@a3s-lab/office 0.8.1 → 0.9.1

package/COLLABORATION_ROADMAP.md

@@ -247,9 +247,9 @@ comments, and delete-vs-edit cases converge and survive PPTX round trips.
 
 ### Phase 4: Spreadsheet
 
-Status: browser collaboration foundation and native conflict-local cell
-mutations implemented; structural operations, native recalculation parity, and
-XLSX concurrency coverage are pending.
+Status: browser collaboration foundation plus native conflict-local single-cell
+and atomic batch-cell mutations implemented; structural operations, native
+recalculation parity, and XLSX concurrency coverage are pending.
 
 - Stable sheet/named-range order arrays, ID-keyed records, and append-only
   creation claims avoid a serialized workbook or dense worksheet root.
@@ -282,11 +282,16 @@ XLSX concurrency coverage are pending.
   and an empty sheet's first write stays sparse. Native restart, real CLI/MCP
   subprocesses, and browser Yjs duplicate/reordered delivery cover the same
   update contract.
+- `spreadsheet-batch-cells` translates one paste, fill, or other bounded user
+  gesture into 1 to 4,096 distinct coordinates in one sheet and one Yjs
+  transaction. Set/create changes retain recursive optimistic guards; delete
+  changes require an exact complete observed cell. Every change is preflighted
+  against one shared sheet snapshot, so one conflict rejects the entire batch
+  without partial fields, presence markers, dense dimensions, or durable log
+  growth. Single-cell mutations use this same kernel.
 
 Remaining:
 
-- Translate one user gesture into one transaction; batch paste/fill/sort/filter
-  without emitting a document-sized replacement.
 - Add stable structural operations and reference transforms for row/column
   insertion/deletion, merged ranges, tables, sort, and named references.
 - Treat calculated values as derived once browser and native recalculation are
@@ -461,9 +466,10 @@ are pending.
   without replacing the full document.
 - Spreadsheet cell mutations create or recursively patch one zero-based
   coordinate after matching the caller's observed cell, or delete it only after
-  an exact complete-cell match. They preserve the browser's field-addressed
-  representation, dense/sparse projection mode, and atomic fail-closed
-  semantics without replacing a worksheet or workbook.
+  an exact complete-cell match. `spreadsheet-batch-cells` applies 1 to 4,096
+  distinct changes from one sheet snapshot in one transaction. They preserve
+  the browser's field-addressed representation, dense/sparse projection mode,
+  and atomic fail-closed semantics without replacing a worksheet or workbook.
 - Presentation scene-element mutations create, update, move, or tombstone one
   stable object inside a slide, master, or layout. Canonical creation claims
   prevent conflicting same-ID reuse, optimistic top-level field guards merge

package/README.md

@@ -144,7 +144,7 @@ The images below are committed visual-regression baselines from the real
 - **Automation outside the browser** — The native Rust CLI, standard MCP
   server, and Office Skill share bounded mutation contracts. Coding agents can
   also keep a durable Yrs replica, exchange standard Yjs v1 updates and state
-  vectors, perform authorized typed Markdown, Document, Spreadsheet cell,
+  vectors, perform authorized typed Markdown, Document, Spreadsheet cell/batch,
   Presentation scene-element and z-order, and PDF annotation, form-value, and
   review changes, including attributable Document selection comments, replies,
   text suggestions, and atomic final decisions, retain browser/native actor
@@ -415,7 +415,10 @@ interaction model.
   edit/preview/PDF typography and page-chrome placement. Editing, read-only
   preview, and browser PDF export share one live pagination result. Tail edits
   reuse the stable physical-page prefix, including resolved first/odd/even
-  headers, footers, page numbers, and navigation descriptors.
+  headers, footers, page numbers, and navigation descriptors. Browser DOM
+  measurement runs in bounded 32 ms slices and yields only between top-level
+  blocks; document edits abort stale passes before a snapshot is committed, so
+  long repagination work does not monopolize the browser event loop.
   Real DOCX fixtures provide deterministic A3S Test evidence for inherited
   table styling across edit and preview, a centered 62.5% table with table and
   cell margin overrides, all four Table Properties tabs at 390 px, exact
@@ -1109,6 +1112,13 @@ cargo run -p a3s-office-cli -- collab mutate .a3s/plan.replica \
   --operation-id edit-45 \
   --mutation '{"type":"spreadsheet-set-cell","sheetId":"sheet-data","row":1,"column":0,"expectedCell":{"v":10,"m":"10"},"nextCell":{"v":12,"m":"12","f":"=6*2"}}' --json
 
+# Apply one bounded Spreadsheet gesture atomically. Coordinates must be unique;
+# nextCell:null is an exact guarded delete.
+cargo run -p a3s-office-cli -- collab mutate .a3s/plan.replica \
+  --artifact-id plan --kind spreadsheet --actor-id agent-7 --mode edit \
+  --operation-id paste-46 \
+  --mutation '{"type":"spreadsheet-batch-cells","sheetId":"sheet-data","changes":[{"row":1,"column":0,"expectedCell":{"v":12,"m":"12","f":"=6*2"},"nextCell":{"v":14,"m":"14","f":"=7*2"}},{"row":1,"column":1,"expectedCell":null,"nextCell":{"v":20,"m":"20"}},{"row":2,"column":0,"expectedCell":{"v":"obsolete","m":"obsolete"},"nextCell":null}]}' --json
+
 # Update one Presentation scene element after matching the complete observed
 # record. Create/delete use presentation-create/delete-element.
 cargo run -p a3s-office-cli -- collab mutate .a3s/deck.replica \
@@ -1197,7 +1207,11 @@ write only changed leaves, so unrelated concurrent value, formula, style,
 hyperlink, note, and metadata edits merge. Use `expectedCell: null` only when
 creating an observed blank coordinate. Spreadsheet deletion requires the exact
 complete current cell, dense projections keep their dimensions, and sparse or
-empty sheets remain sparse. Presentation creation writes one complete element
+empty sheets remain sparse. `spreadsheet-batch-cells` applies 1 to 4,096
+distinct coordinates in one sheet after checking every guard against the same
+snapshot, then writes fields, presence markers, and dense dimensions in one
+Yjs transaction. One conflict rejects the complete gesture without a durable
+event. Presentation creation writes one complete element
 plus a canonical immutable claim inside a slide, master, or layout and can
 place it after a stable active element. Presentation update compares complete
 expected/current/next elements and writes only changed top-level fields, so
