@pilotiq/tiptap 0.1.0

package/dist/extensions/BlockNodeExtension.d.ts

@@ -0,0 +1,41 @@
+import { Node } from '@tiptap/core';
+import type { BlockMeta } from '../Block.js';
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        customBlock: {
+            /** Insert a custom-block node by type, with optional initial data. */
+            insertBlock: (blockType: string, blockData?: Record<string, unknown>) => ReturnType;
+        };
+    }
+}
+export interface BlockNodeOptions {
+    /**
+     * Block-meta registry. The NodeView reads from this to find the schema
+     * for the block-type it's rendering. Stashed on the extension's options
+     * because Tiptap's ReactNodeViewRenderer mounts NodeViews in a separate
+     * React tree — `useContext` does NOT reach them, so we can't pass
+     * registry data via React context.
+     */
+    blocks: BlockMeta[];
+    /**
+     * Bridge from the NodeView's separate React tree back to the editor's
+     * own tree, where the side panel lives. Set by `TiptapEditor` so the
+     * "Edit" button on each block can request the panel open against this
+     * specific node. `undefined` means no host is listening — the NodeView
+     * falls back to a no-op (does not render an Edit affordance, or does
+     * so disabled, depending on the consumer's chrome).
+     */
+    onEdit?: (pos: number) => void;
+}
+/**
+ * Single ProseMirror node type that represents every custom block. The
+ * concrete block type ("callout", "image", …) lives in `attrs.blockType`,
+ * and the per-block data lives in `attrs.blockData`. The React NodeView
+ * looks the type up in this extension's `options.blocks` and renders the
+ * matching inline form.
+ *
+ * Storing one node type per block name would scale O(n) extensions. This
+ * approach scales O(1).
+ */
+export declare const BlockNodeExtension: Node<BlockNodeOptions, any>;
+//# sourceMappingURL=BlockNodeExtension.d.ts.map

package/dist/extensions/BlockNodeExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockNodeExtension.d.ts","sourceRoot":"","sources":["../../src/extensions/BlockNodeExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,cAAc,CAAA;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,QAAQ,CAAC,UAAU;QAC3B,WAAW,EAAE;YACX,sEAAsE;YACtE,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,CAAA;SACpF,CAAA;KACF;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,6BAyF7B,CAAA"}

package/dist/extensions/BlockNodeExtension.js

@@ -0,0 +1,103 @@
+import { Node, mergeAttributes } from '@tiptap/core';
+import { ReactNodeViewRenderer } from '@tiptap/react';
+import { BlockNodeView } from '../react/BlockNodeView.js';
+/**
+ * Single ProseMirror node type that represents every custom block. The
+ * concrete block type ("callout", "image", …) lives in `attrs.blockType`,
+ * and the per-block data lives in `attrs.blockData`. The React NodeView
+ * looks the type up in this extension's `options.blocks` and renders the
+ * matching inline form.
+ *
+ * Storing one node type per block name would scale O(n) extensions. This
+ * approach scales O(1).
+ */
+export const BlockNodeExtension = Node.create({
+    // Avoid `name: 'block'` — ProseMirror's `block` is a schema group name,
+    // and naming a node identically to a group can collide subtly with
+    // schema content matching (TrailingNode threw "invalid content" on every
+    // dispatch with `name: 'block'`).
+    name: 'pilotiqBlock',
+    group: 'block',
+    // Mirrors the canonical Tiptap atom-block pattern (image / horizontalRule):
+    // omit `atom`/`selectable`, set `draggable: true`, no explicit `content`.
+    // Setting `atom: true` together with `group: 'block'` was making
+    // StarterKit's TrailingNode plugin throw "invalid content" on every
+    // dispatch — even before any block was inserted.
+    draggable: true,
+    addOptions() {
+        // `onEdit` intentionally omitted — `exactOptionalPropertyTypes` makes
+        // an explicit `undefined` non-assignable to the optional field, and
+        // the host wires it via `BlockNodeExtension.configure({ onEdit })`.
+        return { blocks: [] };
+    },
+    addAttributes() {
+        return {
+            blockType: {
+                default: null,
+                parseHTML: (el) => el.getAttribute('data-block-type'),
+                renderHTML: (attrs) => {
+                    if (!attrs['blockType'])
+                        return {};
+                    return { 'data-block-type': attrs['blockType'] };
+                },
+            },
+            blockData: {
+                // Default `null` rather than `{}` — ProseMirror compares attrs by
+                // reference for some equality checks, and a fresh `{}` per node
+                // create call breaks them subtly.
+                default: null,
+                parseHTML: (el) => {
+                    const raw = el.getAttribute('data-block-data');
+                    if (!raw)
+                        return null;
+                    try {
+                        return JSON.parse(raw);
+                    }
+                    catch {
+                        return null;
+                    }
+                },
+                renderHTML: (attrs) => {
+                    if (!attrs['blockData'])
+                        return {};
+                    return { 'data-block-data': JSON.stringify(attrs['blockData']) };
+                },
+            },
+        };
+    },
+    parseHTML() {
+        return [{ tag: 'div[data-pilotiq-block]' }];
+    },
+    renderHTML({ HTMLAttributes }) {
+        return ['div', mergeAttributes({ 'data-pilotiq-block': '' }, HTMLAttributes)];
+    },
+    addNodeView() {
+        return ReactNodeViewRenderer(BlockNodeView);
+    },
+    addCommands() {
+        return {
+            insertBlock: (blockType, blockData = {}) => ({ commands }) => commands.insertContent({
+                type: this.name,
+                attrs: { blockType, blockData },
+            }),
+        };
+    },
+    // `Mod-e` opens the side panel for the currently NodeSelected block.
+    // Returns false when no block is selected so the browser's default
+    // (Safari "Use Selection for Find", etc.) still applies in plain text.
+    addKeyboardShortcuts() {
+        return {
+            'Mod-e': () => {
+                const onEdit = this.options.onEdit;
+                if (!onEdit)
+                    return false;
+                const sel = this.editor.state.selection;
+                if (sel.node?.type.name !== this.name)
+                    return false;
+                onEdit(sel.from);
+                return true;
+            },
+        };
+    },
+});
+//# sourceMappingURL=BlockNodeExtension.js.map

