@pilotiq/tiptap 0.1.0

package/dist/extensions/MentionExtension.js

@@ -0,0 +1,165 @@
+import { Node, mergeAttributes } from '@tiptap/core';
+import Suggestion from '@tiptap/suggestion';
+import { PluginKey } from '@tiptap/pm/state';
+/**
+ * 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 const MentionExtension = Node.create({
+    name: 'mention',
+    group: 'inline',
+    inline: true,
+    atom: true,
+    selectable: true,
+    addOptions() {
+        return {
+            providers: [],
+            onStateChange: () => { },
+        };
+    },
+    addAttributes() {
+        return {
+            id: {
+                default: null,
+                parseHTML: (el) => el.getAttribute('data-id'),
+                renderHTML: (a) => (a['id'] ? { 'data-id': String(a['id']) } : {}),
+            },
+            label: {
+                default: null,
+                parseHTML: (el) => el.getAttribute('data-label'),
+                renderHTML: (a) => (a['label'] ? { 'data-label': String(a['label']) } : {}),
+            },
+            trigger: {
+                default: null,
+                parseHTML: (el) => el.getAttribute('data-trigger'),
+                renderHTML: (a) => (a['trigger'] ? { 'data-trigger': String(a['trigger']) } : {}),
+            },
+        };
+    },
+    parseHTML() {
+        return [{ tag: 'span[data-pilotiq-mention]' }];
+    },
+    renderHTML({ node, HTMLAttributes }) {
+        const trigger = String(node.attrs['trigger'] ?? '');
+        const label = String(node.attrs['label'] ?? node.attrs['id'] ?? '');
+        return [
+            'span',
+            mergeAttributes({
+                'data-pilotiq-mention': '',
+                class: 'pilotiq-mention rounded bg-blue-500/10 px-1.5 py-0.5 text-xs font-medium text-blue-700 dark:text-blue-300 align-baseline',
+            }, HTMLAttributes),
+            `${trigger}${label}`,
+        ];
+    },
+    addCommands() {
+        return {
+            insertMention: ({ id, label, trigger }) => ({ commands }) => commands.insertContent([
+                { type: this.name, attrs: { id, label, trigger } },
+                { type: 'text', text: ' ' },
+            ]),
+        };
+    },
+    addProseMirrorPlugins() {
+        const providers = this.options.providers;
+        const emit = this.options.onStateChange;
+        const editor = this.editor;
+        const url = this.options.mentionsUrl;
+        const fieldName = this.options.fieldName;
+        return providers.map((provider, i) => Suggestion({
+            pluginKey: new PluginKey(`pilotiqMentionSuggestion-${i}`),
+            editor,
+            char: provider.trigger,
+            startOfLine: false,
+            allowSpaces: false,
+            items: provider.async
+                ? async ({ query }) => fetchAsyncMentionItems(url, fieldName, provider.trigger, query)
+                : ({ query }) => filterMentionItems(provider.items, query),
+            command: ({ editor: ed, range, props }) => {
+                ed
+                    .chain()
+                    .focus()
+                    .deleteRange(range)
+                    .insertContent([
+                    {
+                        type: 'mention',
+                        attrs: { id: props.id, label: props.label, trigger: provider.trigger },
+                    },
+                    { type: 'text', text: ' ' },
+                ])
+                    .run();
+            },
+            render: () => ({
+                onStart: (props) => emit(stateFrom(provider.trigger, props)),
+                onUpdate: (props) => emit(stateFrom(provider.trigger, props)),
+                // Keys handled at the document level by TiptapEditor — same posture
+                // as the slash menu.
+                onKeyDown: () => false,
+                onExit: () => emit(null),
+            }),
+        }));
+    },
+});
+function stateFrom(trigger, props) {
+    return {
+        trigger,
+        items: props.items,
+        command: props.command,
+        clientRect: props.clientRect ?? (() => null),
+        query: props.query,
+    };
+}
+function filterMentionItems(items, query) {
+    if (!query)
+        return items;
+    const needle = query.toLowerCase();
+    return items.filter((item) => `${item.label} ${item.id} ${item.group ?? ''}`.toLowerCase().includes(needle));
+}
+/**
+ * Async path — POST `{ field, trigger, query }` to the field's
+ * `mentionsUrl` and return the resolved items. Returns `[]` for any
+ * failure (missing URL / network error / non-200 response / malformed
+ * payload) so the menu degrades to "no matches" instead of throwing
+ * inside Suggestion's items pipeline.
+ *
+ * Suggestion handles its own debouncing; we don't need a setTimeout
+ * wrapper. In-flight races aren't tracked here either — Suggestion's
+ * internal sequence handling owns "newer query supersedes older one".
+ */
+async function fetchAsyncMentionItems(url, field, trigger, query) {
+    if (!url || !field)
+        return [];
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+            body: JSON.stringify({ field, trigger, query }),
+        });
+        if (!res.ok)
+            return [];
+        const json = await res.json();
+        if (!json.ok || !Array.isArray(json.items))
+            return [];
+        return json.items.filter((item) => item != null
+            && typeof item === 'object'
+            && typeof item['id'] === 'string'
+            && typeof item['label'] === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=MentionExtension.js.map

package/dist/extensions/MentionExtension.js.map

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

package/dist/extensions/MergeTagExtension.d.ts

@@ -0,0 +1,24 @@
+import { Node } from '@tiptap/core';
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        mergeTag: {
+            /** Insert a `mergeTag` atom node carrying the given identifier. */
+            insertMergeTag: (id: string) => ReturnType;
+        };
+    }
+}
+/**
+ * Inline atom that represents a `{{ tag }}` placeholder in the document.
+ *
+ * The editor renders the node as a small chip — `{{ id }}` inside a styled
+ * `<span>` — so the author sees what gets substituted at read time. Storage
+ * is JSON: `{ type: 'mergeTag', attrs: { id: 'name' } }`.
+ *
+ * Read-side rendering happens through `renderRichTextToHtml(content,
+ * { mergeTags: { name: 'Sleman' } })` — pass a substitution map and the
+ * placeholder is replaced with the value (HTML-escaped). Without a map,
+ * the renderer emits `<span class="merge-tag" data-id="name">{{ name }}</span>`
+ * so previews on the server stay informative.
+ */
+export declare const MergeTagExtension: Node<any, any>;
+//# sourceMappingURL=MergeTagExtension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MergeTagExtension.d.ts","sourceRoot":"","sources":["../../src/extensions/MergeTagExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,cAAc,CAAA;AAEpD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,QAAQ,CAAC,UAAU;QAC3B,QAAQ,EAAE;YACR,mEAAmE;YACnE,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,CAAA;SAC3C,CAAA;KACF;CACF;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,gBAkD5B,CAAA"}

