@docx-editor.dev/core 2.12.0 → 2.13.0

package/dist/layout.d.ts

@@ -1,22 +1,22 @@
-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-CkOGZQn9.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 shapedRunComparatorInputs, $ as shapingEnvironmentFingerprint, a0 as shapingEnvironmentFingerprintInputs } from './shaped-measurer-CkOGZQn9.js';
-import { d as LayoutBox, D as DrawingPoint, e as DrawingInsets, a as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, f as ThemeFonts, g as ParagraphSpacing, h as ParagraphLineSpacing, i as ParagraphBorderEdge, j as ParagraphBorders, k as ResolvedTabStops, S as SemanticLayout, B as BlockFragmentRecord, A as AnchoredDrawingRecord, l as PageRecord, R as ResolvedRunStyle, m as TableBorderSide, C as ContentControlBoundaryRecord$1, n as ContentControlLock, o as ParagraphFragmentRecord, L as LineRecord, p as InlineDrawingLayoutContext, T as TextMeasurer, H as HyperlinkProjector, F as FieldLinkProjector, q as StoryPageFieldNeeds, P as PageGeometry, r as CellBorderBox, s as TableBorderBox } from './semantic-records-CzI0ZEuR.js';
-export { t as AUTO_PARAGRAPH_SPACING_PT, u as BorderGridGeometry, v as ContentControlGeometryFragment, w as ContentControlLevel, 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 EquationFractionGeometry, N as EquationGeometry, O as EquationNaryGeometry, Q as EquationRadicalGeometry, U as EquationRowGeometry, V as EquationScriptGeometry, W as EquationSpanRecord, X as EquationTextGeometry, Y as FieldAtomMarker, Z as HeaderFooterStoryRecord, _ as HyperlinkFieldSpec, $ as LineSpacingRule, a0 as ListMarkerRecord, a1 as MAX_BORDER_SPACE_PT, a2 as MAX_BORDER_WIDTH_PT, a3 as MAX_PARAGRAPH_SPACING_PT, a4 as MAX_TABLE_BORDER_STROKES, a5 as MAX_TAB_POSITION_TWIPS, a6 as MAX_TAB_STOPS, a7 as PARAGRAPH_BORDER_SIDES, a8 as ParagraphAutoSpacingContext, a9 as ParagraphBorderSide, aa as ParagraphBorderStrokeRecord, ab as ParagraphBottomBorderRecord, ac as ParagraphIndent, ad as ResolvedCellBorders, ae as ResolvedTableBorderEdge, af as ResolvedTableBorderEdgeSegment, ag as ResolvedUnderline, ah as SINGLE_LINE_SPACING, ai as SourceRange, aj as SpanLinkRecord, ak as TAB_LEADER_GLYPH, al as TabAlignment, am as TabDestination, an as TabLeader, ao as TabStop, ap as TableBorderSideName, aq as TableBorderStrokeRecord, c as TableCellFragmentRecord, ar as TableFragmentRecord, b as TableRowFragmentRecord, as as VerticalAlign, at as appliedSpaceBefore, au as applyLineSpacing, av as baselineShiftPtOf, aw as borderExtentPt, ax as borderWeight, ay as bottomBorderExtentPt, az as cascadedParagraphBorders, aA as cascadedTabStops, aB as collapsedSpaceBefore, aC as defaultTabIntervalFromSettings, aD as displayText, aE as layoutEquation, aF as measureDisplayText, aG as nextTabDestination, aH as paragraphBorderExtentPt, aI as paragraphBorderStrokeWidthPt, aJ as paragraphBorders, aK as paragraphBordersFingerprint, aL as paragraphBreaksBefore, aM as paragraphContextualSpacing, aN as paragraphLineSpacing, aO as paragraphSpacing, aP as paragraphTabStops, aQ as readBorderSide, aR as readCellBorders, aS as readTableBorders, aT as resolveBorderConflict, aU as resolveRunStyle, aV as resolveTableCellBorderGrid, aW as runStylesEqual, aX as tabAdvanceWidth, aY as tabStopsFingerprint, aZ as withDefaultTabInterval } from './semantic-records-CzI0ZEuR.js';
-import { a as OoxmlNode, s as OoxmlProperty, g as OoxmlElement, I as ImpactClass, O as OoxmlPart, $ as ContentControlKind, a0 as ContentControlLevel, a1 as ContentControlLock$1, a2 as ContentControlDataBinding } from './tree-op-types-HKfUzt_-.js';
-export { M as TableBorderStyle } from './tree-op-types-HKfUzt_-.js';
-import { N as NoteKind, T as TreeModelChange, n as noteTypeOf } from './tree-store-B7hd6cEa.js';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties } from './note-properties-Bx7rXruA.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-qnBJziPx.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 shapedRunComparatorInputs, $ as shapingEnvironmentFingerprint, a0 as shapingEnvironmentFingerprintInputs } from './shaped-measurer-qnBJziPx.js';
+import { N as NumberingLevel, d as NumberingIndex, e as LayoutBox, D as DrawingPoint, f as DrawingInsets, a as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, S as SemanticLayout, B as BlockFragmentRecord, A as AnchoredDrawingRecord, g as PageRecord, h as TableBorderSide, C as ContentControlBoundaryRecord$1, i as ContentControlLock, j as ParagraphFragmentRecord, L as LineRecord, T as TextMeasurer, k as InlineDrawingLayoutContext, l as StyleCascadeTable, H as HyperlinkProjector, F as FieldLinkProjector, m as RefFieldContext, n as StoryPageFieldNeeds, P as PageGeometry, o as ResolvedListItem, p as CellBorderBox, q as TableCellStyleFormatting, r as TableBorderBox } from './semantic-records-BI1jpft7.js';
+export { s as AUTO_PARAGRAPH_SPACING_PT, t as AbstractNumDefinition, u as BorderGridGeometry, v as CascadedParagraphFormatting, w as ContentControlGeometryFragment, x as ContentControlLevel, y as ContentControlMappedType, z as DEFAULT_PAGE_GEOMETRY, E as DEFAULT_RUN_STYLE, G as DEFAULT_TAB_INTERVAL_PT, J as DEFAULT_TAB_INTERVAL_TWIPS, K as EMPTY_NUMBERING_INDEX, O as EMPTY_TAB_STOPS, Q as EquationFractionGeometry, U as EquationGeometry, V as EquationNaryGeometry, W as EquationRadicalGeometry, X as EquationRowGeometry, Y as EquationScriptGeometry, Z as EquationSpanRecord, _ as EquationTextGeometry, $ as FieldAtomMarker, a0 as HeaderFooterStoryRecord, a1 as HyperlinkFieldSpec, a2 as LevelOverride, a3 as LineSpacingRule, a4 as ListMarkerAlign, a5 as ListMarkerRecord, a6 as ListSuffix, a7 as MAX_BORDER_SPACE_PT, a8 as MAX_BORDER_WIDTH_PT, a9 as MAX_LVL_OVERRIDES, aa as MAX_NUMBERING_DEFINITIONS, ab as MAX_PARAGRAPH_SPACING_PT, ac as MAX_STYLE_BASED_ON_DEPTH, ad as MAX_STYLE_DEFINITIONS, ae as MAX_TABLE_BORDER_STROKES, af as MAX_TAB_POSITION_TWIPS, ag as MAX_TAB_STOPS, ah as NumDefinition, ai as NumberingLevelIndent, aj as PARAGRAPH_BORDER_SIDES, ak as PageRefCalibrationCell, al as PageRefFieldProjection, am as ParagraphAutoSpacingContext, an as ParagraphBorderEdge, ao as ParagraphBorderSide, ap as ParagraphBorderStrokeRecord, aq as ParagraphBorders, ar as ParagraphBottomBorderRecord, as as ParagraphIndent, at as ParagraphLayoutInputs, au as ParagraphLineSpacing, av as ParagraphSpacing, aw as RefFieldSpec, ax as RefNoteParts, ay as ResolvedCellBorders, R as ResolvedRunStyle, az as ResolvedTabStops, aA as ResolvedTableBorderEdge, aB as ResolvedTableBorderEdgeSegment, aC as ResolvedUnderline, aD as SINGLE_LINE_SPACING, aE as SourceRange, aF as SpanLinkRecord, aG as StyleDefinition, aH as TAB_LEADER_GLYPH, aI as TabAlignment, aJ as TabDestination, aK as TabLeader, aL as TabStop, aM as TableBorderSideName, aN as TableBorderStrokeRecord, c as TableCellFragmentRecord, aO as TableFragmentRecord, b as TableRowFragmentRecord, aP as VerticalAlign, aQ as appliedSpaceBefore, aR as applyLineSpacing, aS as baselineShiftPtOf, aT as borderExtentPt, aU as borderWeight, aV as bottomBorderExtentPt, aW as buildNumberingIndex, aX as buildStyleCascadeTable, aY as cascadeParagraphFormatting, aZ as cascadeRunProperties, a_ as cascadedBottomBorder, a$ as cascadedParagraphBorders, b0 as cascadedTabStops, b1 as collapsedSpaceBefore, b2 as defaultTabIntervalFromSettings, b3 as displayText, b4 as isValidStyleId, b5 as layoutEquation, b6 as listMarkerBox, b7 as measureDisplayText, b8 as mergeListIndent, b9 as nextTabDestination, ba as paragraphBorderExtentPt, bb as paragraphBorderStrokeWidthPt, bc as paragraphBorders, bd as paragraphBordersFingerprint, be as paragraphBreaksBefore, bf as paragraphContextualSpacing, bg as paragraphLineSpacing, bh as paragraphSpacing, bi as paragraphTabStops, bj as parseRefInstruction, bk as readBorderSide, bl as readCellBorders, bm as readNumPr, bn as readTableBorders, bo as resolveBorderConflict, bp as resolveNumberingLevel, bq as resolveParagraphLayoutInputs, br as resolveRunStyle, bs as resolveStoryListItems, bt as resolveStoryRefFields, bu as resolveTableCellBorderGrid, bv as runStylesEqual, bw as tabAdvanceWidth, bx as tabStopsFingerprint, by as walkStoryParagraphs, bz as withDefaultTabInterval, bA as withNumberingStyleLinks, bB as withResolvedListItems } from './semantic-records-BI1jpft7.js';
+import { a as OoxmlNode, s as OoxmlProperty, I as ImpactClass, g as OoxmlElement, O as OoxmlPart, T as TreeDocOp, b as OoxmlPackage, $ as ContentControlKind, a0 as ContentControlLevel, a1 as ContentControlLock$1, a2 as ContentControlDataBinding } from './tree-op-types-D6HzlPR4.js';
+export { _ as TableBorderStyle } from './tree-op-types-D6HzlPR4.js';
+import { N as NoteKind, T as TreeModelChange, n as noteTypeOf } from './tree-store-APgWx6qn.js';
+import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties } from './note-properties-CDFiNXcD.js';
 import { D as DocumentProperties } from './document-properties-D6Ahr8D6.js';
