@pilotiq/tiptap 0.1.0

package/dist/react/BlockSidePanel.js

@@ -0,0 +1,339 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { FormFields, parseFormDataToNested, clampPanelWidth as clampPanelWidthShared, useResizableWidth, } from '@pilotiq/pilotiq/react';
+const PANEL_WIDTH_STORAGE_KEY = 'pilotiq.tiptap.sidePanel.width';
+const PANEL_WIDTH_DEFAULT = 320;
+const PANEL_WIDTH_MIN = 240;
+const PANEL_WIDTH_MAX = 600;
+// Keys that point at any tabbable / interactive element inside the panel.
+// Same intent as Filament's focus-trap helper but kept inline — small one-off.
+const FOCUSABLE_SELECTOR = [
+    'a[href]',
+    'button:not([disabled])',
+    'input:not([disabled]):not([type="hidden"])',
+    'select:not([disabled])',
+    'textarea:not([disabled])',
+    '[tabindex]:not([tabindex="-1"])',
+].join(',');
+export function BlockSidePanel({ editor, initialPos, blockType, blocks, onClose, }) {
+    const meta = blocks.find((b) => b.name === blockType);
+    // Live-tracked position of the block we're editing. Starts at the
+    // open-time position; every editor transaction maps it forward so the
+    // panel keeps writing to the same node even as the user types text
+    // elsewhere in the document.
+    const [pos, setPos] = useState(initialPos);
+    const posRef = useRef(initialPos);
+    // Prefilled values seed the form's `defaultValue`s. We re-read once
+    // when the panel opens (and on hard re-mount via key prop); ongoing
+    // edits don't snapshot the doc — the form's uncontrolled inputs hold
+    // their own state until the user closes the panel.
+    const initialValuesRef = useRef(pos !== null ? readBlockData(editor, pos) : {});
+    const asideRef = useRef(null);
+    const formRef = useRef(null);
+    // Width memory — survives panel close/reopen and full reload via
+    // localStorage. The shared `useResizableWidth` hook from
+    // `@pilotiq/pilotiq/react` handles the localStorage round-trip + drag
+    // pipeline; we just bind it to this panel's per-key bounds.
+    const { width, onResizeStart } = useResizableWidth({
+        storageKey: PANEL_WIDTH_STORAGE_KEY,
+        min: PANEL_WIDTH_MIN,
+        max: PANEL_WIDTH_MAX,
+        defaultWidth: PANEL_WIDTH_DEFAULT,
+        edge: 'left',
+    });
+    // Save focus on mount, focus the first focusable inside the panel,
+    // restore previous focus on unmount. Mount-only effect — re-mounting
+    // the panel for a different block (key={pos:blockType}) re-runs this.
+    useEffect(() => {
+        const previouslyFocused = (typeof document !== 'undefined'
+            ? document.activeElement
+            : null);
+        const aside = asideRef.current;
+        if (aside) {
+            const first = aside.querySelector(FOCUSABLE_SELECTOR);
+            first?.focus();
+        }
+        return () => {
+            // Try/catch — the previously focused element may have been removed
+            // (e.g. an editor selection refresh nuked the surrounding NodeView).
+            try {
+                previouslyFocused?.focus?.();
+            }
+            catch { /* noop */ }
+        };
+    }, []);
+    // ESC closes; Tab / Shift+Tab cycles within the panel. Bubble-phase
+    // listener — slash and mention menus' capture-phase ESC handlers fire
+    // first and stopPropagation, so ESC inside an open slash menu only
+    // closes the menu. ESC anywhere else (panel inputs, editor) closes
+    // the panel.
+    useEffect(() => {
+        const onKey = (e) => {
+            if (e.key === 'Escape') {
+                onClose();
+                e.preventDefault();
+                e.stopPropagation();
+                return;
+            }
+            if (e.key !== 'Tab')
+                return;
+            const aside = asideRef.current;
+            if (!aside)
+                return;
+            const active = document.activeElement;
+            if (!active || !aside.contains(active))
+                return;
+            const focusables = Array.from(aside.querySelectorAll(FOCUSABLE_SELECTOR)).filter((el) => !el.hasAttribute('disabled'));
+            if (focusables.length === 0)
+                return;
+            const first = focusables[0];
+            const last = focusables[focusables.length - 1];
+            if (e.shiftKey && active === first) {
+                e.preventDefault();
+                last.focus();
+            }
+            else if (!e.shiftKey && active === last) {
+                e.preventDefault();
+                first.focus();
+            }
+        };
+        document.addEventListener('keydown', onKey);
+        return () => document.removeEventListener('keydown', onKey);
+    }, [onClose]);
+    useEffect(() => {
+        if (pos === null)
+            return;
+        const handler = ({ transaction }) => {
+            const current = posRef.current;
+            if (current === null)
+                return;
+            const mapped = transaction.mapping.map(current);
+            // The block was deleted — close the panel.
+            const nodeNow = nodeAt(editor, mapped);
+            if (!nodeNow || nodeNow.type.name !== 'pilotiqBlock' || String(nodeNow.attrs['blockType'] ?? '') !== blockType) {
+                posRef.current = null;
+                setPos(null);
+                onClose();
+                return;
+            }
+            posRef.current = mapped;
+            setPos(mapped);
+        };
+        editor.on('transaction', handler);
+        return () => { editor.off('transaction', handler); };
+    }, [editor, blockType, pos, onClose]);
+    const writeBack = useCallback((nextValues) => {
+        const at = posRef.current;
+        if (at === null)
+            return;
+        // ProseMirror's `setNodeMarkup` lives on the transaction, not the
+        // ChainedCommands surface — go through `tr` directly. Pass `null`
+        // for the node-type arg to keep the existing type, just swap attrs.
+        const view = editor.view;
+        const state = editor.state;
+        const tr = state.tr.setNodeMarkup(at, null, { blockType, blockData: nextValues });
+        view.dispatch(tr);
+    }, [editor, blockType]);
+    const handleChange = useCallback(() => {
+        const formEl = formRef.current;
+        if (!formEl || !meta)
+            return;
+        // Snapshot the full form: nested arrays / objects materialize from
+        // dotted-path names (`items.0.title`), JSON-encoded hidden inputs
+        // (TagsInput / KeyValue / FileUpload-multi) sit as JSON strings,
+        // toggle / checkbox hidden inputs sit as `'true' | 'false'`. The
+        // coerce pass below normalizes those to canonical shapes.
+        const raw = parseFormDataToNested(new FormData(formEl));
+        const coerced = coerceBlockValues(raw, meta.schema);
+        writeBack(coerced);
+    }, [meta, writeBack]);
+    if (!meta || pos === null)
+        return null;
+    return (_jsxs("aside", { ref: asideRef, role: "dialog", "aria-label": `Edit ${meta.label}`, style: { width }, className: "absolute top-0 left-full ml-4 max-h-[calc(100vh-2rem)] overflow-y-auto rounded-lg border bg-background shadow-lg z-30", children: [_jsx("div", { role: "separator", "aria-orientation": "vertical", "aria-label": "Resize panel", onPointerDown: onResizeStart, className: "absolute left-0 top-0 h-full w-1 cursor-ew-resize hover:bg-border/80" }), _jsxs("header", { className: "sticky top-0 z-10 flex items-center justify-between gap-2 border-b bg-background px-3 py-2", children: [_jsxs("div", { className: "flex items-center gap-2 min-w-0", children: [meta.icon && _jsx("span", { "aria-hidden": "true", children: meta.icon }), _jsx("span", { className: "text-sm font-medium truncate", children: meta.label })] }), _jsx("button", { type: "button", onClick: onClose, "aria-label": "Close panel", className: "text-muted-foreground hover:text-foreground text-sm", children: "\u00D7" })] }), _jsx("form", { ref: formRef, onInput: handleChange, onChange: handleChange, onSubmit: (e) => { e.preventDefault(); }, className: "flex flex-col gap-3 px-3 py-3", children: _jsx(FormFields, { elements: meta.schema, values: initialValuesRef.current }) })] }));
+}
+/**
+ * Clamp + sanitize a candidate panel width against this panel's bounds
+ * (`[PANEL_WIDTH_MIN, PANEL_WIDTH_MAX]`, default `PANEL_WIDTH_DEFAULT`).
+ * Thin wrapper around the shared `clampPanelWidth` helper from
+ * `@pilotiq/pilotiq/react` — kept exported with the panel-specific
+ * defaults baked in so existing tests + downstream callers don't have
+ * to plumb the bounds themselves.
+ */
+export function clampPanelWidth(value) {
+    return clampPanelWidthShared(value, {
+        min: PANEL_WIDTH_MIN,
+        max: PANEL_WIDTH_MAX,
+        defaultWidth: PANEL_WIDTH_DEFAULT,
+    });
+}
+/**
+ * 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
+ * side panel — we only run on top-level block fields plus the immediate
+ * children of any Repeater rows / Builder rows.data, which is all the
+ * V2 surface needs.
+ *
+ * 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.
+ *
+ * Exported for unit tests. Pure — no React, no DOM, no editor.
+ */
+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. Kept
+ * for back-compat — V1 used this in the per-event handler. V2 reads
+ * the entire form via `FormData` instead, but this helper still maps
+ * cleanly onto a single-input read for testing and is exported.
+ *
+ * String passthrough for the common case; explicit coercion for
+ * booleans and numerics so the round-trip into the node attrs preserves
+ * shape.
+ */
+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;
+}
+function readBlockData(editor, pos) {
+    const node = nodeAt(editor, pos);
+    if (!node)
+        return {};
+    return node.attrs['blockData'] ?? {};
+}
+function nodeAt(editor, pos) {
+    try {
+        return editor.state.doc.nodeAt(pos);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=BlockSidePanel.js.map

package/dist/react/BlockSidePanel.js.map

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

package/dist/react/FloatingToolbar.d.ts

@@ -0,0 +1,13 @@
+import type { Editor } from '@tiptap/core';
+interface FloatingToolbarProps {
+    editor: Editor;
+}
+/**
+ * Selection-based formatting toolbar. Visible whenever the editor has a
+ * non-empty range selection inside text content. Inline marks (B/I/S/Code)
+ * are grouped together; Link sits after a separator since it's a different
+ * kind of action.
+ */
+export declare function FloatingToolbar({ editor }: FloatingToolbarProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=FloatingToolbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingToolbar.d.ts","sourceRoot":"","sources":["../../src/react/FloatingToolbar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAI1C,UAAU,oBAAoB;IAC5B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,oBAAoB,2CAwH/D"}

package/dist/react/FloatingToolbar.js

@@ -0,0 +1,113 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Tooltip } from '@base-ui/react/tooltip';
+import { Dialog } from '@base-ui/react/dialog';
+/**
+ * Selection-based formatting toolbar. Visible whenever the editor has a
+ * non-empty range selection inside text content. Inline marks (B/I/S/Code)
+ * are grouped together; Link sits after a separator since it's a different
+ * kind of action.
+ */
+export function FloatingToolbar({ editor }) {
+    const [pos, setPos] = useState(null);
+    const [linkOpen, setLinkOpen] = useState(false);
+    const [linkUrl, setLinkUrl] = useState('');
+    useEffect(() => {
+        const update = () => {
+            const { from, to, empty } = editor.state.selection;
+            if (empty) {
+                setPos(null);
+                return;
+            }
+            // Don't show on full-block selections (e.g. clicking a custom block).
+            const slice = editor.state.doc.slice(from, to);
+            if (slice.content.childCount === 0) {
+                setPos(null);
+                return;
+            }
+            const start = editor.view.coordsAtPos(from);
+            const end = editor.view.coordsAtPos(to);
+            // Viewport-relative — pair with `position: fixed` below. The wrapper
+            // around <EditorContent> is `position: relative`, so an absolute toolbar
+            // would be positioned relative to it instead of the viewport.
+            // Lift the toolbar above the selection. The value is the toolbar's full
+            // height plus a small breathing gap; bump if the toolbar grows.
+            const top = Math.min(start.top, end.top) - 48;
+            const left = (start.left + end.right) / 2;
+            setPos({ top, left });
+        };
+        const close = () => setPos(null);
+        editor.on('selectionUpdate', update);
+        editor.on('blur', close);
+        // Keep the toolbar pinned to the selection when the page or any scroll
+        // ancestor scrolls (capture phase catches inner scrollers too).
+        window.addEventListener('scroll', update, true);
+        window.addEventListener('resize', update);
+        return () => {
+            editor.off('selectionUpdate', update);
+            editor.off('blur', close);
+            window.removeEventListener('scroll', update, true);
+            window.removeEventListener('resize', update);
+        };
+    }, [editor]);
+    const openLinkDialog = () => {
+        const previousUrl = editor.getAttributes('link')['href'];
+        setLinkUrl(previousUrl ?? '');
+        setLinkOpen(true);
+    };
+    const applyLink = () => {
+        setLinkOpen(false);
+        const trimmed = linkUrl.trim();
+        if (trimmed === '') {
+            editor.chain().focus().extendMarkRange('link').unsetLink().run();
+            return;
+        }
+        editor.chain().focus().extendMarkRange('link').setLink({ href: trimmed }).run();
+    };
+    const removeLink = () => {
+        setLinkOpen(false);
+        editor.chain().focus().extendMarkRange('link').unsetLink().run();
+    };
+    const mod = isMac() ? '⌘' : 'Ctrl+';
+    const isLink = editor.isActive('link');
+    return (_jsxs(_Fragment, { children: [pos && (_jsx(Tooltip.Provider, { delay: 400, children: _jsxs("div", { className: "fixed z-40 flex items-center gap-0.5 rounded-md border bg-popover px-1 py-1 text-popover-foreground shadow-md", style: { top: pos.top, left: pos.left, transform: 'translateX(-50%)' }, children: [_jsx(ToolbarButton, { label: `Bold (${mod}B)`, active: editor.isActive('bold'), onClick: () => editor.chain().focus().toggleBold().run(), children: _jsx(BoldIcon, {}) }), _jsx(ToolbarButton, { label: `Italic (${mod}I)`, active: editor.isActive('italic'), onClick: () => editor.chain().focus().toggleItalic().run(), children: _jsx(ItalicIcon, {}) }), _jsx(ToolbarButton, { label: `Strikethrough (${mod}⇧X)`, active: editor.isActive('strike'), onClick: () => editor.chain().focus().toggleStrike().run(), children: _jsx(StrikeIcon, {}) }), _jsx(ToolbarButton, { label: `Code (${mod}E)`, active: editor.isActive('code'), onClick: () => editor.chain().focus().toggleCode().run(), children: _jsx(CodeIcon, {}) }), _jsx("span", { "aria-hidden": true, className: "mx-1 h-5 w-px shrink-0 bg-border" }), _jsx(ToolbarButton, { label: isLink ? 'Edit link' : 'Add link', active: isLink, onClick: openLinkDialog, children: _jsx(LinkIcon, {}) })] }) })), _jsx(LinkDialog, { open: linkOpen, onOpenChange: setLinkOpen, url: linkUrl, onUrlChange: setLinkUrl, onApply: applyLink, onRemove: isLink ? removeLink : null, isEdit: isLink })] }));
+}
+function ToolbarButton({ label, active, onClick, children, }) {
+    return (_jsxs(Tooltip.Root, { children: [_jsx(Tooltip.Trigger, { render: (props) => (_jsx("button", { ...props, type: "button", 
+                    // mousedown + preventDefault keeps editor focus so the selection
+                    // (and therefore the toolbar) survives the click.
+                    onMouseDown: (e) => { e.preventDefault(); onClick(); }, className: `inline-flex h-7 w-7 items-center justify-center rounded text-foreground transition-colors ${active ? 'bg-accent text-accent-foreground' : 'hover:bg-accent/60'}`, "aria-label": label, "aria-pressed": active, children: children })) }), _jsx(Tooltip.Portal, { children: _jsx(Tooltip.Positioner, { side: "top", sideOffset: 6, className: "isolate z-50", children: _jsx(Tooltip.Popup, { className: "rounded-md bg-foreground px-2 py-1 text-xs text-background shadow-md data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", children: label }) }) })] }));
+}
+function LinkDialog({ open, onOpenChange, url, onUrlChange, onApply, onRemove, isEdit, }) {
+    return (_jsx(Dialog.Root, { open: open, onOpenChange: onOpenChange, children: _jsxs(Dialog.Portal, { children: [_jsx(Dialog.Backdrop, { className: "fixed inset-0 z-50 bg-black/50 transition-opacity duration-150 data-[starting-style]:opacity-0 data-[ending-style]:opacity-0" }), _jsxs(Dialog.Popup, { className: "fixed top-[50%] left-[50%] z-50 grid w-full max-w-[calc(100%-2rem)] sm:max-w-md translate-x-[-50%] translate-y-[-50%] gap-4 rounded-lg border bg-background p-6 shadow-lg transition-[opacity,transform] duration-150 data-[starting-style]:scale-95 data-[starting-style]:opacity-0 data-[ending-style]:scale-95 data-[ending-style]:opacity-0", children: [_jsx(Dialog.Title, { className: "text-lg leading-none font-semibold", children: isEdit ? 'Edit link' : 'Add link' }), _jsx("input", { type: "url", value: url, onChange: (e) => onUrlChange(e.target.value), onKeyDown: (e) => {
+                                if (e.key === 'Enter') {
+                                    e.preventDefault();
+                                    onApply();
+                                }
+                            }, placeholder: "https://example.com", autoFocus: true, className: "flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-colors placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring" }), _jsxs("div", { className: "flex flex-row-reverse items-center gap-2", children: [_jsx("button", { type: "button", onClick: onApply, className: "inline-flex h-9 items-center justify-center rounded-md bg-primary px-3 text-sm font-medium text-primary-foreground hover:bg-primary/90", children: isEdit ? 'Update' : 'Add' }), _jsx("button", { type: "button", onClick: () => onOpenChange(false), className: "inline-flex h-9 items-center justify-center rounded-md border border-input bg-background px-3 text-sm font-medium hover:bg-accent hover:text-accent-foreground", children: "Cancel" }), onRemove && (_jsx("button", { type: "button", onClick: onRemove, className: "me-auto inline-flex h-9 items-center justify-center rounded-md px-3 text-sm font-medium text-destructive hover:bg-destructive/10", children: "Remove link" }))] })] })] }) }));
+}
+function isMac() {
+    if (typeof navigator === 'undefined')
+        return false;
+    // navigator.platform is deprecated but still the most reliable signal here.
+    return /Mac|iPhone|iPad|iPod/.test(navigator.platform);
+}
+// Inline SVG icons (lucide.dev paths). Kept inline so this package doesn't
+// pull `lucide-react` as a peer dep — the rest of @pilotiq/tiptap is already
+// inline-SVG (DragHandle).
+function BoldIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.25", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M6 12h9a4 4 0 0 1 0 8H6Z" }), _jsx("path", { d: "M6 4h7a4 4 0 0 1 0 8H6Z" })] }));
+}
+function ItalicIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("line", { x1: "19", y1: "4", x2: "10", y2: "4" }), _jsx("line", { x1: "14", y1: "20", x2: "5", y2: "20" }), _jsx("line", { x1: "15", y1: "4", x2: "9", y2: "20" })] }));
+}
+function StrikeIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M16 4H9a3 3 0 0 0-2.83 4" }), _jsx("path", { d: "M14 12a4 4 0 0 1 0 8H6" }), _jsx("line", { x1: "4", y1: "12", x2: "20", y2: "12" })] }));
+}
+function CodeIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("polyline", { points: "16 18 22 12 16 6" }), _jsx("polyline", { points: "8 6 2 12 8 18" })] }));
+}
+function LinkIcon() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" }), _jsx("path", { d: "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" })] }));
+}
+//# sourceMappingURL=FloatingToolbar.js.map

