@rtif-sdk/web 1.0.0 → 1.1.0

package/dist/content-handlers.js

@@ -4,10 +4,11 @@
  * Provides handlers for:
  * - Plain text (`text/plain`) — splits on newlines, creates blocks
  * - RTIF JSON (`application/x-rtif+json`) — preserves marks and block attrs
- * - HTML (`text/html`) — stub, falls through to plain text handler
+ * - HTML (`text/html`) — deserializes via @rtif-sdk/format-html
  *
  * @module
  */
+import { deserialize as deserializeHtml } from '@rtif-sdk/format-html';
 // ---------------------------------------------------------------------------
 // Plain text handler
 // ---------------------------------------------------------------------------
@@ -68,6 +69,105 @@ export function createPlainTextHandler(generateBlockId) {
         },
     };
 }
+// ---------------------------------------------------------------------------
+// Shared helper for block-based paste handlers
+// ---------------------------------------------------------------------------
+/**
+ * Convert an array of RTIF blocks into operations and dispatch them.
+ *
+ * Generates a 4-phase operation sequence:
+ * 1. Insert text + split blocks
+ * 2. Apply span marks
+ * 3. Apply block attrs on new blocks
+ * 4. Apply block type on new blocks
+ *
+ * Used by both the RTIF JSON and HTML paste handlers.
+ *
+ * @param blocks - Source blocks to insert
+ * @param context - The content pipeline context
+ */
+function insertBlocksAsOps(blocks, context) {
+    let insertOffset = context.deleteSelectionAndGetOffset();
+    const ops = [];
+    // Track the offsets where each new block starts, for set_span_marks later
+    const blockInsertions = [];
+    // Phase 1: Insert text and create blocks
+    for (let bi = 0; bi < blocks.length; bi++) {
+        const block = blocks[bi];
+        const isFirst = bi === 0;
+        let newBlockId = null;
+        if (!isFirst) {
+            newBlockId = context.generateBlockId();
+            ops.push({
+                type: 'split_block',
+                offset: insertOffset,
+                newBlockId,
+            });
+            insertOffset += 1;
+        }
+        const blockStartOffset = insertOffset;
+        // Insert the full text of all spans in this block
+        const fullText = block.spans.map((s) => s.text).join('');
+        if (fullText.length > 0) {
+            ops.push({
+                type: 'insert_text',
+                offset: insertOffset,
+                text: fullText,
+            });
+            insertOffset += fullText.length;
+        }
+        blockInsertions.push({
+            blockStartOffset,
+            block,
+            isFirstBlock: isFirst,
+            newBlockId,
+        });
+    }
+    // Phase 2: Apply span marks for each block
+    for (const { blockStartOffset, block } of blockInsertions) {
+        let spanOffset = blockStartOffset;
+        for (const span of block.spans) {
+            if (span.marks && Object.keys(span.marks).length > 0) {
+                ops.push({
+                    type: 'set_span_marks',
+                    offset: spanOffset,
+                    count: span.text.length,
+                    marks: span.marks,
+                });
+            }
+            spanOffset += span.text.length;
+        }
+    }
+    // Phase 3: Apply block attrs (only on NEW blocks created by split, not the original)
+    for (const { block, isFirstBlock, newBlockId, } of blockInsertions) {
+        if (isFirstBlock)
+            continue; // Don't set attrs on the block the cursor was in
+        if (!block.attrs || Object.keys(block.attrs).length === 0)
+            continue;
+        if (newBlockId === null)
+            continue;
+        ops.push({
+            type: 'set_block_attrs',
+            blockId: newBlockId,
+            attrs: block.attrs,
+        });
+    }
+    // Phase 4: Apply block type on NEW blocks to match source document
+    for (const { block, isFirstBlock, newBlockId, } of blockInsertions) {
+        if (isFirstBlock)
+            continue; // Don't change the cursor's original block type
+        if (newBlockId === null)
+            continue;
+        ops.push({
+            type: 'set_block_type',
+            blockId: newBlockId,
+            blockType: block.type,
+        });
+    }
+    if (ops.length > 0) {
+        context.dispatch(ops);
+    }
+}
 /**
  * Create a content handler for RTIF JSON paste.
  *
@@ -77,16 +177,15 @@ export function createPlainTextHandler(generateBlockId) {
  *
  * Priority: -80 (highest built-in, runs before HTML and plain text).
  *
- * @param generateBlockId - Factory for generating unique block IDs
  * @returns A ContentHandler for RTIF JSON paste
  *
  * @example
  * ```ts
- * const handler = createRtifPasteHandler(() => crypto.randomUUID());
+ * const handler = createRtifPasteHandler();
  * pipeline.register(handler);
  * ```
  */
