@rtif-sdk/web 1.0.0

package/dist/plugins/callout-plugin.js

@@ -0,0 +1,200 @@
+/**
+ * Callout block type plugin — registers the `callout` block type with 5 variants
+ * (info, warning, error, success, note), three commands (`insertCallout`,
+ * `setCalloutVariant`, `toggleCallout`), and an input rule for `> !` at block start.
+ *
+ * Callouts are blocks with a colored border, icon, and editable content area.
+ * The variant determines the visual treatment (color, icon) applied by the
+ * block renderer in the web layer.
+ *
+ * @module
+ */
+import { getBlockStartOffset, getBlockAtCursor, isBlockType, setBlockType } from './block-utils.js';
+/**
+ * Command name constants for the callout plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(CalloutCommands.INSERT, { variant: 'warning' });
+ * engine.exec(CalloutCommands.SET_VARIANT, { variant: 'error' });
+ * engine.exec(CalloutCommands.TOGGLE);
+ * ```
+ */
+export const CalloutCommands = {
+    INSERT: 'insertCallout',
+    SET_VARIANT: 'setCalloutVariant',
+    TOGGLE: 'toggleCallout',
+};
+/** All valid callout variant values, used for validation. */
+const VALID_VARIANTS = new Set([
+    'info',
+    'warning',
+    'error',
+    'success',
+    'note',
+]);
+/**
+ * Check whether a variant string is a valid {@link CalloutVariant}.
+ *
+ * @param value - The value to check
+ * @returns `true` if the value is one of the 5 valid variant strings
+ *
+ * @example
+ * ```ts
+ * isValidVariant('info');    // true
+ * isValidVariant('danger');  // false
+ * ```
+ */
+function isValidVariant(value) {
+    return typeof value === 'string' && VALID_VARIANTS.has(value);
+}
+/**
+ * Create the callout block type plugin.
+ *
+ * Registers:
+ * - Block type: `callout` (attrs must have `variant` as one of 5 valid values)
+ * - Command: `insertCallout` — convert the block at cursor to a callout with
+ *   an optional variant payload (defaults to `'info'`)
+ * - Command: `setCalloutVariant` — change the variant attr on the current
+ *   callout block (only executable when cursor is in a callout)
+ * - Command: `toggleCallout` — toggle between callout (info variant) and
+ *   plain text
+ * - Input rule: `> !` at the start of a block converts to a callout with
+ *   `'info'` variant
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(calloutPlugin());
+ *
+ * // Convert block at cursor to a warning callout
+ * engine.exec(CalloutCommands.INSERT, { variant: 'warning' });
+ *
+ * // Change variant of the current callout
+ * engine.exec(CalloutCommands.SET_VARIANT, { variant: 'error' });
+ *
+ * // Toggle callout on/off (uses 'info' variant when toggling on)
+ * engine.exec(CalloutCommands.TOGGLE);
+ * ```
+ */
+export function calloutPlugin() {
+    return {
+        id: 'block-callout',
+        init(ctx) {
+            // ---------------------------------------------------------------
+            // Block type registration
+            // ---------------------------------------------------------------
+            ctx.registerBlockType('callout', {
+                defaultAttrs: { variant: 'info' },
+                validate: (attrs) => {
+                    return isValidVariant(attrs.variant);
+                },
+            });
+            // ---------------------------------------------------------------
+            // insertCallout command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(CalloutCommands.INSERT, {
+                /**
+                 * Convert the block at the cursor to a callout with the given variant.
+                 * If no variant is provided in the payload, defaults to `'info'`.
+                 */
+                execute(engine, payload) {
+                    const p = payload;
+                    const variant = p?.variant ?? 'info';
+                    if (!isValidVariant(variant))
+                        return;
+                    const block = getBlockAtCursor(engine);
+                    setBlockType(engine, block.id, 'callout', { variant });
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+                isActive(engine) {
+                    return isBlockType(engine, 'callout');
+                },
+            });
+            // ---------------------------------------------------------------
+            // setCalloutVariant command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(CalloutCommands.SET_VARIANT, {
+                /**
+                 * Change the variant attr on the current callout block.
+                 * Requires a payload with `{ variant: CalloutVariant }`.
+                 * Only executable when the cursor is inside a callout block.
+                 */
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || !isValidVariant(p.variant))
+                        return;
+                    const block = getBlockAtCursor(engine);
+                    if (block.type !== 'callout')
+                        return;
+                    engine.dispatch({
+                        type: 'set_block_attrs',
+                        blockId: block.id,
+                        attrs: { variant: p.variant },
+                    });
+                },
+                canExecute(engine) {
+                    return isBlockType(engine, 'callout');
+                },
+                isActive(engine, payload) {
+                    const p = payload;
+                    if (!p || !isValidVariant(p.variant))
+                        return false;
+                    return isBlockType(engine, 'callout', { variant: p.variant });
+                },
+            });
+            // ---------------------------------------------------------------
+            // toggleCallout command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(CalloutCommands.TOGGLE, {
+                /**
+                 * Toggle between callout (info variant) and plain text.
+                 * When the block is already a callout, reverts to text and clears
+                 * the variant attr. When the block is not a callout, converts to
+                 * a callout with the `'info'` variant.
+                 */
+                execute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    if (isBlockType(engine, 'callout')) {
+                        // Already a callout — revert to plain text and clear variant
+                        engine.dispatch([
+                            { type: 'set_block_type', blockId: block.id, blockType: 'text' },
+                            { type: 'set_block_attrs', blockId: block.id, attrs: { variant: null } },
+                        ]);
+                    }
+                    else {
+                        // Set to callout with info variant
+                        setBlockType(engine, block.id, 'callout', { variant: 'info' });
+                    }
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+                isActive(engine) {
+                    return isBlockType(engine, 'callout');
+                },
+            });
+            // ---------------------------------------------------------------
+            // Input rule: > ! at block start converts to callout
+            // ---------------------------------------------------------------
+            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: 'callout' },
+                        { type: 'set_block_attrs', blockId, attrs: { variant: 'info' } },
+                    ]);
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=callout-plugin.js.map

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

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

