@a3s-lab/office 0.9.0 → 0.9.2

package/COLLABORATION_ROADMAP.md

@@ -395,8 +395,9 @@ projection, a host-injected live CLI transport session, authenticated browser
 suggestion-update authorization, and typed Markdown, Document
 content/comment/suggestion, Spreadsheet cell, Presentation scene-element, PDF
 annotation/form-value, and PDF redaction/page-operation review mutation surfaces
-are implemented; the remaining format mutations and native presence projection
-are pending.
+are implemented. The live CLI session also projects ephemeral native Presence
+and format-specific locations through standard Yjs Awareness; remaining typed
+format mutations are pending.
 
 - Yrs `0.27.3` now uses 53-bit Yjs-compatible client IDs and exchanges standard
   Yjs v1 updates, state vectors, and y-sync `SyncStep1`/`Update` messages with
@@ -426,6 +427,14 @@ are pending.
   stdin/stdout for a coding-agent or product host. The host still owns the
   WebSocket or IPC channel, room selection, authentication, authorization,
   buffering, and delivery identities; the CLI never opens a provider itself.
+- Supplying `--actor-name` gives the live session a separate in-memory Yrs
+  Awareness peer. Typed active/idle/away state and Document, Markdown,
+  Spreadsheet, Presentation, or PDF locations are emitted as bounded
+  `outbound-awareness` records, while validated remote updates and peer-left
+  events become sorted participant snapshots. Reconnect clears stale remote
+  state and republishes the local participant; orderly close emits an
+  Awareness tombstone. No Presence state or clock enters the replica,
+  checkpoint, durable update log, or operation receipts.
 - Each replica binds one stable actor ID, actor kind, permission mode, artifact
   identity/kind, namespace, and client ID. Apply/checkpoint/leave require the
   same identity plus a stable operation ID and accept an optional state-vector
@@ -518,8 +527,6 @@ Remaining:
   structural/rich-text operations plus PDF signatures; deepen Document
   mutations to additional nested structures and complete table/list/section
   revision workflows.
-- Project editor-visible presence and selection state while keeping Awareness
-  ephemeral and outside native replica persistence.
 
 Exit criterion: a browser, `office` CLI, MCP client, and `a3s code` agent edit
 the same artifact concurrently, converge at the shared-model level, reconnect

package/README.md

@@ -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
@@ -1039,7 +1042,7 @@ cargo run -p a3s-office-cli -- collab diff .a3s/report.replica \
 
 # Bridge that replica to a host-owned room over machine-readable JSONL.
 cargo run -p a3s-office-cli -- collab session .a3s/report.replica \
-  --poll-ms 100 --json
+  --poll-ms 100 --actor-name "A3S Agent" --json
 
 # Make a typed local change in an initialized Markdown replica. A running
 # session publishes the resulting incremental Yjs update automatically.
@@ -1177,7 +1180,11 @@ controller as a shared participant roster, remote canvas projection, and
 participant-to-location navigation; neither component creates an account or
 backend. The native CLI's JSONL session bridges the same host-channel envelope,
 including reconnect handshakes, durable agent updates, and remote-echo
-suppression, without opening its own network provider. Native Rust `project`,
+suppression, without opening its own network provider. With `--actor-name`, it
+also emits standard, bounded `outbound-awareness` records for ephemeral agent
+activity and format-specific locations, accepts remote Awareness and peer-left
+records, and publishes participant snapshots without changing the durable
+replica. Native Rust `project`,
 `collab read`, and `office_collaboration_read` return the exact canonical
 Markdown source or an Office-owned bounded Document projection with stable
 paragraph/text identities, structural ancestry, option fields, subordinate
@@ -1320,6 +1327,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.2 documentation](https://a3s-lab.github.io/Office/docs/0.9.2/)
+- [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/)

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.9.0",
+  "version": "0.9.2",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",