@rtif-sdk/web 1.0.0

package/dist/plugins/mention-plugin.js

@@ -0,0 +1,295 @@
+/**
+ * @mention plugin — parameterized mark for user mentions with trigger-based
+ * picker integration.
+ *
+ * The plugin has two parts:
+ * - **Engine plugin** (`plugin` property): Mark type registration + commands.
+ * - **Web `attach()`**: Trigger registration + mark renderer.
+ *
+ * Consumers render their own UI (dropdown, popover, etc.) using the
+ * session callbacks. The plugin handles all the RTIF operation plumbing.
+ *
+ * @module
+ */
+import { findContiguousMarkRange } from './mark-utils.js';
+/**
+ * Command name constants for the mention plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(MentionCommands.INSERT, { id: 'user-123', displayName: 'Alice' });
+ * engine.exec(MentionCommands.REMOVE);
+ * ```
+ */
+export const MentionCommands = {
+    INSERT: 'insertMention',
+    REMOVE: 'removeMention',
+};
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a mention plugin with trigger-based picker integration.
+ *
+ * @param config - The mention plugin configuration
+ * @returns A result with `plugin` (for engine) and `attach()` (for web editor)
+ *
+ * @example
+ * ```ts
+ * const mention = createMentionPlugin({
+ *   onActivate(session) { showDropdown(session.query, session.getTriggerRect()); },
+ *   onDeactivate() { hideDropdown(); },
+ *   onChange(session) { filterDropdown(session.query); },
+ *   onKeyDown(session, event) {
+ *     if (event.key === 'Enter') { session.accept(selected); return true; }
+ *     return false;
+ *   },
+ * });
+ *
+ * engine.use(mention.plugin);
+ * const editor = createWebEditor({ root, engine, accessibleLabel: 'Editor' });
+ * const detach = mention.attach(editor);
+ * ```
+ */
+export function createMentionPlugin(config) {
+    const triggerChar = config.triggerChar ?? '@';
+    const appendSpace = config.appendSpace !== false;
+    // -------------------------------------------------------------------
+    // Engine plugin
+    // -------------------------------------------------------------------
+    const plugin = {
+        id: 'mark-mention',
+        init(ctx) {
+            // Register mention mark type with validator
+            ctx.registerMarkType('mention', {
+                validate(value) {
+                    if (typeof value !== 'object' || value === null)
+                        return false;
+                    const v = value;
+                    return typeof v.id === 'string' && typeof v.displayName === 'string';
+                },
+            });
+            // -----------------------------------------------------------
+            // insertMention command
+            // -----------------------------------------------------------
+            ctx.registerCommand(MentionCommands.INSERT, {
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || !p.id || !p.displayName)
+                        return;
+                    const { anchor, focus } = engine.state.selection;
+                    const start = Math.min(anchor.offset, focus.offset);
+                    const end = Math.max(anchor.offset, focus.offset);
+                    const text = `${triggerChar}${p.displayName}`;
+                    const mentionMark = { id: p.id, displayName: p.displayName };
+                    const ops = [];
+                    // Delete selection if present
+                    if (start !== end) {
+                        ops.push({
+                            type: 'delete_text',
+                            offset: start,
+                            count: end - start,
+                        });
+                    }
+                    // Insert mention text
+                    ops.push({
+                        type: 'insert_text',
+                        offset: start,
+                        text,
+                    });
+                    // Apply mention mark
+                    ops.push({
+                        type: 'set_span_marks',
+                        offset: start,
+                        count: text.length,
+                        marks: { mention: mentionMark },
+                    });
+                    // Append space
+                    ops.push({
+                        type: 'insert_text',
+                        offset: start + text.length,
+                        text: ' ',
+                    });
+                    engine.dispatch(ops);
+                },
+                canExecute() {
+                    return true;
+                },
+                isActive(engine) {
+                    const marks = engine.getMarksAtOffset(engine.state.selection.focus.offset);
+                    return (typeof marks.mention === 'object' &&
+                        marks.mention !== null);
+                },
+            });
+            // -----------------------------------------------------------
+            // removeMention command
+            // -----------------------------------------------------------
+            ctx.registerCommand(MentionCommands.REMOVE, {
+                execute(engine) {
+                    const focusOffset = engine.state.selection.focus.offset;
+                    const range = findContiguousMarkRange(engine.state.doc, focusOffset, 'mention');
+                    if (!range)
+                        return;
+                    engine.dispatch({
+                        type: 'set_span_marks',
+                        offset: range.offset,
+                        count: range.count,
+                        marks: { mention: null },
+                    });
+                },
+                canExecute(engine) {
+                    const marks = engine.getMarksAtOffset(engine.state.selection.focus.offset);
+                    return typeof marks.mention === 'object' && marks.mention !== null;
+                },
+            });
+        },
+    };
+    // -------------------------------------------------------------------
+    // Web attach
+    // -------------------------------------------------------------------
+    function attach(editor) {
+        // Register mention mark renderer
+        editor.markRenderers.register('mention', {
+            atomic: true,
+            apply(el, value) {
+                el.classList.add('rtif-mention');
+                el.setAttribute('contenteditable', 'false');
+                if (typeof value === 'object' && value !== null) {
+                    const m = value;
+                    if (typeof m.id === 'string') {
+                        el.setAttribute('data-mention-id', m.id);
+                    }
+                    if (typeof m.displayName === 'string') {
+                        el.setAttribute('data-mention-name', m.displayName);
+                    }
+                }
+            },
+        });
+        // Wrap TriggerSession → MentionSession
+        function wrapSession(triggerSession) {
+            return {
+                query: triggerSession.query,
+                triggerOffset: triggerSession.triggerOffset,
+                getTriggerRect: () => triggerSession.getTriggerRect(),
+                getCursorRect: () => triggerSession.getCursorRect(),
+                accept(mention) {
+                    const result = {
+                        text: `${triggerChar}${mention.displayName}`,
+                        marks: { mention: { id: mention.id, displayName: mention.displayName } },
+                        appendSpace,
+                    };
+                    triggerSession.accept(result);
+                },
+                dismiss: () => triggerSession.dismiss(),
+                isActive: () => triggerSession.isActive(),
+            };
+        }
+        // Register trigger
+        const triggerDisposable = editor.triggers.register({
+            id: 'mention',
+            char: triggerChar,
+            position: config.triggerPosition,
+            onActivate(session) {
+                config.onActivate(wrapSession(session));
+            },
+            onDeactivate: config.onDeactivate,
+            onChange: config.onChange
+                ? (session) => config.onChange(wrapSession(session))
+                : undefined,
+            onKeyDown: config.onKeyDown
+                ? (session, event) => config.onKeyDown(wrapSession(session), event)
+                : undefined,
+            onPositionChange: config.onPositionChange
+                ? (session) => config.onPositionChange(wrapSession(session))
+                : undefined,
+        });
+        return {
+            dispose() {
+                triggerDisposable.dispose();
+            },
+        };
+    }
+    return { plugin, attach };
+}
+// ---------------------------------------------------------------------------
+// Mention serializers (for format plugin integration)
+// ---------------------------------------------------------------------------
+/**
+ * Mention serializer for plaintext format.
+ * Produces: `@Alice` (just the display text, matching the span text).
+ *
+ * @example
+ * ```ts
+ * mentionPlaintextSerializer.serialize('@Alice', { id: 'u1', displayName: 'Alice' });
+ * // => '@Alice'
+ * ```
+ */
+export const mentionPlaintextSerializer = {
+    serialize(text) {
+        return text;
+    },
+};
+/**
+ * Mention serializer for markdown format.
+ * Produces: `[@Alice](mention:user-123)` (link-like syntax with mention: scheme).
+ *
+ * @example
+ * ```ts
+ * mentionMarkdownSerializer.serialize('@Alice', { id: 'u1', displayName: 'Alice' });
+ * // => '[@Alice](mention:u1)'
+ * ```
+ */
+export const mentionMarkdownSerializer = {
+    serialize(text, value) {
+        const m = value;
+        const id = m?.id ?? '';
+        return `[${text}](mention:${id})`;
+    },
+    deserialize(formatted) {
+        const match = /^\[([^\]]+)\]\(mention:([^)]+)\)$/.exec(formatted);
+        if (!match)
+            return null;
+        const displayText = match[1];
+        const id = match[2];
+        // Strip leading @ from display text if present
+        const displayName = displayText.startsWith('@') ? displayText.slice(1) : displayText;
+        return { id, displayName };
+    },
+};
+/**
+ * Mention serializer for HTML format.
+ * Produces: `<span data-mention-id="user-123" data-mention-name="Alice">@Alice</span>`.
+ *
+ * @example
+ * ```ts
+ * mentionHtmlSerializer.serialize('@Alice', { id: 'u1', displayName: 'Alice' });
+ * // => '<span data-mention-id="u1" data-mention-name="Alice">@Alice</span>'
+ * ```
+ */
+export const mentionHtmlSerializer = {
+    serialize(text, value) {
+        const m = value;
+        const id = escapeHtml(m?.id ?? '');
+        const name = escapeHtml(m?.displayName ?? '');
+        const escapedText = escapeHtml(text);
+        return `<span data-mention-id="${id}" data-mention-name="${name}">${escapedText}</span>`;
+    },
+    deserialize(formatted) {
+        const match = /data-mention-id="([^"]*)"/.exec(formatted);
+        const nameMatch = /data-mention-name="([^"]*)"/.exec(formatted);
+        if (!match)
+            return null;
+        const id = match[1];
+        const displayName = nameMatch?.[1] ?? '';
+        return { id, displayName };
+    },
+};
+/** Escape special HTML characters in a string. */
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+//# sourceMappingURL=mention-plugin.js.map

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

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

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

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

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

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