package/dist/extensions/BlockNodeExtension.js.map

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

package/dist/extensions/DragHandleExtension.d.ts

@@ -0,0 +1,19 @@
+import { Extension } from '@tiptap/core';
+/**
+ * Hand-built drag handle: floats a six-dot button in the gutter on the left
+ * of whichever top-level block the cursor is hovering. Click-drag to reorder.
+ *
+ * Implementation (kept self-contained, no `tiptap-extension-global-drag-handle`
+ * dep — that pkg uses Tiptap internals that break across versions):
+ *
+ *  1. On mount, append a single `<button>` to `document.body`. It's the
+ *     handle. Position lives in CSS `top` / `left`.
+ *  2. On `mousemove` over the editor, find the top-level block under the
+ *     cursor via `posAtCoords` + climb to depth 1, then read its DOM rect
+ *     and align the handle to its top-left.
+ *  3. On `mousedown` on the handle, set `node` selection on that block and
+ *     dispatch a synthetic `dragstart` from the editor DOM — ProseMirror's
+ *     own drop logic handles reorder.
+ */
+export declare const DragHandleExtension: Extension<any, any>;
+//# sourceMappingURL=DragHandleExtension.d.ts.map

package/dist/extensions/DragHandleExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DragHandleExtension.d.ts","sourceRoot":"","sources":["../../src/extensions/DragHandleExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAYxC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,qBAW9B,CAAA"}

package/dist/extensions/DragHandleExtension.js