package/dist/extensions/MergeTagExtension.js

@@ -0,0 +1,57 @@
+import { Node, mergeAttributes } from '@tiptap/core';
+/**
+ * Inline atom that represents a `{{ tag }}` placeholder in the document.
+ *
+ * The editor renders the node as a small chip — `{{ id }}` inside a styled
+ * `<span>` — so the author sees what gets substituted at read time. Storage
+ * is JSON: `{ type: 'mergeTag', attrs: { id: 'name' } }`.
+ *
+ * Read-side rendering happens through `renderRichTextToHtml(content,
+ * { mergeTags: { name: 'Sleman' } })` — pass a substitution map and the
+ * placeholder is replaced with the value (HTML-escaped). Without a map,
+ * the renderer emits `<span class="merge-tag" data-id="name">{{ name }}</span>`
+ * so previews on the server stay informative.
+ */
+export const MergeTagExtension = Node.create({
+    name: 'mergeTag',
+    group: 'inline',
+    inline: true,
+    atom: true,
+    selectable: true,
+    addAttributes() {
+        return {
+            id: {
+                default: null,
+                parseHTML: (el) => el.getAttribute('data-id'),
+                renderHTML: (attrs) => {
+                    if (!attrs['id'])
+                        return {};
+                    return { 'data-id': String(attrs['id']) };
+                },
+            },
+        };
+    },
+    parseHTML() {
+        return [{ tag: 'span[data-pilotiq-merge-tag]' }];
+    },
+    renderHTML({ node, HTMLAttributes }) {
+        const id = String(node.attrs['id'] ?? '');
+        return [
+            'span',
+            mergeAttributes({
+                'data-pilotiq-merge-tag': '',
+                class: 'pilotiq-merge-tag rounded bg-primary/10 px-1.5 py-0.5 text-xs font-medium text-primary align-baseline',
+            }, HTMLAttributes),
+            `{{ ${id} }}`,
+        ];
+    },
+    addCommands() {
+        return {
+            insertMergeTag: (id) => ({ commands }) => commands.insertContent({
+                type: this.name,
+                attrs: { id },
+            }),
+        };
+    },
+});
+//# sourceMappingURL=MergeTagExtension.js.map

