@rtif-sdk/web 1.0.0

package/dist/plugins/index.js

@@ -0,0 +1,42 @@
+/**
+ * Plugins and shared utilities for the RTIF web editor.
+ *
+ * Mark plugins register mark types, toggle commands, and keyboard shortcuts.
+ * Block utilities provide shared helpers for block type plugins.
+ * Load only the plugins you need.
+ *
+ * @packageDocumentation
+ */
+// Mark utilities
+export { createToggleMarkCommand, toggleMark, isMarkActiveAtSelection, createSetMarkCommand, createRemoveMarkCommand, findContiguousMarkRange, adjustOffsetAroundAtomicMarks, adjustOffsetAroundAtomicBlocks, } from './mark-utils.js';
+// Block utilities
+export { getBlockStartOffset, getBlockAtCursor, isBlockType, createToggleBlockTypeCommand, setBlockType, } from './block-utils.js';
+// Simple boolean mark plugins
+export { boldPlugin, BoldCommands } from './bold-plugin.js';
+export { italicPlugin, ItalicCommands } from './italic-plugin.js';
+export { underlinePlugin, UnderlineCommands } from './underline-plugin.js';
+export { strikethroughPlugin, StrikethroughCommands } from './strikethrough-plugin.js';
+export { codePlugin, CodeMarkCommands } from './code-plugin.js';
+// Parameterized mark plugins
+export { linkPlugin, createLinkPlugin, LinkCommands } from './link-plugin.js';
+export { textColorPlugin, TextColorCommands } from './text-color-plugin.js';
+export { fontSizePlugin, FontSizeCommands } from './font-size-plugin.js';
+export { fontFamilyPlugin, FontFamilyCommands } from './font-family-plugin.js';
+// Block type plugins
+export { headingPlugin, HeadingCommands } from './heading-plugin.js';
+export { listPlugin, ListCommands } from './list-plugin.js';
+export { blockquotePlugin, BlockquoteCommands } from './blockquote-plugin.js';
+export { codeBlockPlugin, CodeBlockCommands } from './code-block-plugin.js';
+export { hrPlugin } from './hr-plugin.js';
+export { calloutPlugin, CalloutCommands } from './callout-plugin.js';
+export { embedPlugin, EmbedCommands } from './embed-plugin.js';
+// Paragraph formatting plugins
+export { alignmentPlugin, AlignmentCommands } from './alignment-plugin.js';
+export { indentPlugin, IndentCommands, MAX_INDENT } from './indent-plugin.js';
+// Image block plugin
+export { imagePlugin, ImageCommands } from './image-plugin.js';
+// Plugin kit
+export { defineBooleanMark, defineParameterizedMark, defineBlockType, installWebPlugins, } from '../plugin-kit.js';
+// Mention plugin
+export { createMentionPlugin, MentionCommands, mentionPlaintextSerializer, mentionMarkdownSerializer, mentionHtmlSerializer, } from './mention-plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iBAAiB;AACjB,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,4BAA4B,EAC5B,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,8BAA8B;AAC9B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,6BAA6B;AAC7B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAO9E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMrE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAO/D,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE9E,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAO/D,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAW1B,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/plugins/italic-plugin.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Italic mark plugin — registers the `italic` mark type, `toggleMark:italic` command,
+ * and Cmd/Ctrl+I keyboard shortcut.
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the italic plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(ItalicCommands.TOGGLE);
+ * ```
+ */
+export declare const ItalicCommands: {
+    readonly TOGGLE: "toggleMark:italic";
+};
+/**
+ * Create the italic mark plugin.
+ *
+ * Registers:
+ * - Mark type: `italic` (value must be `true`)
+ * - Command: `toggleMark:italic`
+ * - Shortcut: Cmd/Ctrl+I
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(italicPlugin());
+ * engine.exec(ItalicCommands.TOGGLE);
+ * ```
+ */
+export declare function italicPlugin(): Plugin;
+//# sourceMappingURL=italic-plugin.d.ts.map

package/dist/plugins/italic-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"italic-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/italic-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC"}

package/dist/plugins/italic-plugin.js

@@ -0,0 +1,48 @@
+/**
+ * Italic mark plugin — registers the `italic` mark type, `toggleMark:italic` command,
+ * and Cmd/Ctrl+I keyboard shortcut.
+ *
+ * @module
+ */
+import { createToggleMarkCommand } from './mark-utils.js';
+/**
+ * Command name constants for the italic plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(ItalicCommands.TOGGLE);
+ * ```
+ */
+export const ItalicCommands = {
+    TOGGLE: 'toggleMark:italic',
+};
+/**
+ * Create the italic mark plugin.
+ *
+ * Registers:
+ * - Mark type: `italic` (value must be `true`)
+ * - Command: `toggleMark:italic`
+ * - Shortcut: Cmd/Ctrl+I
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(italicPlugin());
+ * engine.exec(ItalicCommands.TOGGLE);
+ * ```
+ */
+export function italicPlugin() {
+    return {
+        id: 'mark-italic',
+        init(ctx) {
+            ctx.registerMarkType('italic', {
+                validate: (value) => value === true,
+            });
+            ctx.registerCommand(ItalicCommands.TOGGLE, createToggleMarkCommand('italic'));
+            ctx.registerShortcut({ key: 'i', mod: true }, ItalicCommands.TOGGLE);
+        },
+    };
+}
+//# sourceMappingURL=italic-plugin.js.map

