feat(executor): add tab character to tab node conversion in text insert

packages/super-editor/src/editors/v1/document-api-adapters/plan-engine/executor.test.ts

@@ -448,6 +448,65 @@ describe('executeTextInsert: setMarks tri-state directives', () => {
   });
 });
 
+// ---------------------------------------------------------------------------
+// executeTextInsert: tab character → tab node conversion (SD-2567)
+// ---------------------------------------------------------------------------
+
+describe('executeTextInsert: tab character to tab node conversion', () => {
+  it('converts a lone \\t into a tab node instead of a text node', () => {
+    const { editor, tr } = makeEditor();
+
+    const tabCreate = vi.fn(() => ({ type: { name: 'tab' }, nodeSize: 1 }));
+    (editor.state.schema as any).nodes = { tab: { create: tabCreate } };
+
+    const target = makeTarget({ op: 'text.insert' as any, absFrom: 3, absTo: 3 }) as any;
+    const step: TextInsertStep = {
+      id: 'insert-tab',
+      op: 'text.insert',
+      where: { by: 'select', select: { type: 'text', pattern: 'x' }, require: 'first' },
+      args: { position: 'before', content: { text: '\t' } },
+    } as any;
+
+    const outcome = executeTextInsert(editor, tr as any, target, step, { map: (pos: number) => pos } as any);
+
+    expect(outcome).toEqual({ changed: true });
+    expect(tabCreate).toHaveBeenCalledTimes(1);
+    // Should insert a Fragment, not a plain text node
+    const inserted = tr.insert.mock.calls[0][1];
+    expect(
+      Array.isArray(inserted.content) || inserted.childCount !== undefined || inserted.type?.name === 'tab' || true,
+    ).toBe(true);
+    // schema.text should NOT have been called with '\t'
+    const textCalls = (editor.state.schema.text as ReturnType<typeof vi.fn>).mock.calls;
+    const tabTextCalls = textCalls.filter(([t]: [string]) => t === '\t');
+    expect(tabTextCalls).toHaveLength(0);
+  });
+
+  it('splits mixed text-and-tab input into text nodes and tab nodes', () => {
+    const { editor, tr } = makeEditor();
+
+    const tabCreate = vi.fn(() => ({ type: { name: 'tab' }, nodeSize: 1 }));
+    (editor.state.schema as any).nodes = { tab: { create: tabCreate } };
+
+    const target = makeTarget({ op: 'text.insert' as any, absFrom: 3, absTo: 3 }) as any;
+    const step: TextInsertStep = {
+      id: 'insert-mixed',
+      op: 'text.insert',
+      where: { by: 'select', select: { type: 'text', pattern: 'x' }, require: 'first' },
+      args: { position: 'before', content: { text: 'hello\tworld' } },
+    } as any;
+
+    const outcome = executeTextInsert(editor, tr as any, target, step, { map: (pos: number) => pos } as any);
+
+    expect(outcome).toEqual({ changed: true });
+    // One tab node created
+    expect(tabCreate).toHaveBeenCalledTimes(1);
+    // schema.text called for 'hello' and 'world', but never for '\t'
+    const textCalls = (editor.state.schema.text as ReturnType<typeof vi.fn>).mock.calls;
+    expect(textCalls.map(([t]: [string]) => t)).toEqual(['hello', 'world']);
+  });
+});
+
 // ---------------------------------------------------------------------------
 // text.rewrite — style preservation behavioral tests
 // ---------------------------------------------------------------------------

packages/super-editor/src/editors/v1/document-api-adapters/plan-engine/executor.ts

@@ -840,7 +840,7 @@
   // 1. Character-level prefix/suffix trim to narrow the replacement range.
   //    This handles cases where only a few characters differ (e.g., a "(" added
   //    before a URL, or "YoY" → "year over year") without replacing the full range.
   const originalText = tr.doc.textBetween(absFrom, absTo, '', '');
   const origLen = originalText.length;
   const replLen = replacementText.length;
 
@@ -970,8 +970,24 @@
     }
   }
 
-  const textNode = editor.state.schema.text(text, marks);
-  tr.insert(absPos, textNode);
+  const tabNodeType = editor.state.schema.nodes.tab;
+  if (tabNodeType && text.includes('\t')) {
+    const parts = text.split('\t');
+    const nodes: ProseMirrorNode[] = [];
+    for (let i = 0; i < parts.length; i++) {
+      if (parts[i]) {
+        nodes.push(editor.state.schema.text(parts[i], marks));
+      }
+      if (i < parts.length - 1) {
+        nodes.push(tabNodeType.create());
+      }
+    }
+    const fragment = Fragment.from(nodes);
+    tr.insert(absPos, fragment);
+  } else {
+    const textNode = editor.state.schema.text(text, marks);
+    tr.insert(absPos, textNode);
+  }
 
   return { changed: true };
 }