@@ -0,0 +1,166 @@
+import { Extension } from '@tiptap/core';
+import { NodeSelection, Plugin, PluginKey } from '@tiptap/pm/state';
+const dragHandlePluginKey = new PluginKey('pilotiqDragHandle');
+// Node types whose direct children are the draggable units (e.g. each
+// `listItem` of a `bulletList` is a draggable unit). Listed forward-compat
+// includes `taskList` even though StarterKit 3 doesn't ship it; if a consumer
+// registers it later it'll just work.
+const LIST_CONTAINERS = new Set(['bulletList', 'orderedList', 'taskList']);
+/**
+ * Hand-built drag handle: floats a six-dot button in the gutter on the left
+ * of whichever top-level block the cursor is hovering. Click-drag to reorder.
+ *
+ * Implementation (kept self-contained, no `tiptap-extension-global-drag-handle`
+ * dep — that pkg uses Tiptap internals that break across versions):
+ *
+ *  1. On mount, append a single `<button>` to `document.body`. It's the
+ *     handle. Position lives in CSS `top` / `left`.
+ *  2. On `mousemove` over the editor, find the top-level block under the
+ *     cursor via `posAtCoords` + climb to depth 1, then read its DOM rect
+ *     and align the handle to its top-left.
+ *  3. On `mousedown` on the handle, set `node` selection on that block and
+ *     dispatch a synthetic `dragstart` from the editor DOM — ProseMirror's
+ *     own drop logic handles reorder.
+ */
+export const DragHandleExtension = Extension.create({
+    name: 'pilotiqDragHandle',
+    addProseMirrorPlugins() {
+        return [
+            new Plugin({
+                key: dragHandlePluginKey,
+                view: (view) => createDragHandleView(view),
+            }),
+        ];
+    },
+});
+function createDragHandleView(view) {
+    const handle = document.createElement('button');
+    handle.type = 'button';
+    handle.setAttribute('data-pilotiq-drag-handle', '');
+    handle.setAttribute('contenteditable', 'false');
+    handle.setAttribute('aria-label', 'Drag block');
+    handle.setAttribute('draggable', 'true');
+    handle.style.cssText = [
+        'position: absolute',
+        'display: none',
+        'cursor: grab',
+        'background: transparent',
+        'border: 0',
+        'padding: 2px',
+        'color: var(--muted-foreground, #888)',
+        'opacity: 0',
+        'transition: opacity 0.15s',
+        'z-index: 50',
+        'line-height: 1',
+        'border-radius: 4px',
+    ].join(';');
+    handle.innerHTML = '<svg width="8" height="12" viewBox="0 0 8 12" fill="currentColor" aria-hidden="true"><circle cx="2" cy="2" r="1"/><circle cx="2" cy="6" r="1"/><circle cx="2" cy="10" r="1"/><circle cx="6" cy="2" r="1"/><circle cx="6" cy="6" r="1"/><circle cx="6" cy="10" r="1"/></svg>';
+    document.body.appendChild(handle);
+    let activePos = null;
+    const onMouseMove = (event) => {
+        const editorRect = view.dom.getBoundingClientRect();
+        const inside = event.clientX >= editorRect.left - 60 &&
+            event.clientX <= editorRect.right &&
+            event.clientY >= editorRect.top &&
+            event.clientY <= editorRect.bottom;
+        if (!inside) {
+            hide();
+            return;
+        }
+        const pos = view.posAtCoords({ left: event.clientX, top: event.clientY });
+        if (!pos) {
+            hide();
+            return;
+        }
+        const $pos = view.state.doc.resolve(pos.pos);
+        // Pick the deepest ancestor whose parent is the doc OR a list container —
+        // that's the "unit" the user expects the handle to grab. So inside a
+        // bullet list, hovering an item resolves to the list_item (not the whole
+        // bullet_list); inside a blockquote, hovering its inner paragraph resolves
+        // to the blockquote (since the blockquote's parent is the doc).
+        let blockDepth = 1;
+        for (let d = $pos.depth; d >= 1; d--) {
+            const parentName = $pos.node(d - 1).type.name;
+            if (parentName === 'doc' || LIST_CONTAINERS.has(parentName)) {
+                blockDepth = d;
+                break;
+            }
+        }
+        const blockPos = $pos.before(blockDepth);
+        const blockNode = view.nodeDOM(blockPos);
+        if (!blockNode) {
+            hide();
+            return;
+        }
+        const rect = blockNode.getBoundingClientRect();
+        handle.style.display = 'block';
+        handle.style.opacity = '1';
+        handle.style.top = `${rect.top + window.scrollY + 4}px`;
+        // Pin X to the editor's left gutter (not the block's left edge). For
+        // nested content the block's `rect.left` sits past the indent / bullet
+        // gutter, so handles for list items would overlap their bullets. Keeping
+        // the handle in a fixed column lets the eye track which block it points
+        // at by vertical alignment alone.
+        handle.style.left = `${editorRect.left + window.scrollX + 16}px`;
+        activePos = blockPos;
+    };
+    const hide = () => {
+        handle.style.opacity = '0';
+        handle.style.display = 'none';
+        activePos = null;
+    };
+    const onMouseLeave = (event) => {
+        // Don't hide while moving onto the handle itself.
+        if (event.relatedTarget === handle)
+            return;
+        hide();
+    };
+    const onDragStart = (event) => {
+        if (activePos === null || !event.dataTransfer)
+            return;
+        const node = view.state.doc.nodeAt(activePos);
+        if (!node)
+            return;
+        // Select the block as a NodeSelection so PM treats the drag as a node
+        // move, not a text-range move.
+        const selection = NodeSelection.create(view.state.doc, activePos);
+        view.dispatch(view.state.tr.setSelection(selection));
+        // PM's drop handler reads `view.dragging` for in-editor drags. Without
+        // it the drop falls back to clipboard-HTML parsing and silently no-ops
+        // (drop returns to origin). This is the line that actually fixes drop.
+        const slice = selection.content();
+        view.dragging = {
+            slice,
+            move: !event.ctrlKey && !event.metaKey,
+        };
+        // Use PM's clipboard serializer so the drag carries proper HTML — both
+        // for cross-editor pastes and as the visible drag image.
+        const { dom, text } = view.serializeForClipboard(slice);
+        event.dataTransfer.clearData();
+        event.dataTransfer.setData('text/html', dom.innerHTML);
+        event.dataTransfer.setData('text/plain', text);
+        event.dataTransfer.effectAllowed = 'copyMove';
+        // Drag image = the actual block, not the handle button.
+        const blockNode = view.nodeDOM(activePos);
+        if (blockNode)
+            event.dataTransfer.setDragImage(blockNode, 0, 0);
+        handle.style.cursor = 'grabbing';
+    };
+    const onDragEnd = () => {
+        handle.style.cursor = 'grab';
+    };
+    view.dom.addEventListener('mousemove', onMouseMove);
+    view.dom.addEventListener('mouseleave', onMouseLeave);
+    handle.addEventListener('dragstart', onDragStart);
+    handle.addEventListener('dragend', onDragEnd);
+    return {
+        destroy: () => {
+            view.dom.removeEventListener('mousemove', onMouseMove);
+            view.dom.removeEventListener('mouseleave', onMouseLeave);
+            handle.removeEventListener('dragstart', onDragStart);
+            handle.removeEventListener('dragend', onDragEnd);
+            handle.remove();
+        },
+    };
+}
+//# sourceMappingURL=DragHandleExtension.js.map