package/dist/plugins/code-block-plugin.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Code block type plugin — registers the `code_block` block type,
+ * `toggleCodeBlock` and `setCodeLanguage` commands, and an input rule
+ * for triple backtick + space at block start.
+ *
+ * Also intercepts `split_block` inside code blocks via `beforeApply`,
+ * replacing them with `insert_text('\n')` so that Enter inserts a
+ * newline instead of creating a new block.
+ *
+ * @module
+ */
+import type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the code block plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(CodeBlockCommands.TOGGLE);
+ * engine.exec(CodeBlockCommands.SET_LANGUAGE, { language: 'typescript' });
+ * ```
+ */
+export declare const CodeBlockCommands: {
+    readonly TOGGLE: "toggleCodeBlock";
+    readonly SET_LANGUAGE: "setCodeLanguage";
+};
+/**
+ * Payload for the `setCodeLanguage` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('setCodeLanguage', { language: 'typescript' });
+ * ```
+ */
+export interface SetCodeLanguagePayload {
+    /** The programming language identifier (e.g., "typescript", "python") */
+    readonly language: string;
+}
+/**
+ * Create the code block type plugin.
+ *
+ * Registers:
+ * - Block type: `code_block` (defaultAttrs: `{ language: '' }`, language must be a string)
+ * - Command: `toggleCodeBlock` — toggle between code block and plain text
+ * - Command: `setCodeLanguage` — set the language attribute on a code block
+ * - Input rule: ``` followed by space at block start converts to code block
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(codeBlockPlugin());
+ *
+ * // Toggle code block on the block at cursor
+ * engine.exec(CodeBlockCommands.TOGGLE);
+ *
+ * // Set language on the current code block
+ * engine.exec(CodeBlockCommands.SET_LANGUAGE, { language: 'typescript' });
+ * ```
+ */
+export declare function codeBlockPlugin(): Plugin;
+//# sourceMappingURL=code-block-plugin.d.ts.map

package/dist/plugins/code-block-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/code-block-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,kBAAkB,CAAC;AAG3E;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAgJxC"}