@@ -1309,6 +1323,8 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.9.1 documentation](https://a3s-lab.github.io/Office/docs/0.9.1/)
+- [A3S Office 0.9.0 documentation](https://a3s-lab.github.io/Office/docs/0.9.0/)
 - [A3S Office 0.8.1 documentation](https://a3s-lab.github.io/Office/docs/0.8.1/)
 - [A3S Office 0.8.0 documentation](https://a3s-lab.github.io/Office/docs/0.8.0/)
 - [A3S Office 0.7.3 documentation](https://a3s-lab.github.io/Office/docs/0.7.3/)

package/dist/0~document-editor.js

@@ -19,7 +19,7 @@ import { TableMap, isInTable, selectedRect } from "@tiptap/pm/tables";
 import { useOfficeTaskPaneEscape, normalizeOfficeFontFamily, OfficeCheckbox, useOfficeDialog, useOfficeTaskPaneModal, CommittedOfficeNumberField, officeFontFamilyLabel, officeFontFamilies, CollectionState, createOfficeKernelClient, OfficeNumberField } from "./0~7048.js";
 import { office_text_field_OfficeTextArea, Popover, officeOverlayPortalRoot, button_Button, useOfficePublishPresenceLocation, OfficeTiptapPresenceLayer, icon_button_IconButton, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom, office_text_field_OfficeFileInput } from "./0~6090.js";
 import { WorkOfficePreviewBar, isWorkspaceContextMenuKeyboardEvent, Tabs, WorkOfficeZoomControls, WorkOfficeStatusBar, Dialog, WorkOfficeRibbon, workspaceContextMenuPosition, OfficeSelect, WorkspaceContextMenu, WorkOfficeRibbonGroup, WorkOfficeRibbonButton } from "./0~4595.js";
-import { documentTableSizing, documentTableRowOptions, documentCommentViews, documentParagraphSpacing, documentPageBordersVisible, DOCUMENT_PAGE_BORDER_EDGES, normalizeDocumentColumns, clampDocumentMargin, normalizeDocumentTabStops, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, createWorkDocumentModel, nextDocumentTabAlignment, documentBookmarkNameExists, normalizedTabPosition, DocumentImage, collectDocumentChanges, documentCitationCount, isDocumentParagraphArtBorderStyle, resolveDocumentPageMargins, updateDocumentPageMarginMode, resolveDocumentPageBorders, canSetDocumentTableRowRepeatHeader, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, retainAnchoredDocumentComments, measureDocumentLayoutBlocks, DocumentTableRowIdentity, work_document_page_margins_twipsToMillimeters, DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, resolveWorkDocumentEditorInput, collectDocumentTextLayoutParagraphs, millimetersToPixels as work_document_layout_millimetersToPixels, documentBulletListStyle, readOfficeDocumentCollaboration as readWorkOfficeDocumentCollaboration, documentTabLeaderLabel, documentOrderedListState, normalizeDocumentPageChrome, documentPageMarginsForLayout, documentTableCellFormat, updateDocumentCustomPageMillimeters, documentCommentDraftRange, normalizeDocumentPageGeometry, documentParagraphTabStops, normalizeDocumentImageLayer, documentImageProperties, documentParagraphIndent, documentTableHorizontalAlignment, isValidDocumentCitationTag, canInsertDocumentComment, sanitizeDocumentPageChromeHtml, pageTwipsToMillimeters, normalizeDocumentPageBorders, DocumentParagraphFormatting, activeDocumentSection, documentTextLayoutBatches, normalizeDocumentImageWrapSide, normalizeDocumentHtml, documentParagraphDirection, documentParagraphPagination, updateDocumentPageOrientation, documentCitationStyleDetails, documentInitialSectionLayout, documentPageChromeLegacyFields, setCustomDocumentColumns, collectDocumentCommentAnchors, documentCitationStyle, updateDocumentPageMarginMillimeters, canChangeDocumentIndent, validateDocumentBookmarkName, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DocumentSuperscript, documentSectionById, DOCUMENT_TABLE_STYLE_OPTIONS, updateDocumentColumnWidth, updateDocumentPaperSizePreset, DocumentEquation, documentPageMetrics, normalizeDocumentParagraphIndent, updateDocumentGutterPosition, mountWorkLiveDocumentCapture, activeDocumentBookmark, createDocumentBibliography, DocumentSubscript, DocumentParagraphIdentity, syncDocumentContentFromHtml, updateDocumentPageChromeVariant, editorDocumentCaptionTargets, resolveDocumentPageChrome, updateDocumentMirrorMargins, documentImageLayoutOptions, MAX_DOCUMENT_NUMBERING_START, resolveDocumentPageSize, activeDocumentTableStyle, editorDocumentBookmarkReferenceTargets, createOfficeDocumentCollaborationBinding as createWorkOfficeDocumentCollaborationBinding, createWorkDocumentExtensions } from "./8928.js";
+import { documentTableSizing, documentTableRowOptions, documentCommentViews, documentParagraphSpacing, documentPageBordersVisible, DOCUMENT_PAGE_BORDER_EDGES, normalizeDocumentColumns, clampDocumentMargin, normalizeDocumentTabStops, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, createWorkDocumentModel, nextDocumentTabAlignment, documentBookmarkNameExists, normalizedTabPosition, DocumentImage, collectDocumentChanges, documentCitationCount, isDocumentParagraphArtBorderStyle, resolveDocumentPageMargins, updateDocumentPageMarginMode, resolveDocumentPageBorders, canSetDocumentTableRowRepeatHeader, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, retainAnchoredDocumentComments, DocumentTableRowIdentity, work_document_page_margins_twipsToMillimeters, DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, resolveWorkDocumentEditorInput, collectDocumentTextLayoutParagraphs, millimetersToPixels as work_document_layout_millimetersToPixels, documentBulletListStyle, readOfficeDocumentCollaboration as readWorkOfficeDocumentCollaboration, documentTabLeaderLabel, documentOrderedListState, normalizeDocumentPageChrome, documentPageMarginsForLayout, documentTableCellFormat, updateDocumentCustomPageMillimeters, documentCommentDraftRange, normalizeDocumentPageGeometry, documentParagraphTabStops, normalizeDocumentImageLayer, documentImageProperties, documentParagraphIndent, documentTableHorizontalAlignment, isValidDocumentCitationTag, canInsertDocumentComment, sanitizeDocumentPageChromeHtml, pageTwipsToMillimeters, normalizeDocumentPageBorders, DocumentParagraphFormatting, activeDocumentSection, documentTextLayoutBatches, normalizeDocumentImageWrapSide, normalizeDocumentHtml, documentParagraphDirection, documentParagraphPagination, updateDocumentPageOrientation, documentCitationStyleDetails, documentInitialSectionLayout, documentPageChromeLegacyFields, setCustomDocumentColumns, collectDocumentCommentAnchors, documentCitationStyle, updateDocumentPageMarginMillimeters, canChangeDocumentIndent, validateDocumentBookmarkName, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DocumentSuperscript, documentSectionById, DOCUMENT_TABLE_STYLE_OPTIONS, updateDocumentColumnWidth, updateDocumentPaperSizePreset, DocumentEquation, documentPageMetrics, normalizeDocumentParagraphIndent, updateDocumentGutterPosition, mountWorkLiveDocumentCapture, activeDocumentBookmark, createDocumentBibliography, DocumentSubscript, DocumentParagraphIdentity, syncDocumentContentFromHtml, updateDocumentPageChromeVariant, editorDocumentCaptionTargets, resolveDocumentPageChrome, updateDocumentMirrorMargins, documentImageLayoutOptions, MAX_DOCUMENT_NUMBERING_START, resolveDocumentPageSize, activeDocumentTableStyle, editorDocumentBookmarkReferenceTargets, createOfficeDocumentCollaborationBinding as createWorkOfficeDocumentCollaborationBinding, measureDocumentLayoutBlocksIncrementally, createWorkDocumentExtensions } from "./8928.js";
 import { createOfficeId as createWorkId } from "./5184.js";
 import { normalizeDocumentHref, DOCUMENT_LINK_VALIDATION_MESSAGE } from "./0~work-document-links.js";
 import { OfficeColorPicker, isOfficeShortcutBlocked } from "./0~3635.js";
@@ -13382,6 +13382,44 @@ function incrementalBoundaryBreak(previous, next) {
         spacerHeight: remainingBodyHeight + previous.page.marginBottom + previous.page.pageGap + next.page.marginTop
     };
 }
+function createDocumentPaginationMeasurementRange() {
+    let activePass = null;
+    let dirtyFrom = 0;
+    const restore = (pass)=>{
+        if (activePass !== pass) return;
+        dirtyFrom = Math.min(dirtyFrom, pass.from);
+        activePass = null;
+    };
+    return {
+        begin: ()=>{
+            const pass = {
+                from: Number.isFinite(dirtyFrom) ? dirtyFrom : 0
+            };
+            activePass = pass;
+            dirtyFrom = 1 / 0;
+            return pass;
+        },
+        commit: (pass)=>{
+            if (activePass === pass) activePass = null;
+        },
+        ensureDirty: ()=>{
+            if (Number.isFinite(dirtyFrom)) return;
+            dirtyFrom = activePass?.from ?? 0;
+        },
+        invalidate: (position)=>{
+            const normalizedPosition = Number.isFinite(position) ? Math.max(0, position) : 0;
+            dirtyFrom = Math.min(dirtyFrom, normalizedPosition);
+        },
+        reset: ()=>{
+            activePass = null;
+            dirtyFrom = 0;
+        },
+        restore,
+        restoreActive: ()=>{
+            if (activePass) restore(activePass);
+        }
+    };
+}
 function createDocumentPaginationRunCoordinator({ cancelFrame, onAbort, onCoalescedRequest, onError, onRunFinish, onRunStart, requestFrame, run }) {
     let activeController = null;
     let disposed = false;
@@ -13455,7 +13493,9 @@ function useDocumentPagination({ editor, documentRevision, enabled, layoutKey, p
     const paginationCache = useRef(null);
     const measurementEditor = useRef(null);
     const measurementLayoutKey = useRef('');
-    const dirtyMeasurementFrom = useRef(0);
+    const measurementRangeRef = useRef(null);
+    measurementRangeRef.current ??= createDocumentPaginationMeasurementRange();
+    const measurementRange = measurementRangeRef.current;
     const observedDocumentRevision = useRef(documentRevision);
     const [pagination, setPagination] = useState(null);
     const pageKey = pageMetricsKey(page);
@@ -13470,10 +13510,10 @@ function useDocumentPagination({ editor, documentRevision, enabled, layoutKey, p
             paginationCache.current = null;
             measurementEditor.current = editor;
             measurementLayoutKey.current = measurementKey;
-            dirtyMeasurementFrom.current = 0;
+            measurementRange.reset();
         }
         if (observedDocumentRevision.current !== documentRevision) {
-            if (!Number.isFinite(dirtyMeasurementFrom.current)) dirtyMeasurementFrom.current = 0;
+            measurementRange.ensureDirty();
             observedDocumentRevision.current = documentRevision;
         }
         if (!editor || !editorMounted || editor.isDestroyed || !enabled || !client) {
@@ -13518,7 +13558,7 @@ function useDocumentPagination({ editor, documentRevision, enabled, layoutKey, p
             if (!enabled) {
                 measurementCache.current = null;
                 paginationCache.current = null;
-                dirtyMeasurementFrom.current = 0;
+                measurementRange.reset();
             }
             setPagination(null);
             return;
@@ -13586,143 +13626,155 @@ function useDocumentPagination({ editor, documentRevision, enabled, layoutKey, p
             editorDom.dataset.paginationReusedPageChrome = '0';
             editorDom.dataset.paginationDerivedPageChrome = '0';
             delete editorDom.dataset.paginationError;
-            const measurementStart = dirtyMeasurementFrom.current;
-            dirtyMeasurementFrom.current = 1 / 0;
-            const textLayoutCollection = collectDocumentTextLayoutParagraphs(editor, layoutFonts, loadedLayoutFontIds, measurementCache.current, measurementStart);
-            editorDom.dataset.paginationTextCandidates = String(textLayoutCollection.paragraphs.length);
-            editorDom.dataset.paginationTextRuns = String(textLayoutCollection.paragraphs.reduce((count, paragraph)=>count + paragraph.runs.length, 0));
-            const textLayouts = new Map();
-            let fallbackGlyphCount = 0;
-            if (textLayoutCollection.paragraphs.length) {
-                editorDom.dataset.paginationState = 'shaping';
-                try {
-                    let textLayoutEngine = '';
-                    let unsupportedTextLayoutCount = 0;
-                    const textLayoutBatches = documentTextLayoutBatches(textLayoutCollection.paragraphs);
-                    editorDom.dataset.paginationTextBatches = String(textLayoutBatches.length);
-                    for (const [batchIndex, paragraphs] of textLayoutBatches.entries()){
-                        editorDom.dataset.paginationTextBatch = String(batchIndex + 1);
-                        const textLayout = await client.textLayout({
-                            revision: nextRevision,
-                            documentRevision,
-                            paragraphs
-                        }, signal);
-                        if (disposed || signal.aborted || nextRevision !== revision.current || editor.isDestroyed) return;
-                        textLayoutEngine ||= textLayout.engine;
-                        unsupportedTextLayoutCount += textLayout.unsupportedParagraphIds.length + textLayout.layouts.filter((layout)=>layout.missingGlyphCount > 0).length;
-                        for (const layout of textLayout.layouts)if (0 === layout.missingGlyphCount) {
-                            textLayouts.set(layout.id, layout);
-                            fallbackGlyphCount += layout.fallbackGlyphCount;
+            const measurementPass = measurementRange.begin();
+            const measurementStart = measurementPass.from;
+            try {
+                const textLayoutCollection = collectDocumentTextLayoutParagraphs(editor, layoutFonts, loadedLayoutFontIds, measurementCache.current, measurementStart);
+                editorDom.dataset.paginationTextCandidates = String(textLayoutCollection.paragraphs.length);
+                editorDom.dataset.paginationTextRuns = String(textLayoutCollection.paragraphs.reduce((count, paragraph)=>count + paragraph.runs.length, 0));
+                const textLayouts = new Map();
+                let fallbackGlyphCount = 0;
+                if (textLayoutCollection.paragraphs.length) {
+                    editorDom.dataset.paginationState = 'shaping';
+                    try {
+                        let textLayoutEngine = '';
+                        let unsupportedTextLayoutCount = 0;
+                        const textLayoutBatches = documentTextLayoutBatches(textLayoutCollection.paragraphs);
+                        editorDom.dataset.paginationTextBatches = String(textLayoutBatches.length);
+                        for (const [batchIndex, paragraphs] of textLayoutBatches.entries()){
+                            editorDom.dataset.paginationTextBatch = String(batchIndex + 1);
+                            const textLayout = await client.textLayout({
+                                revision: nextRevision,
+                                documentRevision,
+                                paragraphs
+                            }, signal);
+                            if (disposed || signal.aborted || nextRevision !== revision.current || editor.isDestroyed) return;
+                            textLayoutEngine ||= textLayout.engine;
+                            unsupportedTextLayoutCount += textLayout.unsupportedParagraphIds.length + textLayout.layouts.filter((layout)=>layout.missingGlyphCount > 0).length;
+                            for (const layout of textLayout.layouts)if (0 === layout.missingGlyphCount) {
+                                textLayouts.set(layout.id, layout);
+                                fallbackGlyphCount += layout.fallbackGlyphCount;
+                            }
                         }
+                        editorDom.dataset.paginationTextEngine = textLayoutEngine;
+                        editorDom.dataset.paginationUnsupportedText = String(unsupportedTextLayoutCount);
+                    } catch (error) {
+                        if (signal.aborted || error instanceof DOMException && 'AbortError' === error.name) return;
+                        textLayouts.clear();
+                        fallbackGlyphCount = 0;
+                        editorDom.dataset.paginationTextEngine = 'dom';
+                        editorDom.dataset.paginationUnsupportedText = String(textLayoutCollection.paragraphs.length);
                     }
-                    editorDom.dataset.paginationTextEngine = textLayoutEngine;
-                    editorDom.dataset.paginationUnsupportedText = String(unsupportedTextLayoutCount);
-                } catch (error) {
-                    if (signal.aborted || error instanceof DOMException && 'AbortError' === error.name) return;
-                    textLayouts.clear();
-                    fallbackGlyphCount = 0;
+                } else {
                     editorDom.dataset.paginationTextEngine = 'dom';
-                    editorDom.dataset.paginationUnsupportedText = String(textLayoutCollection.paragraphs.length);
+                    editorDom.dataset.paginationUnsupportedText = '0';
+                    editorDom.dataset.paginationTextBatch = '0';
+                    editorDom.dataset.paginationTextBatches = '0';
                 }
-            } else {
-                editorDom.dataset.paginationTextEngine = 'dom';
-                editorDom.dataset.paginationUnsupportedText = '0';
-                editorDom.dataset.paginationTextBatch = '0';
-                editorDom.dataset.paginationTextBatches = '0';
-            }
-            editorDom.dataset.paginationShapedParagraphs = String(textLayouts.size);
-            editorDom.dataset.paginationFallbackGlyphs = String(fallbackGlyphCount);
-            editorDom.dataset.paginationShapedRuns = String(textLayoutCollection.paragraphs.reduce((count, paragraph)=>count + (textLayouts.has(paragraph.id) ? paragraph.runs.length : 0), 0));
-            const snapshot = measureDocumentLayoutBlocks(editor, measurementCache.current, measurementStart, textLayouts);
-            measurementCache.current = snapshot;
-            editorDom.dataset.paginationBlocks = String(snapshot.blocks.length);
-            editorDom.dataset.paginationFlows = String(new Set(snapshot.blocks.flatMap((block)=>block.block.flowId ? [
-                    block.block.flowId
-                ] : [])).size);
-            editorDom.dataset.paginationMeasuredBlocks = String(snapshot.measuredBlockCount);
-            editorDom.dataset.paginationReusedBlocks = String(snapshot.reusedBlockCount);
-            if (snapshot.unsupportedLayout || !snapshot.blocks.length) {
-                observeBlocks(snapshot.blocks);
-                editorDom.dataset.paginationState = snapshot.unsupportedLayout ? 'unsupported' : 'empty';
-                setPagination(null);
-                paginationCache.current = null;
-                return;
-            }
-            const previousPagination = paginationCache.current;
-            const layoutPlan = planIncrementalDocumentLayout(previousPagination, snapshot.blocks, measurementStart);
-            editorDom.dataset.paginationLaidOutBlocks = String(layoutPlan.blocks.length);
-            editorDom.dataset.paginationReusedPages = String(layoutPlan.reusedPageCount);
-            try {
-                editorDom.dataset.paginationState = 'layout';
-                const partialLayout = await client.layout({
-                    revision: nextRevision,
-                    documentRevision,
-                    startPageIndex: layoutPlan.startPageIndex,
-                    page,
-                    pageStyles: snapshot.pageStyles,
-                    blocks: layoutPlan.blocks
-                }, signal);
-                if (disposed || signal.aborted || nextRevision !== revision.current || editor.isDestroyed) return;
-                const layout = previousPagination && layoutPlan.startPageIndex > 0 ? mergeIncrementalDocumentLayout(previousPagination.layout, partialLayout) : partialLayout;
-                const blockById = new Map(snapshot.blocks.map((block)=>[
-                        block.block.id,
-                        block
-                    ]));
-                const pageDescriptorDerivation = deriveDocumentPaginationPageDescriptors(layout, snapshot.blocks, editor.state.doc, previousPagination?.pages, layoutPlan.reusedPageCount);
-                const pages = pageDescriptorDerivation.pages;
-                editorDom.dataset.paginationReusedPageChrome = String(pageDescriptorDerivation.reusedPageCount);
-                editorDom.dataset.paginationDerivedPageChrome = String(pageDescriptorDerivation.derivedPageCount);
-                const pageByIndex = new Map(pages.map((descriptor)=>[
-                        descriptor.pageIndex,
-                        descriptor
-                    ]));
-                editor.commands.applyDocumentPagination(nextRevision, layout.breaks.flatMap((pageBreak)=>{
-                    const block = blockById.get(pageBreak.beforeBlockId);
-                    return block ? [
-                        {
-                            ...pageBreak,
-                            previousPage: pageByIndex.get(pageBreak.pageIndex - 1)?.page ?? layout.pages[pageBreak.pageIndex - 1]?.page ?? page,
-                            nextPage: pageByIndex.get(pageBreak.pageIndex)?.page ?? layout.pages[pageBreak.pageIndex]?.page ?? page,
-                            position: block.from,
-                            inlineOffsetLeft: block.inlineOffsetLeft,
-                            inlineOffsetRight: block.inlineOffsetRight,
-                            previousPageChrome: visualPageChrome(pageByIndex.get(pageBreak.pageIndex - 1)),
-                            nextPageChrome: visualPageChrome(pageByIndex.get(pageBreak.pageIndex)),
-                            tableBreak: block.tableBreak
-                        }
-                    ] : [];
-                }));
-                observeBlocks(snapshot.blocks);
-                editorDom.dataset.paginationEngine = layout.engine;
-                editorDom.dataset.paginationDocumentRevision = String(layout.documentRevision);
-                editorDom.dataset.paginationPages = String(layout.pages.length);
-                editorDom.dataset.paginationState = 'ready';
-                delete editorDom.dataset.paginationError;
-                const nextPagination = {
-                    layout,
-                    blocks: snapshot.blocks,
-                    pages,
-                    pageByBlockId: new Map(layout.pages.flatMap((page)=>page.placements.map((placement)=>[
-                                placement.blockId,
-                                page.index + 1
-                            ])))
-                };
-                paginationCache.current = nextPagination;
-                setPagination(nextPagination);
-            } catch (error) {
-                if (disposed || signal.aborted || error instanceof DOMException && 'AbortError' === error.name) return;
-                editorDom.dataset.paginationState = 'error';
-                editorDom.dataset.paginationError = error instanceof Error ? `${error.name}: ${error.message}` : 'UnknownError';
-                editor.commands.clearDocumentPagination(nextRevision);
-                paginationCache.current = null;
-                setPagination(null);
+                editorDom.dataset.paginationShapedParagraphs = String(textLayouts.size);
+                editorDom.dataset.paginationFallbackGlyphs = String(fallbackGlyphCount);
+                editorDom.dataset.paginationShapedRuns = String(textLayoutCollection.paragraphs.reduce((count, paragraph)=>count + (textLayouts.has(paragraph.id) ? paragraph.runs.length : 0), 0));
+                const snapshot = await measureDocumentLayoutBlocksIncrementally(editor, measurementCache.current, measurementStart, textLayouts, 1000000, {
+                    signal
+                });
+                measurementCache.current = snapshot;
+                editorDom.dataset.paginationBlocks = String(snapshot.blocks.length);
+                editorDom.dataset.paginationFlows = String(new Set(snapshot.blocks.flatMap((block)=>block.block.flowId ? [
+                        block.block.flowId
+                    ] : [])).size);
+                editorDom.dataset.paginationMeasuredBlocks = String(snapshot.measuredBlockCount);
+                editorDom.dataset.paginationReusedBlocks = String(snapshot.reusedBlockCount);
+                if (snapshot.unsupportedLayout || !snapshot.blocks.length) {
+                    observeBlocks(snapshot.blocks);
+                    editorDom.dataset.paginationState = snapshot.unsupportedLayout ? 'unsupported' : 'empty';
+                    setPagination(null);
+                    paginationCache.current = null;
+                    measurementRange.commit(measurementPass);
+                    return;
+                }
+                const previousPagination = paginationCache.current;
+                const layoutPlan = planIncrementalDocumentLayout(previousPagination, snapshot.blocks, measurementStart);
+                editorDom.dataset.paginationLaidOutBlocks = String(layoutPlan.blocks.length);
+                editorDom.dataset.paginationReusedPages = String(layoutPlan.reusedPageCount);
+                try {
+                    editorDom.dataset.paginationState = 'layout';
+                    const partialLayout = await client.layout({
+                        revision: nextRevision,
+                        documentRevision,
+                        startPageIndex: layoutPlan.startPageIndex,
+                        page,
+                        pageStyles: snapshot.pageStyles,
+                        blocks: layoutPlan.blocks
+                    }, signal);
+                    if (disposed || signal.aborted || nextRevision !== revision.current || editor.isDestroyed) return;
+                    const layout = previousPagination && layoutPlan.startPageIndex > 0 ? mergeIncrementalDocumentLayout(previousPagination.layout, partialLayout) : partialLayout;
+                    const blockById = new Map(snapshot.blocks.map((block)=>[
+                            block.block.id,
+                            block
+                        ]));
+                    const pageDescriptorDerivation = deriveDocumentPaginationPageDescriptors(layout, snapshot.blocks, editor.state.doc, previousPagination?.pages, layoutPlan.reusedPageCount);
+                    const pages = pageDescriptorDerivation.pages;
+                    editorDom.dataset.paginationReusedPageChrome = String(pageDescriptorDerivation.reusedPageCount);
+                    editorDom.dataset.paginationDerivedPageChrome = String(pageDescriptorDerivation.derivedPageCount);
+                    const pageByIndex = new Map(pages.map((descriptor)=>[
+                            descriptor.pageIndex,
+                            descriptor
+                        ]));
+                    editor.commands.applyDocumentPagination(nextRevision, layout.breaks.flatMap((pageBreak)=>{
+                        const block = blockById.get(pageBreak.beforeBlockId);
+                        return block ? [
+                            {
+                                ...pageBreak,
+                                previousPage: pageByIndex.get(pageBreak.pageIndex - 1)?.page ?? layout.pages[pageBreak.pageIndex - 1]?.page ?? page,
+                                nextPage: pageByIndex.get(pageBreak.pageIndex)?.page ?? layout.pages[pageBreak.pageIndex]?.page ?? page,
+                                position: block.from,
+                                inlineOffsetLeft: block.inlineOffsetLeft,
+                                inlineOffsetRight: block.inlineOffsetRight,
+                                previousPageChrome: visualPageChrome(pageByIndex.get(pageBreak.pageIndex - 1)),
+                                nextPageChrome: visualPageChrome(pageByIndex.get(pageBreak.pageIndex)),
+                                tableBreak: block.tableBreak
+                            }
+                        ] : [];
+                    }));
+                    observeBlocks(snapshot.blocks);
+                    editorDom.dataset.paginationEngine = layout.engine;
+                    editorDom.dataset.paginationDocumentRevision = String(layout.documentRevision);
+                    editorDom.dataset.paginationPages = String(layout.pages.length);
+                    editorDom.dataset.paginationState = 'ready';
+                    delete editorDom.dataset.paginationError;
+                    const nextPagination = {
+                        layout,
+                        blocks: snapshot.blocks,
+                        pages,
+                        pageByBlockId: new Map(layout.pages.flatMap((page)=>page.placements.map((placement)=>[
+                                    placement.blockId,
+                                    page.index + 1
+                                ])))
+                    };
+                    paginationCache.current = nextPagination;
+                    measurementRange.commit(measurementPass);
+                    setPagination(nextPagination);
+                } catch (error) {
+                    if (disposed || signal.aborted || error instanceof DOMException && 'AbortError' === error.name) return;
+                    editorDom.dataset.paginationState = 'error';
+                    editorDom.dataset.paginationError = error instanceof Error ? `${error.name}: ${error.message}` : 'UnknownError';
+                    editor.commands.clearDocumentPagination(nextRevision);
+                    paginationCache.current = null;
+                    setPagination(null);
+                }
+            } finally{
+                measurementRange.restore(measurementPass);
             }
         };
         const coordinator = createDocumentPaginationRunCoordinator({
             cancelFrame: cancelAnimationFrame,
-            onAbort: ()=>updateDiagnostic('aborts', 'paginationAborts'),
+            onAbort: ()=>{
+                measurementRange.restoreActive();
+                updateDiagnostic('aborts', 'paginationAborts');
+            },
             onCoalescedRequest: ()=>updateDiagnostic('coalescedRequests', 'paginationCoalescedRequests'),
             onError: (error)=>{
+                measurementRange.restoreActive();
                 if (disposed || editor.isDestroyed) return;
                 editorDom.dataset.paginationState = 'error';
                 editorDom.dataset.paginationError = error instanceof Error ? `${error.name}: ${error.message}` : 'UnknownError';
@@ -13745,7 +13797,7 @@ function useDocumentPagination({ editor, documentRevision, enabled, layoutKey, p
             });
         };
         const markDirty = (position)=>{
-            dirtyMeasurementFrom.current = Math.min(dirtyMeasurementFrom.current, Math.max(0, position));
+            measurementRange.invalidate(position);
         };
         const handleDocumentUpdate = ({ transaction })=>{
             updateDiagnostic('documentTriggers', 'paginationDocumentTriggers');
@@ -14029,7 +14081,10 @@ function pageMetricsKey(page) {
         page.headerHeight,
         page.footerHeight,
         page.pageGap
-    ].join(':');
+    ].map(canonicalPageMetric).join(':');
+}
+function canonicalPageMetric(value) {
+    return Math.round(1000000 * value) / 1000000;
 }
 function earliestChangedPosition(transaction) {
     let earliest = 1 / 0;

package/dist/8928.js

@@ -7672,7 +7672,7 @@ function documentSectionNodeAttributes(layout, id) {
         documentGridLinePitch: normalizedDocumentGrid(layout.documentGrid)?.linePitch ?? null
     };
 }
-function documentSectionLayoutFromNodeAttributes(attributes, fallback) {
+function work_document_section_documentSectionLayoutFromNodeAttributes(attributes, fallback) {
     const base = fallback ?? {
         pageSize: 'a4',
         orientation: 'portrait',
@@ -7765,7 +7765,7 @@ function documentSectionDomAttributes(layout, id) {
     };
 }
 function documentSectionLayoutFromElement(element, fallback) {
-    return documentSectionLayoutFromNodeAttributes({
+    return work_document_section_documentSectionLayoutFromNodeAttributes({
         pageSize: element.dataset.sectionPageSize,
         orientation: element.dataset.sectionOrientation,
         marginTop: numberValue(element.dataset.sectionMarginTop),
@@ -7911,7 +7911,7 @@ function activeDocumentSectionFromState(state) {
         count: sections.length,
         position,
         node,
-        layout: documentSectionLayoutFromNodeAttributes(node.attrs)
+        layout: work_document_section_documentSectionLayoutFromNodeAttributes(node.attrs)
     };
 }
 function updateActiveDocumentSection(layout, commandContext) {
@@ -7933,7 +7933,7 @@ function updateDocumentSection(sectionId, layout, commandContext) {
         const globals = documentPageMarginsForLayout(next);
         for (const [index, candidate] of directDocumentSections(state.doc).entries()){
             const id = documentSectionId(candidate.node, index);
-            const current = documentSectionLayoutFromNodeAttributes(candidate.node.attrs);
+            const current = work_document_section_documentSectionLayoutFromNodeAttributes(candidate.node.attrs);
             const synchronized = synchronizeDocumentPageMarginGlobals(id === sectionId ? next : current, globals);
             commandContext.tr.setNodeMarkup(candidate.position, void 0, documentSectionNodeAttributes(synchronized, id));
         }
@@ -8008,7 +8008,7 @@ function documentSectionByIdInDocument(document1, sectionId) {
         count: sections.length,
         position: section.position,
         node: section.node,
-        layout: documentSectionLayoutFromNodeAttributes(section.node.attrs)
+        layout: work_document_section_documentSectionLayoutFromNodeAttributes(section.node.attrs)
     };
 }
 function directDocumentSections(document1) {
@@ -12967,30 +12967,37 @@ function sanitizeRepeatedDocumentTableElement(clone) {
         pageBreak.remove();
     });
 }
-function measureDocumentLayoutBlocks(editor, previous = null, dirtyFrom = 0, textLayouts = new Map(), maximumFragmentedTableRowHeight = 1000000) {
+const DOCUMENT_LAYOUT_MEASUREMENT_SLICE_MS = 32;
+async function measureDocumentLayoutBlocksIncrementally(editor, previous = null, dirtyFrom = 0, textLayouts = new Map(), maximumFragmentedTableRowHeight = 1000000, options = {}) {
     const blocks = [];
     const pageStyleByMetrics = new Map();
     const counts = {
         measured: 0,
         reused: 0
     };
+    const checkpoint = options.checkpoint ?? createDocumentLayoutMeasurementCheckpoint();
+    throwIfDocumentMeasurementAborted(options.signal);
     let unsupportedLayout = false;
-    editor.state.doc.forEach((section, sectionPosition, sectionIndex)=>{
-        if ('documentSection' !== section.type.name) return;
-        const layout = documentSectionLayoutFromNodeAttributes(section.attrs);
-        if (layout.columns.count > 1) unsupportedLayout = true;
-        const page = documentPageMetrics(layout);
-        const metricsKey = documentPageMetricsKey(page);
-        let pageStyle = pageStyleByMetrics.get(metricsKey);
-        if (!pageStyle) {
-            pageStyle = {
-                id: `document-page-style-${pageStyleByMetrics.size + 1}`,
-                page
-            };
-            pageStyleByMetrics.set(metricsKey, pageStyle);
+    let sectionPosition = 0;
+    for(let sectionIndex = 0; sectionIndex < editor.state.doc.childCount; sectionIndex += 1){
+        const section = editor.state.doc.child(sectionIndex);
+        if ('documentSection' === section.type.name) {
+            const layout = work_document_section_documentSectionLayoutFromNodeAttributes(section.attrs);
+            if (layout.columns.count > 1) unsupportedLayout = true;
+            const page = documentPageMetrics(layout);
+            const metricsKey = documentPageMetricsKey(page);
+            let pageStyle = pageStyleByMetrics.get(metricsKey);
+            if (!pageStyle) {
+                pageStyle = {
+                    id: `document-page-style-${pageStyleByMetrics.size + 1}`,
+                    page
+                };
+                pageStyleByMetrics.set(metricsKey, pageStyle);
+            }
+            await measureSectionBlocksIncrementally(editor, section, sectionPosition, sectionIndex, layout, pageStyle, previous?.blocks ?? [], dirtyFrom, textLayouts, Math.min(maximumFragmentedTableRowHeight, documentPageBodyHeight(pageStyle.page)), counts, blocks, checkpoint, options.signal);
         }
-        measureSectionBlocks(editor, section, sectionPosition, sectionIndex, layout, pageStyle, previous?.blocks ?? [], dirtyFrom, textLayouts, Math.min(maximumFragmentedTableRowHeight, documentPageBodyHeight(pageStyle.page)), counts, blocks);
-    });
+        sectionPosition += section.nodeSize;
+    }
     return {
         blocks,
         pageStyles: [
@@ -13022,63 +13029,74 @@ function documentPageMetrics(layout, physicalPage = 1) {
 function documentPageBodyHeight(page) {
     return Math.max(1, page.height - page.marginTop - page.marginBottom);
 }
-function measureSectionBlocks(editor, section, sectionPosition, sectionIndex, layout, pageStyle, previous, dirtyFrom, textLayouts, maximumFragmentedTableRowHeight, counts, result) {
+async function measureSectionBlocksIncrementally(editor, section, sectionPosition, sectionIndex, layout, pageStyle, previous, dirtyFrom, textLayouts, maximumFragmentedTableRowHeight, counts, result, checkpoint, signal) {
     const sectionBlocks = [];
-    section.forEach((node, offset, index)=>{
-        const position = sectionPosition + offset + 1;
-        const element = elementForNode(editor, position);
-        if (!element) return;
-        const id = documentBlockId(sectionPosition, index, position);
-        const paragraphPagination = documentNodeParagraphPagination(node);
-        if (isDocumentListNode(node)) {
-            const reused = reusableDocumentListLayoutBlocks(previous, id, position + node.nodeSize, dirtyFrom);
-            if (reused.length) {
-                counts.reused += reused.length;
-                sectionBlocks.push(...reused);
-                return;
-            }
-            const listBlocks = measureDocumentListBlocks(editor, node, element, id, position, textLayouts, maximumFragmentedTableRowHeight);
-            if (listBlocks.length) {
-                counts.measured += listBlocks.length;
-                sectionBlocks.push(...listBlocks);
-                return;
-            }
-        }
-        const reused = reusableDocumentLayoutBlocks(previous, id, element, position + node.nodeSize, dirtyFrom);
+    let offset = 0;
+    for(let index = 0; index < section.childCount; index += 1){
+        await checkpoint(signal);
+        throwIfDocumentMeasurementAborted(signal);
+        const node = section.child(index);
+        measureSectionBlock(editor, node, offset, index, sectionPosition, previous, dirtyFrom, textLayouts, maximumFragmentedTableRowHeight, counts, sectionBlocks);
+        offset += node.nodeSize;
+    }
+    finishMeasuredSection(section, sectionPosition, sectionIndex, layout, pageStyle, sectionBlocks, result);
+}
+function measureSectionBlock(editor, node, offset, index, sectionPosition, previous, dirtyFrom, textLayouts, maximumFragmentedTableRowHeight, counts, sectionBlocks) {
+    const position = sectionPosition + offset + 1;
+    const element = elementForNode(editor, position);
+    if (!element) return;
+    const id = documentBlockId(sectionPosition, index, position);
+    const paragraphPagination = documentNodeParagraphPagination(node);
+    if (isDocumentListNode(node)) {
+        const reused = reusableDocumentListLayoutBlocks(previous, id, position + node.nodeSize, dirtyFrom);
         if (reused.length) {
             counts.reused += reused.length;
             sectionBlocks.push(...reused);
             return;
         }
-        if ('table' === node.type.name) {
-            const tableRows = measureDocumentTableRows(editor, node, element, id, position, maximumFragmentedTableRowHeight);
-            if (tableRows.length) {
-                counts.measured += tableRows.length;
-                sectionBlocks.push(...tableRows);
-                return;
-            }
+        const listBlocks = measureDocumentListBlocks(editor, node, element, id, position, textLayouts, maximumFragmentedTableRowHeight);
+        if (listBlocks.length) {
+            counts.measured += listBlocks.length;
+            sectionBlocks.push(...listBlocks);
+            return;
         }
-        const lineFragments = measureParagraphLineFragments(editor, node, element, id, position, position + node.nodeSize, paragraphPagination, textLayouts.get(id));
-        if (lineFragments.length > 1) {
-            counts.measured += lineFragments.length;
-            sectionBlocks.push(...lineFragments);
+    }
+    const reused = reusableDocumentLayoutBlocks(previous, id, element, position + node.nodeSize, dirtyFrom);
+    if (reused.length) {
+        counts.reused += reused.length;
+        sectionBlocks.push(...reused);
+        return;
+    }
+    if ('table' === node.type.name) {
+        const tableRows = measureDocumentTableRows(editor, node, element, id, position, maximumFragmentedTableRowHeight);
+        if (tableRows.length) {
+            counts.measured += tableRows.length;
+            sectionBlocks.push(...tableRows);
             return;
         }
-        counts.measured += 1;
-        sectionBlocks.push(measuredDocumentBlock({
-            block: {
-                id,
-                height: documentBlockFlowHeight(node, element),
-                breakBefore: paragraphPagination.pageBreakBefore,
-                breakAfter: 'pageBreak' === node.type.name,
-                keepTogether: paragraphPagination.keepLines || shouldKeepDocumentBlockTogether(node),
-                keepWithNext: paragraphPagination.keepWithNext
-            },
-            element,
-            from: position,
-            to: position + node.nodeSize
-        }));
-    });
+    }
+    const lineFragments = measureParagraphLineFragments(editor, node, element, id, position, position + node.nodeSize, paragraphPagination, textLayouts.get(id));
+    if (lineFragments.length > 1) {
+        counts.measured += lineFragments.length;
+        sectionBlocks.push(...lineFragments);
+        return;
+    }
+    counts.measured += 1;
+    sectionBlocks.push(measuredDocumentBlock({
+        block: {
+            id,
+            height: documentBlockFlowHeight(node, element),
+            breakBefore: paragraphPagination.pageBreakBefore,
+            breakAfter: 'pageBreak' === node.type.name,
+            keepTogether: paragraphPagination.keepLines || shouldKeepDocumentBlockTogether(node),
+            keepWithNext: paragraphPagination.keepWithNext
+        },
+        element,
+        from: position,
+        to: position + node.nodeSize
+    }));
+}
+function finishMeasuredSection(section, sectionPosition, sectionIndex, layout, pageStyle, sectionBlocks, result) {
     const last = sectionBlocks.at(-1);
     if (last && 'continuous' !== layout.breakAfter && 'nextColumn' !== layout.breakAfter) last.block.breakAfter = true;
     const sectionMetadata = {
@@ -13095,6 +13113,41 @@ function measureSectionBlocks(editor, section, sectionPosition, sectionIndex, la
     }
     result.push(...sectionBlocks);
 }
+function createDocumentLayoutMeasurementCheckpoint() {
+    let deadline = documentMeasurementNow() + DOCUMENT_LAYOUT_MEASUREMENT_SLICE_MS;
+    return async (signal)=>{
+        throwIfDocumentMeasurementAborted(signal);
+        if (documentMeasurementNow() < deadline) return;
+        await yieldDocumentMeasurement();
+        throwIfDocumentMeasurementAborted(signal);
+        deadline = documentMeasurementNow() + DOCUMENT_LAYOUT_MEASUREMENT_SLICE_MS;
+    };
+}
+function documentMeasurementNow() {
+    return globalThis.performance?.now?.() ?? Date.now();
+}
+function yieldDocumentMeasurement() {
+    if ("u" > typeof MessageChannel) return new Promise((resolve)=>{
+        const channel = new MessageChannel();
+        channel.port1.addEventListener('message', ()=>{
+            channel.port1.close();
+            channel.port2.close();
+            resolve();
+        }, {
+            once: true
+        });
+        channel.port1.start();
+        channel.port2.postMessage(void 0);
+    });
+    return new Promise((resolve)=>globalThis.setTimeout(resolve, 0));
+}
+function throwIfDocumentMeasurementAborted(signal) {
+    if (!signal?.aborted) return;
+    if (signal.reason instanceof Error) throw signal.reason;
+    const error = new Error('Document layout measurement was aborted');
+    error.name = 'AbortError';
+    throw error;
+}
 function documentPageMetricsKey(page) {
     return [
         page.width,
@@ -13337,7 +13390,7 @@ const DocumentSection = core_Node.create({
         ];
     },
     renderHTML ({ node, HTMLAttributes }) {
-        const layout = documentSectionLayoutFromNodeAttributes(node.attrs);
+        const layout = work_document_section_documentSectionLayoutFromNodeAttributes(node.attrs);
         const id = 'string' == typeof node.attrs.id && node.attrs.id ? node.attrs.id : 'document-section';
         const columns = layout.columns;
         const page = documentPageMetrics(layout);
@@ -17415,4 +17468,4 @@ function capturePages(surface) {
             width: surface.pageWidth
         }));
 }
-export { DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DEFAULT_DOCUMENT_TABLE_GEOMETRY, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_PAGE_MARGIN_KEYS, DOCUMENT_PARAGRAPH_BORDER_EDGES, DOCUMENT_PARAGRAPH_BORDER_STYLES, DOCUMENT_PARAGRAPH_SHADING_PATTERNS, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, DOCUMENT_TABLE_STYLE_OPTIONS, DocumentEquation, DocumentImage, DocumentParagraphFormatting, DocumentParagraphIdentity, DocumentSubscript, DocumentSuperscript, DocumentTableRowIdentity, DocxThemePatchCollector, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, MAX_DOCUMENT_NUMBERING_START, activeDocumentBookmark, activeDocumentSection, activeDocumentTableStyle, applyDocumentImageCropToElement, applyDocumentImageIdentityToElement, applyDocumentImageLayerToElement, applyDocumentImageWrapContourToElement, applyDocumentPageGeometry, applyDocumentParagraphIdentityToElement, applyDocumentTableGeometryToElement, applyDocumentTableRowIdentityToElement, canChangeDocumentIndent, canInsertDocumentComment, canSetDocumentTableRowRepeatHeader, clampDocumentMargin, collectDocumentChanges, collectDocumentCommentAnchors, collectDocumentNotes, collectDocumentTextLayoutParagraphs, createDocumentBibliography, createDocumentEquationElement, createDocumentImageIdentityRegistry, createDocumentNoteElement, createDocumentParagraphIdentityRegistry, createWorkDocumentExtensions, createWorkDocumentModel, createWorkDocumentModelFromContent, createWorkOfficeDocumentCollaborationBinding as createOfficeDocumentCollaborationBinding, defaultDocumentImageWrapContour, documentAutoLineHeight, documentBookmarkNameExists, documentBookmarkReferenceInstruction, documentBulletListStyle, documentCaptionKind, documentCaptionLabel, documentCitationCount, documentCitationInstruction, documentCitationStyle, documentCitationStyleDetails, documentCitationTags, documentCitationTagsFromInstruction, documentCommentDraftRange, documentCommentViews, documentContentLayoutProperties, documentEquationFromElement, documentEquationText, documentImageCropFromElement, documentImageIdentityFromElement, documentImageLayerFromElement, documentImageLayoutFromElement, documentImageLayoutOptions, documentImagePositionFromElement, documentImageProperties, documentImageWrapContourFromElement, documentInitialSectionLayout, documentModelForContent, documentNoteKey, documentNoteKind, documentOrderedListState, documentPageBordersVisible, documentPageChromeLegacyFields, documentPageGeometryForLayout, documentPageHorizontalMarginTwips, documentPageMarginBody, documentPageMarginsForLayout, documentPageMetrics, documentParagraphBordersDomAttributes, documentParagraphDirection, documentParagraphIdentityFromElement, documentParagraphIndent, documentParagraphPagination, documentParagraphShadingDomAttributes, documentParagraphSpacing, documentParagraphTabStops, documentSectionById, documentSectionDomAttributes, documentSections, documentTabLeaderLabel, documentTableBordersFromElement, documentTableCellFormat, documentTableCellMarginOverridesFromElement, documentTableColumnPercentagesFromElement, documentTableGeometryFromElement, documentTableHorizontalAlignment, documentTableRowIdentityFromElement, documentTableRowOptions, documentTableSizing, documentTextLayoutBatches, documentWordLineHeightFactor, docxBookmarkReferenceTarget, docxDocumentFieldKind, editorDocumentBookmarkReferenceTargets, editorDocumentCaptionTargets, initializeWorkOfficeDocumentCollaboration as initializeOfficeDocumentCollaboration, isContourImageLayout, isDocumentParagraphArtBorderStyle, isValidDocumentCitationTag, materializeWorkDocumentContent, measureDocumentLayoutBlocks, millimetersToPixels, mountWorkLiveDocumentCapture, nextDocumentTabAlignment, normalizeDocumentBookmarkName, normalizeDocumentBookmarkNativeId, normalizeDocumentBookmarkReferencesHtml, normalizeDocumentBookmarksHtml, normalizeDocumentCaptionsHtml, normalizeDocumentCitationsHtml, normalizeDocumentColumns, normalizeDocumentEquation, normalizeDocumentFieldsHtml, normalizeDocumentHtml, normalizeDocumentImageAlignment, normalizeDocumentImageCrop, normalizeDocumentImageIdentity, normalizeDocumentImageLayer, normalizeDocumentImageLayoutOptions, normalizeDocumentImagePosition, normalizeDocumentImageWrapContour, normalizeDocumentImageWrapSide, normalizeDocumentNotesHtml, normalizeDocumentPageBorders, normalizeDocumentPageChrome, normalizeDocumentPageGeometry, normalizeDocumentPageMargins, normalizeDocumentPaperSource, normalizeDocumentParagraphBorder, normalizeDocumentParagraphBorders, normalizeDocumentParagraphId, normalizeDocumentParagraphIdentity, normalizeDocumentParagraphIndent, normalizeDocumentTabStops, normalizeDocumentTableBorderStyle, normalizeDocumentTableBorderWidth, normalizeDocumentTableRowHeightRule, normalizeDocumentTableRowIdentity, normalizeDocumentTableVerticalAlign, normalizeTableColor, normalizedTabPosition, pageTwipsToMillimeters, parseDocumentParagraphBordersElement, parseDocumentParagraphShadingElement, parseDocxThemeReference, patchDocxThemeReferences, positionWorkLiveDocumentCapture, readWorkOfficeDocumentCollaboration as readOfficeDocumentCollaboration, renderDocumentAutoLineHeight, renderDocumentTableBorders, renderDocumentTableCellMarginOverrides, resolveDocumentPageBorders, resolveDocumentPageChrome, resolveDocumentPageMargins, resolveDocumentPageSize, resolveWorkDocumentEditorInput, retainAnchoredDocumentComments, sanitizeDocumentPageChromeHtml, serializeDocumentTabStops, serializeDocxThemeReference, serializeWorkDocumentNode, setCustomDocumentColumns, supportedDocxBookmarkReferenceInstruction, syncDocumentContentFromHtml, uniqueDocumentImageIdentity, uniqueDocumentParagraphIdentity, updateDocumentColumnWidth, updateDocumentCustomPageMillimeters, updateDocumentGutterPosition, updateDocumentMirrorMargins, updateDocumentPageChromeVariant, updateDocumentPageMarginMillimeters, updateDocumentPageMarginMode, updateDocumentPageOrientation, updateDocumentPaperSizePreset, validateDocumentBookmarkName, workDocumentSchema, workOfficeDocumentCollaborationFragment as officeDocumentCollaborationFragment, work_document_page_margins_twipsToMillimeters, wrapsBesideImage };
+export { DEFAULT_DOCUMENT_TABLE_CELL_FORMAT, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, DEFAULT_DOCUMENT_TABLE_GEOMETRY, DOCUMENT_BOOKMARK_DUPLICATE_MESSAGE, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_PAGE_MARGIN_KEYS, DOCUMENT_PARAGRAPH_BORDER_EDGES, DOCUMENT_PARAGRAPH_BORDER_STYLES, DOCUMENT_PARAGRAPH_SHADING_PATTERNS, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, DOCUMENT_TABLE_STYLE_OPTIONS, DocumentEquation, DocumentImage, DocumentParagraphFormatting, DocumentParagraphIdentity, DocumentSubscript, DocumentSuperscript, DocumentTableRowIdentity, DocxThemePatchCollector, MAX_DOCUMENT_IMAGE_RELATIVE_HEIGHT, MAX_DOCUMENT_NUMBERING_START, activeDocumentBookmark, activeDocumentSection, activeDocumentTableStyle, applyDocumentImageCropToElement, applyDocumentImageIdentityToElement, applyDocumentImageLayerToElement, applyDocumentImageWrapContourToElement, applyDocumentPageGeometry, applyDocumentParagraphIdentityToElement, applyDocumentTableGeometryToElement, applyDocumentTableRowIdentityToElement, canChangeDocumentIndent, canInsertDocumentComment, canSetDocumentTableRowRepeatHeader, clampDocumentMargin, collectDocumentChanges, collectDocumentCommentAnchors, collectDocumentNotes, collectDocumentTextLayoutParagraphs, createDocumentBibliography, createDocumentEquationElement, createDocumentImageIdentityRegistry, createDocumentNoteElement, createDocumentParagraphIdentityRegistry, createWorkDocumentExtensions, createWorkDocumentModel, createWorkDocumentModelFromContent, createWorkOfficeDocumentCollaborationBinding as createOfficeDocumentCollaborationBinding, defaultDocumentImageWrapContour, documentAutoLineHeight, documentBookmarkNameExists, documentBookmarkReferenceInstruction, documentBulletListStyle, documentCaptionKind, documentCaptionLabel, documentCitationCount, documentCitationInstruction, documentCitationStyle, documentCitationStyleDetails, documentCitationTags, documentCitationTagsFromInstruction, documentCommentDraftRange, documentCommentViews, documentContentLayoutProperties, documentEquationFromElement, documentEquationText, documentImageCropFromElement, documentImageIdentityFromElement, documentImageLayerFromElement, documentImageLayoutFromElement, documentImageLayoutOptions, documentImagePositionFromElement, documentImageProperties, documentImageWrapContourFromElement, documentInitialSectionLayout, documentModelForContent, documentNoteKey, documentNoteKind, documentOrderedListState, documentPageBordersVisible, documentPageChromeLegacyFields, documentPageGeometryForLayout, documentPageHorizontalMarginTwips, documentPageMarginBody, documentPageMarginsForLayout, documentPageMetrics, documentParagraphBordersDomAttributes, documentParagraphDirection, documentParagraphIdentityFromElement, documentParagraphIndent, documentParagraphPagination, documentParagraphShadingDomAttributes, documentParagraphSpacing, documentParagraphTabStops, documentSectionById, documentSectionDomAttributes, documentSections, documentTabLeaderLabel, documentTableBordersFromElement, documentTableCellFormat, documentTableCellMarginOverridesFromElement, documentTableColumnPercentagesFromElement, documentTableGeometryFromElement, documentTableHorizontalAlignment, documentTableRowIdentityFromElement, documentTableRowOptions, documentTableSizing, documentTextLayoutBatches, documentWordLineHeightFactor, docxBookmarkReferenceTarget, docxDocumentFieldKind, editorDocumentBookmarkReferenceTargets, editorDocumentCaptionTargets, initializeWorkOfficeDocumentCollaboration as initializeOfficeDocumentCollaboration, isContourImageLayout, isDocumentParagraphArtBorderStyle, isValidDocumentCitationTag, materializeWorkDocumentContent, measureDocumentLayoutBlocksIncrementally, millimetersToPixels, mountWorkLiveDocumentCapture, nextDocumentTabAlignment, normalizeDocumentBookmarkName, normalizeDocumentBookmarkNativeId, normalizeDocumentBookmarkReferencesHtml, normalizeDocumentBookmarksHtml, normalizeDocumentCaptionsHtml, normalizeDocumentCitationsHtml, normalizeDocumentColumns, normalizeDocumentEquation, normalizeDocumentFieldsHtml, normalizeDocumentHtml, normalizeDocumentImageAlignment, normalizeDocumentImageCrop, normalizeDocumentImageIdentity, normalizeDocumentImageLayer, normalizeDocumentImageLayoutOptions, normalizeDocumentImagePosition, normalizeDocumentImageWrapContour, normalizeDocumentImageWrapSide, normalizeDocumentNotesHtml, normalizeDocumentPageBorders, normalizeDocumentPageChrome, normalizeDocumentPageGeometry, normalizeDocumentPageMargins, normalizeDocumentPaperSource, normalizeDocumentParagraphBorder, normalizeDocumentParagraphBorders, normalizeDocumentParagraphId, normalizeDocumentParagraphIdentity, normalizeDocumentParagraphIndent, normalizeDocumentTabStops, normalizeDocumentTableBorderStyle, normalizeDocumentTableBorderWidth, normalizeDocumentTableRowHeightRule, normalizeDocumentTableRowIdentity, normalizeDocumentTableVerticalAlign, normalizeTableColor, normalizedTabPosition, pageTwipsToMillimeters, parseDocumentParagraphBordersElement, parseDocumentParagraphShadingElement, parseDocxThemeReference, patchDocxThemeReferences, positionWorkLiveDocumentCapture, readWorkOfficeDocumentCollaboration as readOfficeDocumentCollaboration, renderDocumentAutoLineHeight, renderDocumentTableBorders, renderDocumentTableCellMarginOverrides, resolveDocumentPageBorders, resolveDocumentPageChrome, resolveDocumentPageMargins, resolveDocumentPageSize, resolveWorkDocumentEditorInput, retainAnchoredDocumentComments, sanitizeDocumentPageChromeHtml, serializeDocumentTabStops, serializeDocxThemeReference, serializeWorkDocumentNode, setCustomDocumentColumns, supportedDocxBookmarkReferenceInstruction, syncDocumentContentFromHtml, uniqueDocumentImageIdentity, uniqueDocumentParagraphIdentity, updateDocumentColumnWidth, updateDocumentCustomPageMillimeters, updateDocumentGutterPosition, updateDocumentMirrorMargins, updateDocumentPageChromeVariant, updateDocumentPageMarginMillimeters, updateDocumentPageMarginMode, updateDocumentPageOrientation, updateDocumentPaperSizePreset, validateDocumentBookmarkName, workDocumentSchema, workOfficeDocumentCollaborationFragment as officeDocumentCollaborationFragment, work_document_page_margins_twipsToMillimeters, wrapsBesideImage };

package/dist/internal/features/work/editors/document-pagination-measurement-range.d.ts

@@ -0,0 +1,18 @@
+export interface DocumentPaginationMeasurementPass {
+    readonly from: number;
+}
+export interface DocumentPaginationMeasurementRange {
+    begin: () => DocumentPaginationMeasurementPass;
+    commit: (pass: DocumentPaginationMeasurementPass) => void;
+    ensureDirty: () => void;
+    invalidate: (position: number) => void;
+    reset: () => void;
+    restore: (pass: DocumentPaginationMeasurementPass) => void;
+    restoreActive: () => void;
+}
+/**
+ * Tracks the earliest document position that the next pagination pass must
+ * measure. An active pass consumes that position temporarily, then either
+ * commits it or restores it when cooperative work is aborted.
+ */
+export declare function createDocumentPaginationMeasurementRange(): DocumentPaginationMeasurementRange;

package/dist/internal/features/work/work-document-pagination-measurement.d.ts

@@ -2,7 +2,18 @@ import type { Editor } from '@tiptap/core';
 import type { OfficeKernelPageMetrics, OfficeKernelTextLayoutParagraphResult } from '../../kernel/office-kernel-protocol';
 import type { DocumentPaginationSnapshot } from './work-document-pagination-types';
 import type { WorkDocumentSectionLayout } from './work-types';
+export interface IncrementalDocumentLayoutMeasurementOptions {
+    checkpoint?: (signal?: AbortSignal) => Promise<void>;
+    signal?: AbortSignal;
+}
 export declare function measureDocumentLayoutBlocks(editor: Editor, previous?: DocumentPaginationSnapshot | null, dirtyFrom?: number, textLayouts?: ReadonlyMap<string, OfficeKernelTextLayoutParagraphResult>, maximumFragmentedTableRowHeight?: number): DocumentPaginationSnapshot;
+/**
+ * Measures the same canonical editor DOM as `measureDocumentLayoutBlocks`
+ * while yielding between top-level blocks. The browser keeps input, media,
+ * and animation tasks schedulable during large-document pagination without
+ * weakening the layout result or replacing the controlled editor model.
+ */
+export declare function measureDocumentLayoutBlocksIncrementally(editor: Editor, previous?: DocumentPaginationSnapshot | null, dirtyFrom?: number, textLayouts?: ReadonlyMap<string, OfficeKernelTextLayoutParagraphResult>, maximumFragmentedTableRowHeight?: number, options?: IncrementalDocumentLayoutMeasurementOptions): Promise<DocumentPaginationSnapshot>;
 export declare function documentPageMetrics(layout: WorkDocumentSectionLayout, physicalPage?: number): OfficeKernelPageMetrics;
 export declare function documentPageBodyHeight(page: OfficeKernelPageMetrics): number;
 export declare function documentPaginationSurfaceHeight(pageCount: number, page: OfficeKernelPageMetrics): number;

package/dist/internal/features/work/work-document-pagination.d.ts

@@ -2,7 +2,8 @@ import { Extension } from '@tiptap/core';
 import type { DocumentPaginationVisualBreak } from './work-document-pagination-types';
 export { createDocumentLineFragments, createShapedDocumentLineFragments, findDocumentLineStartOffset, } from './work-document-line-measurement';
 export { reusableDocumentLayoutBlocks } from './work-document-pagination-dom';
-export { documentPageBodyHeight, documentPageMetrics, documentPaginationSurfaceHeight, measureDocumentLayoutBlocks, } from './work-document-pagination-measurement';
+export { documentPageBodyHeight, documentPageMetrics, documentPaginationSurfaceHeight, measureDocumentLayoutBlocks, measureDocumentLayoutBlocksIncrementally, } from './work-document-pagination-measurement';
+export type { IncrementalDocumentLayoutMeasurementOptions } from './work-document-pagination-measurement';
 export type { DocumentPaginationSection, DocumentPaginationSnapshot, DocumentPaginationVisualBreak, DocumentPaginationVisualPageChrome, DocumentTableCellBoundary, DocumentTableCellFragmentMeasurement, DocumentTableCellPageBreak, DocumentTablePaginationBreak, DocumentTableRowFragmentPlan, DocumentTextLayoutCollection, MeasuredDocumentLayoutBlock, } from './work-document-pagination-types';
 export { createDocumentTableRowFragmentPlan } from './work-document-table-pagination';
 export { collectDocumentTextLayoutParagraphs, collectDocumentTextLayoutRuns, documentTextLayoutBatches, } from './work-document-text-layout';

package/docs/latest/en/browser-editor-architecture.md

@@ -844,6 +844,13 @@ text validation, UTF-16 offset mapping, shaping, and their tests live in
 focused modules. This keeps the fallback and WASM paths independently
 testable without duplicating their public protocol.
 
+Live DOM measurement is cooperatively scheduled in bounded 32 ms slices. It
+yields only between top-level ProseMirror blocks, so one block is always
+measured atomically against its rendered element. Document invalidation aborts
+the stale pass before it can replace the reusable snapshot, while the existing
+single-flight coordinator coalesces one fresh run. The synchronous measurement
+path remains available for deterministic callers and parity tests.
+
 Layout requests carry a bounded, deduplicated page-style table and let each
 measured block reference its section geometry. A geometry transition opens a
 new physical page in both the JavaScript fallback and Rust/WASM kernel, and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",