package/dist/extensions/DragHandleExtension.js.map

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

package/dist/extensions/GridExtension.d.ts

@@ -0,0 +1,49 @@
+import { Node } from '@tiptap/core';
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        grid: {
+            /**
+             * Insert a multi-column grid at the cursor. Each column gets one
+             * empty paragraph. Defaults to 2 columns; pass `{ columns: 3 }` for
+             * the three-column variant.
+             */
+            setGrid: (options?: {
+                columns?: GridColumns;
+            }) => ReturnType;
+            /**
+             * Unwrap the enclosing grid: replace the grid node with the flat
+             * concatenation of every column's children. No-op when the cursor
+             * isn't inside a grid.
+             */
+            unsetGrid: () => ReturnType;
+        };
+    }
+}
+/** Allowed column counts. */
+export type GridColumns = 2 | 3;
+/**
+ * Coerce any input into one of the allowed column counts. Out-of-range
+ * values, NaN, undefined, and non-numeric strings all fall back to 2 — the
+ * conservative default.
+ *
+ * Exported for unit tests and so the renderer in `render.ts` can share the
+ * same validator with the editor's `parseHTML`.
+ */
+export declare function clampGridColumns(raw: unknown): GridColumns;
+/**
+ * Multi-column grid container. Schema constrains it to exactly 2 or 3
+ * `gridColumn` children, so the user can't construct a 1-column or
+ * 4-column grid through any path (toolbar, slash, paste).
+ *
+ * Renders to `<div data-type="grid" data-columns="N" class="pilotiq-grid
+ * pilotiq-grid-cols-N">` — consumers ship the matching CSS (Tailwind
+ * `grid grid-cols-N gap-4` or hand-rolled). Same posture as `lead` /
+ * `small` size marks: the package stays CSS-free.
+ */
+export declare const Grid: Node<any, any>;
+/**
+ * Individual column inside a `grid`. Belongs to its own custom group so the
+ * top-level document only accepts `Grid` (not bare `gridColumn`s).
+ */
+export declare const GridColumn: Node<any, any>;
+//# sourceMappingURL=GridExtension.d.ts.map