package/dist/react/FloatingToolbar.js.map

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

package/dist/react/MentionMenu.d.ts

@@ -0,0 +1,26 @@
+import type { MentionItem } from '../MentionProvider.js';
+/**
+ * Mutable ref the document-level keydown listener in `TiptapEditor` reads.
+ * `MentionMenu` installs its keyboard handler on mount, clears on unmount —
+ * same protocol as `SlashMenu`'s `keyHandlerRef`.
+ */
+export type MentionKeyHandlerRef = {
+    current: ((event: KeyboardEvent) => boolean) | null;
+};
+interface MentionMenuProps {
+    trigger: string;
+    items: MentionItem[];
+    command: (item: MentionItem) => void;
+    keyHandlerRef: MentionKeyHandlerRef;
+}
+/**
+ * Floating list of mention items. Mirrors `SlashMenu` but uses the lighter
+ * `MentionItem` shape (no command thunk per item — the `command` prop is
+ * pre-curried by the Suggestion plugin).
+ *
+ * Optional `group` strings on items render as section headings; items
+ * without a group land under "Suggestions".
+ */
+export declare function MentionMenu({ trigger, items, command, keyHandlerRef }: MentionMenuProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=MentionMenu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MentionMenu.d.ts","sourceRoot":"","sources":["../../src/react/MentionMenu.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAAA;AAE1F,UAAU,gBAAgB;IACxB,OAAO,EAAQ,MAAM,CAAA;IACrB,KAAK,EAAU,WAAW,EAAE,CAAA;IAC5B,OAAO,EAAQ,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IAC1C,aAAa,EAAE,oBAAoB,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,gBAAgB,2CAmFvF"}

package/dist/react/MentionMenu.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState } from 'react';
+/**
+ * Floating list of mention items. Mirrors `SlashMenu` but uses the lighter
+ * `MentionItem` shape (no command thunk per item — the `command` prop is
+ * pre-curried by the Suggestion plugin).
+ *
+ * Optional `group` strings on items render as section headings; items
+ * without a group land under "Suggestions".
+ */
+export function MentionMenu({ trigger, items, command, keyHandlerRef }) {
+    const [active, setActive] = useState(0);
+    const containerRef = useRef(null);
+    const grouped = useMemo(() => groupBy(items, (it) => it.group ?? 'Suggestions'), [items]);
+    const renderOrder = useMemo(() => Array.from(grouped.values()).flat(), [grouped]);
+    useEffect(() => { setActive(0); }, [renderOrder]);
+    useEffect(() => {
+        const el = containerRef.current?.querySelector(`[data-index="${active}"]`);
+        el?.scrollIntoView({ block: 'nearest' });
+    }, [active]);
+    useEffect(() => {
+        keyHandlerRef.current = (event) => {
+            const len = renderOrder.length;
+            if (event.key === 'ArrowDown') {
+                setActive((i) => (len === 0 ? 0 : (i + 1) % len));
+                return true;
+            }
+            if (event.key === 'ArrowUp') {
+                setActive((i) => (len === 0 ? 0 : (i - 1 + len) % len));
+                return true;
+            }
+            if (event.key === 'Enter') {
+                const item = renderOrder[active];
+                if (item)
+                    command(item);
+                return true;
+            }
+            return false;
+        };
+        return () => { keyHandlerRef.current = null; };
+    }, [renderOrder, active, command, keyHandlerRef]);
+    if (renderOrder.length === 0) {
+        return (_jsx("div", { className: "px-3 py-2 text-xs text-muted-foreground", children: "No matches" }));
+    }
+    let runningIndex = 0;
+    return (_jsx("div", { ref: containerRef, className: "max-h-72 w-64 overflow-y-auto p-1 text-sm", children: Array.from(grouped.entries()).map(([groupName, groupItems]) => (_jsxs("div", { children: [_jsx("div", { className: "px-2 pt-2 pb-1 text-[0.7rem] font-medium uppercase tracking-wide text-muted-foreground", children: groupName }), groupItems.map((item) => {
+                    const idx = runningIndex++;
+                    const isActive = idx === active;
+                    return (_jsxs("button", { "data-index": idx, type: "button", onMouseDown: (e) => { e.preventDefault(); command(item); }, onMouseEnter: () => setActive(idx), className: `flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-left ${isActive ? 'bg-accent text-accent-foreground' : 'hover:bg-accent/60'}`, children: [_jsx("span", { className: "flex size-6 items-center justify-center rounded border bg-background text-xs", children: trigger }), _jsx("span", { className: "flex-1", children: item.label }), _jsx("span", { className: "text-xs text-muted-foreground", children: item.id })] }, item.id));
+                })] }, groupName))) }));
+}
+function groupBy(items, key) {
+    const out = new Map();
+    for (const item of items) {
+        const k = key(item);
+        const list = out.get(k);
+        if (list)
+            list.push(item);
+        else
+            out.set(k, [item]);
+    }
+    return out;
+}
+//# sourceMappingURL=MentionMenu.js.map

package/dist/react/MentionMenu.js.map

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