@pilotiq/tiptap 3.19.2 → 4.0.0

package/dist/react/MarkdownEditor.js

@@ -13,12 +13,12 @@ import { DOMParser as ProseMirrorDOMParser } from '@tiptap/pm/model';
 import { Markdown } from '../markdownExtension.js';
 import { useCollabRoom, getCollabExtensions, useToast, } from '@pilotiq/pilotiq/react';
 import { useCollabSeed } from '@rudderjs/sync/react';
-import { AiSuggestionExtension } from '../extensions/AiSuggestionExtension.js';
-import { AiInlineDiffExtension } from '../extensions/AiInlineDiffExtension.js';
+import { SuggestionChipExtension } from '../extensions/SuggestionChipExtension.js';
+import { InlineDiffExtension } from '../extensions/InlineDiffExtension.js';
 import { Alert, AlertTitle, AlertBody, ContentBlockKeymap } from '../extensions/contentBlocks.js';
-import { useAiSuggestionBridge } from './useAiSuggestionBridge.js';
-import { useAiInlineDiff, useIsAiInlineDiffActive, readAiDiffViewMarker } from './useAiInlineDiff.js';
-import { AiSuggestionBanner } from './AiSuggestionBanner.js';
+import { useSuggestionBridge } from './useSuggestionBridge.js';
+import { useInlineDiff, useIsInlineDiffActive, readDiffViewMarker } from './useInlineDiff.js';
+import { SuggestionBanner } from './SuggestionBanner.js';
 import { getMarkdownString, parseMarkdownToHtml } from '../markdownStorage.js';
 // Inline lucide.dev SVGs — same posture as `toolbarButtons.tsx` so this
 // package doesn't pull `lucide-react` as a peer dep. Keep stroke / size
