@pilotiq/tiptap 3.5.0 → 3.7.0

package/dist/react/useAiInlineDiff.js

@@ -0,0 +1,218 @@
+/**
+ * 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 { useEditorState } from '@tiptap/react';
+import { registerPendingSuggestionApplier, usePendingSuggestionsForField, } from '@pilotiq/pilotiq/react';
+import { aiInlineDiffPluginKey } from '../extensions/AiInlineDiffExtension.js';
+import { planReplaceBlock, planInsertBlockBefore, planDeleteBlock, planUpdateBlockMark, } from '../surgicalOps.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) {
+    const active = useEditorState({
+        editor,
+        selector: ({ editor: ed }) => !!ed && aiInlineDiffPluginKey.getState(ed.state) !== null,
+    });
+    return active ?? false;
+}
+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 /
+    // surgical-block suggestion. `meta.surgical` (if present) routes to a
+    // precise PM transaction; otherwise we treat the suggested value as a
+    // whole-field replacement. `meta.editorRange` (chip path) is filtered
+    // out — handled by AiSuggestionExtension elsewhere.
+    useEffect(() => {
+        if (!editor)
+            return;
+        const diffable = list.filter(s => !hasEditorRange(s));
+        for (const s of diffable) {
+            if (startedRef.current.has(s.id))
+                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 surgical = readSurgicalMeta(s);
+            if (surgical) {
+                const modifier = planSurgicalModifier(editor, surgical);
+                if (!modifier)
+                    continue;
+                editor.commands.applySurgicalAiInlineDiff(s.id, modifier);
+                startedRef.current.add(s.id);
+                continue;
+            }
+            if (typeof s.suggestedValue !== 'string')
+                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');
+}
+function parseSurgicalOp(obj) {
+    const op = obj['op'];
+    const blockIndex = obj['blockIndex'];
+    if (typeof blockIndex !== 'number')
+        return null;
+    switch (op) {
+        case 'replace_block':
+        case 'insert_block_before': {
+            const content = obj['content'];
+            if (typeof content !== 'string')
+                return null;
+            return { op, blockIndex, content };
+        }
+        case 'delete_block':
+            return { op, blockIndex };
+        case 'update_block_mark': {
+            const mark = obj['mark'];
+            const range = obj['range'];
+            const apply = obj['apply'];
+            const attrs = obj['attrs'];
+            if (typeof mark !== 'string')
+                return null;
+            if (!range || typeof range.from !== 'number' || typeof range.to !== 'number')
+                return null;
+            if (typeof apply !== 'boolean')
+                return null;
+            return {
+                op,
+                blockIndex,
+                mark,
+                range: { from: range.from, to: range.to },
+                apply,
+                ...(attrs && typeof attrs === 'object' ? { attrs: attrs } : {}),
+            };
+        }
+        default:
+            return null;
+    }
+}
+function readSurgicalMeta(s) {
+    const meta = (s.meta ?? {});
+    const raw = meta['surgical'];
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const obj = raw;
+    // Batch form: { ops: [SurgicalOp, ...] }
+    if (Array.isArray(obj['ops'])) {
+        const parsed = [];
+        for (const entry of obj['ops']) {
+            if (!entry || typeof entry !== 'object')
+                continue;
+            const op = parseSurgicalOp(entry);
+            if (op)
+                parsed.push(op);
+        }
+        if (parsed.length === 0)
+            return null;
+        return { ops: parsed };
+    }
+    return parseSurgicalOp(obj);
+}
+function planOp(editor, op) {
+    switch (op.op) {
+        case 'replace_block': return planReplaceBlock(editor, op.blockIndex, op.content);
+        case 'insert_block_before': return planInsertBlockBefore(editor, op.blockIndex, op.content);
+        case 'delete_block': return planDeleteBlock(editor, op.blockIndex);
+        case 'update_block_mark': return planUpdateBlockMark(editor, op.blockIndex, op.mark, op.range, op.apply, op.attrs);
+    }
+}
+/**
+ * Translate a surgical meta into a single TransactionModifier the diff
+ * extension can wrap with a snapshot. For batches, modifiers are
+ * computed against the original (pre-transaction) doc and then applied
+ * in DESC `blockIndex` order — each subsequent modifier touches earlier
+ * positions, so the prior modifiers' edits (at higher positions) don't
+ * shift the absolute positions the later modifiers were planned with.
+ *
+ * Returns null when the batch has no plannable ops (all out-of-range /
+ * unparseable). Drops individual non-plannable ops from a batch but
+ * still runs whatever did plan, so a single bad op doesn't kill the
+ * whole batch.
+ */
+function planSurgicalModifier(editor, surgical) {
+    if ('ops' in surgical) {
+        const sorted = [...surgical.ops].sort((a, b) => b.blockIndex - a.blockIndex);
+        const modifiers = [];
+        for (const op of sorted) {
+            const mod = planOp(editor, op);
+            if (mod)
+                modifiers.push(mod);
+        }
+        if (modifiers.length === 0)
+            return null;
+        return (tr) => { for (const mod of modifiers)
+            mod(tr); };
+    }
+    return planOp(editor, surgical);
+}
+//# 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/surgicalOps.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Surgical block-op planners for AI-driven precise edits.
+ *
+ * Each planner takes the editor + a logical block index + a payload and
+ * returns a `TransactionModifier` — a function the caller (typically
+ * `useAiInlineDiff`) feeds into
+ * `editor.commands.applySurgicalAiInlineDiff(id, modifier)`. The diff
+ * extension wraps the modifier in a snapshot-then-apply step so the
+ * inline-diff overlay renders against the precise changed range.
+ *
+ * "Block index" refers to a 0-based position across the doc's top-level
+ * children — what the AI agent sees as a numbered structural summary.
+ * Planners translate that to absolute ProseMirror positions internally.
+ *
+ * Planners return `null` when the request can't be satisfied (out-of-
+ * range index, unparseable HTML, unknown mark). Callers should treat
+ * `null` as "abort the surgical op" and surface a clear error to the
+ * agent so it can retry with a different plan.
+ */
+import type { Editor } from '@tiptap/core';
+import type { Transaction } from '@tiptap/pm/state';
+import type { Node as ProseMirrorNode } from '@tiptap/pm/model';
+export type TransactionModifier = (tr: Transaction) => void;
+/**
+ * Replace the top-level block at `blockIndex` with the parsed content.
+ * Caller-supplied `content` is HTML — multiple top-level nodes are
+ * allowed and will all land where the original block was.
+ */
+export declare function planReplaceBlock(editor: Editor, blockIndex: number, content: string): TransactionModifier | null;
+/**
+ * Insert one or more top-level nodes (parsed from `content` HTML)
+ * before the block at `blockIndex`. `blockIndex === doc.childCount`
+ * appends at the end.
+ */
+export declare function planInsertBlockBefore(editor: Editor, blockIndex: number, content: string): TransactionModifier | null;
+/**
+ * Delete the top-level block at `blockIndex`. Doc must retain at least
+ * one child after the delete (most schemas require this) — refuses to
+ * delete the last remaining block.
+ */
+export declare function planDeleteBlock(editor: Editor, blockIndex: number): TransactionModifier | null;
+export interface BlockMarkRange {
+    /** 0-based text offset from the start of the block's content. */
+    from: number;
+    /** Exclusive end offset. */
+    to: number;
+}
+/**
+ * Apply or remove an inline mark on a range *within* the block at
+ * `blockIndex`. `range.from` / `range.to` are text offsets relative to
+ * the start of the block's content (so `0` is the first character of
+ * the block, not the start of the doc).
+ *
+ * `apply = true` sets the mark (with optional `attrs`); `apply = false`
+ * removes it. Unknown marks (not in the editor's schema) return `null`
+ * so the caller can surface a clean error to the agent.
+ */
+export declare function planUpdateBlockMark(editor: Editor, blockIndex: number, mark: string, range: BlockMarkRange, apply: boolean, attrs?: Record<string, unknown>): TransactionModifier | null;
+/**
+ * Summarize a doc's top-level structure as a numbered list the AI can
+ * cite by index when proposing surgical ops. Each entry includes the
+ * block index, node type, and a truncated text preview — enough for the
+ * model to identify which block it wants to modify without sending the
+ * whole HTML/markdown back through token-priced channels.
+ *
+ * Returns one line per top-level child:
+ *   `[0] heading: Welcome to the docs`
+ *   `[1] paragraph: Lorem ipsum dolor sit amet…`
+ *   `[2] bulletList: 3 items`
+ */
+export declare function summarizeBlockStructure(doc: ProseMirrorNode, maxChars?: number): string;
+//# sourceMappingURL=surgicalOps.d.ts.map