-export function createRtifPasteHandler(generateBlockId) {
+export function createRtifPasteHandler() {
     return {
         id: 'rtif:rtif-json',
         accept: ['application/x-rtif+json'],
@@ -99,86 +198,7 @@ export function createRtifPasteHandler(generateBlockId) {
             const payload = parseRtifPayload(jsonStr);
             if (payload === null)
                 return false;
-            let insertOffset = context.deleteSelectionAndGetOffset();
-            const ops = [];
-            // Track the offsets where each new block starts, for set_span_marks later
-            const blockInsertions = [];
-            // Phase 1: Insert text and create blocks
-            for (let bi = 0; bi < payload.blocks.length; bi++) {
-                const block = payload.blocks[bi];
-                const isFirst = bi === 0;
-                let newBlockId = null;
-                if (!isFirst) {
-                    newBlockId = generateBlockId();
-                    ops.push({
-                        type: 'split_block',
-                        offset: insertOffset,
-                        newBlockId,
-                    });
-                    insertOffset += 1;
-                }
-                const blockStartOffset = insertOffset;
-                // Insert the full text of all spans in this block
-                const fullText = block.spans.map((s) => s.text).join('');
-                if (fullText.length > 0) {
-                    ops.push({
-                        type: 'insert_text',
-                        offset: insertOffset,
-                        text: fullText,
-                    });
-                    insertOffset += fullText.length;
-                }
-                blockInsertions.push({
-                    blockStartOffset,
-                    block,
-                    isFirstBlock: isFirst,
-                    newBlockId,
-                });
-            }
-            // Phase 2: Apply span marks for each block
-            for (const { blockStartOffset, block } of blockInsertions) {
-                let spanOffset = blockStartOffset;
-                for (const span of block.spans) {
-                    if (span.marks && Object.keys(span.marks).length > 0) {
-                        ops.push({
-                            type: 'set_span_marks',
-                            offset: spanOffset,
-                            count: span.text.length,
-                            marks: span.marks,
-                        });
-                    }
-                    spanOffset += span.text.length;
-                }
-            }
-            // Phase 3: Apply block attrs (only on NEW blocks created by split, not the original)
-            for (const { block, isFirstBlock, newBlockId, } of blockInsertions) {
-                if (isFirstBlock)
-                    continue; // Don't set attrs on the block the cursor was in
-                if (!block.attrs || Object.keys(block.attrs).length === 0)
-                    continue;
-                if (newBlockId === null)
-                    continue;
-                ops.push({
-                    type: 'set_block_attrs',
-                    blockId: newBlockId,
-                    attrs: block.attrs,
-                });
-            }
-            // Phase 4: Apply block type on NEW blocks to match source document
-            for (const { block, isFirstBlock, newBlockId, } of blockInsertions) {
-                if (isFirstBlock)
-                    continue; // Don't change the cursor's original block type
-                if (newBlockId === null)
-                    continue;
-                ops.push({
-                    type: 'set_block_type',
-                    blockId: newBlockId,
-                    blockType: block.type,
-                });
-            }
-            if (ops.length > 0) {
-                context.dispatch(ops);
-            }
+            insertBlocksAsOps(payload.blocks, context);
             return true;
         },
     };
@@ -230,17 +250,17 @@ function parseRtifPayload(jsonStr) {
     }
 }
 // ---------------------------------------------------------------------------
-// HTML paste handler (stub)
+// HTML paste handler
 // ---------------------------------------------------------------------------
 /**
- * Create a stub content handler for HTML paste.
+ * Create a content handler for HTML paste.
  *
- * Currently always returns `false` (falls through to the plain text handler).
- * Will be implemented when the `@rtif-sdk/format-html` plugin is available.
+ * Accepts `text/html` content and deserializes it via `@rtif-sdk/format-html`,
+ * preserving formatting (bold, italic, links, headings, lists, code blocks, etc.).
  *
  * Priority: -90 (between RTIF JSON and plain text).
  *
- * @returns A ContentHandler stub for HTML paste
+ * @returns A ContentHandler for HTML paste
  *
  * @example
  * ```ts
@@ -253,10 +273,19 @@ export function createHtmlPasteHandler() {
         id: 'rtif:html',
         accept: ['text/html'],
         priority: -90,
-        async handle(_item, _context) {
-            // Stub — always declines. HTML deserialization will be implemented
-            // when @rtif-sdk/format-html is available.
-            return false;
+        async handle(item, context) {
+            const html = await item.getString();
+            if (html === null || html === '')
+                return false;
+            const doc = deserializeHtml(html);
+            // Check if deserialization produced only a single empty block
+            if (doc.blocks.length === 1 &&
+                doc.blocks[0].spans.length === 1 &&
+                doc.blocks[0].spans[0].text === '') {
+                return false;
+            }
+            insertBlocksAsOps(doc.blocks, context);
+            return true;
         },
     };
 }

package/dist/content-handlers.js.map

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

package/dist/editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8C7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CA4oBlE"}
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkD7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAguBlE"}

package/dist/editor.js

@@ -35,6 +35,9 @@ import { createCursorRectAPI } from './cursor-rect.js';
 import { createTriggerManager } from './trigger-manager.js';
 import { findContiguousMarkRange, adjustOffsetAroundAtomicMarks, adjustOffsetAroundAtomicBlocks } from './plugins/mark-utils.js';
 import { installWebPlugins } from './plugin-kit.js';
+import { createLinkPopover } from './link-popover.js';
+import { LinkCommands } from './plugins/link-plugin.js';
+import { createPerfInstrumentation } from './perf.js';
 // ---------------------------------------------------------------------------
 // Factory
 // ---------------------------------------------------------------------------
@@ -72,6 +75,14 @@ export function createWebEditor(config) {
     const autoFocus = config.autoFocus ?? false;
     let destroyed = false;
     // -------------------------------------------------------------------
+    // Performance instrumentation
+    // -------------------------------------------------------------------
+    const perfEnabled = config.perf != null && config.perf !== false;
+    const perfInstrumentation = perfEnabled ? createPerfInstrumentation() : null;
+    if (perfInstrumentation && typeof config.perf === 'object') {
+        perfInstrumentation.setObserver(config.perf);
+    }
+    // -------------------------------------------------------------------
     // Set up the contenteditable root
     // -------------------------------------------------------------------
     root.setAttribute('contenteditable', readOnly ? 'false' : 'true');
@@ -110,7 +121,9 @@ export function createWebEditor(config) {
     // -------------------------------------------------------------------
     // Initial render
     // -------------------------------------------------------------------
-    renderInitial(root, engine.state.doc, markRenderers, blockRenderers);
+    // Persistent blockId → DOM element Map for O(1) lookups in reconcile + selection sync
+    const blockElementMap = new Map();
+    renderInitial(root, engine.state.doc, markRenderers, blockRenderers, blockElementMap);
     // -------------------------------------------------------------------
     // Command bus
     // -------------------------------------------------------------------
@@ -188,7 +201,7 @@ export function createWebEditor(config) {
     const contentPipeline = createContentPipeline();
     // Register built-in handlers (priority: RTIF JSON -80, image -85, HTML -90,
     // URL -95, plain text -100, file drop -105)
-    contentPipeline.register(createRtifPasteHandler(() => generateId()));
+    contentPipeline.register(createRtifPasteHandler());
     contentPipeline.register(createImageContentHandler());
     contentPipeline.register(createHtmlPasteHandler());
     contentPipeline.register(createUrlContentHandler());
@@ -218,6 +231,7 @@ export function createWebEditor(config) {
         getDoc: () => engine.state.doc,
         dispatch: (ops) => engine.dispatch(ops),
         isReadOnly: () => readOnly,
+        getBlockElementMap: () => blockElementMap,
     });
     // -------------------------------------------------------------------
     // Paste handler (via content pipeline)
@@ -258,7 +272,7 @@ export function createWebEditor(config) {
             }
             else {
                 // Find nearest block for between-blocks indicator
-                const blockEl = findNearestBlock(root, e.clientY);
+                const blockEl = findNearestBlock(root, e.clientY, engine.state.doc, blockElementMap);
                 if (blockEl) {
                     const blockRect = blockEl.getBoundingClientRect();
                     const midY = blockRect.top + blockRect.height / 2;
@@ -310,7 +324,7 @@ export function createWebEditor(config) {
             // Programmatic selection change (Cmd+A, Cmd+Home/End):
             // update engine state AND sync to DOM.
             engine.setSelection(sel);
-            setDomSelection(root, engine.state.doc, sel);
+            setDomSelection(root, engine.state.doc, sel, blockElementMap);
         },
         isMac: () => isMac(),
     });
@@ -349,6 +363,11 @@ export function createWebEditor(config) {
             return;
         if (compositionHandler.isComposing())
             return;
+        // Early containment check: skip if selection is outside this editor
+        const domSel = document.getSelection();
+        if (!domSel || !domSel.focusNode || !root.contains(domSel.focusNode)) {
+            return;
+        }
         const cache = buildBlockOffsetCache(engine.state.doc);
         const sel = readDomSelection(root, cache);
         if (sel === null)
@@ -358,7 +377,7 @@ export function createWebEditor(config) {
         if (adjustedSel !== sel) {
             // Selection was adjusted — update engine AND re-sync DOM
             engine.setSelection(adjustedSel);
-            setDomSelection(root, engine.state.doc, adjustedSel);
+            setDomSelection(root, engine.state.doc, adjustedSel, blockElementMap);
             return;
         }
         // Adjust offsets that land inside atomic blocks (HR, image, embed)
@@ -378,7 +397,7 @@ export function createWebEditor(config) {
                 focus: { offset: adjFocus },
             };
             engine.setSelection(blockAdjustedSel);
-            setDomSelection(root, engine.state.doc, blockAdjustedSel);
+            setDomSelection(root, engine.state.doc, blockAdjustedSel, blockElementMap);
             return;
         }
         // Update engine selection without triggering a dispatch
@@ -423,19 +442,52 @@ export function createWebEditor(config) {
     // -------------------------------------------------------------------
     // Engine onChange — reconcile DOM and sync selection
     // -------------------------------------------------------------------
-    const unsubscribeOnChange = engine.onChange((state) => {
-        if (destroyed)
-            return;
+    // Batched reconciliation: when multiple onChange events fire in the same
+    // synchronous turn (e.g., from plugin afterApply → engine.dispatch), only
+    // the final state is reconciled. The first onChange in a synchronous turn
+    // is applied immediately; subsequent ones replace `pendingState` and a
+    // microtask flushes the final state.
+    let pendingState = null;
+    let isReconciling = false;
+    const doReconcile = (state) => {
+        perfInstrumentation?.markReconcileStart();
         const composingBlockId = compositionHandler.getComposingBlockId();
-        reconcile(root, prevDoc, state.doc, composingBlockId, markRenderers, blockRenderers);
+        reconcile(root, prevDoc, state.doc, composingBlockId, markRenderers, blockRenderers, blockElementMap);
         prevDoc = state.doc;
+        perfInstrumentation?.markReconcileEnd();
         // Sync selection to DOM (unless composing)
         if (!compositionHandler.isComposing()) {
-            setDomSelection(root, state.doc, state.selection);
+            perfInstrumentation?.markSelectionSyncStart();
+            setDomSelection(root, state.doc, state.selection, blockElementMap);
             scrollToCursor(root);
+            perfInstrumentation?.markSelectionSyncEnd();
         }
         // Update placeholder visibility
         updatePlaceholder(root, state.doc);
+        perfInstrumentation?.collect();
+    };
+    const unsubscribeOnChange = engine.onChange((state) => {
+        if (destroyed)
+            return;
+        if (isReconciling) {
+            // Nested dispatch during reconciliation — defer to microtask
+            pendingState = state;
+            queueMicrotask(() => {
+                if (destroyed || !pendingState)
+                    return;
+                const deferred = pendingState;
+                pendingState = null;
+                doReconcile(deferred);
+            });
+            return;
+        }
+        isReconciling = true;
+        try {
+            doReconcile(state);
+        }
+        finally {
+            isReconciling = false;
+        }
     });
     // -------------------------------------------------------------------
     // Exclusive mark boundary helper
@@ -537,9 +589,13 @@ export function createWebEditor(config) {
         root.focus();
     }
     // -------------------------------------------------------------------
+    // Auto-wire link popover
+    // -------------------------------------------------------------------
+    let linkPopoverHandle = null;
+    // -------------------------------------------------------------------
     // Return WebEditor handle
     // -------------------------------------------------------------------
-    return {
+    const webEditor = {
         engine,
         commandBus,
         content: contentPipeline,
@@ -547,6 +603,8 @@ export function createWebEditor(config) {
         blockRenderers,
         triggers: triggerManager,
         cursorRect,
+        get linkPopover() { return linkPopoverHandle; },
+        perf: perfInstrumentation,
         focus() {
             if (destroyed)
                 return;
@@ -555,7 +613,7 @@ export function createWebEditor(config) {
             // reset the contenteditable's selection when focus leaves and returns
             // (e.g., after interacting with a popover). The engine is the source
             // of truth, so always sync after focusing.
-            setDomSelection(root, engine.state.doc, engine.state.selection);
+            setDomSelection(root, engine.state.doc, engine.state.selection, blockElementMap);
         },
         blur() {
             if (destroyed)
@@ -571,6 +629,15 @@ export function createWebEditor(config) {
             if (destroyed)
                 return;
             destroyed = true;
+            // Clean up auto-wired link popover
+            if (linkPopoverHandle) {
+                linkPopoverHandle.dispose();
+                try {
+                    engine.exec(LinkCommands._UNWIRE_UI);
+                }
+                catch { /* engine may be destroyed */ }
+                linkPopoverHandle = null;
+            }
             // Detach event handlers
             shortcutHandler.detach();
             inputBridge.detach();
