@docx-editor.dev/core 2.30.0 → 2.31.0

package/dist/output.d.ts

@@ -8,14 +8,13 @@
  * @packageDocumentation
  * @public
  */
-import { R as ReviewAuthorInfo } from './semantic-paint-Bz3FBAoH.js';
-export { B as BreakMarkStrings, C as ChangeBarsMode, D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PageChangeBars, a as PaintOptions, b as RevisionAuthorAssignments, c as RevisionAuthorStyle, d as RevisionStyles, e as collectPageChangeBars, p as paintSemanticLayout } from './semantic-paint-Bz3FBAoH.js';
-import { S as SemanticLayout } from './semantic-records-CjcF26ZL.js';
-import './semantic-record-queries-Bx0pl6kL.js';
-import './image-resources-Bipz8toD.js';
-import './types-barrel-CA0xB8kH.js';
-import './editor-scope-7o9xweiJ.js';
-import './omml-equation-DP2WpUbK.js';
+import { R as ReviewAuthorInfo } from './semantic-paint-DLzA8sjP.js';
+export { B as BreakMarkStrings, C as ChangeBarsMode, D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PageChangeBars, a as PaintOptions, b as RevisionAuthorAssignments, c as RevisionAuthorStyle, d as RevisionStyles, e as collectPageChangeBars, p as paintSemanticLayout } from './semantic-paint-DLzA8sjP.js';
+import { S as SemanticLayout } from './semantic-records-B-akgRch.js';
+import './semantic-record-queries-3yp9o11g.js';
+import './types-barrel-CkF2JbU4.js';
+import './editor-scope-C7ke1KJG.js';
+import './omml-equation-BsLAa2lX.js';
 
 /** A rectangle in page-content coordinates, on a named page. */
 interface OverlayRect {
@@ -92,5 +91,16 @@ interface SelectionOverlayOptions {
  */
 declare function paintSelectionOverlay(layer: HTMLElement, layout: SemanticLayout, rects: readonly OverlayRect[], options: SelectionOverlayOptions): void;
 
-export { ReviewAuthorInfo, paintSelectionOverlay };
-export type { OverlayRect, SelectionOverlayOptions };
+/** `out = slope * in + intercept` over sRGB channels in [0, 1]. */
+interface LumTransfer {
+    readonly slope: number;
+    readonly intercept: number;
+}
+/**
+ * Word's `a:lum` transfer for `bright`/`contrast` given in percent (`70.001` for `70001`).
+ * Returns `null` for the identity transfer and for non-finite input.
+ */
+declare function lumTransfer(brightPercent: number, contrastPercent: number): LumTransfer | null;
+
+export { ReviewAuthorInfo, lumTransfer, paintSelectionOverlay };
+export type { LumTransfer, OverlayRect, SelectionOverlayOptions };

package/dist/output.js

@@ -1 +1 @@
-export{m as DEFAULT_FIELD_SHADING,h as collectPageChangeBars,r as paintSelectionOverlay,p as paintSemanticLayout}from'./chunk-ZOS2PM4A.js';import'./chunk-EBCXSH2W.js';import'./chunk-RIYSCEFQ.js';import'./chunk-UM26GH5B.js';import'./chunk-T32MGBJS.js';import'./chunk-PF5NJWS3.js';import'./chunk-5SPITS5F.js';
+export{n as DEFAULT_FIELD_SHADING,h as collectPageChangeBars,i as lumTransfer,s as paintSelectionOverlay,q as paintSemanticLayout}from'./chunk-LZY6B6IV.js';import'./chunk-FNNOJNGY.js';import'./chunk-RIYSCEFQ.js';import'./chunk-4S24UOPG.js';import'./chunk-VWIJKH4A.js';import'./chunk-Q5K2GGNG.js';import'./chunk-T2QQHG5C.js';

package/dist/{protocol-CZ1uUlPO.d.ts → protocol-COZJUKUY.d.ts}

@@ -1,5 +1,5 @@
-import { aw as AutomationTableMutation, a9 as RevisionBatchResult, a8 as RevisionAuthorResult } from './types-barrel-CA0xB8kH.js';
-import { c as HeaderFooterVariant, N as NoteKind } from './tree-package-store-DKhdEVym.js';
+import { aF as AutomationTableMutation, ac as RevisionBatchResult, ab as RevisionAuthorResult } from './types-barrel-CkF2JbU4.js';
+import { c as HeaderFooterVariant, N as NoteKind } from './tree-package-store-B8l8DX3Z.js';
 
 /** Word's shape types, as `Word.ShapeType` spells them. */
 type AutomationShapeType = 'TextBox' | 'GeometricShape' | 'Picture' | 'Group' | 'Canvas' | 'Unsupported';
@@ -877,6 +877,50 @@ type AutomationOperation = AutomationAuthoringOperation | {
     readonly op: 'getBookmarkRange';
     readonly bookmark: AutomationHandle;
 }
+/**
+ * The names of the bookmarks a span overlaps, in document order: `Range.getBookmarks`.
+ *
+ * A non-empty span holds a bookmark when the two share text, and a point bookmark when the
+ * point is inside the span. An empty span holds the bookmarks around it. `includeAdjacent`
+ * adds the bookmarks that only touch the span; `includeHidden` adds names starting with `_`.
+ */
+ | {
+    readonly op: 'getBookmarkNames';
+    readonly scope: AutomationSpanRef;
+    readonly includeHidden: boolean;
+    readonly includeAdjacent: boolean;
+}
+/**
+ * The range of the bookmark with this name, compared without case, in any story: main text
+ * first, then headers, footers and notes. Answers no span when nothing declares the name.
+ */
+ | {
+    readonly op: 'getBookmarkRangeByName';
+    readonly document: AutomationHandle;
+    readonly name: string;
+}
+/**
+ * Add a bookmark around a span, or at a point. A bookmark any story declares under the same
+ * name, compared without case, moves here in the same write.
+ */
+ | {
+    readonly op: 'insertBookmark';
+    readonly span: AutomationSpanRef;
+    readonly name: string;
+}
+/**
+ * Remove a bookmark: by name anywhere in the document, or the one a handle names. The text
+ * stays. A name nothing declares is not an error and changes nothing.
+ */
+ | {
+    readonly op: 'deleteBookmark';
+    readonly target: {
+        readonly document: AutomationHandle;
+        readonly name: string;
+    } | {
+        readonly bookmark: AutomationHandle;
+    };
+}
 /**
  * The comments anchored in a scope, in document order — the TOP-LEVEL ones.
  *
@@ -990,6 +1034,31 @@ type AutomationOperation = AutomationAuthoringOperation | {
     readonly op: 'getRevisions';
     readonly body: AutomationHandle;
 }
+/**
+ * The listed tracked changes whose characters a span overlaps, in document order. A collapsed
+ * span lists the changes it touches. Handles are the story-wide listing's handles.
+ */
+ | {
+    readonly op: 'getRevisions';
+    readonly scope: AutomationSpanRef;
+}
+/**
+ * The listed tracked changes a review-queue key names: one, or the two halves of a paired
+ * replacement. A key naming nothing answers no handles.
+ */
+ | {
+    readonly op: 'getRevisions';
+    readonly key: string;
+}
+/**
+ * The stretch a review-queue key names: `revision-<id>`, a paired `revision-replace:<a>+<b>`,
+ * or `comment-<id>`. Answers `spans` holding one span covering every range of the item, or no
+ * span when the key names nothing this document holds.
+ */
+ | {
+    readonly op: 'getReviewItemRange';
+    readonly key: string;
+}
 /** Resolve eligible decisions in one story. Omit revisions to select every canonical decision. */
  | {
     readonly op: 'resolveRevisionBatch';
@@ -1061,6 +1130,24 @@ type AutomationOperation = AutomationAuthoringOperation | {
     readonly op: 'rejectAllRevisions';
     readonly document: AutomationHandle;
 }
+/**
+ * Accept or reject every change a span overlaps, or the changes a review-queue key names, as
+ * one transaction. Structural changes absent from listings are included. Refused whole when
+ * any of them is read-only or cannot be resolved, and when the key names nothing.
+ */
+ | {
+    readonly op: 'acceptAllRevisions';
+    readonly scope: AutomationSpanRef;
+} | {
+    readonly op: 'rejectAllRevisions';
+    readonly scope: AutomationSpanRef;
+} | {
+    readonly op: 'acceptAllRevisions';
+    readonly key: string;
+} | {
+    readonly op: 'rejectAllRevisions';
+    readonly key: string;
+}
 /**
  * Put the reader's selection on a span. Requires the `selection` capability, so a headless
  * host refuses it rather than pretending to have a caret.
@@ -1493,6 +1580,11 @@ type AutomationValue = {
 } | {
     readonly kind: 'text';
     readonly text: string;
+}
+/** Several strings, in document order: the names of the bookmarks a range holds. */
+ | {
+    readonly kind: 'texts';
+    readonly texts: readonly string[];
 } | {
     readonly kind: 'span';
     readonly span: AutomationSpan;

package/dist/{review-paragraph-order-CqVelc5A.d.ts → review-paragraph-order-C_QbCKcH.d.ts}

@@ -1,4 +1,4 @@
-import { N as OoxmlNode, ah as OoxmlElement, ai as OoxmlContentControlNode, V as OoxmlGenericElementNode, aj as OoxmlContentControlContentNode, C as CommentRecord, O as OoxmlPart } from './types-barrel-CA0xB8kH.js';
+import { N as OoxmlNode, ap as OoxmlElement, aq as OoxmlContentControlNode, V as OoxmlGenericElementNode, ar as OoxmlContentControlContentNode, C as CommentRecord, O as OoxmlPart } from './types-barrel-CkF2JbU4.js';
 
 /** Nested content-control wrappers deeper than this stop flattening; content stays preserved. */
 declare const MAX_CONTENT_CONTROL_NESTING = 32;

package/dist/{semantic-cell-selection-Dr9yxFZt.d.ts → semantic-cell-selection-Cub9FDa8.d.ts}

@@ -1,5 +1,5 @@
-import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-Dc3pf3hr.js';
-import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, g as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, h as TableRowFragmentRecord, i as TableCellFragmentRecord } from './semantic-records-CjcF26ZL.js';
+import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-dApRIYpt.js';
+import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, g as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, h as TableRowFragmentRecord, i as TableCellFragmentRecord } from './semantic-records-B-akgRch.js';
 
 /** A point in the coordinate space named by the function taking it. */
 interface HitPoint {

package/dist/{semantic-interaction-Dc3pf3hr.d.ts → semantic-interaction-dApRIYpt.d.ts}

@@ -1,4 +1,4 @@
-import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, g as StyleSpanRecord } from './semantic-records-CjcF26ZL.js';
+import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, g as StyleSpanRecord } from './semantic-records-B-akgRch.js';
 
 /** How `moveCaret` resolves a motion. */
 interface MoveCaretOptions {

package/dist/{semantic-paint-Bz3FBAoH.d.ts → semantic-paint-DLzA8sjP.d.ts}

@@ -1,6 +1,6 @@
-import { c as PageRecord, q as ResolvedRevisionMarkup, C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-CjcF26ZL.js';
-import { S as SemanticRootStoryKind } from './semantic-record-queries-Bx0pl6kL.js';
-import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-Bipz8toD.js';
+import { c as PageRecord, q as ResolvedRevisionMarkup, C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-B-akgRch.js';
+import { S as SemanticRootStoryKind } from './semantic-record-queries-3yp9o11g.js';
+import { aj as ValidatedImageBytesHandle, aa as RenderableImageMime } from './types-barrel-CkF2JbU4.js';
 
 /**
  * Everything a host can say about ONE author's presentation. Every field is optional and

package/dist/{semantic-record-queries-Bx0pl6kL.d.ts → semantic-record-queries-3yp9o11g.d.ts}

@@ -1,4 +1,4 @@
-import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, P as ParagraphFragmentRecord, L as LineRecord, c as PageRecord, N as NoteAreaRecord, d as LayoutBox, H as HeaderFooterStoryRecord, e as NoteStoryRecord, B as BlockFragmentRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, f as ContentControlLock } from './semantic-records-CjcF26ZL.js';
+import { I as InlineDrawingRecord, A as AnchoredDrawingRecord, P as ParagraphFragmentRecord, L as LineRecord, c as PageRecord, N as NoteAreaRecord, d as LayoutBox, H as HeaderFooterStoryRecord, e as NoteStoryRecord, B as BlockFragmentRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, f as ContentControlLock } from './semantic-records-B-akgRch.js';
 
 /**
  * Depth-first paragraph fragments of one page, in reading order.

package/dist/{semantic-records-CjcF26ZL.d.ts → semantic-records-B-akgRch.d.ts}

@@ -1,6 +1,5 @@
-import { N as OoxmlNode, am as OoxmlProperty, O as OoxmlPart, ah as OoxmlElement, aQ as TableBorderStyle, aR as DrawingAccessibility, aS as DrawingImageEffects, aJ as SourceCrop, aP as DrawingTransform, aT as VectorShapeProjection, X as DrawingHorizontalReferenceFrame, $ as DrawingVerticalReferenceFrame, a1 as ImageWrapTarget, al as DrawingProjection, aU as OoxmlDrawingNode } from './types-barrel-CA0xB8kH.js';
-import { I as ImageResourceState } from './image-resources-Bipz8toD.js';
-import { O as OmmlEquationProjection } from './omml-equation-DP2WpUbK.js';
+import { N as OoxmlNode, at as OoxmlProperty, O as OoxmlPart, ap as OoxmlElement, b3 as TableBorderStyle, a1 as ImageResourceState, b4 as DrawingAccessibility, b5 as DrawingImageEffects, aT as SourceCrop, b2 as DrawingTransform, b6 as VectorShapeProjection, X as DrawingHorizontalReferenceFrame, $ as DrawingVerticalReferenceFrame, a2 as ImageWrapTarget, b7 as DrawingProjection, b8 as OoxmlDrawingNode } from './types-barrel-CkF2JbU4.js';
+import { O as OmmlEquationProjection } from './omml-equation-BsLAa2lX.js';
 
 /** Named revision colors. Identifiers are stable and never contain CSS. @public */
 declare const REVISION_MARKUP_COLORS: readonly ['black', 'blue', 'turquoise', 'green', 'pink', 'red', 'yellow', 'white', 'darkBlue', 'teal', 'darkGreen', 'violet', 'darkRed', 'darkYellow', 'gray50', 'gray25', 'lightBlue', 'lightYellow', 'lightOrange', 'lightPurple', 'lightGreen', 'gray'];
@@ -240,14 +239,6 @@ declare function formatRevisionOf(properties: readonly {
 /** True when this stack of revisions marks its content as deleted from the live document. */
 declare function revisionsAreDeletion(revisions: readonly RevisionAttribution[]): boolean;
 
-/** A strikeout stroke at the drawn size, in points. `offsetPt` is the stroke TOP. @public */
-interface StrikeoutStrokePt {
-    /** Distance from the baseline UP to the top of the stroke. */
-    readonly offsetPt: number;
-    /** Stroke height. Always positive. */
-    readonly thicknessPt: number;
-}
-
 /**
  * Whether a paragraph must start a new page (`w:pageBreakBefore`).
  *
@@ -1905,6 +1896,12 @@ declare function resolveStoryRefFields(blocks: readonly OoxmlElement[], listItem
  * view decision made downstream, so this states the fact and nothing about the appearance.
  */
 interface FieldAtomMarker {
+    /**
+     * A plain REF cross-reference with no nested field (not PAGEREF or NOTEREF): its result,
+     * the target's text or number, never changes with pagination, so a justified line may treat
+     * it as an ordinary word.
+     */
+    readonly fixedResult?: true;
     /**
      * A legacy form field: `w:fldChar/w:ffData` (FORMTEXT, FORMCHECKBOX, FORMDROPDOWN).
      *
@@ -1988,6 +1985,22 @@ type HyperlinkProjector = (link: OoxmlNode) => SpanLinkRecord | null;
  */
 type FieldLinkProjector = (spec: HyperlinkFieldSpec) => SpanLinkRecord | null;
 
+/** 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;
+    /** Disable adjacent full-width punctuation compression when false. */
+    readonly punctuationKerning?: boolean;
+    /** The document defaults explicitly select an East Asian face as the East Asian font. */
+    readonly sourceEastAsianFont?: 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>>;
+}
+
 /** Soft ceiling matching Word's practical custom-tab UI limit. */
 declare const MAX_TAB_STOPS = 64;
 /**
@@ -2109,22 +2122,6 @@ declare function tabAdvanceWidth(alignment: TabAlignment, currentX: number, dest
  */
 declare function tabStopsFingerprint(tabs: ResolvedTabStops): string;
 
-/** 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;
-    /** Disable adjacent full-width punctuation compression when false. */
-    readonly punctuationKerning?: boolean;
-    /** The document defaults explicitly select an East Asian face as the East Asian font. */
-    readonly sourceEastAsianFont?: 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>>;
-}
-
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
     /** Sparse intervals emitted (not dense column slots). */
@@ -2378,6 +2375,39 @@ interface GroupTextboxStoryRecord {
     readonly rotationDegrees: number;
 }
 
+/** `x' = scaleX * x + offsetX`, `y' = scaleY * y + offsetY`, from text space into the box. */
+interface TextArtFit {
+    readonly scaleX: number;
+    readonly scaleY: number;
+    readonly offsetX: number;
+    readonly offsetY: number;
+}
+interface DrawingTextArtRecord {
+    readonly text: string;
+    readonly fontFamily: string;
+    readonly bold: boolean;
+    readonly italic: boolean;
+    /** Size of the unfitted text that `fit` maps into the box. */
+    readonly fontSizePt: number;
+    /** `RRGGBB`, or null when the text is not filled. */
+    readonly fillHex: string | null;
+    readonly fillAlpha: number;
+    /** `RRGGBB`, or null when the text is not outlined. */
+    readonly strokeHex: string | null;
+    readonly strokeAlpha: number;
+    readonly strokeWidthPt: number;
+    /** Clockwise rotation about the box centre. */
+    readonly rotationDegrees: number;
+    /**
+     * The fitted glyph outlines in points from the box's top-left corner, as absolute M/L/Q/C/Z
+     * path data. Null when the measurer knew only the ink box: paint then draws the text at
+     * `fontSizePt` through `fit`.
+     */
+    readonly path: string | null;
+    /** Null when the measurer could not bound the string's ink: nothing paints. */
+    readonly fit: TextArtFit | null;
+}
+
 /** 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 {
@@ -2495,6 +2525,8 @@ interface AnchoredDrawingRecord extends Omit<InlineDrawingRecord, 'kind' | 'base
     readonly layoutFallback?: AnchoredDrawingLayoutFallback;
     /** Canonical document traversal index within the owner story part. */
     readonly sourceOrder?: number;
+    /** Floating VML text art fitted to the box; paint draws it instead of a resource. */
+    readonly textArt?: DrawingTextArtRecord;
 }
 
 /**
@@ -2557,25 +2589,6 @@ declare function readNumPr(paragraphPropertyNodes: readonly OoxmlNode[]): {
  * and so it is when nothing delegates, which keeps layout cache identity.
  */
 declare function withNumberingStyleLinks(index: NumberingIndex, styleCascade: StyleCascadeTable | undefined): NumberingIndex;
-/**
- * The effective indent of a list paragraph: `inherited`, then the numbering LEVEL, then
- * `direct`, per attribute.
- *
- * A level's `w:pPr/w:ind` applies per attribute between the two tiers, and the ordering
- * matters on real documents. A converted agreement numbers its `(a)` items with a level
- * stating `left=1512 hanging=738` under a `ListParagraph` style stating
- * `left=775 hanging=624`, and states only `hanging="737"` on the paragraph itself. Reading
- * the flattened cascade as "the paragraph's indent" gave the STYLE's 775 to a level that had
- * overridden it, so every lettered sub-item hung a full indent step to the left of where
- * Word puts it.
- *
- * `inherited` is what the level outranks and `direct` is what outranks it. When the
- * paragraph's own `w:pPr` states a `w:numPr`, these are the style chain (after the document
- * defaults) and that `w:pPr`. Otherwise the level sits directly below the nearest style that
- * states a `w:numPr`: that style, the styles based on it and the paragraph's own `w:pPr` go
- * 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;
 
 /**
  * Resolve every list paragraph in a story to a {@link ResolvedListItem}, keyed by node id.
@@ -3072,6 +3085,75 @@ interface PageGeometry {
 /** US Letter with one-inch margins, in points. */
 declare const DEFAULT_PAGE_GEOMETRY: PageGeometry;
 
+/** A strikeout stroke at the drawn size, in points. `offsetPt` is the stroke TOP. @public */
+interface StrikeoutStrokePt {
+    /** Distance from the baseline UP to the top of the stroke. */
+    readonly offsetPt: number;
+    /** Stroke height. Always positive. */
+    readonly thicknessPt: number;
+}
+
+/**
+ * A string's glyphs in points, x right and y down from the pen origin on the baseline, at the
+ * style's size.
+ *
+ * `path` is SVG path data made only of absolute `M`, `L`, `Q`, `C` and `Z` commands, or null
+ * when the measurer knows the ink box but not the outlines (a canvas measurer). `ink` bounds
+ * every glyph's ink in the same space.
+ */
+interface TextOutline {
+    readonly path: string | null;
+    readonly ink: {
+        readonly left: number;
+        readonly top: number;
+        readonly right: number;
+        readonly bottom: number;
+    };
+}
+/**
+ * Text measurement, injected.
+ *
+ * A real implementation shapes with the resolved font; the tests supply a deterministic one.
+ * Layout never reads the DOM, so this is the only way width and height enter it.
+ */
+interface TextMeasurer {
+    /** Advance width of `text` in the resolved style. */
+    measure(text: string, style: ResolvedRunStyle): number;
+    /**
+     * Optional whole-span logical caret advances, indexed by UTF-16 offset. Values
+     * are nondecreasing, start at zero, and end at the measured advance. Ligature
+     * interiors may share an edge. Undefined selects a bounded approximate fallback.
+     */
+    caretAdvances?(text: string, style: ResolvedRunStyle): readonly number[] | undefined;
+    /**
+     * Optional conservative ink bounds for one grapheme, in points from its origin.
+     * Includes size and horizontal scale, but not trailing character spacing.
+     * Undefined keeps layout on the advance-only path.
+     */
+    inkBounds?(text: string, style: ResolvedRunStyle): {
+        left: number;
+        right: number;
+    } | undefined;
+    /**
+     * Optional glyph outlines of a whole string, for text drawn as a shape (VML text art).
+     * Undefined when the face cannot answer; the shape then paints nothing rather than guess.
+     */
+    textOutline?(text: string, style: ResolvedRunStyle): TextOutline | undefined;
+    /** Whether line metrics use an admitted face instead of approximate fallback metrics. */
+    hasResolvedFont?(style: ResolvedRunStyle): boolean;
+    /**
+     * Optional `OS/2` strikeout stroke for the resolved face, at the drawn size. Word paints
+     * `w:separator` as a strikeout, so the note rule reads its thickness and offset here rather
+     * than assuming one face's numbers. Undefined keeps the caller's own default.
+     */
+    strikeoutMetrics?(style: ResolvedRunStyle): StrikeoutStrokePt | undefined;
+    /** Line metrics for the actual text faces; omitted text measures the primary face. */
+    lineMetrics(style: ResolvedRunStyle, text?: string): {
+        height: number;
+        baseline: number;
+    };
+}
+
 /** A half-open UTF-16 range inside one paragraph, addressed by its canonical node id. */
 interface SourceRange {
     readonly paragraphId: string;
@@ -3965,44 +4047,5 @@ interface SectionBreakMarkRecord {
     readonly kind: SectionBreakType;
 }
 
-/**
- * Text measurement, injected.
- *
- * A real implementation shapes with the resolved font; the tests supply a deterministic one.
- * Layout never reads the DOM, so this is the only way width and height enter it.
- */
-interface TextMeasurer {
-    /** Advance width of `text` in the resolved style. */
-    measure(text: string, style: ResolvedRunStyle): number;
-    /**
-     * Optional whole-span logical caret advances, indexed by UTF-16 offset. Values
-     * are nondecreasing, start at zero, and end at the measured advance. Ligature
-     * interiors may share an edge. Undefined selects a bounded approximate fallback.
-     */
-    caretAdvances?(text: string, style: ResolvedRunStyle): readonly number[] | undefined;
-    /**
-     * Optional conservative ink bounds for one grapheme, in points from its origin.
-     * Includes size and horizontal scale, but not trailing character spacing.
-     * Undefined keeps layout on the advance-only path.
-     */
-    inkBounds?(text: string, style: ResolvedRunStyle): {
-        left: number;
-        right: number;
-    } | undefined;
-    /** Whether line metrics use an admitted face instead of approximate fallback metrics. */
-    hasResolvedFont?(style: ResolvedRunStyle): boolean;
-    /**
-     * Optional `OS/2` strikeout stroke for the resolved face, at the drawn size. Word paints
-     * `w:separator` as a strikeout, so the note rule reads its thickness and offset here rather
-     * than assuming one face's numbers. Undefined keeps the caller's own default.
-     */
-    strikeoutMetrics?(style: ResolvedRunStyle): StrikeoutStrokePt | undefined;
-    /** Line metrics for the actual text faces; omitted text measures the primary face. */
-    lineMetrics(style: ResolvedRunStyle, text?: string): {
-        height: number;
-        baseline: number;
-    };
-}
-
-export { DEFAULT_REVISION_MARKUP as D, resolveRevisionMarkup as Q, DEFAULT_PAGE_GEOMETRY as aA, DEFAULT_REVISION_DISPLAY_MODE as aB, DEFAULT_RUN_STYLE as aC, DEFAULT_SECTION_PROPERTIES as aD, DEFAULT_TAB_INTERVAL_PT as aE, DEFAULT_TAB_INTERVAL_TWIPS as aF, EMPTY_NUMBERING_INDEX as aM, EMPTY_TAB_STOPS as aN, FontResolutionError as aZ, AUTO_PARAGRAPH_SPACING_PT as ap, HARD_MAX_AGGREGATE_FONT_BYTES as b6, HARD_MAX_FONT_BYTES as b7, HARD_MAX_FONT_SOURCES as b8, SINGLE_LINE_SPACING as bU, MAX_BORDER_SPACE_PT as be, MAX_BORDER_WIDTH_PT as bf, MAX_DOCUMENT_SECTIONS as bg, MAX_LVL_OVERRIDES as bh, MAX_NUMBERING_DEFINITIONS as bi, MAX_PARAGRAPH_SPACING_PT as bj, MAX_SHAPING_CONTEXT as bk, MAX_STYLE_DEFINITIONS as bl, MAX_TABLE_BORDER_STROKES as bm, MAX_TAB_POSITION_TWIPS as bn, MAX_TAB_STOPS as bo, PAGE_BORDER_SIDES as bs, PARAGRAPH_BORDER_SIDES as bt, nextTabDestination as c$, boundedStructuralFontValidator as cA, buildNumberingIndex as cB, buildStyleCascadeTable as cC, cascadeParagraphFormatting as cD, cascadeRunProperties as cE, cascadedBottomBorder as cF, cascadedParagraphBorders as cG, cascadedTabStops as cH, collapsedSpaceBefore as cI, createFontResourceSnapshot as cJ, createShapedRun as cK, createShapingEnvironment as cL, defaultTabIntervalFromSettings as cM, displayText as cN, enumerateDocumentSections as cO, enumerateDocumentSectionsBounded as cP, fixedPoint as cQ, fontRequestKey as cR, formatRevisionOf as cS, geometryOfSection as cT, glyphSizeFactorOf as cU, isValidStyleId as cV, itemizeScriptFontSlots as cW, layoutEquation as cX, markRevisionRemovesMark as cY, measureDisplayText as cZ, mergeListIndent as c_, TAB_LEADER_GLYPH as ch, UnsupportedScriptError as cs, appliedSpaceBefore as cu, applyLineSpacing as cv, baselineShiftPtOf as cw, borderExtentPt as cx, borderWeight as cy, bottomBorderExtentPt as cz, pageBordersFingerprint as d0, paragraphBorderExtentPt as d1, paragraphBorderStrokeWidthPt as d2, paragraphBorders as d3, paragraphBordersFingerprint as d4, paragraphBreaksBefore as d5, paragraphContextualSpacing as d6, paragraphLineSpacing as d7, paragraphMarkFormatRevisionOf as d8, paragraphMarkRevisionOf as d9, shapedRunComparatorInputs as dA, shapingEnvironmentFingerprint as dB, shapingEnvironmentFingerprintInputs as dC, shownMarkRevision as dD, styleForFontSlot as dE, tabAdvanceWidth as dF, tabStopsFingerprint as dG, withDefaultTabInterval as dH, withNumberingStyleLinks as dI, withResolvedListItems as dJ, paragraphMarkRevisionsOf as da, paragraphSectionNode as db, paragraphSpacing as dc, paragraphTabStops as dd, parsePageBorders as de, parsePageNumbering as df, parseRefInstruction as dg, parseSectionProperties as dh, projectedSectionSourceIndexes as di, readBorderSide as dj, readCellBorders as dk, readNumPr as dl, readSectionProperties as dm, readTableBorders as dn, resolveBorderConflict as dp, resolveNumberingLevel as dq, resolveParagraphLayoutInputs as dr, resolveRunStyle as ds, resolveStoryListItems as dt, resolveStoryRefFields as du, resolveTableCellBorderGrid as dv, revisionAuthorFilter as dw, revisionsAreDeletion as dx, revisionsVisible as dy, runStylesEqual as dz, REVISION_MARKUP_COLORS as w };
-export type { TableBorderSide as $, AnchoredDrawingRecord as A, BlockFragmentRecord as B, ContentControlBoundaryRecord as C, RevisionMarkupColor as E, FontResourceSnapshot as F, RevisionMarkupMark as G, HeaderFooterStoryRecord as H, InlineDrawingRecord as I, RevisionMarkupNamedColor as J, RevisionMarkupStyle as K, LineRecord as L, RevisionMarkupTextStyle as M, NoteAreaRecord as N, SectionProperties as O, ParagraphFragmentRecord as P, RevisionMarkupDialogSession as R, SemanticLayout as S, TextMeasurer as T, NumberingLevel as U, VersionedShapingLibrary as V, NumberingIndex as W, DrawingPoint as X, DrawingInsets as Y, ModelRange as Z, RevisionAttribution as _, ReviewDisplayMode as a, FontResourceDefinition as a$, TableFloatXSpec as a0, TableFloatYSpec as a1, ResolvedListItem as a2, RefFieldContext as a3, InlineDrawingLayoutContext as a4, CellBorderBox as a5, TableBorderBox as a6, TableCellStyleFormatting as a7, TableFloatPosition as a8, StyleCascadeTable as a9, DeclaredFontSubstitution as aG, DocumentSection as aH, DocumentSectionsEnumeration as aI, DrawingClipFallback as aJ, DrawingGeometry as aK, DrawingGroupPictureRecord as aL, EquationBarGeometry as aO, EquationFractionGeometry as aP, EquationGeometry as aQ, EquationNaryGeometry as aR, EquationRadicalGeometry as aS, EquationRowGeometry as aT, EquationScriptGeometry as aU, EquationSpanRecord as aV, EquationTextGeometry as aW, FieldAtomMarker as aX, FontFingerprintInputs as aY, FontResolutionErrorCode as a_, RevisionAuthorFilter as aa, FixedPoint as ab, FontByteValidator as ac, SourceRange as ad, HyperlinkProjector as ae, FieldLinkProjector as af, StoryPageFieldNeeds as ag, HyperlinkFieldSpec as ah, SpanLinkRecord as ai, PageGeometry as aj, SectionColumns as ak, SectionPageBorders as al, PageBorderFrameRecord as am, ParagraphBorderStrokeRecord as an, StrikeoutStrokePt as ao, AbstractNumDefinition as aq, AnchoredDrawingLayoutFallback as ar, BidiEmbeddingLevels as as, BorderGridGeometry as at, CascadedParagraphFormatting as au, CjkTypographySettings as av, ContentControlGeometryFragment as aw, ContentControlLevel as ax, ContentControlMappedType as ay, ContentControlModelRange as az, RevisionDisplayMode as b, SemanticArtifactRootStoryKind as b$, FontResourceInstrumentation as b0, FontResourceSnapshotOptions as b1, FontSlot as b2, FontValidationResult as b3, GlyphOutline as b4, GroupTextboxStoryRecord as b5, LevelOverride as b9, PageRefFieldProjection as bA, ParagraphAutoSpacingContext as bB, ParagraphBorderEdge as bC, ParagraphBorderSide as bD, ParagraphBorders as bE, ParagraphBottomBorderRecord as bF, ParagraphIndent as bG, ParagraphLayoutInputs as bH, ParagraphLineSpacing as bI, ParagraphSpacing as bJ, RefFieldSpec as bK, RefNoteParts as bL, ResolvedCellBorders as bM, ResolvedPictureBullet as bN, ResolvedTabStops as bO, ResolvedTableBorderEdge as bP, ResolvedTableBorderEdgeSegment as bQ, ResolvedUnderline as bR, RevisionFilter as bS, RevisionKind as bT, ScriptItem as bV, SectionBreakMarkRecord as bW, SectionBreakType as bX, SectionColumnDefinition as bY, SectionMargins as bZ, SectionPageNumbering as b_, LineSpacingRule as ba, ListMarkerAlign as bb, ListMarkerRecord as bc, ListSuffix as bd, NumDefinition as bp, NumberingLevelIndent as bq, NumberingPictureBullet as br, PageBorderDisplay as bu, PageBorderOffsetFrom as bv, PageBorderSide as bw, PageBorderStrokeRecord as bx, PageBorderZOrder as by, PageRefCalibrationCell as bz, PageRecord as c, SemanticArtifactStoryKind as c0, SemanticCommentArtifactRecord as c1, SemanticReviewArtifactOccurrence as c2, SemanticReviewArtifactOccurrenceGeometry as c3, SemanticReviewArtifactPosition as c4, SemanticReviewArtifactSource as c5, SemanticTrackedChangeArtifactRecord as c6, ShapeInput as c7, ShapedCluster as c8, ShapedFontSpan as c9, ShapedGlyph as ca, ShapedRunComparatorInputs as cb, ShapedVerticalMetrics as cc, ShapingContext as cd, ShapingEnvironment as ce, ShapingEnvironmentFingerprintInputs as cf, StyleDefinition as cg, TabAlignment as ci, TabDestination as cj, TabLeader as ck, TabStop as cl, TableBorderSideName as cm, TableBorderStrokeRecord as cn, TableFragmentRecord as co, TextDirection as cp, TextboxStoryFallbackReason as cq, TextboxStoryLayout as cr, VerticalAlign as ct, LayoutBox as d, NoteStoryRecord as e, ContentControlLock as f, StyleSpanRecord as g, TableRowFragmentRecord as h, TableCellFragmentRecord as i, ShapingEnvironmentInput as j, TextShaper as k, ResolvedRunStyle as l, ResolvedFont as m, NormalizationPolicy as n, FixedPointRoundingMode as o, FontRequest as p, ResolvedRevisionMarkup as q, SemanticReviewArtifactRecord as r, ListMarkerPictureRecord as s, RevisionMarkupOptions as t, FontSubstitution as u, ShapedRun as v, RevisionChangedLinesMark as x, RevisionDeletionMark as y, RevisionMarkupChromeHandlers as z };
+export { DEFAULT_REVISION_MARKUP as D, resolveRevisionMarkup as Q, FontResolutionError as a$, DEFAULT_PAGE_GEOMETRY as aB, DEFAULT_REVISION_DISPLAY_MODE as aC, DEFAULT_RUN_STYLE as aD, DEFAULT_SECTION_PROPERTIES as aE, DEFAULT_TAB_INTERVAL_PT as aF, DEFAULT_TAB_INTERVAL_TWIPS as aG, EMPTY_NUMBERING_INDEX as aO, EMPTY_TAB_STOPS as aP, AUTO_PARAGRAPH_SPACING_PT as aq, HARD_MAX_AGGREGATE_FONT_BYTES as b8, HARD_MAX_FONT_BYTES as b9, SINGLE_LINE_SPACING as bV, HARD_MAX_FONT_SOURCES as ba, MAX_BORDER_SPACE_PT as bg, MAX_BORDER_WIDTH_PT as bh, MAX_DOCUMENT_SECTIONS as bi, MAX_LVL_OVERRIDES as bj, MAX_NUMBERING_DEFINITIONS as bk, MAX_PARAGRAPH_SPACING_PT as bl, MAX_SHAPING_CONTEXT as bm, MAX_STYLE_DEFINITIONS as bn, MAX_TABLE_BORDER_STROKES as bo, MAX_TAB_POSITION_TWIPS as bp, MAX_TAB_STOPS as bq, PAGE_BORDER_SIDES as bt, PARAGRAPH_BORDER_SIDES as bu, markRevisionRemovesMark as c$, borderExtentPt as cA, borderWeight as cB, bottomBorderExtentPt as cC, boundedStructuralFontValidator as cD, buildNumberingIndex as cE, buildStyleCascadeTable as cF, cascadeParagraphFormatting as cG, cascadeRunProperties as cH, cascadedBottomBorder as cI, cascadedParagraphBorders as cJ, cascadedTabStops as cK, collapsedSpaceBefore as cL, createFontResourceSnapshot as cM, createShapedRun as cN, createShapingEnvironment as cO, defaultTabIntervalFromSettings as cP, displayText as cQ, enumerateDocumentSections as cR, enumerateDocumentSectionsBounded as cS, fixedPoint as cT, fontRequestKey as cU, formatRevisionOf as cV, geometryOfSection as cW, glyphSizeFactorOf as cX, isValidStyleId as cY, itemizeScriptFontSlots as cZ, layoutEquation as c_, TAB_LEADER_GLYPH as ci, UnsupportedScriptError as cv, appliedSpaceBefore as cx, applyLineSpacing as cy, baselineShiftPtOf as cz, measureDisplayText as d0, nextTabDestination as d1, pageBordersFingerprint as d2, paragraphBorderExtentPt as d3, paragraphBorderStrokeWidthPt as d4, paragraphBorders as d5, paragraphBordersFingerprint as d6, paragraphBreaksBefore as d7, paragraphContextualSpacing as d8, paragraphLineSpacing as d9, revisionsVisible as dA, runStylesEqual as dB, shapedRunComparatorInputs as dC, shapingEnvironmentFingerprint as dD, shapingEnvironmentFingerprintInputs as dE, shownMarkRevision as dF, styleForFontSlot as dG, tabAdvanceWidth as dH, tabStopsFingerprint as dI, withDefaultTabInterval as dJ, withNumberingStyleLinks as dK, withResolvedListItems as dL, paragraphMarkFormatRevisionOf as da, paragraphMarkRevisionOf as db, paragraphMarkRevisionsOf as dc, paragraphSectionNode as dd, paragraphSpacing as de, paragraphTabStops as df, parsePageBorders as dg, parsePageNumbering as dh, parseRefInstruction as di, parseSectionProperties as dj, projectedSectionSourceIndexes as dk, readBorderSide as dl, readCellBorders as dm, readNumPr as dn, readSectionProperties as dp, readTableBorders as dq, resolveBorderConflict as dr, resolveNumberingLevel as ds, resolveParagraphLayoutInputs as dt, resolveRunStyle as du, resolveStoryListItems as dv, resolveStoryRefFields as dw, resolveTableCellBorderGrid as dx, revisionAuthorFilter as dy, revisionsAreDeletion as dz, REVISION_MARKUP_COLORS as w };
+export type { TableBorderSide as $, AnchoredDrawingRecord as A, BlockFragmentRecord as B, ContentControlBoundaryRecord as C, RevisionMarkupColor as E, FontResourceSnapshot as F, RevisionMarkupMark as G, HeaderFooterStoryRecord as H, InlineDrawingRecord as I, RevisionMarkupNamedColor as J, RevisionMarkupStyle as K, LineRecord as L, RevisionMarkupTextStyle as M, NoteAreaRecord as N, SectionProperties as O, ParagraphFragmentRecord as P, RevisionMarkupDialogSession as R, SemanticLayout as S, TextMeasurer as T, NumberingLevel as U, VersionedShapingLibrary as V, NumberingIndex as W, DrawingPoint as X, DrawingInsets as Y, ModelRange as Z, RevisionAttribution as _, ReviewDisplayMode as a, TableFloatXSpec as a0, TableFloatYSpec as a1, NumberingLevelIndent as a2, ResolvedListItem as a3, RefFieldContext as a4, InlineDrawingLayoutContext as a5, CellBorderBox as a6, TableBorderBox as a7, TableCellStyleFormatting as a8, TableFloatPosition as a9, ContentControlModelRange as aA, DeclaredFontSubstitution as aH, DocumentSection as aI, DocumentSectionsEnumeration as aJ, DrawingClipFallback as aK, DrawingGeometry as aL, DrawingGroupPictureRecord as aM, DrawingTextArtRecord as aN, EquationBarGeometry as aQ, EquationFractionGeometry as aR, EquationGeometry as aS, EquationNaryGeometry as aT, EquationRadicalGeometry as aU, EquationRowGeometry as aV, EquationScriptGeometry as aW, EquationSpanRecord as aX, EquationTextGeometry as aY, FieldAtomMarker as aZ, FontFingerprintInputs as a_, StyleCascadeTable as aa, RevisionAuthorFilter as ab, FixedPoint as ac, FontByteValidator as ad, SourceRange as ae, HyperlinkProjector as af, FieldLinkProjector as ag, StoryPageFieldNeeds as ah, HyperlinkFieldSpec as ai, SpanLinkRecord as aj, PageGeometry as ak, SectionColumns as al, SectionPageBorders as am, PageBorderFrameRecord as an, ParagraphBorderStrokeRecord as ao, StrikeoutStrokePt as ap, AbstractNumDefinition as ar, AnchoredDrawingLayoutFallback as as, BidiEmbeddingLevels as at, BorderGridGeometry as au, CascadedParagraphFormatting as av, CjkTypographySettings as aw, ContentControlGeometryFragment as ax, ContentControlLevel as ay, ContentControlMappedType as az, RevisionDisplayMode as b, SectionPageNumbering as b$, FontResolutionErrorCode as b0, FontResourceDefinition as b1, FontResourceInstrumentation as b2, FontResourceSnapshotOptions as b3, FontSlot as b4, FontValidationResult as b5, GlyphOutline as b6, GroupTextboxStoryRecord as b7, PageRefCalibrationCell as bA, PageRefFieldProjection as bB, ParagraphAutoSpacingContext as bC, ParagraphBorderEdge as bD, ParagraphBorderSide as bE, ParagraphBorders as bF, ParagraphBottomBorderRecord as bG, ParagraphIndent as bH, ParagraphLayoutInputs as bI, ParagraphLineSpacing as bJ, ParagraphSpacing as bK, RefFieldSpec as bL, RefNoteParts as bM, ResolvedCellBorders as bN, ResolvedPictureBullet as bO, ResolvedTabStops as bP, ResolvedTableBorderEdge as bQ, ResolvedTableBorderEdgeSegment as bR, ResolvedUnderline as bS, RevisionFilter as bT, RevisionKind as bU, ScriptItem as bW, SectionBreakMarkRecord as bX, SectionBreakType as bY, SectionColumnDefinition as bZ, SectionMargins as b_, LevelOverride as bb, LineSpacingRule as bc, ListMarkerAlign as bd, ListMarkerRecord as be, ListSuffix as bf, NumDefinition as br, NumberingPictureBullet as bs, PageBorderDisplay as bv, PageBorderOffsetFrom as bw, PageBorderSide as bx, PageBorderStrokeRecord as by, PageBorderZOrder as bz, PageRecord as c, SemanticArtifactRootStoryKind as c0, SemanticArtifactStoryKind as c1, SemanticCommentArtifactRecord as c2, SemanticReviewArtifactOccurrence as c3, SemanticReviewArtifactOccurrenceGeometry as c4, SemanticReviewArtifactPosition as c5, SemanticReviewArtifactSource as c6, SemanticTrackedChangeArtifactRecord as c7, ShapeInput as c8, ShapedCluster as c9, ShapedFontSpan as ca, ShapedGlyph as cb, ShapedRunComparatorInputs as cc, ShapedVerticalMetrics as cd, ShapingContext as ce, ShapingEnvironment as cf, ShapingEnvironmentFingerprintInputs as cg, StyleDefinition as ch, TabAlignment as cj, TabDestination as ck, TabLeader as cl, TabStop as cm, TableBorderSideName as cn, TableBorderStrokeRecord as co, TableFragmentRecord as cp, TextArtFit as cq, TextDirection as cr, TextOutline as cs, TextboxStoryFallbackReason as ct, TextboxStoryLayout as cu, VerticalAlign as cw, LayoutBox as d, NoteStoryRecord as e, ContentControlLock as f, StyleSpanRecord as g, TableRowFragmentRecord as h, TableCellFragmentRecord as i, ShapingEnvironmentInput as j, TextShaper as k, ResolvedRunStyle as l, ResolvedFont as m, NormalizationPolicy as n, FixedPointRoundingMode as o, FontRequest as p, ResolvedRevisionMarkup as q, SemanticReviewArtifactRecord as r, ListMarkerPictureRecord as s, RevisionMarkupOptions as t, FontSubstitution as u, ShapedRun as v, RevisionChangedLinesMark as x, RevisionDeletionMark as y, RevisionMarkupChromeHandlers as z };