@rtif-sdk/web 1.4.0 → 1.6.0

package/dist/block-gutter.js

@@ -0,0 +1,331 @@
+/**
+ * Block gutter toolbar — a Notion-style hover-revealed toolbar to the left
+ * of blocks with a "+" button (add block below) and a drag handle (reorder).
+ *
+ * The gutter owns hover detection and DOM elements. Drag-and-drop logic is
+ * delegated to {@link BlockDragHandler} in external handle mode.
+ *
+ * @module
+ */
+import { blockTextLength } from '@rtif-sdk/core';
+import { BlockDragHandler, findBlockElement } from './block-drag-handler.js';
+import { getBlockStartOffset } from './plugins/block-utils.js';
+// ---------------------------------------------------------------------------
+// CSS class names
+// ---------------------------------------------------------------------------
+const CSS_GUTTER = 'rtif-block-gutter';
+const CSS_ADD = 'rtif-gutter-add';
+const CSS_HANDLE = 'rtif-drag-handle';
+const CSS_HIDDEN = 'rtif-hidden';
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a block gutter toolbar.
+ *
+ * The gutter appears on hover or when the keyboard cursor enters a block.
+ * It provides a "+" button to add a new block below and a drag handle
+ * for block reordering.
+ *
+ * @param deps - Injected dependencies
+ * @returns A handle to attach/detach the gutter
+ *
+ * @example
+ * ```ts
+ * const gutter = createBlockGutter({
+ *   root: editorRoot,
+ *   engine,
+ *   isReadOnly: () => false,
+ *   getBlockElementMap: () => blockElementMap,
+ *   generateBlockId: () => generateId(),
+ *   focusAtOffset: (offset) => { ... },
+ * });
+ * gutter.attach();
+ * ```
+ */
+export function createBlockGutter(deps) {
+    let attached = false;
+    // Active block state
+    let activeBlockId = null;
+    let mouseIsActive = false;
+    let isDragging = false;
+    let hideTimeout = null;
+    let rafId = null;
+    // -------------------------------------------------------------------------
+    // DOM creation
+    // -------------------------------------------------------------------------
+    const gutterEl = document.createElement('div');
+    gutterEl.className = CSS_GUTTER;
+    gutterEl.setAttribute('role', 'toolbar');
+    gutterEl.setAttribute('aria-label', 'Block actions');
+    gutterEl.setAttribute('contenteditable', 'false');
+    gutterEl.classList.add(CSS_HIDDEN);
+    // + button
+    const addButton = document.createElement('button');
+    addButton.className = CSS_ADD;
+    addButton.type = 'button';
+    addButton.setAttribute('aria-label', 'Add block below');
+    addButton.textContent = '+';
+    // Drag handle
+    const dragHandle = document.createElement('div');
+    dragHandle.className = CSS_HANDLE;
+    dragHandle.setAttribute('draggable', 'true');
+    dragHandle.setAttribute('role', 'button');
+    dragHandle.setAttribute('tabindex', '-1');
+    dragHandle.setAttribute('aria-label', 'Drag to reorder');
+    dragHandle.textContent = '\u2807'; // BRAILLE PATTERN DOTS-123
+    gutterEl.appendChild(addButton);
+    gutterEl.appendChild(dragHandle);
+    // -------------------------------------------------------------------------
+    // BlockDragHandler in external handle mode
+    // -------------------------------------------------------------------------
+    const blockDragHandler = new BlockDragHandler({
+        root: deps.root,
+        getDoc: () => deps.engine.state.doc,
+        dispatch: (ops) => deps.engine.dispatch(ops),
+        isReadOnly: deps.isReadOnly,
+        getBlockElementMap: () => deps.getBlockElementMap(),
+        externalHandleMode: true,
+        getHandleEl: () => dragHandle,
+    });
+    // -------------------------------------------------------------------------
+    // Gutter positioning
+    // -------------------------------------------------------------------------
+    function showGutter(blockEl) {
+        if (deps.isReadOnly())
+            return;
+        if (isDragging)
+            return;
+        const blockId = blockEl.getAttribute('data-rtif-block');
+        if (!blockId)
+            return;
+        activeBlockId = blockId;
+        dragHandle.setAttribute('data-drag-block-id', blockId);
+        const rootRect = deps.root.getBoundingClientRect();
+        const blockRect = blockEl.getBoundingClientRect();
+        // Account for scroll offset: getBoundingClientRect is viewport-relative,
+        // but absolute positioning is relative to the offsetParent (root).
+        // When the root is scrolled, we need to add scrollTop to compensate.
+        gutterEl.style.top = `${blockRect.top - rootRect.top + deps.root.scrollTop}px`;
+        gutterEl.style.height = `${blockRect.height}px`;
+        gutterEl.classList.remove(CSS_HIDDEN);
+    }
+    function hideGutter() {
+        gutterEl.classList.add(CSS_HIDDEN);
+        activeBlockId = null;
+    }
+    function clearHideTimeout() {
+        if (hideTimeout !== null) {
+            clearTimeout(hideTimeout);
+            hideTimeout = null;
+        }
+    }
+    function scheduleHide() {
+        clearHideTimeout();
+        hideTimeout = setTimeout(() => {
+            hideTimeout = null;
+            hideGutter();
+            mouseIsActive = false;
+        }, 150);
+    }
+    // -------------------------------------------------------------------------
+    // Hover detection (event delegation on root)
+    // -------------------------------------------------------------------------
+    function onMouseOver(e) {
+        const blockEl = findBlockElement(e.target, deps.root);
+        if (blockEl) {
+            clearHideTimeout();
+            mouseIsActive = true;
+            showGutter(blockEl);
+        }
+    }
+    function onMouseOut(e) {
+        const relatedTarget = e.relatedTarget;
+        if (relatedTarget) {
+            // Moving to gutter → grace
+            if (gutterEl.contains(relatedTarget))
+                return;
+            // Moving to another block → will trigger mouseover
+            if (deps.root.contains(relatedTarget)) {
+                const blockEl = findBlockElement(relatedTarget, deps.root);
+                if (blockEl)
+                    return;
+            }
+        }
+        scheduleHide();
+    }
+    function onGutterMouseEnter() {
+        clearHideTimeout();
+    }
+    function onGutterMouseLeave(e) {
+        const relatedTarget = e.relatedTarget;
+        if (relatedTarget && deps.root.contains(relatedTarget)) {
+            const blockEl = findBlockElement(relatedTarget, deps.root);
+            if (blockEl)
+                return; // Moving back to a block
+        }
+        scheduleHide();
+    }
+    // -------------------------------------------------------------------------
+    // Drag state tracking — hide gutter during active drag
+    // -------------------------------------------------------------------------
+    function onDragStart() {
+        isDragging = true;
+        hideGutter();
+    }
+    function onDragEnd() {
+        isDragging = false;
+    }
+    // -------------------------------------------------------------------------
+    // Keyboard focus tracking (rAF-throttled)
+    // -------------------------------------------------------------------------
+    let prevFocusBlockId = null;
+    let unsubChange = null;
+    let unsubSelection = null;
+    function updateGutterForSelection() {
+        if (deps.isReadOnly())
+            return;
+        // Mouse hover takes priority
+        if (mouseIsActive)
+            return;
+        if (isDragging)
+            return;
+        const { selection, doc } = deps.engine.state;
+        const offset = selection.focus.offset;
+        try {
+            const block = deps.engine.getBlockAtOffset(offset);
+            if (block.id === prevFocusBlockId)
+                return;
+            prevFocusBlockId = block.id;
+            const blockEl = deps.getBlockElementMap().get(block.id);
+            if (!blockEl)
+                return; // Virtualized away
+            showGutter(blockEl);
+        }
+        catch {
+            // Offset out of range — hide
+            hideGutter();
+        }
+    }
+    function scheduleSelectionUpdate() {
+        if (rafId !== null)
+            return; // Already scheduled
+        rafId = requestAnimationFrame(() => {
+            rafId = null;
+            updateGutterForSelection();
+        });
+    }
+    // -------------------------------------------------------------------------
+    // + button handler
+    // -------------------------------------------------------------------------
+    function onAddMouseDown(e) {
+        e.preventDefault(); // Preserve editor focus
+    }
+    function onAddClick() {
+        if (deps.isReadOnly())
+            return;
+        if (!activeBlockId)
+            return;
+        const doc = deps.engine.state.doc;
+        const block = doc.blocks.find((b) => b.id === activeBlockId);
+        if (!block)
+            return;
+        const blockStart = getBlockStartOffset(doc, activeBlockId);
+        const blockLen = blockTextLength(block);
+        const splitOffset = blockStart + blockLen;
+        const newBlockId = deps.generateBlockId();
+        deps.engine.dispatch({
+            type: 'split_block',
+            offset: splitOffset,
+            newBlockId,
+        });
+        // Cursor at start of new block (splitOffset + 1 for virtual \n)
+        deps.focusAtOffset(splitOffset + 1);
+    }
+    // Drag handle also needs focus preservation
+    function onDragHandleMouseDown(e) {
+        e.preventDefault();
+    }
+    // -------------------------------------------------------------------------
+    // Blur handler
+    // -------------------------------------------------------------------------
+    function onBlur() {
+        clearHideTimeout();
+        hideGutter();
+        mouseIsActive = false;
+        prevFocusBlockId = null;
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    return {
+        attach() {
+            if (attached)
+                return;
+            attached = true;
+            // Append gutter to root
+            deps.root.appendChild(gutterEl);
+            // Hover listeners
+            deps.root.addEventListener('mouseover', onMouseOver);
+            deps.root.addEventListener('mouseout', onMouseOut);
+            gutterEl.addEventListener('mouseenter', onGutterMouseEnter);
+            gutterEl.addEventListener('mouseleave', onGutterMouseLeave);
+            // Button listeners
+            addButton.addEventListener('mousedown', onAddMouseDown);
+            addButton.addEventListener('click', onAddClick);
+            dragHandle.addEventListener('mousedown', onDragHandleMouseDown);
+            // Drag state listeners
+            deps.root.addEventListener('dragstart', onDragStart);
+            deps.root.addEventListener('dragend', onDragEnd);
+            // Blur
+            deps.root.addEventListener('blur', onBlur);
+            // Keyboard tracking (rAF-throttled)
+            unsubChange = deps.engine.onChange(() => scheduleSelectionUpdate());
+            unsubSelection = deps.engine.onSelectionChange(() => scheduleSelectionUpdate());
+            // Drag handler
+            blockDragHandler.attach();
+        },
+        detach() {
+            if (!attached)
+                return;
+            attached = false;
+            // Hover listeners
+            deps.root.removeEventListener('mouseover', onMouseOver);
+            deps.root.removeEventListener('mouseout', onMouseOut);
+            gutterEl.removeEventListener('mouseenter', onGutterMouseEnter);
+            gutterEl.removeEventListener('mouseleave', onGutterMouseLeave);
+            // Button listeners
+            addButton.removeEventListener('mousedown', onAddMouseDown);
+            addButton.removeEventListener('click', onAddClick);
+            dragHandle.removeEventListener('mousedown', onDragHandleMouseDown);
+            // Drag state listeners
+            deps.root.removeEventListener('dragstart', onDragStart);
+            deps.root.removeEventListener('dragend', onDragEnd);
+            // Blur
+            deps.root.removeEventListener('blur', onBlur);
+            // Keyboard tracking
+            unsubChange?.();
+            unsubSelection?.();
+            unsubChange = null;
+            unsubSelection = null;
+            // Cancel pending rAF
+            if (rafId !== null) {
+                cancelAnimationFrame(rafId);
+                rafId = null;
+            }
+            // Drag handler
+            blockDragHandler.detach();
+            // Remove DOM
+            if (gutterEl.parentNode) {
+                gutterEl.parentNode.removeChild(gutterEl);
+            }
+            // Clear state
+            clearHideTimeout();
+            activeBlockId = null;
+            mouseIsActive = false;
+            isDragging = false;
+            prevFocusBlockId = null;
+        },
+    };
+}
+//# sourceMappingURL=block-gutter.js.map

package/dist/block-gutter.js.map

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

package/dist/context-menu.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Context menu — right-click menu with Cut/Copy/Paste/Select All.
+ *
+ * Shows a positioned menu on `contextmenu` events with keyboard navigation,
+ * viewport clamping, and ARIA roles. Items are configurable via
+ * `ContextMenuConfig` on {@link WebEditorConfig}.
+ *
+ * @module
+ */
+import type { IEditorEngine } from '@rtif-sdk/engine';
+import type { WebEditor, ContextMenuItem, ContextMenuHandle } from './types.js';
+/**
+ * Get the default context menu items (Cut, Copy, Paste, Paste as Plain Text,
+ * separator, Select All).
+ *
+ * @returns An array of default context menu items
+ *
+ * @example
+ * ```ts
+ * const items = getDefaultItems();
+ * ```
+ */
+export declare function getDefaultItems(): ContextMenuItem[];
+/**
+ * Dependencies for creating a context menu. Internal — not exported as a
+ * public type. The `createWebEditor` factory wires these from its own scope.
+ */
+interface ContextMenuDeps {
+    readonly editor: WebEditor;
+    readonly root: HTMLElement;
+    readonly engine: IEditorEngine;
+    readonly isReadOnly: () => boolean;
+    readonly items?: ReadonlyArray<ContextMenuItem>;
+    readonly additionalItems?: ReadonlyArray<ContextMenuItem>;
+}
+/**
+ * Create a context menu attached to the editor root.
+ *
+ * Intercepts the `contextmenu` event, builds the menu DOM, and manages
+ * keyboard navigation plus outside-click dismissal.
+ *
+ * @param deps - Dependencies injected by the editor factory
+ * @returns A {@link ContextMenuHandle} for programmatic control and cleanup
+ *
+ * @example
+ * ```ts
+ * const handle = createContextMenu({ editor, root, engine, isReadOnly: () => false });
+ * // later:
+ * handle.dispose();
+ * ```
+ */
+export declare function createContextMenu(deps: ContextMenuDeps): ContextMenuHandle;
+export {};
+//# sourceMappingURL=context-menu.d.ts.map

package/dist/context-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.d.ts","sourceRoot":"","sources":["../src/context-menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EAGf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,eAAe,EAAE,CA6DnD;AA0GD;;;GAGG;AACH,UAAU,eAAe;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAC3D;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAyS1E"}