-import { a as RevisionAttribution, R as RevisionDisplayMode } from './revision-projection-B2v9U3qx.js';
-export { D as DEFAULT_REVISION_DISPLAY_MODE, 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-B2v9U3qx.js';
-import { a as SectionColumns } from './semantic-cell-selection-DsYz2Vg3.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-DsYz2Vg3.js';
-export { M as MAX_SDT_NESTING, c as collectFlowBlocks, a as commentBodyText, b as commentInitials, d as contentControlContentChildren, i as isContentControl, e as isContentControlContent, p as paragraphOrderOfPart } from './review-reads-UexYBp-m.js';
-import { a as ReviewItem } from './review-items-B78OsJU2.js';
-export { i as CommentAnchor, j as CommentPosition, C as CommentRecord, h as CommentThreadState, c as ReviewCommentItem, d as ReviewCustomItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, W as W15_NAMESPACE_URI, k as activeReviewItem, l as firstReviewRange, r as reviewItemKey, m as reviewItemPositionRank, n as reviewItemRanges, o as reviewItemsAt, p as reviewThreadRootOf } from './review-items-B78OsJU2.js';
-import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection } from './semantic-interaction-C00BpIyC.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 deletedTextBoundaries, k as hitTestSemantic, m as moveCaret, p as paragraphTextFromLayout, s as spansInSelection } from './semantic-interaction-C00BpIyC.js';
-import './omml-equation-69O1Pd8G.js';
+import { a as RevisionAttribution, R as RevisionDisplayMode } from './revision-projection-BmLtLPxH.js';
+export { D as DEFAULT_REVISION_DISPLAY_MODE, 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-BmLtLPxH.js';
+import { a as SectionColumns } from './semantic-cell-selection-BZ50i-Fu.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-BZ50i-Fu.js';
+export { M as MAX_SDT_NESTING, c as collectFlowBlocks, a as commentBodyText, b as commentInitials, d as contentControlContentChildren, i as isContentControl, e as isContentControlContent, p as paragraphOrderOfPart } from './review-reads-DcGYCH0w.js';
+import { a as ReviewItem } from './review-items-CCS1h93f.js';
+export { i as CommentAnchor, j as CommentPosition, C as CommentRecord, h as CommentThreadState, c as ReviewCommentItem, d as ReviewCustomItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, W as W15_NAMESPACE_URI, k as activeReviewItem, l as firstReviewRange, r as reviewItemKey, m as reviewItemPositionRank, n as reviewItemRanges, o as reviewItemsAt, p as reviewThreadRootOf } from './review-items-CCS1h93f.js';
+import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection } from './semantic-interaction-BDJ4TBjm.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 deletedTextBoundaries, k as hitTestSemantic, m as moveCaret, p as paragraphTextFromLayout, s as spansInSelection } from './semantic-interaction-BDJ4TBjm.js';
+import './omml-equation-BY49UOIF.js';
 import './contracts/types.js';
 
 /**
@@ -46,6 +46,45 @@ interface FieldPageContext {
  */
 declare function formatPageNumber(value: number, format: string | undefined): string;
 
+/**
+ * The result of counting ONE list paragraph: the level that applied, the counter vector after it,
+ * and the marker text a reader sees.
+ *
+ * Counters are a vector across all nine levels, not a single number, because a deeper level
+ * restarting resets the ones below it while leaving those above intact.
+ */
+interface ListCounterAdvance {
+    /** Effective abstract numbering template for this num instance. */
+    readonly abstractNumId: string;
+    readonly numId: string;
+    readonly ilvl: number;
+    readonly level: NumberingLevel;
+    /** Counter vector after this item was counted (indices 0..8). */
+    readonly counters: readonly number[];
+    /** Expanded marker text (empty when vanished / empty lvlText). */
+    readonly markerText: string;
+}
+/**
+ * The running counters for one layout pass over one story.
+ *
+ * Stateful and order-dependent by nature: a list number is a function of every numbered paragraph
+ * before it, which is why markers are computed during layout and cannot be read off a paragraph
+ * in isolation.
+ */
+interface ListCounterState {
+    /**
+     * Advance counters for one list paragraph.
+     *
+     * Returns null when the numbering definition cannot be resolved — callers treat the
+     * paragraph as non-list (inert fallback).
+     */
+    advance(numId: string, ilvl: number): ListCounterAdvance | null;
+}
+/**
+ * Create a fresh counter bag for one story (body, or one header/footer part).
+ */
+declare function createListCounterState(index: NumberingIndex): ListCounterState;
+
 /**
  * Lookup of derived display marks keyed by {@link formatNoteScopeId}.
  *
@@ -195,144 +234,6 @@ interface ParagraphLayoutCacheOptions {
  */
 declare function createParagraphLayoutCache<T>(options?: ParagraphLayoutCacheOptions): ParagraphLayoutCache<T>;
 