package/dist/surgicalOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surgicalOps.d.ts","sourceRoot":"","sources":["../src/surgicalOps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAkB,IAAI,IAAI,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAG/E,MAAM,MAAM,mBAAmB,GAAG,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAA;AAyB3D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAM,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAK,MAAM,GACjB,mBAAmB,GAAG,IAAI,CAQ5B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAM,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAK,MAAM,GACjB,mBAAmB,GAAG,IAAI,CAQ5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAM,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,mBAAmB,GAAG,IAAI,CAO5B;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,EAAE,EAAI,MAAM,CAAA;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAM,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAQ,MAAM,EAClB,KAAK,EAAO,cAAc,EAC1B,KAAK,EAAO,OAAO,EACnB,KAAK,CAAC,EAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,mBAAmB,GAAG,IAAI,CAwB5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,SAAK,GAAG,MAAM,CAWnF"}

package/dist/surgicalOps.js

@@ -0,0 +1,160 @@
+/**
+ * Surgical block-op planners for AI-driven precise edits.
+ *
+ * Each planner takes the editor + a logical block index + a payload and
+ * returns a `TransactionModifier` — a function the caller (typically
+ * `useAiInlineDiff`) feeds into
+ * `editor.commands.applySurgicalAiInlineDiff(id, modifier)`. The diff
+ * extension wraps the modifier in a snapshot-then-apply step so the
+ * inline-diff overlay renders against the precise changed range.
+ *
+ * "Block index" refers to a 0-based position across the doc's top-level
+ * children — what the AI agent sees as a numbered structural summary.
+ * Planners translate that to absolute ProseMirror positions internally.
+ *
+ * Planners return `null` when the request can't be satisfied (out-of-
+ * range index, unparseable HTML, unknown mark). Callers should treat
+ * `null` as "abort the surgical op" and surface a clear error to the
+ * agent so it can retry with a different plan.
+ */
+import { DOMParser as PMDOMParser } from '@tiptap/pm/model';
+/** Resolve the start position of the top-level child at `blockIndex`. */
+function blockStartPos(doc, blockIndex) {
+    if (!Number.isInteger(blockIndex) || blockIndex < 0 || blockIndex >= doc.childCount)
+        return null;
+    let pos = 0;
+    for (let i = 0; i < blockIndex; i++)
+        pos += doc.child(i).nodeSize;
+    return pos;
+}
+/**
+ * Parse an HTML fragment into a doc-replaceable Slice. Uses the
+ * editor's own schema so block types unknown to the schema fail loudly
+ * rather than silently degrading.
+ *
+ * Returns `null` when DOM isn't available (SSR — shouldn't happen here,
+ * but keeps the planner safe).
+ */
+function parseHtmlToSlice(editor, html) {
+    if (typeof document === 'undefined')
+        return null;
+    const container = document.createElement('div');
+    container.innerHTML = html;
+    return PMDOMParser.fromSchema(editor.schema).parseSlice(container);
+}
+/**
+ * Replace the top-level block at `blockIndex` with the parsed content.
+ * Caller-supplied `content` is HTML — multiple top-level nodes are
+ * allowed and will all land where the original block was.
+ */
+export function planReplaceBlock(editor, blockIndex, content) {
+    const doc = editor.state.doc;
+    const start = blockStartPos(doc, blockIndex);
+    if (start === null)
+        return null;
+    const slice = parseHtmlToSlice(editor, content);
+    if (!slice)
+        return null;
+    const end = start + doc.child(blockIndex).nodeSize;
+    return (tr) => { tr.replace(start, end, slice); };
+}
+/**
+ * Insert one or more top-level nodes (parsed from `content` HTML)
+ * before the block at `blockIndex`. `blockIndex === doc.childCount`
+ * appends at the end.
+ */
+export function planInsertBlockBefore(editor, blockIndex, content) {
+    const doc = editor.state.doc;
+    if (!Number.isInteger(blockIndex) || blockIndex < 0 || blockIndex > doc.childCount)
+        return null;
+    const slice = parseHtmlToSlice(editor, content);
+    if (!slice)
+        return null;
+    let pos = 0;
+    for (let i = 0; i < blockIndex; i++)
+        pos += doc.child(i).nodeSize;
+    return (tr) => { tr.replace(pos, pos, slice); };
+}
+/**
+ * Delete the top-level block at `blockIndex`. Doc must retain at least
+ * one child after the delete (most schemas require this) — refuses to
+ * delete the last remaining block.
+ */
+export function planDeleteBlock(editor, blockIndex) {
+    const doc = editor.state.doc;
+    const start = blockStartPos(doc, blockIndex);
+    if (start === null)
+        return null;
+    if (doc.childCount <= 1)
+        return null;
+    const end = start + doc.child(blockIndex).nodeSize;
+    return (tr) => { tr.delete(start, end); };
+}
+/**
+ * Apply or remove an inline mark on a range *within* the block at
+ * `blockIndex`. `range.from` / `range.to` are text offsets relative to
+ * the start of the block's content (so `0` is the first character of
+ * the block, not the start of the doc).
+ *
+ * `apply = true` sets the mark (with optional `attrs`); `apply = false`
+ * removes it. Unknown marks (not in the editor's schema) return `null`
+ * so the caller can surface a clean error to the agent.
+ */
+export function planUpdateBlockMark(editor, blockIndex, mark, range, apply, attrs) {
+    const doc = editor.state.doc;
+    const start = blockStartPos(doc, blockIndex);
+    if (start === null)
+        return null;
+    const markType = editor.schema.marks[mark];
+    if (!markType)
+        return null;
+    const block = doc.child(blockIndex);
+    const blockInner = start + 1; // step inside the block's opening token
+    const contentMax = block.content.size;
+    if (!Number.isInteger(range.from) || !Number.isInteger(range.to))
+        return null;
+    const clampedFrom = Math.max(0, Math.min(range.from, contentMax));
+    const clampedTo = Math.max(clampedFrom, Math.min(range.to, contentMax));
+    if (clampedTo === clampedFrom)
+        return null;
+    const from = blockInner + clampedFrom;
+    const to = blockInner + clampedTo;
+    if (apply) {
+        const m = markType.create(attrs ?? null);
+        return (tr) => { tr.addMark(from, to, m); };
+    }
+    return (tr) => { tr.removeMark(from, to, markType); };
+}
+/**
+ * Summarize a doc's top-level structure as a numbered list the AI can
+ * cite by index when proposing surgical ops. Each entry includes the
+ * block index, node type, and a truncated text preview — enough for the
+ * model to identify which block it wants to modify without sending the
+ * whole HTML/markdown back through token-priced channels.
+ *
+ * Returns one line per top-level child:
+ *   `[0] heading: Welcome to the docs`
+ *   `[1] paragraph: Lorem ipsum dolor sit amet…`
+ *   `[2] bulletList: 3 items`
+ */
+export function summarizeBlockStructure(doc, maxChars = 80) {
+    const lines = [];
+    for (let i = 0; i < doc.childCount; i++) {
+        const node = doc.child(i);
+        const text = node.textContent.trim().replace(/\s+/g, ' ');
+        const preview = text.length === 0
+            ? describeStructuralNode(node)
+            : text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+        lines.push(`[${i}] ${node.type.name}: ${preview}`);
+    }
+    return lines.join('\n');
+}
+function describeStructuralNode(node) {
+    const kids = node.childCount;
+    if (kids === 0)
+        return '(empty)';
+    if (kids === 1)
+        return `1 ${node.firstChild?.type.name ?? 'child'}`;
+    return `${kids} children`;
+}
+//# sourceMappingURL=surgicalOps.js.map

package/dist/surgicalOps.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pilotiq/tiptap",
-  "version": "3.5.0",
+  "version": "3.7.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,29 +59,29 @@
   "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.19.0"
   },