package/dist/plugins/code-block-plugin.js

@@ -0,0 +1,176 @@
+/**
+ * Code block type plugin — registers the `code_block` block type,
+ * `toggleCodeBlock` and `setCodeLanguage` commands, and an input rule
+ * for triple backtick + space at block start.
+ *
+ * Also intercepts `split_block` inside code blocks via `beforeApply`,
+ * replacing them with `insert_text('\n')` so that Enter inserts a
+ * newline instead of creating a new block.
+ *
+ * @module
+ */
+import { resolve, blockTextLength } from '@rtif-sdk/core';
+import { getBlockStartOffset, getBlockAtCursor, isBlockType, setBlockType } from './block-utils.js';
+/**
+ * Command name constants for the code block plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(CodeBlockCommands.TOGGLE);
+ * engine.exec(CodeBlockCommands.SET_LANGUAGE, { language: 'typescript' });
+ * ```
+ */
+export const CodeBlockCommands = {
+    TOGGLE: 'toggleCodeBlock',
+    SET_LANGUAGE: 'setCodeLanguage',
+};
+/**
+ * Create the code block type plugin.
+ *
+ * Registers:
+ * - Block type: `code_block` (defaultAttrs: `{ language: '' }`, language must be a string)
+ * - Command: `toggleCodeBlock` — toggle between code block and plain text
+ * - Command: `setCodeLanguage` — set the language attribute on a code block
+ * - Input rule: ``` followed by space at block start converts to code block
+ *
+ * @returns A plugin instance ready for `engine.use()`
+ *
+ * @example
+ * ```ts
+ * const engine = createEngine(initialDoc);
+ * engine.use(codeBlockPlugin());
+ *
+ * // Toggle code block on the block at cursor
+ * engine.exec(CodeBlockCommands.TOGGLE);
+ *
+ * // Set language on the current code block
+ * engine.exec(CodeBlockCommands.SET_LANGUAGE, { language: 'typescript' });
+ * ```
+ */
+export function codeBlockPlugin() {
+    return {
+        id: 'block-code-block',
+        beforeApply(ops, state) {
+            const removedBlockIds = new Set();
+            const transformed = ops.flatMap((op) => {
+                if (op.type !== 'split_block')
+                    return [op];
+                let resolved;
+                let block;
+                try {
+                    resolved = resolve(state.doc, op.offset);
+                    block = state.doc.blocks[resolved.blockIndex];
+                    if (!block || block.type !== 'code_block')
+                        return [op];
+                }
+                catch {
+                    return [op];
+                }
+                const blockLen = blockTextLength(block);
+                // Exit condition: cursor at end of block and block text ends with \n.
+                // This implements "double-Enter to exit" — the first Enter inserted \n,
+                // the second Enter exits the code block and creates a new text block.
+                if (resolved.localOffset === blockLen && blockLen > 0) {
+                    let blockText = '';
+                    for (const span of block.spans) {
+                        blockText += span.text;
+                    }
+                    if (blockText.endsWith('\n')) {
+                        const newBlockId = op.newBlockId ?? `${block.id}_split`;
+                        const deleteOffset = op.offset - 1;
+                        return [
+                            { type: 'delete_text', offset: deleteOffset, count: 1 },
+                            { type: 'split_block', offset: deleteOffset, newBlockId },
+                            { type: 'set_block_type', blockId: newBlockId, blockType: 'text' },
+                        ];
+                    }
+                }
+                // Normal case: convert split_block to insert_text('\n')
+                if (op.newBlockId) {
+                    removedBlockIds.add(op.newBlockId);
+                }
+                return [{ type: 'insert_text', offset: op.offset, text: '\n' }];
+            });
+            if (removedBlockIds.size === 0)
+                return transformed;
+            return transformed.filter((op) => {
+                if ((op.type === 'set_block_type' || op.type === 'set_block_attrs' || op.type === 'merge_block') &&
+                    removedBlockIds.has(op.blockId)) {
+                    return false;
+                }
+                return true;
+            });
+        },
+        init(ctx) {
+            // ---------------------------------------------------------------
+            // Block type registration
+            // ---------------------------------------------------------------
+            ctx.registerBlockType('code_block', {
+                defaultAttrs: { language: '' },
+                validate: (attrs) => {
+                    return typeof attrs.language === 'string';
+                },
+            });
+            // ---------------------------------------------------------------
+            // toggleCodeBlock command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(CodeBlockCommands.TOGGLE, {
+                execute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    if (isBlockType(engine, 'code_block')) {
+                        // Already a code block — revert to plain text and clear language attr
+                        engine.dispatch([
+                            { type: 'set_block_type', blockId: block.id, blockType: 'text' },
+                            { type: 'set_block_attrs', blockId: block.id, attrs: { language: null } },
+                        ]);
+                    }
+                    else {
+                        // Set to code block
+                        setBlockType(engine, block.id, 'code_block');
+                    }
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+                isActive(engine) {
+                    return isBlockType(engine, 'code_block');
+                },
+            });
+            // ---------------------------------------------------------------
+            // setCodeLanguage command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(CodeBlockCommands.SET_LANGUAGE, {
+                execute(engine, payload) {
+                    const p = payload;
+                    if (!p || typeof p.language !== 'string')
+                        return;
+                    const block = getBlockAtCursor(engine);
+                    if (block.type !== 'code_block')
+                        return;
+                    engine.dispatch([
+                        { type: 'set_block_attrs', blockId: block.id, attrs: { language: p.language } },
+                    ]);
+                },
+                canExecute(engine) {
+                    return isBlockType(engine, 'code_block');
+                },
+            });
+            // ---------------------------------------------------------------
+            // Input rule: ``` followed by space at block start
+            // ---------------------------------------------------------------
+            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: 'code_block' },
+                    ]);
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=code-block-plugin.js.map