@@ -135,13 +135,13 @@ export function MarkdownEditor({ name, fragmentKey, defaultValue, placeholder, d
             Image.configure({ inline: false, allowBase64: false }),
             Placeholder.configure({ placeholder: placeholder ?? 'Write in markdown…' }),
             // AI suggestions — chip widget for surgical (range-anchored) edits.
-            AiSuggestionExtension,
+            SuggestionChipExtension,
             // AI inline diff — Tiptap-Pro-style visualization for whole-field
             // suggestions (prosemirror-changeset under the hood). Decorations
             // show green-background inserts inline + red-strikethrough widgets
-            // for deleted text. Host's `<AiSuggestionBanner>` drives Accept /
+            // for deleted text. Host's `<SuggestionBanner>` drives Accept /
             // Reject via the extension's commands.
-            AiInlineDiffExtension,
+            InlineDiffExtension,
             // Alert content block — round-trips to `:::alert{type=…} Title` via the
             // node's `markdown` storage spec; renders the same shadcn NodeView.
             Alert,
@@ -167,13 +167,13 @@ export function MarkdownEditor({ name, fragmentKey, defaultValue, placeholder, d
         editor.setEditable(!disabled && tab === 'editor');
     }, [editor, disabled, tab]);
     // Cross-package suggestion bridge — sync the host's
-    // `<PendingSuggestionsContext>` queue with the editor's `AiSuggestion`
+    // `<PendingSuggestionsContext>` queue with the editor's `InlineSuggestion`
     // extension. No-op when no provider is mounted (default no-op context).
     //
     // Whole-field handling: NO chip widget here. The chip's `textContent`
     // renderer surfaces raw markdown (`## Heading\n- item`) as literal text
     // inside the green pill — visually unparseable for multi-paragraph
-    // rewrites. Instead, `<AiSuggestionBanner>` mounts below the editor
+    // rewrites. Instead, `<SuggestionBanner>` mounts below the editor
     // (see render below). Producer-supplied range suggestions still ride
     // the inline chip path — those have a precise anchor worth showing
     // in context.
@@ -182,7 +182,7 @@ export function MarkdownEditor({ name, fragmentKey, defaultValue, placeholder, d
             return;
         editor.commands.setContent(value);
     };
-    useAiSuggestionBridge(editor ?? null, name, {
+    useSuggestionBridge(editor ?? null, name, {
         onApplyWholeField: applyWholeField,
     });
     // Inline diff for whole-field suggestions — replaces the editor doc with
@@ -194,7 +194,7 @@ export function MarkdownEditor({ name, fragmentKey, defaultValue, placeholder, d
     //      that HTML into a Slice against THIS editor's schema — same path
     //      the editor's own clipboard-paste uses, so the slice is guaranteed
     //      schema-valid.
-    useAiInlineDiff(editor ?? null, name, {
+    useInlineDiff(editor ?? null, name, {
         parseSuggestion: (ed, value) => {
             try {
                 const html = parseMarkdownToHtml(ed, value);
@@ -208,9 +208,9 @@ export function MarkdownEditor({ name, fragmentKey, defaultValue, placeholder, d
                 return null;
             }
         },
-        resolveDisplayMode: () => readAiDiffViewMarker(name),
+        resolveDisplayMode: () => readDiffViewMarker(name),
     });
-    const isDiffActive = useIsAiInlineDiffActive(editor ?? null);
+    const isDiffActive = useIsInlineDiffActive(editor ?? null);
     // First-load seed for collab. Collaboration starts the editor empty
     // regardless of `content`; once the room's first sync resolves,
     // `useCollabSeed` runs the callback inside `ydoc.transact`. Empty
@@ -439,10 +439,10 @@ export function MarkdownEditor({ name, fragmentKey, defaultValue, placeholder, d
                                         : 'hover:bg-accent hover:text-accent-foreground',
                                     'disabled:opacity-50',
                                 ].join(' '), onClick: () => exec(b), disabled: disabled || (isAttach && uploading), title: labels[b] ?? b, "aria-label": labels[b] ?? b, "aria-pressed": active, children: isAttach && uploading ? Spinner : icon }, b));
-                        }) }))] }), tab === 'editor' && (_jsx("div", { className: "prose prose-sm dark:prose-invert max-w-none px-3 py-2 [&_.ProseMirror]:outline-none [&_.ProseMirror]:min-h-[6rem]", style: wrapperStyle, children: _jsx(EditorContent, { editor: editor }) })), tab === 'source' && (_jsx("textarea", { className: "w-full resize-y bg-transparent px-3 py-2 text-sm font-mono leading-relaxed outline-none disabled:opacity-50", style: wrapperStyle, value: sourceDraft, onChange: (e) => setSourceDraft(e.target.value), ...(placeholder !== undefined ? { placeholder } : {}), disabled: disabled, "aria-label": `${name} (markdown source)` })), tab === 'preview' && (_jsx("div", { className: "prose prose-sm dark:prose-invert max-w-none px-3 py-2", style: wrapperStyle, dangerouslySetInnerHTML: { __html: previewHtml || '<p class="text-muted-foreground italic">Nothing to preview</p>' } })), _jsx(AiSuggestionBanner, { fieldName: name, onApplyWholeField: applyWholeField, ...(isDiffActive && editor
+                        }) }))] }), tab === 'editor' && (_jsx("div", { className: "prose prose-sm dark:prose-invert max-w-none px-3 py-2 [&_.ProseMirror]:outline-none [&_.ProseMirror]:min-h-[6rem]", style: wrapperStyle, children: _jsx(EditorContent, { editor: editor }) })), tab === 'source' && (_jsx("textarea", { className: "w-full resize-y bg-transparent px-3 py-2 text-sm font-mono leading-relaxed outline-none disabled:opacity-50", style: wrapperStyle, value: sourceDraft, onChange: (e) => setSourceDraft(e.target.value), ...(placeholder !== undefined ? { placeholder } : {}), disabled: disabled, "aria-label": `${name} (markdown source)` })), tab === 'preview' && (_jsx("div", { className: "prose prose-sm dark:prose-invert max-w-none px-3 py-2", style: wrapperStyle, dangerouslySetInnerHTML: { __html: previewHtml || '<p class="text-muted-foreground italic">Nothing to preview</p>' } })), _jsx(SuggestionBanner, { fieldName: name, onApplyWholeField: applyWholeField, ...(isDiffActive && editor
                     ? {
-                        onAcceptViaEditor: () => editor.commands.acceptAiInlineDiff(),
-                        onRejectViaEditor: () => editor.commands.rejectAiInlineDiff(),
+                        onAcceptViaEditor: () => editor.commands.acceptInlineDiff(),
+                        onRejectViaEditor: () => editor.commands.rejectInlineDiff(),
                     }
                     : {}) })] }));
 }

package/dist/react/{AiSuggestionBanner.d.ts → SuggestionBanner.d.ts}

@@ -25,7 +25,7 @@ import { type PendingSuggestion } from '@pilotiq/pilotiq/react';
  * same field stack — Accept all / Reject all collapse the queue in one
  * pass.
  */
