@doxi/core 0.11.0

package/dist/view/reconcile.js

@@ -0,0 +1,158 @@
+import { renderSpec as renderSpecImport, HOLE_MARKER_ATTR as HOLE_MARKER_ATTR_IMPORT } from './dom-spec.js';
+import { renderNode } from './renderer.js';
+/**
+ * Reconcile the DOM children of `domRoot` so they represent `newDoc`'s content,
+ * starting from a DOM that already represents `oldDoc`'s content.
+ *
+ * Algorithm (v0.1):
+ *   - If oldDoc === newDoc (reference equality, which happens whenever the
+ *     immutable model wasn't touched): no-op.
+ *   - Otherwise walk children in parallel; if a child differs, replace it
+ *     wholesale (re-render the differing subtree). More sophisticated diffing
+ *     (Levenshtein on child arrays, in-place updates for same-type nodes)
+ *     lands in Phase 7 polish.
+ */
+export function reconcile(domRoot, oldDoc, newDoc, renderer) {
+    if (oldDoc === newDoc)
+        return;
+    reconcileChildren(domRoot, oldDoc, newDoc, renderer, 0);
+}
+function reconcileChildren(parentEl, oldParent, newParent, renderer, baseAbsPos) {
+    const oldChildren = oldParent.content.children;
+    const newChildren = newParent.content.children;
+    const max = Math.max(oldChildren.length, newChildren.length);
+    let modelOffset = baseAbsPos + 1; // +1 to step past the parent's [open] token
+    for (let i = 0; i < max; i++) {
+        const oldChild = oldChildren[i];
+        const newChild = newChildren[i];
+        const domChild = parentEl.childNodes[i];
+        if (!newChild) {
+            // Trailing children removed
+            if (domChild)
+                parentEl.removeChild(domChild);
+            continue;
+        }
+        if (!oldChild) {
+            // New child appended
+            const fresh = renderNode(document, renderer, newChild, modelOffset);
+            parentEl.appendChild(fresh);
+            modelOffset += newChild.nodeSize;
+            continue;
+        }
+        if (oldChild === newChild) {
+            modelOffset += newChild.nodeSize;
+            continue;
+        }
+        if (sameShape(oldChild, newChild) && !newChild.isText && !newChild.isAtom && domChild) {
+            // Same node type + attrs — descend.
+            reconcileChildren(domChild, oldChild, newChild, renderer, modelOffset);
+        }
+        else if (oldChild.isText &&
+            newChild.isText &&
+            oldChild.type === newChild.type &&
+            sameMarkArrays(oldChild.marks, newChild.marks) &&
+            domChild) {
+            // Text leaf with same marks but different text — update .data in place.
+            updateTextLeaf(domChild, newChild.text);
+        }
+        else if (oldChild.isText &&
+            newChild.isText &&
+            oldChild.type === newChild.type &&
+            oldChild.text === newChild.text &&
+            domChild) {
+            // Same text, different marks — rewrap in place, preserving the Text node.
+            const innerText = findInnerTextNode(domChild);
+            if (innerText) {
+                // Record insertion point BEFORE wrapWithMarks detaches innerText
+                // (which may BE domChild itself when the leaf had no marks).
+                const next = domChild.nextSibling;
+                if (domChild.parentNode === parentEl)
+                    parentEl.removeChild(domChild);
+                const wrapped = wrapWithMarks(innerText, newChild.marks, renderer);
+                if (next)
+                    parentEl.insertBefore(wrapped, next);
+                else
+                    parentEl.appendChild(wrapped);
+            }
+        }
+        else {
+            // Different shape, or atom — replace.
+            const fresh = renderNode(document, renderer, newChild, modelOffset);
+            if (domChild)
+                parentEl.replaceChild(fresh, domChild);
+            else
+                parentEl.appendChild(fresh);
+        }
+        modelOffset += newChild.nodeSize;
+    }
+}
+function sameShape(a, b) {
+    if (a.type !== b.type)
+        return false;
+    const ak = Object.keys(a.attrs), bk = Object.keys(b.attrs);
+    if (ak.length !== bk.length)
+        return false;
+    for (const k of ak) {
+        if (!(k in b.attrs))
+            return false;
+        if (!Object.is(a.attrs[k], b.attrs[k]))
+            return false;
+    }
+    return true;
+}
+function sameMarkArrays(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (!a[i].eq(b[i]))
+            return false;
+    }
+    return true;
+}
+function updateTextLeaf(domNode, newText) {
+    // The rendered text leaf is either a Text node (when no marks) or an Element
+    // wrapping a Text node (one or more marks). Walk down to the innermost text.
+    let cur = domNode;
+    while (cur.nodeType !== 3 /* TEXT_NODE */) {
+        if (cur.firstChild)
+            cur = cur.firstChild;
+        else
+            break;
+    }
+    if (cur.nodeType === 3) {
+        ;
+        cur.data = newText;
+    }
+}
+function findInnerTextNode(domNode) {
+    let cur = domNode;
+    while (cur.nodeType !== 3 /* TEXT_NODE */) {
+        if (cur.firstChild)
+            cur = cur.firstChild;
+        else
+            return null;
+    }
+    return cur;
+}
+function wrapWithMarks(textNode, marks, renderer) {
+    // Detach from any current parent.
+    textNode.parentNode?.removeChild(textNode);
+    let outer = textNode;
+    for (let i = marks.length - 1; i >= 0; i--) {
+        const mark = marks[i];
+        const markFn = renderer.getMarkRenderer(mark.type.name);
+        if (!markFn)
+            continue;
+        const wrapped = renderSpecImport(textNode.ownerDocument, markFn(mark));
+        const hole = wrapped.hasAttribute(HOLE_MARKER_ATTR_IMPORT)
+            ? wrapped
+            : wrapped.querySelector(`[${HOLE_MARKER_ATTR_IMPORT}]`);
+        if (hole)
+            hole.appendChild(outer);
+        else
+            wrapped.appendChild(outer);
+        outer = wrapped;
+    }
+    return outer;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/view/reconcile.js.map

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

package/dist/view/renderer.d.ts

@@ -0,0 +1,31 @@
+import type { Mark } from '../model/mark.js';
+import type { DxNode } from '../model/node.js';
+import { type DOMSpec } from './dom-spec.js';
+export type NodeRenderFn = (node: DxNode) => DOMSpec;
+export type MarkRenderFn = (mark: Mark) => DOMSpec;
+export interface RendererSpec {
+    readonly nodes: Readonly<Record<string, NodeRenderFn>>;
+    readonly marks: Readonly<Record<string, MarkRenderFn>>;
+}
+export declare class Renderer {
+    readonly spec: RendererSpec;
+    constructor(spec: RendererSpec);
+    getNodeRenderer(name: string): NodeRenderFn;
+    getMarkRenderer(name: string): MarkRenderFn | undefined;
+}
+export interface NodeRef {
+    readonly node: DxNode;
+    /** Absolute document position of this node's [open] boundary (or -1 for root). */
+    readonly pos: number;
+}
+export declare function getNodeRef(el: Node): NodeRef | undefined;
+/**
+ * Render a model node into a DOM subtree, recursively populating the content
+ * hole at each level. Attaches __dxNode/__pos back-pointers (via getNodeRef)
+ * for selection translation.
+ *
+ * `absPos` is the absolute document position of this node (where its [open]
+ * token sits). For the root doc, callers pass -1.
+ */
+export declare function renderNode(doc: Document, renderer: Renderer, node: DxNode, absPos?: number): Node;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/view/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/view/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAE1E,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;CACvD;AAED,qBAAa,QAAQ;IACP,QAAQ,CAAC,IAAI,EAAE,YAAY;gBAAlB,IAAI,EAAE,YAAY;IAEvC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAM3C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAGxD;AAID,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAExD;AAMD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,IAAI,CA6C7F"}

package/dist/view/renderer.js

@@ -0,0 +1,89 @@
+import { renderSpec, HOLE_MARKER_ATTR } from './dom-spec.js';
+export class Renderer {
+    spec;
+    constructor(spec) {
+        this.spec = spec;
+    }
+    getNodeRenderer(name) {
+        const fn = this.spec.nodes[name];
+        if (!fn)
+            throw new Error(`Renderer: no renderer for node type '${name}'`);
+        return fn;
+    }
+    getMarkRenderer(name) {
+        return this.spec.marks[name];
+    }
+}
+const NODE_REF = Symbol.for('@doxi/core.view.nodeRef');
+export function getNodeRef(el) {
+    return el[NODE_REF];
+}
+function setNodeRef(el, ref) {
+    ;
+    el[NODE_REF] = ref;
+}
+/**
+ * Render a model node into a DOM subtree, recursively populating the content
+ * hole at each level. Attaches __dxNode/__pos back-pointers (via getNodeRef)
+ * for selection translation.
+ *
+ * `absPos` is the absolute document position of this node (where its [open]
+ * token sits). For the root doc, callers pass -1.
+ */
+export function renderNode(doc, renderer, node, absPos = -1) {
+    if (node.isText) {
+        const text = node.text;
+        let outer = doc.createTextNode(text);
+        for (let i = node.marks.length - 1; i >= 0; i--) {
+            const mark = node.marks[i];
+            const markFn = renderer.getMarkRenderer(mark.type.name);
+            if (!markFn)
+                continue;
+            const wrapped = renderSpec(doc, markFn(mark));
+            const hole = findHole(wrapped);
+            if (hole)
+                hole.appendChild(outer);
+            else
+                wrapped.appendChild(outer);
+            outer = wrapped;
+        }
+        setNodeRef(outer, { node, pos: absPos });
+        return outer;
+    }
+    const nodeFn = renderer.getNodeRenderer(node.type.name);
+    const root = renderSpec(doc, nodeFn(node));
+    setNodeRef(root, { node, pos: absPos });
+    if (!node.isAtom) {
+        const hole = findHole(root) ?? root;
+        let childPos = absPos + 1; // +1 to step past this node's [open] token
+        for (let i = 0; i < node.content.childCount; i++) {
+            const child = node.content.child(i);
+            hole.appendChild(renderNode(doc, renderer, child, childPos));
+            childPos += child.nodeSize;
+        }
+        hole.removeAttribute(HOLE_MARKER_ATTR);
+        // Empty inline-content blocks (paragraph/heading/etc.) need a placeholder
+        // so the line has visible height and contenteditable can place a caret
+        // inside it. The doc node itself is exempt.
+        if (node.content.childCount === 0 &&
+            node.type.name !== 'doc' &&
+            acceptsInlineContent(node)) {
+            const br = doc.createElement('br');
+            br.setAttribute('data-dx-placeholder', 'true');
+            hole.appendChild(br);
+        }
+    }
+    return root;
+}
+function acceptsInlineContent(node) {
+    const content = node.type.spec.content;
+    if (!content)
+        return false;
+    return content.includes('inline');
+}
+function findHole(el) {
+    if (el.hasAttribute(HOLE_MARKER_ATTR))
+        return el;
+    return el.querySelector(`[${HOLE_MARKER_ATTR}]`);
+}
+//# sourceMappingURL=renderer.js.map

package/dist/view/renderer.js.map

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

package/dist/view/selection-sync.d.ts

@@ -0,0 +1,35 @@
+import type { DxNode } from '../model/node.js';
+import type { Selection } from '../state/selection.js';
+/**
+ * Move the host window's selection to mirror `sel`. Walks the rendered DOM
+ * subtree under `root`, finds the text node and offset corresponding to
+ * sel.anchor/head, and calls Selection.setBaseAndExtent.
+ *
+ * Positions on a block boundary (depth 0 of the model) snap to the nearest
+ * inline text node.
+ *
+ * For a CellSelection, paints `dx-cell-selected` on every cell in the
+ * rectangle and clears the native DOM selection (no caret) instead.
+ */
+export declare function renderSelection(root: Element, sel: Selection, doc: DxNode): void;
+export interface DomLoc {
+    readonly node: Node;
+    readonly offset: number;
+}
+/**
+ * Find the DOM text node + offset that corresponds to model position `pos`.
+ * Strategy: walk the DOM in document order. Each text node carries a
+ * NodeRef (set by renderer.ts) pointing back at the model node and the
+ * model position of its [open] boundary. We match by model position.
+ *
+ * Exported as `locateDomFromModelPos` for collab presence overlays — see
+ * `@doxi/collab` `installRemoteCursors`.
+ */
+export declare function locateDomFromModelPos(root: Element, pos: number, doc: DxNode): DomLoc | null;
+import { TextSelection } from '../state/text-selection.js';
+/**
+ * Translate the host window's current selection into a model TextSelection.
+ * Returns null when the selection is not inside `root` (or there is none).
+ */
+export declare function resolveDOMSelection(root: Element, _doc: DxNode): TextSelection | null;
+//# sourceMappingURL=selection-sync.d.ts.map

package/dist/view/selection-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-sync.d.ts","sourceRoot":"","sources":["../../src/view/selection-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAMtD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAyBhF;AA4FD,MAAM,WAAW,MAAM;IAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAExE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5F;AAsED,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE1D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAmCrF"}

package/dist/view/selection-sync.js

@@ -0,0 +1,324 @@
+import { tableGrid } from '../model/table-grid.js';
+import { CellSelection } from '../state/cell-selection.js';
+import { NodeSelection } from '../state/node-selection.js';
+import { getNodeRef } from './renderer.js';
+const CELL_SELECTED_CLASS = 'dx-cell-selected';
+const IMAGE_SELECTED_CLASS = 'dx-image-selected';
+/**
+ * Move the host window's selection to mirror `sel`. Walks the rendered DOM
+ * subtree under `root`, finds the text node and offset corresponding to
+ * sel.anchor/head, and calls Selection.setBaseAndExtent.
+ *
+ * Positions on a block boundary (depth 0 of the model) snap to the nearest
+ * inline text node.
+ *
+ * For a CellSelection, paints `dx-cell-selected` on every cell in the
+ * rectangle and clears the native DOM selection (no caret) instead.
+ */
+export function renderSelection(root, sel, doc) {
+    const win = root.ownerDocument.defaultView;
+    if (!win)
+        return;
+    if (sel instanceof CellSelection) {
+        paintCellSelection(root, sel, doc);
+        clearImageSelectionPainting(root);
+        win.getSelection()?.removeAllRanges();
+        return;
+    }
+    if (sel instanceof NodeSelection) {
+        // Only image NodeSelections get painted today; other node selections
+        // (hr, etc.) fall back to clearing the image highlight without painting.
+        paintImageSelection(root, sel);
+        clearCellSelectionPainting(root);
+        win.getSelection()?.removeAllRanges();
+        return;
+    }
+    clearCellSelectionPainting(root);
+    clearImageSelectionPainting(root);
+    const anchor = locate(root, sel.anchor, doc);
+    const head = locate(root, sel.head, doc);
+    if (!anchor || !head)
+        return;
+    const sel2 = win.getSelection();
+    if (!sel2)
+        return;
+    sel2.setBaseAndExtent(anchor.node, anchor.offset, head.node, head.offset);
+}
+/**
+ * Paint `dx-cell-selected` on every cell inside the bounding rectangle of
+ * the CellSelection, and remove the class from every other cell under `root`.
+ *
+ * Strategy: locate the anchor and head cell DOM elements via the NodeRef
+ * back-pointers attached by the renderer, walk up to their shared `<table>`,
+ * find the master positions in `tableGrid`, and call `cellPositionsInRect`
+ * over the bounding rectangle. Match those positions against the cell DOM
+ * elements inside the table.
+ */
+function paintCellSelection(root, sel, doc) {
+    // Find every cell DOM under the root once.
+    const allCells = Array.from(root.querySelectorAll('.dx-table-cell'));
+    const anchorEl = allCells.find((el) => getNodeRef(el)?.pos === sel.anchorCell) ?? null;
+    const headEl = allCells.find((el) => getNodeRef(el)?.pos === sel.headCell) ?? null;
+    if (!anchorEl || !headEl) {
+        // Couldn't locate the cells — clear stale highlighting and bail.
+        clearCellSelectionPainting(root);
+        return;
+    }
+    const anchorTable = anchorEl.closest('table.dx-table');
+    const headTable = headEl.closest('table.dx-table');
+    if (!anchorTable || anchorTable !== headTable) {
+        clearCellSelectionPainting(root);
+        return;
+    }
+    const tableRef = getNodeRef(anchorTable);
+    if (!tableRef || tableRef.pos < 0) {
+        clearCellSelectionPainting(root);
+        return;
+    }
+    const grid = tableGrid(tableRef.node, tableRef.pos);
+    const anchorCell = grid.byPos(sel.anchorCell);
+    const headCell = grid.byPos(sel.headCell);
+    if (!anchorCell || !headCell) {
+        clearCellSelectionPainting(root);
+        return;
+    }
+    const r0 = Math.min(anchorCell.row, headCell.row);
+    const r1 = Math.max(anchorCell.row + anchorCell.rowspan - 1, headCell.row + headCell.rowspan - 1);
+    const c0 = Math.min(anchorCell.col, headCell.col);
+    const c1 = Math.max(anchorCell.col + anchorCell.colspan - 1, headCell.col + headCell.colspan - 1);
+    const selectedPositions = new Set(grid.cellPositionsInRect(r0, r1, c0, c1));
+    // Clear painting on cells outside the table; mark inside the table.
+    for (const el of allCells) {
+        const pos = getNodeRef(el)?.pos;
+        if (pos !== undefined && selectedPositions.has(pos) && el.closest('table.dx-table') === anchorTable) {
+            el.classList.add(CELL_SELECTED_CLASS);
+        }
+        else {
+            el.classList.remove(CELL_SELECTED_CLASS);
+        }
+    }
+    // Reference doc to keep the signature stable for callers that pass it.
+    void doc;
+}
+function clearCellSelectionPainting(root) {
+    const painted = root.querySelectorAll(`.${CELL_SELECTED_CLASS}`);
+    for (let i = 0; i < painted.length; i++) {
+        painted.item(i).classList.remove(CELL_SELECTED_CLASS);
+    }
+}
+/**
+ * Paint `dx-image-selected` on the `.dx-image` whose NodeRef.pos matches
+ * `sel.anchor`, and remove it from every other image under `root`. Used by
+ * NodeSelection to give the user a visible affordance for the selected image.
+ *
+ * If no matching image is found (e.g., the NodeSelection targets a non-image
+ * atomic node), this still clears stale highlights and bails — the model
+ * selection remains valid even without DOM affordance.
+ */
+function paintImageSelection(root, sel) {
+    const allImages = Array.from(root.querySelectorAll('.dx-image'));
+    for (const el of allImages) {
+        if (getNodeRef(el)?.pos === sel.anchor) {
+            el.classList.add(IMAGE_SELECTED_CLASS);
+        }
+        else {
+            el.classList.remove(IMAGE_SELECTED_CLASS);
+        }
+    }
+}
+function clearImageSelectionPainting(root) {
+    const painted = root.querySelectorAll(`.${IMAGE_SELECTED_CLASS}`);
+    for (let i = 0; i < painted.length; i++) {
+        painted.item(i).classList.remove(IMAGE_SELECTED_CLASS);
+    }
+}
+/**
+ * Find the DOM text node + offset that corresponds to model position `pos`.
+ * Strategy: walk the DOM in document order. Each text node carries a
+ * NodeRef (set by renderer.ts) pointing back at the model node and the
+ * model position of its [open] boundary. We match by model position.
+ *
+ * Exported as `locateDomFromModelPos` for collab presence overlays — see
+ * `@doxi/collab` `installRemoteCursors`.
+ */
+export function locateDomFromModelPos(root, pos, doc) {
+    return locate(root, pos, doc);
+}
+function locate(root, pos, _doc) {
+    for (const textNode of collectTextNodes(root)) {
+        const ref = findRefForText(textNode);
+        if (!ref)
+            continue;
+        const start = ref.pos;
+        const end = start + textNode.data.length;
+        if (pos >= start && pos <= end) {
+            return { node: textNode, offset: pos - start };
+        }
+    }
+    // Fallback for positions inside empty blocks (e.g., the tail block produced
+    // by splitBlock when the cursor was at the end of a line). Walk elements
+    // with NodeRefs and pick the deepest one whose inside-range contains pos.
+    let best = null;
+    let bestStart = -1;
+    const walk = (el) => {
+        const ref = getNodeRef(el);
+        if (ref) {
+            const start = ref.pos;
+            const end = start + ref.node.nodeSize;
+            const insideStart = start + 1;
+            const insideEnd = end - 1;
+            if (pos >= insideStart && pos <= insideEnd && start > bestStart) {
+                best = el;
+                bestStart = start;
+            }
+        }
+        for (let i = 0; i < el.children.length; i++) {
+            const child = el.children[i];
+            if (child)
+                walk(child);
+        }
+    };
+    walk(root);
+    if (best) {
+        return { node: best, offset: 0 };
+    }
+    if (root.lastChild)
+        return { node: root.lastChild, offset: 0 };
+    return { node: root, offset: 0 };
+}
+function collectTextNodes(root) {
+    const out = [];
+    const recur = (n) => {
+        if (n.nodeType === 3 /* TEXT_NODE */) {
+            out.push(n);
+            return;
+        }
+        for (let i = 0; i < n.childNodes.length; i++) {
+            const c = n.childNodes[i];
+            if (c)
+                recur(c);
+        }
+    };
+    recur(root);
+    return out;
+}
+function findRefForText(textNode) {
+    // The renderer attached NodeRef to the OUTER text element (the unwrapped Text
+    // node OR the outermost mark span). Walk up the DOM until we find one.
+    let cur = textNode;
+    while (cur) {
+        const ref = getNodeRef(cur);
+        if (ref)
+            return ref;
+        cur = cur.parentNode;
+    }
+    return undefined;
+}
+import { TextSelection } from '../state/text-selection.js';
+/**
+ * Translate the host window's current selection into a model TextSelection.
+ * Returns null when the selection is not inside `root` (or there is none).
+ */
+export function resolveDOMSelection(root, _doc) {
+    const win = root.ownerDocument.defaultView;
+    if (!win)
+        return null;
+    const domSel = win.getSelection();
+    if (!domSel || domSel.rangeCount === 0)
+        return null;
+    // Prefer anchor/focus so reverse selections (head < anchor when the user
+    // drags right-to-left or shift-arrows backward) are preserved in the
+    // model. Fall back to the range's start/end when anchor/focus aren't
+    // usable (e.g., happy-dom doesn't expose focusOffset reliably for
+    // selections set via setBaseAndExtent).
+    const range = domSel.getRangeAt(0);
+    let aNode = domSel.anchorNode;
+    let aOff = domSel.anchorOffset;
+    let fNode = domSel.focusNode;
+    let fOff = domSel.focusOffset;
+    const haveAnchorFocus = aNode != null && fNode != null && root.contains(aNode) && root.contains(fNode);
+    // happy-dom only updates anchor when a selection is created via addRange or
+    // setBaseAndExtent; focus stays equal to anchor. Detect that as "AF is
+    // collapsed but the range isn't" and fall back to range start/end (loses
+    // direction information, but is at least correct).
+    const afAppearsCollapsed = aNode === fNode && aOff === fOff;
+    const rangeNotCollapsed = !range.collapsed;
+    if (!haveAnchorFocus || (afAppearsCollapsed && rangeNotCollapsed)) {
+        aNode = range.startContainer;
+        aOff = range.startOffset;
+        fNode = range.endContainer;
+        fOff = range.endOffset;
+    }
+    if (!aNode || !fNode)
+        return null;
+    if (!root.contains(aNode) || !root.contains(fNode))
+        return null;
+    const anchor = domOffsetToModelPos(aNode, aOff);
+    const head = domOffsetToModelPos(fNode, fOff);
+    if (anchor === null || head === null)
+        return null;
+    return new TextSelection(anchor, head);
+}
+function domOffsetToModelPos(node, offset) {
+    if (node.nodeType === 3 /* TEXT_NODE */) {
+        const ref = findAncestorRef(node);
+        if (!ref)
+            return null;
+        return ref.pos + offset;
+    }
+    // Element selection. The browser uses element + child-offset when no text
+    // node is at the precise click point (e.g., user clicked past the end of a
+    // line, or the caret sits inside an empty block whose only DOM child is a
+    // <br> placeholder).
+    const childAt = node.childNodes[offset];
+    if (childAt) {
+        const tDesc = lastTextDescendant(childAt);
+        if (tDesc) {
+            const ref = findAncestorRef(tDesc);
+            if (ref)
+                return ref.pos;
+        }
+    }
+    const childBefore = node.childNodes[offset - 1];
+    if (childBefore) {
+        const last = lastTextDescendant(childBefore);
+        if (last) {
+            const ref = findAncestorRef(last);
+            if (ref)
+                return ref.pos + last.data.length;
+        }
+    }
+    // Fall back to the nearest ancestor ref. For text refs, `pos` is already
+    // the start of text content. For container refs (e.g., an empty <p>),
+    // `pos` is the container's [open] token — a depth-0 boundary that the
+    // selectionchange guard rejects. Nudge to the first inside position so the
+    // caret is on an editable spot inside the container.
+    const ref = findAncestorRef(node);
+    if (!ref)
+        return null;
+    return ref.node.isText ? ref.pos : ref.pos + 1;
+}
+function lastTextDescendant(node) {
+    if (node.nodeType === 3)
+        return node;
+    for (let i = node.childNodes.length - 1; i >= 0; i--) {
+        const c = node.childNodes[i];
+        if (!c)
+            continue;
+        const t = lastTextDescendant(c);
+        if (t)
+            return t;
+    }
+    return null;
+}
+function findAncestorRef(node) {
+    let cur = node;
+    while (cur) {
+        const ref = getNodeRef(cur);
+        if (ref)
+            return ref;
+        cur = cur.parentNode;
+    }
+    return undefined;
+}
+//# sourceMappingURL=selection-sync.js.map