package/dist/plugins/strikethrough-plugin.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"strikethrough-plugin.js","sourceRoot":"","sources":["../../src/plugins/strikethrough-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,MAAM,EAAE,0BAA0B;CAC1B,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,EAAE,EAAE,oBAAoB;QACxB,IAAI,CAAC,GAAG;YACN,GAAG,CAAC,gBAAgB,CAAC,eAAe,EAAE;gBACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI;aACpC,CAAC,CAAC;YAEH,GAAG,CAAC,eAAe,CACjB,qBAAqB,CAAC,MAAM,EAC5B,uBAAuB,CAAC,eAAe,CAAC,CACzC,CAAC;YAEF,GAAG,CAAC,gBAAgB,CAClB,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EACpC,qBAAqB,CAAC,MAAM,CAC7B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/text-color-plugin.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Text color mark plugin — registers the `color` mark type,
+ * `setTextColor` and `removeTextColor` commands.
+ *
+ * This is a parameterized mark plugin: the mark value is a CSS color string
+ * (e.g., `"#ff0000"`, `"red"`, `"rgb(255, 0, 0)"`).
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the text color plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(TextColorCommands.SET, { color: '#ff0000' });
+ * engine.exec(TextColorCommands.REMOVE);
+ * ```
+ */
+export declare const TextColorCommands: {
+    readonly SET: "setTextColor";
+    readonly REMOVE: "removeTextColor";
+};
+/**
+ * Payload for the `setTextColor` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('setTextColor', { color: '#ff0000' });
+ * ```
+ */
+export interface SetTextColorPayload {
+    /** The CSS color value to apply */
+    readonly color: string;
+}
+/**
+ * Create the text color mark plugin.
+ *
+ * Registers:
+ * - Mark type: `color` (value must be a non-empty string)
+ * - Command: `setTextColor` — apply color to selection or set pending mark
+ * - Command: `removeTextColor` — remove color from selection or set pending mark null
+ *
+ * No keyboard shortcuts are registered.
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(textColorPlugin());
+ * engine.exec(TextColorCommands.SET, { color: '#ff0000' });
+ * engine.exec(TextColorCommands.REMOVE);
+ * ```
+ */
+export declare function textColorPlugin(): Plugin;
+//# sourceMappingURL=text-color-plugin.d.ts.map

package/dist/plugins/text-color-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-color-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/text-color-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAgBxC"}

package/dist/plugins/text-color-plugin.js

@@ -0,0 +1,56 @@
+/**
+ * Text color mark plugin — registers the `color` mark type,
+ * `setTextColor` and `removeTextColor` commands.
+ *
+ * This is a parameterized mark plugin: the mark value is a CSS color string
+ * (e.g., `"#ff0000"`, `"red"`, `"rgb(255, 0, 0)"`).
+ *
+ * @module
+ */
+import { createSetMarkCommand, createRemoveMarkCommand } from './mark-utils.js';
+/**
+ * Command name constants for the text color plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(TextColorCommands.SET, { color: '#ff0000' });
+ * engine.exec(TextColorCommands.REMOVE);
+ * ```
+ */
+export const TextColorCommands = {
+    SET: 'setTextColor',
+    REMOVE: 'removeTextColor',
+};
+/**
+ * Create the text color mark plugin.
+ *
+ * Registers:
+ * - Mark type: `color` (value must be a non-empty string)
+ * - Command: `setTextColor` — apply color to selection or set pending mark
+ * - Command: `removeTextColor` — remove color from selection or set pending mark null
+ *
+ * No keyboard shortcuts are registered.
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(textColorPlugin());
+ * engine.exec(TextColorCommands.SET, { color: '#ff0000' });
+ * engine.exec(TextColorCommands.REMOVE);
+ * ```
+ */
+export function textColorPlugin() {
+    return {
+        id: 'mark-color',
+        init(ctx) {
+            ctx.registerMarkType('color', {
+                validate: (value) => typeof value === 'string' && value.length > 0,
+            });
+            ctx.registerCommand(TextColorCommands.SET, createSetMarkCommand('color', (p) => p.color));
+            ctx.registerCommand(TextColorCommands.REMOVE, createRemoveMarkCommand('color'));
+        },
+    };
+}
+//# sourceMappingURL=text-color-plugin.js.map

package/dist/plugins/text-color-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-color-plugin.js","sourceRoot":"","sources":["../../src/plugins/text-color-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,cAAc;IACnB,MAAM,EAAE,iBAAiB;CACjB,CAAC;AAeX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,IAAI,CAAC,GAAG;YACN,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE;gBAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;aACnE,CAAC,CAAC;YAEH,GAAG,CAAC,eAAe,CACjB,iBAAiB,CAAC,GAAG,EACrB,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAE,CAAyB,CAAC,KAAK,CAAC,CACvE,CAAC;YAEF,GAAG,CAAC,eAAe,CAAC,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;QAClF,CAAC;KACF,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/plugins/underline-plugin.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"underline-plugin.js","sourceRoot":"","sources":["../../src/plugins/underline-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,sBAAsB;CACtB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,EAAE,EAAE,gBAAgB;QACpB,IAAI,CAAC,GAAG;YACN,GAAG,CAAC,gBAAgB,CAAC,WAAW,EAAE;gBAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI;aACpC,CAAC,CAAC;YAEH,GAAG,CAAC,eAAe,CACjB,iBAAiB,CAAC,MAAM,EACxB,uBAAuB,CAAC,WAAW,CAAC,CACrC,CAAC;YAEF,GAAG,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1E,CAAC;KACF,CAAC;AACJ,CAAC"}