@pilotiq/tiptap 3.4.0 → 3.6.0

package/dist/react/useAiInlineDiff.js

@@ -0,0 +1,121 @@
+/**
+ * Bridge between the host's `<PendingSuggestionsContext>` queue and the
+ * editor's `AiInlineDiffExtension`. When a whole-field suggestion arrives
+ * for the field, the hook:
+ *
+ *   1. Parses the suggested value into a ProseMirror `Slice` via the
+ *      renderer-supplied parser. Each Tiptap surface owns its own
+ *      content shape — markdown source for `MarkdownEditor`, HTML / JSON
+ *      for `TiptapEditor`, plain text for `CollabTextRenderer`.
+ *   2. Calls `editor.commands.startAiInlineDiff(id, slice)` — the
+ *      extension snapshots the current doc as the baseline, replaces
+ *      the doc content with the proposed slice, and starts a
+ *      `prosemirror-changeset` tracking the diff.
+ *   3. Registers an applier on the cross-tree pending-suggestion
+ *      registry so the host's `<AiSuggestionBanner>` Accept button (and
+ *      any other surface calling `pendingSuggestions.approve(id)`) runs
+ *      `acceptAiInlineDiff()` instead of the legacy `onApplyWholeField`
+ *      callback. The current doc IS the accepted state — no extra
+ *      content swap needed.
+ *
+ * Reject handling: not registered on the applier (the registry only
+ * tracks Approve). Renderers wire Reject through the banner's
+ * `onRejectWithEditor` prop, which calls `rejectAiInlineDiff()` to revert
+ * the doc to the baseline before dismissing the suggestion.
+ *
+ * Defensive: only one inline diff active at a time per editor. If a new
+ * synthesized suggestion arrives while one is still pending review, the
+ * hook drops it (the producer should have waited). This matches
+ * `AiSuggestionExtension`'s chip path which also allows only one
+ * suggestion at a time per id.
+ */
+import { useEffect, useRef } from 'react';
+import { registerPendingSuggestionApplier, usePendingSuggestionsForField, } from '@pilotiq/pilotiq/react';
+import { aiInlineDiffPluginKey } from '../extensions/AiInlineDiffExtension.js';
+/**
+ * Returns whether a diff is currently active in the editor. Hosts use
+ * this to gate the banner's UI between the legacy `onApplyWholeField`
+ * mode and the diff-aware mode (Reject routes through
+ * `rejectAiInlineDiff` to revert the doc).
+ */
+export function useIsAiInlineDiffActive(editor) {
+    // Re-render on every editor transaction so the hook tracks state
+    // changes (start / accept / reject). useEditorState would be the
+    // idiomatic way; we read directly here to keep the dep surface tiny.
+    const [, force] = useReducerForceUpdate();
+    useEffect(() => {
+        if (!editor)
+            return;
+        const handler = () => force();
+        editor.on('transaction', handler);
+        return () => { editor.off('transaction', handler); };
+    }, [editor, force]);
+    if (!editor)
+        return false;
+    return aiInlineDiffPluginKey.getState(editor.state) !== null;
+}
+export function useAiInlineDiff(editor, fieldName, options) {
+    const { list } = usePendingSuggestionsForField(fieldName);
+    const parseRef = useRef(options.parseSuggestion);
+    useEffect(() => { parseRef.current = options.parseSuggestion; }, [options.parseSuggestion]);
+    // Track which ids we've handed off to the editor's diff extension
+    // so we don't re-start the diff every render or for already-active
+    // suggestions.
+    const startedRef = useRef(new Set());
+    // Context → editor: start the diff for each new whole-field suggestion.
+    useEffect(() => {
+        if (!editor)
+            return;
+        const wholeField = list.filter(s => !hasEditorRange(s));
+        for (const s of wholeField) {
+            if (startedRef.current.has(s.id))
+                continue;
+            if (typeof s.suggestedValue !== 'string')
+                continue;
+            // Bail when a different diff is already showing — one at a time.
+            // Producer should serialize calls; if not, the second suggestion
+            // sits in the queue until the first is approved/rejected.
+            if (aiInlineDiffPluginKey.getState(editor.state) !== null)
+                continue;
+            const slice = parseRef.current(editor, s.suggestedValue);
+            if (!slice)
+                continue;
+            editor.commands.startAiInlineDiff(s.id, slice);
+            startedRef.current.add(s.id);
+        }
+        // Cleanup: when a suggestion leaves the context AND we previously
+        // started a diff for it, the editor should drop the diff state too.
+        // Approve dismisses via context → here we drop from startedRef.
+        const contextIds = new Set(list.map(s => s.id));
+        for (const id of Array.from(startedRef.current)) {
+            if (!contextIds.has(id))
+                startedRef.current.delete(id);
+        }
+    }, [editor, list]);
+    // Cross-tree applier — when the banner / chat-sidebar pill calls
+    // `pendingSuggestions.approve(id)` for one of our tracked suggestions,
+    // accept the diff. Editor is the source of truth for the new doc.
+    useEffect(() => {
+        if (!editor)
+            return;
+        const applier = (suggestion) => {
+            if (!startedRef.current.has(suggestion.id))
+                return;
+            editor.commands.acceptAiInlineDiff();
+        };
+        return registerPendingSuggestionApplier(undefined, fieldName, applier);
+    }, [editor, fieldName]);
+}
+function hasEditorRange(s) {
+    const meta = (s.meta ?? {});
+    const range = meta['editorRange'];
+    return !!(range && typeof range.from === 'number' && typeof range.to === 'number');
+}
+// useReducer + dispatch is the smallest-API force-update primitive React
+// ships. Hoisted into a helper so the call site stays one line.
+import { useReducer } from 'react';
+function useReducerForceUpdate() {
+    const [n, inc] = useReducer((x) => (x + 1) | 0, 0);
+    return [n, () => inc()];
+}
+//# sourceMappingURL=useAiInlineDiff.js.map

