docxodus 7.1.0 → 9.0.0

package/dist/editor-headerfooter.js

@@ -0,0 +1,530 @@
+/**
+ * HeaderFooterRegion — the DocxEditor's docked header/footer editing bands.
+ *
+ * Header and footer stories live in their own OOXML parts (HeaderPart/FooterPart) *outside*
+ * the body, so they cannot be another block in the body flow. This module renders them as two
+ * docked bands — one above the body, one below — each composed PER STORY PARAGRAPH via the
+ * session-attached `RenderBlockHtml`, which resolves `hdr`/`ftr` anchors natively.
+ *
+ * Using the same renderer for first paint and for the post-edit incremental swap means there is
+ * no fidelity drift between them. It is also the only option that works in continuous mode at
+ * all: the editor's full-document render only asks for headers/footers in paginated mode, and it
+ * never stamps `data-anchor` inside header/footer parts (Unids are assigned to the main document
+ * part only). In paginated mode the page boxes additionally clone one header node onto every
+ * page, so page-margin nodes could never be uniquely addressable — bands keep exactly one DOM
+ * node per story paragraph.
+ *
+ * Once rendered, a story paragraph is an ORDINARY editable block: DocxSession's anchor
+ * resolution indexes every scope and routes by part, so ReplaceText/ApplyFormat/SetParagraphFormat
+ * all accept a `p:hdr1:<unid>` anchor. The editor wires band blocks with the same `wireBlock` it
+ * uses for the body, which is why the whole ribbon works inside a band with no new command code.
+ */
+/** The page-number formats Word's *Format Page Numbers…* dialog offers, in its order. The blank
+ *  entry means "leave the section's format alone" — not "decimal", which would write an attribute
+ *  the document may never have had. */
+const PAGE_FORMAT_LABELS = [
+    { value: "", label: "Format…" },
+    { value: "decimal", label: "1, 2, 3" },
+    { value: "lowerLetter", label: "a, b, c" },
+    { value: "upperLetter", label: "A, B, C" },
+    { value: "lowerRoman", label: "i, ii, iii" },
+    { value: "upperRoman", label: "I, II, III" },
+];
+const KIND_LABELS = [
+    { value: "default", label: "Default" },
+    { value: "first", label: "First page" },
+    { value: "even", label: "Even pages" },
+];
+/**
+ * Verbatim from docs/architecture/docx_mutation_api.md. `w:evenAndOddHeaders` is set on the
+ * SETTINGS part, so it is document-global and governs footers as well as headers: once set,
+ * even pages stop inheriting the Default stories entirely. A demo user who creates only an
+ * even header hits this immediately and sees their footer vanish on page 2.
+ */
+const EVEN_WARNING = "w:evenAndOddHeaders is document-global and governs footers too — even pages stop " +
+    "inheriting the Default stories, so a section with only a Default footer shows no footer " +
+    "at all on even pages.";
+/**
+ * `w:titlePg` is per-section but has the same shape of surprise: once set, page 1 uses its OWN
+ * header AND footer, so an empty first-page footer means page 1 shows no footer even though the
+ * Default one is populated.
+ */
+const FIRST_WARNING = "w:titlePg makes page 1 use its own first-page header AND footer instead of the Default " +
+    "ones, so an empty first-page footer leaves page 1 with no footer.";
+/** Kinds/scopes the markdown projection addresses as editable text blocks. */
+const STORY_BLOCK_KINDS = new Set(["p", "h", "li"]);
+export class HeaderFooterRegion {
+    constructor(bridge, handle, options, callbacks) {
+        /** The body anchor whose section the bands currently describe (needed to seed a story). */
+        this.bodyAnchorId = null;
+        this.sectionInfo = null;
+        /** Memoized body anchor → governing sectionUnid, so repeat focus costs no bridge call. */
+        this.sectionOfAnchor = new Map();
+        this.kinds = {
+            header: "default",
+            footer: "default",
+        };
+        this.bridge = bridge;
+        this.handle = handle;
+        this.options = options;
+        this.callbacks = callbacks;
+        this.headerBand = this.buildBand("header");
+        this.footerBand = this.buildBand("footer");
+    }
+    // ─── public surface ──────────────────────────────────────────────────
+    /**
+     * Point the bands at the section governing `bodyAnchorId` and repaint if it changed.
+     * Cheap to call on every focus change: the anchor → section lookup is memoized, and an
+     * unchanged `sectionUnid` returns without touching the DOM (so it never clobbers the
+     * user's kind selection).
+     */
+    syncToBody(bodyAnchorId) {
+        if (!bodyAnchorId)
+            return;
+        const cached = this.sectionOfAnchor.get(bodyAnchorId);
+        if (cached !== undefined && cached === this.sectionInfo?.sectionUnid) {
+            this.bodyAnchorId = bodyAnchorId; // same section — keep it as the seed target
+            return;
+        }
+        const info = this.readSectionInfo(bodyAnchorId);
+        if (!info)
+            return; // not a body anchor (or no sectPr) — leave the bands as they are
+        this.sectionOfAnchor.set(bodyAnchorId, info.sectionUnid);
+        const changed = info.sectionUnid !== this.sectionInfo?.sectionUnid;
+        this.bodyAnchorId = bodyAnchorId;
+        this.sectionInfo = info;
+        if (changed)
+            this.refreshAll();
+    }
+    /** Repaint one band from the live session. */
+    refresh(which) {
+        this.sectionInfo = this.bodyAnchorId ? this.readSectionInfo(this.bodyAnchorId) : null;
+        this.renderBand(which);
+    }
+    /** Repaint both bands from the live session (after a remount, undo/redo, or section change). */
+    refreshAll() {
+        this.renderBand("header");
+        this.renderBand("footer");
+    }
+    /** Select (and, if absent, create) the story kind a band edits, and make it render. */
+    setKind(which, kind) {
+        this.kinds[which] = kind;
+        const select = this.bandFor(which).querySelector("[data-hf-kind]");
+        if (select && select.value !== kind)
+            select.value = kind;
+        if (!this.partUriFor(which, kind))
+            this.seedStory(which, kind);
+        // Selecting first/even IS the user saying "use a different first/even page", so the section's
+        // visibility flag must be set even when the part already exists — seedStory (which sets it as
+        // a side effect of writing content) doesn't run then. Word leaves first/even parts behind when
+        // those options are switched off, so a real document commonly has the reference WITHOUT the
+        // flag; without this the typed story is saved but never rendered.
+        if (this.bodyAnchorId && kind !== "default") {
+            this.bridge.EnsureHeaderFooterVisible(this.handle, this.bodyAnchorId, kind);
+        }
+        this.refresh(which);
+    }
+    /** The kind a band is currently editing. */
+    kindOf(which) {
+        return this.kinds[which];
+    }
+    /** Append a PAGE / NUMPAGES field to the story paragraph addressed by `anchorId`.
+     *  Deliberately a PLAIN field (no `\*` switch), exactly as Word inserts one, so it follows the
+     *  section's page-number format — see {@link setPageNumbering}. Stamping the section's current
+     *  format as a switch here would silently WIN over any later format change. */
+    insertPageNumber(which, anchorId, field) {
+        const res = parseResult(this.bridge.InsertPageNumberField(this.handle, anchorId, field, ""));
+        if (!res.success)
+            return false;
+        this.refresh(which);
+        return true;
+    }
+    /**
+     * Set this section's page numbering (`w:pgNumType`) — Word's *Format Page Numbers…*. Omitted
+     * fields are left alone, so the format and the start are independently settable. Both bands then
+     * repaint, because the values belong to the section rather than to either story.
+     *
+     * The rendered page numbers in the editor do not change: a page-number field's cached result is
+     * what the browser shows, and Word recomputes it on open. Paginated mode substitutes the real
+     * per-page number, so it does reflect the format immediately.
+     */
+    setPageNumbering(op) {
+        if (!this.bodyAnchorId)
+            return false;
+        const res = parseResult(this.bridge.SetPageNumbering(this.handle, this.bodyAnchorId, JSON.stringify(op)));
+        if (!res.success)
+            return false;
+        this.reloadSection();
+        return true;
+    }
+    /** This section's page numbering as the live document states it. Fields are absent, not
+     *  defaulted — "continues the previous section" is not the same claim as "starts at 1". */
+    pageNumbering() {
+        return {
+            start: this.sectionInfo?.pageNumberStart,
+            format: this.sectionInfo?.pageNumberFormat,
+        };
+    }
+    /** Remove this section's page-numbering start/format — it reverts to continuing the previous
+     *  section's numbering in Word's default `1, 2, 3`. */
+    clearPageNumbering() {
+        if (!this.bodyAnchorId)
+            return false;
+        const res = parseResult(this.bridge.ClearPageNumbering(this.handle, this.bodyAnchorId));
+        if (!res.success)
+            return false;
+        this.reloadSection();
+        return true;
+    }
+    /**
+     * Re-read the section from the live document and repaint BOTH bands.
+     *
+     * `refreshAll` only repaints — it deliberately does not re-read, because its callers (remount,
+     * undo/redo) already refreshed the section. A section-property write has no such caller, and
+     * repainting from the stale snapshot would leave the chrome reporting the value the document had
+     * before the edit.
+     */
+    reloadSection() {
+        this.sectionInfo = this.bodyAnchorId ? this.readSectionInfo(this.bodyAnchorId) : null;
+        this.refreshAll();
+    }
+    /** Insert a page number into a band's own target paragraph (focused, else last). Seeds the
+     *  story first if the band's selected kind has none, so the command is never a silent no-op. */
+    insertPageNumberInBand(which, field) {
+        if (!this.partUriFor(which, this.kinds[which])) {
+            this.seedStory(which, this.kinds[which]);
+            this.renderBand(which);
+        }
+        const target = this.pageNumberTarget(which);
+        return target ? this.insertPageNumber(which, target, field) : false;
+    }
+    /** The band element containing `node`, or null. */
+    bandOf(node) {
+        const el = node && node.nodeType === 1 ? node : node?.parentElement ?? null;
+        const band = el?.closest("[data-hf-band]") ?? null;
+        return band === this.headerBand || band === this.footerBand ? band : null;
+    }
+    /** The block-list root (a band's story container) owning `node`, or null. */
+    blockRootOf(node) {
+        const band = this.bandOf(node);
+        return band ? band.querySelector("[data-hf-body]") : null;
+    }
+    /** True when `node` is inside either band (including its chrome). */
+    contains(node) {
+        return this.bandOf(node) !== null;
+    }
+    /** `"header"` / `"footer"` for a band element produced by this region. */
+    whichOf(band) {
+        return band === this.footerBand ? "footer" : "header";
+    }
+    // ─── section + anchor resolution ─────────────────────────────────────
+    readSectionInfo(bodyAnchorId) {
+        try {
+            const raw = this.bridge.GetSectionInfo(this.handle, bodyAnchorId);
+            const parsed = JSON.parse(raw);
+            return parsed && typeof parsed.sectionUnid === "string" ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    refsFor(which) {
+        const info = this.sectionInfo;
+        if (!info)
+            return [];
+        return (which === "header" ? info.headerRefs : info.footerRefs) ?? [];
+    }
+    /** The reference supplying `kind` for this band — possibly inherited from an earlier section. */
+    refFor(which, kind) {
+        return this.refsFor(which).find((r) => r.kind === kind) ?? null;
+    }
+    /** URI of the part supplying `kind` for this band, or null when the story doesn't exist. */
+    partUriFor(which, kind) {
+        return this.refFor(which, kind)?.partUri ?? null;
+    }
+    /** Full anchor ids of the story paragraphs held in `partUri`, in document order. */
+    storyAnchors(partUri) {
+        let index;
+        try {
+            index = JSON.parse(this.bridge.Project(this.handle)).anchorIndex;
+        }
+        catch {
+            return [];
+        }
+        return Object.entries(index)
+            .filter(([, t]) => t.partUri === partUri && STORY_BLOCK_KINDS.has(t.kind))
+            .map(([id]) => id);
+    }
+    /**
+     * Create an empty story for `kind`. Seeding happens the moment a kind is selected rather than
+     * lazily on first keystroke: an absent story renders no contenteditable element, so there
+     * would be nothing to click into.
+     */
+    seedStory(which, kind) {
+        if (!this.bodyAnchorId)
+            return;
+        const set = which === "header" ? this.bridge.SetHeaderText : this.bridge.SetFooterText;
+        const res = parseResult(set(this.handle, this.bodyAnchorId, kind, ""));
+        if (!res.success)
+            return;
+        // A new part changes the projection (fresh hdr{N}/ftr{N} scope) and the section's refs.
+        this.callbacks.refreshAnchorMap();
+        this.sectionInfo = this.readSectionInfo(this.bodyAnchorId);
+    }
+    // ─── rendering ───────────────────────────────────────────────────────
+    bandFor(which) {
+        return which === "header" ? this.headerBand : this.footerBand;
+    }
+    buildBand(which) {
+        const band = document.createElement("div");
+        band.className = "docx-hf-band";
+        band.setAttribute("data-hf-band", which);
+        const chrome = document.createElement("div");
+        chrome.className = "docx-hf-chrome";
+        const label = document.createElement("span");
+        label.className = "docx-hf-label";
+        label.textContent = which === "header" ? "Header" : "Footer";
+        chrome.appendChild(label);
+        const kindSelect = document.createElement("select");
+        kindSelect.setAttribute("data-hf-kind", "");
+        kindSelect.title = "Which header/footer story to edit";
+        for (const k of KIND_LABELS) {
+            const opt = document.createElement("option");
+            opt.value = k.value;
+            opt.textContent = k.label;
+            kindSelect.appendChild(opt);
+        }
+        kindSelect.addEventListener("change", () => this.setKind(which, kindSelect.value));
+        chrome.appendChild(kindSelect);
+        const pageNum = document.createElement("select");
+        pageNum.setAttribute("data-hf-pagenum", "");
+        pageNum.title = "Insert a page-number field into the focused story paragraph";
+        for (const o of [
+            { value: "", label: "Page №…" },
+            { value: "currentPage", label: "Page number" },
+            { value: "totalPages", label: "Total pages" },
+        ]) {
+            const opt = document.createElement("option");
+            opt.value = o.value;
+            opt.textContent = o.label;
+            pageNum.appendChild(opt);
+        }
+        // The <select> steals focus from the story paragraph, collapsing the caret, so the target
+        // is resolved from the band's own blocks rather than from the editor's live selection.
+        pageNum.addEventListener("change", () => {
+            const field = pageNum.value;
+            pageNum.value = "";
+            if (field !== "currentPage" && field !== "totalPages")
+                return;
+            const target = this.pageNumberTarget(which);
+            if (target)
+                this.insertPageNumber(which, target, field);
+        });
+        chrome.appendChild(pageNum);
+        // Word's "Format Page Numbers…": these are SECTION properties (w:pgNumType), not properties of
+        // this band's story, so both bands show the same values and either can set them. An inserted
+        // page-number field is plain, so it renders through whatever is chosen here.
+        const pageFmt = document.createElement("select");
+        pageFmt.setAttribute("data-hf-pagefmt", "");
+        pageFmt.title = "Page-number format for this section";
+        for (const o of PAGE_FORMAT_LABELS) {
+            const opt = document.createElement("option");
+            opt.value = o.value;
+            opt.textContent = o.label;
+            pageFmt.appendChild(opt);
+        }
+        pageFmt.addEventListener("change", () => {
+            if (pageFmt.value === "")
+                return;
+            this.setPageNumbering({ format: pageFmt.value });
+        });
+        chrome.appendChild(pageFmt);
+        const pageStart = document.createElement("input");
+        pageStart.setAttribute("data-hf-pagestart", "");
+        pageStart.type = "number";
+        pageStart.min = "0";
+        pageStart.placeholder = "Start at";
+        pageStart.title = "Restart this section's page numbering at this number";
+        // Commit on blur/Enter, not on every keystroke: typing "12" would otherwise apply a start of 1
+        // first, and each apply is an undo step.
+        const commitStart = () => {
+            const raw = pageStart.value.trim();
+            if (raw === "")
+                return;
+            const start = Number(raw);
+            if (!Number.isInteger(start) || start < 0)
+                return;
+            this.setPageNumbering({ start });
+        };
+        pageStart.addEventListener("blur", commitStart);
+        pageStart.addEventListener("keydown", (e) => {
+            if (e.key === "Enter") {
+                e.preventDefault();
+                commitStart();
+            }
+        });
+        chrome.appendChild(pageStart);
+        const inheritedNote = document.createElement("span");
+        inheritedNote.className = "docx-hf-inherited";
+        inheritedNote.setAttribute("data-hf-inherited-note", "");
+        inheritedNote.hidden = true;
+        chrome.appendChild(inheritedNote);
+        band.appendChild(chrome);
+        const warning = document.createElement("div");
+        warning.className = "docx-hf-warning";
+        warning.setAttribute("data-hf-warning", "");
+        warning.hidden = true;
+        band.appendChild(warning);
+        const body = document.createElement("div");
+        body.className = "docx-hf-body";
+        body.setAttribute("data-hf-body", "");
+        band.appendChild(body);
+        return band;
+    }
+    /**
+     * Which story paragraph a page-number insert targets: the last one the user focused in this
+     * band if it is still attached, else the band's last paragraph (Word's convention — the page
+     * number goes at the end of the footer line).
+     */
+    pageNumberTarget(which) {
+        const body = this.bandFor(which).querySelector("[data-hf-body]");
+        if (!body)
+            return null;
+        const focused = body.querySelector('[data-hf-focused="true"][data-hf-anchor]');
+        const blocks = Array.from(body.querySelectorAll("[data-hf-anchor]"));
+        const target = focused ?? blocks[blocks.length - 1];
+        return target?.getAttribute("data-hf-anchor") ?? null;
+    }
+    renderBand(which) {
+        const band = this.bandFor(which);
+        const body = band.querySelector("[data-hf-body]");
+        if (!body)
+            return;
+        const kind = this.kinds[which];
+        const select = band.querySelector("[data-hf-kind]");
+        if (select && select.value !== kind)
+            select.value = kind;
+        // Section-level page numbering — the same values on both bands, seeded from the live sectPr so
+        // the chrome reports what the document says rather than what was last clicked.
+        const pageFmt = band.querySelector("[data-hf-pagefmt]");
+        if (pageFmt)
+            pageFmt.value = this.sectionInfo?.pageNumberFormat ?? "";
+        const pageStart = band.querySelector("[data-hf-pagestart]");
+        if (pageStart && document.activeElement !== pageStart) {
+            const start = this.sectionInfo?.pageNumberStart;
+            pageStart.value = start === undefined ? "" : String(start);
+        }
+        // A section that declares no reference of this kind shows the story it inherits from an
+        // earlier section. Say so: editing it changes BOTH sections, because they share one part.
+        const inherited = this.refFor(which, kind)?.inherited === true;
+        band.toggleAttribute("data-hf-inherited", inherited);
+        const note = band.querySelector("[data-hf-inherited-note]");
+        if (note) {
+            note.hidden = !inherited;
+            note.textContent = inherited ? "inherited from an earlier section" : "";
+        }
+        this.renderKindWarning(which);
+        body.innerHTML = "";
+        const partUri = this.partUriFor(which, kind);
+        if (!partUri) {
+            body.appendChild(this.placeholder(which, kind));
+            band.setAttribute("data-hf-empty", "true");
+            return;
+        }
+        band.removeAttribute("data-hf-empty");
+        const anchors = this.storyAnchors(partUri);
+        if (anchors.length === 0) {
+            body.appendChild(this.placeholder(which, kind));
+            return;
+        }
+        for (const anchorId of anchors) {
+            const el = this.renderStoryBlock(anchorId);
+            if (!el)
+                continue;
+            body.appendChild(el);
+            // Adopt BEFORE wiring: the editor resolves a block's anchor from `data-hf-anchor` first,
+            // because a story paragraph's content-addressed unid can collide with another part's.
+            this.adoptBlock(el, anchorId);
+            this.callbacks.wireBlock(el);
+        }
+    }
+    /**
+     * Mark a story paragraph as belonging to this region. The full anchor id is stamped alongside
+     * `data-anchor` (which carries only the bare unid, matching the body's convention) so band
+     * chrome can address the block without going through the editor's unid map. Called on first
+     * render AND after an incremental swap, which replaces the DOM node.
+     */
+    adoptBlock(el, anchorId) {
+        const body = this.blockRootOf(el);
+        if (!body)
+            return;
+        el.setAttribute("data-hf-anchor", anchorId);
+        if (el.dataset.hfAdopted === "true")
+            return;
+        el.dataset.hfAdopted = "true";
+        el.addEventListener("focus", () => {
+            body
+                .querySelectorAll("[data-hf-focused]")
+                .forEach((sib) => sib.removeAttribute("data-hf-focused"));
+            el.setAttribute("data-hf-focused", "true");
+        });
+    }
+    renderStoryBlock(anchorId) {
+        const html = this.bridge.RenderBlockHtml(this.handle, anchorId, this.options.cssPrefix, this.options.fabricateClasses);
+        if (html.charCodeAt(0) === 0x7b /* error object */)
+            return null;
+        return new DOMParser().parseFromString(html, "text/html").body
+            .firstElementChild;
+    }
+    placeholder(which, kind) {
+        const el = document.createElement("div");
+        el.className = "docx-hf-placeholder";
+        el.setAttribute("data-hf-placeholder", "");
+        const label = KIND_LABELS.find((k) => k.value === kind)?.label ?? kind;
+        el.textContent = `No ${label.toLowerCase()} ${which} — pick a kind to create one.`;
+        return el;
+    }
+    /**
+     * Surface the caveat that comes with the selected kind. Turning on first/even means those pages
+     * stop using the Default stories entirely, which bites hardest on the OTHER band: enabling an
+     * even header with no even footer leaves even pages footer-less, and enabling a first-page
+     * header with an empty first-page footer leaves page 1 footer-less. The note is shown whenever
+     * first/even is selected (the behavior change is real either way); the fix button appears only
+     * when the counterpart story is missing entirely, which is what a user almost always wants next.
+     */
+    renderKindWarning(which) {
+        const band = this.bandFor(which);
+        const warning = band.querySelector("[data-hf-warning]");
+        if (!warning)
+            return;
+        const kind = this.kinds[which];
+        if (kind === "default") {
+            warning.hidden = true;
+            warning.textContent = "";
+            return;
+        }
+        const other = which === "header" ? "footer" : "header";
+        warning.hidden = false;
+        warning.textContent = `${kind === "even" ? EVEN_WARNING : FIRST_WARNING} `;
+        if (this.partUriFor(other, kind))
+            return; // counterpart exists — nothing to offer
+        const fix = document.createElement("button");
+        fix.type = "button";
+        fix.setAttribute("data-hf-fix-counterpart", "");
+        fix.textContent = `Also create a ${kind === "even" ? "matching even" : "first-page"} ${other}`;
+        fix.addEventListener("click", () => {
+            this.setKind(other, kind);
+            this.renderKindWarning(which);
+        });
+        warning.appendChild(fix);
+    }
+}
+function parseResult(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return { success: false };
+    }
+}
+//# sourceMappingURL=editor-headerfooter.js.map

package/dist/editor-headerfooter.js.map

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

package/dist/editor-reconcile.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Unit-sequence diff for the editor's incremental structural repaint.
+ *
+ * After a structural op (insert table/row, footnote, delete block, undo/redo)
+ * the editor fetches the session's {@link RenderPlan} (`ListBlocks`) and diffs
+ * each container's unit sequence against the DOM's, so unchanged blocks keep
+ * their DOM nodes and only changed/created units re-render — replacing the
+ * whole-document remount that cost seconds on large documents.
+ *
+ * Pure functions only: DOM walking, rendering, and fallback policy live in
+ * `editor.ts` (`DocxEditor.reconcile`).
+ */
+/** One top-level render unit: a body block (`p`/`h`/`li`), one whole table
+ *  (`tbl`), or one footnote/endnote definition (`fn`/`en`). Mirrors the wire
+ *  shape of `DocxSessionBridge.ListBlocks`. `sig` (container units only) is a
+ *  content signature: a table or note keeps its unid when content INSIDE it
+ *  changes, so the diff tokens must include it or a changed container would be
+ *  kept stale. */
+export interface RenderUnit {
+    id: string;
+    kind: string;
+    sig?: string;
+}
+/** The diff token for a unit: unid plus the container content signature. The DOM
+ *  side composes the same token from a node's `data-anchor` + `data-render-sig`
+ *  stamp, so a container whose inside changed diffs as an in-place substitution. */
+export declare function tokenOf(unit: RenderUnit): string;
+/** Per-container render plan — the wire shape of `DocxSessionBridge.ListBlocks`. */
+export interface RenderPlan {
+    body: RenderUnit[];
+    footnotes: RenderUnit[];
+    endnotes: RenderUnit[];
+}
+export interface UnitDiff {
+    /** newIndex → oldIndex for units that keep their existing DOM node. */
+    keep: Map<number, number>;
+    /** Indices into the OLD DOM sequence whose nodes must be removed. */
+    removed: number[];
+    /** Indices into the NEW plan that need a fresh render. */
+    added: number[];
+    /**
+     * added/removed pairs that are an IN-PLACE change (same number of kept units
+     * on each side) — e.g. a text edit re-hashing a block's content-addressed
+     * unid. A substituted list item keeps its list position, so it renumbers no
+     * siblings and may reconcile where a pure li insert/remove may not.
+     */
+    substituted: Array<{
+        oldIndex: number;
+        newIndex: number;
+    }>;
+}
+/** unid ("a1b2…") from a full anchor id ("p:body:a1b2…"). */
+export declare function unidOf(id: string): string;
+/**
+ * LCS diff of the DOM's unit-token sequence against the new plan's. Old entries
+ * are tokens (see {@link tokenOf} — bare unids for leaf blocks, `unid|sig` for
+ * containers). Equal tokens are interchangeable (content-addressed: equal token
+ * ⇒ equal content ⇒ equal rendering, up to position-dependent chrome the caller
+ * handles). O(n·m) — sequences are document block counts, a few hundred.
+ */
+export declare function diffUnits(oldUnids: string[], newUnits: RenderUnit[]): UnitDiff;
+/**
+ * Whether this diff must fall back to a full remount:
+ *  - a PURE li insert or removal (not an in-place substitution) — sibling list
+ *    items renumber without their own XML changing, which a unit diff cannot see;
+ *  - total churn above `threshold` (a remount is cheaper and simpler than
+ *    rendering half the document block-by-block).
+ *
+ * `oldKinds[i]` is the kind of the old sequence's i-th unit (the DOM knows it).
+ * An li substitution deliberately does NOT force a remount — its list position
+ * is unchanged; the CALLER must still verify its list facts (numId/ilvl)
+ * survived, and remount when they changed.
+ */
+export declare function needsRemount(diff: UnitDiff, newUnits: RenderUnit[], oldKinds: string[], threshold?: number): boolean;
+//# sourceMappingURL=editor-reconcile.d.ts.map

package/dist/editor-reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-reconcile.d.ts","sourceRoot":"","sources":["../src/editor-reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;kBAKkB;AAClB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;oFAEoF;AACpF,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEhD;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,QAAQ,CA8D9E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,SAAK,GACb,OAAO,CAWT"}