@docx-editor.dev/core 2.15.1 → 2.16.0

package/dist/{semantic-records-EIdwId-a.d.ts → semantic-records-BreR44Ki.d.ts}

@@ -1,264 +1,174 @@
-import { b as RevisionAttribution, R as RevisionDisplayMode } from './revision-projection-DHRJH48u.js';
-import { a as OoxmlNode, q as OoxmlProperty, c as OoxmlElement, U as TableBorderStyle, O as OoxmlPart, x as ImageResourceState, W as DrawingAccessibility, S as SourceCrop, X as DrawingTransform, Y as VectorShapeProjection, z as DrawingHorizontalReferenceFrame, A as DrawingVerticalReferenceFrame, u as ImageWrapTarget, Z as DrawingProjection, _ as OoxmlDrawingNode } from './tree-op-types-egdarvH_.js';
-import { O as OmmlEquationProjection } from './omml-equation-BpRmfDAf.js';
+import { b as RevisionAttribution, R as RevisionDisplayMode, a as RevisionAuthorFilter } from './revision-projection-CN_DiOl_.js';
+import { q as OoxmlProperty, c as OoxmlElement, a as OoxmlNode, O as OoxmlPart, U as TableBorderStyle, x as ImageResourceState, W as DrawingAccessibility, X as DrawingImageEffects, S as SourceCrop, Y as DrawingTransform, Z as VectorShapeProjection, z as DrawingHorizontalReferenceFrame, A as DrawingVerticalReferenceFrame, u as ImageWrapTarget, _ as DrawingProjection, $ as OoxmlDrawingNode } from './tree-op-types-C5rZzoAz.js';
+import { O as OmmlEquationProjection } from './omml-equation-oLlbPpVy.js';
 
+/** 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';
 /**
- * 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.
+ * One level's indent, plus which parts the level actually AUTHORED.
  *
- * 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
- * that an attacker-authored spacing would push pagination into pathological page counts.
+ * 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.
  */
-declare const MAX_PARAGRAPH_SPACING_PT: number;
-/** Soft ceiling on border width (96 eighths = 12pt). Word's UI tops out well below this. */
-declare const MAX_BORDER_WIDTH_PT = 12;
-/** Soft ceiling on border-to-text gap (`w:space`, already in points). */
-declare const MAX_BORDER_SPACE_PT = 3168;
+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;
+}
 /**
- * A paragraph's resolved space before and after, in points.
+ * One `w:lvlOverride` on a `w:num`: a restart value, a replacement level, or both.
  *
- * Already collapsed against `w:contextualSpacing`, so adjacent same-style paragraphs that suppress
- * their gap arrive here with it removed rather than leaving that to whoever stacks them.
+ * How two lists share an abstract definition while numbering independently.
  */
-interface ParagraphSpacing {
-    /** `w:spacing/@before`, in points. */
-    readonly before: number;
-    /** `w:spacing/@after`, in points. */
-    readonly after: number;
+interface LevelOverride {
+    readonly startOverride?: number;
+    /** Full level replacement when `w:lvl` is present under the override. */
+    readonly level?: NumberingLevel;
 }
 /**
- * The gap Word substitutes when `w:beforeAutospacing` / `w:afterAutospacing` is on
- * (ECMA-376 §17.3.1.33, the `w:spacing` clause both attributes belong to).
+ * One `w:abstractNum` — the shape of a list, without being a list.
  *
- * 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,
- * 14pt, which is what a document round-tripped through Word's HTML filter carries — and this
- * one is everywhere, because Word writes `w:before="100" w:beforeAutospacing="1"` for it. Reading
- * only the literal 100 twips lays every such paragraph out 9pt tight, which moves page breaks.
+ * 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.
  */
-declare const AUTO_PARAGRAPH_SPACING_PT = 14;
+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;
+}
 /**
- * Where a paragraph sits, for the two contexts in which Word's auto spacing resolves to 0
- * instead of {@link AUTO_PARAGRAPH_SPACING_PT}.
+ * One `w:num` — the thing a paragraph's `w:numId` actually names.
  *
- * Both come from the HTML model the attribute emulates: a `<li>` and a `<td>` collapse the
- * paragraph margin, a bare `<p>` does not. A caller that says nothing gets the body answer.
+ * Points at an {@link AbstractNumDefinition} and may override any of its levels.
  */
