@pilotiq/tiptap 3.2.0 → 3.2.1

package/dist/PlainTextEditor.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Plain-text editor factory — Tiptap editor config tuned to behave like a
+ * native `<input>` (single-line) or `<textarea>` (multi-line), with no marks
+ * and a Document schema restricted to paragraph(s) of inline text.
+ *
+ * Built for `@pilotiq/pilotiq`'s collab-text-field path: when collab is on,
+ * the renderer mounts a Tiptap editor instead of a native input so y-prosemirror
+ * can anchor selections to Yjs `RelativePosition` items (positional identity).
+ * This avoids the cursor-jump + concurrent-insert races inherent to the
+ * `Y.Text` + manual `computeDelta` + heuristic `preserveCursor` path.
+ *
+ * Pure config — no React. Caller passes the returned object to `useEditor` or
+ * `new Editor(...)`. Caller is also responsible for passing in the collab
+ * extension list (typically `Collaboration` + `CollaborationCursor` from the
+ * pilotiq collab adapter); we never import `@tiptap/extension-collaboration`
+ * directly so the open-core package stays free of collab peer deps.
+ */
+import { type AnyExtension, type EditorOptions, type Editor } from '@tiptap/core';
+export interface PlainTextEditorOptions {
+    /** If true, allow multiple paragraphs (textarea-like). Default `false` (input-like). */
+    multiline?: boolean;
+    /** Placeholder text shown while the editor is empty. */
+    placeholder?: string;
+    /** Editable / disabled state. Default `true`. */
+    editable?: boolean;
+    /**
+     * Initial textual content. Ignored when a Collaboration extension is passed
+     * via `extensions` — Collaboration takes ownership of the document and seeds
+     * from the Yjs fragment instead. Use the caller's own first-load seed (see
+     * `@pilotiq/tiptap` README) when collab is on.
+     */
+    content?: string;
+    /**
+     * Extra extensions to merge into the editor — typically the Collaboration +
+     * CollaborationCursor pair from the pilotiq collab adapter. Pass `[]` (or
+     * omit) for the non-collab path.
+     */
+    extensions?: AnyExtension[];
+    /**
+     * Called on every editor update with the editor's plain-text value (blocks
+     * joined by `'\n'`). Use this to mirror the value into form-state for
+     * submission via a hidden `<input>`.
+     */
+    onUpdate?: (text: string, editor: Editor) => void;
+    /**
+     * Single-line Enter handler. Return `true` to suppress the default blur
+     * behavior. When omitted, Enter simply blurs the editor.
+     */
+    onSubmit?: (editor: Editor) => boolean | void;
+    /**
+     * DOM attributes for the editor's contenteditable wrapper — typically
+     * `{ class: '…tailwind classes…' }` to style the editor like the native
+     * `<input>` / `<textarea>` it replaces.
+     */
+    editorAttributes?: Record<string, string>;
+}
+/**
+ * Read the editor's current value as plain text, with paragraphs joined by
+ * `'\n'`. Mirrors the behavior of `<textarea>.value`.
+ */
+export declare function plainTextOf(editor: Editor): string;
+/**
+ * Convert a plain-text string into a Tiptap JSON doc that satisfies the
+ * plain-text schema. Multi-line input splits on `'\n'` into separate
+ * paragraphs; single-line strips any embedded newlines into a single run.
+ * Exported for tests — pure, no editor instance required.
+ */
+export declare function plainTextToDoc(text: string, multiline: boolean): {
+    type: 'doc';
+    content: Array<{
+        type: 'paragraph';
+        content?: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+};
+/**
+ * Build the Tiptap editor config for a plain-text field. Pass the returned
+ * object to `useEditor` (React) or `new Editor(...)` (vanilla).
+ *
+ * The editor schema is deliberately minimal:
+ *   - `doc` → `paragraph` (single-line) or `paragraph+` (multi-line)
+ *   - `paragraph` → `inline*`
+ *   - `text` (inline)
+ *
+ * No marks, no input rules, no list items, no code blocks — just text. Pasted
+ * rich content is stripped to plain text by ProseMirror's schema enforcement.
+ */
+export declare function createPlainTextEditor(options?: PlainTextEditorOptions): Partial<EditorOptions>;
+//# sourceMappingURL=PlainTextEditor.d.ts.map

package/dist/PlainTextEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainTextEditor.d.ts","sourceRoot":"","sources":["../src/PlainTextEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,cAAc,CAAA;AAsErB,MAAM,WAAW,sBAAsB;IACrC,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAA;IAC7C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG;IAChE,IAAI,EAAE,KAAK,CAAA;IACX,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAA;CACvF,CAmBA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,aAAa,CAAC,CA2CxB"}

package/dist/PlainTextEditor.js

@@ -0,0 +1,157 @@
+/**
+ * Plain-text editor factory — Tiptap editor config tuned to behave like a
+ * native `<input>` (single-line) or `<textarea>` (multi-line), with no marks
+ * and a Document schema restricted to paragraph(s) of inline text.
+ *
+ * Built for `@pilotiq/pilotiq`'s collab-text-field path: when collab is on,
+ * the renderer mounts a Tiptap editor instead of a native input so y-prosemirror
+ * can anchor selections to Yjs `RelativePosition` items (positional identity).
+ * This avoids the cursor-jump + concurrent-insert races inherent to the
+ * `Y.Text` + manual `computeDelta` + heuristic `preserveCursor` path.
+ *
+ * Pure config — no React. Caller passes the returned object to `useEditor` or
+ * `new Editor(...)`. Caller is also responsible for passing in the collab
+ * extension list (typically `Collaboration` + `CollaborationCursor` from the
+ * pilotiq collab adapter); we never import `@tiptap/extension-collaboration`
+ * directly so the open-core package stays free of collab peer deps.
+ */
+import { Node, Extension, mergeAttributes, } from '@tiptap/core';
+import Placeholder from '@tiptap/extension-placeholder';
+/** Block separator used by `getText` — newline matches `<textarea>.value`. */
+const BLOCK_SEPARATOR = '\n';
+/**
+ * Bare paragraph block — the only block the plain-text schema permits.
+ * No options, no input rules, no toggles. `inline*` content lets any inline
+ * node (today just `text`) appear inside.
+ */
+const PlainTextParagraph = Node.create({
+    name: 'paragraph',
+    group: 'block',
+    content: 'inline*',
+    priority: 1000,
+    parseHTML() {
+        return [{ tag: 'p' }];
+    },
+    renderHTML({ HTMLAttributes }) {
+        return ['p', mergeAttributes(HTMLAttributes), 0];
+    },
+});
+/** The text node — Tiptap requires this to be defined explicitly. */
+const PlainTextText = Node.create({
+    name: 'text',
+    group: 'inline',
+});
+/**
+ * Build a Document node with content restricted to either a single paragraph
+ * (single-line mode) or one-or-more paragraphs (multi-line mode). The schema
+ * itself blocks paste of incompatible content — ProseMirror will coerce or
+ * reject non-matching nodes at parse time.
+ */
+function makePlainTextDocument(multiline) {
+    return Node.create({
+        name: 'doc',
+        topNode: true,
+        content: multiline ? 'paragraph+' : 'paragraph',
+    });
+}
+/**
+ * Single-line Enter handler. Tiptap's default `Enter` keymap splits the
+ * paragraph — meaningless when the schema only allows exactly one — so we
+ * intercept and either delegate to `onSubmit` (caller-supplied) or blur.
+ *
+ * Filament's plain-text fields blur on Enter; matching that default.
+ */
+function makeSingleLineKeymap(onSubmit) {
+    return Extension.create({
+        name: 'plainTextSingleLineKeymap',
+        addKeyboardShortcuts() {
+            const handleEnter = () => {
+                const handled = onSubmit?.(this.editor);
+                if (handled === true)
+                    return true;
+                this.editor.commands.blur();
+                return true;
+            };
+            return {
+                Enter: handleEnter,
+                'Mod-Enter': () => true,
+                'Shift-Enter': () => true,
+            };
+        },
+    });
+}
+/**
+ * Read the editor's current value as plain text, with paragraphs joined by
+ * `'\n'`. Mirrors the behavior of `<textarea>.value`.
+ */
+export function plainTextOf(editor) {
+    return editor.getText({ blockSeparator: BLOCK_SEPARATOR });
+}
+/**
+ * Convert a plain-text string into a Tiptap JSON doc that satisfies the
+ * plain-text schema. Multi-line input splits on `'\n'` into separate
+ * paragraphs; single-line strips any embedded newlines into a single run.
+ * Exported for tests — pure, no editor instance required.
+ */
+export function plainTextToDoc(text, multiline) {
+    if (!multiline) {
+        const flat = text.replace(/\r?\n/g, '');
+        return {
+            type: 'doc',
+            content: [
+                flat ? { type: 'paragraph', content: [{ type: 'text', text: flat }] }
+                    : { type: 'paragraph' },
+            ],
+        };
+    }
+    const lines = text.split(/\r?\n/);
+    return {
+        type: 'doc',
+        content: lines.map((line) => line ? { type: 'paragraph', content: [{ type: 'text', text: line }] }
+            : { type: 'paragraph' }),
+    };
+}
+/**
+ * Build the Tiptap editor config for a plain-text field. Pass the returned
+ * object to `useEditor` (React) or `new Editor(...)` (vanilla).
+ *
+ * The editor schema is deliberately minimal:
+ *   - `doc` → `paragraph` (single-line) or `paragraph+` (multi-line)
+ *   - `paragraph` → `inline*`
+ *   - `text` (inline)
+ *
+ * No marks, no input rules, no list items, no code blocks — just text. Pasted
+ * rich content is stripped to plain text by ProseMirror's schema enforcement.
+ */
+export function createPlainTextEditor(options = {}) {
+    const { multiline = false, placeholder, editable = true, content = '', extensions = [], onUpdate, onSubmit, editorAttributes, } = options;
+    const schema = [
+        makePlainTextDocument(multiline),
+        PlainTextParagraph,
+        PlainTextText,
+    ];
+    const behavior = [];
+    if (!multiline)
+        behavior.push(makeSingleLineKeymap(onSubmit));
+    if (placeholder !== undefined) {
+        behavior.push(Placeholder.configure({ placeholder }));
+    }
+    const allExtensions = [...schema, ...behavior, ...extensions];
+    // When Collaboration owns the doc, an explicit `content` would race the
+    // Yjs sync. Caller is responsible for omitting `content` in that case; we
+    // pass it through verbatim either way.
+    const initialContent = content ? plainTextToDoc(content, multiline) : '';
+    const config = {
+        editable,
+        extensions: allExtensions,
+        content: initialContent,
+    };
+    if (onUpdate) {
+        config.onUpdate = ({ editor }) => onUpdate(plainTextOf(editor), editor);
+    }
+    if (editorAttributes) {
+        config.editorProps = { attributes: editorAttributes };
+    }
+    return config;
+}
+//# sourceMappingURL=PlainTextEditor.js.map

package/dist/PlainTextEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainTextEditor.js","sourceRoot":"","sources":["../src/PlainTextEditor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { RichTextField, DEFAULT_TOOLBAR_GROUPS, DEFAULT_TEXT_COLORS, DEFAULT_HIG
 export { Block, type BlockMeta } from './Block.js';
 export { MentionProvider, type MentionItem, type MentionProviderMeta, } from './MentionProvider.js';
 export { registerTiptap } from './register.js';
+export { createPlainTextEditor, plainTextOf, plainTextToDoc, type PlainTextEditorOptions, } from './PlainTextEditor.js';
 export { tiptap } from './plugin.js';
 export { TiptapEditor } from './react/TiptapEditor.js';
 export { AiSuggestionExtension, aiSuggestionPluginKey, upsertSuggestion, upsertSuggestions, removeSuggestion, remapSuggestions, sortForApproveAll, clampPos, type AiSuggestion, type AiSuggestionExtensionOptions, } from './extensions/AiSuggestionExtension.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,4BAA4B,GAClC,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,cAAc,EACd,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,4BAA4B,GAClC,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -2,6 +2,7 @@ export { RichTextField, DEFAULT_TOOLBAR_GROUPS, DEFAULT_TEXT_COLORS, DEFAULT_HIG
 export { Block } from './Block.js';
 export { MentionProvider, } from './MentionProvider.js';
 export { registerTiptap } from './register.js';
+export { createPlainTextEditor, plainTextOf, plainTextToDoc, } from './PlainTextEditor.js';
 export { tiptap } from './plugin.js';
 export { TiptapEditor } from './react/TiptapEditor.js';
 export { AiSuggestionExtension, aiSuggestionPluginKey, upsertSuggestion, upsertSuggestions, removeSuggestion, remapSuggestions, sortForApproveAll, clampPos, } from './extensions/AiSuggestionExtension.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GAOzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,GAGT,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EACL,oBAAoB,EACpB,eAAe,GAIhB,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GAOzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,cAAc,GAEf,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,GAGT,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EACL,oBAAoB,EACpB,eAAe,GAIhB,MAAM,aAAa,CAAA"}

package/dist/react/CollabTextRenderer.d.ts

@@ -0,0 +1,26 @@
+import { type CollabTextRendererProps } from '@pilotiq/pilotiq/react';
+/**
+ * Tiptap-backed plain-text editor for pilotiq's `TextField` / `TextareaField`
+ * / similar single-line / multi-line text fields when collab is on.
+ *
+ * Lifts the cursor-bookkeeping burden off the field renderer: y-prosemirror
+ * anchors selections to `Yjs.RelativePosition` items, so concurrent and
+ * mid-word remote edits translate the local cursor correctly without any
+ * heuristic. Replaces the legacy `Y.Text` + `computeDelta` + `preserveCursor`
+ * path documented in `docs/plans/text-fields-tiptap-backed-collab.md`.
+ *
+ * Mount conditions (enforced upstream by `TextLikeInput`):
+ *   - A `<RecordCollabRoom>` is mounted up-tree (`useCollabRoom() !== null`).
+ *   - A collab extension factory was registered (`getCollabExtensions() !== null`).
+ *   - The field hasn't opted out via `.collab(false)`.
+ *   - The field is not masked (`.mask(pattern)`).
+ *   - The field is top-level (not a Repeater / Builder row leaf).
+ *
+ * If either the room or the factory disappears at runtime (e.g. the plugin
+ * was never installed), we still render an editor — it's just a non-collab
+ * plain Tiptap. That's a regression vs `<input>` ergonomically but never
+ * crashes; in practice the upstream gate prevents this branch from mounting
+ * when collab isn't wired.
+ */
+export declare function CollabTextRenderer({ name, multiline, defaultValue, placeholder, disabled, onChange, onBlur, onSubmit, className, editorAttributes, }: CollabTextRendererProps): React.ReactElement;
+//# sourceMappingURL=CollabTextRenderer.d.ts.map

package/dist/react/CollabTextRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollabTextRenderer.d.ts","sourceRoot":"","sources":["../../src/react/CollabTextRenderer.tsx"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAG/B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,gBAAgB,GACjB,EAAE,uBAAuB,GAAG,KAAK,CAAC,YAAY,CAwH9C"}

package/dist/react/CollabTextRenderer.js

@@ -0,0 +1,149 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from 'react';
+import { useEditor, EditorContent } from '@tiptap/react';
+import { useCollabRoom, getCollabExtensions, } from '@pilotiq/pilotiq/react';
+import { createPlainTextEditor, plainTextOf, plainTextToDoc } from '../PlainTextEditor.js';
+/**
+ * Tiptap-backed plain-text editor for pilotiq's `TextField` / `TextareaField`
+ * / similar single-line / multi-line text fields when collab is on.
+ *
+ * Lifts the cursor-bookkeeping burden off the field renderer: y-prosemirror
+ * anchors selections to `Yjs.RelativePosition` items, so concurrent and
+ * mid-word remote edits translate the local cursor correctly without any
+ * heuristic. Replaces the legacy `Y.Text` + `computeDelta` + `preserveCursor`
+ * path documented in `docs/plans/text-fields-tiptap-backed-collab.md`.
+ *
+ * Mount conditions (enforced upstream by `TextLikeInput`):
+ *   - A `<RecordCollabRoom>` is mounted up-tree (`useCollabRoom() !== null`).
+ *   - A collab extension factory was registered (`getCollabExtensions() !== null`).
+ *   - The field hasn't opted out via `.collab(false)`.
+ *   - The field is not masked (`.mask(pattern)`).
+ *   - The field is top-level (not a Repeater / Builder row leaf).
+ *
+ * If either the room or the factory disappears at runtime (e.g. the plugin
+ * was never installed), we still render an editor — it's just a non-collab
+ * plain Tiptap. That's a regression vs `<input>` ergonomically but never
+ * crashes; in practice the upstream gate prevents this branch from mounting
+ * when collab isn't wired.
+ */
+export function CollabTextRenderer({ name, multiline, defaultValue, placeholder, disabled, onChange, onBlur, onSubmit, className, editorAttributes, }) {
+    const room = useCollabRoom();
+    const factory = getCollabExtensions();
+    const collabActive = !!(room && factory);
+    // Built once per editor mount. The factory closes over the room's `ydoc`
+    // + `provider` and the field name to produce a `Collaboration` (and
+    // optional `CollaborationCursor`) extension targeting the field's
+    // `Y.XmlFragment`. Re-running on every render would tear down the editor.
+    const collabExtensions = useMemo(() => {
+        if (!collabActive || !room || !factory)
+            return [];
+        return factory({
+            ydoc: room.ydoc,
+            provider: room.provider,
+            fieldName: name,
+            ...(room.user ? { user: room.user } : {}),
+        });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [collabActive]);
+    const editor = useEditor(createPlainTextEditor({
+        multiline,
+        ...(placeholder !== undefined ? { placeholder } : {}),
+        editable: !disabled,
+        // When Collaboration owns the doc, omit `content` so the editor
+        // doesn't race the y-prosemirror sync. The post-`synced` effect below
+        // seeds the fragment on first connect when it's still empty. When
+        // collab is off, seed from defaultValue directly.
+        content: collabActive ? '' : defaultValue,
+        extensions: collabExtensions,
+        onUpdate: (text) => onChange(text),
+        ...(onSubmit ? { onSubmit: () => { onSubmit(); return false; } } : {}),
+        ...(className || editorAttributes
+            ? {
+                editorAttributes: {
+                    ...(editorAttributes ?? {}),
+                    ...(className ? { class: className } : {}),
+                },
+            }
+            : {}),
+    }), 
+    // Re-mount when collab toggles. Other props (multiline, name, etc) are
+    // stable per mount under the upstream gate.
+    [collabActive]);
+    // Mirror the editor's editable state with the prop. `useEditor` snapshots
+    // `editable` at first call, so we update it imperatively on changes.
+    useEffect(() => {
+        if (!editor)
+            return;
+        editor.setEditable(!disabled);
+    }, [editor, disabled]);
+    // First-load seed when collab is active. Collaboration starts the editor
+    // empty regardless of `defaultValue`; once the provider syncs the room
+    // state from the server we check whether the field's `Y.XmlFragment`
+    // was ever written. Empty + we have an initial value = first session for
+    // this record — push the SSR-rendered default into the editor once.
+    //
+    // Race caveat: two peers simultaneously mounting against a brand-new
+    // record (both seeing `fragment.length === 0`) can both seed and produce
+    // duplicated text. Same window as `TiptapEditor`'s rich-text seed path.
+    // Acceptable for now; can be tightened later via a deterministic
+    // first-writer election or a server-side seed handoff.
+    const [hasSeeded, setHasSeeded] = useState(false);
+    useEffect(() => {
+        if (!editor || !collabActive || !room || hasSeeded)
+            return;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ydoc = room.ydoc;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const provider = room.provider;
+        if (!ydoc || !provider)
+            return;
+        const trySeed = () => {
+            try {
+                const fragment = ydoc.getXmlFragment(name);
+                if (fragment && fragment.length === 0 && defaultValue) {
+                    editor.commands.setContent(plainTextToDoc(defaultValue, multiline));
+                }
+                setHasSeeded(true);
+            }
+            catch {
+                setHasSeeded(true);
+            }
+        };
+        if (provider.synced) {
+            trySeed();
+            return;
+        }
+        provider.once('synced', trySeed);
+        return () => {
+            try {
+                provider.off?.('synced', trySeed);
+            }
+            catch { /* ignore */ }
+        };
+        // Seed once per editor instance — keyed remount above resets `hasSeeded`.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [editor, collabActive, room]);
+    // Bubble the editor's blur event up to the host. Tiptap exposes this via
+    // `editor.on('blur', ...)`. The simpler `onBlur` prop on `EditorContent`
+    // fires on the DOM node, but selection inside contenteditable can land on
+    // child nodes; the Tiptap event is the canonical "editor lost focus".
+    useEffect(() => {
+        if (!editor)
+            return;
+        const handler = () => onBlur();
+        editor.on('blur', handler);
+        return () => { editor.off('blur', handler); };
+    }, [editor, onBlur]);
+    // Best-effort getText safety net — onUpdate should fire on every
+    // y-prosemirror sync, but if a remote update somehow doesn't trigger
+    // `onUpdate`, the wrapper's hidden input goes stale. Re-emit on every
+    // editor render tick. No-op when text matches the last emit.
+    useEffect(() => {
+        if (!editor)
+            return;
+        onChange(plainTextOf(editor));
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [editor]);
+    return _jsx(EditorContent, { editor: editor });
+}
+//# sourceMappingURL=CollabTextRenderer.js.map

package/dist/react/CollabTextRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollabTextRenderer.js","sourceRoot":"","sources":["../../src/react/CollabTextRenderer.tsx"],"names":[],"mappings":"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"}

package/dist/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,IAAI,IAAI,CASrC"}

package/dist/register.js

@@ -1,6 +1,7 @@
-import { registerFieldRenderer } from '@pilotiq/pilotiq/react';
+import { registerFieldRenderer, registerCollabTextRenderer } from '@pilotiq/pilotiq/react';
 import { registerRichTextRenderer } from '@pilotiq/pilotiq/richtext';
 import { TiptapEditor } from './react/TiptapEditor.js';
+import { CollabTextRenderer } from './react/CollabTextRenderer.js';
 import { renderRichTextToHtml, isRichTextValue } from './render.js';
 /**
  * Register the Tiptap editor as the pilotiq renderer for `fieldType: 'richtext'`.
@@ -23,5 +24,11 @@ import { renderRichTextToHtml, isRichTextValue } from './render.js';
 export function registerTiptap() {
     registerFieldRenderer('richtext', TiptapEditor);
     registerRichTextRenderer(renderRichTextToHtml, isRichTextValue);
+    // Phase B — opt every plain-text field in the panel into y-prosemirror
+    // backing when collab is on. `TextLikeInput` checks this registry; if it's
+    // populated AND a `<RecordCollabRoom>` is up-tree AND the field hasn't opted
+    // out via `.collab(false)`, the renderer mounts `CollabTextRenderer`
+    // instead of the legacy `Y.Text` + `computeDelta` + `preserveCursor` path.
+    registerCollabTextRenderer(CollabTextRenderer);
 }
 //# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc;IAC5B,qBAAqB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IAC/C,wBAAwB,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAA;AACjE,CAAC"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc;IAC5B,qBAAqB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IAC/C,wBAAwB,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAA;IAC/D,uEAAuE;IACvE,2EAA2E;IAC3E,6EAA6E;IAC7E,qEAAqE;IACrE,2EAA2E;IAC3E,0BAA0B,CAAC,kBAAkB,CAAC,CAAA;AAChD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilotiq/tiptap",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "Tiptap rich-text editor adapter for @pilotiq/pilotiq — slash menu, draggable blocks, custom-block API",
   "license": "MIT",
   "repository": {
@@ -79,7 +79,7 @@
     "react": "^19",
     "react-dom": "^19",
     "typescript": "^5",
-    "@pilotiq/pilotiq": "^0.8.0"
+    "@pilotiq/pilotiq": "^0.12.0"
   },
   "author": "Suleiman Shahbari",
   "scripts": {

package/src/PlainTextEditor.test.ts

@@ -0,0 +1,158 @@
+import { describe, it } from 'node:test'
+import assert from 'node:assert/strict'
+
+import {
+  createPlainTextEditor,
+  plainTextToDoc,
+  type PlainTextEditorOptions,
+} from './PlainTextEditor.js'
+
+describe('plainTextToDoc — single-line', () => {
+  it('empty string yields one empty paragraph', () => {
+    assert.deepEqual(plainTextToDoc('', false), {
+      type: 'doc',
+      content: [{ type: 'paragraph' }],
+    })
+  })
+
+  it('wraps a single run of text in one paragraph', () => {
+    assert.deepEqual(plainTextToDoc('hello', false), {
+      type: 'doc',
+      content: [{ type: 'paragraph', content: [{ type: 'text', text: 'hello' }] }],
+    })
+  })
+
+  it('strips embedded newlines (LF and CRLF) — single-line schema permits one paragraph only', () => {
+    assert.deepEqual(plainTextToDoc('a\nb', false), {
+      type: 'doc',
+      content: [{ type: 'paragraph', content: [{ type: 'text', text: 'ab' }] }],
+    })
+    assert.deepEqual(plainTextToDoc('a\r\nb', false), {
+      type: 'doc',
+      content: [{ type: 'paragraph', content: [{ type: 'text', text: 'ab' }] }],
+    })
+  })
+})
+
+describe('plainTextToDoc — multi-line', () => {
+  it('empty string yields one empty paragraph', () => {
+    assert.deepEqual(plainTextToDoc('', true), {
+      type: 'doc',
+      content: [{ type: 'paragraph' }],
+    })
+  })
+
+  it('splits LF-separated lines into separate paragraphs', () => {
+    assert.deepEqual(plainTextToDoc('a\nb', true), {
+      type: 'doc',
+      content: [
+        { type: 'paragraph', content: [{ type: 'text', text: 'a' }] },
+        { type: 'paragraph', content: [{ type: 'text', text: 'b' }] },
+      ],
+    })
+  })
+
+  it('preserves empty lines as empty paragraphs', () => {
+    assert.deepEqual(plainTextToDoc('a\n\nb', true), {
+      type: 'doc',
+      content: [
+        { type: 'paragraph', content: [{ type: 'text', text: 'a' }] },
+        { type: 'paragraph' },
+        { type: 'paragraph', content: [{ type: 'text', text: 'b' }] },
+      ],
+    })
+  })
+
+  it('normalises CRLF to single paragraph splits', () => {
+    assert.deepEqual(plainTextToDoc('a\r\nb', true), {
+      type: 'doc',
+      content: [
+        { type: 'paragraph', content: [{ type: 'text', text: 'a' }] },
+        { type: 'paragraph', content: [{ type: 'text', text: 'b' }] },
+      ],
+    })
+  })
+})
+
+describe('createPlainTextEditor — config shape', () => {
+  function names(extensions: ReadonlyArray<{ name: string }>): string[] {
+    return extensions.map((e) => e.name)
+  }
+
+  it('default config: single-line, editable, schema + single-line keymap only', () => {
+    const cfg = createPlainTextEditor()
+    assert.equal(cfg.editable, true)
+    assert.equal(cfg.content, '')
+    const exts = (cfg.extensions ?? []) as Array<{ name: string }>
+    assert.deepEqual(names(exts), ['doc', 'paragraph', 'text', 'plainTextSingleLineKeymap'])
+    assert.equal(cfg.editorProps, undefined)
+    assert.equal(cfg.onUpdate, undefined)
+  })
+
+  it('multiline mode drops the single-line keymap', () => {
+    const cfg = createPlainTextEditor({ multiline: true })
+    const exts = (cfg.extensions ?? []) as Array<{ name: string }>
+    assert.deepEqual(names(exts), ['doc', 'paragraph', 'text'])
+  })
+
+  it('placeholder appends the Placeholder extension', () => {
+    const cfg = createPlainTextEditor({ placeholder: 'Type here…' })
+    const exts = (cfg.extensions ?? []) as Array<{ name: string }>
+    assert.ok(exts.some((e) => e.name === 'placeholder'),
+      `expected placeholder extension, got ${names(exts).join(',')}`)
+  })
+
+  it('caller-supplied extensions land after schema + behavior', () => {
+    const fakeExt = { name: 'fake-collab' } as unknown as Parameters<typeof createPlainTextEditor>[0] extends infer T
+      ? T extends { extensions?: Array<infer E> } ? E : never : never
+    const cfg = createPlainTextEditor({ extensions: [fakeExt] })
+    const exts = (cfg.extensions ?? []) as Array<{ name: string }>
+    assert.equal(exts[exts.length - 1]?.name, 'fake-collab')
+  })
+
+  it('editable can be turned off', () => {
+    const cfg = createPlainTextEditor({ editable: false })
+    assert.equal(cfg.editable, false)
+  })
+
+  it('seeds content as a doc JSON when text provided (single-line)', () => {
+    const cfg = createPlainTextEditor({ content: 'hello' })
+    assert.deepEqual(cfg.content, {
+      type: 'doc',
+      content: [{ type: 'paragraph', content: [{ type: 'text', text: 'hello' }] }],
+    })
+  })
+
+  it('seeds content as multi-paragraph doc JSON when multiline + text provided', () => {
+    const cfg = createPlainTextEditor({ multiline: true, content: 'a\nb' })
+    assert.deepEqual(cfg.content, {
+      type: 'doc',
+      content: [
+        { type: 'paragraph', content: [{ type: 'text', text: 'a' }] },
+        { type: 'paragraph', content: [{ type: 'text', text: 'b' }] },
+      ],
+    })
+  })
+
+  it('empty content stays an empty string sentinel — Collaboration-friendly', () => {
+    // When collab is on, callers pass content omitted/'' so Collaboration's
+    // y-prosemirror binding takes ownership of the doc without a seed race.
+    const cfg = createPlainTextEditor({ content: '' })
+    assert.equal(cfg.content, '')
+  })
+
+  it('editorAttributes plumb into editorProps.attributes verbatim', () => {
+    const attrs = { class: 'foo bar', 'aria-label': 'Name' }
+    const cfg = createPlainTextEditor({ editorAttributes: attrs })
+    assert.deepEqual(cfg.editorProps, { attributes: attrs })
+  })
+
+  it('onUpdate is wired only when caller provides it', () => {
+    const withCb: PlainTextEditorOptions = { onUpdate: () => {} }
+    const cfgA = createPlainTextEditor(withCb)
+    assert.equal(typeof cfgA.onUpdate, 'function')
+
+    const cfgB = createPlainTextEditor()
+    assert.equal(cfgB.onUpdate, undefined)
+  })
+})

package/src/PlainTextEditor.ts

@@ -0,0 +1,229 @@
+/**
+ * Plain-text editor factory — Tiptap editor config tuned to behave like a
+ * native `<input>` (single-line) or `<textarea>` (multi-line), with no marks
+ * and a Document schema restricted to paragraph(s) of inline text.
+ *
+ * Built for `@pilotiq/pilotiq`'s collab-text-field path: when collab is on,
+ * the renderer mounts a Tiptap editor instead of a native input so y-prosemirror
+ * can anchor selections to Yjs `RelativePosition` items (positional identity).
+ * This avoids the cursor-jump + concurrent-insert races inherent to the
+ * `Y.Text` + manual `computeDelta` + heuristic `preserveCursor` path.
+ *
+ * Pure config — no React. Caller passes the returned object to `useEditor` or
+ * `new Editor(...)`. Caller is also responsible for passing in the collab
+ * extension list (typically `Collaboration` + `CollaborationCursor` from the
+ * pilotiq collab adapter); we never import `@tiptap/extension-collaboration`
+ * directly so the open-core package stays free of collab peer deps.
+ */
+import {
+  Node,
+  Extension,
+  mergeAttributes,
+  type AnyExtension,
+  type EditorOptions,
+  type Editor,
+} from '@tiptap/core'
+import Placeholder from '@tiptap/extension-placeholder'
+
+/** Block separator used by `getText` — newline matches `<textarea>.value`. */
+const BLOCK_SEPARATOR = '\n'
+
+/**
+ * Bare paragraph block — the only block the plain-text schema permits.
+ * No options, no input rules, no toggles. `inline*` content lets any inline
+ * node (today just `text`) appear inside.
+ */
+const PlainTextParagraph = Node.create({
+  name: 'paragraph',
+  group: 'block',
+  content: 'inline*',
+  priority: 1000,
+  parseHTML() {
+    return [{ tag: 'p' }]
+  },
+  renderHTML({ HTMLAttributes }) {
+    return ['p', mergeAttributes(HTMLAttributes), 0]
+  },
+})
+
+/** The text node — Tiptap requires this to be defined explicitly. */
+const PlainTextText = Node.create({
+  name: 'text',
+  group: 'inline',
+})
+
+/**
+ * Build a Document node with content restricted to either a single paragraph
+ * (single-line mode) or one-or-more paragraphs (multi-line mode). The schema
+ * itself blocks paste of incompatible content — ProseMirror will coerce or
+ * reject non-matching nodes at parse time.
+ */
+function makePlainTextDocument(multiline: boolean) {
+  return Node.create({
+    name: 'doc',
+    topNode: true,
+    content: multiline ? 'paragraph+' : 'paragraph',
+  })
+}
+
+/**
+ * Single-line Enter handler. Tiptap's default `Enter` keymap splits the
+ * paragraph — meaningless when the schema only allows exactly one — so we
+ * intercept and either delegate to `onSubmit` (caller-supplied) or blur.
+ *
+ * Filament's plain-text fields blur on Enter; matching that default.
+ */
+function makeSingleLineKeymap(onSubmit: ((editor: Editor) => boolean | void) | undefined) {
+  return Extension.create({
+    name: 'plainTextSingleLineKeymap',
+    addKeyboardShortcuts() {
+      const handleEnter = (): boolean => {
+        const handled = onSubmit?.(this.editor)
+        if (handled === true) return true
+        this.editor.commands.blur()
+        return true
+      }
+      return {
+        Enter:         handleEnter,
+        'Mod-Enter':   () => true,
+        'Shift-Enter': () => true,
+      }
+    },
+  })
+}
+
+export interface PlainTextEditorOptions {
+  /** If true, allow multiple paragraphs (textarea-like). Default `false` (input-like). */
+  multiline?: boolean
+  /** Placeholder text shown while the editor is empty. */
+  placeholder?: string
+  /** Editable / disabled state. Default `true`. */
+  editable?: boolean
+  /**
+   * Initial textual content. Ignored when a Collaboration extension is passed
+   * via `extensions` — Collaboration takes ownership of the document and seeds
+   * from the Yjs fragment instead. Use the caller's own first-load seed (see
+   * `@pilotiq/tiptap` README) when collab is on.
+   */
+  content?: string
+  /**
+   * Extra extensions to merge into the editor — typically the Collaboration +
+   * CollaborationCursor pair from the pilotiq collab adapter. Pass `[]` (or
+   * omit) for the non-collab path.
+   */
+  extensions?: AnyExtension[]
+  /**
+   * Called on every editor update with the editor's plain-text value (blocks
+   * joined by `'\n'`). Use this to mirror the value into form-state for
+   * submission via a hidden `<input>`.
+   */
+  onUpdate?: (text: string, editor: Editor) => void
+  /**
+   * Single-line Enter handler. Return `true` to suppress the default blur
+   * behavior. When omitted, Enter simply blurs the editor.
+   */
+  onSubmit?: (editor: Editor) => boolean | void
+  /**
+   * DOM attributes for the editor's contenteditable wrapper — typically
+   * `{ class: '…tailwind classes…' }` to style the editor like the native
+   * `<input>` / `<textarea>` it replaces.
+   */
+  editorAttributes?: Record<string, string>
+}
+
+/**
+ * Read the editor's current value as plain text, with paragraphs joined by
+ * `'\n'`. Mirrors the behavior of `<textarea>.value`.
+ */
+export function plainTextOf(editor: Editor): string {
+  return editor.getText({ blockSeparator: BLOCK_SEPARATOR })
+}
+
+/**
+ * Convert a plain-text string into a Tiptap JSON doc that satisfies the
+ * plain-text schema. Multi-line input splits on `'\n'` into separate
+ * paragraphs; single-line strips any embedded newlines into a single run.
+ * Exported for tests — pure, no editor instance required.
+ */
+export function plainTextToDoc(text: string, multiline: boolean): {
+  type: 'doc'
+  content: Array<{ type: 'paragraph'; content?: Array<{ type: 'text'; text: string }> }>
+} {
+  if (!multiline) {
+    const flat = text.replace(/\r?\n/g, '')
+    return {
+      type: 'doc',
+      content: [
+        flat ? { type: 'paragraph', content: [{ type: 'text', text: flat }] }
+             : { type: 'paragraph' },
+      ],
+    }
+  }
+  const lines = text.split(/\r?\n/)
+  return {
+    type: 'doc',
+    content: lines.map((line) =>
+      line ? { type: 'paragraph', content: [{ type: 'text', text: line }] }
+           : { type: 'paragraph' },
+    ),
+  }
+}
+
+/**
+ * Build the Tiptap editor config for a plain-text field. Pass the returned
+ * object to `useEditor` (React) or `new Editor(...)` (vanilla).
+ *
+ * The editor schema is deliberately minimal:
+ *   - `doc` → `paragraph` (single-line) or `paragraph+` (multi-line)
+ *   - `paragraph` → `inline*`
+ *   - `text` (inline)
+ *
+ * No marks, no input rules, no list items, no code blocks — just text. Pasted
+ * rich content is stripped to plain text by ProseMirror's schema enforcement.
+ */
+export function createPlainTextEditor(
+  options: PlainTextEditorOptions = {},
+): Partial<EditorOptions> {
+  const {
+    multiline = false,
+    placeholder,
+    editable = true,
+    content = '',
+    extensions = [],
+    onUpdate,
+    onSubmit,
+    editorAttributes,
+  } = options
+
+  const schema: AnyExtension[] = [
+    makePlainTextDocument(multiline),
+    PlainTextParagraph,
+    PlainTextText,
+  ]
+
+  const behavior: AnyExtension[] = []
+  if (!multiline) behavior.push(makeSingleLineKeymap(onSubmit))
+  if (placeholder !== undefined) {
+    behavior.push(Placeholder.configure({ placeholder }))
+  }
+
+  const allExtensions: AnyExtension[] = [...schema, ...behavior, ...extensions]
+
+  // When Collaboration owns the doc, an explicit `content` would race the
+  // Yjs sync. Caller is responsible for omitting `content` in that case; we
+  // pass it through verbatim either way.
+  const initialContent = content ? plainTextToDoc(content, multiline) : ''
+
+  const config: Partial<EditorOptions> = {
+    editable,
+    extensions: allExtensions,
+    content: initialContent,
+  }
+  if (onUpdate) {
+    config.onUpdate = ({ editor }) => onUpdate(plainTextOf(editor), editor)
+  }
+  if (editorAttributes) {
+    config.editorProps = { attributes: editorAttributes }
+  }
+  return config
+}

package/src/index.ts

@@ -17,6 +17,12 @@ export {
   type MentionProviderMeta,
 } from './MentionProvider.js'
 export { registerTiptap } from './register.js'
+export {
+  createPlainTextEditor,
+  plainTextOf,
+  plainTextToDoc,
+  type PlainTextEditorOptions,
+} from './PlainTextEditor.js'
 export { tiptap } from './plugin.js'
 export { TiptapEditor } from './react/TiptapEditor.js'
 export {

package/src/react/CollabTextRenderer.tsx

@@ -0,0 +1,165 @@
+import { useEffect, useMemo, useState } from 'react'
+import { useEditor, EditorContent, type Extension } from '@tiptap/react'
+import type { AnyExtension } from '@tiptap/core'
+import {
+  useCollabRoom,
+  getCollabExtensions,
+  type CollabTextRendererProps,
+} from '@pilotiq/pilotiq/react'
+import { createPlainTextEditor, plainTextOf, plainTextToDoc } from '../PlainTextEditor.js'
+
+/**
+ * Tiptap-backed plain-text editor for pilotiq's `TextField` / `TextareaField`
+ * / similar single-line / multi-line text fields when collab is on.
+ *
+ * Lifts the cursor-bookkeeping burden off the field renderer: y-prosemirror
+ * anchors selections to `Yjs.RelativePosition` items, so concurrent and
+ * mid-word remote edits translate the local cursor correctly without any
+ * heuristic. Replaces the legacy `Y.Text` + `computeDelta` + `preserveCursor`
+ * path documented in `docs/plans/text-fields-tiptap-backed-collab.md`.
+ *
+ * Mount conditions (enforced upstream by `TextLikeInput`):
+ *   - A `<RecordCollabRoom>` is mounted up-tree (`useCollabRoom() !== null`).
+ *   - A collab extension factory was registered (`getCollabExtensions() !== null`).
+ *   - The field hasn't opted out via `.collab(false)`.
+ *   - The field is not masked (`.mask(pattern)`).
+ *   - The field is top-level (not a Repeater / Builder row leaf).
+ *
+ * If either the room or the factory disappears at runtime (e.g. the plugin
+ * was never installed), we still render an editor — it's just a non-collab
+ * plain Tiptap. That's a regression vs `<input>` ergonomically but never
+ * crashes; in practice the upstream gate prevents this branch from mounting
+ * when collab isn't wired.
+ */
+export function CollabTextRenderer({
+  name,
+  multiline,
+  defaultValue,
+  placeholder,
+  disabled,
+  onChange,
+  onBlur,
+  onSubmit,
+  className,
+  editorAttributes,
+}: CollabTextRendererProps): React.ReactElement {
+  const room    = useCollabRoom()
+  const factory = getCollabExtensions()
+  const collabActive = !!(room && factory)
+
+  // Built once per editor mount. The factory closes over the room's `ydoc`
+  // + `provider` and the field name to produce a `Collaboration` (and
+  // optional `CollaborationCursor`) extension targeting the field's
+  // `Y.XmlFragment`. Re-running on every render would tear down the editor.
+  const collabExtensions = useMemo<AnyExtension[]>(() => {
+    if (!collabActive || !room || !factory) return []
+    return factory({
+      ydoc:      room.ydoc,
+      provider:  room.provider,
+      fieldName: name,
+      ...(room.user ? { user: room.user } : {}),
+    }) as Extension[]
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [collabActive])
+
+  const editor = useEditor(
+    createPlainTextEditor({
+      multiline,
+      ...(placeholder !== undefined ? { placeholder } : {}),
+      editable: !disabled,
+      // When Collaboration owns the doc, omit `content` so the editor
+      // doesn't race the y-prosemirror sync. The post-`synced` effect below
+      // seeds the fragment on first connect when it's still empty. When
+      // collab is off, seed from defaultValue directly.
+      content: collabActive ? '' : defaultValue,
+      extensions: collabExtensions,
+      onUpdate: (text) => onChange(text),
+      ...(onSubmit ? { onSubmit: () => { onSubmit(); return false } } : {}),
+      ...(className || editorAttributes
+        ? {
+            editorAttributes: {
+              ...(editorAttributes ?? {}),
+              ...(className ? { class: className } : {}),
+            },
+          }
+        : {}),
+    }),
+    // Re-mount when collab toggles. Other props (multiline, name, etc) are
+    // stable per mount under the upstream gate.
+    [collabActive],
+  )
+
+  // Mirror the editor's editable state with the prop. `useEditor` snapshots
+  // `editable` at first call, so we update it imperatively on changes.
+  useEffect(() => {
+    if (!editor) return
+    editor.setEditable(!disabled)
+  }, [editor, disabled])
+
+  // First-load seed when collab is active. Collaboration starts the editor
+  // empty regardless of `defaultValue`; once the provider syncs the room
+  // state from the server we check whether the field's `Y.XmlFragment`
+  // was ever written. Empty + we have an initial value = first session for
+  // this record — push the SSR-rendered default into the editor once.
+  //
+  // Race caveat: two peers simultaneously mounting against a brand-new
+  // record (both seeing `fragment.length === 0`) can both seed and produce
+  // duplicated text. Same window as `TiptapEditor`'s rich-text seed path.
+  // Acceptable for now; can be tightened later via a deterministic
+  // first-writer election or a server-side seed handoff.
+  const [hasSeeded, setHasSeeded] = useState(false)
+  useEffect(() => {
+    if (!editor || !collabActive || !room || hasSeeded) return
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const ydoc     = room.ydoc as any
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const provider = room.provider as any
+    if (!ydoc || !provider) return
+
+    const trySeed = (): void => {
+      try {
+        const fragment = ydoc.getXmlFragment(name)
+        if (fragment && fragment.length === 0 && defaultValue) {
+          editor.commands.setContent(plainTextToDoc(defaultValue, multiline))
+        }
+        setHasSeeded(true)
+      } catch {
+        setHasSeeded(true)
+      }
+    }
+
+    if (provider.synced) {
+      trySeed()
+      return
+    }
+    provider.once('synced', trySeed)
+    return () => {
+      try { provider.off?.('synced', trySeed) } catch { /* ignore */ }
+    }
+    // Seed once per editor instance — keyed remount above resets `hasSeeded`.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [editor, collabActive, room])
+
+  // Bubble the editor's blur event up to the host. Tiptap exposes this via
+  // `editor.on('blur', ...)`. The simpler `onBlur` prop on `EditorContent`
+  // fires on the DOM node, but selection inside contenteditable can land on
+  // child nodes; the Tiptap event is the canonical "editor lost focus".
+  useEffect(() => {
+    if (!editor) return
+    const handler = (): void => onBlur()
+    editor.on('blur', handler)
+    return () => { editor.off('blur', handler) }
+  }, [editor, onBlur])
+
+  // Best-effort getText safety net — onUpdate should fire on every
+  // y-prosemirror sync, but if a remote update somehow doesn't trigger
+  // `onUpdate`, the wrapper's hidden input goes stale. Re-emit on every
+  // editor render tick. No-op when text matches the last emit.
+  useEffect(() => {
+    if (!editor) return
+    onChange(plainTextOf(editor))
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [editor])
+
+  return <EditorContent editor={editor} />
+}

package/src/register.ts

@@ -1,6 +1,7 @@
-import { registerFieldRenderer } from '@pilotiq/pilotiq/react'
+import { registerFieldRenderer, registerCollabTextRenderer } from '@pilotiq/pilotiq/react'
 import { registerRichTextRenderer } from '@pilotiq/pilotiq/richtext'
 import { TiptapEditor } from './react/TiptapEditor.js'
+import { CollabTextRenderer } from './react/CollabTextRenderer.js'
 import { renderRichTextToHtml, isRichTextValue } from './render.js'
 
 /**
@@ -24,4 +25,10 @@ import { renderRichTextToHtml, isRichTextValue } from './render.js'
 export function registerTiptap(): void {
   registerFieldRenderer('richtext', TiptapEditor)
   registerRichTextRenderer(renderRichTextToHtml, isRichTextValue)
+  // Phase B — opt every plain-text field in the panel into y-prosemirror
+  // backing when collab is on. `TextLikeInput` checks this registry; if it's
+  // populated AND a `<RecordCollabRoom>` is up-tree AND the field hasn't opted
+  // out via `.collab(false)`, the renderer mounts `CollabTextRenderer`
+  // instead of the legacy `Y.Text` + `computeDelta` + `preserveCursor` path.
+  registerCollabTextRenderer(CollabTextRenderer)
 }