@docx-editor.dev/core 2.6.0 → 2.7.0

package/dist/layout.d.ts

@@ -1,23 +1,23 @@
-import { V as VersionedShapingLibrary, T as TextShaper, F as FontByteValidator, a as FixedPointRoundingMode, b as FixedPoint, c as TextDirection, S as ShapedRun } from './shaped-measurer-l4o5ITJ0.js';
-export { C as CacheLookup, d as CacheMiss, e as CacheProvenance, D as DeclaredFontSubstitution, f as FontFingerprintInputs, g as FontRequest, h as FontResolutionError, i as FontResolutionErrorCode, j as FontResourceDefinition, k as FontResourceInstrumentation, l as FontResourceSnapshot, m as FontResourceSnapshotOptions, n as FontSubstitution, o as FontValidationResult, G as GlyphOutline, H as HARD_MAX_AGGREGATE_FONT_BYTES, p as HARD_MAX_FONT_BYTES, q as HARD_MAX_FONT_SOURCES, L as LayoutShapingOptions, N as NormalizationPolicy, O as OperationSnapshot, r as OperationSnapshotField, s as OperationSnapshotGuard, R as ResolvedCache, t as ResolvedFont, u as ResourceDependencyProvenance, v as ShapeInput, w as ShapedCluster, x as ShapedFontSpan, y as ShapedGlyph, z as ShapedMeasurerOptions, A as ShapedRunComparatorInputs, B as ShapedVerticalMetrics, E as ShapingEnvironment, I as ShapingEnvironmentFingerprintInputs, J as ShapingEnvironmentInput, K as boundedStructuralFontValidator, M as captureOperationSnapshot, P as createFontResourceSnapshot, Q as createShapedMeasurer, U as createShapedRun, W as createShapingEnvironment, X as fixedPoint, Y as fontRequestKey, Z as guardOperationSnapshot, _ as sha256FontBytes, $ as shapedRunComparatorInputs, a0 as shapingEnvironmentFingerprint, a1 as shapingEnvironmentFingerprintInputs } from './shaped-measurer-l4o5ITJ0.js';
-import { d as LayoutBox, D as DrawingPoint, e as DrawingInsets, a as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, R as ResolvedRunStyle, f as ThemeFonts, g as ParagraphSpacing, h as ParagraphLineSpacing, i as ParagraphBorderEdge, j as ParagraphBorders, k as ResolvedTabStops, l as TableBorderSide, S as SemanticLayout, B as BlockFragmentRecord, m as InlineDrawingLayoutContext, T as TextMeasurer, H as HyperlinkProjector, F as FieldLinkProjector, n as PageRecord, o as ParagraphFragmentRecord, p as StoryPageFieldNeeds, A as AnchoredDrawingRecord, P as PageGeometry, q as CellBorderBox, r as TableBorderBox } from './semantic-records-CdQvpUj1.js';
-export { s as AUTO_PARAGRAPH_SPACING_PT, t as BorderGridGeometry, C as ContentControlBoundaryRecord, u as ContentControlGeometryFragment, v as ContentControlLevel, w as ContentControlLock, x as ContentControlMappedType, y as DEFAULT_PAGE_GEOMETRY, z as DEFAULT_RUN_STYLE, E as DEFAULT_TAB_INTERVAL_PT, G as DEFAULT_TAB_INTERVAL_TWIPS, J as EMPTY_TAB_STOPS, K as FieldAtomMarker, N as HeaderFooterStoryRecord, O as HyperlinkFieldSpec, L as LineRecord, Q as LineSpacingRule, U as ListMarkerRecord, V as MAX_BORDER_SPACE_PT, W as MAX_BORDER_WIDTH_PT, X as MAX_PARAGRAPH_SPACING_PT, Y as MAX_TABLE_BORDER_STROKES, Z as MAX_TAB_POSITION_TWIPS, _ as MAX_TAB_STOPS, $ as PARAGRAPH_BORDER_SIDES, a0 as ParagraphAutoSpacingContext, a1 as ParagraphBorderSide, a2 as ParagraphBorderStrokeRecord, a3 as ParagraphBottomBorderRecord, a4 as ParagraphIndent, a5 as ResolvedCellBorders, a6 as ResolvedTableBorderEdge, a7 as ResolvedTableBorderEdgeSegment, a8 as ResolvedUnderline, a9 as SINGLE_LINE_SPACING, aa as SourceRange, ab as SpanLinkRecord, ac as TAB_LEADER_GLYPH, ad as TabAlignment, ae as TabDestination, af as TabLeader, ag as TabStop, ah as TableBorderSideName, ai as TableBorderStrokeRecord, c as TableCellFragmentRecord, aj as TableFragmentRecord, b as TableRowFragmentRecord, ak as VerticalAlign, al as appliedSpaceBefore, am as applyLineSpacing, an as baselineShiftPtOf, ao as borderExtentPt, ap as borderWeight, aq as bottomBorderExtentPt, ar as cascadedParagraphBorders, as as cascadedTabStops, at as collapsedSpaceBefore, au as contentControlsOfLayout, av as defaultTabIntervalFromSettings, aw as displayText, ax as effectiveContentControlLock, ay as fragmentsOfParagraph, az as lineAtPosition, aA as linesOf, aB as measureDisplayText, aC as nextTabDestination, aD as paragraphBorderExtentPt, aE as paragraphBorderStrokeWidthPt, aF as paragraphBorders, aG as paragraphBordersFingerprint, aH as paragraphBreaksBefore, aI as paragraphContextualSpacing, aJ as paragraphFragmentsOf, aK as paragraphFragmentsOfBlocks, aL as paragraphLineSpacing, aM as paragraphSpacing, aN as paragraphTabStops, aO as readBorderSide, aP as readCellBorders, aQ as readTableBorders, aR as resolveBorderConflict, aS as resolveRunStyle, aT as resolveTableCellBorderGrid, aU as runStylesEqual, aV as tabAdvanceWidth, aW as tabStopsFingerprint, aX as unionLayoutBoxes, aY as withDefaultTabInterval } from './semantic-records-CdQvpUj1.js';
+import { V as VersionedShapingLibrary, T as TextShaper, F as FontByteValidator, a as FixedPointRoundingMode, b as FixedPoint, c as TextDirection, S as ShapedRun } from './shaped-measurer-CakZ7g1s.js';
+export { C as CacheLookup, d as CacheMiss, e as CacheProvenance, D as DeclaredFontSubstitution, f as FontFingerprintInputs, g as FontRequest, h as FontResolutionError, i as FontResolutionErrorCode, j as FontResourceDefinition, k as FontResourceInstrumentation, l as FontResourceSnapshot, m as FontResourceSnapshotOptions, n as FontSubstitution, o as FontValidationResult, G as GlyphOutline, H as HARD_MAX_AGGREGATE_FONT_BYTES, p as HARD_MAX_FONT_BYTES, q as HARD_MAX_FONT_SOURCES, L as LayoutShapingOptions, N as NormalizationPolicy, O as OperationSnapshot, r as OperationSnapshotField, s as OperationSnapshotGuard, R as ResolvedCache, t as ResolvedFont, u as ResourceDependencyProvenance, v as ShapeInput, w as ShapedCluster, x as ShapedFontSpan, y as ShapedGlyph, z as ShapedMeasurerOptions, A as ShapedRunComparatorInputs, B as ShapedVerticalMetrics, E as ShapingEnvironment, I as ShapingEnvironmentFingerprintInputs, J as ShapingEnvironmentInput, K as boundedStructuralFontValidator, M as captureOperationSnapshot, P as createFontResourceSnapshot, Q as createShapedMeasurer, U as createShapedRun, W as createShapingEnvironment, X as fixedPoint, Y as fontRequestKey, Z as guardOperationSnapshot, _ as sha256FontBytes, $ as shapedRunComparatorInputs, a0 as shapingEnvironmentFingerprint, a1 as shapingEnvironmentFingerprintInputs } from './shaped-measurer-CakZ7g1s.js';
+import { d as LayoutBox, D as DrawingPoint, e as DrawingInsets, a as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, R as ResolvedRunStyle, f as ThemeFonts, g as ParagraphSpacing, h as ParagraphLineSpacing, i as ParagraphBorderEdge, j as ParagraphBorders, k as ResolvedTabStops, l as TableBorderSide, S as SemanticLayout, B as BlockFragmentRecord, m as InlineDrawingLayoutContext, T as TextMeasurer, H as HyperlinkProjector, F as FieldLinkProjector, n as PageRecord, o as ParagraphFragmentRecord, p as StoryPageFieldNeeds, A as AnchoredDrawingRecord, P as PageGeometry, q as CellBorderBox, r as TableBorderBox } from './semantic-records-DoW_xNgJ.js';
+export { s as AUTO_PARAGRAPH_SPACING_PT, t as BorderGridGeometry, C as ContentControlBoundaryRecord, u as ContentControlGeometryFragment, v as ContentControlLevel, w as ContentControlLock, x as ContentControlMappedType, y as DEFAULT_PAGE_GEOMETRY, z as DEFAULT_RUN_STYLE, E as DEFAULT_TAB_INTERVAL_PT, G as DEFAULT_TAB_INTERVAL_TWIPS, J as EMPTY_TAB_STOPS, K as FieldAtomMarker, N as HeaderFooterStoryRecord, O as HyperlinkFieldSpec, L as LineRecord, Q as LineSpacingRule, U as ListMarkerRecord, V as MAX_BORDER_SPACE_PT, W as MAX_BORDER_WIDTH_PT, X as MAX_PARAGRAPH_SPACING_PT, Y as MAX_TABLE_BORDER_STROKES, Z as MAX_TAB_POSITION_TWIPS, _ as MAX_TAB_STOPS, $ as PARAGRAPH_BORDER_SIDES, a0 as ParagraphAutoSpacingContext, a1 as ParagraphBorderSide, a2 as ParagraphBorderStrokeRecord, a3 as ParagraphBottomBorderRecord, a4 as ParagraphIndent, a5 as ResolvedCellBorders, a6 as ResolvedTableBorderEdge, a7 as ResolvedTableBorderEdgeSegment, a8 as ResolvedUnderline, a9 as SINGLE_LINE_SPACING, aa as SourceRange, ab as SpanLinkRecord, ac as TAB_LEADER_GLYPH, ad as TabAlignment, ae as TabDestination, af as TabLeader, ag as TabStop, ah as TableBorderSideName, ai as TableBorderStrokeRecord, c as TableCellFragmentRecord, aj as TableFragmentRecord, b as TableRowFragmentRecord, ak as VerticalAlign, al as appliedSpaceBefore, am as applyLineSpacing, an as baselineShiftPtOf, ao as borderExtentPt, ap as borderWeight, aq as bottomBorderExtentPt, ar as cascadedParagraphBorders, as as cascadedTabStops, at as collapsedSpaceBefore, au as contentControlsOfLayout, av as defaultTabIntervalFromSettings, aw as displayText, ax as effectiveContentControlLock, ay as fragmentsOfParagraph, az as lineAtPosition, aA as linesOf, aB as measureDisplayText, aC as nextTabDestination, aD as paragraphBorderExtentPt, aE as paragraphBorderStrokeWidthPt, aF as paragraphBorders, aG as paragraphBordersFingerprint, aH as paragraphBreaksBefore, aI as paragraphContextualSpacing, aJ as paragraphFragmentsOf, aK as paragraphFragmentsOfBlocks, aL as paragraphLineSpacing, aM as paragraphSpacing, aN as paragraphTabStops, aO as readBorderSide, aP as readCellBorders, aQ as readTableBorders, aR as resolveBorderConflict, aS as resolveRunStyle, aT as resolveTableCellBorderGrid, aU as runStylesEqual, aV as tabAdvanceWidth, aW as tabStopsFingerprint, aX as unionLayoutBoxes, aY as withDefaultTabInterval } from './semantic-records-DoW_xNgJ.js';
 import { O as OoxmlNode, a as OoxmlElement, e as OoxmlPart } from './ooxml-tree-BU0e3DVi.js';