package/dist/extensions/GridExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridExtension.d.ts","sourceRoot":"","sources":["../../src/extensions/GridExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,cAAc,CAAA;AAEpD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,QAAQ,CAAC,UAAU;QAC3B,IAAI,EAAE;YACJ;;;;eAIG;YACH,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;gBAAE,OAAO,CAAC,EAAE,WAAW,CAAA;aAAE,KAAK,UAAU,CAAA;YAC5D;;;;eAIG;YACH,SAAS,EAAE,MAAM,UAAU,CAAA;SAC5B,CAAA;KACF;CACF;AAED,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,CAAA;AAI/B;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAK1D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,gBAmEf,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,gBAarB,CAAA"}

package/dist/extensions/GridExtension.js

@@ -0,0 +1,105 @@
+import { Node, mergeAttributes } from '@tiptap/core';
+const ALLOWED_COLUMNS = [2, 3];
+/**
+ * Coerce any input into one of the allowed column counts. Out-of-range
+ * values, NaN, undefined, and non-numeric strings all fall back to 2 — the
+ * conservative default.
+ *
+ * Exported for unit tests and so the renderer in `render.ts` can share the
+ * same validator with the editor's `parseHTML`.
+ */
+export function clampGridColumns(raw) {
+    const n = typeof raw === 'number' ? raw : Number(raw);
+    if (!Number.isFinite(n))
+        return 2;
+    const trunc = Math.trunc(n);
+    return ALLOWED_COLUMNS.includes(trunc) ? trunc : 2;
+}
+/**
+ * Multi-column grid container. Schema constrains it to exactly 2 or 3
+ * `gridColumn` children, so the user can't construct a 1-column or
+ * 4-column grid through any path (toolbar, slash, paste).
+ *
+ * Renders to `<div data-type="grid" data-columns="N" class="pilotiq-grid
+ * pilotiq-grid-cols-N">` — consumers ship the matching CSS (Tailwind
+ * `grid grid-cols-N gap-4` or hand-rolled). Same posture as `lead` /
+ * `small` size marks: the package stays CSS-free.
+ */
+export const Grid = Node.create({
+    name: 'grid',
+    group: 'block',
+    content: 'gridColumn{2,3}',
+    defining: true,
+    addAttributes() {
+        return {
+            columns: {
+                default: 2,
+                parseHTML: (el) => clampGridColumns(el.getAttribute('data-columns')),
+                renderHTML: (attrs) => {
+                    const cols = clampGridColumns(attrs['columns']);
+                    return {
+                        'data-columns': String(cols),
+                        class: `pilotiq-grid pilotiq-grid-cols-${cols}`,
+                    };
+                },
+            },
+        };
+    },
+    parseHTML() {
+        return [{ tag: 'div[data-type="grid"]' }];
+    },
+    renderHTML({ HTMLAttributes }) {
+        return ['div', mergeAttributes(HTMLAttributes, { 'data-type': 'grid' }), 0];
+    },
+    addCommands() {
+        return {
+            setGrid: (options) => ({ chain }) => {
+                const columns = clampGridColumns(options?.columns ?? 2);
+                const content = Array.from({ length: columns }, () => ({
+                    type: 'gridColumn',
+                    content: [{ type: 'paragraph' }],
+                }));
+                return chain()
+                    .focus()
+                    .insertContent({ type: 'grid', attrs: { columns }, content })
+                    .run();
+            },
+            unsetGrid: () => ({ state, tr, dispatch }) => {
+                const $head = state.selection.$head;
+                for (let depth = $head.depth; depth > 0; depth--) {
+                    const node = $head.node(depth);
+                    if (node.type.name !== 'grid')
+                        continue;
+                    const start = $head.before(depth);
+                    const end = $head.after(depth);
+                    // Concatenate each column's children into a flat block list.
+                    const flat = [];
+                    node.forEach((col) => {
+                        col.forEach((child) => flat.push(child));
+                    });
+                    if (dispatch)
+                        tr.replaceWith(start, end, flat);
+                    return true;
+                }
+                return false;
+            },
+        };
+    },
+});
+/**
+ * Individual column inside a `grid`. Belongs to its own custom group so the
+ * top-level document only accepts `Grid` (not bare `gridColumn`s).
+ */
+export const GridColumn = Node.create({
+    name: 'gridColumn',
+    group: 'gridColumn',
+    content: 'block+',
+    defining: true,
+    parseHTML() {
+        return [{ tag: 'div[data-type="gridColumn"]' }];
+    },
+    renderHTML({ HTMLAttributes }) {
+        return ['div', mergeAttributes(HTMLAttributes, { 'data-type': 'gridColumn' }), 0];
+    },
+});
+//# sourceMappingURL=GridExtension.js.map