-/** Soft ceiling on abstractNum / num entries read from one part. */
-declare const MAX_NUMBERING_DEFINITIONS = 512;
-/** Soft ceiling on override entries per `w:num`. */
-declare const MAX_LVL_OVERRIDES = 9;
-/** `w:suff` — what separates a list marker from the text after it. */
-type ListSuffix = 'tab' | 'space' | 'nothing';
-/** `w:lvlJc` — how a list marker aligns within its own indent. */
-type ListMarkerAlign = 'left' | 'center' | 'right';
-/**
- * One level's indent, plus which parts the level actually AUTHORED.
- *
- * The provenance matters: `w:ind` cascades per-attribute, so a level that authored only `left`
- * must not overwrite an inherited `hanging` with a synthesized zero.
- */
-interface NumberingLevelIndent {
-    readonly left: number;
-    readonly right: number;
-    readonly hanging: number;
-    readonly firstLine: number;
-    /**
-     * Which of these the LEVEL actually authored.
-     *
-     * A level's `w:pPr/w:ind` sits between the paragraph style and direct formatting, so the
-     * merge has to tell "the level says left = 0" from "the level says nothing about left and
-     * the style's value stands". Absent (the default) reads as "says nothing", which is what a
-     * hand-built level in a test means.
-     */
-    readonly stated?: {
-        readonly left: boolean;
-        readonly right: boolean;
-        /** `w:hanging`/`w:firstLine` are one mutually exclusive slot (§17.3.1.10, §17.3.1.12). */
-        readonly firstLineOffset: boolean;
-    };
-}
-/** One `w:lvl`: how this depth numbers, what its marker looks like, and how it indents. */
-interface NumberingLevel {
-    readonly ilvl: number;
-    readonly start: number;
-    readonly numFmt: string;
-    readonly lvlText: string;
-    readonly lvlJc: ListMarkerAlign;
-    readonly suff: ListSuffix;
-    readonly indent: NumberingLevelIndent;
-    /**
-     * `w:lvlRestart` one-based trigger level, or `0` when the level never restarts.
-     * Omitted in XML → restart when the previous level (or any earlier level) is used.
-     */
-    readonly lvlRestart?: number;
-    /**
-     * `w:isLgl` (§17.9.9): render EVERY level referenced by this level's `w:lvlText` in
-     * decimal, whatever number format those levels declare for themselves.
-     */
-    readonly isLgl: boolean;
-    /** Level `w:rPr` as flat properties (for marker face / vanish). */
-    readonly runProperties: readonly OoxmlProperty[];
-    /** True when level run props request vanish — marker must not paint. */
-    readonly vanish: boolean;
-}
-/**
- * One `w:lvlOverride` on a `w:num`: a restart value, a replacement level, or both.
- *
- * How two lists share an abstract definition while numbering independently.
- */
-interface LevelOverride {
-    readonly startOverride?: number;
-    /** Full level replacement when `w:lvl` is present under the override. */
-    readonly level?: NumberingLevel;
-}
-/**
- * One `w:abstractNum` — the shape of a list, without being a list.
- *
- * Never referenced by a paragraph directly. Paragraphs name a {@link NumDefinition}, which names
- * one of these, so several lists can share a definition and still count separately.
- */
-interface AbstractNumDefinition {
-    readonly abstractNumId: string;
-    readonly levels: ReadonlyMap<number, NumberingLevel>;
-    /**
-     * `w:numStyleLink` (§17.9.21): this definition carries no levels of its own — the numbering
-     * lives on the named style. Word follows the link; resolve it with
-     * {@link resolveNumberingStyleLinks} before reading levels, or every paragraph on this
-     * abstract renders with NO marker at all.
-     */
-    readonly numStyleLink?: string;
-    /**
-     * `w:styleLink` (§17.9.23): the definition side of the same pair — this abstract IS the
-     * numbering of the named style. Kept so a link can be verified rather than assumed.
-     */
-    readonly styleLink?: string;
-}
-/**
- * One `w:num` — the thing a paragraph's `w:numId` actually names.
- *
- * Points at an {@link AbstractNumDefinition} and may override any of its levels.
- */
-interface NumDefinition {
-    readonly numId: string;
-    readonly abstractNumId: string;
-    readonly overrides: ReadonlyMap<number, LevelOverride>;
-}
-/**
- * The bounded projection of `numbering.xml` that list layout resolves against.
- *
- * Projection ONLY — never a mutation or serialization authority. Hostile values are dropped or
- * clamped, and a missing definition resolves to "no list" rather than a guess.
- */
-interface NumberingIndex {
-    readonly abstractNums: ReadonlyMap<string, AbstractNumDefinition>;
-    readonly nums: ReadonlyMap<string, NumDefinition>;
-}
-/**
- * Build a numbering index from the root of a numbering part (`w:numbering`).
- *
- * Empty / missing roots yield an empty index. Duplicate ids keep the first definition.
- */
-/**
- * Project `numbering.xml` into the bounded index.
- *
- * Every ceiling here exists because the input is file-derived: definition counts, override
- * counts, indent magnitudes and style-link hop depth are all capped, and nothing from the file
- * becomes a loop bound or an allocation size.
- */
-declare function buildNumberingIndex(root: OoxmlElement | null | undefined): NumberingIndex;
-/** Resolve the effective level for a `numId` + `ilvl`, applying overrides. */
-/**
- * The effective level for one paragraph's numbering reference, after overrides and style links.
- *
- * Answers null for a reference the index cannot resolve — a paragraph naming a definition the
- * file never declared is an unnumbered paragraph, not an error.
- */
-declare function resolveNumberingLevel(index: NumberingIndex, numId: string, ilvl: number): {
-    readonly abstractNumId: string;
-    readonly level: NumberingLevel;
-    readonly startOverride?: number;
-} | null;
-/** Empty index for tests / documents without numbering. */
-declare const EMPTY_NUMBERING_INDEX: NumberingIndex;
-
 type WrapTextSide = 'bothSides' | 'left' | 'right' | 'largest';
 interface WrapExclusionInput {
     readonly mode: 'square' | 'tight' | 'through' | 'topAndBottom';
@@ -400,234 +301,6 @@ interface PendingLine {
     anchorRevisions?: readonly RevisionAttribution[];
 }
 
-/** Horizontal alignment of a paragraph (`w:jc`, ECMA-376 §17.3.1.13). */
-type Alignment = 'left' | 'center' | 'right' | 'both';
-
-/** Soft ceiling on `basedOn` chain length — enough for real templates, refuses hostile graphs. */
-declare const MAX_STYLE_BASED_ON_DEPTH = 32;
-/** Soft ceiling on style definitions read from one styles part. */
-declare const MAX_STYLE_DEFINITIONS = 4096;
-/** One `w:style` as the cascade reads it: its properties, and the style it is based on. */
-interface StyleDefinition {
-    readonly styleId: string;
-    readonly type: string;
-    readonly basedOn: string | null;
-    /**
-     * `w:next` — the style Word gives the paragraph that FOLLOWS one in this style.
-     *
-     * Nothing in layout reads it: it is a rule about authoring, not about painting. It is
-     * read here because this is the one place `styles.xml` is parsed, and a second reader
-     * would be a second answer to what a style id means.
-     */
-    readonly next: string | null;
-    readonly paragraphProperties: readonly OoxmlProperty[];
-    readonly runProperties: readonly OoxmlProperty[];
-    /** The style's `w:pPr` node, when present — needed for nested `w:pBdr`. */
-    readonly paragraphPropertiesNode: OoxmlElement | undefined;
-    /** The style's `w:tblPr`, for a `w:type="table"` style. */
-    readonly tablePropertiesNode: OoxmlElement | undefined;
-    /**
-     * `w:tblStylePr` conditional formats by `w:type` (`firstRow`, `band1Horz`, …).
-     *
-     * Word puts a table's real appearance here: `Table Grid` carries its grid in the style's
-     * `w:tblBorders`, and the banded/​header looks live in these. A document states only
-     * `<w:tblStyle w:val="TableGrid"/>`.
-     */
-    readonly conditionalTableFormats: ReadonlyMap<string, OoxmlElement>;
-}
-/**
- * The whole styles part, indexed and ready to resolve against.
- *
- * `cacheToken` is load-bearing: it folds into layout cache producers so breaks measured under one
- * styles part are never reused under another.
- */
-interface StyleCascadeTable {
-    /**
-     * Bounded fingerprint folded into layout cache producers so a different styles part cannot
-     * reuse breaks measured under another cascade. Computed once per table (FNV-1a hex).
-     */
-    readonly cacheToken: string;
-    readonly docDefaultsRun: readonly OoxmlProperty[];
-    readonly docDefaultsParagraph: readonly OoxmlProperty[];
-    readonly docDefaultsParagraphNode: OoxmlElement | undefined;
-    /** `w:style[@w:default='1'][@w:type='paragraph']` — last wins among defaults of that type. */
-    readonly defaultParagraphStyleId: string | null;
-    /** `w:style[@w:default='1'][@w:type='character']` — last wins among defaults of that type. */
-    readonly defaultCharacterStyleId: string | null;
-    /**
-     * `w:style[@w:default='1'][@w:type='table']` — last wins among defaults of that type.
-     *
-     * A `w:tbl` with no `w:tblStyle` still resolves against this one. Word's own
-     * `TableNormal` is where the 0/108/0/108 twip cell margins live, so skipping it gives
-     * every unstyled table padding the document says it does not have.
-     */
-    readonly defaultTableStyleId: string | null;
-    /**
-     * The theme part's Latin typefaces, for `w:rFonts` theme references.
-     *
-     * Lives on the cascade because it is document-level style material with the same
-     * lifetime, and because every site that resolves run properties already holds this table.
-     */
-    readonly themeFonts: ThemeFonts;
-    readonly styles: ReadonlyMap<string, StyleDefinition>;
-}
-/**
- * A paragraph's properties after the cascade, plus the same list WITHOUT its own `w:pPr`.
- *
- * Both, because a writer needs to know what a paragraph INHERITS to decide whether setting a
- * value is a change or a no-op — and writing back an inherited value freezes it into the
- * paragraph as though the author had chosen it.
- */
-interface CascadedParagraphFormatting {
-    /** Flat paragraph properties in cascade order (defaults → bases → style → direct). */
-    readonly paragraphProperties: readonly OoxmlProperty[];
-    /**
-     * The same list WITHOUT the paragraph's own `w:pPr` — everything it inherits.
-     *
-     * Numbering needs the two tiers apart: a level's `w:pPr/w:ind` outranks the style's and is
-     * outranked by the paragraph's own, and a flattened list cannot say which is which.
-     */
-    readonly inheritedParagraphProperties: readonly OoxmlProperty[];
-    /** Matching `w:pPr` nodes for nested border resolution. */
-    readonly paragraphPropertyNodes: readonly OoxmlNode[];
-    /**
-     * Inherited run properties for CONTENT runs (before direct run `rPr`).
-     *
-     * Does NOT include direct `w:pPr/w:rPr` — that formats the paragraph MARK only
-     * (ECMA-376 §17.3.1.36). Folding mark `w:sz` into content made BodyText runs with no
-     * direct size paint at the mark's size (Selection Notice "or" alternative → 6.5pt).
-     */
-    readonly runProperties: readonly OoxmlProperty[];
-    /**
-     * Content cascade plus direct `w:pPr/w:rPr` — empty-line metrics and last-line mark height.
-     */
-    readonly markRunProperties: readonly OoxmlProperty[];
-    /**
-     * The style this paragraph resolved to, or null when it names none and there is no
-     * document default. `w:contextualSpacing` compares neighbours by exactly this.
-     */
-    readonly styleId: string | null;
-}
-/** Accepted style ids only — over-long, control-bearing, or dangerous keys are dropped. */
-declare function isValidStyleId(raw: string | undefined): raw is string;
-/**
- * What a table style contributes to the paragraphs of ONE cell: the style's whole-table
- * `w:pPr`/`w:rPr` followed by every `w:tblStylePr` the cell is under (17.7.6.6), weakest
- * first in the caller's condition order (banding, column, row, corner).
- *
- * This is how Word makes a header row bold and centred while the document states nothing
- * but `<w:tblStyle w:val="…"/>` on the table and plain runs in the cells.
- */
-interface TableCellStyleFormatting {
-    readonly paragraphProperties: readonly OoxmlProperty[];
-    /** Matching `w:pPr` nodes, for nested `w:pBdr` / `w:tabs` resolution. */
-    readonly paragraphPropertyNodes: readonly OoxmlElement[];
-    /** Inherited run properties for every run in the cell, before the paragraph style. */
-    readonly runProperties: readonly OoxmlProperty[];
-}
-/**
- * Build a cascade table from a styles part root.
- *
- * Only direct `w:style` children of the root participate (bounded count). Duplicate
- * `styleId` values keep the last definition, matching Word's reader for this fixture class.
- * Default paragraph/character style ids track `w:default="1"` with the same last-wins rule.
- */
-declare function buildStyleCascadeTable(stylesRoot: OoxmlElement | null, themeFonts?: ThemeFonts): StyleCascadeTable;
-/**
- * Cascade paragraph + inherited run properties for one paragraph's direct `w:pPr`.
- *
- * Order: `docDefaults` → table style → `basedOn` ancestors → paragraph style → direct
- * formatting, which is the style hierarchy of 17.7.2: a table style sits above the document
- * defaults and below the paragraph style a cell paragraph names for itself.
- * When `w:pStyle` is absent, the document's default paragraph style (`w:default="1"`) is used.
- * Direct formatting is last so it overrides inherited values inside the existing resolvers.
- */
-declare function cascadeParagraphFormatting(table: StyleCascadeTable, directPPr: OoxmlNode | undefined, tableCellStyle?: TableCellStyleFormatting): CascadedParagraphFormatting;
-/**
- * Bottom border after cascade: a later `w:pBdr` replaces an earlier one; absence inherits.
- * `nil`/`none` clear the edge via `paragraphBorders`.
- */
-declare function cascadedBottomBorder(paragraphPropertyNodes: readonly OoxmlNode[]): ParagraphBorderEdge | undefined;
-/**
- * Merge inherited paragraph-style run props with a run's direct `rPr` (direct last).
- *
- * When a cascade table is supplied, also resolves `w:rStyle` character styles (basedOn chain,
- * cycle/depth capped). Runs without an explicit `rStyle` pick up the default character style
- * (`w:default="1"`). Precedence: inherited → character style chain → direct formatting.
- *
- * PASS `inheritedRunProperties` BY IDENTITY. It must be an array
- * {@link cascadeParagraphFormatting} returned — `runProperties` or `markRunProperties` — and
- * not a copy of one. A toggle property (ECMA-376 §17.7.3) resolves per level of the style
- * hierarchy, and the levels below the character style resolve to more than a true or a false:
- * whether the document defaults' short circuit is still standing decides what the character
- * style's own toggle does next, and no single `w:b` element can spell that. The paragraph
- * cascade attaches that state to the array it returns, so spreading, filtering or sorting the
- * list drops it. (`Object.freeze` returns the same object, so that one is safe.) A list
- * without it is read as one ordinary level, which is the most a bare property list can say
- * and is what a caller assembling its own list gets.
- */
-declare function cascadeRunProperties(inheritedRunProperties: readonly OoxmlProperty[], directRunProperties: readonly OoxmlProperty[], table?: StyleCascadeTable): readonly OoxmlProperty[];
-/** Everything the line breaker needs about one paragraph, already cascaded and converted. */
-interface ParagraphLayoutInputs {
-    readonly props: OoxmlProperty[];
-    readonly indent: {
-        left: number;
-        right: number;
-        hanging: number;
-        firstLine: number;
-    };
-    readonly available: number;
-    readonly alignment: Alignment;
-    readonly spacing: ParagraphSpacing;
-    /** Resolved `w:line` / `w:lineRule`; single spacing where the cascade says nothing. */
-    readonly lineSpacing: ParagraphLineSpacing;
-    /** `w:contextualSpacing`: drop before/after between same-style neighbours. */
-    readonly contextualSpacing: boolean;
-    /** Resolved paragraph style id, for the `w:contextualSpacing` neighbour comparison. */
-    readonly styleId: string | null;
-    readonly bottomBorder: ParagraphBorderEdge | undefined;
-    /**
-     * Every `CT_PBdr` edge after cascade, not just the bottom one.
-     *
-     * `bottomBorder` stays alongside it because the fragment signature and the table flow
-     * read that field by name; this is the whole box, so a cell paragraph gets the same
-     * frame a body paragraph does.
-     */
-    readonly borders: ParagraphBorders;
-    /** Validated 6-hex paragraph shading fill from cascaded `w:pPr/w:shd`, absent for none. */
-    readonly shading: string | undefined;
-    readonly inheritedRunProperties: readonly OoxmlProperty[];
-    /**
-     * Paragraph-mark cascade (`inheritedRunProperties` + direct `w:pPr/w:rPr`).
-     * Empty-line sizing and last-line mark height — never content-run face.
-     */
-    readonly markRunProperties: readonly OoxmlProperty[];
-    /** Cascaded custom tab stops + default interval for paragraph-flow breaking. */
-    readonly tabStops: ResolvedTabStops;
-    /**
-     * Fingerprint folded into the paragraph layout cache key — nested `w:tabs` are absent
-     * from flat property bags, so style-inherited stops must be named explicitly.
-     */
-    readonly tabStopsCacheToken: string;
-    /** Resolved list marker inputs when the paragraph participates in numbering. */
-    readonly listItem?: ResolvedListItem;
-}
-/**
- * Resolve every paragraph input semantic layout / table cells share: cascaded props when a
- * style table is present, otherwise direct formatting only.
- *
- * When `listItem` is provided, its merged level indent becomes the paragraph indent (list
- * hanging / left from `numbering.xml`), which is what Word uses for fixture list paragraphs
- * that author no direct `w:ind`.
- *
- * `tableCellStyle` carries what the enclosing table's style says about this cell's
- * paragraphs; body paragraphs pass nothing.
- *
- * `inTableCell` is asked for separately because a cell paragraph may have no table style to
- * inherit at all, and `w:beforeAutospacing` still needs to know it is in a cell.
- */
-declare function resolveParagraphLayoutInputs(paragraph: OoxmlElement, contentWidth: number, styleCascade: StyleCascadeTable | undefined, listItem?: ResolvedListItem, tableCellStyle?: TableCellStyleFormatting, inTableCell?: boolean): ParagraphLayoutInputs;
-
 /**
  * What a batch of commits can affect.
  *
@@ -793,6 +466,12 @@ interface MultiSectionLayoutState {
     previousRemapped: readonly PageRecord[];
     previousFinalized: SemanticLayout | null;
     previousPageCount: number;
+    /**
+     * The PAGEREF assignment token of the pages behind `previousFinalized`. A target can move
+     * sheets while the TOC page's own remapped record stays identity-unchanged, so the finalized
+     * restore must compare this before handing back a previously substituted sheet.
+     */
+    previousPageRefToken: string;
 }
 /**
  * Carried-over state that makes layout incremental.
@@ -891,99 +570,21 @@ interface LayoutSession {
  */
 declare function createLayoutSession(): LayoutSession;
 