package/dist/extensions/MergeTagExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MergeTagExtension.js","sourceRoot":"","sources":["../../src/extensions/MergeTagExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAWpD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,UAAU,EAAE,IAAI;IAEhB,aAAa;QACX,OAAO;YACL,EAAE,EAAE;gBACF,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC;gBAC7C,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;oBACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBAAE,OAAO,EAAE,CAAA;oBAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAA;gBAC3C,CAAC;aACF;SACF,CAAA;IACH,CAAC;IAED,SAAS;QACP,OAAO,CAAC,EAAE,GAAG,EAAE,8BAA8B,EAAE,CAAC,CAAA;IAClD,CAAC;IAED,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE;QACjC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACzC,OAAO;YACL,MAAM;YACN,eAAe,CACb;gBACE,wBAAwB,EAAE,EAAE;gBAC5B,KAAK,EAAE,uGAAuG;aAC/G,EACD,cAAc,CACf;YACD,MAAM,EAAE,KAAK;SACd,CAAA;IACH,CAAC;IAED,WAAW;QACT,OAAO;YACL,cAAc,EACZ,CAAC,EAAU,EAAE,EAAE,CACf,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CACf,QAAQ,CAAC,aAAa,CAAC;gBACrB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,EAAE,EAAE,EAAE;aACd,CAAC;SACP,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/extensions/SlashCommandExtension.d.ts

@@ -0,0 +1,71 @@
+import { Extension, type Editor, type Range } from '@tiptap/core';
+import type { BlockMeta } from '../Block.js';
+export interface SlashItem {
+    /** Stable id used to dedupe + as React key. */
+    key: string;
+    label: string;
+    icon: string | undefined;
+    group?: string;
+    /** Free-text searched against label + group. */
+    searchKey: string;
+    /** Run when the user picks this item. `range` is the slash + query slice. */
+    command: (args: {
+        editor: Editor;
+        range: Range;
+    }) => void;
+}
+/**
+ * State the React side of the editor needs to render the slash menu. Set to
+ * `null` when the menu should be unmounted.
+ */
+export interface SlashState {
+    items: SlashItem[];
+    /** Pick item — Suggestion will replace the slash range and run the command. */
+    command: (item: SlashItem) => void;
+    /**
+     * Cursor / range coords in viewport space. Re-call this every layout tick
+     * (the popover positioner does) so scroll/resize tracking comes for free.
+     */
+    clientRect: () => DOMRect | null;
+    query: string;
+}
+export interface SlashCommandOptions {
+    /** Custom blocks contributed by RichTextField.blocks([...]). */
+    blocks: BlockMeta[];
+    /** Merge-tag identifiers contributed by RichTextField.mergeTags([...]). */
+    mergeTags: string[];
+    /**
+     * Called whenever the menu should mount, update, or unmount. TiptapEditor
+     * holds the React state and passes a setter here.
+     */
+    onStateChange: (state: SlashState | null) => void;
+    /**
+     * `true` when the panel has wired an `UploadAdapter` (mirrors the
+     * toolbar's `attachFiles` gating). Drives whether the "Image" entry
+     * appears in the menu — it would have nowhere to upload otherwise.
+     */
+    hasUpload: boolean;
+    /**
+     * Called when the user picks the "Image" slash entry. The slash range
+     * is already deleted before this fires; the callback just opens the
+     * shared attach-files dialog (whose UI lives in `Toolbar`).
+     */
+    onInsertImage: () => void;
+}
+/**
+ * `/`-triggered slash menu. The plugin owns the suggestion lifecycle (range
+ * detection + command invocation); rendering is React-side via a Base UI
+ * Popover anchored to a virtual element. Keyboard events are NOT forwarded
+ * through the Suggestion plugin — TiptapEditor installs a document-level
+ * capture-phase keydown listener while the menu is open, because Base UI's
+ * focus manager can briefly steal focus from the editor when the popup mounts
+ * and the suggestion plugin's `handleKeyDown` only fires when the editor has
+ * focus.
+ */
+export declare const SlashCommandExtension: Extension<SlashCommandOptions, any>;
+export interface SlashInsertEntries {
+    hasUpload: boolean;
+    onInsertImage: () => void;
+}
+export declare function buildSlashItems(blocks: BlockMeta[], mergeTags: string[], query: string, insert: SlashInsertEntries): SlashItem[];
+//# sourceMappingURL=SlashCommandExtension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommandExtension.d.ts","sourceRoot":"","sources":["../../src/extensions/SlashCommandExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAA;AAKjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,GAAG,EAAS,MAAM,CAAA;IAClB,KAAK,EAAO,MAAM,CAAA;IAClB,IAAI,EAAQ,MAAM,GAAG,SAAS,CAAA;IAC9B,KAAK,CAAC,EAAM,MAAM,CAAA;IAClB,gDAAgD;IAChD,SAAS,EAAG,MAAM,CAAA;IAClB,6EAA6E;IAC7E,OAAO,EAAK,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAA;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAO,SAAS,EAAE,CAAA;IACvB,+EAA+E;IAC/E,OAAO,EAAK,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;IACrC;;;OAGG;IACH,UAAU,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;IAChC,KAAK,EAAO,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;;OAGG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IACjD;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,qCA2ChC,CAAA;AAgBF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAM,OAAO,CAAA;IACtB,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B;AAQD,wBAAgB,eAAe,CAC7B,MAAM,EAAK,SAAS,EAAE,EACtB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAM,MAAM,EACjB,MAAM,EAAK,kBAAkB,GAC5B,SAAS,EAAE,CAmLb"}

