@rtif-sdk/web 1.0.0

package/dist/plugins/list-plugin.js

@@ -0,0 +1,309 @@
+/**
+ * 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 { blockTextLength, resolve } from '@rtif-sdk/core';
+import { getBlockAtCursor, getBlockStartOffset } from './block-utils.js';
+/**
+ * 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 const ListCommands = {
+    TOGGLE_BULLET: 'toggleBulletList',
+    TOGGLE_ORDERED: 'toggleOrderedList',
+    INDENT: 'indentList',
+    OUTDENT: 'outdentList',
+};
+/** Maximum nesting depth for list items */
+const MAX_DEPTH = 8;
+/**
+ * Check whether a block is a list-item with an optional specific listStyle.
+ *
+ * @param block - The block to inspect
+ * @param listStyle - If provided, also check the listStyle attr matches
+ * @returns `true` if the block is a list-item with the matching style
+ *
+ * @example
+ * ```ts
+ * isListItem(block); // true if block.type === 'list-item'
+ * isListItem(block, 'bullet'); // true if also listStyle === 'bullet'
+ * ```
+ */
+function isListItem(block, listStyle) {
+    if (block.type !== 'list-item') {
+        return false;
+    }
+    if (listStyle === undefined) {
+        return true;
+    }
+    return block.attrs?.listStyle === listStyle;
+}
+/**
+ * Get the current depth of a list-item block.
+ *
+ * @param block - A list-item block
+ * @returns The depth value, defaulting to 0 if not set
+ */
+function getDepth(block) {
+    const depth = block.attrs?.depth;
+    return typeof depth === 'number' ? depth : 0;
+}
+/**
+ * Build operations to revert a list-item block back to plain text.
+ *
+ * @param blockId - The block ID to revert
+ * @returns An array of operations that set the type to "text" and clear list attrs
+ */
+function revertToText(blockId) {
+    return [
+        { type: 'set_block_type', blockId, blockType: 'text' },
+        { type: 'set_block_attrs', blockId, attrs: { listStyle: null, depth: null } },
+    ];
+}
+/**
+ * Build operations to set a block to a list-item with a given style.
+ *
+ * @param blockId - The block ID to convert
+ * @param listStyle - The list style to apply
+ * @returns An array of operations that set the type and attrs
+ */
+function setListItem(blockId, listStyle) {
+    return [
+        { type: 'set_block_type', blockId, blockType: 'list-item' },
+        { type: 'set_block_attrs', blockId, attrs: { listStyle, depth: 0 } },
+    ];
+}
+/**
+ * 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 function listPlugin() {
+    return {
+        id: 'block-list-item',
+        init(ctx) {
+            // ---------------------------------------------------------------
+            // Block type registration
+            // ---------------------------------------------------------------
+            ctx.registerBlockType('list-item', {
+                defaultAttrs: { listStyle: 'bullet', depth: 0 },
+                validate: (attrs) => {
+                    return ((attrs.listStyle === 'bullet' || attrs.listStyle === 'ordered') &&
+                        typeof attrs.depth === 'number' &&
+                        attrs.depth >= 0);
+                },
+            });
+            // ---------------------------------------------------------------
+            // toggleBulletList command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(ListCommands.TOGGLE_BULLET, {
+                execute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    if (isListItem(block, 'bullet')) {
+                        engine.dispatch(revertToText(block.id));
+                    }
+                    else {
+                        engine.dispatch(setListItem(block.id, 'bullet'));
+                    }
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+                isActive(engine) {
+                    const block = getBlockAtCursor(engine);
+                    return isListItem(block, 'bullet');
+                },
+            });
+            // ---------------------------------------------------------------
+            // toggleOrderedList command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(ListCommands.TOGGLE_ORDERED, {
+                execute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    if (isListItem(block, 'ordered')) {
+                        engine.dispatch(revertToText(block.id));
+                    }
+                    else {
+                        engine.dispatch(setListItem(block.id, 'ordered'));
+                    }
+                },
+                canExecute(_engine) {
+                    return true;
+                },
+                isActive(engine) {
+                    const block = getBlockAtCursor(engine);
+                    return isListItem(block, 'ordered');
+                },
+            });
+            // ---------------------------------------------------------------
+            // indentList command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(ListCommands.INDENT, {
+                execute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    if (!isListItem(block))
+                        return;
+                    const currentDepth = getDepth(block);
+                    if (currentDepth >= MAX_DEPTH)
+                        return;
+                    engine.dispatch({
+                        type: 'set_block_attrs',
+                        blockId: block.id,
+                        attrs: { depth: currentDepth + 1 },
+                    });
+                },
+                canExecute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    return isListItem(block) && getDepth(block) < MAX_DEPTH;
+                },
+            });
+            // ---------------------------------------------------------------
+            // outdentList command
+            // ---------------------------------------------------------------
+            ctx.registerCommand(ListCommands.OUTDENT, {
+                execute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    if (!isListItem(block))
+                        return;
+                    const currentDepth = getDepth(block);
+                    if (currentDepth > 0) {
+                        engine.dispatch({
+                            type: 'set_block_attrs',
+                            blockId: block.id,
+                            attrs: { depth: currentDepth - 1 },
+                        });
+                    }
+                    else {
+                        // Depth is 0 -- revert to plain text
+                        engine.dispatch(revertToText(block.id));
+                    }
+                },
+                canExecute(engine) {
+                    const block = getBlockAtCursor(engine);
+                    return isListItem(block);
+                },
+            });
+            // ---------------------------------------------------------------
+            // Input rules: `- ` / `* ` -> bullet list, `1. ` -> ordered list
+            // ---------------------------------------------------------------
+            // Bullet list: `- ` or `* ` at block start
+            ctx.registerInputRule({
+                pattern: /^[-*] $/,
+                exclusive: true,
+                handler(engine, _match, blockId) {
+                    const blockStart = getBlockStartOffset(engine.state.doc, blockId);
+                    engine.dispatch([
+                        { type: 'delete_text', offset: blockStart, count: 2 },
+                        { type: 'set_block_type', blockId, blockType: 'list-item' },
+                        { type: 'set_block_attrs', blockId, attrs: { listStyle: 'bullet', depth: 0 } },
+                    ]);
+                },
+            });
+            // Ordered list: `1. ` at block start
+            ctx.registerInputRule({
+                pattern: /^1\. $/,
+                exclusive: true,
+                handler(engine, _match, blockId) {
+                    const blockStart = getBlockStartOffset(engine.state.doc, blockId);
+                    engine.dispatch([
+                        { type: 'delete_text', offset: blockStart, count: 3 },
+                        { type: 'set_block_type', blockId, blockType: 'list-item' },
+                        { type: 'set_block_attrs', blockId, attrs: { listStyle: 'ordered', depth: 0 } },
+                    ]);
+                },
+            });
+            // ---------------------------------------------------------------
+            // Keyboard shortcuts: Tab / Shift+Tab for indent/outdent
+            // ---------------------------------------------------------------
+            ctx.registerShortcut({ key: 'Tab' }, ListCommands.INDENT);
+            ctx.registerShortcut({ key: 'Tab', shift: true }, ListCommands.OUTDENT);
+        },
+        // ---------------------------------------------------------------
+        // beforeApply: Enter on empty list item → outdent or revert to text
+        // ---------------------------------------------------------------
+        beforeApply(ops, state) {
+            // Track block IDs from stripped split_block ops so we can filter
+            // orphan ops referencing those IDs.
+            const removedBlockIds = new Set();
+            const result = ops.flatMap((op) => {
+                if (op.type !== 'split_block')
+                    return [op];
+                // Resolve the split offset to find which block it targets
+                let blockIndex;
+                try {
+                    const resolved = resolve(state.doc, op.offset);
+                    blockIndex = resolved.blockIndex;
+                }
+                catch {
+                    return [op]; // Invalid offset — let core handle the error
+                }
+                const block = state.doc.blocks[blockIndex];
+                if (!block || !isListItem(block))
+                    return [op];
+                // Only intercept if the block has no text content
+                if (blockTextLength(block) !== 0)
+                    return [op];
+                // Track the removed block ID (from the split_block's newBlockId)
+                if (op.newBlockId) {
+                    removedBlockIds.add(op.newBlockId);
+                }
+                const depth = getDepth(block);
+                if (depth > 0) {
+                    // Outdent: decrease depth by 1
+                    return [
+                        {
+                            type: 'set_block_attrs',
+                            blockId: block.id,
+                            attrs: { depth: depth - 1 },
+                        },
+                    ];
+                }
+                else {
+                    // Depth 0: revert to plain text
+                    return revertToText(block.id);
+                }
+            });
+            // Filter out orphan ops referencing removed block IDs
+            if (removedBlockIds.size === 0)
+                return result;
+            return result.filter((op) => {
+                if ('blockId' in op && typeof op.blockId === 'string') {
+                    return !removedBlockIds.has(op.blockId);
+                }
+                return true;
+            });
+        },
+    };
+}
+//# sourceMappingURL=list-plugin.js.map

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

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

package/dist/plugins/mark-utils.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Shared utilities for inline mark plugins.
+ *
+ * Provides `createToggleMarkCommand()` for building mark toggle commands,
+ * `toggleMark()` for the toggle logic, and `isMarkActiveAtSelection()`
+ * for querying active mark state.
+ *
+ * @module
+ */
+import type { IEditorEngine, CommandDescriptor } from '@rtif-sdk/engine';
+import type { Document } from '@rtif-sdk/core';
+/**
+ * Create a `CommandDescriptor` for toggling a mark type on/off.
+ *
+ * When the cursor is collapsed, toggles a pending mark.
+ * When a selection exists, applies or removes the mark via `set_span_marks`.
+ *
+ * @param markType - The mark type string (e.g., "bold", "italic")
+ * @param markValue - The mark value to apply (default: `true`)
+ * @returns A `CommandDescriptor` with execute, canExecute, and isActive
+ *
+ * @example
+ * ```ts
+ * const boldCommand = createToggleMarkCommand('bold');
+ * registries.registerCommand('toggleMark:bold', boldCommand);
+ * ```
+ */
+export declare function createToggleMarkCommand(markType: string, markValue?: unknown): CommandDescriptor;
+/**
+ * Toggle a mark on the current selection or as a pending mark.
+ *
+ * If the cursor is collapsed, toggles the mark as a pending mark (the next
+ * typed text will have or not have the mark). If a range is selected,
+ * dispatches `set_span_marks` to apply or remove the mark.
+ *
+ * @param engine - The editor engine instance
+ * @param markType - The mark type string (e.g., "bold")
+ * @param markValue - The value to apply (default: `true`)
+ * @returns `true` if the toggle was performed
+ *
+ * @example
+ * ```ts
+ * toggleMark(engine, 'bold');
+ * ```
+ */
+export declare function toggleMark(engine: IEditorEngine, markType: string, markValue?: unknown): boolean;
+/**
+ * Check whether a mark type is active at the current selection.
+ *
+ * For collapsed cursors, checks the marks at the cursor offset and
+ * pending marks. For range selections, checks if the mark is present
+ * across the entire range (`common` marks).
+ *
+ * @param engine - The editor engine instance
+ * @param markType - The mark type to check (e.g., "bold")
+ * @returns `true` if the mark is active at the selection
+ *
+ * @example
+ * ```ts
+ * if (isMarkActiveAtSelection(engine, 'bold')) {
+ *   // Bold button should show as pressed
+ * }
+ * ```
+ */
+export declare function isMarkActiveAtSelection(engine: IEditorEngine, markType: string): boolean;
+/**
+ * Create a `CommandDescriptor` that sets a parameterized mark value.
+ *
+ * On a collapsed cursor, sets the mark as a pending mark so the next typed
+ * text inherits the value. On a range selection, dispatches `set_span_marks`
+ * to apply the mark to the selected text.
+ *
+ * @param markType - The mark type string (e.g., "color", "fontSize")
+ * @param extractValue - A function that extracts the mark value from the command payload
+ * @returns A `CommandDescriptor` with execute and isActive
+ *
+ * @example
+ * ```ts
+ * const cmd = createSetMarkCommand('color', (p) => (p as { color: string }).color);
+ * registries.registerCommand('setTextColor', cmd);
+ * ```
+ */
+export declare function createSetMarkCommand(markType: string, extractValue: (payload: unknown) => unknown): CommandDescriptor;
+/**
+ * Create a `CommandDescriptor` that removes a mark.
+ *
+ * On a collapsed cursor, sets the pending mark to `null` so the next typed
+ * text will not have the mark. On a range selection, dispatches `set_span_marks`
+ * with `null` to remove the mark from the selected text.
+ *
+ * @param markType - The mark type string (e.g., "color", "fontSize")
+ * @returns A `CommandDescriptor` with execute and canExecute
+ *
+ * @example
+ * ```ts
+ * const cmd = createRemoveMarkCommand('color');
+ * registries.registerCommand('removeTextColor', cmd);
+ * ```
+ */
+export declare function createRemoveMarkCommand(markType: string): CommandDescriptor;
+/**
+ * Find the absolute document range of a contiguous mark span containing
+ * the given offset.
+ *
+ * Scans the spans of the block containing the offset to find the contiguous
+ * range of spans that share the same mark key (with a non-null object value).
+ *
+ * @param doc - The document to search
+ * @param offset - The absolute offset to find the mark at
+ * @param markKey - The mark key to search for (e.g., 'link', 'mention')
+ * @returns The absolute offset and count of the mark range, or null if no mark at offset
+ *
+ * @example
+ * ```ts
+ * const range = findContiguousMarkRange(doc, 5, 'link');
+ * if (range) {
+ *   engine.dispatch({ type: 'set_span_marks', offset: range.offset, count: range.count, marks: { link: null } });
+ * }
+ * ```
+ */
+export declare function findContiguousMarkRange(doc: Document, offset: number, markKey: string): {
+    offset: number;
+    count: number;
+} | null;
+/**
+ * Adjust an offset that falls inside an atomic mark range to the nearest boundary.
+ *
+ * When arrow keys or clicks land the cursor inside a `contenteditable="false"`
+ * span (e.g., an @mention), this function snaps the offset to the start or end
+ * of the atomic range based on the movement direction.
+ *
+ * Iterates up to `MAX_ITERATIONS` to handle adjacent atomic marks (e.g., two
+ * mentions side by side) — each iteration snaps to a boundary, then re-checks
+ * whether the boundary itself is inside another atomic range.
+ *
+ * @param offset - The absolute document offset to adjust
+ * @param direction - Which direction to snap: 'forward' snaps to end, 'backward' snaps to start, 'nearest' picks closer boundary
+ * @param findAtomicRange - Function that returns the atomic mark range at an offset, or null
+ * @returns The adjusted offset (unchanged if not inside an atomic range)
+ *
+ * @example
+ * ```ts
+ * // Mention "@alice" spans offsets 5..10
+ * const find = (o: number) =>
+ *   o > 5 && o < 10 ? { offset: 5, count: 5 } : null;
+ * adjustOffsetAroundAtomicMarks(7, 'forward', find);  // => 10
+ * adjustOffsetAroundAtomicMarks(7, 'backward', find); // => 5
+ * ```
+ */
+export declare function adjustOffsetAroundAtomicMarks(offset: number, direction: 'forward' | 'backward' | 'nearest', findAtomicRange: (offset: number) => {
+    offset: number;
+    count: number;
+} | null): number;
+/**
+ * Adjust an absolute offset so it does not land inside an atomic block.
+ *
+ * When the cursor resolves to a block whose type is atomic (e.g., HR, image,
+ * embed), snap it to the nearest non-atomic block boundary based on the
+ * inferred movement direction.
+ *
+ * @param doc - The document
+ * @param offset - The absolute offset to adjust
+ * @param direction - Movement direction for choosing which boundary to snap to
+ * @param isAtomicBlock - Predicate that returns true for atomic block types
+ * @returns The adjusted offset, or the original if no adjustment needed
+ *
+ * @example
+ * ```ts
+ * const adjusted = adjustOffsetAroundAtomicBlocks(doc, 6, 'forward', (t) => t === 'hr');
+ * ```
+ */
+export declare function adjustOffsetAroundAtomicBlocks(doc: Document, offset: number, direction: 'forward' | 'backward' | 'nearest', isAtomicBlock: (blockType: string) => boolean): number;
+//# sourceMappingURL=mark-utils.d.ts.map

package/dist/plugins/mark-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-utils.d.ts","sourceRoot":"","sources":["../../src/plugins/mark-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AAG5D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,OAAc,GACxB,iBAAiB,CAYnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,OAAc,GACxB,OAAO,CAuBT;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAoBT;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GAC1C,iBAAiB,CA0BnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAyBnB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmB1C;AA0ED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,EAC7C,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC5E,MAAM,CA2BR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,EAC7C,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAC5C,MAAM,CAoDR"}