@pilotiq/tiptap 3.1.1 → 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/react/TiptapEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TiptapEditor.d.ts","sourceRoot":"","sources":["../../src/react/TiptapEditor.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAyBhE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,2CAqBrD"}
+{"version":3,"file":"TiptapEditor.d.ts","sourceRoot":"","sources":["../../src/react/TiptapEditor.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,wBAAwB,CAAA;AA0B/B;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,2CAqBrD"}