package/dist/extensions/SlashCommandExtension.js

@@ -0,0 +1,244 @@
+import { Extension } from '@tiptap/core';
+import Suggestion from '@tiptap/suggestion';
+import { PluginKey } from '@tiptap/pm/state';
+const SLASH_PLUGIN_KEY = new PluginKey('pilotiqSlashSuggestion');
+/**
+ * `/`-triggered slash menu. The plugin owns the suggestion lifecycle (range
+ * detection + command invocation); rendering is React-side via a Base UI
+ * Popover anchored to a virtual element. Keyboard events are NOT forwarded
+ * through the Suggestion plugin — TiptapEditor installs a document-level
+ * capture-phase keydown listener while the menu is open, because Base UI's
+ * focus manager can briefly steal focus from the editor when the popup mounts
+ * and the suggestion plugin's `handleKeyDown` only fires when the editor has
+ * focus.
+ */
+export const SlashCommandExtension = Extension.create({
+    name: 'slashCommand',
+    addOptions() {
+        return {
+            blocks: [],
+            mergeTags: [],
+            onStateChange: () => { },
+            hasUpload: false,
+            onInsertImage: () => { },
+        };
+    },
+    addProseMirrorPlugins() {
+        const blocks = this.options.blocks;
+        const mergeTags = this.options.mergeTags;
+        const emit = this.options.onStateChange;
+        const hasUpload = this.options.hasUpload;
+        const onInsertImage = this.options.onInsertImage;
+        return [
+            Suggestion({
+                pluginKey: SLASH_PLUGIN_KEY,
+                editor: this.editor,
+                char: '/',
+                startOfLine: false,
+                allowSpaces: false,
+                items: ({ query }) => buildSlashItems(blocks, mergeTags, query, { hasUpload, onInsertImage }),
+                command: ({ editor, range, props }) => {
+                    props.command({ editor, range });
+                },
+                render: () => ({
+                    onStart: (props) => emit(stateFrom(props)),
+                    onUpdate: (props) => emit(stateFrom(props)),
+                    // Keys are handled at the document level by TiptapEditor; nothing
+                    // to do here. Returning false lets PM's keymap handle anything we
+                    // don't intercept (typing more of the slash query, etc.).
+                    onKeyDown: () => false,
+                    onExit: () => emit(null),
+                }),
+            }),
+        ];
+    },
+});
+function stateFrom(props) {
+    return {
+        items: props.items,
+        command: props.command,
+        clientRect: props.clientRect ?? (() => null),
+        query: props.query,
+    };
+}
+// Built-in items mirror the standard rich-text-editor slash menu. Custom
+// blocks append, then merge-tag placeholders.
+//
+// Exported so tests can pin down the menu contents without spinning up an
+// editor instance — the function is pure and deterministic given its
+// inputs.
+export function buildSlashItems(blocks, mergeTags, query, insert) {
+    const builtins = [
+        {
+            key: 'paragraph', label: 'Text', icon: '¶', group: 'Basic',
+            searchKey: 'text paragraph p',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setNode('paragraph').run(),
+        },
+        ...[1, 2, 3, 4, 5, 6].map((level) => ({
+            key: `heading-${level}`,
+            label: `Heading ${level}`,
+            icon: `H${level}`,
+            group: 'Headings',
+            searchKey: `heading ${level} h${level}${level === 1 ? ' title' : level === 2 ? ' subtitle' : ''}`,
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setNode('heading', { level }).run(),
+        })),
+        {
+            key: 'bullet-list', label: 'Bullet list', icon: '•', group: 'Lists',
+            searchKey: 'bullet list ul unordered',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).toggleBulletList().run(),
+        },
+        {
+            key: 'ordered-list', label: 'Numbered list', icon: '1.', group: 'Lists',
+            searchKey: 'numbered ordered list ol',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).toggleOrderedList().run(),
+        },
+        {
+            key: 'quote', label: 'Quote', icon: '❝', group: 'Basic',
+            searchKey: 'quote blockquote',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).toggleBlockquote().run(),
+        },
+        {
+            key: 'code', label: 'Code block', icon: '</>', group: 'Basic',
+            searchKey: 'code block pre',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).toggleCodeBlock().run(),
+        },
+        {
+            key: 'hr', label: 'Divider', icon: '—', group: 'Basic',
+            searchKey: 'divider hr horizontal rule',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setHorizontalRule().run(),
+        },
+        // 3×3 table with a header row — same shape as the toolbar `table` button.
+        // No upload gate; tables are pure schema, available everywhere.
+        {
+            key: 'table', label: 'Table', icon: '⊞', group: 'Insert',
+            searchKey: 'table grid rows columns',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range)
+                .insertTable({ rows: 3, cols: 3, withHeaderRow: true }).run(),
+        },
+        // Collapsible `<details>` block. `setDetails` wraps the cursor's
+        // paragraph in a details node with an empty summary; the user starts
+        // typing the summary and presses Enter to drop into the body. No
+        // upload gate — pure schema, available everywhere.
+        {
+            key: 'details', label: 'Collapsible block', icon: '▸', group: 'Insert',
+            searchKey: 'details collapsible disclosure summary toggle expand',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setDetails().run(),
+        },
+        // Multi-column grid layout. Two distinct entries (2-col + 3-col) so
+        // the user picks the column count from the slash menu directly,
+        // matching how the toolbar's `grid` button defaults to 2 cols.
+        {
+            key: 'grid-2', label: 'Two-column grid', icon: '⊞', group: 'Insert',
+            searchKey: 'grid columns layout 2 two split side',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setGrid({ columns: 2 }).run(),
+        },
+        {
+            key: 'grid-3', label: 'Three-column grid', icon: '⊞', group: 'Insert',
+            searchKey: 'grid columns layout 3 three split',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setGrid({ columns: 3 }).run(),
+        },
+        // Image entry shares the toolbar's attach-files dialog; only surfaced
+        // when the panel has wired an `UploadAdapter`. Without one, the dialog
+        // would post to a missing endpoint — the slash item degrades the same
+        // way the toolbar's `attachFiles` button does (server-stripped at meta
+        // build time when no adapter is set).
+        ...(insert.hasUpload ? [{
+                key: 'image', label: 'Image', icon: '🖼', group: 'Insert',
+                searchKey: 'image upload media file attach',
+                command: ({ editor, range }) => {
+                    // Drop the slash range first so the user doesn't return to a
+                    // dangling `/image` after closing the dialog. Inserting the
+                    // actual image happens inside the dialog's upload handler.
+                    editor.chain().focus().deleteRange(range).run();
+                    insert.onInsertImage();
+                },
+            }] : []),
+        {
+            key: 'align-left', label: 'Align left', icon: '⇤', group: 'Align',
+            searchKey: 'align left start',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setTextAlign('left').run(),
+        },
+        {
+            key: 'align-center', label: 'Align center', icon: '⇔', group: 'Align',
+            searchKey: 'align center middle',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setTextAlign('center').run(),
+        },
+        {
+            key: 'align-right', label: 'Align right', icon: '⇥', group: 'Align',
+            searchKey: 'align right end',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).setTextAlign('right').run(),
+        },
+        {
+            key: 'clear-format', label: 'Clear formatting', icon: '⌫', group: 'Basic',
+            searchKey: 'clear formatting reset',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).clearNodes().unsetAllMarks().run(),
+        },
+        // Inline-mark size variants. Slash-menu form leaves the slash range in
+        // place rather than swallowing it, so the user runs the command on the
+        // word they were just typing — the alternative ("/lead" deletes the
+        // range, then user types more) requires re-positioning the cursor and
+        // breaks the "type-toggle-keep-typing" rhythm authors use most.
+        {
+            key: 'lead', label: 'Lead', icon: 'P+', group: 'Style',
+            searchKey: 'lead lede intro paragraph emphasis',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).toggleMark('lead').run(),
+        },
+        {
+            key: 'small', label: 'Small', icon: 'P-', group: 'Style',
+            searchKey: 'small fine print footnote caption',
+            command: ({ editor, range }) => editor.chain().focus().deleteRange(range).toggleMark('small').run(),
+        },
+    ];
+    const customs = blocks.map((b) => ({
+        key: `block:${b.name}`,
+        label: b.label,
+        icon: b.icon,
+        group: 'Blocks',
+        searchKey: `${b.label} ${b.name} block`,
+        command: ({ editor, range }) => {
+            // Use insertContent directly with explicit attrs rather than chaining
+            // through our custom `insertBlock` command — chained custom commands
+            // sometimes drop the `attrs` payload depending on Tiptap version.
+            editor
+                .chain()
+                .focus()
+                .deleteRange(range)
+                .insertContent({
+                type: 'pilotiqBlock',
+                attrs: {
+                    blockType: b.name,
+                    blockData: defaultsFromSchema(b),
+                },
+            })
+                .run();
+        },
+    }));
+    const merges = mergeTags.map((id) => ({
+        key: `merge-tag:${id}`,
+        label: `{{ ${id} }}`,
+        icon: '{{}}',
+        group: 'Merge tags',
+        searchKey: `merge tag placeholder ${id}`,
+        command: ({ editor, range }) => {
+            editor
+                .chain()
+                .focus()
+                .deleteRange(range)
+                .insertContent({ type: 'mergeTag', attrs: { id } })
+                .run();
+        },
+    }));
+    const all = [...builtins, ...customs, ...merges];
+    if (!query)
+        return all;
+    const needle = query.toLowerCase();
+    return all.filter((item) => `${item.label} ${item.searchKey} ${item.group ?? ''}`.toLowerCase().includes(needle));
+}
+function defaultsFromSchema(block) {
+    const out = {};
+    for (const f of block.schema) {
+        out[f.name] = '';
+    }
+    return out;
+}
+//# sourceMappingURL=SlashCommandExtension.js.map

