feat(module-engine): add inlineTextEdit contract, declare on text/but…

…ton/link Optional ModuleDefinition.inlineTextEdit { prop, multiline? } is the extension point for canvas double-click inline editing — no per-module branches in canvas code. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
CoreBunch · DavidBabinec · Jun 11, 2026 · Jun 10, 2026 · Jun 10, 2026 · Jun 10, 2026
commit f975e9a63d476c11fa997173dbe3ff393da12724
diff --git a/src/__tests__/base-modules.test.ts b/src/__tests__/base-modules.test.ts
@@ -826,3 +826,32 @@ describe('base.link — render() specifics', () => {
     ).not.toThrow()
   })
 })
+
+// ---------------------------------------------------------------------------
+// Inline text edit declarations (docs/superpowers/specs/
+// 2026-06-10-inline-text-editing-design.md) — the canvas resolves these
+// generically; the declaration IS the feature's per-module surface.
+// ---------------------------------------------------------------------------
+
+describe('inline text edit declarations', () => {
+  it('base.text edits the multiline `text` prop', () => {
+    expect(TextModule.inlineTextEdit).toEqual({ prop: 'text', multiline: true })
+  })
+
+  it('base.button edits the single-line `label` prop', () => {
+    expect(ButtonModule.inlineTextEdit).toEqual({ prop: 'label' })
+  })
+
+  it('base.link edits the single-line `text` prop (childless render path)', () => {
+    expect(LinkModule.inlineTextEdit).toEqual({ prop: 'text' })
+  })
+
+  it('every declared prop exists in the module schema with a string default', () => {
+    expect(Object.keys(TextModule.schema)).toContain('text')
+    expect(typeof TextModule.defaults.text).toBe('string')
+    expect(Object.keys(ButtonModule.schema)).toContain('label')
+    expect(typeof ButtonModule.defaults.label).toBe('string')
+    expect(Object.keys(LinkModule.schema)).toContain('text')
+    expect(typeof LinkModule.defaults.text).toBe('string')
+  })
+})
diff --git a/src/core/module-engine/types.ts b/src/core/module-engine/types.ts
@@ -212,6 +212,18 @@ export interface ModuleDefinition<
    */
   canHaveChildren: boolean
 
+  /**
+   * Opt-in canvas inline text editing (double-click a node on the canvas).
+   * `prop` names the single string prop the overlay edits; `multiline: true`
+   * renders a `<textarea>` instead of an `<input>`. Modules without this
+   * field keep the no-op double-click. The canvas resolves the contract
+   * generically — no per-module branches (a node with children never starts
+   * a session, which is how `base.link`'s children-over-text render rule is
+   * honoured). See docs/features/canvas-iframe-per-frame.md → "Inline text
+   * editing (parent-doc overlay)".
+   */
+  inlineTextEdit?: { prop: string; multiline?: boolean }
+
   /**
    * How the publisher's node walker dispatches this module. Makes the
    * otherwise-invisible two-tier render contract explicit on the definition:

diff --git a/src/modules/base/button/index.ts b/src/modules/base/button/index.ts
@@ -37,6 +37,7 @@ export const ButtonModule: ModuleDefinition<ButtonStoredProps> = {
   icon: CursorClickSolidIcon,
   trusted: true,
   canHaveChildren: false,
+  inlineTextEdit: { prop: 'label' },
 
   schema: {
     label: { type: 'text', label: 'Label', placeholder: 'Button text...' },

diff --git a/src/modules/base/link/index.ts b/src/modules/base/link/index.ts
@@ -36,6 +36,9 @@ export const LinkModule: ModuleDefinition<LinkStoredProps> = {
   icon: LinkIcon,
   trusted: true,
   canHaveChildren: true,
+  // Inline-editable only while childless — the canvas's generic
+  // children-guard mirrors linkUsesChildren() in render().
+  inlineTextEdit: { prop: 'text' },
 
   schema: {
     href: { type: 'url', label: 'URL' },

diff --git a/src/modules/base/text/index.ts b/src/modules/base/text/index.ts
@@ -50,6 +50,7 @@ export const TextModule: ModuleDefinition<TextStoredProps> = {
   icon: TextStartTIcon,
   trusted: true,
   canHaveChildren: false,
+  inlineTextEdit: { prop: 'text', multiline: true },
 
   schema: {
     text: { type: 'textarea', label: 'Text', rows: 4, placeholder: 'Enter text...' },