-export interface AiSuggestionBannerProps {
+export interface SuggestionBannerProps {
     /** Field name, matches the suggestion's `fieldName`. */
     fieldName: string;
     /**
@@ -35,8 +35,8 @@ export interface AiSuggestionBannerProps {
      * MarkdownEditor, HTML / JSON for TiptapEditor).
      *
      * Skipped when `onAcceptViaEditor` is supplied — that path means the
-     * editor already holds the proposed state via `AiInlineDiffExtension`,
-     * and Accept routes through `acceptAiInlineDiff()` instead. The host
+     * editor already holds the proposed state via `InlineDiffExtension`,
+     * and Accept routes through `acceptInlineDiff()` instead. The host
      * still calls `pendingSuggestions.approve(id)` afterwards to dismiss
      * the queue entry.
      */
@@ -64,10 +64,10 @@ export interface AiSuggestionBannerProps {
  * Hook variant — returns banner state without rendering, for renderers
  * that want to compose their own chrome. Renderer-agnostic.
  */
-export declare function useAiSuggestionBanner(fieldName: string): {
+export declare function useSuggestionBanner(fieldName: string): {
     pending: readonly PendingSuggestion[];
     approveAll: (apply: (value: string) => void) => void;
     rejectAll: () => void;
 };
-export declare function AiSuggestionBanner({ fieldName, onApplyWholeField, onAcceptViaEditor, onRejectViaEditor, className, }: AiSuggestionBannerProps): React.ReactElement | null;
-//# sourceMappingURL=AiSuggestionBanner.d.ts.map
+export declare function SuggestionBanner({ fieldName, onApplyWholeField, onAcceptViaEditor, onRejectViaEditor, className, }: SuggestionBannerProps): React.ReactElement | null;
+//# sourceMappingURL=SuggestionBanner.d.ts.map

package/dist/react/{AiSuggestionBanner.js → SuggestionBanner.js}

@@ -5,7 +5,7 @@ import { usePendingSuggestionsForField, usePendingSuggestions, } from '@pilotiq/
  * Hook variant — returns banner state without rendering, for renderers
  * that want to compose their own chrome. Renderer-agnostic.
  */
-export function useAiSuggestionBanner(fieldName) {
+export function useSuggestionBanner(fieldName) {
     const { list, dismiss } = usePendingSuggestionsForField(fieldName);
     // Only whole-field suggestions land in the banner. Range-anchored ones
     // ride the editor chip widget.
@@ -28,8 +28,8 @@ function hasEditorRange(s) {
     const range = meta['editorRange'];
     return !!(range && typeof range.from === 'number' && typeof range.to === 'number');
 }
-export function AiSuggestionBanner({ fieldName, onApplyWholeField, onAcceptViaEditor, onRejectViaEditor, className, }) {
-    const { pending, approveAll, rejectAll } = useAiSuggestionBanner(fieldName);
+export function SuggestionBanner({ fieldName, onApplyWholeField, onAcceptViaEditor, onRejectViaEditor, className, }) {
+    const { pending, approveAll, rejectAll } = useSuggestionBanner(fieldName);
     const { dismiss } = usePendingSuggestions();
     if (pending.length === 0)
         return null;
@@ -63,9 +63,9 @@ export function AiSuggestionBanner({ fieldName, onApplyWholeField, onAcceptViaEd
     // Per-suggestion controls when there's more than one — keeps the UX
     // discoverable. Single suggestion: Accept / Reject only.
     const single = pending.length === 1;
-    return (_jsxs("div", { role: "region", "aria-label": "AI suggested changes", "data-pilotiq-ai-banner": "", className: className ?? 'pilotiq-ai-banner', children: [_jsx("span", { className: "pilotiq-ai-banner-icon", "aria-hidden": "true", children: "\uD83D\uDCA1" }), _jsx("span", { className: "pilotiq-ai-banner-label", children: single
+    return (_jsxs("div", { role: "region", "aria-label": "AI suggested changes", "data-pilotiq-suggestion-banner": "", className: className ?? 'pilotiq-suggestion-banner', children: [_jsx("span", { className: "pilotiq-suggestion-banner-icon", "aria-hidden": "true", children: "\uD83D\uDCA1" }), _jsx("span", { className: "pilotiq-suggestion-banner-label", children: single
                     ? sourceLabel
                         ? `Changes suggested by ${sourceLabel}`
                         : 'Changes suggested'
-                    : `${pending.length} changes suggested` }), _jsxs("div", { className: "pilotiq-ai-banner-actions", children: [_jsx("button", { type: "button", className: "pilotiq-ai-banner-reject", onClick: handleReject, children: single ? 'Reject' : 'Reject all' }), _jsx("button", { type: "button", className: "pilotiq-ai-banner-accept", onClick: handleAccept, children: single ? 'Accept' : 'Accept all' })] })] }));
+                    : `${pending.length} changes suggested` }), _jsxs("div", { className: "pilotiq-suggestion-banner-actions", children: [_jsx("button", { type: "button", className: "pilotiq-suggestion-banner-reject", onClick: handleReject, children: single ? 'Reject' : 'Reject all' }), _jsx("button", { type: "button", className: "pilotiq-suggestion-banner-accept", onClick: handleAccept, children: single ? 'Accept' : 'Accept all' })] })] }));
 }

package/dist/react/TiptapEditor.js

@@ -17,24 +17,23 @@ import { contentBlockNodes } from '../extensions/contentBlocks.js';
 import { Popover } from '@base-ui/react/popover';
 import { useCollabRoom, getCollabExtensions, useRowCoords, parseRowFieldPath } from '@pilotiq/pilotiq/react';
 import { useCollabSeed } from '@rudderjs/sync/react';
-import { useAiSuggestionBridge } from './useAiSuggestionBridge.js';
-import { useAiInlineDiff, useIsAiInlineDiffActive, readAiDiffViewMarker } from './useAiInlineDiff.js';
-import { AiSuggestionBanner } from './AiSuggestionBanner.js';
+import { useSuggestionBridge } from './useSuggestionBridge.js';
+import { useInlineDiff, useIsInlineDiffActive, readDiffViewMarker } from './useInlineDiff.js';
+import { SuggestionBanner } from './SuggestionBanner.js';
 import { DOMParser as ProseMirrorDOMParser } from '@tiptap/pm/model';
 import { BlockNodeExtension } from '../extensions/BlockNodeExtension.js';
 import { SlashCommandExtension, } from '../extensions/SlashCommandExtension.js';
 import { DragHandleExtension } from '../extensions/DragHandleExtension.js';
 import { MergeTagExtension } from '../extensions/MergeTagExtension.js';
 import { LeadMarkExtension, SmallMarkExtension } from '../extensions/TextSizeMarks.js';
-import { AiSuggestionExtension } from '../extensions/AiSuggestionExtension.js';
-import { AiInlineDiffExtension } from '../extensions/AiInlineDiffExtension.js';
+import { SuggestionChipExtension } from '../extensions/SuggestionChipExtension.js';
+import { InlineDiffExtension } from '../extensions/InlineDiffExtension.js';
 import { MentionExtension, } from '../extensions/MentionExtension.js';
 import { SlashMenu } from './SlashMenu.js';
 import { MentionMenu } from './MentionMenu.js';
 import { FloatingToolbar } from './FloatingToolbar.js';
 import { TableFloatingToolbar } from './TableFloatingToolbar.js';
 import { Toolbar, AttachFilesDialog, useEditorTick } from './Toolbar.js';
-import { BlockSidePanel } from './BlockSidePanel.js';
 /**
  * The pilotiq field renderer for `RichTextField`. Registered globally via
  * `registerTiptap()`; pilotiq's `SchemaRenderer` looks it up by `fieldType:
@@ -168,36 +167,9 @@ function ClientEditor(props) {
             setMentionDismissed(false);
         setRawMentionState(s);
     }, []);
-    // Custom-block side panel — opens when a block's NodeView fires its
-    // Edit button. The NodeView lives in a separate React tree and reaches
-    // us via `BlockNodeExtension.options.onEdit` (set during configure()
-    // below). Stores `pos` + `blockType` at open-time; `BlockSidePanel`
-    // tracks the position forward through transactions and writes attrs
-    // back via setNodeMarkup. Closing nullifies the slot — re-opening
-    // remounts the panel fresh, including a re-snapshot of `blockData`.
-    const [selectedBlock, setSelectedBlock] = useState(null);
-    const handleEditBlock = useCallback((pos) => {
-        // We resolve `blockType` here against the current doc so a stale
-        // pos (e.g. the block was just deleted before the click landed)
-        // produces a no-op rather than an empty panel.
-        setSelectedBlock((prev) => {
-            // Read from the editor lazily — the editor ref isn't stable yet
-            // on the very first render where this callback is created, so
-            // defer the lookup to call time.
-            const ed = editorRef.current;
-            if (!ed)
-                return prev;
-            const node = ed.state.doc.nodeAt(pos);
-            if (!node || node.type.name !== 'pilotiqBlock')
-                return prev;
-            return { pos, blockType: String(node.attrs['blockType'] ?? '') };
-        });
-    }, []);
-    const closeBlockPanel = useCallback(() => { setSelectedBlock(null); }, []);
-    // editorRef gives the onEdit callback access to the editor instance
-    // without re-creating the callback on every render (which would force
-    // the extension config to re-evaluate, triggering a full editor reset).
-    const editorRef = useRef(null);
+    // Custom blocks (`pilotiqBlock`) edit inline now — the NodeView expands an
+    // accordion form and writes attrs back via `updateAttributes` itself, so the
+    // host needs no side panel, no `onEdit` bridge, and no position tracking.
     // Resolve the collab-attached extensions once per editor build.
     // `Collaboration` is constructed eagerly here (during `useEditor`'s
     // first call); the keyed remount above guarantees we never swap it.
@@ -283,10 +255,9 @@ function ClientEditor(props) {
             Placeholder.configure({ placeholder: placeholder ?? 'Start writing…' }),
             // BlockNodeExtension carries the block registry on its options —
             // NodeViews mount in a separate React tree and can't see context.
-            // `onEdit` is the bridge back to the host editor's tree where the
-            // side panel lives; the NodeView's Edit button calls it with its
-            // own `getPos()`.
-            BlockNodeExtension.configure({ blocks, onEdit: handleEditBlock }),
+            // The NodeView edits inline (accordion) and writes back itself, so no
+            // host callback is threaded here.
+            BlockNodeExtension.configure({ blocks }),
             ...(slashEnabled ? [SlashCommandExtension.configure({
                     blocks,
                     mergeTags,
@@ -307,10 +278,10 @@ function ClientEditor(props) {
                 })] : [MentionExtension]),
             DragHandleExtension,
             // AI suggestions — chip widget for surgical (range-anchored) edits.
-            AiSuggestionExtension,
+            SuggestionChipExtension,
             // AI inline diff — Tiptap-Pro-style visualization for whole-field
-            // suggestions via prosemirror-changeset. See AiInlineDiffExtension.
-            AiInlineDiffExtension,
+            // suggestions via prosemirror-changeset. See InlineDiffExtension.
+            InlineDiffExtension,
             // Realtime-collab extensions (Yjs `Collaboration` + cursor) — empty
             // when no `<RecordCollabRoom>` is mounted up-tree, or when no plugin
             // registered a factory via `registerCollabExtensions`.
@@ -400,12 +371,6 @@ function ClientEditor(props) {
         if (debounceRef.current)
             clearTimeout(debounceRef.current);
     }, []);
-    // Mirror the editor instance into a ref so callbacks captured during
-    // `useEditor`'s extension config (notably the BlockNode `onEdit`
-    // bridge) can reach the live editor without re-creating themselves
-    // every render. Re-creation would force the editor to rebuild from
-    // scratch on every keystroke.
-    useEffect(() => { editorRef.current = editor ?? null; }, [editor]);
     // Mirror `disabled` onto the live editor at runtime. `useEditor`'s
     // `editable: !disabled` only fires at construction time, so a parent
     // flipping read-only after mount (e.g. policy denial mid-edit, form
@@ -461,13 +426,13 @@ function ClientEditor(props) {
         }
     });
     // Cross-package suggestion bridge — sync the host's
-    // `<PendingSuggestionsContext>` queue with the editor's `AiSuggestion`
+    // `<PendingSuggestionsContext>` queue with the editor's `InlineSuggestion`
     // extension. No-op when no provider is mounted (default no-op context).
     //
     // Whole-field handling: NO chip widget here. The chip's `textContent`
     // renderer would surface raw HTML tags as literal text inside the
     // green pill — unparseable on multi-paragraph rewrites. Instead,
-    // `<AiSuggestionBanner>` mounts below the editor (see render below).
+    // `<SuggestionBanner>` mounts below the editor (see render below).
     // Producer-supplied range suggestions still ride the inline chip —
     // those have a precise anchor worth visualizing in context.
     const applyWholeField = (value) => {
@@ -475,7 +440,7 @@ function ClientEditor(props) {
             return;
         editor.commands.setContent(value);
     };
-    useAiSuggestionBridge(editor ?? null, name, {
+    useSuggestionBridge(editor ?? null, name, {
         onApplyWholeField: applyWholeField,
     });
     // Inline diff for whole-field suggestions. Pipeline mirrors MarkdownEditor:
@@ -483,7 +448,7 @@ function ClientEditor(props) {
     // on a RichTextField are typically HTML (or marked-up JSON that the
     // schema's DOMParser also handles via its serialized round-trip). For
     // JSON suggestions, the schema may reject — falls back to banner-only.
-    useAiInlineDiff(editor ?? null, name, {
+    useInlineDiff(editor ?? null, name, {
         parseSuggestion: (ed, value) => {
             try {
                 const container = document.createElement('div');
@@ -494,18 +459,18 @@ function ClientEditor(props) {
                 return null;
             }
         },
-        resolveDisplayMode: () => readAiDiffViewMarker(name),
+        resolveDisplayMode: () => readDiffViewMarker(name),
     });
-    const isDiffActive = useIsAiInlineDiffActive(editor ?? null);
+    const isDiffActive = useIsInlineDiffActive(editor ?? null);
     // Re-render the toolbar when the selection / marks change so active-state
     // booleans stay fresh.
     const tick = useEditorTick(editor);
-    return (_jsxs("div", { className: "relative flex flex-col", children: [_jsx("input", { type: "hidden", name: name, value: serialized }), editor && toolbarGroups && toolbarGroups.length > 0 && (_jsx(Toolbar, { editor: editor, groups: toolbarGroups, tick: tick, textColors: textColors, customTextColors: customTextColors, highlightColors: highlightColors, onAttachOpenChange: setAttachOpen })), editor && (_jsx(AttachFilesDialog, { open: attachOpen, onOpenChange: setAttachOpen, editor: editor, fieldName: name, ...(uploadUrl !== undefined ? { uploadUrl } : {}), ...(acceptedFileTypes !== undefined ? { acceptedFileTypes } : {}), ...(maxAttachmentSize !== undefined ? { maxFileSize: maxAttachmentSize } : {}), ...(attachmentDir !== undefined ? { directory: attachmentDir } : {}), ...(attachmentVis !== undefined ? { visibility: attachmentVis } : {}) })), _jsx(EditorContent, { editor: editor }), _jsx(AiSuggestionBanner, { fieldName: name, onApplyWholeField: applyWholeField, ...(isDiffActive && editor
+    return (_jsxs("div", { className: "relative flex flex-col", children: [_jsx("input", { type: "hidden", name: name, value: serialized }), editor && toolbarGroups && toolbarGroups.length > 0 && (_jsx(Toolbar, { editor: editor, groups: toolbarGroups, tick: tick, textColors: textColors, customTextColors: customTextColors, highlightColors: highlightColors, onAttachOpenChange: setAttachOpen })), editor && (_jsx(AttachFilesDialog, { open: attachOpen, onOpenChange: setAttachOpen, editor: editor, fieldName: name, ...(uploadUrl !== undefined ? { uploadUrl } : {}), ...(acceptedFileTypes !== undefined ? { acceptedFileTypes } : {}), ...(maxAttachmentSize !== undefined ? { maxFileSize: maxAttachmentSize } : {}), ...(attachmentDir !== undefined ? { directory: attachmentDir } : {}), ...(attachmentVis !== undefined ? { visibility: attachmentVis } : {}) })), _jsx(EditorContent, { editor: editor }), _jsx(SuggestionBanner, { fieldName: name, onApplyWholeField: applyWholeField, ...(isDiffActive && editor
                     ? {
-                        onAcceptViaEditor: () => editor.commands.acceptAiInlineDiff(),
-                        onRejectViaEditor: () => editor.commands.rejectAiInlineDiff(),
+                        onAcceptViaEditor: () => editor.commands.acceptInlineDiff(),
+                        onRejectViaEditor: () => editor.commands.rejectInlineDiff(),
                     }
-                    : {}) }), editor && floatingEnabled && _jsx(FloatingToolbar, { editor: editor }), editor && _jsx(TableFloatingToolbar, { editor: editor }), _jsx(SlashPopover, { state: slashState, keyHandlerRef: slashKeyRef }), _jsx(MentionPopover, { state: mentionState, keyHandlerRef: mentionKeyRef }), editor && selectedBlock && (_jsx(BlockSidePanel, { editor: editor, initialPos: selectedBlock.pos, blockType: selectedBlock.blockType, blocks: blocks, onClose: closeBlockPanel }, `${selectedBlock.pos}:${selectedBlock.blockType}`))] }));
+                    : {}) }), editor && floatingEnabled && _jsx(FloatingToolbar, { editor: editor }), editor && _jsx(TableFloatingToolbar, { editor: editor }), _jsx(SlashPopover, { state: slashState, keyHandlerRef: slashKeyRef }), _jsx(MentionPopover, { state: mentionState, keyHandlerRef: mentionKeyRef })] }));
 }
 /**
  * Cursor-anchored popover for the mention menu. Same Floating-UI / virtual-

package/dist/react/blockValues.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Pure value-coercion helpers for custom-block (`pilotiqBlock`) form data.
+ *
+ * The inline accordion editor in `BlockNodeView` snapshots its `<form>` via
+ * `new FormData(formEl)` → `parseFormDataToNested` (rebuilds nested arrays /
+ * objects from dotted-path inputs like `items.0.title`) → `coerceBlockValues`
+ * (per-fieldType JSON parse / boolean / number coerce so nested-shape fields
+ * round-trip in their canonical wire form) before writing the result back onto
+ * the node via `updateAttributes({ blockData })`.
+ *
+ * No React, no DOM, no editor — exported for unit tests.
+ */
+/**
+ * Per-fieldType coerce of a nested values map (built by
+ * `parseFormDataToNested`) against the block's schema. Mirrors the
+ * server-side `coerceFormValues` at a small subset suitable for the
+ * inline block editor — top-level block fields plus the immediate
+ * children of any Repeater rows / Builder rows.data.
+ *
+ * Non-coerce passthrough for: text, textarea, select, radio, date,
+ * dateTime, email, color, toggleButtons, slug, hidden. (Their wire shape
+ * is already a plain string / array of strings.)
+ *
+ * Coerce branches:
+ * - `toggle` / `checkbox`: 'true' / 'false' string → boolean.
+ * - `number` / `slider`: parse to Number, null on empty, raw string
+ *   passthrough on NaN (so a half-typed value isn't lost).
+ * - `tagsInput`: JSON-encoded string → string[].
+ * - `checkboxList`: JSON-encoded string OR array → string[].
+ * - `keyValue`: JSON-encoded string → Record<string, unknown>.
+ * - `fileUpload`: single → URL string passthrough; multiple →
+ *   JSON-encoded string → string[].
+ * - `repeater`: each row in the array gets recursive coerce against
+ *   the field's `template` (the inner field schema definition).
+ * - `builder`: each row's `data` gets recursive coerce against the
+ *   block matching `row.type` from `field.blocks[]`. Unknown block
+ *   types pass through verbatim — the renderer shows a placeholder
+ *   and the data round-trips intact across config rollbacks.
+ */
+export declare function coerceBlockValues(raw: Record<string, unknown>, schema: ReadonlyArray<Record<string, unknown>>): Record<string, unknown>;
+/**
+ * Read the resolved field value for a given input event target. Maps a
+ * single-input change onto its coerced wire shape — string passthrough
+ * for the common case; explicit coercion for booleans and numerics so
+ * the round-trip into the node attrs preserves shape. Exported for tests.
+ */
+export declare function readBlockFieldValue(target: {
+    type?: string;
+    value: string;
+    checked?: boolean;
+}, fieldMeta: {
+    fieldType?: unknown;
+}): unknown;
+//# sourceMappingURL=blockValues.d.ts.map

package/dist/react/blockValues.js

@@ -0,0 +1,161 @@
+/**
+ * Pure value-coercion helpers for custom-block (`pilotiqBlock`) form data.
+ *
+ * The inline accordion editor in `BlockNodeView` snapshots its `<form>` via
+ * `new FormData(formEl)` → `parseFormDataToNested` (rebuilds nested arrays /
+ * objects from dotted-path inputs like `items.0.title`) → `coerceBlockValues`
+ * (per-fieldType JSON parse / boolean / number coerce so nested-shape fields
+ * round-trip in their canonical wire form) before writing the result back onto
+ * the node via `updateAttributes({ blockData })`.
+ *
+ * No React, no DOM, no editor — exported for unit tests.
+ */
+/**
+ * Per-fieldType coerce of a nested values map (built by
+ * `parseFormDataToNested`) against the block's schema. Mirrors the
+ * server-side `coerceFormValues` at a small subset suitable for the
+ * inline block editor — top-level block fields plus the immediate
+ * children of any Repeater rows / Builder rows.data.
+ *
+ * Non-coerce passthrough for: text, textarea, select, radio, date,
+ * dateTime, email, color, toggleButtons, slug, hidden. (Their wire shape
+ * is already a plain string / array of strings.)
+ *
+ * Coerce branches:
+ * - `toggle` / `checkbox`: 'true' / 'false' string → boolean.
+ * - `number` / `slider`: parse to Number, null on empty, raw string
+ *   passthrough on NaN (so a half-typed value isn't lost).
+ * - `tagsInput`: JSON-encoded string → string[].
+ * - `checkboxList`: JSON-encoded string OR array → string[].
+ * - `keyValue`: JSON-encoded string → Record<string, unknown>.
+ * - `fileUpload`: single → URL string passthrough; multiple →
+ *   JSON-encoded string → string[].
+ * - `repeater`: each row in the array gets recursive coerce against
+ *   the field's `template` (the inner field schema definition).
+ * - `builder`: each row's `data` gets recursive coerce against the
+ *   block matching `row.type` from `field.blocks[]`. Unknown block
+ *   types pass through verbatim — the renderer shows a placeholder
+ *   and the data round-trips intact across config rollbacks.
+ */
+export function coerceBlockValues(raw, schema) {
+    const out = { ...raw };
+    for (const field of schema) {
+        const name = String(field['name'] ?? '');
+        if (!name)
+            continue;
+        const ft = String(field['fieldType'] ?? 'text');
+        const value = out[name];
+        out[name] = coerceField(value, ft, field);
+    }
+    return out;
+}
+function coerceField(value, ft, field) {
+    switch (ft) {
+        case 'toggle':
+        case 'checkbox':
+            return value === 'true' || value === true;
+        case 'number':
+        case 'slider':
+            return coerceNumber(value);
+        case 'tagsInput':
+            return parseJsonArray(value);
+        case 'checkboxList':
+            return parseJsonArray(value);
+        case 'keyValue':
+            return parseJsonObject(value);
+        case 'fileUpload': {
+            const multiple = Boolean(field['multiple']);
+            if (multiple)
+                return parseJsonArray(value);
+            return typeof value === 'string' ? value : '';
+        }
+        case 'repeater': {
+            if (!Array.isArray(value))
+                return [];
+            const template = field['template'] ?? [];
+            return value.map((row) => {
+                if (!row || typeof row !== 'object')
+                    return {};
+                return coerceBlockValues(row, template);
+            });
+        }
+        case 'builder': {
+            if (!Array.isArray(value))
+                return [];
+            const blockMetas = field['blocks'] ?? [];
+            return value.map((row) => {
+                if (!row || typeof row !== 'object')
+                    return { type: '', data: {} };
+                const r = row;
+                const type = String(r['type'] ?? '');
+                const data = r['data'] ?? {};
+                const block = blockMetas.find((b) => String(b['name'] ?? '') === type);
+                if (!block)
+                    return { type, data };
+                const tpl = block['template'] ?? [];
+                return { type, data: coerceBlockValues(data, tpl) };
+            });
+        }
+        default:
+            return value === undefined ? '' : value;
+    }
+}
+function coerceNumber(value) {
+    if (value === '' || value === null || value === undefined)
+        return null;
+    if (typeof value === 'number')
+        return value;
+    const raw = String(value);
+    if (raw === '')
+        return null;
+    const n = Number(raw);
+    return Number.isNaN(n) ? raw : n;
+}
+function parseJsonArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value !== 'string' || value === '')
+        return [];
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function parseJsonObject(value) {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value !== 'string' || value === '')
+        return {};
+    try {
+        const parsed = JSON.parse(value);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch { /* fall through */ }
+    return {};
+}
+/**
+ * Read the resolved field value for a given input event target. Maps a
+ * single-input change onto its coerced wire shape — string passthrough
+ * for the common case; explicit coercion for booleans and numerics so
+ * the round-trip into the node attrs preserves shape. Exported for tests.
+ */
+export function readBlockFieldValue(target, fieldMeta) {
+    const ft = String(fieldMeta.fieldType ?? 'text');
+    if (ft === 'toggle' || ft === 'checkbox') {
+        return target.checked === true;
+    }
+    if (ft === 'number' || ft === 'slider') {
+        const raw = target.value;
+        if (raw === '')
+            return null;
+        const n = Number(raw);
+        return Number.isNaN(n) ? raw : n;
+    }
+    return target.value;
+}

package/dist/react/floatingToolbarVisibility.d.ts

@@ -1,4 +1,4 @@
-import type { EditorState } from '@tiptap/pm/state';
+import { type EditorState } from '@tiptap/pm/state';
 /**
  * Inline marks the `FloatingToolbar` can toggle — bold / italic / strike /
  * code / link. A caret (empty selection) sitting inside any of these surfaces
@@ -10,7 +10,14 @@ export declare const TOOLBAR_MARKS: readonly ["bold", "italic", "strike", "code"
  * Whether the selection-based `FloatingToolbar` should be visible. A PURE
  * decision (no DOM / coords) so it's unit-testable against the real schema:
  *
- *  - never inside a callout/alert block — it owns its own chrome (#155);
+ *  - never on a whole-node selection of a non-text block — a schema-form
+ *    custom block card (`pilotiqBlock`), an image, an hr, or a whole Alert
+ *    block picked via the drag handle has no inline text to format, so it
+ *    must not surface the mark toolbar (#155);
+ *  - the toolbar DOES show for text inside the Alert's editable title/body —
+ *    those are real editable text nodes, so the formatting actions should
+ *    work there like anywhere else (an earlier over-correction suppressed the
+ *    whole Alert, including its editable text);
  *  - a caret (empty selection) shows ONLY when it sits inside a formatting
  *    mark (link / bold / …) so the mark can be edited without selecting (#156);
  *  - a non-empty range shows whenever it actually spans inline content (the

package/dist/react/floatingToolbarVisibility.js

@@ -1,4 +1,4 @@
-import { isSelectionInAlert } from '../extensions/contentBlocks.js';
+import { NodeSelection } from '@tiptap/pm/state';
 /**
  * Inline marks the `FloatingToolbar` can toggle — bold / italic / strike /
  * code / link. A caret (empty selection) sitting inside any of these surfaces
@@ -23,15 +23,24 @@ function caretInToolbarMark(state) {
  * Whether the selection-based `FloatingToolbar` should be visible. A PURE
  * decision (no DOM / coords) so it's unit-testable against the real schema:
  *
- *  - never inside a callout/alert block — it owns its own chrome (#155);
+ *  - never on a whole-node selection of a non-text block — a schema-form
+ *    custom block card (`pilotiqBlock`), an image, an hr, or a whole Alert
+ *    block picked via the drag handle has no inline text to format, so it
+ *    must not surface the mark toolbar (#155);
+ *  - the toolbar DOES show for text inside the Alert's editable title/body —
+ *    those are real editable text nodes, so the formatting actions should
+ *    work there like anywhere else (an earlier over-correction suppressed the
+ *    whole Alert, including its editable text);
  *  - a caret (empty selection) shows ONLY when it sits inside a formatting
  *    mark (link / bold / …) so the mark can be edited without selecting (#156);
  *  - a non-empty range shows whenever it actually spans inline content (the
  *    `childCount === 0` guard skips degenerate full-block selections).
  */
 export function shouldShowFloatingToolbar(state) {
-    if (isSelectionInAlert(state.selection))
+    const sel = state.selection;
+    if (sel instanceof NodeSelection && sel.node.isBlock && !sel.node.isTextblock) {
         return false;
+    }
     if (state.selection.empty)
         return caretInToolbarMark(state);
     const { from, to } = state.selection;