package/dist/react/useAiInlineDiff.js.map

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

package/dist/react/useAiSuggestionBridge.d.ts

@@ -21,7 +21,43 @@ import { type PendingSuggestion } from '@pilotiq/pilotiq/react';
  * hook had previously pushed (so an id added directly by host code via
  * `editor.commands.addAiSuggestion(...)` doesn't get reflected back through
  * a context that never knew about it).
+ *
+ * **Whole-field fallback** (chat-driven suggestions). Producers like
+ * `@pilotiq-pro/ai`'s `update_form_state` tool push suggestions that target
+ * the whole field — no `meta.editorRange`, just `suggestedValue` as a string.
+ * Without `editorRange` the bridge can't render the inline-diff chip widget
+ * (it has nowhere to anchor), so the host renderer passes an
+ * `onApplyWholeField(value)` callback. When the chat-sidebar Approve fires
+ * for a non-bridge-pushed id, the registered applier calls this callback
+ * instead of no-op'ing — letting each renderer apply the suggestion the
+ * right way for its shape (plain text → `plainTextToDoc`, markdown → set
+ * markdown source, richtext → setContent with HTML/JSON). The host is also
+ * responsible for the Approve UI — FieldShell hides its legacy overlay
+ * whenever a Tiptap renderer is mounted (richtext / markdown / collab text).
  */
-export declare function useAiSuggestionBridge(editor: Editor | null, fieldName: string): void;
+export interface UseAiSuggestionBridgeOptions {
+    /**
+     * Apply a whole-field suggestion that lacks `meta.editorRange`. Each
+     * Tiptap renderer passes its own implementation (different content
+     * shapes — plain text, markdown source, HTML/JSON). Omit for editors
+     * that should ignore whole-field suggestions entirely.
+     */
+    onApplyWholeField?: (suggestedValue: string) => void;
+    /**
+     * Synthesize a `{ from, to }` range for whole-field suggestions so the
+     * inline-diff chip widget can render BEFORE the user approves. The
+     * extension's `applyApprove` inserts a plain text node spanning the
+     * synthesized range — safe only for editors whose schema accepts a
+     * text-node replacement covering the whole doc (CollabTextRenderer's
+     * plain-text schema fits; richtext / markdown lose formatting if
+     * approved that way). Return `undefined` to skip synthesis and fall
+     * through to the legacy `onApplyWholeField` callback (silent swap).
+     */
+    synthesizeWholeFieldRange?: (editor: Editor, suggestion: PendingSuggestion) => {
+        from: number;
+        to: number;
+    } | undefined;
+}
+export declare function useAiSuggestionBridge(editor: Editor | null, fieldName: string, options?: UseAiSuggestionBridgeOptions): void;
 export type { PendingSuggestion };
 //# sourceMappingURL=useAiSuggestionBridge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useAiSuggestionBridge.d.ts","sourceRoot":"","sources":["../../src/react/useAiSuggestionBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAA;AAG/B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAiFpF;AAKD,YAAY,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"useAiSuggestionBridge.d.ts","sourceRoot":"","sources":["../../src/react/useAiSuggestionBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAA;AAG/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAA;IAEpD;;;;;;;;;OASG;IACH,yBAAyB,CAAC,EAAE,CAC1B,MAAM,EAAM,MAAM,EAClB,UAAU,EAAE,iBAAiB,KAC1B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC9C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,4BAAiC,GACzC,IAAI,CAuIN;AAKD,YAAY,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/react/useAiSuggestionBridge.js

