wordinweb 0.1.8 → 0.1.9

package/README.md

@@ -14,7 +14,7 @@ Editing is in an Alpha state and is strictly opt-in via the `editable` flag; the
 
 If you discover an edge case or perf issue create an issue and include the offending Word file.
 
-Part of the broader roadmap is to migrate away from DOM rendering to canvas rendering, or a hybrid of the two. Editing performance can suffer on very long documents.
+Long-document performance work focuses on incremental parsing/layout and page virtualization; the current renderer remains DOM-based.
 
 ---
 

package/dist/index.d.ts

@@ -1245,16 +1245,24 @@ declare class DocxDocument {
      * stable across a plain text edit). */
     layoutGlobalSig(): string;
     refresh(): void;
-    /**
-     * Reparse the two direct body paragraphs created by Enter without rebuilding
-     * the complete document model. This deliberately covers only the simple
-     * single-section body case used by incremental pagination; structural
-     * containers, revisions, bookmarks, and section breaks use refresh().
-     */
+    /** Reparse the two sibling body-story paragraphs created by Enter without
+     * rebuilding the complete document model. Paragraphs nested in table cells
+     * are included because legal documents spend most of their body inside
+     * tables; revisions, bookmarks, fields, and section breaks use refresh(). */
     reparseDirectBodyParagraphSplit(beforeSource: XmlElement, afterSource: XmlElement): {
         before: Paragraph;
         after: Paragraph;
     } | null;
+    /** Reparse a body paragraph plus several new siblings created by
+     * click-and-type without rebuilding the complete document model. */
+    reparseDirectBodyParagraphSplits(beforeSource: XmlElement, afterSources: XmlElement[]): Paragraph[] | null;
+    /** Reparse one retained body-story paragraph after a structural edit that
+     * leaves its surrounding block list unchanged, such as inserting ink. */
+    reparseBodyParagraph(source: XmlElement): Paragraph | null;
+    /** Reparse two sibling body-story paragraphs after Backspace/Delete merged
+     * their XML into one. Keeps the parsed model generation stable so long
+     * documents can use incremental layout instead of repaginating in full. */
+    reparseDirectBodyParagraphMerge(beforeSource: XmlElement, afterSource: XmlElement, survivorSource: XmlElement): Paragraph | null;
     private deriveComments;
     /** Retained comments tree for edit commands (null when the doc has none). */
     /**
@@ -1792,10 +1800,8 @@ interface LayoutOptions {
      * type/delete. Lets the incremental scan skip re-hashing every block: it
      * re-hashes only the hinted block and its two neighbours and reuses prev's
      * per-block signatures for the rest. Purely an optimisation — the fast path
-     * is gated on block-count parity and neighbour-signature checks, so a stale,
-     * structural, or wrong hint falls through to the full block scan. Absent for
-     * multi-block edits (paste, paragraph split/merge, undo/redo, structural ops),
-     * which take the full scan. */
+     * is gated on block identity/count and neighbour-signature checks, so a stale
+     * or wrong hint falls through to the full block scan. */
     dirtyHint?: XmlElement;
     /** Exact retained text element changed by a local edit. Used only to bound
      * structural page comparison before the first actually dirty page. */