@@ -601,6 +668,10 @@ export function createWebEditor(config) {
             // Reset composition handler
             compositionHandler.reset();
             resetSuppression();
+            // Clear block element map
+            blockElementMap.clear();
+            // Destroy performance instrumentation
+            perfInstrumentation?.destroy();
             // Remove contenteditable attributes
             root.removeAttribute('contenteditable');
             root.removeAttribute('role');
@@ -613,6 +684,12 @@ export function createWebEditor(config) {
             root.style.whiteSpace = '';
         },
     };
+    // Auto-wire link popover when link plugin is registered and not disabled/readOnly
+    if (config.linkPopover !== false && !readOnly && engine.canExecute(LinkCommands._WIRE_UI)) {
+        linkPopoverHandle = createLinkPopover(webEditor, root);
+        engine.exec(LinkCommands._WIRE_UI, linkPopoverHandle.show);
+    }
+    return webEditor;
 }
 // ---------------------------------------------------------------------------
 // Helpers
@@ -689,7 +766,30 @@ function getOffsetFromDropPoint(root, doc, clientX, clientY) {
  * @param clientY - The Y coordinate to find the nearest block to
  * @returns The nearest block element, or null if no blocks found
  */
-function findNearestBlock(root, clientY) {
+function findNearestBlock(root, clientY, doc, blockElementMap) {
+    // Use persistent Map for O(1) element lookup (avoids querySelectorAll + n getBoundingClientRect)
+    if (doc && blockElementMap && blockElementMap.size > 0) {
+        let nearest = null;
+        let nearestDistance = Infinity;
+        for (const block of doc.blocks) {
+            const el = blockElementMap.get(block.id);
+            if (!el)
+                continue;
+            const rect = el.getBoundingClientRect();
+            const midY = rect.top + rect.height / 2;
+            const distance = Math.abs(clientY - midY);
+            if (distance < nearestDistance) {
+                nearestDistance = distance;
+                nearest = el;
+            }
+            else {
+                // Blocks are in document order; once distance starts increasing, we've found the nearest
+                break;
+            }
+        }
+        return nearest;
+    }
+    // Fallback: scan DOM children
     const blocks = root.querySelectorAll('[data-rtif-block]');
     if (blocks.length === 0)
         return null;
@@ -704,6 +804,9 @@ function findNearestBlock(root, clientY) {
             nearestDistance = distance;
             nearest = block;
         }
+        else {
+            break;
+        }
     }
     return nearest;
 }