@docx-editor.dev/core 2.26.0 → 2.28.0

package/dist/{semantic-paint-Bk9wIXdZ.d.ts → semantic-paint-BME37OMv.d.ts}

@@ -1,5 +1,7 @@
-import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-COqi8pjP.js';
-import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-DfagDguq.js';
+import { d as ResolvedRevisionMarkup } from './revision-projection-DZ4kKVev.js';
+import { a as PageRecord, C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-4B3WwFAi.js';
+import { S as SemanticRootStoryKind } from './semantic-record-queries-CBlZqZNa.js';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-BN-hUgCn.js';
 
 /**
  * Everything a host can say about ONE author's presentation. Every field is optional and
@@ -101,6 +103,21 @@ interface ReviewAuthorInfo {
     /** The host-supplied style, normalised; absent when the author rides the ramp. */
     readonly style?: RevisionAuthorStyle;
 }
+/**
+ * The resolved form the painter consumes: the document's author→slot map, the host's
+ * per-author styles, what UNSTYLED authors take, and the paint-reuse key for all of it.
+ * `null` means the default kind colouring for everyone.
+ */
+interface RevisionStyleContext {
+    readonly authorSlots: ReadonlyMap<string, number>;
+    readonly styles: ReadonlyMap<string, RevisionAuthorStyle>;
+    /** `spanClassName` pre-split into tokens, so paint does not split per span. */
+    readonly classTokens: ReadonlyMap<string, readonly string[]>;
+    /** Authors without a style: `'kind'` colours, or the ramp. */
+    readonly others: 'kind' | 'author';
+    /** See {@link revisionStyleContextKey}. Computed once, with the context. */
+    readonly key: string;
+}
 
 /** Host port for safe blob URLs — only called for {@link ImageResourceState.kind} `ready`. */
 interface PaintImageUrlPort {
@@ -120,8 +137,40 @@ interface DrawingPaintStrings {
     readonly pendingResource: string;
 }
 
-/** Which bars a paint draws: the view's own, or none for the resolved views. */
+/** Which bars a paint draws. @public */
 type ChangeBarsMode = 'all-markup' | 'simple-markup' | 'none';
+/** Which story a bar stands beside; the header-editing chrome dims every other story's. */
+type BarStory = Exclude<SemanticRootStoryKind, 'note-separator'>;
+/** One rule in sheet coordinates (points from the page's top-left corner). */
+interface BarRun {
+    author?: string;
+    color?: string;
+    top: number;
+    bottom: number;
+    story: BarStory;
+    insertion: boolean;
+    deletion: boolean;
+    format: boolean;
+}
+/** Page change bars in page coordinates. @public */
+interface PageChangeBars {
+    readonly mode: ChangeBarsMode;
+    readonly color?: string;
+    /** Whether the bars take the pointer as Word's toggle. */
+    readonly toggle: boolean;
+    /** Sheet-relative x of the column, already scaled and snapped to a whole pixel. */
+    readonly left: number;
+    readonly runs: readonly BarRun[];
+    /** Cheap identity of `left` + `runs`, for the block-adoption path to compare. */
+    readonly signature: string;
+}
+/**
+ * The rules one page needs, in sheet coordinates: every root story the page paints, the
+ * blocks of each (tracked rows and rotated cells included), and the text-box stories its
+ * anchored drawings carry, each at the origin the painter places it at.
+ * @public
+ */
+declare function collectPageChangeBars(page: PageRecord, scale: number, mode: ChangeBarsMode, toggle?: boolean, markup?: ResolvedRevisionMarkup, facingPages?: boolean, colors?: RevisionStyleContext): PageChangeBars;
 
 /**
  * When a field's result is drawn on its grey block, following Word's own View option.
@@ -179,6 +228,9 @@ interface PaintOptions {
      * See {@link RevisionStyles}.
      */
     readonly revisionStyles?: RevisionStyles;
+    readonly revisionMarkup?: ResolvedRevisionMarkup;
+    readonly revisionKindColors?: boolean;
+    readonly facingPages?: boolean;
     /**
      * Which change bars the margin draws: All Markup's neutral rule beside attributed lines
      * (the default, whatever the layout's projection — a layout that carries attribution gets
@@ -270,5 +322,5 @@ interface PaintOptions {
  */
 declare function paintSemanticLayout(container: HTMLElement, layout: SemanticLayout, options?: PaintOptions): void;
 
-export { DEFAULT_FIELD_SHADING as D, paintSemanticLayout as p };
-export type { FieldShadingMode as F, PaintOptions as P, ReviewAuthorInfo as R, RevisionAuthorAssignments as a, RevisionAuthorStyle as b, RevisionStyles as c, DrawingPaintStrings as d };
+export { DEFAULT_FIELD_SHADING as D, collectPageChangeBars as e, paintSemanticLayout as p };
+export type { ChangeBarsMode as C, FieldShadingMode as F, PageChangeBars as P, ReviewAuthorInfo as R, PaintOptions as a, RevisionAuthorAssignments as b, RevisionAuthorStyle as c, RevisionStyles as d, DrawingPaintStrings as f };

package/dist/semantic-record-queries-CBlZqZNa.d.ts

@@ -0,0 +1,177 @@
+import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, P as ParagraphFragmentRecord, L as LineRecord, a as PageRecord, N as NoteAreaRecord, b as LayoutBox, H as HeaderFooterStoryRecord, c as NoteStoryRecord, B as BlockFragmentRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, d as ContentControlLock } from './semantic-records-4B3WwFAi.js';
+
+/**
+ * Depth-first paragraph fragments of one page, in reading order.
+ *
+ * Table interiors flatten through rows and cells; header-repeat rows are skipped unless
+ * asked for, so interaction sees each caret stop exactly once while paint sees everything.
+ */
+declare function paragraphFragmentsOf(page: PageRecord, includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
+declare function paragraphFragmentsOfBlocks(blocks: readonly BlockFragmentRecord[], includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
+/** Every line in a layout, in reading order — the order caret navigation walks. */
+declare function linesOf(layout: SemanticLayout): LineRecord[];
+/** The fragment-plus-anchored-drawings shape every laid-out story shares. */
+interface StoryDrawingHost {
+    /** Root story fragments in their published reading order. */
+    readonly fragments: readonly BlockFragmentRecord[];
+    /** Story-level positioned drawings, when that story supports anchors. */
+    readonly anchoredDrawings?: readonly AnchoredDrawingRecord[];
+}
+/** Root story kinds published directly from one page record. @public */
+type SemanticRootStoryKind = 'body' | 'header' | 'footer' | 'footnote' | 'endnote' | 'note-separator';
+/** Story containing a visited semantic record. @public */
+type SemanticStoryKind = SemanticRootStoryKind | 'textbox';
+/**
+ * One root story in the engine's complete published page/story order.
+ *
+ * The story discriminant preserves the precise published host type so exporters can consume
+ * furniture and note metadata without casting or searching the page graph a second time.
+ * @public
+ */
+type SemanticStoryVisit = {
+    readonly page: PageRecord;
+    readonly story: 'body';
+    readonly host: PageRecord;
+    /** Absolute story bounds; body records are relative to the page content box. */
+    readonly box: LayoutBox;
+    /** Absolute origin to add to story-relative fragment and drawing coordinates. */
+    readonly origin: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly noteScopeId: null;
+    readonly noteAreaKind: null;
+} | {
+    readonly page: PageRecord;
+    readonly story: 'header' | 'footer';
+    readonly host: HeaderFooterStoryRecord;
+    readonly box: LayoutBox;
+    readonly origin: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly noteScopeId: null;
+    readonly noteAreaKind: null;
+} | {
+    readonly page: PageRecord;
+    readonly story: 'footnote' | 'endnote';
+    readonly host: NoteStoryRecord;
+    readonly box: LayoutBox;
+    readonly origin: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly noteScopeId: string;
+    readonly noteAreaKind: NoteAreaRecord['kind'];
+} | {
+    readonly page: PageRecord;
+    readonly story: 'note-separator';
+    readonly host: NonNullable<NoteAreaRecord['separator']>;
+    readonly box: LayoutBox;
+    readonly origin: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly noteScopeId: null;
+    readonly noteAreaKind: NoteAreaRecord['kind'];
+};
+/** Visit every root story in a semantic layout, preserving page/story order. @public */
+declare function forEachSemanticStory(layout: SemanticLayout, visit: (story: SemanticStoryVisit) => void): void;
+/** Location of one paragraph fragment within a recursively painted story graph. @public */
+interface StoryParagraphFragmentContext {
+    /** Absolute origin of the immediate story containing this record. */
+    readonly storyOrigin: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    /** Zero for the supplied story; increments for every textbox boundary. */
+    readonly textboxDepth: number;
+    /** Drawing whose textbox directly owns this fragment, or null for the root story. */
+    readonly textboxOwner: TextboxOwnerRecord | null;
+    /** Root-to-leaf owning drawings, empty for the supplied story. */
+    readonly textboxPath: readonly TextboxOwnerRecord[];
+}
+/** A drawing that owns a text-box story: anchored, or inline on a line. @public */
+type TextboxOwnerRecord = InlineDrawingRecord | AnchoredDrawingRecord;
+/** Location of one drawing within a recursively painted story graph. @public */
+interface StoryDrawingContext extends StoryParagraphFragmentContext {
+    /** Enclosing paragraph for an inline drawing; null for a story-level anchor. */
+    readonly paragraph: ParagraphFragmentRecord | null;
+    /** Enclosing line for an inline drawing; null for a story-level anchor. */
+    readonly line: LineRecord | null;
+}
+type RootDrawingOrigin = (drawing: AnchoredDrawingRecord) => Readonly<{
+    x: number;
+    y: number;
+}>;
+/** Drawing layer relative to its owning story's text. @public */
+type SemanticDrawingLayer = 'behind-text' | 'inline' | 'in-front-of-text';
+/**
+ * One drawing in bounded graph-enumeration order with exporter-grade provenance.
+ *
+ * Enumeration is deliberately not paint order: story anchors (and nested textboxes) are visited
+ * before inline line drawings. Renderers use `paintLayer` plus record geometry to compose layers.
+ * @public
+ */
+interface SemanticDrawingVisit extends StoryDrawingContext {
+    /** Physical page carrying this drawing occurrence. */
+    readonly page: PageRecord;
+    /** Immediate story classification; `textbox` after textbox descent. */
+    readonly story: SemanticStoryKind;
+    /** Root story from which textbox descent began. */
+    readonly rootStory: SemanticRootStoryKind;
+    /** Note scope for drawings in note stories; null elsewhere. */
+    readonly noteScopeId: string | null;
+    /** Owning note-area kind for note/separator drawings; null elsewhere. */
+    readonly noteAreaKind: NoteAreaRecord['kind'] | null;
+    /** Precise root host and absolute origin for story-relative geometry. */
+    readonly root: SemanticStoryVisit;
+    /** Absolute origin of this drawing's extent in page-stack coordinates. */
+    readonly drawingOrigin: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    /** Absolute painted bounds, including effects and clipping. */
+    readonly absolutePaintBounds: LayoutBox;
+    /** Absolute pointer/hit bounds. */
+    readonly absoluteHitBounds: LayoutBox;
+    /** Layer relative to text in the immediate owning story. */
+    readonly paintLayer: SemanticDrawingLayer;
+    /** Published drawing record; inline visits also carry paragraph and line. */
+    readonly drawing: InlineDrawingRecord | AnchoredDrawingRecord;
+}
+/** Visit every drawing through the canonical root-story and recursive textbox walks. @public */
+declare function forEachSemanticDrawing(layout: SemanticLayout, visit: (drawing: SemanticDrawingVisit) => void): void;
+/**
+ * Visit every paragraph fragment one story paints — its own (table interiors flattened,
+ * header repeats included) and the fragments inside each anchored drawing's text-box story,
+ * recursively.
+ *
+ * The fragment sibling of {@link forEachStoryDrawing}, sharing its depth bound, for
+ * consumers that read per-paragraph published fields (list markers) rather than drawings.
+ * The furniture list-marker token walks with this; a fragment it misses leaves a reused
+ * page showing a stale marker.
+ */
+declare function forEachStoryParagraphFragment(story: StoryDrawingHost, visit: (fragment: ParagraphFragmentRecord, context: StoryParagraphFragmentContext) => void, rootOrigin?: Readonly<{
+    x: number;
+    y: number;
+}>, rootDrawingOrigin?: RootDrawingOrigin): void;
+/** Every fragment belonging to one paragraph, in order, across page boundaries. */
+declare function fragmentsOfParagraph(layout: SemanticLayout, paragraphId: string): ParagraphFragmentRecord[];
+/** The line containing a model position, or null when the position is not laid out. */
+declare function lineAtPosition(layout: SemanticLayout, paragraphId: string, offset: number, 
+/** Lines to test, when the caller already knows which ones can carry the paragraph. */
+candidates?: Iterable<LineRecord>): LineRecord | null;
+/** Every content-control boundary on a layout, preferring the layout-level list. */
+declare function contentControlsOfLayout(layout: SemanticLayout): readonly ContentControlBoundaryRecord[];
+/**
+ * Axis-aligned union of boxes, or null when the list is empty.
+ *
+ * Used when a control's content spans several fragments or spans on one page.
+ */
+declare function unionLayoutBoxes(boxes: readonly LayoutBox[]): LayoutBox | null;
+/** Collapse raw + ancestor locks into one `ST_Lock` vocabulary value. */
+declare function effectiveContentControlLock(locks: readonly ContentControlLock[]): ContentControlLock;
+
+export { contentControlsOfLayout as h, effectiveContentControlLock as i, forEachSemanticDrawing as j, forEachSemanticStory as k, forEachStoryParagraphFragment as l, fragmentsOfParagraph as m, lineAtPosition as n, linesOf as o, paragraphFragmentsOf as p, paragraphFragmentsOfBlocks as q, unionLayoutBoxes as u };
+export type { SemanticRootStoryKind as S, TextboxOwnerRecord as T, SemanticStoryKind as a, SemanticStoryVisit as b, SemanticDrawingLayer as c, SemanticDrawingVisit as d, StoryDrawingContext as e, StoryDrawingHost as f, StoryParagraphFragmentContext as g };

package/dist/{semantic-records-COqi8pjP.d.ts → semantic-records-4B3WwFAi.d.ts}

@@ -1,7 +1,7 @@
-import { c as RevisionAttribution, a as RevisionDisplayMode } from './revision-projection-DfWxdBqA.js';
-import { X as OoxmlProperty, Z as OoxmlElement, N as OoxmlNode, O as OoxmlPart, aG as TableBorderStyle, aH as DrawingAccessibility, aI as DrawingImageEffects, a8 as SourceCrop, aJ as DrawingTransform, aK as VectorShapeProjection, aj as DrawingHorizontalReferenceFrame, ak as DrawingVerticalReferenceFrame, aa as ImageWrapTarget, a0 as DrawingProjection, aL as OoxmlDrawingNode } from './types-barrel-BO73JqHG.js';
-import { b as ImageResourceState } from './image-resources-DfagDguq.js';
-import { O as OmmlEquationProjection } from './omml-equation-CZ6IG2ja.js';
+import { o as RevisionAttribution, b as RevisionDisplayMode } from './revision-projection-DZ4kKVev.js';
+import { X as OoxmlProperty, Z as OoxmlElement, N as OoxmlNode, O as OoxmlPart, aJ as TableBorderStyle, aK as DrawingAccessibility, aL as DrawingImageEffects, al as SourceCrop, aM as DrawingTransform, aN as VectorShapeProjection, aw as DrawingHorizontalReferenceFrame, ax as DrawingVerticalReferenceFrame, an as ImageWrapTarget, a0 as DrawingProjection, aO as OoxmlDrawingNode } from './types-barrel-D3xCgQX6.js';
+import { b as ImageResourceState } from './image-resources-BN-hUgCn.js';
+import { O as OmmlEquationProjection } from './omml-equation-CuzBL5DD.js';
 
 /** A strikeout stroke at the drawn size, in points. `offsetPt` is the stroke TOP. @public */
 interface StrikeoutStrokePt {
@@ -913,8 +913,8 @@ declare function paragraphLineSpacing(props: readonly OoxmlProperty[]): Paragrap
  * Exact-height boxes place their baseline at 80% of the height; the legacy
  * noExtraLineSpacing switch instead preserves the face baseline within the box.
  *
- * An `auto` line of a snapping paragraph under an active line grid takes whole pitches
- * instead ({@link gridLineBox}); `trailing` then names the extra below the grid line.
+ * An `auto` or `atLeast` line of a snapping paragraph under an active line grid takes whole
+ * pitches instead ({@link gridLineBox}); `trailing` then names the box below the glyphs.
  */
 declare function applyLineSpacing(spacing: ParagraphLineSpacing, naturalHeight: number, naturalBaseline: number): {
     height: number;
@@ -1130,6 +1130,8 @@ interface ThemeFonts {
     /** Language-specific theme faces, keyed by ISO 15924 script. */
     readonly majorSupplemental?: Readonly<Record<string, string>>;
     readonly minorSupplemental?: Readonly<Record<string, string>>;
+    /** Lower-cased font table names that declare a Chinese character set. */
+    readonly chineseFontTableFaces?: readonly string[];
 }
 /**
  * Resolve one run's direct formatting.
@@ -1171,6 +1173,9 @@ declare function glyphSizeFactorOf(style: ResolvedRunStyle): number;
 /** Horizontal alignment of a paragraph (`w:jc`, ECMA-376 §17.3.1.13). */
 type Alignment = 'left' | 'center' | 'right' | 'both';
 
+/** The number formats a page field's `\*` switch can select (ST_NumberFormat names). */
+type PageFieldNumberFormat = 'decimal' | 'lowerRoman' | 'upperRoman' | 'lowerLetter' | 'upperLetter' | 'numberInDash';
+
 type AllowlistedPageField = 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES';
 /**
  * Which allowlisted page fields a header/footer story actually contains.
@@ -1192,6 +1197,29 @@ interface StoryPageFieldNeeds {
     readonly hasPageParity?: boolean;
 }
 
+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[];
+    /** Unclipped image corners for affine encoding; clipping must not stretch the image. */
+    readonly imageTransformCorners?: readonly DrawingPoint[];
+    readonly clipPolygon: readonly DrawingPoint[] | null;
+    readonly clipFallback: DrawingClipFallback;
+    readonly effectInsets: DrawingInsets;
+}
+
 /**
  * UAX #9 embedding levels, one per UTF-16 code unit, plus the paragraph ranges they were resolved
  * within.
@@ -1428,6 +1456,8 @@ interface FieldAtomMarker {
         readonly kind: AllowlistedPageField;
         /** The field's `\#` numeric picture, applied when finalize substitutes the value. */
         readonly picture?: string;
+        /** The field's `\*` number format, applied when finalize substitutes the value. */
+        readonly numberFormat?: PageFieldNumberFormat;
     };
     /**
      * A BODY `PAGEREF` atom whose value is the page number its bookmark target lands on.
@@ -1438,6 +1468,17 @@ interface FieldAtomMarker {
      * first fragment, gated per field on the calibration verdict.
      */
     readonly pageRef?: PageRefFieldProjection;
+    /**
+     * The first model offset of the editable saved result this piece belongs to.
+     *
+     * Present only when saved results are laid out as text (`fieldResults: 'editable'`). The
+     * result is ordinary text then, so its pieces have their own offsets; every piece of one
+     * result shares this value, which keeps a multi-run link result one anchor and lets the
+     * caret find the whole result it is in.
+     */
+    readonly resultStart?: number;
+    /** The model offset just past the same result, beside {@link resultStart}. */
+    readonly resultEnd?: number;
 }
 /** A half-open model-offset range, in the paragraph's own UTF-16 offset space. */
 interface ModelRange {
@@ -1595,29 +1636,6 @@ interface CjkTypographySettings {
     readonly after: Readonly<Record<string, string>>;
 }
 
-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[];
-    /** Unclipped image corners for affine encoding; clipping must not stretch the image. */
-    readonly imageTransformCorners?: readonly DrawingPoint[];
-    readonly clipPolygon: readonly DrawingPoint[] | null;
-    readonly clipFallback: DrawingClipFallback;
-    readonly effectInsets: DrawingInsets;
-}
-
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
     /** Sparse intervals emitted (not dense column slots). */
@@ -1634,9 +1652,8 @@ type TableBorderSideName = 'top' | 'right' | 'bottom' | 'left';
 /**
  * One border edge in one of three states.
  *
- * Omitted edges inherit. Explicit no-border edges suppress inherited rules; a directly
- * authored opposing edge can still win. This matches the saved Word sample's mixed and
- * borderless tables, including cells authored with `w:val="none"`.
+ * Omitted edges inherit. Explicit no-border edges suppress their own inherited rule.
+ * An opposing edge can still win, including a rule inherited by the neighboring cell.
  */
 type TableBorderSide = {
     readonly state: 'omitted';
@@ -1750,6 +1767,8 @@ interface BorderGridCell {
     readonly borders: CellBorderBox;
     /** Set on restart cells that visually span into later rows. */
     readonly mergeRowSpan?: number;
+    /** The row's `w:tblPrEx` table borders, which replace the table's own for this cell. */
+    readonly rowTableBorders?: TableBorderBox;
 }
 /**
  * The absolute grid a table's borders are drawn on: column widths, and per-row tops and heights.
@@ -1824,8 +1843,13 @@ interface TextboxStoryLayout {
         x: number;
         y: number;
     }>;
-    /** Content box width (extent minus horizontal insets). */
+    /** Content box width (extent minus horizontal insets; the widest line when unwrapped). */
     readonly contentWidth: number;
+    /**
+     * Box width (points) that unwrapped text sizes its shape to: the widest line plus the
+     * insets. Placement resolves the shape at this width. Absent when the extent width holds.
+     */
+    readonly extentWidth?: 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. */
@@ -1850,6 +1874,21 @@ interface TextboxStoryLayout {
     readonly clippedResourceToken?: string;
 }
 
+/** One laid-out group member story. */
+interface GroupTextboxStoryRecord {
+    /** Canonical node id of the member `wps:wsp`. */
+    readonly memberNodeId: string;
+    /** The member box in points, relative to the drawing extent's top-left corner. */
+    readonly box: LayoutBox;
+    /** The member's story, in content-box coordinates inside {@link box}. */
+    readonly story: TextboxStoryLayout;
+    /**
+     * Clockwise turn of the painted member about the center of {@link box}, in degrees. The
+     * story lays out upright; paint and export turn it. Hit testing never maps into it.
+     */
+    readonly rotationDegrees: number;
+}
+
 /** Clip `box` to a horizontal content band; preserves authored size, zeroes clipped axes. */
 /** How a drawing record holds the picture member of a shape group. */
 interface DrawingGroupPictureRecord {
@@ -1922,6 +1961,8 @@ interface InlineDrawingRecord {
      * inline text box carries one too: its story sits inside the extent the line reserves.
      */
     readonly textboxStory?: TextboxStoryLayout;
+    /** Read-only stories of a group's text box members, each placed in its member box. */
+    readonly groupTextboxStories?: readonly GroupTextboxStoryRecord[];
 }
 interface InlineDrawingLayoutContext {
     readonly ownerPartName: string;
@@ -2046,12 +2087,7 @@ declare function withNumberingStyleLinks(index: NumberingIndex, styleCascade: St
  * in `direct`, and the defaults and that style's bases go in `inherited`.
  */
 declare function mergeListIndent(levelIndent: NumberingLevelIndent, inherited: readonly OoxmlProperty[], direct?: readonly OoxmlProperty[]): NumberingLevelIndent;
-/**
- * Collect paragraphs of a block list in document order, descending into tables.
- *
- * Caps nesting so a hostile nested-table document cannot recurse without bound.
- */
-declare function walkStoryParagraphs(blocks: readonly OoxmlElement[], maxTableDepth?: number): OoxmlElement[];
+
 /**
  * Resolve every list paragraph in a story to a {@link ResolvedListItem}, keyed by node id.
  *
@@ -2480,6 +2516,8 @@ interface SemanticTrackedChangeArtifactRecord {
     readonly kind: 'tracked-change';
     readonly id: string;
     readonly change: 'insert' | 'delete' | 'replace' | 'moveFrom' | 'moveTo' | 'format' | 'paragraphMark' | 'structural';
+    /** Structural changes represented by this review artifact. */
+    readonly structuralChanges?: readonly ('rowInsert' | 'rowDelete' | 'cellInsert' | 'cellDelete' | 'cellMerge' | 'numberingInsert')[];
     readonly markDirection?: 'insert' | 'delete' | 'moveFrom' | 'moveTo';
     readonly author: string;
     readonly date?: string;
@@ -2791,7 +2829,8 @@ interface LineRecord {
      * nothing, which is why the caret, paint's `padding-bottom` and the content-control
      * boundary all need this published rather than recovered from the box.
      *
-     * Zero under exact and atLeast, and on lines holding drawings (the box is authored).
+     * Zero under exact and atLeast. On a line holding drawings, only an auto multiple above
+     * single spacing sets it: the multiple's extra text band below the drawings.
      * Absent on lines published before this was measured; treat as zero.
      */
     readonly trailingSpacing?: number;
@@ -3156,6 +3195,9 @@ interface TableRowFragmentRecord {
  * blocks — its content belongs to the cell that started the merge.
  */
 interface TableCellFragmentRecord {
+    readonly revisionShading?: 'inserted' | 'deleted' | 'merged' | 'split';
+    /** Author of the visible cell revision, or its enclosing row revision. */
+    readonly revisionShadingAuthor?: string;
     /** Canonical node id of the `w:tc`. */
     readonly id: string;
     /** First grid column this cell occupies. */
@@ -3486,5 +3528,5 @@ interface TextMeasurer {
     };
 }
 
-export { PARAGRAPH_BORDER_SIDES as a$, AUTO_PARAGRAPH_SPACING_PT as a4, HARD_MAX_AGGREGATE_FONT_BYTES as aF, HARD_MAX_FONT_BYTES as aG, HARD_MAX_FONT_SOURCES as aH, MAX_BORDER_SPACE_PT as aN, MAX_BORDER_WIDTH_PT as aO, MAX_LVL_OVERRIDES as aP, MAX_NUMBERING_DEFINITIONS as aQ, MAX_PARAGRAPH_SPACING_PT as aR, MAX_SHAPING_CONTEXT as aS, MAX_STYLE_DEFINITIONS as aT, MAX_TABLE_BORDER_STROKES as aU, MAX_TAB_POSITION_TWIPS as aV, MAX_TAB_STOPS as aW, PAGE_BORDER_SIDES as a_, DEFAULT_RUN_STYLE as ae, DEFAULT_TAB_INTERVAL_PT as af, DEFAULT_TAB_INTERVAL_TWIPS as ag, EMPTY_NUMBERING_INDEX as al, EMPTY_TAB_STOPS as am, FontResolutionError as ax, boundedStructuralFontValidator as b$, TAB_LEADER_GLYPH as bI, UnsupportedScriptError as bT, appliedSpaceBefore as bV, applyLineSpacing as bW, baselineShiftPtOf as bX, borderExtentPt as bY, borderWeight as bZ, bottomBorderExtentPt as b_, SINGLE_LINE_SPACING as bo, 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, readNumPr as cA, readTableBorders as cB, resolveBorderConflict as cC, resolveNumberingLevel as cD, resolveParagraphLayoutInputs as cE, resolveRunStyle as cF, resolveStoryListItems as cG, resolveStoryRefFields as cH, resolveTableCellBorderGrid as cI, runStylesEqual as cJ, shapedRunComparatorInputs as cK, shapingEnvironmentFingerprint as cL, shapingEnvironmentFingerprintInputs as cM, styleForFontSlot as cN, tabAdvanceWidth as cO, tabStopsFingerprint as cP, walkStoryParagraphs as cQ, withDefaultTabInterval as cR, withNumberingStyleLinks as cS, withResolvedListItems as cT, createShapingEnvironment as ca, defaultTabIntervalFromSettings as cb, displayText as cc, fixedPoint as cd, fontRequestKey as ce, glyphSizeFactorOf as cf, isValidStyleId as cg, itemizeScriptFontSlots as ch, layoutEquation as ci, measureDisplayText as cj, mergeListIndent as ck, nextTabDestination as cl, pageBordersFingerprint as cm, paragraphBorderExtentPt as cn, paragraphBorderStrokeWidthPt as co, paragraphBorders as cp, paragraphBordersFingerprint as cq, paragraphBreaksBefore as cr, paragraphContextualSpacing as cs, paragraphLineSpacing as ct, paragraphSpacing as cu, paragraphTabStops as cv, parsePageBorders as cw, parseRefInstruction as cx, readBorderSide as cy, readCellBorders as cz };
-export type { HyperlinkFieldSpec as $, AnchoredDrawingRecord as A, BlockFragmentRecord as B, ContentControlBoundaryRecord as C, DrawingPoint as D, TableFloatPosition as E, FontResourceSnapshot as F, TableBorderBox as G, StyleCascadeTable as H, InlineDrawingRecord as I, NoteAreaRecord as J, HeaderFooterStoryRecord as K, LineRecord as L, ModelRange as M, NormalizationPolicy as N, NoteStoryRecord as O, ParagraphFragmentRecord as P, ContentControlLock as Q, ResolvedRunStyle as R, SemanticLayout as S, TextMeasurer as T, FixedPoint as U, VersionedShapingLibrary as V, FontByteValidator as W, SourceRange as X, HyperlinkProjector as Y, FieldLinkProjector as Z, StoryPageFieldNeeds as _, StyleSpanRecord as a, SpanLinkRecord as a0, PageBorderFrameRecord as a1, ParagraphBorderStrokeRecord as a2, StrikeoutStrokePt as a3, AbstractNumDefinition as a5, AnchoredDrawingLayoutFallback as a6, BidiEmbeddingLevels as a7, BorderGridGeometry as a8, CascadedParagraphFormatting as a9, FontResourceInstrumentation as aA, FontResourceSnapshotOptions as aB, FontSlot as aC, FontValidationResult as aD, GlyphOutline as aE, LevelOverride as aI, LineSpacingRule as aJ, ListMarkerAlign as aK, ListMarkerRecord as aL, ListSuffix as aM, NumDefinition as aX, NumberingLevelIndent as aY, NumberingPictureBullet as aZ, CjkTypographySettings as aa, ContentControlGeometryFragment as ab, ContentControlLevel as ac, ContentControlMappedType as ad, DeclaredFontSubstitution as ah, DrawingClipFallback as ai, DrawingGeometry as aj, DrawingGroupPictureRecord as ak, EquationFractionGeometry as an, EquationGeometry as ao, EquationNaryGeometry as ap, EquationRadicalGeometry as aq, EquationRowGeometry as ar, EquationScriptGeometry as as, EquationSpanRecord as at, EquationTextGeometry as au, FieldAtomMarker as av, FontFingerprintInputs as aw, FontResolutionErrorCode as ay, FontResourceDefinition as az, SectionPageBorders as b, PageBorderDisplay as b0, PageBorderOffsetFrom as b1, PageBorderSide as b2, PageBorderStrokeRecord as b3, PageBorderZOrder as b4, PageRefCalibrationCell as b5, PageRefFieldProjection as b6, ParagraphAutoSpacingContext as b7, ParagraphBorderEdge as b8, ParagraphBorderSide as b9, ShapedFontSpan as bA, ShapedGlyph as bB, ShapedRunComparatorInputs as bC, ShapedVerticalMetrics as bD, ShapingContext as bE, ShapingEnvironment as bF, ShapingEnvironmentFingerprintInputs as bG, StyleDefinition as bH, TabAlignment as bJ, TabDestination as bK, TabLeader as bL, TabStop as bM, TableBorderSideName as bN, TableBorderStrokeRecord as bO, TableFragmentRecord as bP, TextDirection as bQ, TextboxStoryFallbackReason as bR, TextboxStoryLayout as bS, VerticalAlign as bU, ParagraphBorders as ba, ParagraphBottomBorderRecord as bb, ParagraphIndent as bc, ParagraphLayoutInputs as bd, ParagraphLineSpacing as be, ParagraphSpacing as bf, RefFieldSpec as bg, RefNoteParts as bh, ResolvedCellBorders as bi, ResolvedPictureBullet as bj, ResolvedTabStops as bk, ResolvedTableBorderEdge as bl, ResolvedTableBorderEdgeSegment as bm, ResolvedUnderline as bn, ScriptItem as bp, SemanticArtifactRootStoryKind as bq, SemanticArtifactStoryKind as br, SemanticCommentArtifactRecord as bs, SemanticReviewArtifactOccurrence as bt, SemanticReviewArtifactOccurrenceGeometry as bu, SemanticReviewArtifactPosition as bv, SemanticReviewArtifactSource as bw, SemanticTrackedChangeArtifactRecord as bx, ShapeInput as by, ShapedCluster as bz, TableRowFragmentRecord as c, TableCellFragmentRecord as d, ShapingEnvironmentInput as e, TextShaper as f, ResolvedFont as g, FixedPointRoundingMode as h, FontRequest as i, SemanticReviewArtifactRecord as j, ListMarkerPictureRecord as k, FontSubstitution as l, ShapedRun as m, NumberingLevel as n, NumberingIndex as o, LayoutBox as p, DrawingInsets as q, TableBorderSide as r, TableFloatXSpec as s, TableFloatYSpec as t, PageRecord as u, ResolvedListItem as v, RefFieldContext as w, InlineDrawingLayoutContext as x, CellBorderBox as y, TableCellStyleFormatting as z };
+export { PAGE_BORDER_SIDES as a$, AUTO_PARAGRAPH_SPACING_PT as a4, HARD_MAX_AGGREGATE_FONT_BYTES as aG, HARD_MAX_FONT_BYTES as aH, HARD_MAX_FONT_SOURCES as aI, MAX_BORDER_SPACE_PT as aO, MAX_BORDER_WIDTH_PT as aP, MAX_LVL_OVERRIDES as aQ, MAX_NUMBERING_DEFINITIONS as aR, MAX_PARAGRAPH_SPACING_PT as aS, MAX_SHAPING_CONTEXT as aT, MAX_STYLE_DEFINITIONS as aU, MAX_TABLE_BORDER_STROKES as aV, MAX_TAB_POSITION_TWIPS as aW, MAX_TAB_STOPS as aX, DEFAULT_RUN_STYLE as ae, DEFAULT_TAB_INTERVAL_PT as af, DEFAULT_TAB_INTERVAL_TWIPS as ag, EMPTY_NUMBERING_INDEX as al, EMPTY_TAB_STOPS as am, FontResolutionError as ax, bottomBorderExtentPt as b$, PARAGRAPH_BORDER_SIDES as b0, TAB_LEADER_GLYPH as bJ, UnsupportedScriptError as bU, appliedSpaceBefore as bW, applyLineSpacing as bX, baselineShiftPtOf as bY, borderExtentPt as bZ, borderWeight as b_, SINGLE_LINE_SPACING as bp, boundedStructuralFontValidator as c0, buildNumberingIndex as c1, buildStyleCascadeTable as c2, cascadeParagraphFormatting as c3, cascadeRunProperties as c4, cascadedBottomBorder as c5, cascadedParagraphBorders as c6, cascadedTabStops as c7, collapsedSpaceBefore as c8, createFontResourceSnapshot as c9, readCellBorders as cA, readNumPr as cB, readTableBorders as cC, resolveBorderConflict as cD, resolveNumberingLevel as cE, resolveParagraphLayoutInputs as cF, resolveRunStyle as cG, resolveStoryListItems as cH, resolveStoryRefFields as cI, resolveTableCellBorderGrid as cJ, runStylesEqual as cK, shapedRunComparatorInputs as cL, shapingEnvironmentFingerprint as cM, shapingEnvironmentFingerprintInputs as cN, styleForFontSlot as cO, tabAdvanceWidth as cP, tabStopsFingerprint as cQ, withDefaultTabInterval as cR, withNumberingStyleLinks as cS, withResolvedListItems as cT, createShapedRun as ca, createShapingEnvironment as cb, defaultTabIntervalFromSettings as cc, displayText as cd, fixedPoint as ce, fontRequestKey as cf, glyphSizeFactorOf as cg, isValidStyleId as ch, itemizeScriptFontSlots as ci, layoutEquation as cj, measureDisplayText as ck, mergeListIndent as cl, nextTabDestination as cm, pageBordersFingerprint as cn, paragraphBorderExtentPt as co, paragraphBorderStrokeWidthPt as cp, paragraphBorders as cq, paragraphBordersFingerprint as cr, paragraphBreaksBefore as cs, paragraphContextualSpacing as ct, paragraphLineSpacing as cu, paragraphSpacing as cv, paragraphTabStops as cw, parsePageBorders as cx, parseRefInstruction as cy, readBorderSide as cz };
+export type { HyperlinkFieldSpec as $, AnchoredDrawingRecord as A, BlockFragmentRecord as B, ContentControlBoundaryRecord as C, DrawingPoint as D, InlineDrawingLayoutContext as E, FontResourceSnapshot as F, CellBorderBox as G, HeaderFooterStoryRecord as H, InlineDrawingRecord as I, TableBorderBox as J, TableCellStyleFormatting as K, LineRecord as L, ModelRange as M, NoteAreaRecord as N, TableFloatPosition as O, ParagraphFragmentRecord as P, StyleCascadeTable as Q, ResolvedRunStyle as R, SemanticLayout as S, TextMeasurer as T, FixedPoint as U, VersionedShapingLibrary as V, FontByteValidator as W, SourceRange as X, HyperlinkProjector as Y, FieldLinkProjector as Z, StoryPageFieldNeeds as _, PageRecord as a, SpanLinkRecord as a0, PageBorderFrameRecord as a1, ParagraphBorderStrokeRecord as a2, StrikeoutStrokePt as a3, AbstractNumDefinition as a5, AnchoredDrawingLayoutFallback as a6, BidiEmbeddingLevels as a7, BorderGridGeometry as a8, CascadedParagraphFormatting as a9, FontResourceInstrumentation as aA, FontResourceSnapshotOptions as aB, FontSlot as aC, FontValidationResult as aD, GlyphOutline as aE, GroupTextboxStoryRecord as aF, LevelOverride as aJ, LineSpacingRule as aK, ListMarkerAlign as aL, ListMarkerRecord as aM, ListSuffix as aN, NumDefinition as aY, NumberingLevelIndent as aZ, NumberingPictureBullet as a_, CjkTypographySettings as aa, ContentControlGeometryFragment as ab, ContentControlLevel as ac, ContentControlMappedType as ad, DeclaredFontSubstitution as ah, DrawingClipFallback as ai, DrawingGeometry as aj, DrawingGroupPictureRecord as ak, EquationFractionGeometry as an, EquationGeometry as ao, EquationNaryGeometry as ap, EquationRadicalGeometry as aq, EquationRowGeometry as ar, EquationScriptGeometry as as, EquationSpanRecord as at, EquationTextGeometry as au, FieldAtomMarker as av, FontFingerprintInputs as aw, FontResolutionErrorCode as ay, FontResourceDefinition as az, LayoutBox as b, PageBorderDisplay as b1, PageBorderOffsetFrom as b2, PageBorderSide as b3, PageBorderStrokeRecord as b4, PageBorderZOrder as b5, PageRefCalibrationCell as b6, PageRefFieldProjection as b7, ParagraphAutoSpacingContext as b8, ParagraphBorderEdge as b9, ShapedCluster as bA, ShapedFontSpan as bB, ShapedGlyph as bC, ShapedRunComparatorInputs as bD, ShapedVerticalMetrics as bE, ShapingContext as bF, ShapingEnvironment as bG, ShapingEnvironmentFingerprintInputs as bH, StyleDefinition as bI, TabAlignment as bK, TabDestination as bL, TabLeader as bM, TabStop as bN, TableBorderSideName as bO, TableBorderStrokeRecord as bP, TableFragmentRecord as bQ, TextDirection as bR, TextboxStoryFallbackReason as bS, TextboxStoryLayout as bT, VerticalAlign as bV, ParagraphBorderSide as ba, ParagraphBorders as bb, ParagraphBottomBorderRecord as bc, ParagraphIndent as bd, ParagraphLayoutInputs as be, ParagraphLineSpacing as bf, ParagraphSpacing as bg, RefFieldSpec as bh, RefNoteParts as bi, ResolvedCellBorders as bj, ResolvedPictureBullet as bk, ResolvedTabStops as bl, ResolvedTableBorderEdge as bm, ResolvedTableBorderEdgeSegment as bn, ResolvedUnderline as bo, ScriptItem as bq, SemanticArtifactRootStoryKind as br, SemanticArtifactStoryKind as bs, SemanticCommentArtifactRecord as bt, SemanticReviewArtifactOccurrence as bu, SemanticReviewArtifactOccurrenceGeometry as bv, SemanticReviewArtifactPosition as bw, SemanticReviewArtifactSource as bx, SemanticTrackedChangeArtifactRecord as by, ShapeInput as bz, NoteStoryRecord as c, ContentControlLock as d, StyleSpanRecord as e, SectionPageBorders as f, TableRowFragmentRecord as g, TableCellFragmentRecord as h, ShapingEnvironmentInput as i, TextShaper as j, ResolvedFont as k, NormalizationPolicy as l, FixedPointRoundingMode as m, FontRequest as n, SemanticReviewArtifactRecord as o, ListMarkerPictureRecord as p, FontSubstitution as q, ShapedRun as r, NumberingLevel as s, NumberingIndex as t, DrawingInsets as u, TableBorderSide as v, TableFloatXSpec as w, TableFloatYSpec as x, ResolvedListItem as y, RefFieldContext as z };