package/dist/extensions/SlashCommandExtension.js.map

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

package/dist/extensions/TextSizeMarks.d.ts

@@ -0,0 +1,33 @@
+import { Mark } from '@tiptap/core';
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        lead: {
+            /** Toggle the `lead` mark on the current selection. */
+            toggleLead: () => ReturnType;
+        };
+        small: {
+            /** Toggle the `small` mark on the current selection. */
+            toggleSmall: () => ReturnType;
+        };
+    }
+}
+/**
+ * Two inline marks for paragraph-style size variants beyond the standard
+ * heading levels:
+ *
+ *   - `lead`  — opening / lede paragraph styling. Renders as
+ *               `<span class="lead">…</span>` so authors keep paragraph
+ *               semantics; styling is owned by the consumer's CSS (the
+ *               adapter doesn't ship a `.lead` rule — every site already
+ *               has one).
+ *   - `small` — semantic `<small>` mark. Mirrors the HTML element so
+ *               read-side renderers don't need a special class to style
+ *               fine print.
+ *
+ * Both marks live in the standard inline group so they compose with bold,
+ * italic, color, etc. without exclusivity rules. Excluding each other isn't
+ * useful — a `<small lead>` selection would be inert visually anyway.
+ */
+export declare const LeadMarkExtension: Mark<any, any>;
+export declare const SmallMarkExtension: Mark<any, any>;
+//# sourceMappingURL=TextSizeMarks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TextSizeMarks.d.ts","sourceRoot":"","sources":["../../src/extensions/TextSizeMarks.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,uDAAuD;YACvD,UAAU,EAAE,MAAM,UAAU,CAAA;SAC7B,CAAA;QACD,KAAK,EAAE;YACL,wDAAwD;YACxD,WAAW,EAAE,MAAM,UAAU,CAAA;SAC9B,CAAA;KACF;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,gBAmB5B,CAAA;AAEF,eAAO,MAAM,kBAAkB,gBAmB7B,CAAA"}