-import { O as OoxmlProperty, C as ContentControlKind, n as ContentControlLevel, o as ContentControlLock, p as ContentControlDataBinding, I as ImpactClass } from './tree-op-types-D0fTNBVW.js';
-export { m as TableBorderStyle } from './tree-op-types-D0fTNBVW.js';
+import { O as OoxmlProperty, C as ContentControlKind, n as ContentControlLevel, o as ContentControlLock, p as ContentControlDataBinding, I as ImpactClass } from './tree-op-types-fZgbrR5F.js';
+export { m as TableBorderStyle } from './tree-op-types-fZgbrR5F.js';
 import { N as NoteKind, n as noteTypeOf } from './note-nodes-BPSTVDMr.js';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties } from './review-reads-HDvoQXK2.js';
-export { p as paragraphOrderOfPart } from './review-reads-HDvoQXK2.js';
-import { D as DocumentProperties, T as TreeModelChange } from './tree-store-CIKASRHk.js';
+import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties } from './review-reads-C5E7u-pt.js';
+export { p as paragraphOrderOfPart } from './review-reads-C5E7u-pt.js';
+import { D as DocumentProperties, T as TreeModelChange } from './tree-store-Dy9FZ1pa.js';
 import { R as RevisionDisplayMode } from './revision-projection-UKqvPa4-.js';
 export { D as DEFAULT_REVISION_DISPLAY_MODE, a as RevisionAttribution, b as RevisionKind, f as formatRevisionOf, m as markRevisionRemovesMark, p as paragraphMarkFormatRevisionOf, c as paragraphMarkRevisionOf, d as paragraphMarkRevisionsOf, r as revisionsAreDeletion, e as revisionsVisible, s as shownMarkRevision } from './revision-projection-UKqvPa4-.js';
-import { a as SectionColumns } from './semantic-cell-selection-B5vfPz4Q.js';
-export { C as CellSelection, D as DEFAULT_SECTION_PROPERTIES, b as DEFAULT_VERTICAL_WEIGHT, c as DocumentSection, d as DocumentSectionsEnumeration, e as DrawingOverlayFrame, H as HitPoint, f as HitTestOptions, M as MAX_DOCUMENT_SECTIONS, P as PlacedCell, g as SectionBreakType, h as SectionColumnDefinition, i as SectionMargins, j as SectionPageNumbering, S as SectionProperties, k as SemanticHit, l as SemanticHitDrawing, T as TableCellAddress, m as TableCellContext, n as caretBoxOnLine, o as cellSelectionBetween, p as cellSelectionRects, q as cellSelectionText, r as contentControlAtPoint, s as enumerateDocumentSections, t as enumerateDocumentSectionsBounded, u as findDrawingOverlayFrameInLayout, v as geometryOfSection, w as hitTestPage, x as hitTestSheet, y as isFurniturePoint, z as lineEndOffset, A as pageAtY, B as paragraphSectionNode, E as paragraphsInCells, F as parsePageNumbering, G as parseSectionProperties, I as readSectionProperties, J as spanOffsetX, K as spansInCells, L as tableContextAt } from './semantic-cell-selection-B5vfPz4Q.js';
+import { a as SectionColumns } from './semantic-cell-selection-C8RC0VnN.js';
+export { C as CellSelection, D as DEFAULT_SECTION_PROPERTIES, b as DEFAULT_VERTICAL_WEIGHT, c as DocumentSection, d as DocumentSectionsEnumeration, e as DrawingOverlayFrame, H as HitPoint, f as HitTestOptions, M as MAX_DOCUMENT_SECTIONS, P as PlacedCell, g as SectionBreakType, h as SectionColumnDefinition, i as SectionMargins, j as SectionPageNumbering, S as SectionProperties, k as SemanticHit, l as SemanticHitDrawing, T as TableCellAddress, m as TableCellContext, n as caretBoxOnLine, o as cellSelectionBetween, p as cellSelectionRects, q as cellSelectionText, r as contentControlAtPoint, s as enumerateDocumentSections, t as enumerateDocumentSectionsBounded, u as findDrawingOverlayFrameInLayout, v as geometryOfSection, w as hitTestPage, x as hitTestSheet, y as isFurniturePoint, z as lineEndOffset, A as pageAtY, B as paragraphSectionNode, E as paragraphsInCells, F as parsePageNumbering, G as parseSectionProperties, I as readSectionProperties, J as spanOffsetX, K as spansInCells, L as tableContextAt } from './semantic-cell-selection-C8RC0VnN.js';
 export { M as MAX_SDT_NESTING, c as collectFlowBlocks, a as contentControlContentChildren, i as isContentControl, b as isContentControlContent } from './content-control-walk-D06GijR0.js';
