@llui/lexical-loro 0.1.0

package/dist/agent-write.js

@@ -0,0 +1,499 @@
+/**
+ * Agent-write: reconcile an AGENT-AUTHORED full-document rewrite into an existing
+ * Loro document without tearing down history.
+ *
+ * ── The problem ────────────────────────────────────────────────────────────
+ *
+ * An LLM rewrites a note's WHOLE markdown. The naive route — reparse the new
+ * markdown into the live bound editor (`root.clear()` + rebuild) — mints a fresh
+ * `NodeKey` for every node, so the outbound sync (`to-loro.ts`) matches nothing
+ * through the `NodeKey → ContainerID` registry and recreates EVERY container.
+ * A concurrent edit from another window merges into a container this side just
+ * deleted and is lost; a mounted `LLuiDecoratorNode` sub-app under any block is
+ * torn down. Measured at 0% ContainerID survival even for IDENTICAL markdown.
+ *
+ * ── The design ─────────────────────────────────────────────────────────────
+ *
+ * Reconcile a PARSED TARGET TREE directly against the existing Loro document,
+ * matching existing child carriers to target children by CONTENT rather than by
+ * NodeKey. Unchanged blocks keep their `ContainerID`s (and therefore their
+ * `NodeKey`s and decorator mounts on the inbound bounce); a text-changed block
+ * keeps its `LoroText` and diffs the characters; only genuinely new/removed/moved
+ * blocks touch the ordering. This is the analog of loro-prosemirror's
+ * content-equality match (`eqLoroObjNode`), living where the reconciler already
+ * is.
+ *
+ * This is a SIBLING to the outbound sync ({@link import('./to-loro.js')}), not a
+ * replacement: it writes the Loro document directly under {@link
+ * AGENT_WRITE_ORIGIN}, and the existing inbound path ({@link
+ * import('./to-lexical.js')}) replicates that change into any live editor bound
+ * to the same document — preserving `NodeKey`s and decorator mounts on the
+ * bounce, and self-healing the `ContainerID ↔ NodeKey` mapping there. For that
+ * bounce to happen, {@link AGENT_WRITE_ORIGIN} must be on the inbound target's
+ * list of local origins to apply; `binding.ts` wires that.
+ *
+ * ── What this deliberately does NOT consult ────────────────────────────────
+ *
+ * The `ContainerNodeMap` registry is intentionally NOT read here — content
+ * matching is the whole point, and the mapping self-heals on the inbound bounce.
+ * (Contrast `to-loro.ts`, whose whole job is IDENTITY matching through that
+ * registry.)
+ *
+ * ── Where the markdown parse lives ─────────────────────────────────────────
+ *
+ * The markdown → target-tree PARSE is the CALLER's job, because it is
+ * caller-specific: the caller owns its custom nodes and its own `@lexical/markdown`
+ * transformer set, and that transformer set defines the tree. This module pulls
+ * neither `@lexical/markdown` nor `@lexical/headless` (both would otherwise become
+ * runtime dependencies of a binding whose core — the reconciler — needs neither).
+ * The caller parses markdown headlessly with its own transformers and projects the
+ * resulting Lexical tree with {@link projectTarget} (or {@link
+ * targetFromEditorState}), then hands the plain, serializable {@link TargetElement}
+ * to {@link reconcileTargetIntoLoro}. The reconciler is the reusable core; the
+ * markdown parse is not.
+ */
+import { $getRoot, $isElementNode, $isTextNode, } from 'lexical';
+import { allocate, jitterFor } from './order.js';
+import { createElementChild, createTextChild, deleteChild, elementChildren, elementProps, elementType, isTextContainer, newUuid, orderedChildren, setChildPosition, } from './schema.js';
+import { applyMarkOps, applyTextDiff, diffRunFormats, diffText, normalizeRuns, runsFromText, runsText, } from './text.js';
+/** Lexical node props that are structure/bookkeeping, never document data. */
+const NON_PROP_KEYS = new Set(['type', 'version', 'children']);
+/**
+ * Normalize an `exportJSON` value into a stored {@link PropValue}, dropping
+ * `undefined` exactly as `to-loro.ts`'s `syncProps` does — so a target block's
+ * props signature equals what the Loro container already holds.
+ */
+function toProp(value) {
+    if (value === null)
+        return null;
+    switch (typeof value) {
+        case 'string':
+        case 'number':
+        case 'boolean':
+            return value;
+        case 'object': {
+            if (Array.isArray(value))
+                return value.map(toProp);
+            const out = {};
+            for (const [key, inner] of Object.entries(value)) {
+                if (inner === undefined)
+                    continue;
+                out[key] = toProp(inner);
+            }
+            return out;
+        }
+        default:
+            throw new Error(`lexical-loro: agent-write cannot store a non-JSON prop value (${typeof value})`);
+    }
+}
+/** The document-data props of a Lexical node, mirroring `to-loro.ts`'s `syncProps`. */
+function propsOf(node) {
+    const json = node.exportJSON();
+    const out = {};
+    for (const [key, value] of Object.entries(json)) {
+        if (NON_PROP_KEYS.has(key) || value === undefined)
+            continue;
+        out[key] = toProp(value);
+    }
+    return out;
+}
+/**
+ * Project one Lexical element (or element-mirrored leaf) to a {@link TargetElement}.
+ *
+ * MUST be called inside a Lexical read (`editorState.read(() => …)`), because it
+ * reads node content. Uses only `lexical` (a peer dependency) — never
+ * `@lexical/markdown`. See {@link targetFromEditorState} for the common wrapper.
+ */
+export function projectTarget(node) {
+    const props = propsOf(node);
+    if (!$isElementNode(node))
+        return { kind: 'element', type: node.getType(), props, children: [] };
+    const children = [];
+    let run = [];
+    const flush = () => {
+        if (run.length === 0)
+            return;
+        children.push({
+            kind: 'text',
+            runs: normalizeRuns(run.map((n) => ({ text: n.getTextContent(), format: n.getFormat() }))),
+        });
+        run = [];
+    };
+    for (const child of node.getChildren()) {
+        if ($isTextNode(child)) {
+            run.push(child);
+        }
+        else {
+            flush();
+            children.push(projectTarget(child));
+        }
+    }
+    flush();
+    return { kind: 'element', type: node.getType(), props, children };
+}
+/**
+ * Project the root of an `EditorState` to a {@link TargetElement}, doing the read
+ * for you.
+ *
+ * The caller owns the markdown → editor-state parse (its own headless editor and
+ * `@lexical/markdown` transformer set); this projects the parsed tree into the
+ * plain, serializable shape {@link reconcileTargetIntoLoro} consumes. Uses only
+ * `lexical`.
+ */
+export function targetFromEditorState(state) {
+    let target;
+    state.read(() => {
+        target = projectTarget($getRoot());
+    });
+    if (target === undefined)
+        throw new Error('lexical-loro: agent-write failed to project editor state');
+    return target;
+}
+// ---------------------------------------------------------------------------
+// Content signatures
+// ---------------------------------------------------------------------------
+/** Canonical, sort-stable JSON of a prop value, so equal content compares equal. */
+function stableProps(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableProps).join(',')}]`;
+    const keys = Object.keys(value).sort();
+    return `{${keys.map((k) => `${JSON.stringify(k)}:${stableProps(value[k])}`).join(',')}}`;
+}
+function runsSignature(runs) {
+    return `T|${JSON.stringify(normalizeRuns(runs).map((r) => [r.text, r.format]))}`;
+}
+/** The content signature of a target child — identical content ⇒ identical string. */
+function targetSignature(child) {
+    if (child.kind === 'text')
+        return runsSignature(child.runs);
+    return `E|${child.type}|${stableProps(child.props)}|[${child.children
+        .map(targetSignature)
+        .join(',')}]`;
+}
+/** The content signature of an existing carrier — the mirror of {@link targetSignature}. */
+function entrySignature(entry) {
+    if (entry.kind === 'text' && isTextContainer(entry.container)) {
+        return runsSignature(runsFromText(entry.container));
+    }
+    const container = entry.container;
+    const props = elementProps(container).toJSON();
+    return `E|${elementType(container)}|${stableProps(props)}|[${orderedChildren(container)
+        .map(entrySignature)
+        .join(',')}]`;
+}
+/** The Lexical type a target element maps a carrier to (text runs share `'#text'`). */
+function targetKindKey(child) {
+    return child.kind === 'text' ? '#text' : `E:${child.type}`;
+}
+function entryKindKey(entry) {
+    return entry.kind === 'text' ? '#text' : `E:${elementType(entry.container)}`;
+}
+/**
+ * Match desired children to existing carriers by CONTENT, in two passes:
+ *
+ *  1. EXACT signature — an unchanged subtree keeps its whole identity and needs
+ *     no descent. Within a group of byte-identical carriers the match is biased
+ *     toward the SAME POSITION: each target claims the same-signature carrier
+ *     whose rendered index is nearest the target's own index. This is the
+ *     duplicate-block mitigation — a still-identical sibling keeps its OWN carrier
+ *     rather than an arbitrary same-content one, so the block the user CHANGED is
+ *     the one whose carrier is freed for reuse.
+ *  2. SAME-KIND fallback — a leftover carrier of the same type/text-kind is
+ *     reused for a changed block, so a text edit diffs its `LoroText` and an
+ *     element edit recurses, rather than deleting and recreating.
+ *
+ * Whatever is still unmatched is created (desired) or deleted (existing).
+ *
+ * ── The residual, stated honestly ──────────────────────────────────────────
+ *
+ * Position bias reduces, but CANNOT eliminate, mis-assignment among TRUE
+ * duplicates. When the count of a byte-identical group changes (e.g. one of three
+ * identical paragraphs is deleted), content is by definition insufficient to say
+ * WHICH carrier the user meant to keep, and position proximity is only a guess;
+ * the trailing carrier is dropped regardless of intent. `NodeKey` identity — which
+ * the agent path does not have, since the agent hands us markdown, not an edited
+ * editor state — is the only complete answer. See the duplicate-block tests.
+ */
+function matchChildren(current, desired) {
+    const matched = new Array(desired.length).fill({ entry: null, tag: 'new' });
+    const claimed = new Set();
+    // Pass 1: exact content signature, biased toward the same rendered position.
+    const bySig = new Map();
+    for (let index = 0; index < current.length; index++) {
+        const entry = current[index];
+        const sig = entrySignature(entry);
+        const bucket = bySig.get(sig);
+        if (bucket === undefined)
+            bySig.set(sig, [{ entry, index }]);
+        else
+            bucket.push({ entry, index });
+    }
+    for (let i = 0; i < desired.length; i++) {
+        const bucket = bySig.get(targetSignature(desired[i]));
+        if (bucket === undefined || bucket.length === 0)
+            continue;
+        // Take the same-content carrier nearest this target's index (position bias),
+        // ties resolved toward the earlier carrier.
+        let best = 0;
+        let bestDistance = Math.abs(bucket[0].index - i);
+        for (let b = 1; b < bucket.length; b++) {
+            const distance = Math.abs(bucket[b].index - i);
+            if (distance < bestDistance) {
+                best = b;
+                bestDistance = distance;
+            }
+        }
+        const [carrier] = bucket.splice(best, 1);
+        matched[i] = { entry: carrier.entry, tag: 'exact' };
+        claimed.add(carrier.entry);
+    }
+    // Pass 2: same-kind fallback for changed blocks.
+    const byKind = new Map();
+    for (const entry of current) {
+        if (claimed.has(entry))
+            continue;
+        const key = entryKindKey(entry);
+        const bucket = byKind.get(key);
+        if (bucket === undefined)
+            byKind.set(key, [entry]);
+        else
+            bucket.push(entry);
+    }
+    for (let i = 0; i < desired.length; i++) {
+        if (matched[i].entry !== null)
+            continue;
+        const entry = byKind.get(targetKindKey(desired[i]))?.shift();
+        if (entry === undefined)
+            continue;
+        matched[i] = { entry, tag: 'reuse' };
+        claimed.add(entry);
+    }
+    return matched;
+}
+/**
+ * Longest strictly-increasing subsequence indices — the reorder planner, so a
+ * move rewrites only genuinely displaced `pos` keys. Mirrors `to-loro.ts`.
+ */
+function longestIncreasingSubsequence(values) {
+    if (values.length === 0)
+        return [];
+    const tails = [];
+    const previous = new Array(values.length).fill(-1);
+    for (let i = 0; i < values.length; i++) {
+        let low = 0;
+        let high = tails.length;
+        while (low < high) {
+            const mid = (low + high) >> 1;
+            if (values[tails[mid]] < values[i])
+                low = mid + 1;
+            else
+                high = mid;
+        }
+        if (low > 0)
+            previous[i] = tails[low - 1];
+        tails[low] = i;
+    }
+    const out = new Array(tails.length);
+    let cursor = tails[tails.length - 1];
+    for (let i = tails.length - 1; i >= 0; i--) {
+        out[i] = cursor;
+        cursor = previous[cursor];
+    }
+    return out;
+}
+/** Dense ranks so equal positions share a rank and the strict LIS keeps at most one. */
+function positionRanks(positions) {
+    const distinct = [...new Set(positions)].sort();
+    const rank = new Map(distinct.map((pos, index) => [pos, index]));
+    return positions.map((pos) => rank.get(pos));
+}
+/**
+ * Assign every desired child a position: keep the already-ordered survivors,
+ * re-position the rest, create the ones with no carrier — one maximal gap at a
+ * time so a multi-block insertion is allocated as ONE batch (never interleaves a
+ * concurrent paste, and never rebalances). Mirrors `to-loro.ts`'s `placeChildren`.
+ */
+function placeChildren(children, desired, matched, context) {
+    const survivorIndices = [];
+    for (let i = 0; i < desired.length; i++)
+        if (matched[i].entry !== null)
+            survivorIndices.push(i);
+    const ranks = positionRanks(survivorIndices.map((i) => matched[i].entry.pos));
+    const keep = new Set();
+    for (const index of longestIncreasingSubsequence(ranks))
+        keep.add(survivorIndices[index]);
+    const placed = new Array(desired.length);
+    for (const index of keep)
+        placed[index] = matched[index].entry.container;
+    let i = 0;
+    while (i < desired.length) {
+        if (keep.has(i)) {
+            i++;
+            continue;
+        }
+        let end = i;
+        while (end < desired.length && !keep.has(end))
+            end++;
+        const before = i === 0 ? null : matched[i - 1].entry.pos;
+        const after = end === desired.length ? null : matched[end].entry.pos;
+        const keys = allocate(before, after, end - i, context.jitter);
+        for (let j = i; j < end; j++) {
+            const key = keys[j - i];
+            const entry = matched[j].entry;
+            if (entry === null) {
+                placed[j] = createChild(children, desired[j], key, context);
+                continue;
+            }
+            setChildPosition(entry.carrier, key);
+            context.ops++;
+            placed[j] = entry.container;
+        }
+        i = end;
+    }
+    return placed;
+}
+// ---------------------------------------------------------------------------
+// Reconcile
+// ---------------------------------------------------------------------------
+/**
+ * Commit origin stamped on the single agent-write commit.
+ *
+ * Distinct from `to-loro.ts`'s `OUTBOUND_ORIGIN` so the inbound path can tell an
+ * agent write apart from an echo of its own outbound write: `binding.ts` lists
+ * this origin among the LOCAL batches the inbound path must still APPLY, which is
+ * what bounces an agent write into a live editor (preserving `NodeKey`s and
+ * decorator mounts).
+ */
+export const AGENT_WRITE_ORIGIN = 'agent-write';
+/**
+ * Reconcile a parsed target tree into an existing Loro document, preserving the
+ * `ContainerID`s of unchanged and text-edited blocks, and commit under `origin`.
+ *
+ * A SIBLING to `syncLexicalToLoro` — it writes Loro directly rather than mirroring
+ * a Lexical update, matches by CONTENT rather than by `NodeKey`, and does NOT
+ * consult the `ContainerNodeMap` (which self-heals on the inbound bounce).
+ *
+ * @param doc    the shared document.
+ * @param root   its root element container, as returned by `initDoc`.
+ * @param target the desired tree, from {@link targetFromEditorState} /
+ *               {@link projectTarget} (the caller owns the markdown parse).
+ * @param origin the commit origin. Defaults to {@link AGENT_WRITE_ORIGIN}; keep
+ *               it on the inbound target's applied-local-origins list, or a live
+ *               editor bound to the same doc will not see the change.
+ * @returns the number of Loro write ops emitted. `0` means the target already
+ *          matched the document — nothing committed, no peer sees an event.
+ */
+export function reconcileTargetIntoLoro(doc, root, target, origin = AGENT_WRITE_ORIGIN) {
+    const context = { doc, jitter: jitterFor(doc.peerId), ops: 0 };
+    reconcileElement(root, target, context);
+    if (context.ops > 0)
+        doc.commit({ origin });
+    return context.ops;
+}
+function reconcileElement(container, target, context) {
+    syncProps(container, target.props, context);
+    reconcileChildren(container, orderedChildren(container), target.children, context);
+}
+function syncProps(container, target, context) {
+    const props = elementProps(container);
+    const seen = new Set();
+    for (const [key, value] of Object.entries(target)) {
+        seen.add(key);
+        if (jsonEqual(props.get(key), value))
+            continue;
+        props.set(key, value);
+        context.ops++;
+    }
+    for (const key of props.keys()) {
+        if (seen.has(key))
+            continue;
+        props.delete(key);
+        context.ops++;
+    }
+}
+function reconcileChildren(container, current, desired, context) {
+    const children = elementChildren(container);
+    const matched = matchChildren(current, desired);
+    const survivors = new Set(matched.map((m) => m.entry).filter((e) => e !== null));
+    // Delete carriers no target child reused. A carrier is addressed by uuid, so
+    // deleting one cannot shift another.
+    for (const entry of current) {
+        if (survivors.has(entry))
+            continue;
+        deleteChild(children, entry.uuid);
+        context.ops++;
+    }
+    const placed = placeChildren(children, desired, matched, context);
+    // Descend: exact matches are unchanged (no work); reused carriers get a text
+    // diff or a recursive element reconcile.
+    for (let i = 0; i < desired.length; i++) {
+        const match = matched[i];
+        if (match.tag !== 'reuse')
+            continue;
+        const child = desired[i];
+        const containerAt = placed[i];
+        if (child.kind === 'text') {
+            if (isTextContainer(containerAt))
+                syncText(containerAt, child.runs, context);
+        }
+        else if (!isTextContainer(containerAt)) {
+            reconcileElement(containerAt, child, context);
+        }
+    }
+}
+/**
+ * Fill a text run's `LoroText` to `runs`: diff the characters (no caret — an
+ * agent edit has none), then replay the resulting formats as `mark`/`unmark`.
+ * Mirrors `to-loro.ts`'s `syncText` minus the cursor bias.
+ */
+function syncText(text, runs, context) {
+    const target = normalizeRuns(runs.map((r) => ({ text: r.text, format: r.format })));
+    const targetString = runsText(target);
+    if (text.toString() !== targetString) {
+        const diff = diffText(text.toString(), targetString);
+        applyTextDiff(text, diff);
+        if (diff.remove > 0)
+            context.ops++;
+        if (diff.insert !== '')
+            context.ops++;
+    }
+    const ops = diffRunFormats(runsFromText(text), target);
+    applyMarkOps(text, ops);
+    context.ops += ops.length;
+}
+/** Create, attach and fill a brand-new child at position `pos`. */
+function createChild(children, child, pos, context) {
+    context.ops++;
+    const uuid = newUuid();
+    if (child.kind === 'text') {
+        const text = createTextChild(children, uuid, pos);
+        syncText(text, child.runs, context);
+        return text;
+    }
+    const element = createElementChild(children, uuid, pos, child.type);
+    reconcileElement(element, child, context);
+    return element;
+}
+// ---------------------------------------------------------------------------
+// Shared
+// ---------------------------------------------------------------------------
+function jsonEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null || typeof a !== 'object' || typeof b !== 'object')
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((item, i) => jsonEqual(item, b[i]));
+    }
+    const left = a;
+    const right = b;
+    const keys = Object.keys(left);
+    if (keys.length !== Object.keys(right).length)
+        return false;
+    return keys.every((key) => key in right && jsonEqual(left[key], right[key]));
+}
+//# sourceMappingURL=agent-write.js.map

package/dist/agent-write.js.map

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

package/dist/binding.d.ts

@@ -0,0 +1,122 @@
+/**
+ * `loroCollab(config)` — the binding that drives both directions.
+ *
+ * It composes `to-loro.ts` (Lexical → Loro), `to-lexical.ts` (Loro → Lexical)
+ * and `seed.ts` (boot) into one `register(editor)` step you hand to
+ * `lexicalForeign({ history: false, seedMode: 'deferred', register })`. The
+ * returned handle satisfies `@llui/markdown-editor`'s `CollabBinding`
+ * structurally, so that package needs no Loro dependency of its own.
+ *
+ * ── Transport ──────────────────────────────────────────────────────────────
+ *
+ * There is none, deliberately. `LoroDoc` already exposes the whole wire surface
+ * (`subscribeLocalUpdates` / `import` / `export`), so a transport is a dozen
+ * lines the consumer writes against their own websocket, WebRTC channel or
+ * `loro-websocket` provider — and baking one in would make this package own a
+ * connection lifecycle it has no way to test honestly. Pass the same `LoroDoc`
+ * to your provider and to `loroCollab`.
+ *
+ * ── The three echo layers, and where each one lives ────────────────────────
+ *
+ * All three are required; any one missing produces an infinite loop or, worse,
+ * a silent data-loss bug:
+ *
+ *  a. Loro → us. A LOCAL Loro batch is our own outbound write completing its
+ *     commit. `applyLoroToLexical` drops it (`to-lexical.ts`). Without this the
+ *     binding re-enters `editor.update` from inside a Lexical update listener.
+ *  b. us → Lexical → us. Our inbound writeback is tagged `COLLABORATION_TAG`,
+ *     which `syncLexicalToLoro` skips (`to-loro.ts`). Without this every remote
+ *     keystroke is echoed straight back to its sender.
+ *  c. THE SEAM. This binding NEVER emits `PROGRAMMATIC_TAG`.
+ *     `packages/lexical/src/foreign.ts` treats that tag as "the host pushed new
+ *     content — cancel pending outbound work and rebase", so a remote writeback
+ *     carrying it would cancel the local user's in-flight debounced `onChange`
+ *     and the host's persistence would go dark whenever a peer types. There is
+ *     no code here to enforce this; there is simply no line that emits it, and
+ *     `test/to-lexical.test.ts` pins that.
+ *
+ * ── Undo ───────────────────────────────────────────────────────────────────
+ *
+ * This binding OWNS undo, via `externalUndo` (`undo.ts`, a Loro `UndoManager`
+ * scoped to this peer). Hosts must therefore turn their built-in
+ * `@lexical/history` stack off — `lexicalForeign` does that for you the moment
+ * `externalUndo` is present, so the two can never both be live.
+ *
+ * Loro's manager is operation-based and PeerID-scoped: undo reverts exactly the
+ * local user's own last change and never a peer's, which snapshot-based history
+ * cannot do at any tag setting. See `undo.ts` for why, and for the echo seam the
+ * undo batches travel through.
+ */
+import type { LexicalEditor } from 'lexical';
+import { LoroDoc } from 'loro-crdt';
+import { ContainerNodeMap } from './mapping.js';
+import { type BootstrapOutcome } from './seed.js';
+import { type ElementContainer } from './schema.js';
+import { type LoroUndoOptions } from './undo.js';
+export interface LoroCollabConfig {
+    /** The shared document. Created if omitted — pass your provider's doc. */
+    readonly doc?: LoroDoc;
+    /**
+     * Whether THIS peer may seed an empty shared document. Default `true`.
+     * Set `false` on peers that join rather than create, and on any peer whose
+     * transport has not completed its first sync — an unsynced document looks
+     * empty, and seeding one races the content about to arrive.
+     */
+    readonly shouldBootstrap?: boolean;
+    /**
+     * Fill an empty shared document with this peer's default content. Runs once,
+     * inside a Lexical update. `@llui/markdown-editor` supplies this as
+     * `CollabHooks.seed`, which converts its `defaultValue` markdown.
+     */
+    readonly seed?: (editor: LexicalEditor) => void;
+    /** Commit origin stamped on this binding's writes. Defaults to `'lexical-loro'`. */
+    readonly origin?: string;
+    /** Called after boot with what happened — seeded, adopted, or still waiting. */
+    readonly onBootstrap?: (outcome: BootstrapOutcome) => void;
+    /**
+     * Tuning for the peer-scoped undo manager installed by
+     * {@link LoroCollab.externalUndo} — merge window, stack depth, excluded
+     * origins. Defaults are in `undo.ts`; the `doc` is supplied by the binding.
+     */
+    readonly undo?: Omit<LoroUndoOptions, 'doc'>;
+}
+/** Live handle returned by {@link loroCollab}. */
+export interface LoroCollab {
+    /**
+     * Wire the binding onto an editor; pass as `lexicalForeign({ register })`.
+     * Returns a disposer that unsubscribes both directions.
+     *
+     * Satisfies `@llui/markdown-editor`'s `CollabBinding` structurally.
+     */
+    register: (editor: LexicalEditor) => () => void;
+    /** The shared document. Hand this to your transport. */
+    readonly doc: LoroDoc;
+    /** The root element container mirroring Lexical's `RootNode`. */
+    readonly root: ElementContainer;
+    /** The ContainerID ↔ NodeKey registry. Exposed for tests and diagnostics. */
+    readonly mapping: ContainerNodeMap;
+    /**
+     * Install this binding's CRDT-aware undo/redo on the editor; pass as
+     * `lexicalForeign({ externalUndo })`. Returns a disposer.
+     *
+     * Undo is LOCAL-ONLY: it reverts this peer's own commits and leaves every
+     * other peer's concurrent edits standing (`undo.ts`). Registering it forces
+     * `lexicalForeign`'s built-in `@lexical/history` stack off, which is the point
+     * — a snapshot-based local stack would rewind remote work for everyone.
+     *
+     * Registration is SEPARATE from {@link LoroCollab.register} so a host that
+     * genuinely wants its own undo owner can decline it. Do not register it twice.
+     */
+    readonly externalUndo: (editor: LexicalEditor) => () => void;
+    /** Re-run the boot decision — call after your transport's first sync. */
+    bootstrap: (editor: LexicalEditor) => BootstrapOutcome;
+}
+/**
+ * Build a collaborative-editing binding over a Loro document.
+ *
+ * The document is configured for this package's schema (`initDoc`) immediately,
+ * not at `register` time, so a transport may be attached to `collab.doc` before
+ * any editor exists.
+ */
+export declare function loroCollab(config?: LoroCollabConfig): LoroCollab;
+//# sourceMappingURL=binding.d.ts.map

package/dist/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAW,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI5D,OAAO,EAAkC,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAEhF,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;IAC/C,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC1D;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAA;CAC7C;AAED,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,IAAI,CAAA;IAC/C,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,IAAI,CAAA;IAC5D,yEAAyE;IACzE,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,gBAAgB,CAAA;CACvD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,UAAU,CAuDpE"}