package/dist/extensions/GridExtension.js.map

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

package/dist/extensions/MentionExtension.d.ts

@@ -0,0 +1,71 @@
+import { Node } from '@tiptap/core';
+import type { MentionItem, MentionProviderMeta } from '../MentionProvider.js';
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        mention: {
+            /**
+             * Insert a `mention` atom node. `trigger` is the character the
+             * provider was registered with (`@` / `#` / …) and is rendered
+             * inline together with the resolved label.
+             */
+            insertMention: (args: {
+                id: string;
+                label: string;
+                trigger: string;
+            }) => ReturnType;
+        };
+    }
+}
+/**
+ * State the React side of the editor needs to render the mention popover.
+ * `null` when the popover should be unmounted.
+ */
+export interface MentionState {
+    trigger: string;
+    items: MentionItem[];
+    /** Pick item — Suggestion will replace the trigger range and run the command. */
+    command: (item: MentionItem) => void;
+    clientRect: () => DOMRect | null;
+    query: string;
+}
+export interface MentionOptions {
+    providers: MentionProviderMeta[];
+    /**
+     * Called whenever the popover should mount, update, or unmount. TiptapEditor
+     * holds the React state and passes a setter here.
+     */
+    onStateChange: (state: MentionState | null) => void;
+    /**
+     * URL the field's `tagRichTextMentionUrls` walker stamped on the wire-side
+     * meta. Required for async providers (`MentionProvider.itemsUsing(fn)`);
+     * unused when every provider on this field is static. The client POSTs
+     * `{ field, trigger, query }` per keystroke and expects `{ ok, items }`.
+     */
+    mentionsUrl?: string;
+    /**
+     * Field path the route handler uses to find the RichTextField on the
+     * page. Equals `Field.name` for non-nested fields. Inside a Repeater
+     * row this is the dotted form `<repeaterName>.<index>.<innerName>`;
+     * inside a Builder row it's `<builderName>.<index>.data.<innerName>`.
+     * The route handler parses the prefix and looks up the field against
+     * the Repeater's template / each Builder block's schema.
+     */
+    fieldName?: string;
+}
+/**
+ * Inline atom node + a Suggestion plugin per registered provider.
+ *
+ * The node carries `id`, `label`, and `trigger` attributes. Storage is JSON:
+ * `{ type: 'mention', attrs: { id: 'sleman', label: 'Sleman', trigger: '@' } }`.
+ *
+ * Each provider gets its own ProseMirror Suggestion plugin instance so users
+ * can mix multiple trigger characters in the same editor (`@user`, `#room`).
+ * Items are static — declared via `MentionProvider.make('@').items([...])`.
+ *
+ * Read-side rendering happens through `renderRichTextToHtml(content,
+ * { resolveMention: (trigger, id) => latestLabel })`. Without an override
+ * the cached label is used — the editor stamps it at insert time so
+ * static-content snapshots stay self-contained.
+ */
+export declare const MentionExtension: Node<MentionOptions, any>;
+//# sourceMappingURL=MentionExtension.d.ts.map

package/dist/extensions/MentionExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentionExtension.d.ts","sourceRoot":"","sources":["../../src/extensions/MentionExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA4C,MAAM,cAAc,CAAA;AAG7E,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE7E,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,QAAQ,CAAC,UAAU;QAC3B,OAAO,EAAE;YACP;;;;eAIG;YACH,aAAa,EAAE,CAAC,IAAI,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,KAAK,UAAU,CAAA;SACpF,CAAA;KACF;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAK,MAAM,CAAA;IAClB,KAAK,EAAO,WAAW,EAAE,CAAA;IACzB,iFAAiF;IACjF,OAAO,EAAK,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IACvC,UAAU,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;IAChC,KAAK,EAAO,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,mBAAmB,EAAE,CAAA;IAChC;;;OAGG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAA;IACnD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,2BA6G3B,CAAA"}