package/dist/plugins/italic-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"italic-plugin.js","sourceRoot":"","sources":["../../src/plugins/italic-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,mBAAmB;CACnB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,IAAI,CAAC,GAAG;YACN,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE;gBAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI;aACpC,CAAC,CAAC;YAEH,GAAG,CAAC,eAAe,CAAC,cAAc,CAAC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAE9E,GAAG,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/link-plugin.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Link mark plugin — registers the `link` mark type (parameterized with `href`),
+ * `insertLink`, `removeLink`, `updateLink`, `showLinkUI` commands, and
+ * Cmd/Ctrl+K shortcut.
+ *
+ * Unlike simple boolean marks, links carry structured data (`{ href, title? }`)
+ * and require multiple commands for create, update, and remove operations.
+ *
+ * The `createLinkPlugin()` factory returns `{ plugin, attach }` following the
+ * same pattern as the mention plugin. The `attach()` function wires up the
+ * `showLinkUI` command callback for the web layer.
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+import type { WebEditor, Disposable } from '../types.js';
+/**
+ * Command name constants for the link plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(LinkCommands.INSERT, { href: 'https://example.com' });
+ * engine.exec(LinkCommands.REMOVE);
+ * engine.exec(LinkCommands.UPDATE, { href: 'https://new-url.com' });
+ * engine.exec(LinkCommands.SHOW_UI);
+ * ```
+ */
+export declare const LinkCommands: {
+    readonly INSERT: "insertLink";
+    readonly REMOVE: "removeLink";
+    readonly UPDATE: "updateLink";
+    readonly SHOW_UI: "showLinkUI";
+};
+/**
+ * Payload for the `insertLink` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('insertLink', { href: 'https://example.com', text: 'Example' });
+ * ```
+ */
+export interface InsertLinkPayload {
+    /** The URL for the link */
+    readonly href: string;
+    /** Optional display text. If omitted and cursor is collapsed, the href is used. */
+    readonly text?: string;
+    /** Optional title attribute for the link */
+    readonly title?: string;
+}
+/**
+ * Payload for the `updateLink` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('updateLink', { href: 'https://new-url.com' });
+ * ```
+ */
+export interface UpdateLinkPayload {
+    /** The new URL for the link */
+    readonly href: string;
+    /** Optional new title attribute */
+    readonly title?: string;
+}
+/**
+ * Callback invoked when the link UI should be shown.
+ *
+ * @param mode - Whether to show insert or edit UI
+ * @param currentHref - The current href when editing (undefined for insert mode)
+ */
+export type ShowLinkUICallback = (mode: 'insert' | 'edit', currentHref?: string) => void;
+/**
+ * Result from `createLinkPlugin()`.
+ */
+export interface LinkPluginResult {
+    /** The engine plugin instance */
+    readonly plugin: Plugin;
+    /**
+     * Attach the link plugin's web layer to a WebEditor instance.
+     * Sets up the `showLinkUI` command callback and click-to-edit behavior.
+     *
+     * @param editor - The web editor instance
+     * @param onShowUI - Callback to show the link UI
+     * @returns A disposable for cleanup
+     *
+     * @example
+     * ```ts
+     * const { plugin, attach } = createLinkPlugin();
+     * engine.use(plugin);
+     *
+     * const editor = createWebEditor({ root, engine, accessibleLabel: 'Editor' });
+     * const disposable = attach(editor, (mode, currentHref) => {
+     *   showMyLinkPopover(mode, currentHref);
+     * });
+     * ```
+     */
+    attach(editor: WebEditor, onShowUI: ShowLinkUICallback): Disposable;
+}
+/**
+ * Create the link mark plugin with web layer attachment.
+ *
+ * Registers:
+ * - Mark type: `link` (value must be `{ href: string, title?: string }`)
+ * - Command: `insertLink` — apply link to selection or insert linked text
+ * - Command: `removeLink` — remove link mark at cursor
+ * - Command: `updateLink` — update href/title of link at cursor
+ * - Command: `showLinkUI` — trigger the link editing UI
+ * - Shortcut: Cmd/Ctrl+K → `showLinkUI`
+ *
+ * @returns Plugin and attach function
+ *
+ * @example
+ * ```ts
+ * const { plugin, attach } = createLinkPlugin();
+ * engine.use(plugin);
+ * ```
+ */
+export declare function createLinkPlugin(): LinkPluginResult;
+/**
+ * Create the link mark plugin (backward-compatible wrapper).
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * engine.use(linkPlugin());
+ * ```
+ */
+export declare function linkPlugin(): Plugin;
+//# sourceMappingURL=link-plugin.d.ts.map

package/dist/plugins/link-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/link-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,QAAQ,GAAG,MAAM,EACvB,WAAW,CAAC,EAAE,MAAM,KACjB,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,GAAG,UAAU,CAAC;CACrE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAiLnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/plugins/link-plugin.js

@@ -0,0 +1,212 @@
+/**
+ * Link mark plugin — registers the `link` mark type (parameterized with `href`),
+ * `insertLink`, `removeLink`, `updateLink`, `showLinkUI` commands, and
+ * Cmd/Ctrl+K shortcut.
+ *
+ * Unlike simple boolean marks, links carry structured data (`{ href, title? }`)
+ * and require multiple commands for create, update, and remove operations.
+ *
+ * The `createLinkPlugin()` factory returns `{ plugin, attach }` following the
+ * same pattern as the mention plugin. The `attach()` function wires up the
+ * `showLinkUI` command callback for the web layer.
+ *
+ * @module
+ */
+import { findContiguousMarkRange } from './mark-utils.js';
+/**
+ * Command name constants for the link plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(LinkCommands.INSERT, { href: 'https://example.com' });
+ * engine.exec(LinkCommands.REMOVE);
+ * engine.exec(LinkCommands.UPDATE, { href: 'https://new-url.com' });
+ * engine.exec(LinkCommands.SHOW_UI);
+ * ```
+ */
+export const LinkCommands = {
+    INSERT: 'insertLink',
+    REMOVE: 'removeLink',
+    UPDATE: 'updateLink',
+    SHOW_UI: 'showLinkUI',
+};
+/**
+ * Create the link mark plugin with web layer attachment.
+ *
+ * Registers:
+ * - Mark type: `link` (value must be `{ href: string, title?: string }`)
+ * - Command: `insertLink` — apply link to selection or insert linked text
+ * - Command: `removeLink` — remove link mark at cursor
+ * - Command: `updateLink` — update href/title of link at cursor
+ * - Command: `showLinkUI` — trigger the link editing UI
+ * - Shortcut: Cmd/Ctrl+K → `showLinkUI`
+ *
+ * @returns Plugin and attach function
+ *
+ * @example
+ * ```ts
+ * const { plugin, attach } = createLinkPlugin();
+ * engine.use(plugin);
+ * ```
+ */
+export function createLinkPlugin() {
+    // Mutable callback bridge — set by attach()
+    let showUICallback = null;
+    const plugin = {
+        id: 'mark-link',
+        init(ctx) {
+            ctx.registerMarkType('link', {
+                validate: (value) => {
+                    return (typeof value === 'object' &&
+                        value !== null &&
+                        typeof value.href === 'string');
+                },
+            });
+            // ---------------------------------------------------------------
+            // insertLink command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(LinkCommands.INSERT, {
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || !p.href)
+                        return;
+                    const { anchor, focus } = engine.state.selection;
+                    const start = Math.min(anchor.offset, focus.offset);
+                    const end = Math.max(anchor.offset, focus.offset);
+                    const linkMark = { href: p.href };
+                    if (p.title)
+                        linkMark.title = p.title;
+                    if (start !== end) {
+                        // Selection exists — apply link to selected text
+                        engine.dispatch({
+                            type: 'set_span_marks',
+                            offset: start,
+                            count: end - start,
+                            marks: { link: linkMark },
+                        });
+                    }
+                    else {
+                        // No selection — insert text + apply link
+                        const text = p.text || p.href;
+                        engine.dispatch([
+                            { type: 'insert_text', offset: start, text },
+                            {
+                                type: 'set_span_marks',
+                                offset: start,
+                                count: text.length,
+                                marks: { link: linkMark },
+                            },
+                        ]);
+                    }
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+                isActive(engine) {
+                    const marks = engine.getMarksAtOffset(engine.state.selection.focus.offset);
+                    return (typeof marks.link === 'object' &&
+                        marks.link !== null);
+                },
+            });
+            // ---------------------------------------------------------------
+            // removeLink command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(LinkCommands.REMOVE, {
+                execute(engine) {
+                    const focusOffset = engine.state.selection.focus.offset;
+                    const range = findContiguousMarkRange(engine.state.doc, focusOffset, 'link');
+                    if (!range)
+                        return;
+                    engine.dispatch({
+                        type: 'set_span_marks',
+                        offset: range.offset,
+                        count: range.count,
+                        marks: { link: null },
+                    });
+                },
+                canExecute(engine) {
+                    const marks = engine.getMarksAtOffset(engine.state.selection.focus.offset);
+                    return typeof marks.link === 'object' && marks.link !== null;
+                },
+            });
+            // ---------------------------------------------------------------
+            // updateLink command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(LinkCommands.UPDATE, {
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || !p.href)
+                        return;
+                    const focusOffset = engine.state.selection.focus.offset;
+                    const range = findContiguousMarkRange(engine.state.doc, focusOffset, 'link');
+                    if (!range)
+                        return;
+                    const linkMark = { href: p.href };
+                    if (p.title)
+                        linkMark.title = p.title;
+                    engine.dispatch({
+                        type: 'set_span_marks',
+                        offset: range.offset,
+                        count: range.count,
+                        marks: { link: linkMark },
+                    });
+                },
+                canExecute(engine) {
+                    const marks = engine.getMarksAtOffset(engine.state.selection.focus.offset);
+                    return typeof marks.link === 'object' && marks.link !== null;
+                },
+            });
+            // ---------------------------------------------------------------
+            // showLinkUI command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(LinkCommands.SHOW_UI, {
+                execute(engine) {
+                    if (!showUICallback)
+                        return;
+                    const marks = engine.getMarksAtOffset(engine.state.selection.focus.offset);
+                    const linkMark = marks.link;
+                    if (typeof linkMark === 'object' && linkMark !== null && linkMark.href) {
+                        // Cursor is inside an existing link — edit mode
+                        showUICallback('edit', linkMark.href);
+                    }
+                    else {
+                        // No link at cursor — insert mode
+                        showUICallback('insert');
+                    }
+                },
+                canExecute(_engine) {
+                    return showUICallback !== null;
+                },
+            });
+            // ---------------------------------------------------------------
+            // Keyboard shortcut: Cmd/Ctrl+K → showLinkUI
+            // ---------------------------------------------------------------
+            ctx.registerShortcut({ key: 'k', mod: true }, LinkCommands.SHOW_UI);
+        },
+    };
+    return {
+        plugin,
+        attach(editor, onShowUI) {
+            showUICallback = onShowUI;
+            return {
+                dispose() {
+                    showUICallback = null;
+                },
+            };
+        },
+    };
+}
+/**
+ * Create the link mark plugin (backward-compatible wrapper).
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * engine.use(linkPlugin());
+ * ```
+ */
+export function linkPlugin() {
+    return createLinkPlugin().plugin;
+}
+//# sourceMappingURL=link-plugin.js.map