-/**
- * A paragraph's list membership fully resolved: definition, level, marker text and geometry.
- *
- * `markerText` is already expanded through the counter state, so it is the string a reader sees
- * rather than the `w:lvlText` template.
- */
-interface ResolvedListItem {
-    readonly numId: string;
-    readonly ilvl: number;
-    readonly abstractNumId: string;
-    /** `w:numFmt` of the resolved level — `bullet` or a numbering format. */
-    readonly numFmt: string;
-    readonly markerText: string;
-    readonly markerAlign: ListMarkerAlign;
-    readonly suffix: ListSuffix;
-    /** Effective indent after merging level + paragraph indents, in points. */
-    readonly indent: NumberingLevelIndent;
-    readonly markerStyle: ResolvedRunStyle;
-    /** Fingerprint for layout cache keys (indent, marker text, marker face). */
-    readonly cacheToken: string;
+type AutonumFieldKind = 'AUTONUM' | 'AUTONUMLGL' | 'AUTONUMOUT';
+/** One recognized AUTONUM-family instruction: the kind and its supported switches. */
+interface AutonumFieldSpec {
+    readonly kind: AutonumFieldKind;
+    /** ST_NumberFormat resolved from the `\*` switch; null paints decimal. */
+    readonly numFmt: string | null;
+    /** `\e`: display the number without its trailing period. */
+    readonly suppressPeriod: boolean;
 }
 /**
- * Read `w:numPr` from cascaded paragraph-property nodes (last wins).
- *
- * Flat `OoxmlProperty[]` bags drop nested `ilvl`/`numId`, so this walks the tree nodes
- * the same way borders and tabs do.
- */
-declare function readNumPr(paragraphPropertyNodes: readonly OoxmlNode[]): {
-    numId: string;
-    ilvl: number;
-} | null;
-/**
- * Resolve `w:numStyleLink` delegation using the document's styles (§17.9.21).
- *
- * Without a style table there is nothing to follow, so the index is returned unchanged —
- * and so it is when nothing delegates, which keeps layout cache identity.
- */
-declare function withNumberingStyleLinks(index: NumberingIndex, styleCascade: StyleCascadeTable | undefined): NumberingIndex;
-/**
- * The effective indent of a list paragraph: STYLE, then the numbering LEVEL, then DIRECT.
- *
- * Word applies a level's `w:pPr/w:ind` between the paragraph style and the paragraph's own
- * formatting, per attribute — and the ordering matters on real documents. A converted
- * agreement numbers its `(a)` items with a level stating `left=1512 hanging=738` under a
- * `ListParagraph` style stating `left=775 hanging=624`, and states only `hanging="737"` on
- * the paragraph itself. Reading the flattened cascade as "the paragraph's indent" gave the
- * STYLE's 775 to a level that had overridden it, so every lettered sub-item hung a full
- * indent step to the left of where Word puts it.
- *
- * `inherited` is the cascade WITHOUT the paragraph's own `w:pPr` (defaults, table cell style,
- * style chain); `direct` is that `w:pPr` alone.
- */
-declare function mergeListIndent(levelIndent: NumberingLevelIndent, inherited: readonly OoxmlProperty[], direct?: readonly OoxmlProperty[]): NumberingLevelIndent;
-/**
- * Collect paragraphs of a block list in document order, descending into tables.
- *
- * Caps nesting so a hostile nested-table document cannot recurse without bound.
+ * Recognize `AUTONUM | AUTONUMLGL | AUTONUMOUT [\* <format>] [\e] [\* MERGEFORMAT]`, or null
+ * for anything else. Any unrecognized switch fails the parse so the field stays inert (paints
+ * nothing — its historical rendering), never the raw instruction, never a guessed number.
  */
-declare function walkStoryParagraphs(blocks: readonly OoxmlElement[], maxTableDepth?: number): OoxmlElement[];
-/**
- * Resolve every list paragraph in a story to a {@link ResolvedListItem}, keyed by node id.
- *
- * Non-list paragraphs are absent from the map. Hostile / missing numbering resolves inertly
- * (paragraph omitted — laid out as ordinary text).
- */
-declare function resolveStoryListItems(blocks: readonly OoxmlElement[], index: NumberingIndex, styleCascade: StyleCascadeTable | undefined, isFontAvailable?: (family: string) => boolean): ReadonlyMap<string, ResolvedListItem>;
-/**
- * Attach a full-story list-item map to layout options.
- *
- * Resolves once over `blocks` (body story including table cells) so counters continue across
- * section boundaries. No-ops when numbering is absent.
- */
-declare function withResolvedListItems<T extends {
-    readonly numberingIndex?: NumberingIndex;
-    readonly listItems?: ReadonlyMap<string, ResolvedListItem>;
-    readonly styleCascade?: StyleCascadeTable;
-    readonly isFontAvailable?: (family: string) => boolean;
-}>(options: T, blocks: readonly OoxmlElement[]): T & {
-    readonly numberingIndex: NumberingIndex;
-    readonly listItems?: ReadonlyMap<string, ResolvedListItem>;
-};
-/**
- * Horizontal marker box inside the hanging indent slot.
- *
- * Coordinates are relative to the same origin as paragraph content (`indent.left` is the
- * text start). Returns null when there is nothing to paint.
- */
-declare function listMarkerBox(item: ResolvedListItem, markerWidth: number, lineY: number, lineHeight: number): {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-} | null;
+declare function parseAutonumInstruction(raw: string): AutonumFieldSpec | null;
 
 /**
  * What one cell side is before any ADJACENT cell has its say.
@@ -1092,7 +693,13 @@ declare function selectionRects(layout: SemanticLayout, selection: SemanticSelec
  * it is wrong for every caret outside that story. A caller with no story in hand passes
  * {@link everyStoryOrder}.
  */
-order: readonly string[]): SelectionRect[];
+order: readonly string[], 
+/**
+ * For EXACT edge x positions inside a span. Layout no longer publishes eager per-character
+ * caret edges, so without a measurer an intra-span boundary interpolates across the span's
+ * advance — visibly wrong in a proportional face. Pass the layout's measurer.
+ */
+measurer?: TextMeasurer): SelectionRect[];
 /** A model range to highlight, and the key the caller knows it by. */
 interface KeyedRange {
     readonly key: string;
@@ -1116,7 +723,9 @@ declare function keyedRangeRects(layout: SemanticLayout, ranges: readonly KeyedR
  * materialized pages is what keeps typing in a heavily reviewed document as fast as
  * typing in a clean one.
  */
-pages?: ReadonlySet<number>): Map<string, SelectionRect[]>;
+pages?: ReadonlySet<number>, 
+/** For exact intra-span edge positions (see {@link selectionRects}). */
+measurer?: TextMeasurer): Map<string, SelectionRect[]>;
 
 /**
  * The next word boundary from `offset`, in `direction`.
@@ -1674,9 +1283,25 @@ interface LayoutNoteStoryOptions {
      * paint to anchor and navigation to activate.
      */
     readonly projectLink?: HyperlinkProjector;