-interface ParagraphAutoSpacingContext {
-    /** The paragraph participates in numbering (`w:numPr`), i.e. it is a list item. */
-    readonly inList?: boolean;
-    /** The paragraph lives in a table cell. */
-    readonly inTableCell?: boolean;
+interface NumDefinition {
+    readonly numId: string;
+    readonly abstractNumId: string;
+    readonly overrides: ReadonlyMap<number, LevelOverride>;
 }
 /**
- * Resolved line spacing (`w:spacing/@line` + `@lineRule`, ECMA-376 17.3.1.33).
- *
- * `auto` is the interesting one: `@line` is 240ths of a line, so 240 is single, 360 is
- * one-and-a-half, 480 is double — and Word's own Normal style since 2013 is 259, i.e.
- * 1.08. A document laid out at a flat single spacing is ~8% tight on EVERY line, which
- * moves every page break, so this is not a cosmetic detail.
+ * The bounded projection of `numbering.xml` that list layout resolves against.
  *
- * `exact` fixes the line box at `@line` twips and lets tall glyphs clip, the way Word
- * does. `atLeast` uses it as a floor.
+ * 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.
  */
-type LineSpacingRule = 'auto' | 'exact' | 'atLeast';
+interface NumberingIndex {
+    readonly abstractNums: ReadonlyMap<string, AbstractNumDefinition>;
+    readonly nums: ReadonlyMap<string, NumDefinition>;
+}
 /**
- * Resolved line spacing: the rule, and the value it applies.
+ * Build a numbering index from the root of a numbering part (`w:numbering`).
  *
- * `value` means different things per rule — 240ths of a line under `auto`, points under `exact`
- * and `atLeast` — which is why the two travel together and neither is useful alone.
+ * Empty / missing roots yield an empty index. Duplicate ids keep the first definition.
  */
-interface ParagraphLineSpacing {
-    readonly rule: LineSpacingRule;
-    /** `auto`: the 240ths-of-a-line multiplier numerator. Otherwise points. */
-    readonly value: number;
-}
-/** Single spacing: what a paragraph that says nothing gets. */
-declare const SINGLE_LINE_SPACING: ParagraphLineSpacing;
 /**
- * One resolved `w:pBdr` edge: its style, colour, thickness and gap.
+ * Project `numbering.xml` into the bounded index.
  *
- * `widthPt` and `spacePt` are already converted and CLAMPED — both come from a file, and an
- * unbounded border width becomes a layout dimension.
+ * 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.
  */
-interface ParagraphBorderEdge {
-    /** Authored `ST_Border` value (`single`, `dashed`, …). */
-    readonly val: string;
-    /** RRGGBB, or null when auto/missing (paint defaults to black). */
-    readonly color: string | null;
-    /** Border thickness in points (`w:sz` is eighths of a point). */
-    readonly widthPt: number;
-    /** Gap from text to the rule, in points (`w:space`). */
-    readonly spacePt: number;
-    /**
-     * `w:shadow` — Word offsets a drop shadow behind the rule.
-     *
-     * Present only when authored true, so an edge that says nothing keeps the shape earlier
-     * fixtures assert. Resolved and carried; drawing it is deferred.
-     */
-    readonly shadow?: true;
-}
-/** The six `CT_PBdr` children, in schema order (ECMA-376 §17.3.1.24). */
-declare const PARAGRAPH_BORDER_SIDES: readonly ["top", "left", "bottom", "right", "between", "bar"];
+declare function buildNumberingIndex(root: OoxmlElement | null | undefined): NumberingIndex;
+/** Resolve the effective level for a `numId` + `ilvl`, applying overrides. */
 /**
- * Which of the six `CT_PBdr` edges.
+ * The effective level for one paragraph's numbering reference, after overrides and style links.
  *
- * Four are physical box edges; `between` and `bar` are group-relative, drawn only where
- * consecutive paragraphs share a border definition.
+ * 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.
  */
-type ParagraphBorderSide = (typeof PARAGRAPH_BORDER_SIDES)[number];
+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;
+
+/** Soft ceiling matching Word's practical custom-tab UI limit. */
+declare const MAX_TAB_STOPS = 64;
 /**
- * A paragraph's resolved `w:pBdr` (ECMA-376 §17.3.1.24).
- *
- * `top`/`left`/`bottom`/`right` are the four physical edges of the box. The other two are
- * group-relative: `between` draws at a boundary INSIDE a run of consecutive paragraphs whose
- * border settings are identical, and `bar` is the vertical change-bar rule beside the
- * paragraph, drawn whether or not the paragraph groups with its neighbours.
+ * Soft ceiling on a tab position (31_680 twips ≈ 22"), matching paragraph-spacing bounds so
+ * a hostile stop cannot shove layout into pathological widths.
  */
-interface ParagraphBorders {
-    readonly top?: ParagraphBorderEdge;
-    readonly left?: ParagraphBorderEdge;
-    readonly bottom?: ParagraphBorderEdge;
-    readonly right?: ParagraphBorderEdge;
-    readonly between?: ParagraphBorderEdge;
-    readonly bar?: ParagraphBorderEdge;
-}
+declare const MAX_TAB_POSITION_TWIPS = 31680;
+/** OOXML / Word default when `w:settings/w:defaultTabStop` is absent: 720 twips = 0.5". */
+declare const DEFAULT_TAB_INTERVAL_TWIPS = 720;
+/** The default tab interval in points — {@link DEFAULT_TAB_INTERVAL_TWIPS} converted. */
+declare const DEFAULT_TAB_INTERVAL_PT: number;
 /**
- * Resolve `w:spacing` before/after from flat paragraph properties.
- *
- * Line spacing (`w:line` / `w:lineRule`) is a separate concern — it changes measured line
- * height, not the gap between paragraphs — and is not resolved here.
+ * How a tab stop positions the text that follows it.
  *
- * `w:beforeAutospacing` / `w:afterAutospacing` REPLACE the authored measurement on their own
- * side rather than adding to it; see {@link AUTO_PARAGRAPH_SPACING_PT}.
+ * Only `left` is a plain cursor jump. The other three size the tab glyph from the MEASURED
+ * following segment, so its end, centre or decimal point lands on the stop.
  */
-declare function paragraphSpacing(props: readonly OoxmlProperty[], context?: ParagraphAutoSpacingContext): ParagraphSpacing;
+type TabAlignment = 'left' | 'center' | 'right' | 'decimal';
 /**
- * Resolve `w:line` / `w:lineRule` from flat paragraph properties.
+ * `w:tab/@w:leader` (ECMA-376 §17.3.1.38, ST_TabTlc): the character repeated across the
+ * space a tab reserves. `none` is the default and is represented by an absent leader.
  *
- * Merged per attribute for the same reason as before/after: `w:spacing` is one element
- * carrying independent attributes, and a style that states only `@line` must not reset the
- * rule an earlier entry in the cascade set.
+ * This is the difference between a Word table of contents and a column of headings floating
+ * next to a column of page numbers, so it is carried through layout to paint rather than
+ * dropped as a geometry-irrelevant attribute.
  */
-declare function paragraphLineSpacing(props: readonly OoxmlProperty[]): ParagraphLineSpacing;
+type TabLeader = 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
 /**
- * Apply resolved line spacing to a line's natural (glyph-derived) box.
- *
- * Word places `auto` / `atLeast` extras BELOW the line (the last line's multiple spacing
- * still separates it from the next paragraph). Putting that delta above inverted cover-page
- * rhythm: `w:line="460"` on "between" opened a large gap above the word and almost none
- * before "MERIDIAN". `exact` taller than the glyphs centers the text (ECMA-376 17.3.1.33).
- * An `exact` box smaller than the glyphs keeps the baseline inside so clipped text still
- * sits on it.
- */
-declare function applyLineSpacing(spacing: ParagraphLineSpacing, naturalHeight: number, naturalBaseline: number): {
-    height: number;
-    baseline: number;
-};
-/**
- * `w:contextualSpacing` (17.3.1.9): drop before/after between paragraphs of the SAME
- * style. Word's built-in `ListParagraph` sets it, so every list authored in Word gets a
- * paragraph gap between items without this.
- */
-declare function paragraphContextualSpacing(props: readonly OoxmlProperty[]): boolean;
-/**
- * Resolve `w:pBdr` from the paragraph-properties node.
- *
- * Nested — every edge is a child of `pBdr`, not an attribute — so this reads the typed tree
- * rather than the flattened `OoxmlProperty[]` bag `propertiesOf` builds for leaf props.
- */
-declare function paragraphBorders(pPr: OoxmlNode | undefined): ParagraphBorders;
-/**
- * `w:pBdr` after the style cascade: a later `w:pBdr` replaces an earlier one WHOLESALE.
- *
- * Word does not merge edges across the cascade. A style that states only `w:bottom` discards
- * the box its `basedOn` ancestor declared, so folding edge by edge would leave a lone
- * underline surrounded by a box no one authored. Absence inherits; `nil`/`none` clear.
- */
-declare function cascadedParagraphBorders(paragraphPropertyNodes: readonly OoxmlNode[]): ParagraphBorders;
-/**
- * Visual stroke thickness layout publishes for one edge (points).
- *
- * Compound `ST_Border` values (`double`, …) use the shared inflated band so a thin
- * `w:sz="3"` double still occupies a visible double-line box — matching table borders.
- */
-declare function paragraphBorderStrokeWidthPt(edge: ParagraphBorderEdge): number;
-/**
- * Extent one border edge occupies away from the text it decorates: gap plus rule, in points.
- *
- * Vertically that is flow height — a top rule pushes the first line down, a bottom rule holds
- * the page open below the last one — so pagination has to see it. Horizontally it is
- * publish-only: Word draws left/right paragraph rules OUTSIDE the text column and never
- * re-breaks the lines, which is why adding a box to a paragraph in Word does not reflow it.
- */
-declare function paragraphBorderExtentPt(edge: ParagraphBorderEdge | undefined): number;
-/** Vertical extent a bottom border adds below the last line (gap + rule). */
-declare function bottomBorderExtentPt(edge: ParagraphBorderEdge | undefined): number;
-/**
- * Identity of a paragraph's border set, for the `w:between` group rule.
- *
- * Word treats consecutive paragraphs whose border settings are IDENTICAL as ONE bordered
- * block: the top rule draws above the first, the bottom rule below the last, and each
- * interior boundary gets `w:between` or nothing (§17.3.1.24). That is why applying a box to
- * three selected paragraphs in Word draws one box and not three.
- *
- * Empty string means "no borders", which never groups with anything.
- */
-declare function paragraphBordersFingerprint(borders: ParagraphBorders): string;
-/**
- * Gap to insert before a paragraph once the previous paragraph's `after` is already in the
- * flow cursor — Word takes the larger of the two rather than summing them.
- */
-declare function collapsedSpaceBefore(before: number, previousAfter: number): number;
-/**
- * Applied before-spacing for placement (Word 2013+ / compat mode 15).
- *
- * Adjacent before/after still collapse to the larger gap, but before is dropped entirely when
- * the paragraph begins at the top of a page mid-section. The first paragraph of a document or
- * section retains before. Callers publish this applied value on the fragment so shading, borders,
- * selection, and paint share one geometry.
- */
-declare function appliedSpaceBefore(before: number, previousAfter: number, atTopOfPage: boolean, firstParagraphOfSection: boolean): number;
-
-/** Soft ceiling matching Word's practical custom-tab UI limit. */
-declare const MAX_TAB_STOPS = 64;
-/**
- * Soft ceiling on a tab position (31_680 twips ≈ 22"), matching paragraph-spacing bounds so
- * a hostile stop cannot shove layout into pathological widths.
- */
-declare const MAX_TAB_POSITION_TWIPS = 31680;
-/** OOXML / Word default when `w:settings/w:defaultTabStop` is absent: 720 twips = 0.5". */
-declare const DEFAULT_TAB_INTERVAL_TWIPS = 720;
-/** The default tab interval in points — {@link DEFAULT_TAB_INTERVAL_TWIPS} converted. */
-declare const DEFAULT_TAB_INTERVAL_PT: number;
-/**
- * How a tab stop positions the text that follows it.
- *
- * Only `left` is a plain cursor jump. The other three size the tab glyph from the MEASURED
- * following segment, so its end, centre or decimal point lands on the stop.
- */
-type TabAlignment = 'left' | 'center' | 'right' | 'decimal';
-/**
- * `w:tab/@w:leader` (ECMA-376 §17.3.1.38, ST_TabTlc): the character repeated across the
- * space a tab reserves. `none` is the default and is represented by an absent leader.
- *
- * This is the difference between a Word table of contents and a column of headings floating
- * next to a column of page numbers, so it is carried through layout to paint rather than
- * dropped as a geometry-irrelevant attribute.
- */
-type TabLeader = 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
-/**
- * The character each leader repeats (§17.3.1.38, ST_TabTlc).
+ * The character each leader repeats (§17.3.1.38, ST_TabTlc).
  *
  * Lives with the type rather than with the painter because LAYOUT has to measure it: a
  * leader is the same character typed over and over, and the only way to space it the way
@@ -339,6 +249,125 @@ declare function tabAdvanceWidth(alignment: TabAlignment, currentX: number, dest
  */
 declare function tabStopsFingerprint(tabs: ResolvedTabStops): string;
 
+/** `w:vertAlign` — script position, which also scales the run's effective size. */
+type VerticalAlign = 'baseline' | 'superscript' | 'subscript';
+/** A resolved underline: its variant, and its colour when it does not follow the text. */
+interface ResolvedUnderline {
+    /** The authored `ST_Underline` variant. */
+    readonly variant: string;
+    /** RRGGBB, or null when the underline follows the text colour. */
+    readonly color: string | null;
+}
+/**
+ * A run's character properties after the full cascade, in the units layout works in.
+ *
+ * Points rather than half-points, RRGGBB rather than theme references — everything already
+ * resolved, so measurement and paint never re-run the cascade per glyph.
+ */
+interface ResolvedRunStyle {
+    readonly fontFamily: string | null;
+    /**
+     * The `eastAsia` slot's typeface (`w:rFonts w:eastAsia`/`w:eastAsiaTheme`), or null when
+     * no level authors one.
+     *
+     * OOXML picks a run's face per SCRIPT: `fontFamily` covers the ascii/hAnsi slots, and
+     * ideographic/kana/hangul text resolves through this one instead. Kept beside — not
+     * folded into — `fontFamily`, because a mixed run needs both at once and the split into
+     * slot-homogeneous pieces happens downstream (`piecesOfParagraph`).
+     */
+    readonly fontFamilyEastAsia: string | null;
+    /** Points. `w:sz` is half-points, so 22 becomes 11. */
+    readonly fontSizePt: number;
+    /** RRGGBB, or null for the inherited/automatic colour. */
+    readonly color: string | null;
+    readonly bold: boolean;
+    /** Opaque solid `w14:textOutline`, in points; paint only, never a font-weight change. */
+    readonly textOutline?: {
+        readonly widthPt: number;
+        readonly color: string;
+    };
+    readonly italic: boolean;
+    readonly underline: ResolvedUnderline | null;
+    readonly strike: boolean;
+    readonly doubleStrike: boolean;
+    /** An `ST_HighlightColor` name, or null. */
+    readonly highlight: string | null;
+    /**
+     * Character shading fill (`w:rPr/w:shd`), validated RRGGBB, or null.
+     *
+     * Paint applies this as the glyph-box background; a recognised highlight overrides it.
+     * Measurement ignores shading.
+     */
+    readonly shading: string | null;
+    readonly verticalAlign: VerticalAlign;
+    /** `w:position`, in points. Positive raises the baseline. */
+    readonly baselineShiftPt: number;
+    readonly caps: boolean;
+    readonly smallCaps: boolean;
+    /** `w:spacing`, in points. Added to every advance. */
+    readonly characterSpacingPt: number;
+    /** `w:w`, as a percentage. 100 is unscaled. */
+    readonly horizontalScalePercent: number;
+    /** `w:kern`, in points: the size at or above which kerning applies. 0 disables it. */
+    readonly kerningMinPt: number;
+    /**
+     * `w:vanish` (ECMA-376 §17.3.2.45): the run is hidden text.
+     *
+     * Word does not draw it AND does not paginate it — hidden index or comment text takes no
+     * space at all. So this cannot be a paint-time opacity: a hidden run that is still measured
+     * pushes every following line, and every following page break, to the wrong place. Layout
+     * drops the content instead (see `piecesOfParagraph`).
+     *
+     * `w:specVanish` (§17.3.2.36) is a different property — an always-hidden paragraph mark on
+     * a heading — and never sets this.
+     */
+    readonly hidden: boolean;
+}
+/** The style a run inherits when it authors nothing. */
+declare const DEFAULT_RUN_STYLE: ResolvedRunStyle;
+/**
+ * The theme part's typefaces, for resolving `w:rFonts` theme attributes.
+ *
+ * Structurally identical to the binding lane's `DocumentThemeFonts` and assignable from it.
+ * Declared here so this lane reads validated strings rather than the theme tree.
+ */
+interface ThemeFonts {
+    /** `a:majorFont` latin typeface — headings. */
+    readonly major: string | null;
+    /** `a:minorFont` latin typeface — body text. */
+    readonly minor: string | null;
+    /** `a:majorFont` east asian typeface (`a:ea`) — headings. Optional for back-compat. */
+    readonly majorEastAsia?: string | null;
+    /** `a:minorFont` east asian typeface (`a:ea`) — body text. Optional for back-compat. */
+    readonly minorEastAsia?: string | null;
+}
+/**
+ * Resolve one run's direct formatting.
+ *
+ * Unrecognised values are DROPPED rather than guessed: a `w:sz` of `"large"` leaves the
+ * default size rather than inventing one, because a wrong measurement moves every glyph
+ * after it and a missing one is visible immediately.
+ *
+ * `themeFonts` resolves `w:rFonts` theme references. Absent, a theme-only `rFonts` leaves
+ * the family inherited — which is what every run of a theme-fonted document does, so the
+ * whole document falls back to the surface default face.
+ */
+declare function resolveRunStyle(props: readonly OoxmlProperty[], themeFonts?: ThemeFonts): ResolvedRunStyle;
+/** The text as it is DRAWN, after case transforms. Measurement must use this, not the source. */
+declare function displayText(text: string, style: ResolvedRunStyle): string;
+/** Measure run text the way layout breaks lines and paints glyphs (caps/small-caps aware). */
+declare function measureDisplayText(text: string, style: ResolvedRunStyle, measurer: TextMeasurer): number;
+/** Whether two resolved styles are identical, for span merging and cache keys. */
+declare function runStylesEqual(a: ResolvedRunStyle, b: ResolvedRunStyle): boolean;
+/**
+ * How far a run's glyphs are lifted off the line's baseline, in points. Positive is up.
+ *
+ * Super and subscript move the GLYPHS without moving the run's box, so the box keeps tiling
+ * the line and the selection band stays continuous. Anything drawing at the glyphs — the
+ * painter, and the caret — has to apply this itself, and from one place, or the two drift.
+ */
+declare function baselineShiftPtOf(style: ResolvedRunStyle): number;
+
 /**
  * UAX #9 embedding levels, one per UTF-16 code unit, plus the paragraph ranges they were resolved
  * within.
@@ -806,146 +835,32 @@ declare const createShapedRun: (input: ShapedRun, environmentInput: ShapingEnvir
  */
 declare const shapedRunComparatorInputs: (input: ShapedRun, environment: ShapingEnvironmentInput) => ShapedRunComparatorInputs;
 
-/** `w:vertAlign` — script position, which also scales the run's effective size. */
-type VerticalAlign = 'baseline' | 'superscript' | 'subscript';
-/** A resolved underline: its variant, and its colour when it does not follow the text. */
-interface ResolvedUnderline {
-    /** The authored `ST_Underline` variant. */
-    readonly variant: string;
-    /** RRGGBB, or null when the underline follows the text colour. */
-    readonly color: string | null;
+/**
+ * Which `w:rFonts` slot a character resolves its face through.
+ *
+ * OOXML gives a run up to four faces and picks between them by SCRIPT, so one run of mixed Latin
+ * and CJK text uses two different fonts without saying so anywhere in its properties.
+ */
+type FontSlot = 'ascii' | 'hAnsi' | 'eastAsia' | 'cs';
+/**
+ * A run of text sharing one script, direction and font slot — the unit handed to the shaper.
+ *
+ * Shaping cannot span a script change: Arabic and Latin in one call would produce wrong joining
+ * behaviour, so a run is itemized into these first.
+ */
+interface ScriptItem {
+    readonly from: number;
+    readonly to: number;
+    readonly direction: TextDirection;
+    readonly bidiLevel: number;
+    readonly script: 'Zyyy' | 'Latn' | 'Grek' | 'Cyrl' | 'Hani' | 'Hebr' | 'Arab' | 'Deva' | 'Beng' | 'Thai' | 'Khmr';
+    readonly slot: FontSlot;
 }
 /**
- * A run's character properties after the full cascade, in the units layout works in.
+ * A code point whose script this engine does not itemize.
  *
- * Points rather than half-points, RRGGBB rather than theme references — everything already
- * resolved, so measurement and paint never re-run the cascade per glyph.
- */
-interface ResolvedRunStyle {
-    readonly fontFamily: string | null;
-    /**
-     * The `eastAsia` slot's typeface (`w:rFonts w:eastAsia`/`w:eastAsiaTheme`), or null when
-     * no level authors one.
-     *
-     * OOXML picks a run's face per SCRIPT: `fontFamily` covers the ascii/hAnsi slots, and
-     * ideographic/kana/hangul text resolves through this one instead. Kept beside — not
-     * folded into — `fontFamily`, because a mixed run needs both at once and the split into
-     * slot-homogeneous pieces happens downstream (`piecesOfParagraph`).
-     */
-    readonly fontFamilyEastAsia: string | null;
-    /** Points. `w:sz` is half-points, so 22 becomes 11. */
-    readonly fontSizePt: number;
-    /** RRGGBB, or null for the inherited/automatic colour. */
-    readonly color: string | null;
-    readonly bold: boolean;
-    readonly italic: boolean;
-    readonly underline: ResolvedUnderline | null;
-    readonly strike: boolean;
-    readonly doubleStrike: boolean;
-    /** An `ST_HighlightColor` name, or null. */
-    readonly highlight: string | null;
-    /**
-     * Character shading fill (`w:rPr/w:shd`), validated RRGGBB, or null.
-     *
-     * Paint applies this as the glyph-box background; a recognised highlight overrides it.
-     * Measurement ignores shading.
-     */
-    readonly shading: string | null;
-    readonly verticalAlign: VerticalAlign;
-    /** `w:position`, in points. Positive raises the baseline. */
-    readonly baselineShiftPt: number;
-    readonly caps: boolean;
-    readonly smallCaps: boolean;
-    /** `w:spacing`, in points. Added to every advance. */
-    readonly characterSpacingPt: number;
-    /** `w:w`, as a percentage. 100 is unscaled. */
-    readonly horizontalScalePercent: number;
-    /** `w:kern`, in points: the size at or above which kerning applies. 0 disables it. */
-    readonly kerningMinPt: number;
-    /**
-     * `w:vanish` (ECMA-376 §17.3.2.45): the run is hidden text.
-     *
-     * Word does not draw it AND does not paginate it — hidden index or comment text takes no
-     * space at all. So this cannot be a paint-time opacity: a hidden run that is still measured
-     * pushes every following line, and every following page break, to the wrong place. Layout
-     * drops the content instead (see `piecesOfParagraph`).
-     *
-     * `w:specVanish` (§17.3.2.36) is a different property — an always-hidden paragraph mark on
-     * a heading — and never sets this.
-     */
-    readonly hidden: boolean;
-}
-/** The style a run inherits when it authors nothing. */
-declare const DEFAULT_RUN_STYLE: ResolvedRunStyle;
-/**
- * The theme part's typefaces, for resolving `w:rFonts` theme attributes.
- *
- * Structurally identical to the binding lane's `DocumentThemeFonts` and assignable from it.
- * Declared here so this lane reads validated strings rather than the theme tree.
- */
-interface ThemeFonts {
-    /** `a:majorFont` latin typeface — headings. */
-    readonly major: string | null;
-    /** `a:minorFont` latin typeface — body text. */
-    readonly minor: string | null;
-    /** `a:majorFont` east asian typeface (`a:ea`) — headings. Optional for back-compat. */
-    readonly majorEastAsia?: string | null;
-    /** `a:minorFont` east asian typeface (`a:ea`) — body text. Optional for back-compat. */
-    readonly minorEastAsia?: string | null;
-}
-/**
- * Resolve one run's direct formatting.
- *
- * Unrecognised values are DROPPED rather than guessed: a `w:sz` of `"large"` leaves the
- * default size rather than inventing one, because a wrong measurement moves every glyph
- * after it and a missing one is visible immediately.
- *
- * `themeFonts` resolves `w:rFonts` theme references. Absent, a theme-only `rFonts` leaves
- * the family inherited — which is what every run of a theme-fonted document does, so the
- * whole document falls back to the surface default face.
- */
-declare function resolveRunStyle(props: readonly OoxmlProperty[], themeFonts?: ThemeFonts): ResolvedRunStyle;
-/** The text as it is DRAWN, after case transforms. Measurement must use this, not the source. */
-declare function displayText(text: string, style: ResolvedRunStyle): string;
-/** Measure run text the way layout breaks lines and paints glyphs (caps/small-caps aware). */
-declare function measureDisplayText(text: string, style: ResolvedRunStyle, measurer: TextMeasurer): number;
-/** Whether two resolved styles are identical, for span merging and cache keys. */
-declare function runStylesEqual(a: ResolvedRunStyle, b: ResolvedRunStyle): boolean;
-/**
- * How far a run's glyphs are lifted off the line's baseline, in points. Positive is up.
- *
- * Super and subscript move the GLYPHS without moving the run's box, so the box keeps tiling
- * the line and the selection band stays continuous. Anything drawing at the glyphs — the
- * painter, and the caret — has to apply this itself, and from one place, or the two drift.
- */
-declare function baselineShiftPtOf(style: ResolvedRunStyle): number;
-
-/**
- * Which `w:rFonts` slot a character resolves its face through.
- *
- * OOXML gives a run up to four faces and picks between them by SCRIPT, so one run of mixed Latin
- * and CJK text uses two different fonts without saying so anywhere in its properties.
- */
-type FontSlot = 'ascii' | 'hAnsi' | 'eastAsia' | 'cs';
-/**
- * A run of text sharing one script, direction and font slot — the unit handed to the shaper.
- *
- * Shaping cannot span a script change: Arabic and Latin in one call would produce wrong joining
- * behaviour, so a run is itemized into these first.
- */
-interface ScriptItem {
-    readonly from: number;
-    readonly to: number;
-    readonly direction: TextDirection;
-    readonly bidiLevel: number;
-    readonly script: 'Zyyy' | 'Latn' | 'Grek' | 'Cyrl' | 'Hani' | 'Hebr' | 'Arab' | 'Deva' | 'Beng' | 'Thai' | 'Khmr';
-    readonly slot: FontSlot;
-}
-/**
- * A code point whose script this engine does not itemize.
- *
- * Carries the offending `codePoint` so the caller can report which character stopped it, rather
- * than failing anonymously somewhere in the middle of a paragraph.
+ * Carries the offending `codePoint` so the caller can report which character stopped it, rather
+ * than failing anonymously somewhere in the middle of a paragraph.
  */
 declare class UnsupportedScriptError extends Error {
     readonly name = "UnsupportedScriptError";
@@ -972,19 +887,19 @@ declare function itemizeScriptFontSlots(text: string, paragraphOffset: number, e
  */
 declare function styleForFontSlot(style: ResolvedRunStyle, slot: FontSlot | undefined): ResolvedRunStyle;
 
-type AllowlistedPageField = 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES';
 /**
- * Which allowlisted page fields a header/footer story actually contains.
+ * One parsed `HYPERLINK` instruction: the raw, unsanitized pieces.
  *
- * Drives layout reuse: no fields → one baseline; NUMPAGES only → one layout per page count;
- * SECTIONPAGES only → one layout per section page count; PAGE (alone or combined) → per
- * distinct evaluated values with a bounded cache. Counts both complex markers and
- * `w:fldSimple` (including an allowlisted page field nested inside a non-page simple field).
+ * `target` and `anchor` are verbatim from the instruction — the projector at the trust
+ * boundary decides what, if anything, they become in a DOM sink.
  */
-interface StoryPageFieldNeeds {
-    readonly hasPage: boolean;
-    readonly hasNumPages: boolean;
-    readonly hasSectionPages: boolean;
+interface HyperlinkFieldSpec {
+    /** The target as authored (first quoted or bare non-switch token), or null. */
+    readonly target: string | null;
+    /** `\l` — a bookmark name in this document, or null. */
+    readonly anchor: string | null;
+    /** `\o` — the hover tooltip, or null. */
+    readonly tooltip: string | null;
 }
 
 /** One recognized REF instruction: the target name and the supported switches, nothing else. */
@@ -1007,380 +922,434 @@ interface RefFieldSpec {
  */
 declare function parseRefInstruction(raw: string): RefFieldSpec | null;
 
-/** 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 story's resolved REF inputs for one layout pass.
  *
- * 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.
+ * Threaded as a runtime rider on the layout options (see `layoutSemanticDocument`) rather
+ * than a `SemanticLayoutOptions` member, so the public options surface stays put. Absent
+ * means every REF field paints its cached result — the pre-existing degradation, and the one
+ * header/footer and text-box stories still take. Note stories receive the body's context
+ * through `NotesLayoutInput.refFields`.
  */
-interface NumberingLevelIndent {
-    readonly left: number;
-    readonly right: number;
-    readonly hanging: number;
-    readonly firstLine: number;
+interface RefFieldContext {
     /**
-     * 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.
+     * Content token over each paragraph ID and its PAINTED REF outputs in the story, for the
+     * section prepass memo. IDs keep structural edits from moving an identical sequence of
+     * outputs between paragraphs while the aggregate falsely reports unchanged dependencies.
+     * A renumbering edit can move a REF value in a section whose own blocks and list map are
+     * identity-unchanged, and this token is the only validator that sees it. A field that
+     * failed calibration contributes its (session-constant) cached text, so the token still
+     * moves when painted output or its owning paragraph changes.
      */
-    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;
+    readonly valuesToken: string;
+    /** The paragraph's REF outputs folded for its block cache key; `''` when it holds none. */
+    tokenForParagraph(paragraphId: string): string;
     /**
-     * `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.
+     * The live value ONE field paints, keyed by its begin / `w:fldSimple` node id, or null to
+     * keep the cached result (failed calibration, unresolvable, or an anchor this scan never
+     * saw). Anchor-keyed so the projection's paint and this context's token fold read the SAME
+     * calibration verdict, however each walk collected the field's cached text.
      */
-    readonly lvlRestart?: number;
+    liveValueOf(anchorId: string, spec: RefFieldSpec): string | null;
     /**
-     * `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.
+     * The synthesized display of ONE AUTONUM-family field, keyed by its begin / `w:fldSimple`
+     * node id, or null to paint nothing (unsupported switches, or an anchor this scan never
+     * saw — both the field's historical rendering). These fields carry no cached result at
+     * all, so there is no calibration: the sequential value is the only display they have.
+     * Optional so hand-built contexts predating it stay valid.
      */
-    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;
+    autonumValueOf?(anchorId: string): string | null;
+    /**
+     * The deferred projection of ONE `PAGEREF` field, or null to keep the cached result
+     * (missing bookmark, unsupported switches, or an anchor this scan never saw).
+     *
+     * A `PAGEREF` value is a property of pagination, so the scan cannot compute it — it hands
+     * the projection the resolved TARGET and the calibration inputs instead, and document
+     * finalize (`finalizePageFieldProjection`) substitutes the page number the target's first
+     * fragment lands on. Optional so hand-built contexts predating it stay valid.
+     */
+    pageRefProjectionOf?(anchorId: string, spec: RefFieldSpec): PageRefFieldProjection | null;
 }
 /**
- * One `w:lvlOverride` on a `w:num`: a restart value, a replacement level, or both.
+ * Sticky calibration identity for one `PAGEREF` field.
  *
- * How two lists share an abstract definition while numbering independently.
+ * An opaque frozen object rather than a mutable verdict holder because span markers are
+ * serialized into fragment signatures — a verdict written into the marker would move a
+ * signature that no painted output moved. The verdict itself lives beside the finalize pass
+ * (`field-page-furniture.ts`), keyed weakly on this object; the registry below carries the
+ * object across passes the same way REF verdicts are carried.
  */
-interface LevelOverride {
-    readonly startOverride?: number;
-    /** Full level replacement when `w:lvl` is present under the override. */
-    readonly level?: NumberingLevel;
+type PageRefCalibrationCell = Readonly<Record<never, never>>;
+/**
+ * What a `PAGEREF` span carries to document finalize: the resolved target, the normalized
+ * authored cache (the calibration oracle), and the sticky calibration identity.
+ */
+interface PageRefFieldProjection {
+    /** Canonical id of the paragraph the bookmark names — first declaration wins. */
+    readonly targetParagraphId: string;
+    /** The authored cached result, whitespace-collapsed — what the computed number must reproduce. */
+    readonly cached: string;
+    readonly calibration: PageRefCalibrationCell;
 }
 /**
- * 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.
+ * Note parts whose stories join the context: their REF fields resolve against the body's
+ * bookmarks and numbering (a footnote citing "Section 1.2(c)" targets a body paragraph),
+ * and their bookmark declarations become plain-REF targets. Number switches aimed AT a
+ * note paragraph still fall back to the cached result — the list map is the body's.
  */
-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;
+interface RefNoteParts {
+    readonly footnotesPart: OoxmlPart | null;
+    readonly endnotesPart: OoxmlPart | null;
 }
 /**
- * One `w:num` — the thing a paragraph's `w:numId` actually names.
+ * Resolve the document's REF fields for one layout pass, or null when it has none.
  *
- * Points at an {@link AbstractNumDefinition} and may override any of its levels.
+ * Bookmarks and REF fields resolve across the body story and (when `notes` is given) the
+ * footnote/endnote stories, against ONE shared target index — a footnote REF finds the
+ * body bookmark it cites. Header/footer and text-box stories are not given a context and
+ * keep painting cached results.
  */
-interface NumDefinition {
-    readonly numId: string;
-    readonly abstractNumId: string;
-    readonly overrides: ReadonlyMap<number, LevelOverride>;
-}
+declare function resolveStoryRefFields(blocks: readonly OoxmlElement[], listItems: ReadonlyMap<string, ResolvedListItem> | undefined, notes?: RefNoteParts): RefFieldContext | null;
+
+type AllowlistedPageField = 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES';
 /**
- * The bounded projection of `numbering.xml` that list layout resolves against.
+ * Which allowlisted page fields a header/footer story actually contains.
  *
- * 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.
+ * Drives layout reuse: no fields → one baseline; NUMPAGES only → one layout per page count;
+ * SECTIONPAGES only → one layout per section page count; PAGE (alone or combined) → per
+ * distinct evaluated values with a bounded cache. Counts both complex markers and
+ * `w:fldSimple` (including an allowlisted page field nested inside a non-page simple field).
  */
-interface NumberingIndex {
-    readonly abstractNums: ReadonlyMap<string, AbstractNumDefinition>;
-    readonly nums: ReadonlyMap<string, NumDefinition>;
+interface StoryPageFieldNeeds {
+    readonly hasPage: boolean;
+    readonly hasNumPages: boolean;
+    readonly hasSectionPages: boolean;
 }
+
 /**
- * Build a numbering index from the root of a numbering part (`w:numbering`).
+ * What a piece says about the FIELD result it came from, for Word's shading.
  *
- * Empty / missing roots yield an empty index. Duplicate ids keep the first definition.
+ * Carried from layout rather than decided at paint time because only the walk knows an atom was
+ * a field at all — by paint the result is just text. Whether the shading is actually drawn is a
+ * view decision made downstream, so this states the fact and nothing about the appearance.
  */
+interface FieldAtomMarker {
+    /**
+     * A legacy form field: `w:fldChar/w:ffData` (FORMTEXT, FORMCHECKBOX, FORMDROPDOWN).
+     *
+     * Word shades these on a different rule from ordinary fields — always, unless the document
+     * turns it off — because they mark the blanks somebody is meant to fill in.
+     */
+    readonly formField: boolean;
+    /**
+     * A BODY PAGE / NUMPAGES / SECTIONPAGES atom whose value depends on pagination.
+     *
+     * The paragraph walk cannot know which page the field lands on — layout runs before the page
+     * count — so it paints a placeholder and records the field's kind here. Document finalize
+     * (`substituteBodyPageFields`) reads this marker and substitutes the real value per page.
+     * Absent in headers/footers, which evaluate live through their own per-page projector.
+     */
+    readonly pageField?: {
+        readonly kind: AllowlistedPageField;
+        /** The field's `\#` numeric picture, applied when finalize substitutes the value. */
+        readonly picture?: string;
+    };
+    /**
+     * A BODY `PAGEREF` atom whose value is the page number its bookmark target lands on.
+     *
+     * Deferred exactly like {@link pageField}: the paragraph walk paints the field's cached
+     * result (or the placeholder digit when the file cached none) and records the resolved
+     * target here; document finalize substitutes the number of the page hosting the target's
+     * first fragment, gated per field on the calibration verdict.
+     */
+    readonly pageRef?: PageRefFieldProjection;
+}
+/** A half-open model-offset range, in the paragraph's own UTF-16 offset space. */
+interface ModelRange {
+    readonly start: number;
+    readonly end: number;
+}
 /**
- * Project `numbering.xml` into the bounded index.
+ * How layout turns a typed `w:hyperlink` node into the sanitized record spans carry.
  *
- * 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.
+ * Injected rather than computed here because resolving `r:id` needs the PACKAGE's
+ * relationships and this module only ever sees one part's tree. `null` means the caller
+ * declined to project — the runs still measure and paint, they simply carry no link, which is
+ * the right degradation: text is never lost for want of a target.
  */
-declare function buildNumberingIndex(root: OoxmlElement | null | undefined): NumberingIndex;
-/** Resolve the effective level for a `numId` + `ilvl`, applying overrides. */
+type HyperlinkProjector = (link: OoxmlNode) => SpanLinkRecord | null;
 /**
- * The effective level for one paragraph's numbering reference, after overrides and style links.
+ * How layout turns a parsed HYPERLINK field instruction into the sanitized record spans carry.
  *
- * 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.
+ * Injected for the same reason as {@link HyperlinkProjector}: the spec's raw target must cross
+ * the surface's ONE href trust boundary, and layout owns no sanitization policy. `null` means
+ * no link — the cached result still paints as plain text, which is the right degradation.
  */
-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 FieldLinkProjector = (spec: HyperlinkFieldSpec) => SpanLinkRecord | null;
 
-interface DrawingPoint {
-    readonly x: number;
-    readonly y: number;
-}
-interface DrawingInsets {
-    readonly top: number;
-    readonly right: number;
-    readonly bottom: number;
-    readonly left: number;
+/** Document-wide East Asian line-break and whitespace policy. @public */
+interface CjkTypographySettings {
+    /** Apply the strict Japanese small-kana and prolonged-sound-mark restrictions. */
+    readonly strict: boolean;
+    /** Whitespace compression selected by `w:characterSpacingControl`. */
+    readonly compression: 'doNotCompress' | 'compressPunctuation' | 'compressPunctuationAndJapaneseKana';
+    /** Custom no-line-start characters, keyed by normalized language tag. */
+    readonly before: Readonly<Record<string, string>>;
+    /** Custom no-line-end characters, keyed by normalized language tag. */
+    readonly after: Readonly<Record<string, string>>;
 }
-type DrawingClipFallback = 'none' | 'unsupported-preset';
-interface DrawingGeometry {
-    readonly contentBounds: LayoutBox;
-    readonly paintBounds: LayoutBox;
-    readonly hitBounds: LayoutBox;
-    readonly transformedCorners: readonly DrawingPoint[];
-    readonly clipPolygon: readonly DrawingPoint[] | null;
-    readonly clipFallback: DrawingClipFallback;
-    readonly effectInsets: DrawingInsets;
-}
-
-/** Horizontal alignment of a paragraph (`w:jc`, ECMA-376 §17.3.1.13). */
-type Alignment = 'left' | 'center' | 'right' | 'both';
 
-interface StyleDefinition {
-    readonly styleId: string;
-    readonly type: string;
-    readonly basedOn: string | null;
-    /** `w:next` — the authoring style for a following paragraph. */
-    readonly next: string | null;
-    readonly outlineLevel: number | null;
-    readonly paragraphProperties: readonly OoxmlProperty[];
-    readonly runProperties: readonly OoxmlProperty[];
-    readonly paragraphPropertiesNode: OoxmlElement | undefined;
-    readonly tablePropertiesNode: OoxmlElement | undefined;
-    readonly tableRowPropertiesNode: OoxmlElement | undefined;
-    readonly conditionalTableFormats: ReadonlyMap<string, OoxmlElement>;
+/**
+ * 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
+ * that an attacker-authored spacing would push pagination into pathological page counts.
+ */
+declare const MAX_PARAGRAPH_SPACING_PT: number;
+/** Soft ceiling on border width (96 eighths = 12pt). Word's UI tops out well below this. */
+declare const MAX_BORDER_WIDTH_PT = 12;
+/** Soft ceiling on border-to-text gap (`w:space`, already in points). */
+declare const MAX_BORDER_SPACE_PT = 3168;
+/**
+ * A paragraph's resolved space before and after, in points.
+ *
+ * Already collapsed against `w:contextualSpacing`, so adjacent same-style paragraphs that suppress
+ * their gap arrive here with it removed rather than leaving that to whoever stacks them.
+ */
+interface ParagraphSpacing {
+    /** `w:spacing/@before`, in points. */
+    readonly before: number;
+    /** `w:spacing/@after`, in points. */
+    readonly after: number;
 }
-declare function isValidStyleId(raw: string | undefined): raw is string;
-
-/** 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;
 /**
- * The whole styles part, indexed and ready to resolve against.
+ * The gap Word substitutes when `w:beforeAutospacing` / `w:afterAutospacing` is on
+ * (ECMA-376 §17.3.1.33, the `w:spacing` clause both attributes belong to).
  *
- * `cacheToken` is load-bearing: it folds into layout cache producers so breaks measured under one
- * styles part are never reused under another.
+ * 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,
+ * 14pt, which is what a document round-tripped through Word's HTML filter carries — and this
+ * one is everywhere, because Word writes `w:before="100" w:beforeAutospacing="1"` for it. Reading
+ * only the literal 100 twips lays every such paragraph out 9pt tight, which moves page breaks.
  */
-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 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>;
+declare const AUTO_PARAGRAPH_SPACING_PT = 14;
+/**
+ * Where a paragraph sits, for the two contexts in which Word's auto spacing resolves to 0
+ * instead of {@link AUTO_PARAGRAPH_SPACING_PT}.
+ *
+ * Both come from the HTML model the attribute emulates: a `<li>` and a `<td>` collapse the
+ * paragraph margin, a bare `<p>` does not. A caller that says nothing gets the body answer.
+ */
+interface ParagraphAutoSpacingContext {
+    /** The paragraph participates in numbering (`w:numPr`), i.e. it is a list item. */
+    readonly inList?: boolean;
+    /** The paragraph lives in a table cell. */
+    readonly inTableCell?: boolean;
 }
 /**
- * A paragraph's properties after the cascade, plus the same list WITHOUT its own `w:pPr`.
+ * Resolved line spacing (`w:spacing/@line` + `@lineRule`, ECMA-376 17.3.1.33).
  *
- * 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.
+ * `auto` is the interesting one: `@line` is 240ths of a line, so 240 is single, 360 is
+ * one-and-a-half, 480 is double — and Word's own Normal style since 2013 is 259, i.e.
+ * 1.08. A document laid out at a flat single spacing is ~8% tight on EVERY line, which
+ * moves every page break, so this is not a cosmetic detail.
+ *
+ * `exact` fixes the line box at `@line` twips and lets tall glyphs clip, the way Word
+ * does. `atLeast` uses it as a floor.
  */
-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[];
+type LineSpacingRule = 'auto' | 'exact' | 'atLeast';
+/**
+ * Resolved line spacing: the rule, and the value it applies.
+ *
+ * `value` means different things per rule — 240ths of a line under `auto`, points under `exact`
+ * and `atLeast` — which is why the two travel together and neither is useful alone.
+ */
+interface ParagraphLineSpacing {
+    readonly rule: LineSpacingRule;
+    /** `auto`: the 240ths-of-a-line multiplier numerator. Otherwise points. */
+    readonly value: number;
+}
+/** Single spacing: what a paragraph that says nothing gets. */
+declare const SINGLE_LINE_SPACING: ParagraphLineSpacing;
+/**
+ * One resolved `w:pBdr` edge: its style, colour, thickness and gap.
+ *
+ * `widthPt` and `spacePt` are already converted and CLAMPED — both come from a file, and an
+ * unbounded border width becomes a layout dimension.
+ */
+interface ParagraphBorderEdge {
+    /** Authored `ST_Border` value (`single`, `dashed`, …). */
+    readonly val: string;
+    /** RRGGBB, or null when auto/missing (paint defaults to black). */
+    readonly color: string | null;
+    /** Border thickness in points (`w:sz` is eighths of a point). */
+    readonly widthPt: number;
+    /** Gap from text to the rule, in points (`w:space`). */
+    readonly spacePt: number;
     /**
-     * Inherited run properties for CONTENT runs (before direct run `rPr`).
+     * `w:shadow` — Word offsets a drop shadow behind the rule.
      *
-     * 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.
+     * Present only when authored true, so an edge that says nothing keeps the shape earlier
+     * fixtures assert. Resolved and carried; drawing it is deferred.
      */
-    readonly styleId: string | null;
+    readonly shadow?: true;
 }
+/** The six `CT_PBdr` children, in schema order (ECMA-376 §17.3.1.24). */
+declare const PARAGRAPH_BORDER_SIDES: readonly ["top", "left", "bottom", "right", "between", "bar"];
 /**
- * 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).
+ * Which of the six `CT_PBdr` edges.
  *
- * 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.
+ * Four are physical box edges; `between` and `bar` are group-relative, drawn only where
+ * consecutive paragraphs share a border definition.
  */
-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[];
+type ParagraphBorderSide = (typeof PARAGRAPH_BORDER_SIDES)[number];
+/**
+ * A paragraph's resolved `w:pBdr` (ECMA-376 §17.3.1.24).
+ *
+ * `top`/`left`/`bottom`/`right` are the four physical edges of the box. The other two are
+ * group-relative: `between` draws at a boundary INSIDE a run of consecutive paragraphs whose
+ * border settings are identical, and `bar` is the vertical change-bar rule beside the
+ * paragraph, drawn whether or not the paragraph groups with its neighbours.
+ */
+interface ParagraphBorders {
+    readonly top?: ParagraphBorderEdge;
+    readonly left?: ParagraphBorderEdge;
+    readonly bottom?: ParagraphBorderEdge;
+    readonly right?: ParagraphBorderEdge;
+    readonly between?: ParagraphBorderEdge;
+    readonly bar?: ParagraphBorderEdge;
 }
 /**
- * Build a cascade table from a styles part root.
+ * Resolve `w:spacing` before/after from flat paragraph properties.
  *
- * 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.
+ * Line spacing (`w:line` / `w:lineRule`) is a separate concern — it changes measured line
+ * height, not the gap between paragraphs — and is not resolved here.
+ *
+ * `w:beforeAutospacing` / `w:afterAutospacing` REPLACE the authored measurement on their own
+ * side rather than adding to it; see {@link AUTO_PARAGRAPH_SPACING_PT}.
  */
-declare function buildStyleCascadeTable(stylesRoot: OoxmlElement | null, themeFonts?: ThemeFonts): StyleCascadeTable;
+declare function paragraphSpacing(props: readonly OoxmlProperty[], context?: ParagraphAutoSpacingContext): ParagraphSpacing;
 /**
- * Cascade paragraph + inherited run properties for one paragraph's direct `w:pPr`.
+ * Resolve `w:line` / `w:lineRule` from flat paragraph properties.
  *
- * 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.
+ * Merged per attribute for the same reason as before/after: `w:spacing` is one element
+ * carrying independent attributes, and a style that states only `@line` must not reset the
+ * rule an earlier entry in the cascade set.
+ */
+declare function paragraphLineSpacing(props: readonly OoxmlProperty[]): ParagraphLineSpacing;
+/**
+ * Apply resolved line spacing to a line's natural (glyph-derived) box.
+ *
+ * Word places `auto` / `atLeast` extras BELOW the line (the last line's multiple spacing
+ * still separates it from the next paragraph). Putting that delta above inverted cover-page
+ * rhythm: `w:line="460"` on "between" opened a large gap above the word and almost none
+ * before "MERIDIAN". `exact` taller than the glyphs centers the text (ECMA-376 17.3.1.33).
+ * An `exact` box smaller than the glyphs keeps the baseline inside so clipped text still
+ * sits on it.
+ */
+declare function applyLineSpacing(spacing: ParagraphLineSpacing, naturalHeight: number, naturalBaseline: number): {
+    height: number;
+    baseline: number;
+};
+/**
+ * `w:contextualSpacing` (17.3.1.9): drop before/after between paragraphs of the SAME
+ * style. Word's built-in `ListParagraph` sets it, so every list authored in Word gets a
+ * paragraph gap between items without this.
+ */
+declare function paragraphContextualSpacing(props: readonly OoxmlProperty[]): boolean;
+/**
+ * Resolve `w:pBdr` from the paragraph-properties node.
+ *
+ * Nested — every edge is a child of `pBdr`, not an attribute — so this reads the typed tree
+ * rather than the flattened `OoxmlProperty[]` bag `propertiesOf` builds for leaf props.
+ */
+declare function paragraphBorders(pPr: OoxmlNode | undefined): ParagraphBorders;
+/**
+ * `w:pBdr` after the style cascade: a later `w:pBdr` replaces an earlier one WHOLESALE.
+ *
+ * Word does not merge edges across the cascade. A style that states only `w:bottom` discards
+ * the box its `basedOn` ancestor declared, so folding edge by edge would leave a lone
+ * underline surrounded by a box no one authored. Absence inherits; `nil`/`none` clear.
+ */
+declare function cascadedParagraphBorders(paragraphPropertyNodes: readonly OoxmlNode[]): ParagraphBorders;
+/**
+ * Visual stroke thickness layout publishes for one edge (points).
+ *
+ * Compound `ST_Border` values (`double`, …) use the shared inflated band so a thin
+ * `w:sz="3"` double still occupies a visible double-line box — matching table borders.
+ */
+declare function paragraphBorderStrokeWidthPt(edge: ParagraphBorderEdge): number;
+/**
+ * Extent one border edge occupies away from the text it decorates: gap plus rule, in points.
+ *
+ * Vertically that is flow height — a top rule pushes the first line down, a bottom rule holds
+ * the page open below the last one — so pagination has to see it. Horizontally it is
+ * publish-only: Word draws left/right paragraph rules OUTSIDE the text column and never
+ * re-breaks the lines, which is why adding a box to a paragraph in Word does not reflow it.
+ */
+declare function paragraphBorderExtentPt(edge: ParagraphBorderEdge | undefined): number;
+/** Vertical extent a bottom border adds below the last line (gap + rule). */
+declare function bottomBorderExtentPt(edge: ParagraphBorderEdge | undefined): number;
+/**
+ * Identity of a paragraph's border set, for the `w:between` group rule.
+ *
+ * Word treats consecutive paragraphs whose border settings are IDENTICAL as ONE bordered
+ * block: the top rule draws above the first, the bottom rule below the last, and each
+ * interior boundary gets `w:between` or nothing (§17.3.1.24). That is why applying a box to
+ * three selected paragraphs in Word draws one box and not three.
+ *
+ * Empty string means "no borders", which never groups with anything.
  */
-declare function cascadeParagraphFormatting(table: StyleCascadeTable, directPPr: OoxmlNode | undefined, tableCellStyle?: TableCellStyleFormatting): CascadedParagraphFormatting;
+declare function paragraphBordersFingerprint(borders: ParagraphBorders): string;
 /**
- * Bottom border after cascade: a later `w:pBdr` replaces an earlier one; absence inherits.
- * `nil`/`none` clear the edge via `paragraphBorders`.
+ * Gap to insert before a paragraph once the previous paragraph's `after` is already in the
+ * flow cursor — Word takes the larger of the two rather than summing them.
  */
-declare function cascadedBottomBorder(paragraphPropertyNodes: readonly OoxmlNode[]): ParagraphBorderEdge | undefined;
+declare function collapsedSpaceBefore(before: number, previousAfter: number): number;
 /**
- * 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.
+ * Applied before-spacing for placement (Word 2013+ / compat mode 15).
  *
- * 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.
+ * Adjacent before/after still collapse to the larger gap, but before is dropped entirely when
+ * the paragraph begins at the top of a page mid-section. The first paragraph of a document or
+ * section retains before. Callers publish this applied value on the fragment so shading, borders,
+ * selection, and paint share one geometry.
  */
-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;
-    /** Resolved outline level, with 9/invalid values treated as body text. */
-    readonly outlineLevel: number | 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;
+declare function appliedSpaceBefore(before: number, previousAfter: number, atTopOfPage: boolean, firstParagraphOfSection: boolean): number;
+
+interface DrawingPoint {
+    readonly x: number;
+    readonly y: number;
+}
+interface DrawingInsets {
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
+}
+type DrawingClipFallback = 'none' | 'unsupported-preset';
+interface DrawingGeometry {
+    readonly contentBounds: LayoutBox;
+    readonly paintBounds: LayoutBox;
+    readonly hitBounds: LayoutBox;
+    readonly transformedCorners: readonly DrawingPoint[];
+    readonly clipPolygon: readonly DrawingPoint[] | null;
+    readonly clipFallback: DrawingClipFallback;
+    readonly effectInsets: DrawingInsets;
 }
-/**
- * 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;
+
+/** Horizontal alignment of a paragraph (`w:jc`, ECMA-376 §17.3.1.13). */
+type Alignment = 'left' | 'center' | 'right' | 'both';
 
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
@@ -1531,34 +1500,159 @@ interface BorderGridGeometry {
     /** Absolute column widths for the whole table (points). */
     readonly columnWidthsPt: readonly number[];
     /**
-     * Per laid-out row: absolute top and height in the same coordinate space as cell boxes
-     * (only relative differences matter for vertical edge segmentation).
+     * Per laid-out row: absolute top and height in the same coordinate space as cell boxes
+     * (only relative differences matter for vertical edge segmentation).
+     */
+    readonly rowBands: readonly {
+        readonly y: number;
+        readonly height: number;
+    }[];
+    /** Per laid-out cell: width/height after vMerge expansion (cell-local stroke space). */
+    readonly cellBoxes: readonly (readonly {
+        readonly width: number;
+        readonly height: number;
+    }[])[];
+}
+/**
+ * Resolve borders for every cell in a laid-out table fragment.
+ *
+ * Shared vertical edges: conflict(left.right, right.left) → assigned to the left cell,
+ * segmented per row when a vMerge restart faces differing neighbors.
+ * Shared horizontal edges: conflict(above.bottom, below.top) → assigned to the above cell,
+ * segmented per grid column when a gridSpan cell faces differing below neighbors; vMerge
+ * interior seams are suppressed per interval.
+ *
+ * When `geometry` is provided, compound edges expand into explicit stroke records with
+ * corner-adjusted endpoints in cell-local points.
+ */
+declare function resolveTableCellBorderGrid(rows: readonly (readonly BorderGridCell[])[], table: TableBorderBox, columnCount: number, geometry?: BorderGridGeometry, work?: TableBorderGridResolveWork, ownershipBudget?: TableBorderOwnershipBudget): ResolvedCellBorders[][];
+/** Width contribution of a resolved edge for content inset / row sizing. */
+declare function borderExtentPt(edge: ResolvedTableBorderEdge | TableBorderSide | undefined): number;
+
+/**
+ * Why textbox story layout stopped short.
+ *
+ * Every one is a BOUND rather than a bug: nesting depth, fragment counts and the extent all
+ * come from a file. Falling back with a reason keeps the drawing rendered (clipped) instead
+ * of failing the layout pass.
+ */
+type TextboxStoryFallbackReason = 'textbox-nesting-limit' | 'textbox-fragment-limit'
+/** Flowed content is taller than the extent; trailing fragments were dropped. */
+ | 'textbox-height-clip';
+/**
+ * One text box's story laid out inside its extent, in content-box-relative coordinates.
+ *
+ * Fragments origin at the content box's top-left; paint places the content box at
+ * `drawing origin + contentOffset` and clips to the extent.
+ */
+interface TextboxStoryLayout {
+    /** Content-box-relative fragments (origin at the content box's top-left). */
+    readonly fragments: readonly BlockFragmentRecord[];
+    /** Height the blocks flow to (points), before vertical anchoring. */
+    readonly flowHeight: number;
+    /** Offset of the content box inside the drawing extent: insets plus vertical anchoring. */
+    readonly contentOffset: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    /** Content box width (extent minus horizontal insets). */
+    readonly contentWidth: number;
+    /** Content box height (extent minus vertical insets). */
+    readonly contentHeight: number;
+    /** Solid fill of the hosting shape, painted behind the story; null for no fill. */
+    readonly fillHex: string | null;
+    /** Solid outline of the hosting shape; null for no outline. */
+    readonly strokeHex: string | null;
+    /** Outline width in points; 0 when absent. */
+    readonly strokeWidthPt: number;
+    /** True when layout hit a named bound and returned a truncated / empty story. */
+    readonly fallbackReason?: TextboxStoryFallbackReason;
+    /**
+     * Resource identities of the drawings the clip DROPPED, in flow order.
+     *
+     * The furniture invalidation token walks laid-out records, and a dropped fragment leaves
+     * none — while a `withPageContext` projection of the same story can wrap differently
+     * (PAGE digits) and keep the drawing. Without this a picture clipped out of the baseline
+     * but painted by a projection never reaches the session context, so its decode settling
+     * moves nothing and the unchanged-pass early exit reuses the placeholder pages forever
+     * (#467). Absent when the clip dropped no drawings, so the common story keys byte-for-byte
+     * as before.
+     */
+    readonly clippedResourceToken?: string;
+}
+
+interface InlineDrawingRecord {
+    readonly kind: 'inlineDrawing';
+    readonly drawingNodeId: string;
+    readonly paragraphId: string;
+    readonly ownerPartName: string;
+    readonly start: number;
+    /** Left edge of the extent box (slot + distL). */
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly distL: number;
+    readonly distR: number;
+    readonly distT: number;
+    readonly distB: number;
+    /** Caret/hit advance start (slot left, before distL). */
+    readonly advanceStart: number;
+    /** Caret/hit advance end (slot + totalWidth). */
+    readonly advanceEnd: number;
+    readonly baselineOffset: number;
+    readonly paintBounds: LayoutBox;
+    readonly hitBounds: LayoutBox;
+    readonly geometry: DrawingGeometry;
+    readonly resource: ImageResourceState;
+    readonly accessibility: DrawingAccessibility;
+    /** Sanitized external hyperlink projection; inert until an explicit gesture activates it. */
+    readonly hyperlinkHref: string | null;
+    readonly effects: DrawingImageEffects;
+    readonly crop: SourceCrop;
+    readonly transform: DrawingTransform;
+    /** Fixed non-picture graphic kind for refusal labels (`chart`, `group`, …); null for pictures. */
+    readonly placeholderGraphicKind: string | null;
+    /** Typed solid-geometry payload for a renderable `wps:wsp` shape; null otherwise. */
+    readonly vectorShape: VectorShapeProjection | null;
+    /**
+     * The revision wrappers enclosing the owning run, outermost first — the same stack spans
+     * carry, so paint and review chrome give a tracked picture the same cues as tracked text.
+     * Absent when the drawing is untracked.
+     */
+    readonly revisions?: readonly RevisionAttribution[];
+}
+interface InlineDrawingLayoutContext {
+    readonly ownerPartName: string;
+    /** Precomputed run-level atom id (`w:drawing` or MC wrapper) → projection. */
+    readonly projectionForAtom?: (atomNodeId: string) => DrawingProjection | null;
+    readonly project: (drawing: OoxmlDrawingNode) => DrawingProjection | null;
+    readonly resourceOf: (projection: DrawingProjection) => ImageResourceState;
+}
+/** Named fallback when a positioning frame cannot be resolved (OpenSpec 4.6). */
+type AnchoredDrawingLayoutFallback = 'unresolvable-frame' | 'page-defer-exhausted';
+interface AnchoredDrawingRecord extends Omit<InlineDrawingRecord, 'kind' | 'baselineOffset' | 'advanceStart' | 'advanceEnd' | 'distL' | 'distR' | 'distT' | 'distB'> {
+    readonly kind: 'anchoredDrawing';
+    readonly anchorParagraphId: string;
+    readonly horizontalFrame: DrawingHorizontalReferenceFrame;
+    readonly verticalFrame: DrawingVerticalReferenceFrame;
+    readonly horizontalFrameOrigin: number;
+    readonly verticalFrameOrigin: number;
+    readonly behindDocument: boolean;
+    readonly allowOverlap: boolean;
+    readonly layoutInCell: boolean;
+    readonly relativeHeight: number;
+    readonly wrap: Exclude<ImageWrapTarget, 'inline'>;
+    readonly layoutFallback?: AnchoredDrawingLayoutFallback;
+    /** Canonical document traversal index within the owner story part. */
+    readonly sourceOrder?: number;
+    /**
+     * Laid-out textbox story for a `wps:txbx` drawing; paint renders it clipped inside the
+     * extent instead of a placeholder. Absent when the drawing carries no story or the host
+     * did not thread story layout (the record then degrades to the placeholder path).
      */
-    readonly rowBands: readonly {
-        readonly y: number;
-        readonly height: number;
-    }[];
-    /** Per laid-out cell: width/height after vMerge expansion (cell-local stroke space). */
-    readonly cellBoxes: readonly (readonly {
-        readonly width: number;
-        readonly height: number;
-    }[])[];
+    readonly textboxStory?: TextboxStoryLayout;
 }
-/**
- * Resolve borders for every cell in a laid-out table fragment.
- *
- * Shared vertical edges: conflict(left.right, right.left) → assigned to the left cell,
- * segmented per row when a vMerge restart faces differing neighbors.
- * Shared horizontal edges: conflict(above.bottom, below.top) → assigned to the above cell,
- * segmented per grid column when a gridSpan cell faces differing below neighbors; vMerge
- * interior seams are suppressed per interval.
- *
- * When `geometry` is provided, compound edges expand into explicit stroke records with
- * corner-adjusted endpoints in cell-local points.
- */
-declare function resolveTableCellBorderGrid(rows: readonly (readonly BorderGridCell[])[], table: TableBorderBox, columnCount: number, geometry?: BorderGridGeometry, work?: TableBorderGridResolveWork, ownershipBudget?: TableBorderOwnershipBudget): ResolvedCellBorders[][];
-/** Width contribution of a resolved edge for content inset / row sizing. */
-declare function borderExtentPt(edge: ResolvedTableBorderEdge | TableBorderSide | undefined): number;
 
 /**
  * A paragraph's list membership fully resolved: definition, level, marker text and geometry.
@@ -1673,297 +1767,465 @@ declare function listMarkerBox(item: ResolvedListItem, markerWidth: number, line
     height: number;
 } | null;
 
+interface StyleDefinition {
+    readonly styleId: string;
+    readonly type: string;
+    readonly basedOn: string | null;
+    /** `w:next` — the authoring style for a following paragraph. */
+    readonly next: string | null;
+    readonly outlineLevel: number | null;
+    readonly paragraphProperties: readonly OoxmlProperty[];
+    readonly runProperties: readonly OoxmlProperty[];
+    readonly paragraphPropertiesNode: OoxmlElement | undefined;
+    readonly tablePropertiesNode: OoxmlElement | undefined;
+    readonly tableRowPropertiesNode: OoxmlElement | undefined;
+    readonly conditionalTableFormats: ReadonlyMap<string, OoxmlElement>;
+}
+declare function isValidStyleId(raw: string | undefined): raw is string;
+
+/** 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;
 /**
- * The story's resolved REF inputs for one layout pass.
+ * The whole styles part, indexed and ready to resolve against.
  *
- * Threaded as a runtime rider on the layout options (see `layoutSemanticDocument`) rather
- * than a `SemanticLayoutOptions` member, so the public options surface stays put. Absent
- * means every REF field paints its cached result — the pre-existing degradation, and the one
- * header/footer and text-box stories still take. Note stories receive the body's context
- * through `NotesLayoutInput.refFields`.
+ * `cacheToken` is load-bearing: it folds into layout cache producers so breaks measured under one
+ * styles part are never reused under another.
  */
-interface RefFieldContext {
+interface StyleCascadeTable {
+    readonly typography?: CjkTypographySettings;
     /**
-     * Content token over every PAINTED REF output in the story, for the section prepass memo.
-     * A renumbering edit can move a REF value in a section whose own blocks and list map are
-     * identity-unchanged, and this token is the only validator that sees it. A field that
-     * failed calibration contributes its (session-constant) cached text, so the token still
-     * moves exactly when painted output moves.
+     * 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 valuesToken: string;
-    /** The paragraph's REF outputs folded for its block cache key; `''` when it holds none. */
-    tokenForParagraph(paragraphId: string): string;
+    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;
     /**
-     * The live value ONE field paints, keyed by its begin / `w:fldSimple` node id, or null to
-     * keep the cached result (failed calibration, unresolvable, or an anchor this scan never
-     * saw). Anchor-keyed so the projection's paint and this context's token fold read the SAME
-     * calibration verdict, however each walk collected the field's cached text.
+     * `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.
      */
-    liveValueOf(anchorId: string, spec: RefFieldSpec): string | null;
+    readonly defaultTableStyleId: string | null;
     /**
-     * The synthesized display of ONE AUTONUM-family field, keyed by its begin / `w:fldSimple`
-     * node id, or null to paint nothing (unsupported switches, or an anchor this scan never
-     * saw — both the field's historical rendering). These fields carry no cached result at
-     * all, so there is no calibration: the sequential value is the only display they have.
-     * Optional so hand-built contexts predating it stay valid.
+     * The theme part's 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.
      */
-    autonumValueOf?(anchorId: string): string | null;
+    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 deferred projection of ONE `PAGEREF` field, or null to keep the cached result
-     * (missing bookmark, unsupported switches, or an anchor this scan never saw).
+     * The same list WITHOUT the paragraph's own `w:pPr` — everything it inherits.
      *
-     * A `PAGEREF` value is a property of pagination, so the scan cannot compute it — it hands
-     * the projection the resolved TARGET and the calibration inputs instead, and document
-     * finalize (`finalizePageFieldProjection`) substitutes the page number the target's first
-     * fragment lands on. Optional so hand-built contexts predating it stay valid.
+     * 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.
      */
-    pageRefProjectionOf?(anchorId: string, spec: RefFieldSpec): PageRefFieldProjection | null;
+    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;
+}
+/**
+ * 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, settingsRoot?: OoxmlElement | null): 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;
+    /** Resolved outline level, with 9/invalid values treated as body text. */
+    readonly outlineLevel: number | 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;
 }
 /**
- * Sticky calibration identity for one `PAGEREF` field.
+ * 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;
+
+/**
+ * `w:tblW` / `w:tcW` / `w:wBefore` (CT_TblWidth, 17.4.63 / 17.4.71 / 17.4.86): a PREFERRED
+ * width plus the unit it is stated in. Preferred is the operative word — it is what the
+ * producer asked for, not what the table resolved to.
  *
- * An opaque frozen object rather than a mutable verdict holder because span markers are
- * serialized into fragment signatures — a verdict written into the marker would move a
- * signature that no painted output moved. The verdict itself lives beside the finalize pass
- * (`field-page-furniture.ts`), keyed weakly on this object; the registry below carries the
- * object across passes the same way REF verdicts are carried.
+ * `pct` is stated in fiftieths of a percent (5000 = 100%) by Word, and in the `"50%"`
+ * string form of `ST_Percentage` by others; both are read. `auto` and `nil` carry no width.
  */
-type PageRefCalibrationCell = Readonly<Record<never, never>>;
+type PreferredWidthType = 'dxa' | 'pct' | 'auto' | 'nil';
 /**
- * What a `PAGEREF` span carries to document finalize: the resolved target, the normalized
- * authored cache (the calibration oracle), and the sticky calibration identity.
+ * `w:tblW` / `w:tcW` — a requested width, whose UNIT depends on its type.
+ *
+ * Points for `dxa`, percent for `pct`, and zero for `auto`/`nil`. Reading `value` without `type`
+ * is always wrong.
  */
-interface PageRefFieldProjection {
-    /** Canonical id of the paragraph the bookmark names — first declaration wins. */
-    readonly targetParagraphId: string;
-    /** The authored cached result, whitespace-collapsed — what the computed number must reproduce. */
-    readonly cached: string;
-    readonly calibration: PageRefCalibrationCell;
+interface PreferredWidth {
+    readonly type: PreferredWidthType;
+    /** POINTS for `dxa`, PERCENT (0–100) for `pct`, 0 for `auto`/`nil`. */
+    readonly value: number;
 }
+/** The frozen "no preferred width" value — what a table or cell that declares none resolves to. */
+declare const AUTO_PREFERRED_WIDTH: PreferredWidth;
+
 /**
- * Note parts whose stories join the context: their REF fields resolve against the body's
- * bookmarks and numbering (a footnote citing "Section 1.2(c)" targets a body paragraph),
- * and their bookmark declarations become plain-REF targets. Number switches aimed AT a
- * note paragraph still fall back to the cached result — the list map is the body's.
+ * The uniform 3 pt (60 twip) inset this lane used to apply on every side.
+ *
+ * Word's defaults are not uniform — see {@link DEFAULT_CELL_MARGINS} — so nothing resolves
+ * against this any more. Kept because it is published.
  */
-interface RefNoteParts {
-    readonly footnotesPart: OoxmlPart | null;
-    readonly endnotesPart: OoxmlPart | null;
+declare const CELL_PAD = 3;
+/** Resolved cell padding in points, after the table default and any per-cell override. */
+interface CellMarginsPt {
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
 }
 /**
- * Resolve the document's REF fields for one layout pass, or null when it has none.
+ * Word's own default cell padding, for a document whose styles part states none.
  *
- * Bookmarks and REF fields resolve across the body story and (when `notes` is given) the
- * footnote/endnote stories, against ONE shared target index — a footnote REF finds the
- * body bookmark it cites. Header/footer and text-box stories are not given a context and
- * keep painting cached results.
+ * 0 top, 0 bottom, 108 twips left and right — the values `TableNormal` carries. A uniform
+ * 3 pt on all four sides made every row of every table that authored no `w:tblCellMar` 6 pt
+ * taller than Word's, and that error compounds down a table until it paginates a page early.
+ * A document that DOES ship a default table style resolves against that instead; this is the
+ * floor beneath it.
  */
-declare function resolveStoryRefFields(blocks: readonly OoxmlElement[], listItems: ReadonlyMap<string, ResolvedListItem> | undefined, notes?: RefNoteParts): RefFieldContext | null;
+declare const DEFAULT_CELL_MARGINS: CellMarginsPt;
+
+/** `w:vAlign` — where a cell's content sits when the row is taller than the content. */
+type CellVerticalAlign = 'top' | 'center' | 'bottom';
 
 /**
- * Why textbox story layout stopped short.
+ * Layout-time nesting ceiling. Parse-time depth (MAX_DEPTH = 256 XML levels) alone still
+ * admits ~80 levels of `w:tbl` recursion into the layout walk; deeper tables render as an
+ * empty cell box rather than recursing.
+ */
+declare const MAX_TABLE_NESTING = 16;
+/**
+ * Soft ceiling on an authored `w:trHeight` (~22"). Hostile `w:val` otherwise becomes a
+ * multi-page row that every pagination preflight and cell box inherits.
+ */
+declare const MAX_TABLE_ROW_HEIGHT_PT: number;
+/**
+ * `w:trPr/w:trHeight` (17.4.81) resolved for layout. Points leave the reader already —
+ * twips convert once here, matching every other table geometry boundary.
  *
- * Every one is a BOUND rather than a bug: nesting depth, fragment counts and the extent all
- * come from a file. Falling back with a reason keeps the drawing rendered (clipped) instead
- * of failing the layout pass.
+ * Word quirk (matches Form025U and Word's UI export): a present `@w:val` with an omitted
+ * `@w:hRule` is treated as `atLeast`, not ECMA's `auto`. Explicit `auto` still ignores val.
  */
-type TextboxStoryFallbackReason = 'textbox-nesting-limit' | 'textbox-fragment-limit'
-/** Flowed content is taller than the extent; trailing fragments were dropped. */
- | 'textbox-height-clip';
+type TableRowHeightRule = 'auto' | 'atLeast' | 'exact';
 /**
- * One text box's story laid out inside its extent, in content-box-relative coordinates.
+ * `w:trHeight` — a row's height rule and its value.
  *
- * Fragments origin at the content box's top-left; paint places the content box at
- * `drawing origin + contentOffset` and clips to the extent.
+ * `auto` carries no value at all, which is why this is a union rather than a rule plus an
+ * optional number.
  */
-interface TextboxStoryLayout {
-    /** Content-box-relative fragments (origin at the content box's top-left). */
-    readonly fragments: readonly BlockFragmentRecord[];
-    /** Height the blocks flow to (points), before vertical anchoring. */
-    readonly flowHeight: number;
-    /** Offset of the content box inside the drawing extent: insets plus vertical anchoring. */
-    readonly contentOffset: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    /** Content box width (extent minus horizontal insets). */
-    readonly contentWidth: number;
-    /** Content box height (extent minus vertical insets). */
-    readonly contentHeight: number;
-    /** Solid fill of the hosting shape, painted behind the story; null for no fill. */
-    readonly fillHex: string | null;
-    /** Solid outline of the hosting shape; null for no outline. */
-    readonly strokeHex: string | null;
-    /** Outline width in points; 0 when absent. */
-    readonly strokeWidthPt: number;
-    /** True when layout hit a named bound and returned a truncated / empty story. */
-    readonly fallbackReason?: TextboxStoryFallbackReason;
+type TableRowHeight = {
+    readonly rule: 'auto';
+} | {
+    readonly rule: 'atLeast' | 'exact';
+    readonly valuePt: number;
+};
+/** `w:tblPr/w:jc` (17.4.29, ST_JcTable): where the table sits within the text column. */
+type TableAlignment = 'left' | 'center' | 'right';
+/**
+ * `w:tblpPr/@w:horzAnchor` (17.4.58) and `@w:vertAnchor` (17.4.66): the box a floated
+ * table's offsets are measured from. Absent means `text` for both.
+ */
+type TableFloatAnchor = 'text' | 'margin' | 'page';
+/** `w:tblpPr/@w:tblpXSpec` (17.4.63, ST_XAlign). */
+type TableFloatXSpec = 'left' | 'center' | 'right' | 'inside' | 'outside';
+/** `w:tblpPr/@w:tblpYSpec` (17.4.65, ST_YAlign). */
+type TableFloatYSpec = 'inline' | 'top' | 'center' | 'bottom' | 'inside' | 'outside';
+/**
+ * `w:tblPr/w:tblpPr` (17.4.57) — a table positioned against an anchor box rather than at
+ * the point in the text where it was authored.
+ *
+ * A spec (`tblpXSpec`/`tblpYSpec`) supersedes the matching offset when both are present:
+ * 17.4.57 states the alignment outright, and the offset only answers "how far from the
+ * anchor" for the case where no alignment was stated.
+ */
+interface TableFloatPosition {
+    readonly horzAnchor: TableFloatAnchor;
+    readonly vertAnchor: TableFloatAnchor;
+    readonly xSpec?: TableFloatXSpec;
+    /** `w:tblpX` in points; signed, so a table can be pulled into the margin. */
+    readonly xPt: number;
+    readonly ySpec?: TableFloatYSpec;
+    /** `w:tblpY` in points; signed. */
+    readonly yPt: number;
+    readonly distances?: {
+        readonly top: number;
+        readonly right: number;
+        readonly bottom: number;
+        readonly left: number;
+    };
+}
+/**
+ * One cell in the resolved table structure.
+ *
+ * `gridSpan` is clamped at READ time and layout never re-derives it — the value comes from a file
+ * and would otherwise be a loop bound an attacker controls.
+ */
+interface SemanticTableCell {
+    readonly id: string;
+    /** Derived content-edge geometry for a verified legacy full-width parent table. */
+    readonly legacyContentAlignment?: true;
+    /** Clamped to [1, MAX_TABLE_COLUMNS] at read time; layout never re-derives it. */
+    readonly gridSpan: number;
     /**
-     * Resource identities of the drawings the clip DROPPED, in flow order.
+     * Absolute grid column this cell starts on, after `w:gridBefore` and every preceding
+     * span. Structural conditional formats and cell geometry both key on this, never on the
+     * cell's position in the row: one `gridSpan` cell otherwise shifts firstCol/lastCol and
+     * the vertical bands for every cell after it.
+     */
+    readonly gridColumn: number;
+    /** Canonical `w:gridCol` node id for this cell's start column, when the grid is authored. */
+    readonly gridColumnId?: string;
+    /** A vMerge cell that is not the restart continues the cell above: box, no content. */
+    readonly vMergeContinue: boolean;
+    /** `w:vAlign` — defaults to top when omitted/unrecognised. */
+    readonly vAlign: CellVerticalAlign;
+    /** `w:textDirection`; unsupported values keep horizontal layout. */
+    readonly textDirection: 'horizontal' | 'btLr';
+    /** Resolved per-side margins (tcMar over tblCellMar over the table style over Word's default). */
+    readonly margins: CellMarginsPt;
+    /** Three-state authored `tcBorders` (omitted / none / edge). */
+    readonly borders: CellBorderBox;
+    /** Validated 6-hex shading fill, absent for none/auto. */
+    readonly shading?: string;
+    /**
+     * `w:tcW` — the width this cell asked for, as authored.
      *
-     * The furniture invalidation token walks laid-out records, and a dropped fragment leaves
-     * none — while a `withPageContext` projection of the same story can wrap differently
-     * (PAGE digits) and keep the drawing. Without this a picture clipped out of the baseline
-     * but painted by a projection never reaches the session context, so its decode settling
-     * moves nothing and the unchanged-pass early exit reuses the placeholder pages forever
-     * (#467). Absent when the clip dropped no drawings, so the common story keys byte-for-byte
-     * as before.
+     * Published for consumers that need the cell's own statement (a column-resize handle has
+     * to write back to it). Column geometry is NOT derived from this field: the resolver works
+     * from a flat claim list built in the same pass, because resolving a column means looking
+     * at every cell that covers it across every row, not at one cell at a time. Read
+     * `columnWidthsPt` for what the table actually laid out.
      */
-    readonly clippedResourceToken?: string;
-}
-
-interface InlineDrawingRecord {
-    readonly kind: 'inlineDrawing';
-    readonly drawingNodeId: string;
-    readonly paragraphId: string;
-    readonly ownerPartName: string;
-    readonly start: number;
-    /** Left edge of the extent box (slot + distL). */
-    readonly x: number;
-    readonly y: number;
-    readonly width: number;
-    readonly height: number;
-    readonly distL: number;
-    readonly distR: number;
-    readonly distT: number;
-    readonly distB: number;
-    /** Caret/hit advance start (slot left, before distL). */
-    readonly advanceStart: number;
-    /** Caret/hit advance end (slot + totalWidth). */
-    readonly advanceEnd: number;
-    readonly baselineOffset: number;
-    readonly paintBounds: LayoutBox;
-    readonly hitBounds: LayoutBox;
-    readonly geometry: DrawingGeometry;
-    readonly resource: ImageResourceState;
-    readonly accessibility: DrawingAccessibility;
-    /** Sanitized external hyperlink projection; inert until an explicit gesture activates it. */
-    readonly hyperlinkHref: string | null;
-    readonly effects: Readonly<{
-        readonly grayscale: boolean;
-        readonly brightness: number;
-        readonly contrast: number;
-    }>;
-    readonly crop: SourceCrop;
-    readonly transform: DrawingTransform;
-    /** Fixed non-picture graphic kind for refusal labels (`chart`, `group`, …); null for pictures. */
-    readonly placeholderGraphicKind: string | null;
-    /** Typed solid-geometry payload for a renderable `wps:wsp` shape; null otherwise. */
-    readonly vectorShape: VectorShapeProjection | null;
+    readonly preferredWidth: PreferredWidth;
     /**
-     * The revision wrappers enclosing the owning run, outermost first — the same stack spans
-     * carry, so paint and review chrome give a tracked picture the same cues as tracked text.
-     * Absent when the drawing is untracked.
+     * What the table style says about this cell's paragraphs and runs (17.7.6.6) — a header
+     * row's bold and centring live here, not in the cell's own properties.
      */
-    readonly revisions?: readonly RevisionAttribution[];
-}
-interface InlineDrawingLayoutContext {
-    readonly ownerPartName: string;
-    /** Precomputed run-level atom id (`w:drawing` or MC wrapper) → projection. */
-    readonly projectionForAtom?: (atomNodeId: string) => DrawingProjection | null;
-    readonly project: (drawing: OoxmlDrawingNode) => DrawingProjection | null;
-    readonly resourceOf: (projection: DrawingProjection) => ImageResourceState;
+    readonly styleFormatting: TableCellStyleFormatting;
+    /** Block children in reading order, with content-control wrappers flattened. */
+    readonly blocks: readonly OoxmlElement[];
 }
-/** Named fallback when a positioning frame cannot be resolved (OpenSpec 4.6). */
-type AnchoredDrawingLayoutFallback = 'unresolvable-frame' | 'page-defer-exhausted';
-interface AnchoredDrawingRecord extends Omit<InlineDrawingRecord, 'kind' | 'baselineOffset' | 'advanceStart' | 'advanceEnd' | 'distL' | 'distR' | 'distT' | 'distB'> {
-    readonly kind: 'anchoredDrawing';
-    readonly anchorParagraphId: string;
-    readonly horizontalFrame: DrawingHorizontalReferenceFrame;
-    readonly verticalFrame: DrawingVerticalReferenceFrame;
-    readonly horizontalFrameOrigin: number;
-    readonly verticalFrameOrigin: number;
-    readonly behindDocument: boolean;
-    readonly allowOverlap: boolean;
-    readonly layoutInCell: boolean;
-    readonly relativeHeight: number;
-    readonly wrap: Exclude<ImageWrapTarget, 'inline'>;
-    readonly layoutFallback?: AnchoredDrawingLayoutFallback;
-    /** Canonical document traversal index within the owner story part. */
-    readonly sourceOrder?: number;
+/** One row in the resolved structure: its cells, its height rule, and any row-level revision. */
+interface SemanticTableRow {
+    readonly id: string;
+    /** Pending Word row insertion/deletion authored in `w:trPr`. */
+    readonly revisionKind?: 'insert' | 'delete';
     /**
-     * Laid-out textbox story for a `wps:txbx` drawing; paint renders it clipped inside the
-     * extent instead of a placeholder. Absent when the drawing carries no story or the host
-     * did not thread story layout (the record then degrades to the placeholder path).
+     * The `w:trPr/w:ins|w:del` attribution, carried with the kind so a painted row can say
+     * WHOSE pending decision it is — the review model addresses the decision by exactly this
+     * `(id, author, date)` triple, and a surface with only the kind could highlight the row
+     * but never open its card.
      */
-    readonly textboxStory?: TextboxStoryLayout;
-}
-
-/**
- * One parsed `HYPERLINK` instruction: the raw, unsanitized pieces.
- *
- * `target` and `anchor` are verbatim from the instruction — the projector at the trust
- * boundary decides what, if anything, they become in a DOM sink.
- */
-interface HyperlinkFieldSpec {
-    /** The target as authored (first quoted or bare non-switch token), or null. */
-    readonly target: string | null;
-    /** `\l` — a bookmark name in this document, or null. */
-    readonly anchor: string | null;
-    /** `\o` — the hover tooltip, or null. */
-    readonly tooltip: string | null;
+    readonly revisionId?: string;
+    readonly revisionAuthor?: string;
+    readonly revisionDate?: string;
+    /** `w:trPr/w:tblHeader` — the row repeats atop each page the table continues onto. */
+    readonly isHeader: boolean;
+    /**
+     * `w:trPr/w:cantSplit` — the row must stay on one page. When it cannot fit a fresh page,
+     * layout fails closed rather than fragmenting or overflowing the content box.
+     */
+    readonly cantSplit: boolean;
+    /** `w:trPr/w:trHeight` — auto / atLeast floor / exact (clipped) row height. */
+    readonly height: TableRowHeight;
+    readonly cells: readonly SemanticTableCell[];
 }
-
 /**
- * What a piece says about the FIELD result it came from, for Word's shading.
+ * A table resolved into a rectangular grid: column widths, rows, and the widths it asked for.
  *
- * Carried from layout rather than decided at paint time because only the walk knows an atom was
- * a field at all — by paint the result is just text. Whether the shading is actually drawn is a
- * view decision made downstream, so this states the fact and nothing about the appearance.
+ * The grid is normalized here so layout never has to reconcile `w:gridCol` against actual cell
+ * spans — vertical merges and column spans are already accounted for.
  */
-interface FieldAtomMarker {
+interface SemanticTableStructure {
+    readonly columnWidthsPt: readonly number[];
+    readonly rows: readonly SemanticTableRow[];
+    /** Verified pre-2013 content-aligned full-width inline table; derived, never serialized. */
+    readonly legacyContentAlignment?: true;
+    /** `w:tblPr/w:tblW` — the width the table asked for. */
+    readonly tableWidth: PreferredWidth;
     /**
-     * A legacy form field: `w:fldChar/w:ffData` (FORMTEXT, FORMCHECKBOX, FORMDROPDOWN).
-     *
-     * Word shades these on a different rule from ordinary fields — always, unless the document
-     * turns it off — because they mark the blanks somebody is meant to fill in.
+     * `w:tblInd` (17.4.50) in points — "this indentation should shift the table into the text
+     * margin by the specified amount". Applies to a left-aligned table; `w:jc` decides the
+     * placement outright for the other two.
      */
-    readonly formField: boolean;
+    readonly indentPt: number;
+    /** `w:tblPr/w:jc` (17.4.29) — where the table sits in the text column. */
+    readonly alignment: TableAlignment;
     /**
-     * A BODY PAGE / NUMPAGES / SECTIONPAGES atom whose value depends on pagination.
-     *
-     * The paragraph walk cannot know which page the field lands on — layout runs before the page
-     * count — so it paints a placeholder and records the field's kind here. Document finalize
-     * (`substituteBodyPageFields`) reads this marker and substitutes the real value per page.
-     * Absent in headers/footers, which evaluate live through their own per-page projector.
+     * `w:tblPr/w:tblpPr` (17.4.57) — present when the table is positioned against an anchor
+     * box. Placement then comes from {@link tableFloatOriginX} rather than `w:jc`/`w:tblInd`.
      */
-    readonly pageField?: {
-        readonly kind: AllowlistedPageField;
-        /** The field's `\#` numeric picture, applied when finalize substitutes the value. */
-        readonly picture?: string;
-    };
+    readonly float?: TableFloatPosition;
     /**
-     * A BODY `PAGEREF` atom whose value is the page number its bookmark target lands on.
-     *
-     * Deferred exactly like {@link pageField}: the paragraph walk paints the field's cached
-     * result (or the placeholder digit when the file cached none) and records the resolved
-     * target here; document finalize substitutes the number of the page hosting the target's
-     * first fragment, gated per field on the calibration verdict.
+     * `w:tblCellSpacing` (17.4.45) in points: the gap between adjacent cell edges. Applied as
+     * a half-gap inset on each side of every cell, so cells separate visually without the grid
+     * itself moving. Word ALSO grows the table's overall width by the spacing it adds around
+     * the outside; that part is not modelled, so a spaced table is laid out on the same grid
+     * its file states rather than a wider one.
      */
-    readonly pageRef?: PageRefFieldProjection;
-}
-/** A half-open model-offset range, in the paragraph's own UTF-16 offset space. */
-interface ModelRange {
-    readonly start: number;
-    readonly end: number;
+    readonly cellSpacingPt: number;
+    /**
+     * `w:tblPr/w:tblLayout/@w:type="fixed"` (17.4.52 — 17.4.53 is the `w:tblPrEx` exception
+     * variant, not this element). Fixed layout takes the grid as final;
+     * anything else is autofit, which in Word never renders wider than the text column.
+     */
+    readonly layoutFixed: boolean;
+    /** Table-level `tblBorders` (three-state, including insideH/insideV). */
+    readonly tableBorders: TableBorderBox;
+    /** Table-level `tblCellMar` defaults (per-side, Word's own default when a side is omitted). */
+    readonly defaultMargins: CellMarginsPt;
 }
 /**
- * How layout turns a typed `w:hyperlink` node into the sanitized record spans carry.
- *
- * Injected rather than computed here because resolving `r:id` needs the PACKAGE's
- * relationships and this module only ever sees one part's tree. `null` means the caller
- * declined to project — the runs still measure and paint, they simply carry no link, which is
- * the right degradation: text is never lost for want of a target.
- */
-type HyperlinkProjector = (link: OoxmlNode) => SpanLinkRecord | null;
-/**
- * How layout turns a parsed HYPERLINK field instruction into the sanitized record spans carry.
- *
- * Injected for the same reason as {@link HyperlinkProjector}: the spec's raw target must cross
- * the surface's ONE href trust boundary, and layout owns no sanitization policy. `null` means
- * no link — the cached result still paints as plain text, which is the right degradation.
+ * Read one typed table node into a bounded structure, or null when the node is not a
+ * typed table or sits beyond the nesting ceiling.
  */
-type FieldLinkProjector = (spec: HyperlinkFieldSpec) => SpanLinkRecord | null;
+declare function readTableStructure(table: OoxmlNode, contentWidthPt: number, depth: number, styleCascade?: StyleCascadeTable, 
+/** Which revisions the view resolves away; only the proposed result performs the join. */
+displayMode?: RevisionDisplayMode, authorFilter?: RevisionAuthorFilter, compatibilityMode?: number): SemanticTableStructure | null;
 
 interface EquationGeometryBase {
     readonly box: LayoutBox;
@@ -2384,6 +2646,21 @@ interface ParagraphFragmentRecord {
     readonly paragraphId: string;
     /** 0 for the first fragment of the paragraph, 1 for its continuation, and so on. */
     readonly fragmentIndex: number;
+    /** A fixed text frame clips its painted ink to this fragment's box; source ranges remain intact. */
+    readonly clipToBox?: true;
+    /** A positioned text frame retains its source identity without consuming body flow height. */
+    readonly outOfFlow?: true;
+    /** Placement and wrapping of one authored text-frame group, in page-content coordinates. */
+    readonly positionedFrame?: {
+        readonly anchorId: string;
+        readonly columnIndex: number;
+        readonly groupId: string;
+        readonly sourceOrder: number;
+        readonly wrap: 'around' | 'none' | 'notBeside';
+        readonly hSpace: number;
+        readonly vSpace: number;
+        readonly box: LayoutBox;
+    };
     readonly range: SourceRange;
     readonly props: readonly OoxmlProperty[];
     /** Resolved paragraph style after the style/default cascade, or null when none applies. */
@@ -2543,6 +2820,13 @@ interface ListMarkerRecord {
  */
 interface TableFragmentRecord {
     readonly kind: 'table';
+    /** Source and positioning inputs needed to reconstruct wrapping on an incremental pass. */
+    readonly floatingWrap?: {
+        readonly anchorId: string;
+        readonly columnIndex: number;
+        readonly float: TableFloatPosition;
+        readonly sourceOrder: number;
+    };
     readonly id: string;
     /** Canonical node id of the `w:tbl`. */
     readonly tableId: string;
@@ -2914,4 +3198,4 @@ interface TextMeasurer {
     };
 }
 
-export { type AnchoredDrawingLayoutFallback as $, type AnchoredDrawingRecord as A, type BlockFragmentRecord as B, type ContentControlBoundaryRecord as C, type DrawingPoint as D, type FixedPoint as E, type FontResourceSnapshot as F, type SourceRange as G, type HeaderFooterStoryRecord as H, type InlineDrawingRecord as I, type HyperlinkProjector as J, type InlineDrawingLayoutContext as K, type LineRecord as L, type ModelRange as M, type NormalizationPolicy as N, type FieldLinkProjector as O, type PageGeometry as P, type StoryPageFieldNeeds as Q, type ResolvedRunStyle as R, type SemanticLayout as S, type TextMeasurer as T, type RefFieldContext as U, type VersionedShapingLibrary as V, type HyperlinkFieldSpec as W, type SpanLinkRecord as X, type ResolvedListItem as Y, AUTO_PARAGRAPH_SPACING_PT as Z, type AbstractNumDefinition as _, type StyleSpanRecord as a, type ParagraphLayoutInputs as a$, type BidiEmbeddingLevels as a0, type BorderGridGeometry as a1, type CascadedParagraphFormatting as a2, type ContentControlGeometryFragment as a3, type ContentControlLevel as a4, type ContentControlMappedType as a5, DEFAULT_PAGE_GEOMETRY as a6, DEFAULT_RUN_STYLE as a7, DEFAULT_TAB_INTERVAL_PT as a8, DEFAULT_TAB_INTERVAL_TWIPS as a9, type LevelOverride as aA, type LineSpacingRule as aB, type ListMarkerAlign as aC, type ListMarkerRecord as aD, type ListSuffix as aE, MAX_BORDER_SPACE_PT as aF, MAX_BORDER_WIDTH_PT as aG, MAX_LVL_OVERRIDES as aH, MAX_NUMBERING_DEFINITIONS as aI, MAX_PARAGRAPH_SPACING_PT as aJ, MAX_STYLE_BASED_ON_DEPTH as aK, MAX_STYLE_DEFINITIONS as aL, MAX_TABLE_BORDER_STROKES as aM, MAX_TAB_POSITION_TWIPS as aN, MAX_TAB_STOPS as aO, type NumDefinition as aP, type NumberingLevelIndent as aQ, PARAGRAPH_BORDER_SIDES as aR, type PageRefCalibrationCell as aS, type PageRefFieldProjection as aT, type ParagraphAutoSpacingContext as aU, type ParagraphBorderEdge as aV, type ParagraphBorderSide as aW, type ParagraphBorderStrokeRecord as aX, type ParagraphBorders as aY, type ParagraphBottomBorderRecord as aZ, type ParagraphIndent as a_, type DeclaredFontSubstitution as aa, type DrawingClipFallback as ab, type DrawingGeometry as ac, EMPTY_NUMBERING_INDEX as ad, EMPTY_TAB_STOPS as ae, type EquationFractionGeometry as af, type EquationGeometry as ag, type EquationNaryGeometry as ah, type EquationRadicalGeometry as ai, type EquationRowGeometry as aj, type EquationScriptGeometry as ak, type EquationSpanRecord as al, type EquationTextGeometry as am, type FieldAtomMarker as an, type FontFingerprintInputs as ao, FontResolutionError as ap, type FontResolutionErrorCode as aq, type FontResourceDefinition as ar, type FontResourceInstrumentation as as, type FontResourceSnapshotOptions as at, type FontSlot as au, type FontValidationResult as av, type GlyphOutline as aw, HARD_MAX_AGGREGATE_FONT_BYTES as ax, HARD_MAX_FONT_BYTES as ay, HARD_MAX_FONT_SOURCES as az, type TableRowFragmentRecord as b, isValidStyleId as b$, type ParagraphLineSpacing as b0, type ParagraphSpacing as b1, type RefFieldSpec as b2, type RefNoteParts as b3, type ResolvedCellBorders as b4, type ResolvedTabStops as b5, type ResolvedTableBorderEdge as b6, type ResolvedTableBorderEdgeSegment as b7, type ResolvedUnderline as b8, SINGLE_LINE_SPACING as b9, type TextDirection as bA, type TextboxStoryFallbackReason as bB, type TextboxStoryLayout as bC, UnsupportedScriptError as bD, type VerticalAlign as bE, appliedSpaceBefore as bF, applyLineSpacing as bG, baselineShiftPtOf as bH, borderExtentPt as bI, borderWeight as bJ, bottomBorderExtentPt as bK, boundedStructuralFontValidator as bL, buildNumberingIndex as bM, buildStyleCascadeTable as bN, cascadeParagraphFormatting as bO, cascadeRunProperties as bP, cascadedBottomBorder as bQ, cascadedParagraphBorders as bR, cascadedTabStops as bS, collapsedSpaceBefore as bT, createFontResourceSnapshot as bU, createShapedRun as bV, createShapingEnvironment as bW, defaultTabIntervalFromSettings as bX, displayText as bY, fixedPoint as bZ, fontRequestKey as b_, type ScriptItem as ba, type SemanticArtifactRootStoryKind as bb, type SemanticArtifactStoryKind as bc, type SemanticCommentArtifactRecord as bd, type SemanticReviewArtifactOccurrence as be, type SemanticReviewArtifactOccurrenceGeometry as bf, type SemanticReviewArtifactPosition as bg, type SemanticReviewArtifactSource as bh, type SemanticTrackedChangeArtifactRecord as bi, type ShapeInput as bj, type ShapedCluster as bk, type ShapedFontSpan as bl, type ShapedGlyph as bm, type ShapedRunComparatorInputs as bn, type ShapedVerticalMetrics as bo, type ShapingEnvironment as bp, type ShapingEnvironmentFingerprintInputs as bq, type StyleDefinition as br, TAB_LEADER_GLYPH as bs, type TabAlignment as bt, type TabDestination as bu, type TabLeader as bv, type TabStop as bw, type TableBorderSideName as bx, type TableBorderStrokeRecord as by, type TableFragmentRecord as bz, type TableCellFragmentRecord as c, itemizeScriptFontSlots as c0, layoutEquation as c1, listMarkerBox as c2, measureDisplayText as c3, mergeListIndent as c4, nextTabDestination as c5, paragraphBorderExtentPt as c6, paragraphBorderStrokeWidthPt as c7, paragraphBorders as c8, paragraphBordersFingerprint as c9, withNumberingStyleLinks as cA, withResolvedListItems as cB, paragraphBreaksBefore as ca, paragraphContextualSpacing as cb, paragraphLineSpacing as cc, paragraphSpacing as cd, paragraphTabStops as ce, parseRefInstruction as cf, readBorderSide as cg, readCellBorders as ch, readNumPr as ci, readTableBorders as cj, resolveBorderConflict as ck, resolveNumberingLevel as cl, resolveParagraphLayoutInputs as cm, resolveRunStyle as cn, resolveStoryListItems as co, resolveStoryRefFields as cp, resolveTableCellBorderGrid as cq, runStylesEqual as cr, shapedRunComparatorInputs as cs, shapingEnvironmentFingerprint as ct, shapingEnvironmentFingerprintInputs as cu, styleForFontSlot as cv, tabAdvanceWidth as cw, tabStopsFingerprint as cx, walkStoryParagraphs as cy, withDefaultTabInterval as cz, type ShapingEnvironmentInput as d, type TextShaper as e, type ResolvedFont as f, type FixedPointRoundingMode as g, type FontRequest as h, type SemanticReviewArtifactRecord as i, type FontSubstitution as j, type ShapedRun as k, type NumberingLevel as l, type NumberingIndex as m, type LayoutBox as n, type DrawingInsets as o, type TableBorderSide as p, type CellBorderBox as q, type TableCellStyleFormatting as r, type TableBorderBox as s, type StyleCascadeTable as t, type PageRecord as u, type ParagraphFragmentRecord as v, type NoteAreaRecord as w, type NoteStoryRecord as x, type ContentControlLock as y, type FontByteValidator as z };
+export { type BidiEmbeddingLevels as $, type AnchoredDrawingRecord as A, type BlockFragmentRecord as B, type ContentControlBoundaryRecord as C, type DrawingPoint as D, type HyperlinkProjector as E, type FontResourceSnapshot as F, type InlineDrawingLayoutContext as G, type HeaderFooterStoryRecord as H, type InlineDrawingRecord as I, type FieldLinkProjector as J, type StoryPageFieldNeeds as K, type LineRecord as L, type ModelRange as M, type NormalizationPolicy as N, type RefFieldContext as O, type PageGeometry as P, type HyperlinkFieldSpec as Q, type ResolvedRunStyle as R, type SemanticLayout as S, type TextMeasurer as T, type SpanLinkRecord as U, type VersionedShapingLibrary as V, type ResolvedListItem as W, AUTO_PARAGRAPH_SPACING_PT as X, AUTO_PREFERRED_WIDTH as Y, type AbstractNumDefinition as Z, type AnchoredDrawingLayoutFallback as _, type StyleSpanRecord as a, type ParagraphAutoSpacingContext as a$, type BorderGridGeometry as a0, CELL_PAD as a1, type CascadedParagraphFormatting as a2, type CellBorderBox as a3, type CellMarginsPt as a4, type CellVerticalAlign as a5, type CjkTypographySettings as a6, type ContentControlGeometryFragment as a7, type ContentControlLevel as a8, type ContentControlMappedType as a9, type FontValidationResult as aA, type GlyphOutline as aB, HARD_MAX_AGGREGATE_FONT_BYTES as aC, HARD_MAX_FONT_BYTES as aD, HARD_MAX_FONT_SOURCES as aE, type LevelOverride as aF, type LineSpacingRule as aG, type ListMarkerAlign as aH, type ListMarkerRecord as aI, type ListSuffix as aJ, MAX_BORDER_SPACE_PT as aK, MAX_BORDER_WIDTH_PT as aL, MAX_LVL_OVERRIDES as aM, MAX_NUMBERING_DEFINITIONS as aN, MAX_PARAGRAPH_SPACING_PT as aO, MAX_STYLE_BASED_ON_DEPTH as aP, MAX_STYLE_DEFINITIONS as aQ, MAX_TABLE_BORDER_STROKES as aR, MAX_TABLE_NESTING as aS, MAX_TABLE_ROW_HEIGHT_PT as aT, MAX_TAB_POSITION_TWIPS as aU, MAX_TAB_STOPS as aV, type NumDefinition as aW, type NumberingLevelIndent as aX, PARAGRAPH_BORDER_SIDES as aY, type PageRefCalibrationCell as aZ, type PageRefFieldProjection as a_, DEFAULT_CELL_MARGINS as aa, DEFAULT_PAGE_GEOMETRY as ab, DEFAULT_RUN_STYLE as ac, DEFAULT_TAB_INTERVAL_PT as ad, DEFAULT_TAB_INTERVAL_TWIPS as ae, type DeclaredFontSubstitution as af, type DrawingClipFallback as ag, type DrawingGeometry as ah, EMPTY_NUMBERING_INDEX as ai, EMPTY_TAB_STOPS as aj, type EquationFractionGeometry as ak, type EquationGeometry as al, type EquationNaryGeometry as am, type EquationRadicalGeometry as an, type EquationRowGeometry as ao, type EquationScriptGeometry as ap, type EquationSpanRecord as aq, type EquationTextGeometry as ar, type FieldAtomMarker as as, type FontFingerprintInputs as at, FontResolutionError as au, type FontResolutionErrorCode as av, type FontResourceDefinition as aw, type FontResourceInstrumentation as ax, type FontResourceSnapshotOptions as ay, type FontSlot as az, type TableRowFragmentRecord as b, boundedStructuralFontValidator as b$, type ParagraphBorderEdge as b0, type ParagraphBorderSide as b1, type ParagraphBorderStrokeRecord as b2, type ParagraphBorders as b3, type ParagraphBottomBorderRecord as b4, type ParagraphIndent as b5, type ParagraphLayoutInputs as b6, type ParagraphLineSpacing as b7, type ParagraphSpacing as b8, type PreferredWidth as b9, type ShapingEnvironment as bA, type ShapingEnvironmentFingerprintInputs as bB, type StyleDefinition as bC, TAB_LEADER_GLYPH as bD, type TabAlignment as bE, type TabDestination as bF, type TabLeader as bG, type TabStop as bH, type TableAlignment as bI, type TableBorderBox as bJ, type TableBorderSideName as bK, type TableBorderStrokeRecord as bL, type TableCellStyleFormatting as bM, type TableFragmentRecord as bN, type TableRowHeight as bO, type TableRowHeightRule as bP, type TextDirection as bQ, type TextboxStoryFallbackReason as bR, type TextboxStoryLayout as bS, UnsupportedScriptError as bT, type VerticalAlign as bU, appliedSpaceBefore as bV, applyLineSpacing as bW, baselineShiftPtOf as bX, borderExtentPt as bY, borderWeight as bZ, bottomBorderExtentPt as b_, type PreferredWidthType as ba, type RefFieldSpec as bb, type RefNoteParts as bc, type ResolvedCellBorders as bd, type ResolvedTabStops as be, type ResolvedTableBorderEdge as bf, type ResolvedTableBorderEdgeSegment as bg, type ResolvedUnderline as bh, SINGLE_LINE_SPACING as bi, type ScriptItem as bj, type SemanticArtifactRootStoryKind as bk, type SemanticArtifactStoryKind as bl, type SemanticCommentArtifactRecord as bm, type SemanticReviewArtifactOccurrence as bn, type SemanticReviewArtifactOccurrenceGeometry as bo, type SemanticReviewArtifactPosition as bp, type SemanticReviewArtifactSource as bq, type SemanticTableCell as br, type SemanticTableRow as bs, type SemanticTrackedChangeArtifactRecord as bt, type ShapeInput as bu, type ShapedCluster as bv, type ShapedFontSpan as bw, type ShapedGlyph as bx, type ShapedRunComparatorInputs as by, type ShapedVerticalMetrics as bz, type TableCellFragmentRecord as c, buildNumberingIndex as c0, buildStyleCascadeTable as c1, cascadeParagraphFormatting as c2, cascadeRunProperties as c3, cascadedBottomBorder as c4, cascadedParagraphBorders as c5, cascadedTabStops as c6, collapsedSpaceBefore as c7, createFontResourceSnapshot as c8, createShapedRun as c9, readTableStructure as cA, resolveBorderConflict as cB, resolveNumberingLevel as cC, resolveParagraphLayoutInputs as cD, resolveRunStyle as cE, resolveStoryListItems as cF, resolveStoryRefFields as cG, resolveTableCellBorderGrid as cH, runStylesEqual as cI, shapedRunComparatorInputs as cJ, shapingEnvironmentFingerprint as cK, shapingEnvironmentFingerprintInputs as cL, styleForFontSlot as cM, tabAdvanceWidth as cN, tabStopsFingerprint as cO, walkStoryParagraphs as cP, withDefaultTabInterval as cQ, withNumberingStyleLinks as cR, withResolvedListItems as cS, createShapingEnvironment as ca, defaultTabIntervalFromSettings as cb, displayText as cc, fixedPoint as cd, fontRequestKey as ce, isValidStyleId as cf, itemizeScriptFontSlots as cg, layoutEquation as ch, listMarkerBox as ci, measureDisplayText as cj, mergeListIndent as ck, nextTabDestination as cl, paragraphBorderExtentPt as cm, paragraphBorderStrokeWidthPt as cn, paragraphBorders as co, paragraphBordersFingerprint as cp, paragraphBreaksBefore as cq, paragraphContextualSpacing as cr, paragraphLineSpacing as cs, paragraphSpacing as ct, paragraphTabStops as cu, parseRefInstruction as cv, readBorderSide as cw, readCellBorders as cx, readNumPr as cy, readTableBorders as cz, type ShapingEnvironmentInput as d, type TextShaper as e, type ResolvedFont as f, type FixedPointRoundingMode as g, type FontRequest as h, type SemanticReviewArtifactRecord as i, type FontSubstitution as j, type ShapedRun as k, type NumberingLevel as l, type NumberingIndex as m, type ParagraphFragmentRecord as n, type LayoutBox as o, type DrawingInsets as p, type TableBorderSide as q, type PageRecord as r, type SemanticTableStructure as s, type NoteAreaRecord as t, type NoteStoryRecord as u, type ContentControlLock as v, type FontByteValidator as w, type FixedPoint as x, type SourceRange as y, type StyleCascadeTable as z };