-export { h as CommentAnchor, i as CommentPosition, C as CommentRecord, j as CommentThreadState, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, k as ReviewParagraphAnchor, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, W as W15_NAMESPACE_URI, l as activeReviewItem, m as anchorLineY, n as commentBodyText, o as commentInitials, p as firstReviewRange, r as reviewAnchorIndex, q as reviewItemGeometry, s as reviewItemKey, t as reviewItemPositionRank, u as reviewItemRanges, v as reviewItemsAt, w as reviewThreadRootOf } from './review-support-D4ZBdUXa.js';
-import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection } from './semantic-interaction-lvpzZRpA.js';
-export { c as CaretAtOptions, C as CaretGeometry, M as MoveCaretOptions, N as NavigationCommand, d as caretAt, e as caretStops, f as caretStopsForBlocks, g as compositionAnchor, h as contentControlAtSemantic, i as contentControlsInLayout, j as hitTestSemantic, m as moveCaret, p as paragraphTextFromLayout, s as spansInSelection } from './semantic-interaction-lvpzZRpA.js';
-import './image-resources-Cl5_cNi9.js';
+export { h as CommentAnchor, i as CommentPosition, C as CommentRecord, j as CommentThreadState, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, k as ReviewParagraphAnchor, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, W as W15_NAMESPACE_URI, l as activeReviewItem, m as anchorLineY, n as commentBodyText, o as commentInitials, p as firstReviewRange, r as reviewAnchorIndex, q as reviewItemGeometry, s as reviewItemKey, t as reviewItemPositionRank, u as reviewItemRanges, v as reviewItemsAt, w as reviewThreadRootOf } from './review-support-Cr2n7f1-.js';
+import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection } from './semantic-interaction-C45D_oG2.js';
+export { c as CaretAtOptions, C as CaretGeometry, M as MoveCaretOptions, N as NavigationCommand, d as caretAt, e as caretStops, f as caretStopsForBlocks, g as compositionAnchor, h as contentControlAtSemantic, i as contentControlsInLayout, j as hitTestSemantic, m as moveCaret, p as paragraphTextFromLayout, s as spansInSelection } from './semantic-interaction-C45D_oG2.js';
+import './image-resources-BWd5u-op.js';
 import './ooxml-package-D_CtywTW.js';
 
 /**
@@ -121,6 +121,15 @@ interface ParagraphLayoutCache<T> {
     set(key: ParagraphLayoutKey, value: T): void;
     /** Drop entries for paragraphs a commit removed, so the cache cannot grow without bound. */
     retain(keys: ReadonlySet<ParagraphLayoutKey>): void;
+    /**
+     * Whether THIS published pass should pay for a document-wide {@link retain} sweep.
+     *
+     * Retention only trims memory — the aging window tolerates deferral — while building the
+     * union of live keys costs real time on a large document, so callers ask per pass and
+     * sweep on a stride. Per cache instance, so one editor's cadence cannot starve another's.
+     * Optional for compatibility: a cache without it is retained on every pass.
+     */
+    retentionPassDue?(): boolean;
     clear(): void;
     readonly stats: LayoutCacheStats;
 }
@@ -171,11 +180,16 @@ interface ParagraphLayoutCacheOptions {
     readonly maxEntries?: number;
 }
 /**
- * A bounded least-recently-used cache.
+ * A bounded least-recently-used cache with generation-scoped retention.
  *
  * Bounded because a long editing session touches far more paragraph states than a document
  * contains — every keystroke mints a new key for the paragraph being typed in — and an
  * unbounded cache would hold every intermediate state of the session.
+ *
+ * The bound never evicts the CURRENT working set: entries stamped by this generation's
+ * retain or touched since it began are skipped, and the map grows past `maxEntries` when a
+ * document is larger than the configured cap — evicting live entries made every full pass
+ * on a 500-page document re-measure the whole document.
  */
 declare function createParagraphLayoutCache<T>(options?: ParagraphLayoutCacheOptions): ParagraphLayoutCache<T>;
 
@@ -1421,6 +1435,13 @@ interface NotesLayoutInput {
      * drawing records, which is what a headless caller with no image port wants.
      */
     readonly drawingsForPart?: (ownerPartName: string) => NoteStoryDrawings | undefined;
+    /**
+     * Part-level drawing epoch covering the notes parts, standing in for
+     * {@link drawingsForPart}'s closure in the notes-pass memo (the closure is rebuilt per
+     * pass, so only an epoch can say "the drawing state did not move"). A caller that
+     * supplies `drawingsForPart` without this keeps the rebuild path.
+     */
+    readonly drawingLayoutEpoch?: string;
 }
 /**
  * The layout with notes attached, plus any fallbacks taken and the mark context used.
@@ -1473,7 +1494,9 @@ declare function filterRefsOnPage(page: PageRecord, allRefs: readonly PageRefHit
  * notes then compete for the same band. Oversized notes still split/continue within the budget;
  * {@link MIN_FOOTNOTE_BODY_BAND_PT} keeps a body band so reflow cannot chase blank sheets.
  */