+    /**
+     * Per-part projector, preferred over `projectLink` when `ownerPartName` names the part.
+     *
+     * A `w:hyperlink` in `/word/footnotes.xml` declares its `r:id` in `footnotes.xml.rels`,
+     * so it must resolve there — the body projector answers from the body part's
+     * relationships, and when the two parts assign one id to different targets the footnote
+     * link navigated to the body's target. Same per-part rule pictures follow through
+     * {@link drawingsForPart}.
+     */
+    readonly projectLinkForPart?: (ownerPartName: string) => HyperlinkProjector | undefined;
     readonly projectFieldLink?: FieldLinkProjector;
     /** Document properties for a document-property field inside a note story. */
     readonly documentProperties?: DocumentProperties;
+    /**
+     * The document's resolved REF inputs, so a footnote's cross-reference paints the live
+     * value the body paints. The flow folds each paragraph's resolved values into its break
+     * key, which is what repaints a note after a renumbering edit it cannot otherwise see.
+     */
+    readonly refFields?: RefFieldContext;
     /** Derived display marks for noteRef projection inside the note body. */
     readonly noteMarks?: NoteMarkContext;
     /**
@@ -1742,8 +1367,16 @@ declare function syntheticSeparatorBox(contentWidth: number, flowHeight: number)
 /** Absolute separator box: short rule for marker/synthetic, full width for authored stories. */
 declare function noteSeparatorAreaBox(separator: NoteSeparatorLayout, contentX: number, contentWidth: number, areaTop: number): LayoutBox;
 