package/dist/plugins/link-plugin.js.map

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

package/dist/plugins/list-plugin.d.ts

@@ -0,0 +1,53 @@
+/**
+ * List item block type plugin -- registers the `list-item` block type,
+ * `toggleBulletList` / `toggleOrderedList` toggle commands,
+ * `indentList` / `outdentList` depth commands, and input rules for
+ * `- `, `* `, and `1. ` at block start.
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the list plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(ListCommands.TOGGLE_BULLET);
+ * engine.exec(ListCommands.TOGGLE_ORDERED);
+ * engine.exec(ListCommands.INDENT);
+ * engine.exec(ListCommands.OUTDENT);
+ * ```
+ */
+export declare const ListCommands: {
+    readonly TOGGLE_BULLET: "toggleBulletList";
+    readonly TOGGLE_ORDERED: "toggleOrderedList";
+    readonly INDENT: "indentList";
+    readonly OUTDENT: "outdentList";
+};
+/**
+ * Create the list item block type plugin.
+ *
+ * Registers:
+ * - Block type: `list-item` (attrs must have `listStyle` of "bullet" or "ordered", `depth` >= 0)
+ * - Command: `toggleBulletList` -- toggle between bullet list-item and plain text
+ * - Command: `toggleOrderedList` -- toggle between ordered list-item and plain text
+ * - Command: `indentList` -- increase list-item depth by 1 (max 8)
+ * - Command: `outdentList` -- decrease list-item depth by 1, or revert to text at depth 0
+ * - Input rules: `- ` / `* ` at block start converts to bullet list, `1. ` converts to ordered list
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(listPlugin());
+ *
+ * // Toggle bullet list on the block at cursor
+ * engine.exec(ListCommands.TOGGLE_BULLET);
+ *
+ * // Indent the current list item
+ * engine.exec(ListCommands.INDENT);
+ * ```
+ */
+export declare function listPlugin(): Plugin;
+//# sourceMappingURL=list-plugin.d.ts.map

package/dist/plugins/list-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/list-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,kBAAkB,CAAC;AAK3E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAqEX;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAkOnC"}