@@ -1,36 +1,29 @@
 import { useEffect, useRef } from 'react';
 import { registerPendingSuggestionApplier, usePendingSuggestionsForField, } from '@pilotiq/pilotiq/react';
 import { aiSuggestionPluginKey } from '../extensions/AiSuggestionExtension.js';
-/**
- * Two-way sync between the cross-package `<PendingSuggestionsContext>`
- * queue and this editor's `AiSuggestionExtension` state.
- *
- *   - **Context → editor**: every entry whose `meta.editorRange = { from, to }`
- *     is present and whose `suggestedValue` is a string gets pushed into the
- *     editor as an inline-diff hunk via `addAiSuggestion`. Entries leaving the
- *     queue are removed from the editor via `rejectAiSuggestion` (no doc edit).
- *
- *   - **Editor → context**: when a chip's Approve / Reject button removes a
- *     hunk from the editor's plugin state, the matching id is dismissed from
- *     the queue (`dismiss(id)`) so other surfaces (e.g. the chat-sidebar pill,
- *     a future FieldShell overlay) clear in lock-step. The doc mutation
- *     itself happens inside the editor — context is just a notification.
- *
- * Cycle protection: the hook tracks which ids it has personally pushed to
- * the editor (`pushed`). The Context→editor pass never re-pushes an id that's
- * already there, and the Editor→context pass only dismisses ids that this
- * hook had previously pushed (so an id added directly by host code via
- * `editor.commands.addAiSuggestion(...)` doesn't get reflected back through
- * a context that never knew about it).
- */
-export function useAiSuggestionBridge(editor, fieldName) {
+export function useAiSuggestionBridge(editor, fieldName, options = {}) {
     const { list, dismiss } = usePendingSuggestionsForField(fieldName);
     // Hold the latest `dismiss` in a ref so the editor-side listener — which
     // installs once per editor — always reaches the up-to-date context API.
     const dismissRef = useRef(dismiss);
     useEffect(() => { dismissRef.current = dismiss; }, [dismiss]);
+    // Same ref pattern for the whole-field applier — captured here so the
+    // applier closure registered below stays stable across re-renders without
+    // re-registering on every option change.
+    const onApplyWholeFieldRef = useRef(options.onApplyWholeField);
+    useEffect(() => { onApplyWholeFieldRef.current = options.onApplyWholeField; }, [options.onApplyWholeField]);
+    const synthesizeRangeRef = useRef(options.synthesizeWholeFieldRange);
+    useEffect(() => { synthesizeRangeRef.current = options.synthesizeWholeFieldRange; }, [options.synthesizeWholeFieldRange]);
     // Set of ids this hook pushed; used by both directions for cycle control.
     const pushedRef = useRef(new Set());
+    // Subset of `pushedRef` whose range was synthesized (no producer-supplied
+    // `meta.editorRange`). Approving these must NOT route through the chip's
+    // plain-text replace — that would clobber HTML / markdown formatting on
+    // rich editors. Instead the applier delegates to `onApplyWholeField`,
+    // which sets content via the renderer's content-shape-aware command
+    // (`setContent(plainTextToDoc(...))` / `setContent(markdownSrc)` /
+    // `setContent(html)`), then clears the chip without a doc edit.
+    const synthesizedRef = useRef(new Set());
     // Context → editor.
     useEffect(() => {
         if (!editor)
@@ -40,9 +33,25 @@ export function useAiSuggestionBridge(editor, fieldName) {
             if (pushedRef.current.has(s.id))
                 continue;
             const meta = (s.meta ?? {});
-            const range = meta['editorRange'];
-            if (!range || typeof range.from !== 'number' || typeof range.to !== 'number')
-                continue;
+            const rawRange = meta['editorRange'];
+            let range;
+            let isSynthesized = false;
+            if (rawRange && typeof rawRange.from === 'number' && typeof rawRange.to === 'number') {
+                range = { from: rawRange.from, to: rawRange.to };
+            }
+            else {
+                // Producer didn't supply a range — let the renderer synthesize one
+                // so the inline-diff chip widget can still render. Renderers that
+                // can't safely round-trip a plain-text replace (richtext/markdown
+                // losing formatting on approve) STILL benefit by synthesizing for
+                // visualization — the applier below routes Approve through
+                // `onApplyWholeField` for synthesized ids instead of the chip's
+                // text-node replace.
+                range = synthesizeRangeRef.current?.(editor, s);
+                if (!range)
+                    continue;
+                isSynthesized = true;
+            }
             const replacement = typeof s.suggestedValue === 'string' ? s.suggestedValue : '';
             editor.commands.addAiSuggestion({
                 id: s.id,
@@ -52,6 +61,8 @@ export function useAiSuggestionBridge(editor, fieldName) {
                 ...(s.source ? { source: s.source } : {}),
             });
             pushedRef.current.add(s.id);
+            if (isSynthesized)
+                synthesizedRef.current.add(s.id);
         }
         for (const id of Array.from(pushedRef.current)) {
             if (contextIds.has(id))
@@ -60,6 +71,7 @@ export function useAiSuggestionBridge(editor, fieldName) {
             // mutating the doc (rejectAiSuggestion drops state only).
             editor.commands.rejectAiSuggestion(id);
             pushedRef.current.delete(id);
+            synthesizedRef.current.delete(id);
         }
     }, [editor, list]);
     // Editor → context.
@@ -92,13 +104,32 @@ export function useAiSuggestionBridge(editor, fieldName) {
         if (!editor)
             return;
         const applier = (suggestion) => {
-            // Bail when the suggestion isn't one of ours (no editor range or
-            // bridge-pushed entry). Pro provider falls back to plain dismiss.
-            if (!pushedRef.current.has(suggestion.id))
+            const apply = onApplyWholeFieldRef.current;
+            const hasSynthesized = synthesizedRef.current.has(suggestion.id);
+            const hasPushed = pushedRef.current.has(suggestion.id);
+            // Synthesized whole-field range — the chip rendered for visualization,
+            // but routing Approve through the editor's `approveAiSuggestion` would
+            // do a plain-text replace and clobber HTML / markdown formatting.
+            // Delegate to the renderer-supplied applier (content-shape-aware)
+            // and clear the chip state without a doc edit.
+            if (hasSynthesized && apply && typeof suggestion.suggestedValue === 'string') {
+                apply(suggestion.suggestedValue);
+                editor.commands.rejectAiSuggestion(suggestion.id);
                 return;
-            editor.chain().focus().approveAiSuggestion(suggestion.id).run();
-            // The transaction listener above sees the editor state drop the id
-            // and calls `dismiss(id)` on its own — no manual mirror needed.
+            }
+            // Producer-supplied editor range — surgical edit. Forward Approve to
+            // the editor command; the transaction listener above mirrors the
+            // dismiss back into context.
+            if (hasPushed) {
+                editor.chain().focus().approveAiSuggestion(suggestion.id).run();
+                return;
+            }
+            // Whole-field path WITHOUT visualization — producer skipped the range
+            // and the renderer didn't synthesize. Same applier as above, no chip
+            // to clear. Context's `approve()` dismisses the queue entry.
+            if (apply && typeof suggestion.suggestedValue === 'string') {
+                apply(suggestion.suggestedValue);
+            }
         };
         // Editor renderers don't currently have access to a `formId` here;
         // pass `undefined` so the wildcard form scope resolves. Phase 8.5+

package/dist/react/useAiSuggestionBridge.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilotiq/tiptap",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "description": "Tiptap rich-text editor adapter for @pilotiq/pilotiq — slash menu, draggable blocks, custom-block API",
   "license": "MIT",
   "repository": {
@@ -30,26 +30,28 @@
       "types": "./dist/render.d.ts"
     }
   },
-  "dependencies": {},
+  "dependencies": {
+    "prosemirror-changeset": "^2.4.1"
+  },
   "peerDependencies": {
-    "@pilotiq/pilotiq": ">=0.6.0 <1.0.0",
     "@base-ui/react": "^1",
+    "@pilotiq/pilotiq": ">=0.6.0 <1.0.0",
     "@tiptap/core": "^3",
-    "@tiptap/pm": "^3",
-    "@tiptap/react": "^3",
-    "@tiptap/starter-kit": "^3",
+    "@tiptap/extension-color": "3.22.4",
+    "@tiptap/extension-details": "3.22.4",
+    "@tiptap/extension-highlight": "3.22.4",
+    "@tiptap/extension-image": "3.22.4",
     "@tiptap/extension-link": "^3",
     "@tiptap/extension-placeholder": "^3",
-    "@tiptap/extension-underline": "3.22.4",
     "@tiptap/extension-subscript": "3.22.4",
     "@tiptap/extension-superscript": "3.22.4",
+    "@tiptap/extension-table": "3.22.4",
     "@tiptap/extension-text-align": "3.22.4",
     "@tiptap/extension-text-style": "3.22.4",
-    "@tiptap/extension-color": "3.22.4",
-    "@tiptap/extension-highlight": "3.22.4",
-    "@tiptap/extension-image": "3.22.4",
-    "@tiptap/extension-table": "3.22.4",
-    "@tiptap/extension-details": "3.22.4",
+    "@tiptap/extension-underline": "3.22.4",
+    "@tiptap/pm": "^3",
+    "@tiptap/react": "^3",
+    "@tiptap/starter-kit": "^3",
     "@tiptap/suggestion": "^3",
     "react": "^18 || ^19",
     "react-dom": "^18 || ^19"
@@ -57,36 +59,36 @@
   "devDependencies": {
     "@base-ui/react": "^1",
     "@tiptap/core": "^3",
-    "@tiptap/pm": "^3",
-    "@tiptap/react": "^3",
-    "@tiptap/starter-kit": "^3",
+    "@tiptap/extension-color": "3.22.4",
+    "@tiptap/extension-details": "3.22.4",
+    "@tiptap/extension-highlight": "3.22.4",
+    "@tiptap/extension-image": "3.22.4",
     "@tiptap/extension-link": "^3",
     "@tiptap/extension-placeholder": "^3",
-    "@tiptap/extension-underline": "3.22.4",
     "@tiptap/extension-subscript": "3.22.4",
     "@tiptap/extension-superscript": "3.22.4",
+    "@tiptap/extension-table": "3.22.4",
     "@tiptap/extension-text-align": "3.22.4",
     "@tiptap/extension-text-style": "3.22.4",
-    "@tiptap/extension-color": "3.22.4",
-    "@tiptap/extension-highlight": "3.22.4",
-    "@tiptap/extension-image": "3.22.4",
-    "@tiptap/extension-table": "3.22.4",
-    "@tiptap/extension-details": "3.22.4",
+    "@tiptap/extension-underline": "3.22.4",
+    "@tiptap/pm": "^3",
+    "@tiptap/react": "^3",
+    "@tiptap/starter-kit": "^3",
     "@tiptap/suggestion": "^3",
-    "tiptap-markdown": "^0.9",
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "esbuild": "^0.27",
     "react": "^19",
     "react-dom": "^19",
+    "tiptap-markdown": "^0.9",
     "typescript": "^5",
-    "@pilotiq/pilotiq": "^0.18.0"
+    "@pilotiq/pilotiq": "^0.19.0"
   },
   "author": "Suleiman Shahbari",
   "scripts": {
     "build": "tsc -p tsconfig.build.json && pnpm run bundle:markdown",
-    "bundle:markdown": "esbuild src/markdownExtension.ts --bundle --format=esm --outfile=dist/markdownExtension.js --external:@tiptap/* --sourcemap",
+    "bundle:markdown": "esbuild src/markdownExtension.ts --bundle --format=esm --outfile=dist/markdownExtension.js --external:@tiptap/* && rm -f dist/markdownExtension.js.map",
     "dev": "tsc -p tsconfig.build.json --watch",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src",