@docx-editor.dev/core 2.14.1 → 2.15.0

package/dist/{semantic-records-BpozY7-j.d.cts → semantic-records-EIdwId-a.d.ts}

@@ -1,6 +1,6 @@
-import { a as OoxmlNode, s as OoxmlProperty, g as OoxmlElement, O as OoxmlPart, x as ImageResourceState, U as DrawingAccessibility, S as SourceCrop, W as DrawingTransform, X as VectorShapeProjection, z as DrawingHorizontalReferenceFrame, A as DrawingVerticalReferenceFrame, u as ImageWrapTarget, Y as DrawingProjection, Z as OoxmlDrawingNode, _ as TableBorderStyle } from './tree-op-types-BUulYD5y.cjs';
-import { b as RevisionAttribution } from './revision-projection-DXbrfNGD.cjs';
-import { O as OmmlEquationProjection } from './omml-equation-DB8d-jCq.cjs';
+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';
 
 /**
  * Whether a paragraph must start a new page (`w:pageBreakBefore`).
@@ -1169,38 +1169,26 @@ interface DrawingGeometry {
 /** Horizontal alignment of a paragraph (`w:jc`, ECMA-376 §17.3.1.13). */
 type Alignment = 'left' | 'center' | 'right' | 'both';
 
-/** Soft ceiling on `basedOn` chain length — enough for real templates, refuses hostile graphs. */
-declare const MAX_STYLE_BASED_ON_DEPTH = 32;
-/** Soft ceiling on style definitions read from one styles part. */
-declare const MAX_STYLE_DEFINITIONS = 4096;
-/** One `w:style` as the cascade reads it: its properties, and the style it is based on. */
 interface StyleDefinition {
     readonly styleId: string;
     readonly type: string;
     readonly basedOn: string | null;
-    /**
-     * `w:next` — the style Word gives the paragraph that FOLLOWS one in this style.
-     *
-     * Nothing in layout reads it: it is a rule about authoring, not about painting. It is
-     * read here because this is the one place `styles.xml` is parsed, and a second reader
-     * would be a second answer to what a style id means.
-     */
+    /** `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[];
-    /** The style's `w:pPr` node, when present — needed for nested `w:pBdr`. */
     readonly paragraphPropertiesNode: OoxmlElement | undefined;
-    /** The style's `w:tblPr`, for a `w:type="table"` style. */
     readonly tablePropertiesNode: OoxmlElement | undefined;
-    /**
-     * `w:tblStylePr` conditional formats by `w:type` (`firstRow`, `band1Horz`, …).
-     *
-     * Word puts a table's real appearance here: `Table Grid` carries its grid in the style's
-     * `w:tblBorders`, and the banded/​header looks live in these. A document states only
-     * `<w:tblStyle w:val="TableGrid"/>`.
-     */
+    readonly 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 whole styles part, indexed and ready to resolve against.
  *
@@ -1274,8 +1262,6 @@ interface CascadedParagraphFormatting {
      */
     readonly styleId: string | null;
 }
-/** Accepted style ids only — over-long, control-bearing, or dangerous keys are dropped. */
-declare function isValidStyleId(raw: string | undefined): raw is string;
 /**
  * What a table style contributes to the paragraphs of ONE cell: the style's whole-table
  * `w:pPr`/`w:rPr` followed by every `w:tblStylePr` the cell is under (17.7.6.6), weakest
@@ -1351,6 +1337,8 @@ interface ParagraphLayoutInputs {
     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.
@@ -1394,6 +1382,184 @@ interface ParagraphLayoutInputs {
  */
 declare function resolveParagraphLayoutInputs(paragraph: OoxmlElement, contentWidth: number, styleCascade: StyleCascadeTable | undefined, listItem?: ResolvedListItem, tableCellStyle?: TableCellStyleFormatting, inTableCell?: boolean): ParagraphLayoutInputs;
 
+/** Test-only mutable counters; omitted by production call sites. Not package-public. */
+interface TableBorderGridResolveWork {
+    /** Sparse intervals emitted (not dense column slots). */
+    ownershipSlotsWritten: number;
+    columnLookups: number;
+}
+/** Shared remaining interval budget for nested table finalization in one layout. */
+interface TableBorderOwnershipBudget {
+    intervalsRemaining: number;
+}
+
+/** Which physical edge of a box a border sits on. */
+type TableBorderSideName = 'top' | 'right' | 'bottom' | 'left';
+/**
+ * One border edge in one of three states.
+ *
+ * `omitted` and `none` are NOT the same: an omitted edge inherits from the table style or the
+ * neighbouring cell, while an explicit `none` wins the conflict and draws nothing. Collapsing
+ * them would let a style's border reappear where the author removed it.
+ */
+type TableBorderSide = {
+    readonly state: 'omitted';
+} | {
+    readonly state: 'none';
+} | {
+    readonly state: 'edge';
+    readonly style: TableBorderStyle;
+    /** Validated RRGGBB, or null for auto/missing (paint defaults to black). */
+    readonly color: string | null;
+    /** Thickness in points (`w:sz` is eighths of a point). */
+    readonly widthPt: number;
+};
+/** A table's six authored border edges: four outer, plus the two interior intervals. */
+interface TableBorderBox {
+    readonly top: TableBorderSide;
+    readonly left: TableBorderSide;
+    readonly bottom: TableBorderSide;
+    readonly right: TableBorderSide;
+    readonly insideH: TableBorderSide;
+    readonly insideV: TableBorderSide;
+}
+/** The four resolved edges of one cell, after conflict resolution against its neighbours. */
+interface CellBorderBox {
+    readonly top: TableBorderSide;
+    readonly left: TableBorderSide;
+    readonly bottom: TableBorderSide;
+    readonly right: TableBorderSide;
+}
+/** Final edge winner; absent means the side/interval is not drawn. */
+interface ResolvedTableBorderEdge {
+    readonly style: TableBorderStyle;
+    readonly color: string | null;
+    readonly widthPt: number;
+}
+/**
+ * Conflict winner over one grid interval of a cell side.
+ *
+ * `gridStart`/`gridEnd` are absolute grid column indices for horizontal sides and absolute
+ * row indices for vertical sides (half-open). `startPt`/`endPt` are cell-local along-axis
+ * positions in layout points.
+ */
+interface ResolvedTableBorderEdgeSegment {
+    readonly side: TableBorderSideName;
+    readonly gridStart: number;
+    readonly gridEnd: number;
+    readonly startPt: number;
+    readonly endPt: number;
+    readonly edge: ResolvedTableBorderEdge;
+}
+/**
+ * One published stroke rectangle in cell-local layout points.
+ *
+ * Paint multiplies x/y/width/height by scale and draws — no metrics, gaps, or corner math.
+ */
+interface TableBorderStrokeRecord {
+    readonly side: TableBorderSideName;
+    readonly role: 'outer' | 'inner' | 'middle' | 'edge';
+    readonly color: string | null;
+    /** CSS keyword for this stroke (compound strokes are always solid). */
+    readonly cssStyle: 'solid' | 'dashed' | 'dotted';
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Layout-owned cell borders after conflict resolution and compound expansion.
+ *
+ * Convenience `top`/`left`/`bottom`/`right` are set when that side has a single uniform
+ * full-span winner (existing consumers / CSS simple edges). Multi-interval winners live
+ * only on `edgeSegments`. Compound geometry is always on `strokes`.
+ */
+interface ResolvedCellBorders {
+    readonly top?: ResolvedTableBorderEdge;
+    readonly left?: ResolvedTableBorderEdge;
+    readonly bottom?: ResolvedTableBorderEdge;
+    readonly right?: ResolvedTableBorderEdge;
+    readonly edgeSegments?: readonly ResolvedTableBorderEdgeSegment[];
+    readonly strokes?: readonly TableBorderStrokeRecord[];
+}
+/** Soft cap on published stroke rectangles per cell (security / pathological spans). */
+declare const MAX_TABLE_BORDER_STROKES = 256;
+/** Read one OOXML border child into the three-state model. */
+declare function readBorderSide(node: OoxmlElement | undefined): TableBorderSide;
+/**
+ * Read a table's `w:tblBorders`, dropping or clamping hostile values.
+ *
+ * Widths and colours come from a file: an out-of-range `w:sz` becomes a layout dimension, so it is
+ * bounded here rather than downstream.
+ */
+declare function readTableBorders(tblPr: OoxmlElement | undefined): TableBorderBox;
+/** Read one cell's `w:tcBorders`, under the same bounds {@link readTableBorders} applies. */
+declare function readCellBorders(tcPr: OoxmlElement | undefined): CellBorderBox;
+/**
+ * Conflict weight: the authored width in eighths of a point, and nothing else.
+ *
+ * Word-matching, not conformance — §17.4.39 (`w:tblBorders`) and §17.4.66 (`w:tcBorders`)
+ * describe the elements and specify no conflict algorithm. Word picks the heavier RULE, so
+ * a 6pt dashed rule beats a hairline single. Folding the style rank into the weight (an
+ * `sz × border-number` product) made a 0.5pt double outrank a 1pt single and made every
+ * dashed or dotted rule weigh 1 regardless of `w:sz`, which erased its width entirely.
+ */
+declare function borderWeight(side: TableBorderSide): number;
+/**
+ * Pick the winner between two candidates on a shared grid line (zero cell spacing).
+ *
+ * `none` loses to any edge; two `none`/omitted yield omitted (no paint). Width decides;
+ * equal widths rank by style, then prefer the darker color, then `preferFirst`
+ * (reading-order / first candidate).
+ */
+declare function resolveBorderConflict(first: TableBorderSide, second: TableBorderSide, preferFirst?: boolean): TableBorderSide;
+interface BorderGridCell {
+    readonly gridColumn: number;
+    readonly gridSpan: number;
+    readonly vMergeContinue: boolean;
+    readonly borders: CellBorderBox;
+    /** Set on restart cells that visually span into later rows. */
+    readonly mergeRowSpan?: number;
+}
+/**
+ * The absolute grid a table's borders are drawn on: column widths, and per-row tops and heights.
+ *
+ * Shared by every edge so adjacent cells resolve to the SAME line, rather than each computing its
+ * own and leaving a hairline gap between them.
+ */
+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).
+     */
+    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;
+
 /**
  * A paragraph's list membership fully resolved: definition, level, marker text and geometry.
  *
@@ -1407,6 +1573,8 @@ interface ResolvedListItem {
     /** `w:numFmt` of the resolved level — `bullet` or a numbering format. */
     readonly numFmt: string;
     readonly markerText: string;
+    /** Counter value at this item's own level; absent for bullets. */
+    readonly ordinal?: number;
     readonly markerAlign: ListMarkerAlign;
     readonly suffix: ListSuffix;
     /** Effective indent after merging level + paragraph indents, in points. */
@@ -1797,184 +1965,6 @@ type HyperlinkProjector = (link: OoxmlNode) => SpanLinkRecord | null;
  */
 type FieldLinkProjector = (spec: HyperlinkFieldSpec) => SpanLinkRecord | null;
 
-/** Test-only mutable counters; omitted by production call sites. Not package-public. */
-interface TableBorderGridResolveWork {
-    /** Sparse intervals emitted (not dense column slots). */
-    ownershipSlotsWritten: number;
-    columnLookups: number;
-}
-/** Shared remaining interval budget for nested table finalization in one layout. */
-interface TableBorderOwnershipBudget {
-    intervalsRemaining: number;
-}
-
-/** Which physical edge of a box a border sits on. */
-type TableBorderSideName = 'top' | 'right' | 'bottom' | 'left';
-/**
- * One border edge in one of three states.
- *
- * `omitted` and `none` are NOT the same: an omitted edge inherits from the table style or the
- * neighbouring cell, while an explicit `none` wins the conflict and draws nothing. Collapsing
- * them would let a style's border reappear where the author removed it.
- */
-type TableBorderSide = {
-    readonly state: 'omitted';
-} | {
-    readonly state: 'none';
-} | {
-    readonly state: 'edge';
-    readonly style: TableBorderStyle;
-    /** Validated RRGGBB, or null for auto/missing (paint defaults to black). */
-    readonly color: string | null;
-    /** Thickness in points (`w:sz` is eighths of a point). */
-    readonly widthPt: number;
-};
-/** A table's six authored border edges: four outer, plus the two interior intervals. */
-interface TableBorderBox {
-    readonly top: TableBorderSide;
-    readonly left: TableBorderSide;
-    readonly bottom: TableBorderSide;
-    readonly right: TableBorderSide;
-    readonly insideH: TableBorderSide;
-    readonly insideV: TableBorderSide;
-}
-/** The four resolved edges of one cell, after conflict resolution against its neighbours. */
-interface CellBorderBox {
-    readonly top: TableBorderSide;
-    readonly left: TableBorderSide;
-    readonly bottom: TableBorderSide;
-    readonly right: TableBorderSide;
-}
-/** Final edge winner; absent means the side/interval is not drawn. */
-interface ResolvedTableBorderEdge {
-    readonly style: TableBorderStyle;
-    readonly color: string | null;
-    readonly widthPt: number;
-}
-/**
- * Conflict winner over one grid interval of a cell side.
- *
- * `gridStart`/`gridEnd` are absolute grid column indices for horizontal sides and absolute
- * row indices for vertical sides (half-open). `startPt`/`endPt` are cell-local along-axis
- * positions in layout points.
- */
-interface ResolvedTableBorderEdgeSegment {
-    readonly side: TableBorderSideName;
-    readonly gridStart: number;
-    readonly gridEnd: number;
-    readonly startPt: number;
-    readonly endPt: number;
-    readonly edge: ResolvedTableBorderEdge;
-}
-/**
- * One published stroke rectangle in cell-local layout points.
- *
- * Paint multiplies x/y/width/height by scale and draws — no metrics, gaps, or corner math.
- */
-interface TableBorderStrokeRecord {
-    readonly side: TableBorderSideName;
-    readonly role: 'outer' | 'inner' | 'middle' | 'edge';
-    readonly color: string | null;
-    /** CSS keyword for this stroke (compound strokes are always solid). */
-    readonly cssStyle: 'solid' | 'dashed' | 'dotted';
-    readonly x: number;
-    readonly y: number;
-    readonly width: number;
-    readonly height: number;
-}
-/**
- * Layout-owned cell borders after conflict resolution and compound expansion.
- *
- * Convenience `top`/`left`/`bottom`/`right` are set when that side has a single uniform
- * full-span winner (existing consumers / CSS simple edges). Multi-interval winners live
- * only on `edgeSegments`. Compound geometry is always on `strokes`.
- */
-interface ResolvedCellBorders {
-    readonly top?: ResolvedTableBorderEdge;
-    readonly left?: ResolvedTableBorderEdge;
-    readonly bottom?: ResolvedTableBorderEdge;
-    readonly right?: ResolvedTableBorderEdge;
-    readonly edgeSegments?: readonly ResolvedTableBorderEdgeSegment[];
-    readonly strokes?: readonly TableBorderStrokeRecord[];
-}
-/** Soft cap on published stroke rectangles per cell (security / pathological spans). */
-declare const MAX_TABLE_BORDER_STROKES = 256;
-/** Read one OOXML border child into the three-state model. */
-declare function readBorderSide(node: OoxmlElement | undefined): TableBorderSide;
-/**
- * Read a table's `w:tblBorders`, dropping or clamping hostile values.
- *
- * Widths and colours come from a file: an out-of-range `w:sz` becomes a layout dimension, so it is
- * bounded here rather than downstream.
- */
-declare function readTableBorders(tblPr: OoxmlElement | undefined): TableBorderBox;
-/** Read one cell's `w:tcBorders`, under the same bounds {@link readTableBorders} applies. */
-declare function readCellBorders(tcPr: OoxmlElement | undefined): CellBorderBox;
-/**
- * Conflict weight: the authored width in eighths of a point, and nothing else.
- *
- * Word-matching, not conformance — §17.4.39 (`w:tblBorders`) and §17.4.66 (`w:tcBorders`)
- * describe the elements and specify no conflict algorithm. Word picks the heavier RULE, so
- * a 6pt dashed rule beats a hairline single. Folding the style rank into the weight (an
- * `sz × border-number` product) made a 0.5pt double outrank a 1pt single and made every
- * dashed or dotted rule weigh 1 regardless of `w:sz`, which erased its width entirely.
- */
-declare function borderWeight(side: TableBorderSide): number;
-/**
- * Pick the winner between two candidates on a shared grid line (zero cell spacing).
- *
- * `none` loses to any edge; two `none`/omitted yield omitted (no paint). Width decides;
- * equal widths rank by style, then prefer the darker color, then `preferFirst`
- * (reading-order / first candidate).
- */
-declare function resolveBorderConflict(first: TableBorderSide, second: TableBorderSide, preferFirst?: boolean): TableBorderSide;
-interface BorderGridCell {
-    readonly gridColumn: number;
-    readonly gridSpan: number;
-    readonly vMergeContinue: boolean;
-    readonly borders: CellBorderBox;
-    /** Set on restart cells that visually span into later rows. */
-    readonly mergeRowSpan?: number;
-}
-/**
- * The absolute grid a table's borders are drawn on: column widths, and per-row tops and heights.
- *
- * Shared by every edge so adjacent cells resolve to the SAME line, rather than each computing its
- * own and leaving a hairline gap between them.
- */
-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).
-     */
-    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;
-
 interface EquationGeometryBase {
     readonly box: LayoutBox;
     /** Baseline measured from this node's top edge. */
@@ -2026,6 +2016,91 @@ interface EquationSpanRecord {
 /** Compose one bounded OMML projection into paint-ready point geometry. */
 declare function layoutEquation(projection: OmmlEquationProjection, measurer: TextMeasurer, style: ResolvedRunStyle): EquationSpanRecord;
 
+/** Published root story containing an artifact occurrence. @public */
+type SemanticArtifactRootStoryKind = 'body' | 'header' | 'footer' | 'footnote' | 'endnote' | 'note-separator';
+/** Exact story in which a review artifact's source anchor was laid out. @public */
+type SemanticArtifactStoryKind = SemanticArtifactRootStoryKind | 'textbox';
+/** One model position retained as exporter provenance. @public */
+interface SemanticReviewArtifactPosition {
+    readonly paragraphId: string;
+    readonly offset: number;
+}
+/**
+ * Package-relative snapshot provenance, not durable public identity.
+ *
+ * Engine-produced occurrences keep `start.paragraphId === end.paragraphId`. Cross-paragraph
+ * source ranges are sliced into per-paragraph occurrences before geometry attaches.
+ * @public
+ */
+interface SemanticReviewArtifactSource {
+    readonly partName: string;
+    readonly start: SemanticReviewArtifactPosition;
+    readonly end: SemanticReviewArtifactPosition;
+}
+/**
+ * Laid-out bounds for one review occurrence.
+ *
+ * `pageContent` uses the same space as line boxes. `pageStack` uses stacked page coordinates.
+ * A point occurrence publishes `width: 0`.
+ * @public
+ */
+interface SemanticReviewArtifactOccurrenceGeometry {
+    readonly pageContent: readonly LayoutBox[];
+    readonly pageStack: readonly LayoutBox[];
+}
+/** One physical occurrence of a comment or tracked-change source range. @public */
+interface SemanticReviewArtifactOccurrence {
+    readonly pageIndex: number;
+    readonly physicalPageNumber: number;
+    readonly story: SemanticArtifactStoryKind;
+    readonly rootStory: SemanticArtifactRootStoryKind;
+    /** Root-to-leaf drawing ids for a textbox occurrence; empty outside textboxes. */
+    readonly textboxPath: readonly string[];
+    readonly noteScopeId: string | null;
+    readonly noteAreaKind: 'footnotes' | 'endnotes' | null;
+    /** Replacement-half meaning for tracked-change occurrences; absent for comments. */
+    readonly revisionRole?: 'replaced' | 'replacement' | 'neutral';
+    readonly source: SemanticReviewArtifactSource;
+    /** Laid-out bounds when this occurrence can be measured; omitted otherwise. */
+    readonly geometry?: SemanticReviewArtifactOccurrenceGeometry;
+}
+/** Normalized change; ids are opaque and stable only within the source snapshot. @public */
+interface SemanticTrackedChangeArtifactRecord {
+    readonly kind: 'tracked-change';
+    readonly id: string;
+    readonly change: 'insert' | 'delete' | 'replace' | 'moveFrom' | 'moveTo' | 'format' | 'paragraphMark' | 'structural';
+    readonly markDirection?: 'insert' | 'delete' | 'moveFrom' | 'moveTo';
+    readonly author: string;
+    readonly date?: string;
+    readonly text: string;
+    readonly replacedText: string;
+    /** Nested tracked-change depth, where the innermost decision is operative. */
+    readonly nesting: number;
+    /** Number of leading source ranges belonging to struck text in a replacement. */
+    readonly replacedRangeCount?: number;
+    readonly readOnly: boolean;
+    readonly pairedWith?: string;
+    readonly replyIds: readonly string[];
+    readonly occurrences: readonly SemanticReviewArtifactOccurrence[];
+}
+/** Normalized comment; all relation ids share the opaque snapshot-local id space. @public */
+interface SemanticCommentArtifactRecord {
+    readonly kind: 'comment';
+    readonly id: string;
+    readonly author: string;
+    readonly initials: string;
+    readonly date?: string;
+    readonly text: string;
+    readonly resolved: boolean;
+    readonly parentId?: string;
+    readonly parentRevisionId?: string;
+    readonly replyIds: readonly string[];
+    readonly orphaned: boolean;
+    readonly occurrences: readonly SemanticReviewArtifactOccurrence[];
+}
+/** Exporter-neutral review artifact normalized by core. @public */
+type SemanticReviewArtifactRecord = SemanticTrackedChangeArtifactRecord | SemanticCommentArtifactRecord;
+
 /** A half-open UTF-16 range inside one paragraph, addressed by its canonical node id. */
 interface SourceRange {
     readonly paragraphId: string;
@@ -2113,6 +2188,8 @@ interface StyleSpanRecord {
      */
     readonly fontSlot?: FontSlot;
     readonly box: LayoutBox;
+    /** Authored trailing spaces that layout may clip at the line's right edge. */
+    readonly lineEndWhitespace?: true;
     /**
      * Cumulative advances from {@link box}.x to each UTF-16 caret boundary in {@link text}.
      *
@@ -2309,6 +2386,12 @@ interface ParagraphFragmentRecord {
     readonly fragmentIndex: number;
     readonly range: SourceRange;
     readonly props: readonly OoxmlProperty[];
+    /** Resolved paragraph style after the style/default cascade, or null when none applies. */
+    readonly styleId: string | null;
+    /** Resolved Word outline level (0 = Heading 1), or null for body text. */
+    readonly outlineLevel: number | null;
+    /** Resolved `w:jc` alignment used by layout. */
+    readonly alignment: 'left' | 'center' | 'right' | 'both';
     /**
      * Before/after spacing applied to THIS fragment, in points.
      *
@@ -2448,6 +2531,8 @@ interface ListMarkerRecord {
     readonly numId: string;
     /** `w:numFmt` of the resolved level — `bullet` or a numbering format. */
     readonly numFmt: string;
+    /** Resolved counter at this marker's own level; absent for bullets. */
+    readonly ordinal?: number;
 }
 /**
  * The part of one table that sits on one page.
@@ -2493,6 +2578,8 @@ interface TableRowFragmentRecord {
     readonly revisionDate?: string;
     /** Authored row ordinal within the table; repeats share the original row's index. */
     readonly rowIndex: number;
+    /** True when the authored row resolves `w:tblHeader`, including its first occurrence. */
+    readonly isHeaderRow: boolean;
     /**
      * True for a `w:tblHeader` row RE-EMITTED at the top of a continuation page. Painted,
      * but excluded from interaction walks so each caret stop exists exactly once.
@@ -2533,6 +2620,8 @@ interface TableCellFragmentRecord {
     readonly rowSpan?: number;
     /** Validated 6-hex cell shading fill, absent for none/auto. */
     readonly shading?: string;
+    /** Bottom-to-top cell content uses a rotated local inline axis. */
+    readonly textDirection?: 'btLr';
     /**
      * Layout-owned resolved borders after collapsed conflict resolution.
      *
@@ -2769,7 +2858,14 @@ interface PageRecord {
 interface SemanticLayout {
     /** The store revision these records were laid out from. */
     readonly revision: number;
+    /** Revision projection already applied to every published record. */
+    readonly displayMode?: RevisionDisplayMode;
     readonly pages: readonly PageRecord[];
+    /**
+     * Normalized comments and tracked changes from the same package revision as these pages.
+     * Exporters consume this plain-data stream instead of re-reading OOXML or review state.
+     */
+    readonly reviewArtifacts?: readonly SemanticReviewArtifactRecord[];
     /**
      * Every content-control boundary in document order, including multi-page fragment lists.
      *
@@ -2818,4 +2914,4 @@ interface TextMeasurer {
     };
 }
 
-export { type DeclaredFontSubstitution as $, type AnchoredDrawingRecord as A, type BlockFragmentRecord as B, type ContentControlBoundaryRecord as C, type DrawingPoint as D, AUTO_PARAGRAPH_SPACING_PT as E, type FontResourceSnapshot as F, type AbstractNumDefinition as G, type HyperlinkProjector as H, type InlineDrawingRecord as I, type BidiEmbeddingLevels as J, type BorderGridGeometry as K, type LineRecord as L, type ModelRange as M, type NormalizationPolicy as N, type CascadedParagraphFormatting as O, type PageGeometry as P, type ContentControlGeometryFragment as Q, type ResolvedRunStyle as R, type SemanticLayout as S, type TextMeasurer as T, type ContentControlLevel as U, type VersionedShapingLibrary as V, type ContentControlMappedType as W, DEFAULT_PAGE_GEOMETRY as X, DEFAULT_RUN_STYLE as Y, DEFAULT_TAB_INTERVAL_PT as Z, DEFAULT_TAB_INTERVAL_TWIPS as _, type StyleSpanRecord as a, type ResolvedUnderline as a$, EMPTY_NUMBERING_INDEX as a0, EMPTY_TAB_STOPS as a1, type EquationFractionGeometry as a2, type EquationGeometry as a3, type EquationNaryGeometry as a4, type EquationRadicalGeometry as a5, type EquationRowGeometry as a6, type EquationScriptGeometry as a7, type EquationSpanRecord as a8, type EquationTextGeometry as a9, MAX_PARAGRAPH_SPACING_PT as aA, MAX_STYLE_BASED_ON_DEPTH as aB, MAX_STYLE_DEFINITIONS as aC, MAX_TABLE_BORDER_STROKES as aD, MAX_TAB_POSITION_TWIPS as aE, MAX_TAB_STOPS as aF, type NumDefinition as aG, type NumberingLevelIndent as aH, PARAGRAPH_BORDER_SIDES as aI, type PageRefCalibrationCell as aJ, type PageRefFieldProjection as aK, type ParagraphAutoSpacingContext as aL, type ParagraphBorderEdge as aM, type ParagraphBorderSide as aN, type ParagraphBorderStrokeRecord as aO, type ParagraphBorders as aP, type ParagraphBottomBorderRecord as aQ, type ParagraphIndent as aR, type ParagraphLayoutInputs as aS, type ParagraphLineSpacing as aT, type ParagraphSpacing as aU, type RefFieldSpec as aV, type RefNoteParts as aW, type ResolvedCellBorders as aX, type ResolvedTabStops as aY, type ResolvedTableBorderEdge as aZ, type ResolvedTableBorderEdgeSegment as a_, type FieldAtomMarker as aa, type FontFingerprintInputs as ab, type FontRequest as ac, FontResolutionError as ad, type FontResolutionErrorCode as ae, type FontResourceDefinition as af, type FontResourceInstrumentation as ag, type FontResourceSnapshotOptions as ah, type FontSlot as ai, type FontSubstitution as aj, type FontValidationResult as ak, type GlyphOutline as al, HARD_MAX_AGGREGATE_FONT_BYTES as am, HARD_MAX_FONT_BYTES as an, HARD_MAX_FONT_SOURCES as ao, type HeaderFooterStoryRecord as ap, type HyperlinkFieldSpec as aq, type LevelOverride as ar, type LineSpacingRule as as, type ListMarkerAlign as at, type ListMarkerRecord as au, type ListSuffix as av, MAX_BORDER_SPACE_PT as aw, MAX_BORDER_WIDTH_PT as ax, MAX_LVL_OVERRIDES as ay, MAX_NUMBERING_DEFINITIONS as az, type TextShaper as b, parseRefInstruction as b$, SINGLE_LINE_SPACING as b0, type ScriptItem as b1, type ShapeInput as b2, type ShapedCluster as b3, type ShapedFontSpan as b4, type ShapedGlyph as b5, type ShapedRunComparatorInputs as b6, type ShapedVerticalMetrics as b7, type ShapingEnvironment as b8, type ShapingEnvironmentFingerprintInputs as b9, cascadedBottomBorder as bA, cascadedParagraphBorders as bB, cascadedTabStops as bC, collapsedSpaceBefore as bD, createFontResourceSnapshot as bE, createShapedRun as bF, createShapingEnvironment as bG, defaultTabIntervalFromSettings as bH, displayText as bI, fixedPoint as bJ, fontRequestKey as bK, isValidStyleId as bL, itemizeScriptFontSlots as bM, layoutEquation as bN, listMarkerBox as bO, measureDisplayText as bP, mergeListIndent as bQ, nextTabDestination as bR, paragraphBorderExtentPt as bS, paragraphBorderStrokeWidthPt as bT, paragraphBorders as bU, paragraphBordersFingerprint as bV, paragraphBreaksBefore as bW, paragraphContextualSpacing as bX, paragraphLineSpacing as bY, paragraphSpacing as bZ, paragraphTabStops as b_, type ShapingEnvironmentInput as ba, type SourceRange as bb, type SpanLinkRecord as bc, type StyleDefinition as bd, TAB_LEADER_GLYPH as be, type TabAlignment as bf, type TabDestination as bg, type TabLeader as bh, type TabStop as bi, type TableBorderSideName as bj, type TableBorderStrokeRecord as bk, type TableFragmentRecord as bl, type TextDirection as bm, UnsupportedScriptError as bn, type VerticalAlign as bo, appliedSpaceBefore as bp, applyLineSpacing as bq, baselineShiftPtOf as br, borderExtentPt as bs, borderWeight as bt, bottomBorderExtentPt as bu, boundedStructuralFontValidator as bv, buildNumberingIndex as bw, buildStyleCascadeTable as bx, cascadeParagraphFormatting as by, cascadeRunProperties as bz, type FixedPointRoundingMode as c, readBorderSide as c0, readCellBorders as c1, readNumPr as c2, readTableBorders as c3, resolveBorderConflict as c4, resolveNumberingLevel as c5, resolveParagraphLayoutInputs as c6, resolveRunStyle as c7, resolveStoryListItems as c8, resolveStoryRefFields as c9, resolveTableCellBorderGrid as ca, runStylesEqual as cb, shapedRunComparatorInputs as cc, shapingEnvironmentFingerprint as cd, shapingEnvironmentFingerprintInputs as ce, styleForFontSlot as cf, tabAdvanceWidth as cg, tabStopsFingerprint as ch, walkStoryParagraphs as ci, withDefaultTabInterval as cj, withNumberingStyleLinks as ck, withResolvedListItems as cl, type ResolvedFont as d, type TableRowFragmentRecord as e, type TableCellFragmentRecord as f, type NumberingLevel as g, type NumberingIndex as h, type LayoutBox as i, type DrawingInsets as j, type PageRecord as k, type TableBorderSide as l, type ContentControlLock as m, type ParagraphFragmentRecord as n, type FontByteValidator as o, type FixedPoint as p, type ShapedRun as q, type InlineDrawingLayoutContext as r, type StyleCascadeTable as s, type FieldLinkProjector as t, type RefFieldContext as u, type StoryPageFieldNeeds as v, type ResolvedListItem as w, type CellBorderBox as x, type TableCellStyleFormatting as y, type TableBorderBox as z };
+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 };