package/dist/plugins/code-block-plugin.js.map

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

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

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

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

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

package/dist/plugins/code-plugin.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-plugin.js","sourceRoot":"","sources":["../../src/plugins/code-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,iBAAiB;CACjB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,EAAE,EAAE,WAAW;QACf,IAAI,CAAC,GAAG;YACN,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE;gBAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI;aACpC,CAAC,CAAC;YAEH,GAAG,CAAC,eAAe,CAAC,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;YAE9E,GAAG,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzE,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * 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 type { Plugin } from '@rtif-sdk/engine';
+/**
+ * Command name constants for the embed plugin.
+ *
+ * @example
+ * ```ts
+ * engine.exec(EmbedCommands.INSERT, { url: 'https://youtube.com/...' });
+ * engine.exec(EmbedCommands.REMOVE, { blockId: 'b3' });
+ * ```
+ */
+export declare const EmbedCommands: {
+    readonly INSERT: "insertEmbed";
+    readonly REMOVE: "removeEmbed";
+};
+/**
+ * The kind of embedded content.
+ *
+ * - `'video'` — Video embeds (YouTube, Vimeo, etc.)
+ * - `'tweet'` — Social media embeds (Twitter/X, etc.)
+ * - `'generic'` — Fallback for any other embeddable URL
+ */
+export type EmbedType = 'video' | 'tweet' | 'generic';
+/**
+ * Payload for the `insertEmbed` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('insertEmbed', {
+ *   url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
+ *   type: 'video',
+ * });
+ * ```
+ */
+export interface InsertEmbedPayload {
+    /** The URL of the content to embed */
+    readonly url: string;
+    /** The embed type. Defaults to `'generic'` when omitted. */
+    readonly type?: EmbedType;
+}
+/**
+ * Payload for the `removeEmbed` command.
+ *
+ * @example
+ * ```ts
+ * engine.exec('removeEmbed', { blockId: 'b3' });
+ * ```
+ */
+export interface RemoveEmbedPayload {
+    /** The ID of the embed block to revert to plain text */
+    readonly blockId: string;
+}
+/**
+ * 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 declare function embedPlugin(): Plugin;
+//# sourceMappingURL=embed-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embed-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/embed-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAK9D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,IAAI,MAAM,CA4GpC"}