-/** Bound on reflow attempts per document layout pass. */
-declare const MAX_NOTE_REFLOW_ATTEMPTS = 8;
+/**
+ * Bound on reflow attempts for an UNSEEDED document layout pass (cold open).
+ *
+ * Sized for a cold open of a reference-dense document: adoption is a forward fixed-point
+ * iteration whose settled prefix extends a few pages per round, so a legal document with a
+ * hundred footnotes converges in tens of rounds (a 53-page/108-note fixture took 24).
+ * Orbits exit earlier through the fingerprint/envelope checks below, so the cap is a
+ * safety bound, not the expected cost.
+ */
+declare const MAX_NOTE_REFLOW_ATTEMPTS = 64;
 /** Cap on empty pages created solely to drain footnote/endnote overflow. */
 declare const MAX_NOTE_OVERFLOW_PAGES = 256;
 /**
@@ -1798,9 +1431,32 @@ interface NotesLayoutInput {
      * sanitized record a body one does instead of painting dead text.
      */
     readonly projectLink?: HyperlinkProjector;
+    /**
+     * Per notes-part link projector, preferred over `projectLink`: a `w:hyperlink` inside
+     * `/word/footnotes.xml` or `/word/endnotes.xml` declares its `r:id` in that part's own
+     * `.rels`, not the body part's. The surface supplies this; the inherited body projector
+     * remains only a fallback for callers without per-part resolution.
+     */
+    readonly projectLinkForPart?: (ownerPartName: string) => HyperlinkProjector | undefined;
+    /**
+     * Content token over the notes parts' relationship records, standing in for
+     * {@link projectLinkForPart}'s closure in the notes-pass memo. The projector reads
+     * relationship state the pinned part identity cannot see move: a replicated rels-only
+     * change lands without splicing the notes part, so only a content token catches it.
+     * Required whenever `projectLinkForPart` is supplied — without it the memo is disabled,
+     * the same fail-closed rule `drawingsForPart` follows through `drawingLayoutEpoch`.
+     */
+    readonly linkRelsEpoch?: string;
     readonly projectFieldLink?: FieldLinkProjector;
     /** Document properties for a document-property field inside a note story. */
     readonly documentProperties?: DocumentProperties;