-declare function computeFootnoteReserves(layout: SemanticLayout, allRefs: readonly PageRefHit[], input: NotesLayoutInput, noteMarks: NoteMarkContext): {
+declare function computeFootnoteReserves(layout: SemanticLayout, allRefs: readonly PageRefHit[], input: NotesLayoutInput, noteMarks: NoteMarkContext, 
+/** Session-carried notes memo (opaque; owned by this module). */
+passMemo?: unknown): {
     readonly reserves: ReadonlyMap<number, number>;
     readonly stable: boolean;
     readonly reasons: readonly NotePaginationFallbackReason[];
@@ -1485,6 +1508,11 @@ declare function computeFootnoteReserves(layout: SemanticLayout, allRefs: readon
 declare function attachNotesToLayout(layout: SemanticLayout, allRefs: readonly PageRefHit[], input: NotesLayoutInput, options?: {
     readonly fallbackReasons?: readonly NotePaginationFallbackReason[];
     readonly paragraphSectionIndex?: ReadonlyMap<string, number>;
+    /**
+     * Session-carried notes memo, already validated against `allRefs` and `input`.
+     * Opaque at this boundary; the shape is owned by this module.
+     */
+    readonly memo?: unknown;
 }): NotesAttachResult;
 /**
  * Build a continuous (pre-page) mark context for the first body layout pass.
@@ -1628,6 +1656,30 @@ interface LayoutSession {
     keys: string[];
     /** Geometry and producer of the previous pass; a change to either forces a full pass. */
     context: string;
+    /**
+     * Whether the previous pass read page PARITY: even/odd header variants, or an anchored
+     * drawing positioned against an inside/outside frame or alignment.
+     *
+     * The document page index is not part of {@link context} — page numbers re-project at
+     * finalize and page shells renumber at remap — so parity is the only page-position input
+     * that can invalidate a section's layout. Tracked separately so the common document pays
+     * nothing for a start-index shift.
+     */
+    parityDependent: boolean;
+    /** Parity (0/1) of the document page index this session's layout started on. */
+    startPageParity: number;
+    /**
+     * The section's memoized prepass (prepared blocks, cache keys, flow keys, document
+     * order), reused verbatim while its inputs are unchanged. Opaque here: the shape is
+     * owned by `semantic-layout.ts`, which is the only reader and writer.
+     */
+    prepass: unknown;
+    /**
+     * The notes pass's memoized state (reference hits, mark contexts, per-page attach
+     * results), reused while its inputs are unchanged. Opaque here: the shape is owned by
+     * `note-pagination.ts`, which is the only reader and writer.
+     */
+    notes: unknown;
     /** Line counter at the start of the previous pass, for translating reused section counts. */
     startLineCounter: number;
     /**
@@ -1718,6 +1770,23 @@ interface SemanticLayoutOptions {
      * nobody touched are never measured again.
      */
     readonly cache?: ParagraphLayoutCache<readonly PendingLine[]>;
+    /**
+     * Collector for the cache keys a pass wants retained, instead of retaining directly.
+     * Supplied by the multi-section orchestrator, which retains once over the union —
+     * retaining per section evicted every other section's entries. `false` skips retention
+     * for this pass entirely (the orchestrator strides sweeps). See
+     * {@link retainLiveBreakKeys}.
+     */
+    readonly retainKeys?: Set<string> | false;
+    /**
+     * Part-level drawing projection/resource epoch for the section prepass memo.
+     *
+     * Moves whenever any drawing projection or resource state in the part does, standing in
+     * for the per-paragraph drawing tokens the memo would otherwise have to recompute to
+     * validate. A caller that supplies `drawingTokenForParagraph` without this epoch keeps
+     * the recompute path — the memo must never miss a token move it cannot see.
+     */
+    readonly drawingLayoutEpoch?: string;
     /**
      * Who produced the measurements, folded into every cache key.
      *

package/dist/layout.js

@@ -1 +1 @@
-export{fa as AUTO_PARAGRAPH_SPACING_PT,Nb as AUTO_PREFERRED_WIDTH,Pb as CELL_PAD,$ as COMPOUND_BORDER_MIN_GAP_PT,_ as COMPOUND_BORDER_MIN_STROKE_PT,pd as DEFAULT_CANVAS_FONT_STACK,Rb as DEFAULT_CELL_MARGINS,Q as DEFAULT_PAGE_GEOMETRY,cb as DEFAULT_REVISION_DISPLAY_MODE,Ya as DEFAULT_RUN_STYLE,Ic as DEFAULT_SECTION_PROPERTIES,Ca as DEFAULT_TAB_INTERVAL_PT,Ba as DEFAULT_TAB_INTERVAL_TWIPS,kc as DEFAULT_VERTICAL_WEIGHT,Yb as EMPTY_NUMBERING_INDEX,Ea as EMPTY_TAB_STOPS,p as GRAPHEME_SEGMENTER_LOCALE,g as HARFBUZZ_SHAPING_LIBRARY,j as HarfBuzzShapingError,ea as MAX_BORDER_SPACE_PT,da as MAX_BORDER_WIDTH_PT,Hc as MAX_DOCUMENT_SECTIONS,fd as MAX_EACH_PAGE_MARK_CANDIDATES,Vb as MAX_LVL_OVERRIDES,Na as MAX_LVL_TEXT_LENGTH,Ma as MAX_MARKER_TEXT_LENGTH,Tc as MAX_NOTES_LAID_OUT,Uc as MAX_NOTE_FRAGMENTS,ed as MAX_NOTE_OVERFLOW_PAGES,dd as MAX_NOTE_REFLOW_ATTEMPTS,Ub as MAX_NUMBERING_DEFINITIONS,ca as MAX_PARAGRAPH_SPACING_PT,sb as MAX_STYLE_BASED_ON_DEPTH,tb as MAX_STYLE_DEFINITIONS,Fb as MAX_TABLE_BORDER_STROKES,Ob as MAX_TABLE_NESTING,Ac as MAX_TABLE_ROW_FRAGMENTS,Qb as MAX_TABLE_ROW_HEIGHT_PT,Aa as MAX_TAB_POSITION_TWIPS,za as MAX_TAB_STOPS,ha as PARAGRAPH_BORDER_SIDES,P as ResolvedCache,ga as SINGLE_LINE_SPACING,Da as TAB_LEADER_GLYPH,Bc as TablePaginationError,n as UnsupportedScriptError,E as WORD_SEGMENTER_LOCALE,ta as appliedSpaceBefore,ka as applyLineSpacing,kd as attachNotesToLayout,bb as baselineShiftPtOf,Mb as borderExtentPt,Jb as borderWeight,qa as bottomBorderExtentPt,H as boundedFallbackWordSegments,Wb as buildNumberingIndex,hd as buildPageRefIndex,vb as buildStyleCascadeTable,N as captureOperationSnapshot,Ed as caretAt,tc as caretBoxOnLine,Cd as caretStops,Dd as caretStopsForBlocks,wb as cascadeParagraphFormatting,yb as cascadeRunProperties,xb as cascadedBottomBorder,na as cascadedParagraphBorders,Fa as cascadedTabStops,Md as cellSelectionBetween,Pd as cellSelectionRects,Qd as cellSelectionText,Oa as clampListValue,sa as collapsedSpaceBefore,Kd as compositionAnchor,aa as computeDoubleBorderMetricsPt,jd as computeFootnoteReserves,qc as contentControlAtPoint,Gd as contentControlAtSemantic,ud as contentControlBoundaries,Hd as contentControlsInLayout,X as contentControlsOfLayout,I as createBoundedFallbackWordBoundary,J as createDefaultWordBoundary,nd as createFixedMeasurer,m as createHarfBuzzTextShaper,G as createIntlWordBoundary,xd as createLayoutScheduler,md as createLayoutSession,Zb as createListCounterState,ob as createParagraphLayoutCache,vd as createShapedMeasurer,e as createShapedRun,b as createShapingEnvironment,_c as defaultNoteSeparatorRuleStyle,Ia as defaultTabIntervalFromSettings,Qc as deriveNoteDisplayMarks,Rc as deriveNoteDisplayMarksResolved,_a as displayText,fc as documentOrder,Eb as effectiveBorderSide,Z as effectiveContentControlLock,Ec as emptyTocPlaceholderParagraphIds,Fc as emptyTocSuppressedResultParagraphIds,Nc as enumerateDocumentSections,Oc as enumerateDocumentSectionsBounded,Wa as expandLvlText,id as filterRefsOnPage,uc as findDrawingOverlayFrameInLayout,Xc as findSeparatorNote,a as fixedPoint,Pa as formatDecimal,Qa as formatDecimalZero,Ua as formatLowerLetter,Sa as formatLowerRoman,Va as formatNumFmt,Xa as formatPageNumber,jb as formatRevisionOf,Ta as formatUpperLetter,Ra as formatUpperRoman,gd as fragmentOwnsAtomOffset,V as fragmentsOfParagraph,Pc as geometryOfSection,s as graphemeBoundaryEpoch,w as graphemeCount,y as graphemeOffsetToUtf16,O as guardOperationSnapshot,k as harfBuzzFontValidator,nc as hitTestPage,Fd as hitTestSemantic,pc as hitTestSheet,h as initializeHarfBuzz,r as intlGraphemeBoundary,rd as isCanvasMeasurementAvailable,C as isCumulativeGeometryTrustedFromLineOrigin,mc as isFurniturePoint,B as isGeometryTrustedCaretOffset,i as isHarfBuzzInitialized,q as isIntlSegmenterAvailable,F as isIntlWordSegmenterAvailable,$c as isMarkerOnlySeparatorNote,ub as isValidStyleId,A as isWholeGraphemeHorizontalBoundary,o as itemizeScriptFontSlots,zd as keyedRangeRects,Gc as layoutHeaderFooterStory,Zc as layoutNoteById,ad as layoutNoteSeparator,Yc as layoutNoteStory,od as layoutSemanticDocument,W as lineAtPosition,rc as lineEndOffset,T as linesOf,ec as listMarkerBox,hb as markRevisionRemovesMark,$a as measureDisplayText,ac as mergeListIndent,Jd as moveCaret,Ja as nextTabDestination,Wc as normalNotesOf,Sc as noteDisplayMarkMap,Vc as noteLineIdPrefix,lb as noteMarkKey,cd as noteSeparatorAreaBox,Db as noteStoryBlocks,lc as pageAtY,wd as pagesToMaterialize,pa as paragraphBorderExtentPt,oa as paragraphBorderStrokeWidthPt,ma as paragraphBorders,ra as paragraphBordersFingerprint,ba as paragraphBreaksBefore,la as paragraphContextualSpacing,R as paragraphFragmentsOf,S as paragraphFragmentsOfBlocks,nb as paragraphLayoutKey,ja as paragraphLineSpacing,Ab as paragraphMarkDeleted,fb as paragraphMarkFormatRevisionOf,ib as paragraphMarkRevisionOf,eb as paragraphMarkRevisionsOf,Lc as paragraphSectionNode,xa as paragraphShading,ya as paragraphShadingBox,ia as paragraphSpacing,Ga as paragraphTabStops,Id as paragraphTextFromLayout,Nd as paragraphsInCells,Jc as parsePageNumbering,Kc as parseSectionProperties,Ad as positionPastDeletion,mb as projectedNoteMarkText,ld as provisionalNoteMarks,Gb as readBorderSide,Ib as readCellBorders,_b as readNumPr,Mc as readSectionProperties,Hb as readTableBorders,Tb as readTableStructure,v as resetGraphemeBoundary,Kb as resolveBorderConflict,td as resolveDefaultSurfaceMeasurer,K as resolveDefaultWordBoundary,Xb as resolveNumberingLevel,va as resolveOoxmlShadingFill,zb as resolveParagraphLayoutInputs,Za as resolveRunStyle,cc as resolveStoryListItems,ua as resolveStrictHexFill,Lb as resolveTableCellBorderGrid,Bb as revisionRemovesParagraph,kb as revisionsAreDeletion,db as revisionsVisible,l as roundFontUnitToFixedPoint,ab as runStylesEqual,t as segmentGraphemes,L as segmentWords,yd as selectionRects,D as semanticHorizontalBoundaries,u as setGraphemeBoundary,wa as shadingFillFromElement,z as shapedHorizontalBoundaries,f as shapedRunComparatorInputs,d as shapingEnvironmentFingerprint,c as shapingEnvironmentFingerprintInputs,gb as shownMarkRevision,sc as spanOffsetX,Od as spansInCells,Ld as spansInSelection,Cb as storyBlocks,bd as syntheticSeparatorBox,Ka as tabAdvanceWidth,La as tabStopsFingerprint,Rd as tableContextAt,Sb as tableOriginX,Dc as tocFieldChromeParagraphIds,sd as tryCreateCanvasMeasurer,Y as unionLayoutBoxes,x as utf16OffsetToGrapheme,bc as walkStoryParagraphs,Ha as withDefaultTabInterval,$b as withNumberingStyleLinks,dc as withResolvedListItems,Bd as wordBoundary,M as wordSegmentsToGraphemeRecords}from'./chunk-OPKOTVQQ.js';export{a as setHarfBuzzWasmUrl}from'./chunk-WU7PUTVA.js';export{a as W15_NAMESPACE_URI,i as activeReviewItem,k as anchorLineY,c as commentBodyText,d as commentInitials,f as firstReviewRange,l as reviewAnchorIndex,m as reviewItemGeometry,b as reviewItemKey,g as reviewItemPositionRank,e as reviewItemRanges,h as reviewItemsAt,j as reviewThreadRootOf}from'./chunk-UVIUNAQ6.js';import'./chunk-SMRD66T5.js';export{d as FontResolutionError,c as HARD_MAX_AGGREGATE_FONT_BYTES,a as HARD_MAX_FONT_BYTES,b as HARD_MAX_FONT_SOURCES,Kb as MAX_SDT_NESTING,pf as MAX_TABLE_COLUMNS,j as boundedStructuralFontValidator,Pb as collectFlowBlocks,Ob as contentControlContentChildren,k as createFontResourceSnapshot,e as fontRequestKey,Lb as isContentControl,Mb as isContentControlContent,tg as paragraphOrderOfPart,i as sha256FontBytes}from'./chunk-R75OLPL6.js';
+export{fa as AUTO_PARAGRAPH_SPACING_PT,Pb as AUTO_PREFERRED_WIDTH,Rb as CELL_PAD,$ as COMPOUND_BORDER_MIN_GAP_PT,_ as COMPOUND_BORDER_MIN_STROKE_PT,rd as DEFAULT_CANVAS_FONT_STACK,Tb as DEFAULT_CELL_MARGINS,Q as DEFAULT_PAGE_GEOMETRY,db as DEFAULT_REVISION_DISPLAY_MODE,Za as DEFAULT_RUN_STYLE,Kc as DEFAULT_SECTION_PROPERTIES,Da as DEFAULT_TAB_INTERVAL_PT,Ca as DEFAULT_TAB_INTERVAL_TWIPS,mc as DEFAULT_VERTICAL_WEIGHT,_b as EMPTY_NUMBERING_INDEX,Fa as EMPTY_TAB_STOPS,p as GRAPHEME_SEGMENTER_LOCALE,g as HARFBUZZ_SHAPING_LIBRARY,j as HarfBuzzShapingError,ea as MAX_BORDER_SPACE_PT,da as MAX_BORDER_WIDTH_PT,Jc as MAX_DOCUMENT_SECTIONS,hd as MAX_EACH_PAGE_MARK_CANDIDATES,Xb as MAX_LVL_OVERRIDES,Oa as MAX_LVL_TEXT_LENGTH,Na as MAX_MARKER_TEXT_LENGTH,Vc as MAX_NOTES_LAID_OUT,Wc as MAX_NOTE_FRAGMENTS,gd as MAX_NOTE_OVERFLOW_PAGES,fd as MAX_NOTE_REFLOW_ATTEMPTS,Wb as MAX_NUMBERING_DEFINITIONS,ca as MAX_PARAGRAPH_SPACING_PT,ub as MAX_STYLE_BASED_ON_DEPTH,vb as MAX_STYLE_DEFINITIONS,Hb as MAX_TABLE_BORDER_STROKES,Qb as MAX_TABLE_NESTING,Cc as MAX_TABLE_ROW_FRAGMENTS,Sb as MAX_TABLE_ROW_HEIGHT_PT,Ba as MAX_TAB_POSITION_TWIPS,Aa as MAX_TAB_STOPS,ha as PARAGRAPH_BORDER_SIDES,P as ResolvedCache,ga as SINGLE_LINE_SPACING,Ea as TAB_LEADER_GLYPH,Dc as TablePaginationError,n as UnsupportedScriptError,E as WORD_SEGMENTER_LOCALE,ua as appliedSpaceBefore,la as applyLineSpacing,md as attachNotesToLayout,cb as baselineShiftPtOf,Ob as borderExtentPt,Lb as borderWeight,ra as bottomBorderExtentPt,H as boundedFallbackWordSegments,Yb as buildNumberingIndex,jd as buildPageRefIndex,xb as buildStyleCascadeTable,N as captureOperationSnapshot,Hd as caretAt,vc as caretBoxOnLine,Fd as caretStops,Gd as caretStopsForBlocks,yb as cascadeParagraphFormatting,Ab as cascadeRunProperties,zb as cascadedBottomBorder,oa as cascadedParagraphBorders,Ga as cascadedTabStops,Pd as cellSelectionBetween,Sd as cellSelectionRects,Td as cellSelectionText,Pa as clampListValue,ta as collapsedSpaceBefore,Nd as compositionAnchor,aa as computeDoubleBorderMetricsPt,ld as computeFootnoteReserves,sc as contentControlAtPoint,Jd as contentControlAtSemantic,wd as contentControlBoundaries,Kd as contentControlsInLayout,X as contentControlsOfLayout,I as createBoundedFallbackWordBoundary,J as createDefaultWordBoundary,pd as createFixedMeasurer,m as createHarfBuzzTextShaper,G as createIntlWordBoundary,zd as createLayoutScheduler,od as createLayoutSession,$b as createListCounterState,pb as createParagraphLayoutCache,xd as createShapedMeasurer,e as createShapedRun,b as createShapingEnvironment,ad as defaultNoteSeparatorRuleStyle,Ja as defaultTabIntervalFromSettings,Sc as deriveNoteDisplayMarks,Tc as deriveNoteDisplayMarksResolved,$a as displayText,hc as documentOrder,Gb as effectiveBorderSide,Z as effectiveContentControlLock,Gc as emptyTocPlaceholderParagraphIds,Hc as emptyTocSuppressedResultParagraphIds,Pc as enumerateDocumentSections,Qc as enumerateDocumentSectionsBounded,Xa as expandLvlText,kd as filterRefsOnPage,wc as findDrawingOverlayFrameInLayout,Zc as findSeparatorNote,a as fixedPoint,Qa as formatDecimal,Ra as formatDecimalZero,Va as formatLowerLetter,Ta as formatLowerRoman,Wa as formatNumFmt,Ya as formatPageNumber,kb as formatRevisionOf,Ua as formatUpperLetter,Sa as formatUpperRoman,id as fragmentOwnsAtomOffset,V as fragmentsOfParagraph,Rc as geometryOfSection,s as graphemeBoundaryEpoch,w as graphemeCount,y as graphemeOffsetToUtf16,O as guardOperationSnapshot,k as harfBuzzFontValidator,pc as hitTestPage,Id as hitTestSemantic,rc as hitTestSheet,h as initializeHarfBuzz,r as intlGraphemeBoundary,td as isCanvasMeasurementAvailable,C as isCumulativeGeometryTrustedFromLineOrigin,oc as isFurniturePoint,B as isGeometryTrustedCaretOffset,i as isHarfBuzzInitialized,q as isIntlSegmenterAvailable,F as isIntlWordSegmenterAvailable,bd as isMarkerOnlySeparatorNote,wb as isValidStyleId,A as isWholeGraphemeHorizontalBoundary,o as itemizeScriptFontSlots,Bd as keyedRangeRects,Ic as layoutHeaderFooterStory,$c as layoutNoteById,cd as layoutNoteSeparator,_c as layoutNoteStory,qd as layoutSemanticDocument,W as lineAtPosition,tc as lineEndOffset,T as linesOf,gc as listMarkerBox,ib as markRevisionRemovesMark,ab as measureDisplayText,cc as mergeListIndent,Md as moveCaret,Ka as nextTabDestination,Yc as normalNotesOf,Uc as noteDisplayMarkMap,Xc as noteLineIdPrefix,mb as noteMarkKey,ed as noteSeparatorAreaBox,Fb as noteStoryBlocks,nc as pageAtY,yd as pagesToMaterialize,qa as paragraphBorderExtentPt,pa as paragraphBorderStrokeWidthPt,na as paragraphBorders,sa as paragraphBordersFingerprint,ba as paragraphBreaksBefore,ma as paragraphContextualSpacing,R as paragraphFragmentsOf,S as paragraphFragmentsOfBlocks,ob as paragraphLayoutKey,ka as paragraphLineSpacing,Cb as paragraphMarkDeleted,gb as paragraphMarkFormatRevisionOf,jb as paragraphMarkRevisionOf,fb as paragraphMarkRevisionsOf,Nc as paragraphSectionNode,ya as paragraphShading,za as paragraphShadingBox,ja as paragraphSpacing,Ha as paragraphTabStops,Ld as paragraphTextFromLayout,Qd as paragraphsInCells,Lc as parsePageNumbering,Mc as parseSectionProperties,Dd as positionPastDeletion,nb as projectedNoteMarkText,nd as provisionalNoteMarks,Ib as readBorderSide,Kb as readCellBorders,ac as readNumPr,Oc as readSectionProperties,Jb as readTableBorders,Vb as readTableStructure,v as resetGraphemeBoundary,Mb as resolveBorderConflict,vd as resolveDefaultSurfaceMeasurer,K as resolveDefaultWordBoundary,Zb as resolveNumberingLevel,wa as resolveOoxmlShadingFill,Bb as resolveParagraphLayoutInputs,_a as resolveRunStyle,ec as resolveStoryListItems,va as resolveStrictHexFill,Nb as resolveTableCellBorderGrid,Db as revisionRemovesParagraph,lb as revisionsAreDeletion,eb as revisionsVisible,l as roundFontUnitToFixedPoint,bb as runStylesEqual,t as segmentGraphemes,L as segmentWords,Ad as selectionRects,D as semanticHorizontalBoundaries,u as setGraphemeBoundary,xa as shadingFillFromElement,z as shapedHorizontalBoundaries,f as shapedRunComparatorInputs,d as shapingEnvironmentFingerprint,c as shapingEnvironmentFingerprintInputs,hb as shownMarkRevision,uc as spanOffsetX,Rd as spansInCells,Od as spansInSelection,Eb as storyBlocks,dd as syntheticSeparatorBox,La as tabAdvanceWidth,Ma as tabStopsFingerprint,Ud as tableContextAt,Ub as tableOriginX,Fc as tocFieldChromeParagraphIds,ud as tryCreateCanvasMeasurer,Y as unionLayoutBoxes,x as utf16OffsetToGrapheme,dc as walkStoryParagraphs,Ia as withDefaultTabInterval,bc as withNumberingStyleLinks,fc as withResolvedListItems,Ed as wordBoundary,M as wordSegmentsToGraphemeRecords}from'./chunk-QTUZFJ4O.js';export{a as setHarfBuzzWasmUrl}from'./chunk-WU7PUTVA.js';export{a as W15_NAMESPACE_URI,i as activeReviewItem,k as anchorLineY,c as commentBodyText,d as commentInitials,f as firstReviewRange,l as reviewAnchorIndex,m as reviewItemGeometry,b as reviewItemKey,g as reviewItemPositionRank,e as reviewItemRanges,h as reviewItemsAt,j as reviewThreadRootOf}from'./chunk-42PRWWVE.js';import'./chunk-GPJXQDHC.js';export{d as FontResolutionError,c as HARD_MAX_AGGREGATE_FONT_BYTES,a as HARD_MAX_FONT_BYTES,b as HARD_MAX_FONT_SOURCES,Kb as MAX_SDT_NESTING,qf as MAX_TABLE_COLUMNS,j as boundedStructuralFontValidator,Pb as collectFlowBlocks,Ob as contentControlContentChildren,k as createFontResourceSnapshot,e as fontRequestKey,Lb as isContentControl,Mb as isContentControlContent,xg as paragraphOrderOfPart,i as sha256FontBytes}from'./chunk-32HTRN7R.js';

package/dist/output.cjs

@@ -1 +1 @@
-'use strict';var chunkF7Z6PWAZ_cjs=require('./chunk-F7Z6PWAZ.cjs');require('./chunk-DGUHCJPF.cjs'),require('./chunk-IJ4V3LGV.cjs'),require('./chunk-SFMAIFEN.cjs'),require('./chunk-DY3QVCWC.cjs');Object.defineProperty(exports,"DEFAULT_FIELD_SHADING",{enumerable:true,get:function(){return chunkF7Z6PWAZ_cjs.h}});Object.defineProperty(exports,"paintSelectionOverlay",{enumerable:true,get:function(){return chunkF7Z6PWAZ_cjs.j}});Object.defineProperty(exports,"paintSemanticLayout",{enumerable:true,get:function(){return chunkF7Z6PWAZ_cjs.i}});
+'use strict';var chunkBRBRYJKE_cjs=require('./chunk-BRBRYJKE.cjs');require('./chunk-LEV2X47E.cjs'),require('./chunk-XRDTD4X3.cjs'),require('./chunk-DTR64XCS.cjs'),require('./chunk-WC3LI6FC.cjs');Object.defineProperty(exports,"DEFAULT_FIELD_SHADING",{enumerable:true,get:function(){return chunkBRBRYJKE_cjs.h}});Object.defineProperty(exports,"paintSelectionOverlay",{enumerable:true,get:function(){return chunkBRBRYJKE_cjs.j}});Object.defineProperty(exports,"paintSemanticLayout",{enumerable:true,get:function(){return chunkBRBRYJKE_cjs.i}});

package/dist/output.d.cts

@@ -1,8 +1,8 @@
-import { R as ReviewAuthorInfo } from './semantic-paint-IjbL-4CT.cjs';
-export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles, p as paintSemanticLayout } from './semantic-paint-IjbL-4CT.cjs';
-import { S as SemanticLayout } from './semantic-records-DEOs3_tE.cjs';
-import './image-resources-BaHz4QAd.cjs';
-import './tree-op-types-CUCwPWjT.cjs';
+import { R as ReviewAuthorInfo } from './semantic-paint-BUt0ePEW.cjs';
+export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles, p as paintSemanticLayout } from './semantic-paint-BUt0ePEW.cjs';
+import { S as SemanticLayout } from './semantic-records-CuT3Wsd-.cjs';
+import './image-resources-Bkmu1Jei.cjs';
+import './tree-op-types-QujrzgCz.cjs';
 import './ooxml-tree-BU0e3DVi.cjs';
 import './ooxml-package-CR5us6ad.cjs';
 import './revision-projection-WzlQGBJx.cjs';

package/dist/output.d.ts

@@ -1,8 +1,8 @@
-import { R as ReviewAuthorInfo } from './semantic-paint-BBPL3u5w.js';
-export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles, p as paintSemanticLayout } from './semantic-paint-BBPL3u5w.js';
-import { S as SemanticLayout } from './semantic-records-CdQvpUj1.js';
-import './image-resources-Cl5_cNi9.js';
-import './tree-op-types-D0fTNBVW.js';
+import { R as ReviewAuthorInfo } from './semantic-paint-DUkGLJ_L.js';
+export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles, p as paintSemanticLayout } from './semantic-paint-DUkGLJ_L.js';
+import { S as SemanticLayout } from './semantic-records-DoW_xNgJ.js';
+import './image-resources-BWd5u-op.js';
+import './tree-op-types-fZgbrR5F.js';
 import './ooxml-tree-BU0e3DVi.js';
 import './ooxml-package-D_CtywTW.js';
 import './revision-projection-UKqvPa4-.js';

package/dist/output.js

@@ -1 +1 @@
-export{h as DEFAULT_FIELD_SHADING,j as paintSelectionOverlay,i as paintSemanticLayout}from'./chunk-WAVN7MAT.js';import'./chunk-OPKOTVQQ.js';import'./chunk-WU7PUTVA.js';import'./chunk-UVIUNAQ6.js';import'./chunk-SMRD66T5.js';import'./chunk-R75OLPL6.js';
+export{h as DEFAULT_FIELD_SHADING,j as paintSelectionOverlay,i as paintSemanticLayout}from'./chunk-UE7KTQLK.js';import'./chunk-QTUZFJ4O.js';import'./chunk-WU7PUTVA.js';import'./chunk-42PRWWVE.js';import'./chunk-GPJXQDHC.js';import'./chunk-32HTRN7R.js';

package/dist/{review-reads-HDvoQXK2.d.ts → review-reads-C5E7u-pt.d.ts}

@@ -1,6 +1,6 @@
 import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
 import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
-import { R as RevisionAddress } from './tree-op-types-D0fTNBVW.js';
+import { R as RevisionAddress } from './tree-op-types-fZgbrR5F.js';
 
 /** `w:pos` — where a section's footnotes are laid out. */
 type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';

package/dist/{review-reads-Dr0CpW6u.d.cts → review-reads-ChgUq41I.d.cts}

@@ -1,6 +1,6 @@
 import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
 import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
-import { R as RevisionAddress } from './tree-op-types-CUCwPWjT.cjs';
+import { R as RevisionAddress } from './tree-op-types-QujrzgCz.cjs';
 
 /** `w:pos` — where a section's footnotes are laid out. */
 type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';

package/dist/{review-support-D4ZBdUXa.d.ts → review-support-Cr2n7f1-.d.ts}

@@ -1,5 +1,5 @@
 import { e as OoxmlPart, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
-import { R as RevisionAddress } from './tree-op-types-D0fTNBVW.js';
+import { R as RevisionAddress } from './tree-op-types-fZgbrR5F.js';
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";

package/dist/{review-support-T-riLz4Y.d.cts → review-support-oQrX6Xu3.d.cts}

@@ -1,5 +1,5 @@
 import { e as OoxmlPart, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
-import { R as RevisionAddress } from './tree-op-types-CUCwPWjT.cjs';
+import { R as RevisionAddress } from './tree-op-types-QujrzgCz.cjs';
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";

package/dist/{semantic-cell-selection-B5vfPz4Q.d.ts → semantic-cell-selection-C8RC0VnN.d.ts}

@@ -1,7 +1,7 @@
 import { e as OoxmlPart, a as OoxmlElement, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.js';
-import { P as PageGeometry, I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, a as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, b as TableRowFragmentRecord, c as TableCellFragmentRecord } from './semantic-records-CdQvpUj1.js';
+import { P as PageGeometry, I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, a as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, b as TableRowFragmentRecord, c as TableCellFragmentRecord } from './semantic-records-DoW_xNgJ.js';
 import { R as RevisionDisplayMode } from './revision-projection-UKqvPa4-.js';
-import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-lvpzZRpA.js';
+import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-C45D_oG2.js';
 
 /**
  * Hard ceiling on sections enumerated from a document (matches write-path

package/dist/{semantic-cell-selection-BTQFpN0S.d.cts → semantic-cell-selection-CQOgvtbT.d.cts}

@@ -1,7 +1,7 @@
 import { e as OoxmlPart, a as OoxmlElement, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.cjs';
-import { P as PageGeometry, I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, a as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, b as TableRowFragmentRecord, c as TableCellFragmentRecord } from './semantic-records-DEOs3_tE.cjs';
+import { P as PageGeometry, I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, a as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, b as TableRowFragmentRecord, c as TableCellFragmentRecord } from './semantic-records-CuT3Wsd-.cjs';
 import { R as RevisionDisplayMode } from './revision-projection-WzlQGBJx.cjs';
-import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-CDNEU_Tx.cjs';
+import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-f4GyBQ_1.cjs';
 
 /**
  * Hard ceiling on sections enumerated from a document (matches write-path

package/dist/{semantic-interaction-lvpzZRpA.d.ts → semantic-interaction-C45D_oG2.d.ts}

@@ -1,4 +1,4 @@
-import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-CdQvpUj1.js';
+import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-DoW_xNgJ.js';
 
 /** A caret position in the model. */
 interface SemanticPosition {

package/dist/{semantic-interaction-CDNEU_Tx.d.cts → semantic-interaction-f4GyBQ_1.d.cts}

@@ -1,4 +1,4 @@
-import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-DEOs3_tE.cjs';
+import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-CuT3Wsd-.cjs';
 
 /** A caret position in the model. */
 interface SemanticPosition {

package/dist/{semantic-paint-IjbL-4CT.d.cts → semantic-paint-BUt0ePEW.d.cts}

@@ -1,5 +1,5 @@
-import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-DEOs3_tE.cjs';
-import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-BaHz4QAd.cjs';
+import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-CuT3Wsd-.cjs';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-Bkmu1Jei.cjs';
 
 /**
  * Everything a host can say about ONE author's presentation. Every field is optional and
@@ -171,6 +171,10 @@ interface PaintOptions {
      *
      * When set, the matching `[data-docx-hf]` container is editable and every body
      * `.docx-page-content` box is inert; all other furniture stays read-only.
+     *
+     * Deliberately OUTSIDE the paint-reuse key: entering a header must not rebuild
+     * body sheets. Chrome is applied to already-painted nodes in place, the way TOC
+     * hover is.
      */
     readonly activeHeaderFooterRId?: string;
     /**
@@ -178,6 +182,8 @@ interface PaintOptions {
      *
      * Required with {@link activeHeaderFooterRId} so only one painted copy receives
      * `data-docx-hf-active` / the engine caret when the same rId appears on many pages.
+     * Also outside the paint-reuse key — moving the caret across shared copies retints
+     * markers in place rather than replacing every page.
      */
     readonly activeHeaderFooterPageIndex?: number;
     /**

package/dist/{semantic-paint-BBPL3u5w.d.ts → semantic-paint-DUkGLJ_L.d.ts}

@@ -1,5 +1,5 @@
-import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-CdQvpUj1.js';
-import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-Cl5_cNi9.js';
+import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-DoW_xNgJ.js';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-BWd5u-op.js';
 
 /**
  * Everything a host can say about ONE author's presentation. Every field is optional and
@@ -171,6 +171,10 @@ interface PaintOptions {
      *
      * When set, the matching `[data-docx-hf]` container is editable and every body
      * `.docx-page-content` box is inert; all other furniture stays read-only.
+     *
+     * Deliberately OUTSIDE the paint-reuse key: entering a header must not rebuild
+     * body sheets. Chrome is applied to already-painted nodes in place, the way TOC
+     * hover is.
      */
     readonly activeHeaderFooterRId?: string;
     /**
@@ -178,6 +182,8 @@ interface PaintOptions {
      *
      * Required with {@link activeHeaderFooterRId} so only one painted copy receives
      * `data-docx-hf-active` / the engine caret when the same rId appears on many pages.
+     * Also outside the paint-reuse key — moving the caret across shared copies retints
+     * markers in place rather than replacing every page.
      */
     readonly activeHeaderFooterPageIndex?: number;
     /**

package/dist/{semantic-records-DEOs3_tE.d.cts → semantic-records-CuT3Wsd-.d.cts}

@@ -1,9 +1,20 @@
-import { O as OoxmlProperty, k as DrawingAccessibility, S as SourceCrop, l as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, m as TableBorderStyle } from './tree-op-types-CUCwPWjT.cjs';
+import { O as OoxmlProperty, k as DrawingAccessibility, S as SourceCrop, l as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, m as TableBorderStyle } from './tree-op-types-QujrzgCz.cjs';
 import { O as OoxmlNode, o as OoxmlDrawingNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
-import { I as ImageResourceState } from './image-resources-BaHz4QAd.cjs';
+import { I as ImageResourceState } from './image-resources-Bkmu1Jei.cjs';
 import { a as RevisionAttribution } from './revision-projection-WzlQGBJx.cjs';
 
-/** Whether a paragraph must start a new page (`w:pageBreakBefore`). */
+/**
+ * Whether a paragraph must start a new page (`w:pageBreakBefore`).
+ *
+ * LAST WINS, like every other toggle read off the cascade (`paragraphKeeps` does the same
+ * for `w:keepNext`). An any-wins `.some()` cannot be switched off: a Chapter or Heading style
+ * carries `w:pageBreakBefore`, and Word writes `w:val="0"` on the one instance whose author
+ * unchecked the box — that paragraph still broke, so the document grew a blank page and every
+ * page number after it was wrong.
+ *
+ * An absent `w:val` is on (§17.17.4), and the off vocabulary is the whole of it — `off` is a
+ * spelling too, which {@link isOn} beside this already accepts.
+ */
 declare function paragraphBreaksBefore(props: readonly OoxmlProperty[]): boolean;
 /**
  * Soft ceiling matching the spike's resolved-style limit (31_680 twips ≈ 22"). Beyond
@@ -28,7 +39,7 @@ interface ParagraphSpacing {
 }
 /**
  * The gap Word substitutes when `w:beforeAutospacing` / `w:afterAutospacing` is on
- * (ECMA-376 §17.3.1.2, §17.3.1.13).
+ * (ECMA-376 §17.3.1.33, the `w:spacing` clause both attributes belong to).
  *
  * The attribute means "the consumer decides", and the authored `@before` / `@after` beside it
  * is IGNORED rather than used as the value. Word's answer is HTML's default `<p>` margin,
@@ -1572,19 +1583,15 @@ interface TextMeasurer {
  * asked for, so interaction sees each caret stop exactly once while paint sees everything.
  */
 declare function paragraphFragmentsOf(page: PageRecord, includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
-/**
- * Depth-first paragraph fragments of one block list, in reading order.
- *
- * The same walk as {@link paragraphFragmentsOf} for fragment lists that do not sit on the
- * page directly — a header/footer story's fragments, a note story's.
- */
 declare function paragraphFragmentsOfBlocks(blocks: readonly BlockFragmentRecord[], includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
 /** Every line in a layout, in reading order — the order caret navigation walks. */
 declare function linesOf(layout: SemanticLayout): LineRecord[];
 /** Every fragment belonging to one paragraph, in order, across page boundaries. */
 declare function fragmentsOfParagraph(layout: SemanticLayout, paragraphId: string): ParagraphFragmentRecord[];
 /** The line containing a model position, or null when the position is not laid out. */
-declare function lineAtPosition(layout: SemanticLayout, paragraphId: string, offset: number): LineRecord | null;
+declare function lineAtPosition(layout: SemanticLayout, paragraphId: string, offset: number, 
+/** Lines to test, when the caller already knows which ones can carry the paragraph. */
+candidates?: Iterable<LineRecord>): LineRecord | null;
 /** Every content-control boundary on a layout, preferring the layout-level list. */
 declare function contentControlsOfLayout(layout: SemanticLayout): readonly ContentControlBoundaryRecord[];
 /**

package/dist/{semantic-records-CdQvpUj1.d.ts → semantic-records-DoW_xNgJ.d.ts}

@@ -1,9 +1,20 @@
-import { O as OoxmlProperty, k as DrawingAccessibility, S as SourceCrop, l as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, m as TableBorderStyle } from './tree-op-types-D0fTNBVW.js';
+import { O as OoxmlProperty, k as DrawingAccessibility, S as SourceCrop, l as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, m as TableBorderStyle } from './tree-op-types-fZgbrR5F.js';
 import { O as OoxmlNode, o as OoxmlDrawingNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
-import { I as ImageResourceState } from './image-resources-Cl5_cNi9.js';
+import { I as ImageResourceState } from './image-resources-BWd5u-op.js';
 import { a as RevisionAttribution } from './revision-projection-UKqvPa4-.js';
 
-/** Whether a paragraph must start a new page (`w:pageBreakBefore`). */
+/**
+ * Whether a paragraph must start a new page (`w:pageBreakBefore`).
+ *
+ * LAST WINS, like every other toggle read off the cascade (`paragraphKeeps` does the same
+ * for `w:keepNext`). An any-wins `.some()` cannot be switched off: a Chapter or Heading style
+ * carries `w:pageBreakBefore`, and Word writes `w:val="0"` on the one instance whose author
+ * unchecked the box — that paragraph still broke, so the document grew a blank page and every
+ * page number after it was wrong.
+ *
+ * An absent `w:val` is on (§17.17.4), and the off vocabulary is the whole of it — `off` is a
+ * spelling too, which {@link isOn} beside this already accepts.
+ */
 declare function paragraphBreaksBefore(props: readonly OoxmlProperty[]): boolean;
 /**
  * Soft ceiling matching the spike's resolved-style limit (31_680 twips ≈ 22"). Beyond
@@ -28,7 +39,7 @@ interface ParagraphSpacing {
 }
 /**
  * The gap Word substitutes when `w:beforeAutospacing` / `w:afterAutospacing` is on
- * (ECMA-376 §17.3.1.2, §17.3.1.13).
+ * (ECMA-376 §17.3.1.33, the `w:spacing` clause both attributes belong to).
  *
  * The attribute means "the consumer decides", and the authored `@before` / `@after` beside it
  * is IGNORED rather than used as the value. Word's answer is HTML's default `<p>` margin,
@@ -1572,19 +1583,15 @@ interface TextMeasurer {
  * asked for, so interaction sees each caret stop exactly once while paint sees everything.
  */
 declare function paragraphFragmentsOf(page: PageRecord, includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
-/**
- * Depth-first paragraph fragments of one block list, in reading order.
- *
- * The same walk as {@link paragraphFragmentsOf} for fragment lists that do not sit on the
- * page directly — a header/footer story's fragments, a note story's.
- */
 declare function paragraphFragmentsOfBlocks(blocks: readonly BlockFragmentRecord[], includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
 /** Every line in a layout, in reading order — the order caret navigation walks. */
 declare function linesOf(layout: SemanticLayout): LineRecord[];
 /** Every fragment belonging to one paragraph, in order, across page boundaries. */
 declare function fragmentsOfParagraph(layout: SemanticLayout, paragraphId: string): ParagraphFragmentRecord[];
 /** The line containing a model position, or null when the position is not laid out. */
-declare function lineAtPosition(layout: SemanticLayout, paragraphId: string, offset: number): LineRecord | null;
+declare function lineAtPosition(layout: SemanticLayout, paragraphId: string, offset: number, 
+/** Lines to test, when the caller already knows which ones can carry the paragraph. */
+candidates?: Iterable<LineRecord>): LineRecord | null;
 /** Every content-control boundary on a layout, preferring the layout-level list. */
 declare function contentControlsOfLayout(layout: SemanticLayout): readonly ContentControlBoundaryRecord[];
 /**

package/dist/{shaped-measurer-C2SJAjV0.d.cts → shaped-measurer-CDcHzjhf.d.cts}

@@ -1,4 +1,4 @@
-import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-DEOs3_tE.cjs';
+import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-CuT3Wsd-.cjs';
 
 /**
  * A face, as something asks for it: family plus the two axes this engine admits.

package/dist/{shaped-measurer-l4o5ITJ0.d.ts → shaped-measurer-CakZ7g1s.d.ts}

@@ -1,4 +1,4 @@
-import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-CdQvpUj1.js';
+import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-DoW_xNgJ.js';
 
 /**
  * A face, as something asks for it: family plus the two axes this engine admits.