@rtif-sdk/web 1.0.0

package/dist/plugins/embed-plugin.js

@@ -0,0 +1,147 @@
+/**
+ * Embed block type plugin — registers the `embed` block type and
+ * `insertEmbed` / `removeEmbed` commands for embedding external content
+ * (YouTube, Twitter/X, Vimeo, etc.) as atomic, non-editable blocks.
+ *
+ * Embed blocks are atomic — they carry no meaningful text content.
+ * Their visual representation is determined by the block renderer layer
+ * (iframe, provider-specific HTML, etc.) based on the `url` and
+ * `embedType` attributes.
+ *
+ * @module
+ */
+import { blockTextLength } from '@rtif-sdk/core';
+import { getBlockAtCursor, getBlockStartOffset } from './block-utils.js';
+/**
+ * Command name constants for the embed plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(EmbedCommands.INSERT, { url: 'https://youtube.com/...' });
+ * engine.exec(EmbedCommands.REMOVE, { blockId: 'b3' });
+ * ```
+ */
+export const EmbedCommands = {
+    INSERT: 'insertEmbed',
+    REMOVE: 'removeEmbed',
+};
+/**
+ * Create the embed block type plugin.
+ *
+ * Registers:
+ * - Block type: `embed` (attrs must include `url` as a non-empty string)
+ * - Command: `insertEmbed` — inserts a new embed block after the current block
+ * - Command: `removeEmbed` — reverts an embed block to plain text, clearing embed attrs
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(embedPlugin());
+ *
+ * // Insert a YouTube embed after the current block
+ * engine.exec(EmbedCommands.INSERT, {
+ *   url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
+ *   type: 'video',
+ * });
+ *
+ * // Remove the embed, reverting to a plain text block
+ * engine.exec(EmbedCommands.REMOVE, { blockId: 'b2' });
+ * ```
+ */
+export function embedPlugin() {
+    return {
+        id: 'block-embed',
+        init(ctx) {
+            // ---------------------------------------------------------------
+            // Block type registration
+            // ---------------------------------------------------------------
+            ctx.registerBlockType('embed', {
+                validate: (attrs) => {
+                    return typeof attrs.url === 'string' && attrs.url.length > 0;
+                },
+            });
+            // ---------------------------------------------------------------
+            // insertEmbed command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(EmbedCommands.INSERT, {
+                /**
+                 * Insert a new embed block after the block at the cursor.
+                 *
+                 * Implementation:
+                 * 1. Get the current block and compute its end offset.
+                 * 2. `split_block` at the end offset to create a new empty block.
+                 * 3. `set_block_type` on the new block to `'embed'`.
+                 * 4. `set_block_attrs` on the new block with `{ url, embedType }`.
+                 *
+                 * @param engine - The editor engine instance
+                 * @param payload - {@link InsertEmbedPayload} with `url` and optional `type`
+                 */
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || typeof p.url !== 'string' || p.url.length === 0)
+                        return;
+                    const block = getBlockAtCursor(engine);
+                    const blockStart = getBlockStartOffset(engine.state.doc, block.id);
+                    const blockLen = blockTextLength(block);
+                    const splitOffset = blockStart + blockLen;
+                    const newBlockId = `${block.id}_embed`;
+                    const embedType = p.type ?? 'generic';
+                    const ops = [
+                        { type: 'split_block', offset: splitOffset, newBlockId },
+                        { type: 'set_block_type', blockId: newBlockId, blockType: 'embed' },
+                        {
+                            type: 'set_block_attrs',
+                            blockId: newBlockId,
+                            attrs: { url: p.url, embedType },
+                        },
+                    ];
+                    engine.dispatch(ops);
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+            });
+            // ---------------------------------------------------------------
+            // removeEmbed command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(EmbedCommands.REMOVE, {
+                /**
+                 * Remove an embed block, reverting it to a plain text block.
+                 *
+                 * Sets the block's type to `'text'` and clears the embed-specific
+                 * attrs (`url` and `embedType`).
+                 *
+                 * @param engine - The editor engine instance
+                 * @param payload - {@link RemoveEmbedPayload} with `blockId`
+                 */
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || typeof p.blockId !== 'string')
+                        return;
+                    const block = engine.state.doc.blocks.find((b) => b.id === p.blockId);
+                    if (!block || block.type !== 'embed')
+                        return;
+                    const ops = [
+                        { type: 'set_block_type', blockId: p.blockId, blockType: 'text' },
+                        {
+                            type: 'set_block_attrs',
+                            blockId: p.blockId,
+                            attrs: { url: null, embedType: null },
+                        },
+                    ];
+                    engine.dispatch(ops);
+                },
+                canExecute(engine, payload) {
+                    const p = payload;
+                    if (!p || typeof p.blockId !== 'string')
+                        return false;
+                    const block = engine.state.doc.blocks.find((b) => b.id === p.blockId);
+                    return block !== undefined && block.type === 'embed';
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=embed-plugin.js.map

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

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

package/dist/plugins/font-family-plugin.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Font family mark plugin — registers the `fontFamily` mark type,
+ * `setFontFamily` and `removeFontFamily` commands.
+ *
+ * This is a parameterized mark plugin: the mark value is a non-empty string
+ * representing a CSS font-family value (e.g., `"Arial"`, `"monospace"`,
+ * `"'Courier New', monospace"`).
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the font family plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(FontFamilyCommands.SET, { family: 'Georgia' });
+ * engine.exec(FontFamilyCommands.REMOVE);
+ * ```
+ */
+export declare const FontFamilyCommands: {
+    readonly SET: "setFontFamily";
+    readonly REMOVE: "removeFontFamily";
+};
+/**
+ * Payload for the `setFontFamily` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('setFontFamily', { family: 'Arial' });
+ * ```
+ */
+export interface SetFontFamilyPayload {
+    /** The CSS font-family value to apply */
+    readonly family: string;
+}
+/**
+ * Create the font family mark plugin.
+ *
+ * Registers:
+ * - Mark type: `fontFamily` (value must be a non-empty string)
+ * - Command: `setFontFamily` — apply font family to selection or set pending mark
+ * - Command: `removeFontFamily` — remove font family 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(fontFamilyPlugin());
+ * engine.exec(FontFamilyCommands.SET, { family: 'Georgia' });
+ * engine.exec(FontFamilyCommands.REMOVE);
+ * ```
+ */
+export declare function fontFamilyPlugin(): Plugin;
+//# sourceMappingURL=font-family-plugin.d.ts.map

package/dist/plugins/font-family-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-family-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/font-family-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAgBzC"}

package/dist/plugins/font-family-plugin.js

@@ -0,0 +1,57 @@
+/**
+ * Font family mark plugin — registers the `fontFamily` mark type,
+ * `setFontFamily` and `removeFontFamily` commands.
+ *
+ * This is a parameterized mark plugin: the mark value is a non-empty string
+ * representing a CSS font-family value (e.g., `"Arial"`, `"monospace"`,
+ * `"'Courier New', monospace"`).
+ *
+ * @module
+ */
+import { createSetMarkCommand, createRemoveMarkCommand } from './mark-utils.js';
+/**
+ * Command name constants for the font family plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(FontFamilyCommands.SET, { family: 'Georgia' });
+ * engine.exec(FontFamilyCommands.REMOVE);
+ * ```
+ */
+export const FontFamilyCommands = {
+    SET: 'setFontFamily',
+    REMOVE: 'removeFontFamily',
+};
+/**
+ * Create the font family mark plugin.
+ *
+ * Registers:
+ * - Mark type: `fontFamily` (value must be a non-empty string)
+ * - Command: `setFontFamily` — apply font family to selection or set pending mark
+ * - Command: `removeFontFamily` — remove font family 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(fontFamilyPlugin());
+ * engine.exec(FontFamilyCommands.SET, { family: 'Georgia' });
+ * engine.exec(FontFamilyCommands.REMOVE);
+ * ```
+ */
+export function fontFamilyPlugin() {
+    return {
+        id: 'mark-fontFamily',
+        init(ctx) {
+            ctx.registerMarkType('fontFamily', {
+                validate: (value) => typeof value === 'string' && value.length > 0,
+            });
+            ctx.registerCommand(FontFamilyCommands.SET, createSetMarkCommand('fontFamily', (p) => p.family));
+            ctx.registerCommand(FontFamilyCommands.REMOVE, createRemoveMarkCommand('fontFamily'));
+        },
+    };
+}
+//# sourceMappingURL=font-family-plugin.js.map

package/dist/plugins/font-family-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-family-plugin.js","sourceRoot":"","sources":["../../src/plugins/font-family-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,eAAe;IACpB,MAAM,EAAE,kBAAkB;CAClB,CAAC;AAeX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,EAAE,EAAE,iBAAiB;QACrB,IAAI,CAAC,GAAG;YACN,GAAG,CAAC,gBAAgB,CAAC,YAAY,EAAE;gBACjC,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,kBAAkB,CAAC,GAAG,EACtB,oBAAoB,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAE,CAA0B,CAAC,MAAM,CAAC,CAC9E,CAAC;YAEF,GAAG,CAAC,eAAe,CAAC,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC,CAAC;QACxF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/font-size-plugin.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Font size mark plugin — registers the `fontSize` mark type,
+ * `setFontSize` and `removeFontSize` commands.
+ *
+ * This is a parameterized mark plugin: the mark value is a positive number
+ * representing the font size (unit is consumer-defined, typically px or pt).
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the font size plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(FontSizeCommands.SET, { size: 24 });
+ * engine.exec(FontSizeCommands.REMOVE);
+ * ```
+ */
+export declare const FontSizeCommands: {
+    readonly SET: "setFontSize";
+    readonly REMOVE: "removeFontSize";
+};
+/**
+ * Payload for the `setFontSize` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('setFontSize', { size: 16 });
+ * ```
+ */
+export interface SetFontSizePayload {
+    /** The font size value (must be a positive number) */
+    readonly size: number;
+}
+/**
+ * Create the font size mark plugin.
+ *
+ * Registers:
+ * - Mark type: `fontSize` (value must be a positive number)
+ * - Command: `setFontSize` — apply font size to selection or set pending mark
+ * - Command: `removeFontSize` — remove font size 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(fontSizePlugin());
+ * engine.exec(FontSizeCommands.SET, { size: 24 });
+ * engine.exec(FontSizeCommands.REMOVE);
+ * ```
+ */
+export declare function fontSizePlugin(): Plugin;
+//# sourceMappingURL=font-size-plugin.d.ts.map

package/dist/plugins/font-size-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-size-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/font-size-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAgBvC"}

package/dist/plugins/font-size-plugin.js

@@ -0,0 +1,56 @@
+/**
+ * Font size mark plugin — registers the `fontSize` mark type,
+ * `setFontSize` and `removeFontSize` commands.
+ *
+ * This is a parameterized mark plugin: the mark value is a positive number
+ * representing the font size (unit is consumer-defined, typically px or pt).
+ *
+ * @module
+ */
+import { createSetMarkCommand, createRemoveMarkCommand } from './mark-utils.js';
+/**
+ * Command name constants for the font size plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(FontSizeCommands.SET, { size: 24 });
+ * engine.exec(FontSizeCommands.REMOVE);
+ * ```
+ */
+export const FontSizeCommands = {
+    SET: 'setFontSize',
+    REMOVE: 'removeFontSize',
+};
+/**
+ * Create the font size mark plugin.
+ *
+ * Registers:
+ * - Mark type: `fontSize` (value must be a positive number)
+ * - Command: `setFontSize` — apply font size to selection or set pending mark
+ * - Command: `removeFontSize` — remove font size 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(fontSizePlugin());
+ * engine.exec(FontSizeCommands.SET, { size: 24 });
+ * engine.exec(FontSizeCommands.REMOVE);
+ * ```
+ */
+export function fontSizePlugin() {
+    return {
+        id: 'mark-fontSize',
+        init(ctx) {
+            ctx.registerMarkType('fontSize', {
+                validate: (value) => typeof value === 'number' && value > 0,
+            });
+            ctx.registerCommand(FontSizeCommands.SET, createSetMarkCommand('fontSize', (p) => p.size));
+            ctx.registerCommand(FontSizeCommands.REMOVE, createRemoveMarkCommand('fontSize'));
+        },
+    };
+}
+//# sourceMappingURL=font-size-plugin.js.map

package/dist/plugins/font-size-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-size-plugin.js","sourceRoot":"","sources":["../../src/plugins/font-size-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,aAAa;IAClB,MAAM,EAAE,gBAAgB;CAChB,CAAC;AAeX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,IAAI,CAAC,GAAG;YACN,GAAG,CAAC,gBAAgB,CAAC,UAAU,EAAE;gBAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;aAC5D,CAAC,CAAC;YAEH,GAAG,CAAC,eAAe,CACjB,gBAAgB,CAAC,GAAG,EACpB,oBAAoB,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAE,CAAwB,CAAC,IAAI,CAAC,CACxE,CAAC;YAEF,GAAG,CAAC,eAAe,CAAC,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * Heading block type plugin — registers the `heading` block type, `toggleHeading`
+ * command, input rules for `# ` through `###### `, and Cmd/Ctrl+Alt+1/2/3 shortcuts.
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the heading plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(HeadingCommands.TOGGLE, { level: 2 });
+ * ```
+ */
+export declare const HeadingCommands: {
+    readonly TOGGLE: "toggleHeading";
+};
+/**
+ * Payload for the `toggleHeading` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('toggleHeading', { level: 2 });
+ * ```
+ */
+export interface ToggleHeadingPayload {
+    /** Heading level (1-6) */
+    readonly level: number;
+}
+/**
+ * Create the heading block type plugin.
+ *
+ * Registers:
+ * - Block type: `heading` (attrs must have `level` between 1 and 6)
+ * - Command: `toggleHeading` — toggle between heading at a given level and plain text
+ * - Input rules: `# ` through `###### ` at block start converts to heading
+ * - Shortcuts: Cmd/Ctrl+Alt+1/2/3 for heading levels 1-3
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(headingPlugin());
+ *
+ * // Toggle heading level 2 on the block at cursor
+ * engine.exec(HeadingCommands.TOGGLE, { level: 2 });
+ * ```
+ */
+export declare function headingPlugin(): Plugin;
+//# sourceMappingURL=heading-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heading-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/heading-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAG9D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;CAElB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,IAAI,MAAM,CA2FtC"}

package/dist/plugins/heading-plugin.js

@@ -0,0 +1,114 @@
+/**
+ * Heading block type plugin — registers the `heading` block type, `toggleHeading`
+ * command, input rules for `# ` through `###### `, and Cmd/Ctrl+Alt+1/2/3 shortcuts.
+ *
+ * @module
+ */
+import { getBlockStartOffset, getBlockAtCursor, isBlockType, setBlockType } from './block-utils.js';
+/**
+ * Command name constants for the heading plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(HeadingCommands.TOGGLE, { level: 2 });
+ * ```
+ */
+export const HeadingCommands = {
+    TOGGLE: 'toggleHeading',
+};
+/**
+ * Create the heading block type plugin.
+ *
+ * Registers:
+ * - Block type: `heading` (attrs must have `level` between 1 and 6)
+ * - Command: `toggleHeading` — toggle between heading at a given level and plain text
+ * - Input rules: `# ` through `###### ` at block start converts to heading
+ * - Shortcuts: Cmd/Ctrl+Alt+1/2/3 for heading levels 1-3
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(headingPlugin());
+ *
+ * // Toggle heading level 2 on the block at cursor
+ * engine.exec(HeadingCommands.TOGGLE, { level: 2 });
+ * ```
+ */
+export function headingPlugin() {
+    return {
+        id: 'block-heading',
+        init(ctx) {
+            // ---------------------------------------------------------------
+            // Block type registration
+            // ---------------------------------------------------------------
+            ctx.registerBlockType('heading', {
+                defaultAttrs: { level: 1 },
+                validate: (attrs) => {
+                    return (typeof attrs.level === 'number' &&
+                        attrs.level >= 1 &&
+                        attrs.level <= 6);
+                },
+            });
+            // ---------------------------------------------------------------
+            // toggleHeading command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(HeadingCommands.TOGGLE, {
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || typeof p.level !== 'number')
+                        return;
+                    const block = getBlockAtCursor(engine);
+                    if (isBlockType(engine, 'heading', { level: p.level })) {
+                        // Already a heading at this level — revert to plain text
+                        engine.dispatch([
+                            { type: 'set_block_type', blockId: block.id, blockType: 'text' },
+                            { type: 'set_block_attrs', blockId: block.id, attrs: { level: null } },
+                        ]);
+                    }
+                    else {
+                        // Set to heading with the requested level
+                        setBlockType(engine, block.id, 'heading', { level: p.level });
+                    }
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+                isActive(engine, payload) {
+                    const p = payload;
+                    if (!p || typeof p.level !== 'number')
+                        return false;
+                    return isBlockType(engine, 'heading', { level: p.level });
+                },
+            });
+            // ---------------------------------------------------------------
+            // Input rules: # through ###### followed by space
+            // ---------------------------------------------------------------
+            for (let level = 1; level <= 6; level++) {
+                const hashes = '#'.repeat(level);
+                const pattern = new RegExp(`^${hashes} $`);
+                ctx.registerInputRule({
+                    pattern,
+                    exclusive: true,
+                    handler(engine, match, blockId) {
+                        const blockStart = getBlockStartOffset(engine.state.doc, blockId);
+                        const prefixLength = match[0].length;
+                        engine.dispatch([
+                            { type: 'delete_text', offset: blockStart, count: prefixLength },
+                            { type: 'set_block_type', blockId, blockType: 'heading' },
+                            { type: 'set_block_attrs', blockId, attrs: { level } },
+                        ]);
+                    },
+                });
+            }
+            // ---------------------------------------------------------------
+            // Keyboard shortcuts: Cmd/Ctrl+Alt+1/2/3
+            // ---------------------------------------------------------------
+            for (let level = 1; level <= 3; level++) {
+                ctx.registerShortcut({ key: String(level), mod: true, alt: true }, HeadingCommands.TOGGLE, { level });
+            }
+        },
+    };
+}
+//# sourceMappingURL=heading-plugin.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Horizontal rule block type plugin — registers the `hr` block type and
+ * an input rule for `---` at the start of an empty block.
+ *
+ * The HR plugin does not register any commands — horizontal rules are
+ * created exclusively via the input rule or programmatic operation dispatch.
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Create the horizontal rule block type plugin.
+ *
+ * Registers:
+ * - Block type: `hr` (no default attrs)
+ * - Input rule: `---` at the start of an empty block converts to an HR
+ *   and inserts a new empty text block below it
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(hrPlugin());
+ *
+ * // Type "---" then the input rule fires:
+ * // 1. Deletes the "---" text
+ * // 2. Sets block type to 'hr'
+ * // 3. Splits block to create a new empty text block below
+ * ```
+ */
+export declare function hrPlugin(): Plugin;
+//# sourceMappingURL=hr-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hr-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/hr-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAI9D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA+CjC"}