+    /**
+     * The document's resolved REF inputs, so a footnote's cross-reference paints the live
+     * value the body paints. Normally injected by `semantic-layout` from the context it built
+     * over the body and note stories; its values token joins the notes-pass fingerprint so a
+     * renumbering edit repaints the notes that cite the renumbered target.
+     */
+    readonly refFields?: RefFieldContext;
     /**
      * Inline drawing support per notes part. Absent means note paragraphs flow without
      * drawing records, which is what a headless caller with no image port wants.
@@ -1867,7 +1523,14 @@ declare function filterRefsOnPage(page: PageRecord, allRefs: readonly PageRefHit
  */
 declare function computeFootnoteReserves(layout: SemanticLayout, allRefs: readonly PageRefHit[], input: NotesLayoutInput, noteMarks: NoteMarkContext, 
 /** Session-carried notes memo (opaque; owned by this module). */
-passMemo?: unknown): {
+passMemo?: unknown, 
+/**
+ * The reserve map `layout` was laid under. Feeds the hold-out's observed-refusal test
+ * (a block the body pass declined to split under a known budget only moves whole);
+ * absent, the hold-out releases the ambiguous cases — a caller outside the reflow loop
+ * must not manufacture holds the loop never observed.
+ */
+previousReserves?: ReadonlyMap<number, number>): {
     readonly reserves: ReadonlyMap<number, number>;
     readonly stable: boolean;
     readonly reasons: readonly NotePaginationFallbackReason[];
@@ -2256,45 +1919,6 @@ declare function formatNumFmt(numFmt: string, value: number): string;
  */
 declare function expandLvlText(lvlText: string, counters: readonly number[], formats: readonly string[]): string;
 
-/**
- * The result of counting ONE list paragraph: the level that applied, the counter vector after it,
- * and the marker text a reader sees.
- *
- * Counters are a vector across all nine levels, not a single number, because a deeper level
- * restarting resets the ones below it while leaving those above intact.
- */
-interface ListCounterAdvance {
-    /** Effective abstract numbering template for this num instance. */
-    readonly abstractNumId: string;
-    readonly numId: string;
-    readonly ilvl: number;
-    readonly level: NumberingLevel;
-    /** Counter vector after this item was counted (indices 0..8). */
-    readonly counters: readonly number[];
-    /** Expanded marker text (empty when vanished / empty lvlText). */
-    readonly markerText: string;
-}
-/**
- * The running counters for one layout pass over one story.
- *
- * Stateful and order-dependent by nature: a list number is a function of every numbered paragraph
- * before it, which is why markers are computed during layout and cannot be read off a paragraph
- * in isolation.
- */
-interface ListCounterState {
-    /**
-     * Advance counters for one list paragraph.
-     *
-     * Returns null when the numbering definition cannot be resolved — callers treat the
-     * paragraph as non-list (inert fallback).
-     */
-    advance(numId: string, ilvl: number): ListCounterAdvance | null;
-}
-/**
- * Create a fresh counter bag for one story (body, or one header/footer part).
- */
-declare function createListCounterState(index: NumberingIndex): ListCounterState;
-
 /**
  * The stack used when a run names no font (or names one the sink refuses).
  *
@@ -2405,6 +2029,42 @@ declare function tryCreateCanvasMeasurer(options?: CanvasMeasurerOptions): TextM
  */
 declare function resolveDefaultSurfaceMeasurer(scale?: number, options?: CanvasMeasurerOptions): ResolvedSurfaceMeasurer;
 
+type RefreshFieldResultsOp = Extract<TreeDocOp, {
+    op: 'refreshFieldResults';
+}>;
+
+interface RefFieldRefreshOptions {
+    /**
+     * The package the part belongs to, for the note-part half of the resolution context —
+     * the same context paint uses, so a body REF that targets a footnote bookmark computes
+     * the same value both places. Absent narrows resolution to body-declared bookmarks.
+     */
+    readonly package?: OoxmlPackage;
+    readonly styleCascade?: StyleCascadeTable;
+    readonly numberingIndex?: NumberingIndex;
+    /** The mode the surface painted under, so the saved values match the painted ones. */
+    readonly displayMode?: RevisionDisplayMode;
+    /**
+     * The DISPLAYED page number of one paragraph in the current finalized layout, or null when
+     * it is not placed. PAGEREF results ride the plan through this: the value is pagination's,
+     * so only a caller holding the laid-out pages can answer, and a plan without it keeps every
+     * PAGEREF result as loaded. The same calibration verdict paint took gates each rewrite.
+     */
+    readonly pageRefPageNumberOf?: (targetParagraphId: string) => string | null;
+}
+/**
+ * A {@link RefFieldRefreshOptions.pageRefPageNumberOf} source over one finalized layout.
+ *
+ * Builds the target → host-page index once, on first demand, and answers every field from
+ * it — the same walk finalize substitution takes, so the saved number is the painted one.
+ */
+declare function pageRefPageNumbersFromLayout(layout: SemanticLayout): (targetParagraphId: string) => string | null;
+/**
+ * Plan the refresh for one body part, or null when every supported REF result is already
+ * fresh (the no-op save path — no transaction, no revision bump, no undo entry).
+ */
+declare function planRefFieldResultRefresh(part: OoxmlPart, options: RefFieldRefreshOptions): RefreshFieldResultsOp | null;
+
 /**
  * The story's blocks — paragraphs and tables — in document order, flattening through
  * block-level content-control wrappers under the shared nesting budget.
@@ -2873,4 +2533,4 @@ declare class TablePaginationError extends Error {
     constructor(code: TablePaginationErrorCode, message: string);
 }
 
-export { AUTO_PREFERRED_WIDTH, type AbstractNumDefinition, type BidiEmbeddingLevels, BlockFragmentRecord, CELL_PAD, COMPOUND_BORDER_MIN_GAP_PT, COMPOUND_BORDER_MIN_STROKE_PT, type CanvasMeasurerOptions, type CanvasTextContext, type CanvasTextMetrics, type CascadedParagraphFormatting, CellBorderBox, type CellMarginsPt, type CellVerticalAlign, type CompoundBorderMetrics, ContentControlBoundaryRecord$1 as ContentControlBoundaryRecord, type ContentControlFragmentRecord, ContentControlLock, DEFAULT_CANVAS_FONT_STACK, DEFAULT_CELL_MARGINS, EMPTY_NUMBERING_INDEX, FieldLinkProjector, FixedPoint, FixedPointRoundingMode, FontByteValidator, type FontSlot, GRAPHEME_SEGMENTER_LOCALE, type GraphemeBoundary, type GraphemeSegment, type GraphemeWordSegmentRecord, HARFBUZZ_SHAPING_LIBRARY, type HarfBuzzFaceCacheEvent, type HarfBuzzOutlineCacheEvent, type HarfBuzzShapeCacheEvent, HarfBuzzShapingError, type HarfBuzzShapingErrorCode, type HarfBuzzTextShaper, type HarfBuzzTextShaperInstrumentation, type HarfBuzzTextShaperOptions, type HeaderFooterVariantName, HyperlinkProjector, type KeyedRange, LayoutBox, type LayoutCacheStats, type LayoutScheduler, type LayoutSchedulerOptions, type LayoutScope, type LayoutSession, type LayoutSessionStats, type LevelOverride, LineRecord, type ListCounterAdvance, type ListCounterState, type ListMarkerAlign, type ListSuffix, MAX_EACH_PAGE_MARK_CANDIDATES, MAX_LVL_OVERRIDES, MAX_LVL_TEXT_LENGTH, MAX_MARKER_TEXT_LENGTH, MAX_NOTES_LAID_OUT, MAX_NOTE_FRAGMENTS, MAX_NOTE_OVERFLOW_PAGES, MAX_NOTE_REFLOW_ATTEMPTS, MAX_NUMBERING_DEFINITIONS, MAX_STYLE_BASED_ON_DEPTH, MAX_STYLE_DEFINITIONS, MAX_TABLE_COLUMNS, MAX_TABLE_NESTING, MAX_TABLE_ROW_FRAGMENTS, MAX_TABLE_ROW_HEIGHT_PT, type MaterializationInput, type NoteDisplayMark, type NoteLayoutFallbackReason, type NoteMarkContext, type NotePaginationFallbackReason, type NoteReferenceSite, type NoteSeparatorLayout, type NoteSeparatorRuleStyle, type NoteStoryDrawings, type NoteStoryLayout, type NotesAttachResult, type NotesLayoutInput, type NumDefinition, type NumberingIndex, type NumberingLevel, type NumberingLevelIndent, type PageFurniture, PageGeometry, PageRecord, type PageRefIndex, ParagraphBorderEdge, ParagraphBorders, ParagraphFragmentRecord, type ParagraphKeyInputs, type ParagraphLayoutCache, type ParagraphLayoutCacheOptions, type ParagraphLayoutInputs, ParagraphLineSpacing, ParagraphSpacing, type PreferredWidth, type PreferredWidthType, type ResolvedListItem, ResolvedRunStyle, type ResolvedSurfaceMeasurer, ResolvedTabStops, ReviewItem, type ReviewParagraphAnchor, RevisionAttribution, RevisionDisplayMode, type ScriptItem, SectionColumns, SelectionRect, SemanticLayout, type SemanticLayoutOptions, SemanticPosition, SemanticSelection, type SemanticTableCell, type SemanticTableRow, type SemanticTableStructure, ShapedRun, type StyleCascadeTable, type StyleDefinition, StyleSpanRecord, type TableAlignment, TableBorderBox, TableBorderSide, type TableCellStyleFormatting, TablePaginationError, type TablePaginationErrorCode, type TableRowHeight, type TableRowHeightRule, TextDirection, TextMeasurer, TextShaper, UnsupportedScriptError, VersionedShapingLibrary, type ViewportWindow, WORD_SEGMENTER_LOCALE, type WordBoundary, type WordBoundaryResolverDeps, type WordSegment, anchorLineY, attachNotesToLayout, boundedFallbackWordSegments, buildNumberingIndex, buildPageRefIndex, buildStyleCascadeTable, cascadeParagraphFormatting, cascadeRunProperties, cascadedBottomBorder, clampListValue, computeDoubleBorderMetricsPt, computeFootnoteReserves, contentControlBoundaries, contentControlHoldingParagraph, contentControlRecordsInPart, contentControlsOfLayout, createBoundedFallbackWordBoundary, createDefaultWordBoundary, createFixedMeasurer, createHarfBuzzTextShaper, createIntlWordBoundary, createLayoutScheduler, createLayoutSession, createListCounterState, createParagraphLayoutCache, defaultNoteSeparatorRuleStyle, deriveNoteDisplayMarks, deriveNoteDisplayMarksResolved, documentOrder, effectiveBorderSide, effectiveContentControlLock, emptyTocPlaceholderParagraphIds, emptyTocSuppressedResultParagraphIds, everyStoryOrder, expandLvlText, filterRefsOnPage, findSeparatorNote, formatDecimal, formatDecimalZero, formatLowerLetter, formatLowerRoman, formatNumFmt, formatPageNumber, formatUpperLetter, formatUpperRoman, fragmentOwnsAtomOffset, fragmentsOfParagraph, graphemeBoundaryEpoch, graphemeCount, graphemeOffsetToUtf16, harfBuzzFontValidator, initializeHarfBuzz, intlGraphemeBoundary, isCanvasMeasurementAvailable, isCumulativeGeometryTrustedFromLineOrigin, isGeometryTrustedCaretOffset, isHarfBuzzInitialized, isIntlSegmenterAvailable, isIntlWordSegmenterAvailable, isMarkerOnlySeparatorNote, isValidStyleId, isWholeGraphemeHorizontalBoundary, itemizeScriptFontSlots, keyedRangeRects, layoutHeaderFooterStory, layoutNoteById, layoutNoteSeparator, layoutNoteStory, layoutSemanticDocument, lineAtPosition, linesOf, listMarkerBox, mergeListIndent, normalNotesOf, noteDisplayMarkMap, noteLineIdPrefix, noteMarkKey, noteSeparatorAreaBox, noteStoryBlocks, pagesToMaterialize, paragraphFragmentsOf, paragraphFragmentsOfBlocks, paragraphLayoutKey, paragraphMarkDeleted, paragraphShading, paragraphShadingBox, positionPastDeletion, projectedNoteMarkText, provisionalNoteMarks, readNumPr, readTableStructure, resetGraphemeBoundary, resolveDefaultSurfaceMeasurer, resolveDefaultWordBoundary, resolveNumberingLevel, resolveOoxmlShadingFill, resolveParagraphLayoutInputs, resolveStoryListItems, resolveStrictHexFill, reviewAnchorIndex, reviewItemGeometry, revisionRemovesParagraph, roundFontUnitToFixedPoint, segmentGraphemes, segmentWords, selectionRects, semanticHorizontalBoundaries, setGraphemeBoundary, setHarfBuzzWasmUrl, sha256FontBytes, shadingFillFromElement, shapedHorizontalBoundaries, storyBlocks, syntheticSeparatorBox, tableOriginX, tocFieldChromeParagraphIds, tryCreateCanvasMeasurer, unionLayoutBoxes, utf16OffsetToGrapheme, walkStoryParagraphs, withNumberingStyleLinks, withResolvedListItems, wordBoundary, wordSegmentsToGraphemeRecords };
+export { AUTO_PREFERRED_WIDTH, type AutonumFieldKind, type AutonumFieldSpec, type BidiEmbeddingLevels, BlockFragmentRecord, CELL_PAD, COMPOUND_BORDER_MIN_GAP_PT, COMPOUND_BORDER_MIN_STROKE_PT, type CanvasMeasurerOptions, type CanvasTextContext, type CanvasTextMetrics, CellBorderBox, type CellMarginsPt, type CellVerticalAlign, type CompoundBorderMetrics, ContentControlBoundaryRecord$1 as ContentControlBoundaryRecord, type ContentControlFragmentRecord, ContentControlLock, DEFAULT_CANVAS_FONT_STACK, DEFAULT_CELL_MARGINS, FieldLinkProjector, FixedPoint, FixedPointRoundingMode, FontByteValidator, type FontSlot, GRAPHEME_SEGMENTER_LOCALE, type GraphemeBoundary, type GraphemeSegment, type GraphemeWordSegmentRecord, HARFBUZZ_SHAPING_LIBRARY, type HarfBuzzFaceCacheEvent, type HarfBuzzOutlineCacheEvent, type HarfBuzzShapeCacheEvent, HarfBuzzShapingError, type HarfBuzzShapingErrorCode, type HarfBuzzTextShaper, type HarfBuzzTextShaperInstrumentation, type HarfBuzzTextShaperOptions, type HeaderFooterVariantName, HyperlinkProjector, type KeyedRange, LayoutBox, type LayoutCacheStats, type LayoutScheduler, type LayoutSchedulerOptions, type LayoutScope, type LayoutSession, type LayoutSessionStats, LineRecord, type ListCounterAdvance, type ListCounterState, MAX_EACH_PAGE_MARK_CANDIDATES, MAX_LVL_TEXT_LENGTH, MAX_MARKER_TEXT_LENGTH, MAX_NOTES_LAID_OUT, MAX_NOTE_FRAGMENTS, MAX_NOTE_OVERFLOW_PAGES, MAX_NOTE_REFLOW_ATTEMPTS, MAX_TABLE_COLUMNS, MAX_TABLE_NESTING, MAX_TABLE_ROW_FRAGMENTS, MAX_TABLE_ROW_HEIGHT_PT, type MaterializationInput, type NoteDisplayMark, type NoteLayoutFallbackReason, type NoteMarkContext, type NotePaginationFallbackReason, type NoteReferenceSite, type NoteSeparatorLayout, type NoteSeparatorRuleStyle, type NoteStoryDrawings, type NoteStoryLayout, type NotesAttachResult, type NotesLayoutInput, NumberingIndex, NumberingLevel, type PageFurniture, PageGeometry, PageRecord, type PageRefIndex, ParagraphFragmentRecord, type ParagraphKeyInputs, type ParagraphLayoutCache, type ParagraphLayoutCacheOptions, type PreferredWidth, type PreferredWidthType, RefFieldContext, type RefFieldRefreshOptions, ResolvedListItem, type ResolvedSurfaceMeasurer, ReviewItem, type ReviewParagraphAnchor, RevisionAttribution, RevisionDisplayMode, type ScriptItem, SectionColumns, SelectionRect, SemanticLayout, type SemanticLayoutOptions, SemanticPosition, SemanticSelection, type SemanticTableCell, type SemanticTableRow, type SemanticTableStructure, ShapedRun, StyleCascadeTable, StyleSpanRecord, type TableAlignment, TableBorderBox, TableBorderSide, TableCellStyleFormatting, TablePaginationError, type TablePaginationErrorCode, type TableRowHeight, type TableRowHeightRule, TextDirection, TextMeasurer, TextShaper, UnsupportedScriptError, VersionedShapingLibrary, type ViewportWindow, WORD_SEGMENTER_LOCALE, type WordBoundary, type WordBoundaryResolverDeps, type WordSegment, anchorLineY, attachNotesToLayout, boundedFallbackWordSegments, buildPageRefIndex, clampListValue, computeDoubleBorderMetricsPt, computeFootnoteReserves, contentControlBoundaries, contentControlHoldingParagraph, contentControlRecordsInPart, contentControlsOfLayout, createBoundedFallbackWordBoundary, createDefaultWordBoundary, createFixedMeasurer, createHarfBuzzTextShaper, createIntlWordBoundary, createLayoutScheduler, createLayoutSession, createListCounterState, createParagraphLayoutCache, defaultNoteSeparatorRuleStyle, deriveNoteDisplayMarks, deriveNoteDisplayMarksResolved, documentOrder, effectiveBorderSide, effectiveContentControlLock, emptyTocPlaceholderParagraphIds, emptyTocSuppressedResultParagraphIds, everyStoryOrder, expandLvlText, filterRefsOnPage, findSeparatorNote, formatDecimal, formatDecimalZero, formatLowerLetter, formatLowerRoman, formatNumFmt, formatPageNumber, formatUpperLetter, formatUpperRoman, fragmentOwnsAtomOffset, fragmentsOfParagraph, graphemeBoundaryEpoch, graphemeCount, graphemeOffsetToUtf16, harfBuzzFontValidator, initializeHarfBuzz, intlGraphemeBoundary, isCanvasMeasurementAvailable, isCumulativeGeometryTrustedFromLineOrigin, isGeometryTrustedCaretOffset, isHarfBuzzInitialized, isIntlSegmenterAvailable, isIntlWordSegmenterAvailable, isMarkerOnlySeparatorNote, isWholeGraphemeHorizontalBoundary, itemizeScriptFontSlots, keyedRangeRects, layoutHeaderFooterStory, layoutNoteById, layoutNoteSeparator, layoutNoteStory, layoutSemanticDocument, lineAtPosition, linesOf, normalNotesOf, noteDisplayMarkMap, noteLineIdPrefix, noteMarkKey, noteSeparatorAreaBox, noteStoryBlocks, pageRefPageNumbersFromLayout, pagesToMaterialize, paragraphFragmentsOf, paragraphFragmentsOfBlocks, paragraphLayoutKey, paragraphMarkDeleted, paragraphShading, paragraphShadingBox, parseAutonumInstruction, planRefFieldResultRefresh, positionPastDeletion, projectedNoteMarkText, provisionalNoteMarks, readTableStructure, resetGraphemeBoundary, resolveDefaultSurfaceMeasurer, resolveDefaultWordBoundary, resolveOoxmlShadingFill, resolveStrictHexFill, reviewAnchorIndex, reviewItemGeometry, revisionRemovesParagraph, roundFontUnitToFixedPoint, segmentGraphemes, segmentWords, selectionRects, semanticHorizontalBoundaries, setGraphemeBoundary, setHarfBuzzWasmUrl, sha256FontBytes, shadingFillFromElement, shapedHorizontalBoundaries, storyBlocks, syntheticSeparatorBox, tableOriginX, tocFieldChromeParagraphIds, tryCreateCanvasMeasurer, unionLayoutBoxes, utf16OffsetToGrapheme, wordBoundary, wordSegmentsToGraphemeRecords };