@silurus/ooxml 0.75.3 → 0.75.5

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-//#region dist/.types-work/mathjax-BO1uUSCW.d.ts
+//#region dist/.types-work/mathjax-Cp9KrvN5.d.ts
 //#region packages/core/src/math/mathjax.d.ts
 interface MathSvg {
     /** standalone `<svg>…</svg>` markup. */
@@ -29,7 +29,7 @@ interface MathRenderer {
     mathMLToSvg(mathml: string): Promise<MathSvg>;
 }
 //#endregion
-//#region dist/.types-work/hyperlink-CHHEOeCL.d.ts
+//#region dist/.types-work/hyperlink-DTGUpBI3.d.ts
 //#region packages/core/src/types/math.d.ts
 type MathStyle = 'roman' | 'italic' | 'bold' | 'boldItalic';
 interface MathRun {
@@ -180,182 +180,654 @@ interface Duotone$1 {
     clr2: string;
 }
 //#endregion
-//#region packages/core/src/types/chart.d.ts
-interface ChartSeries {
-    name: string;
-    /** Hex without '#'. null = fall back to palette. */
-    color: string | null;
-    /** Numeric values; null = missing data point. */
-    values: (number | null)[];
+//#region packages/core/src/types/common.d.ts
+type PathCmd$2 = {
+    cmd: 'moveTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'lineTo';
+    x: number;
+    y: number;
+} | {
+    cmd: 'cubicBezTo';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    cmd: 'arcTo';
+    wr: number;
+    hr: number;
+    stAng: number;
+    swAng: number;
+} | {
+    cmd: 'close';
+};
+type Fill = SolidFill | NoFill | GradientFill | PatternFill | ImageFill;
+interface SolidFill {
+    fillType: 'solid';
+    color: string;
+}
+interface NoFill {
+    fillType: 'none';
+}
+interface GradientStop$1 {
+    position: number;
+    color: string;
+}
+interface GradientFill {
+    fillType: 'gradient';
+    stops: GradientStop$1[];
+    /** degrees: 0 = left→right, 90 = top→bottom */
+    angle: number;
+    /** 'linear' | 'radial' */
+    gradType: string;
+}
+/**
+ * Preset pattern fill — ECMA-376 §20.1.8.40 (CT_PatternFillProperties)
+ * with `preset` drawn from §20.1.10.59 (ST_PresetPatternVal).
+ */
+interface PatternFill {
+    fillType: 'pattern';
+    /** Foreground hex colour — used for the "1" pixels of the preset bitmap. */
+    fg: string;
+    /** Background hex colour — used for the "0" pixels. */
+    bg: string;
+    /** Preset name, e.g. "pct25", "horz", "diagCross", "lgGrid". */
+    preset: string;
+}
+/**
+ * ECMA-376 §20.1.8.30 (CT_RelativeRect) — the destination rectangle a stretched
+ * blip is mapped into, as edge insets relative to the fill region. Values are
+ * fractions (ST_Percentage / 100000); **negative values let the image bleed
+ * past the box (overscan)**. Absent edges default to 0.
+ */
+interface FillRect {
+    l?: number;
+    t?: number;
+    r?: number;
+    b?: number;
+}
+/**
+ * ECMA-376 §20.1.8.58 (CT_TileInfoProperties) — tiled blip-fill placement.
+ * The blip repeats at its native size (scaled by sx/sy) across the fill box.
+ * Mutually exclusive with {@link ImageFill.fillRect} (the `stretch` mode).
+ */
+interface TileInfo {
+    /** Horizontal offset of the first tile, in EMU (`tx`). Default 0. */
+    tx: number;
+    /** Vertical offset of the first tile, in EMU (`ty`). Default 0. */
+    ty: number;
+    /** Horizontal tile scale as a fraction (`sx` / 100000). Default 1.0. */
+    sx: number;
+    /** Vertical tile scale as a fraction (`sy` / 100000). Default 1.0. */
+    sy: number;
+    /** Mirror mode: `'none' | 'x' | 'y' | 'xy'` (`flip`). Default `'none'`. */
+    flip: string;
     /**
-     * Per-data-point colors (pie / doughnut). Hex without '#'. null inside the
-     * array = use palette for that slice. Omit entirely for non-pie series.
+     * Anchor corner the tile grid registers against:
+     * `tl|t|tr|l|ctr|r|bl|b|br` (`algn`). The schema has no default; a host may
+     * apply a compatibility fallback when omitted.
      */
-    dataPointColors?: (string | null)[] | null;
+    algn?: string;
+}
+/**
+ * Image fill — ECMA-376 §20.1.8.14 (CT_BlipFillProperties). The embedded blip
+ * is carried as a zip path + MIME; the renderer fetches the bytes on demand via
+ * {@link RenderOptions.fetchImage} (no base64 inlined at parse time). Both
+ * fill-modes are modelled and mutually exclusive: `stretch` (§20.1.8.56) carries
+ * {@link ImageFill.fillRect}; `tile` (§20.1.8.58) carries {@link ImageFill.tile}.
+ */
+interface ImageFill {
+    fillType: 'image';
     /**
-     * Per-data-point data-label text colors. Used by chartEx (`<cx:dataLabel idx>`)
-     * to override label colour per bar — sample-2's waterfall paints negative
-     * △ values in red while positive values stay black. Null inside the array =
-     * fall back to the chart-level `dataLabelFontColor`.
+     * Embedded zip path of the blip (e.g. "word/media/image1.png"), for the lazy
+     * byte-on-demand pipeline. The renderer fetches the bytes via a path-keyed
+     * loader ({@link RenderOptions.fetchImage}) instead of inlining base64.
      */
-    dataLabelColors?: (string | null)[] | null;
+    imagePath: string;
+    /** MIME type of the blip at {@link ImageFill.imagePath} (e.g. `image/png`). */
+    mimeType: string;
     /**
-     * Series-level data-label text colour (`<c:ser><c:dLbls><c:txPr>…solidFill`,
-     * ECMA-376 §21.2.2.216). Hex without '#'. Stacked-bar charts colour each
-     * segment's label independently (e.g. white on the dark segment, black on
-     * the light one), which a single chart-level `dataLabelFontColor` can't
-     * express. Takes precedence over `dataLabelFontColor`; null = no override.
+     * `<a:stretch><a:fillRect>` insets. Absent → fills the whole box (or the
+     * fill is tiled — see {@link ImageFill.tile}).
      */
-    labelColor?: string | null;
+    fillRect?: FillRect;
     /**
-     * Mixed chart: per-series chart type override. Currently only "line" (XLSX
-     * and PPTX combo charts) is honoured; other values are treated as the
-     * chart's primary type.
+     * `<a:tile>` descriptor. Present only when the blipFill is tiled; mutually
+     * exclusive with {@link ImageFill.fillRect}.
      */
-    seriesType?: string | null;
+    tile?: TileInfo;
+    /** `a:blip > a:alphaModFix@amt` as a fraction (0.0–1.0). Absent = opaque. */
+    alpha?: number;
     /**
-     * Combo chart: this series is plotted against the SECONDARY value axis
-     * (`ChartModel.secondaryValAxis`) — the `<c:valAx>` with `axPos="r"` /
-     * `<c:crosses val="max">`. When false/absent the series uses the primary
-     * (left) value-axis scale. PowerPoint's "Revenue vs. gross margin" combo
-     * (sample-14 slide-8) puts the margin line on a 0–100% secondary axis.
+     * ECMA-376 §20.1.8.23 `<a:duotone>` recolour, resolved to its two endpoint
+     * colours (through the slide theme). Absent ⇒ no duotone. When present the
+     * renderer maps the blip's luminance ramp between the two colours (core
+     * `applyDuotone`) — the same recolour a `<p:pic>` duotone applies, wired onto
+     * the picture-FILL path (§20.1.8.14) by issue #889.
      */
-    useSecondaryAxis?: boolean | null;
+    duotone?: Duotone$1;
+}
+interface Shadow {
+    color: string;
+    alpha: number;
+    blur: number;
+    dist: number;
+    /** degrees clockwise from East */
+    dir: number;
+}
+/** ECMA-376 §20.1.8.17 (CT_GlowEffect) — coloured halo with blur radius. */
+interface Glow {
+    color: string;
+    alpha: number;
+    /** Blur radius in EMU. */
+    radius: number;
+}
+/** ECMA-376 §20.1.8.31 (CT_SoftEdgesEffect) — feather radius in EMU. */
+interface SoftEdge {
+    radius: number;
+}
+/** ECMA-376 §20.1.8.27 (CT_ReflectionEffect) — mirrored copy below the
+ *  shape with a linear alpha gradient. Carries the spec attributes whose
+ *  defaults the renderer needs to interpret correctly. */
+interface Reflection {
+    blur: number;
+    dist: number;
+    /** Direction in degrees, clockwise from East. */
+    dir: number;
+    /** Start alpha (0–1). Default 1.0. */
+    stA: number;
+    /** Start position along the gradient (0–1). Default 0. */
+    stPos: number;
+    /** End alpha. Default 0. */
+    endA: number;
+    /** End position. Default 1.0. */
+    endPos: number;
+    /** Horizontal scale (1.0 = same width). */
+    sx: number;
+    /** Vertical scale (-1.0 = full mirror). */
+    sy: number;
+}
+interface ArrowEnd {
+    /** OOXML type: "none" | "triangle" | "stealth" | "diamond" | "oval" | "arrow" */
+    type: string;
+    /** Width multiplier: "sm" | "med" | "lg" */
+    w: string;
+    /** Length multiplier: "sm" | "med" | "lg" */
+    len: string;
+}
+interface Stroke {
+    color: string;
+    /** Width in EMU */
+    width: number;
+    /** Authored non-solid DrawingML line paint. Solid lines use `color`. */
+    fill?: Exclude<Fill, {
+        fillType: 'image';
+    } | {
+        fillType: 'none';
+    }>;
+    /** OOXML prstDash value: "dash", "dot", "dashDot", "lgDash", "lgDashDot", etc. */
+    dashStyle?: string;
+    /** Canvas line cap normalized from DrawingML/VML (`flat` → `butt`). */
+    lineCap?: CanvasLineCap;
+    /** Arrow head at the start of the line */
+    headEnd?: ArrowEnd;
+    /** Arrow head at the end of the line */
+    tailEnd?: ArrowEnd;
     /**
-     * Scatter-only X values (as strings). When null the series uses
-     * `ChartModel.categories` as X.
+     * ECMA-376 §20.1.8.42 ST_CompoundLine. "sng" (default) | "dbl" |
+     * "thinThick" | "thickThin" | "tri". Absent means single line.
      */
-    categories?: string[] | null;
+    cmpd?: string;
+}
+interface TextBody$1 {
+    /** Vertical anchor: "t" | "ctr" | "b" */
+    verticalAnchor: string;
+    paragraphs: Paragraph$1[];
+    /** Default pt size from lstStyle (overrides renderer default when present) */
+    defaultFontSize: number | null;
+    /** Inherited bold from layout/master defRPr (null = not set, use false as final default) */
+    defaultBold: boolean | null;
+    /** Inherited italic from layout/master defRPr (null = not set, use false as final default) */
+    defaultItalic: boolean | null;
+    /** Text insets in EMU (defaults: lIns=rIns=91440, tIns=bIns=45720) */
+    lIns: number;
+    rIns: number;
+    tIns: number;
+    bIns: number;
+    /** "square" = wrap, "none" = no wrap */
+    wrap: string;
+    /** Text direction: "horz" | "vert" | "vert270" | "eaVert" etc. */
+    vert: string;
+    /** Auto-fit: "sp" = shape grows to fit text, "norm" = font shrinks, "none" = no fit */
+    autoFit: string;
     /**
-     * Resolved marker visibility for line/scatter series. ECMA-376 §21.2.2.32
-     * `<c:marker><c:symbol>` defaults to "none" for line charts unless the
-     * chart-level `<c:marker val="1"/>` or a per-series symbol opts in. When
-     * undefined/null the renderer uses its own default (visible) so callers
-     * that don't parse markers (e.g. pptx today) keep their existing behavior.
+     * `<a:normAutofit fontScale>` (ECMA-376 §21.1.2.1.3) — PowerPoint's stored,
+     * pre-computed font-shrink ratio for `autoFit === "norm"`, as a fraction
+     * (e.g. 0.625 for `fontScale="62500"`). Null/absent when PowerPoint stored no
+     * scale; the renderer then re-derives one. Applying the stored value matches
+     * PowerPoint exactly instead of guessing from our own text metrics.
      */
-    showMarker?: boolean | null;
-    /**
-     * Excel number-format code for this series' values (ECMA-376 §21.2.2.37,
-     * `<c:val>/<c:numRef>/<c:formatCode>`). Used to format data labels when the
-     * chart-level `<c:dLbls><c:numFmt>` is not set. null = no series-level code.
+    fontScale?: number | null;
+    /** `<a:normAutofit lnSpcReduction>` — stored line-spacing reduction fraction
+     *  (e.g. 0.20 for `lnSpcReduction="20000"`). Null/absent when not stored. */
+    lnSpcReduction?: number | null;
+    /**
+     * `<a:bodyPr numCol>` (ECMA-376 §20.1.10.34) — number of text columns inside
+     * the shape. Defaults to 1; values > 1 cause the renderer to flow paragraphs
+     * across N columns left-to-right, top-to-bottom.
      */
-    valFormatCode?: string | null;
+    numCol?: number;
+    /** `<a:bodyPr spcCol>` — gap between columns in EMU. Default 0. */
+    spcCol?: number;
+}
+type SpaceLine = {
+    type: 'pct';
+    val: number;
+} | {
+    type: 'pts';
+    val: number;
+};
+/**
+ * A paragraph's bullet marker. For `char`, the marker size is EITHER `sizePct`
+ * (a percentage of the run size — ECMA-376 §21.1.2.4.9 `<a:buSzPct>`) OR `sizePts`
+ * (an absolute size in points — §21.1.2.4.10 `<a:buSzPts>`), never both: they are
+ * the one `EG_TextBulletSize` xsd:choice. `sizePts` is optional (absent when no
+ * `<a:buSzPts>` was declared); when present it takes precedence over `sizePct`.
+ */
+type Bullet$1 = {
+    type: 'none';
+} | {
+    type: 'inherit';
+} | {
+    type: 'char';
+    char: string;
+    color: string | null;
+    sizePct: number | null;
+    sizePts?: number;
+    fontFamily: string | null;
+} | {
+    type: 'autoNum';
+    numType: string;
+    startAt: number | null;
+    color: string | null;
+};
+interface TabStop$1 {
+    /** Position in EMU from the LEADING text-inset edge of the text area —
+     *  logical, not physical (ECMA-376 §21.1.2.1): the left edge (after lIns)
+     *  in an LTR paragraph, the right edge (before rIns) in an RTL
+     *  (`<a:pPr rtl="1">`) paragraph. */
+    pos: number;
+    /** Alignment: "l" | "r" | "ctr" | "dec" */
+    algn: string;
+}
+interface Paragraph$1 {
+    /** Alignment: "l" | "ctr" | "r" | "just" */
+    alignment: string;
+    /** Left margin in EMU */
+    marL: number;
+    /** Right margin in EMU */
+    marR: number;
+    /** First-line indent in EMU (negative = hanging indent) */
+    indent: number;
+    spaceBefore: number | null;
+    spaceAfter: number | null;
+    spaceLine: SpaceLine | null;
+    /** List nesting level (0–8) */
+    lvl: number;
+    bullet: Bullet$1;
+    defFontSize: number | null;
+    defColor: string | null;
+    defBold: boolean | null;
+    defItalic: boolean | null;
+    defFontFamily: string | null;
+    /** Tab stops from pPr > tabLst */
+    tabStops: TabStop$1[];
     /**
-     * `<c:marker><c:symbol val>` (ECMA-376 §21.2.2.32) — point marker shape.
-     * One of "circle"|"square"|"diamond"|"triangle"|"x"|"plus"|"star"|
-     * "dot"|"dash"|"picture"|"none". null = renderer default (circle when
-     * showMarker is true).
+     * `<a:pPr rtl="1">` — right-to-left paragraph (ECMA-376 §21.1.2.2.7).
+     * When true and no explicit `algn`, the parser-side default flips from
+     * "l" to "r"; renderers can also use this flag to flow runs RTL.
      */
-    markerSymbol?: string | null;
+    rtl?: boolean;
+    runs: TextRun[];
+}
+type TextRun = TextRunData | LineBreak | EquationRun;
+/**
+ * An OMML equation embedded in a paragraph (ECMA-376 §22.1). Parsed into the
+ * shared math AST and rendered by `@silurus/ooxml-core`'s math engine.
+ * PowerPoint stores these as `a14:m` inside `mc:AlternateContent`.
+ */
+interface EquationRun {
+    type: 'math';
+    /** Parsed OMML node list. */
+    nodes: MathNode[];
+    /** True for block (`m:oMathPara`) math, false for inline (`m:oMath`). */
+    display: boolean;
+    /** Paragraph default run size in pt, if declared; absent → renderer inherits. */
+    fontSize?: number | null;
+    /** Equation colour (hex, no '#') from the math run's rPr; absent → inherit. */
+    color?: string | null;
+}
+interface TextRunData {
+    type: 'text';
+    text: string;
+    /** null = not set, inherit from paragraph/body defaults */
+    bold: boolean | null;
+    /** null = not set, inherit from paragraph/body defaults */
+    italic: boolean | null;
+    underline: boolean;
     /**
-     * `<c:marker><c:size val>` (ECMA-376 §21.2.2.34) — marker side length in
-     * points. null = renderer default (~5 pt).
+     * Specific underline style when not the default single line. Values come
+     * from ECMA-376 §21.1.2.3.16 (ST_TextUnderlineType): "dbl", "heavy",
+     * "dotted", "dottedHeavy", "dash", "dashHeavy", "dashLong",
+     * "dashLongHeavy", "dotDash", "dotDashHeavy", "dotDotDash",
+     * "dotDotDashHeavy", "wavy", "wavyHeavy", "wavyDbl". Absent means either
+     * no underline (when `underline` is false) or the default single line.
      */
-    markerSize?: number | null;
-    /** `<c:marker><c:spPr><a:solidFill>` resolved hex (no `#`). */
-    markerFill?: string | null;
-    /** `<c:marker><c:spPr><a:ln><a:solidFill>` resolved hex (no `#`). */
-    markerLine?: string | null;
+    underlineStyle?: string;
     /**
-     * Per-data-point overrides (ECMA-376 §21.2.2.39 `<c:dPt>`). Keyed by point
-     * index. Any unset field falls back to the series-level value.
+     * Underline-only colour from rPr > uFill (ECMA-376 §21.1.2.3.20). Absent
+     * means the underline follows the text colour (uFillTx default).
      */
-    dataPointOverrides?: ChartDataPointOverride[] | null;
+    underlineColor?: string;
+    /** True when rPr strike is sngStrike or dblStrike. */
+    strikethrough: boolean;
     /**
-     * Per-data-point custom labels (ECMA-376 §21.2.2.45 `<c:dLbl idx>`).
-     * `text` is the resolved plain string — `<a:fld type="CELLRANGE">`
-     * placeholders are already substituted at parse time. An empty string
-     * means the point's label was deleted with `<c:delete val="1"/>` and
-     * the renderer should skip it.
+     * True only when rPr strike = "dblStrike". Lets the renderer draw two parallel
+     * lines instead of one. ECMA-376 §21.1.2.3.10 (ST_TextStrikeType).
      */
-    dataLabelOverrides?: ChartDataLabelOverride[] | null;
+    strikeDouble?: boolean;
+    /** Font size in points */
+    fontSize: number | null;
+    color: string | null;
+    fontFamily: string | null;
     /**
-     * Series-level `<c:dLbls>` block (showVal / showSerName / position).
-     * Applied to every point lacking its own `<c:dLbl>` override.
+     * East Asian font family from rPr > a:ea (ECMA-376 §21.1.2.3.7),
+     * resolved through the theme. Renderer uses this for CJK glyphs when
+     * present; absent means CJK falls back to fontFamily.
      */
-    seriesDataLabels?: ChartSeriesDataLabels | null;
+    fontFamilyEa?: string;
     /**
-     * `<c:errBars>` per-series error bars (ECMA-376 §21.2.2.20). Up to two
-     * (one per direction). Plus / minus deltas are absolute per-point values
-     * regardless of `errValType`.
+     * Symbol font family from rPr > a:sym (ECMA-376 §21.1.2.3.10), resolved
+     * through the theme. PowerPoint stores symbol-font glyphs as Private-Use
+     * codepoints U+F020–U+F0FF; the renderer uses this font to resolve them.
+     * Absent means no symbol font was declared.
      */
-    errBars?: ChartErrBars[] | null;
+    fontFamilySym?: string;
+    /** Baseline shift in thousandths of a point. Positive = superscript, negative = subscript. */
+    baseline?: number;
     /**
-     * `<c:bubbleSize>` per-point sizes for bubble charts (ECMA-376 §21.2.2.4).
-     * Drives marker radius — renderer treats the values as areas (radius
-     * scales by sqrt) so visual area is proportional to value, matching
-     * Excel. null / empty array = uniform marker size. Ignored for non-bubble
-     * series.
+     * Capitalisation transform — ECMA-376 §21.1.2.3.13 (ST_TextCapsType).
+     * 'all' renders text in upper case; 'small' uses small caps (rendered as
+     * upper case at ~80% size when no smcp font feature is available).
+     * 'none' or omitted leaves the text unchanged.
      */
-    bubbleSizes?: (number | null)[] | null;
+    caps?: 'none' | 'small' | 'all';
     /**
-     * `<c:ser><c:smooth val>` (ECMA-376 §21.2.2.194) — line/area series flag
-     * requesting a smoothed (spline) curve through the points instead of straight
-     * segments. Only consulted for the line and area families (scatter carries its
-     * smoothing in `ChartModel.scatterStyle`). null/undefined/false = straight
-     * polyline (the default; byte-stable for series that never set it).
+     * Inter-character spacing in 100ths of a point — ECMA-376 §21.1.2.3.5
+     * (rPr @spc). Positive values add space, negative values tighten.
      */
-    smooth?: boolean | null;
+    letterSpacing?: number;
+    /** Set for OOXML field runs (e.g. "slidenum"). When set, renderer replaces text with field value. */
+    fieldType?: string;
     /**
-     * `<c:ser><c:trendline>` per-series trendlines (ECMA-376 §21.2.2.211,
-     * `CT_Trendline`). A series can carry several (e.g. a linear fit + a moving
-     * average). null/undefined/empty = no trendline (the default; byte-stable for
-     * series that never declare one).
+     * Hyperlink target resolved from rPr > a:hlinkClick @r:id via the slide's _rels.
+     * For an external link this is the URL; for an internal slide jump it is the
+     * resolved internal part name (e.g. "../slides/slide3.xml"). Undefined for runs
+     * without a hyperlink. ECMA-376 §21.1.2.3.5 (CT_Hyperlink).
      */
-    trendLines?: ChartTrendline[] | null;
+    hyperlink?: string;
     /**
-     * `<c:ser><c:spPr><a:ln><a:noFill/>` (ECMA-376 §21.2.2.198 CT_ShapeProperties
-     * → DrawingML §20.1.2.2.24 CT_LineProperties). true when the series connecting
-     * line is explicitly turned OFF. For a scatter/line series this OVERRIDES the
-     * chart-group `<c:scatterStyle>` (§21.2.2.42) / line default — Excel and
-     * PowerPoint draw markers only (no connecting line) even when the group style
-     * is `lineMarker`. null/undefined = no explicit line-off, so the group default
-     * governs (byte-stable for series that carry a paintable line).
+     * Raw `<a:hlinkClick @action>` string (e.g. "ppaction://hlinksldjump") when
+     * present — its presence marks {@link hyperlink} as an INTERNAL PowerPoint
+     * action (slide jump / first / last …) rather than an external URL. Undefined
+     * when the hlinkClick has no @action. ECMA-376 §21.1.2.3.5. (IX1)
      */
-    lineHidden?: boolean | null;
-}
-/**
- * `<c:ser><c:trendline>` (ECMA-376 §21.2.2.211). A regression/smoothing curve
- * fitted to the series' data points.
- */
-interface ChartTrendline {
+    hyperlinkAction?: string;
     /**
-     * `<c:trendlineType val>` (§21.2.2.213, `ST_TrendlineType` §21.2.3.50):
-     * "linear" | "exp" | "log" | "power" | "poly" | "movingAvg". The renderer
-     * currently draws "linear" (least squares) and "movingAvg"; other types parse
-     * but are not yet plotted (tracked as a follow-up).
+     * Run-level drop shadow on glyphs (`<a:rPr><a:effectLst><a:outerShdw>`),
+     * ECMA-376 §20.1.8.45. Independent of the shape-level shadow on `spPr`.
+     * Absent means no run-level shadow.
      */
-    trendlineType: string;
-    /** `<c:order val>` — polynomial order (`poly`, default 2). */
-    order?: number | null;
-    /** `<c:period val>` — moving-average window (`movingAvg`, default 2). */
-    period?: number | null;
-    /** `<c:forward val>` — units to extend the line past the last point. */
-    forward?: number | null;
-    /** `<c:backward val>` — units to extend the line before the first point. */
-    backward?: number | null;
-    /** `<c:intercept val>` — forced y-intercept (linear/exp). null = free fit. */
-    intercept?: number | null;
-    /** `<c:dispRSqr val="1">` — show the R² value (label; not yet rendered). */
-    dispRSqr?: boolean | null;
-    /** `<c:dispEq val="1">` — show the fit equation (label; not yet rendered). */
-    dispEq?: boolean | null;
-    /** `<c:spPr><a:ln><a:solidFill>` trendline color (hex without '#'). null =
-     *  inherit the series color. */
-    lineColor?: string | null;
-    /** `<c:spPr><a:ln w>` trendline width in EMU. */
-    lineWidthEmu?: number | null;
-}
-interface ChartDataPointOverride {
-    idx: number;
-    /** Resolved fill hex (no `#`). */
-    color?: string;
-    markerSymbol?: string;
-    markerSize?: number;
-    markerFill?: string;
-    markerLine?: string;
+    shadow?: Shadow;
     /**
-     * `<c:dPt><c:explosion val>` (ECMA-376 §21.2.2.61) — the amount this
+     * Run-level glyph outline (`<a:rPr><a:ln w="..">`), ECMA-376 §20.1.2.2.24
+     * (CT_TextOutlineEffect). Renderer strokes each glyph with the given
+     * width / colour in addition to the normal fill. Absent means glyphs are
+     * fill-only.
+     */
+    outline?: TextOutline;
+    /**
+     * Run-level text highlight / marker colour (`<a:rPr><a:highlight>`),
+     * ECMA-376 §21.1.2.3.4. In DrawingML this is a full CT_Color (any
+     * srgbClr / schemeClr / sysClr / prstClr + transforms), unlike
+     * WordprocessingML's fixed 16-name highlight enum — so the parser already
+     * resolves it through the theme/clrMap. The value is a hex string without
+     * `#` (6-char opaque, or 8-char RRGGBBAA when an alpha transform applies);
+     * the renderer paints a background rectangle behind the run's glyphs.
+     * Absent means no highlight.
+     */
+    highlight?: string;
+}
+/** Run-level glyph outline. Width is in OOXML EMU (12700 EMU = 1 pt). */
+interface TextOutline {
+    width: number;
+    /** Hex without '#'. Absent = inherit from text fill colour. */
+    color?: string;
+}
+interface LineBreak {
+    type: 'break';
+}
+interface RenderOptions {
+    width?: number;
+    defaultTextColor?: string | null;
+    dpr?: number;
+    majorFont?: string | null;
+    minorFont?: string | null;
+    /** Theme hyperlink colour (hex 6 chars). Used to colour hyperlink runs without an explicit colour. */
+    hlinkColor?: string | null;
+    /**
+     * Lazily resolve an archive-internal asset (by zip path) to a Blob. The
+     * renderer uses this to fetch posters and other large embedded assets on
+     * demand, keeping the parse output free of inlined base64.
+     */
+    fetchMedia?: (path: string) => Promise<Blob>;
+    /**
+     * Lazily resolve an embedded image (by zip path + MIME) to a Blob. Twin of
+     * {@link RenderOptions.fetchMedia} for pictures and blip fills: the renderer
+     * fetches raster/SVG bytes on demand and decodes them (`createImageBitmap` /
+     * path-keyed `<img>`), so the parse output carries only paths, never base64.
+     */
+    fetchImage?: (path: string, mimeType: string) => Promise<Blob>;
+    /**
+     * When true, renderMedia draws only the poster frame — play/pause badges
+     * and progress bars are left to the caller. Set by the pptx presentSlide
+     * API so its interactive handle can own all control chrome without
+     * the static renderer drawing a duplicate play badge.
+     */
+    skipMediaControls?: boolean;
+}
+//#endregion
+//#region packages/core/src/types/chart.d.ts
+interface ChartSeries {
+    name: string;
+    /** Hex without '#'. null = fall back to palette. */
+    color: string | null;
+    /** Numeric values; null = missing data point. */
+    values: (number | null)[];
+    /**
+     * Per-data-point colors (pie / doughnut). Hex without '#'. null inside the
+     * array = use palette for that slice. Omit entirely for non-pie series.
+     */
+    dataPointColors?: (string | null)[] | null;
+    /**
+     * Per-data-point data-label text colors. Used by chartEx (`<cx:dataLabel idx>`)
+     * to override label colour per bar — sample-2's waterfall paints negative
+     * △ values in red while positive values stay black. Null inside the array =
+     * fall back to the chart-level `dataLabelFontColor`.
+     */
+    dataLabelColors?: (string | null)[] | null;
+    /**
+     * Series-level data-label text colour (`<c:ser><c:dLbls><c:txPr>…solidFill`,
+     * ECMA-376 §21.2.2.216). Hex without '#'. Stacked-bar charts colour each
+     * segment's label independently (e.g. white on the dark segment, black on
+     * the light one), which a single chart-level `dataLabelFontColor` can't
+     * express. Takes precedence over `dataLabelFontColor`; null = no override.
+     */
+    labelColor?: string | null;
+    /**
+     * Mixed chart: per-series chart type override. Currently only "line" (XLSX
+     * and PPTX combo charts) is honoured; other values are treated as the
+     * chart's primary type.
+     */
+    seriesType?: string | null;
+    /**
+     * Combo chart: this series is plotted against the SECONDARY value axis
+     * (`ChartModel.secondaryValAxis`) — the `<c:valAx>` with `axPos="r"` /
+     * `<c:crosses val="max">`. When false/absent the series uses the primary
+     * (left) value-axis scale. PowerPoint's "Revenue vs. gross margin" combo
+     * (sample-14 slide-8) puts the margin line on a 0–100% secondary axis.
+     */
+    useSecondaryAxis?: boolean | null;
+    /**
+     * Scatter-only X values (as strings). When null the series uses
+     * `ChartModel.categories` as X.
+     */
+    categories?: string[] | null;
+    /**
+     * Resolved marker visibility for line/scatter series. ECMA-376 §21.2.2.32
+     * `<c:marker><c:symbol>` defaults to "none" for line charts unless the
+     * chart-level `<c:marker val="1"/>` or a per-series symbol opts in. When
+     * undefined/null the renderer uses its own default (visible) so callers
+     * that don't parse markers (e.g. pptx today) keep their existing behavior.
+     */
+    showMarker?: boolean | null;
+    /**
+     * Excel number-format code for this series' values (ECMA-376 §21.2.2.37,
+     * `<c:val>/<c:numRef>/<c:formatCode>`). Used to format data labels when the
+     * chart-level `<c:dLbls><c:numFmt>` is not set. null = no series-level code.
+     */
+    valFormatCode?: string | null;
+    /**
+     * `<c:marker><c:symbol val>` (ECMA-376 §21.2.2.32) — point marker shape.
+     * One of "circle"|"square"|"diamond"|"triangle"|"x"|"plus"|"star"|
+     * "dot"|"dash"|"picture"|"none". null = renderer default (circle when
+     * showMarker is true).
+     */
+    markerSymbol?: string | null;
+    /**
+     * `<c:marker><c:size val>` (ECMA-376 §21.2.2.34) — marker side length in
+     * points. null = renderer default (~5 pt).
+     */
+    markerSize?: number | null;
+    /** `<c:marker><c:spPr><a:solidFill>` resolved hex (no `#`). */
+    markerFill?: string | null;
+    /** `<c:marker><c:spPr><a:ln><a:solidFill>` resolved hex (no `#`). */
+    markerLine?: string | null;
+    /**
+     * Per-data-point overrides (ECMA-376 §21.2.2.39 `<c:dPt>`). Keyed by point
+     * index. Any unset field falls back to the series-level value.
+     */
+    dataPointOverrides?: ChartDataPointOverride[] | null;
+    /**
+     * Per-data-point custom labels (ECMA-376 §21.2.2.45 `<c:dLbl idx>`).
+     * `text` is the resolved plain string — `<a:fld type="CELLRANGE">`
+     * placeholders are already substituted at parse time. An empty string
+     * means the point's label was deleted with `<c:delete val="1"/>` and
+     * the renderer should skip it.
+     */
+    dataLabelOverrides?: ChartDataLabelOverride[] | null;
+    /**
+     * Series-level `<c:dLbls>` block (showVal / showSerName / position).
+     * Applied to every point lacking its own `<c:dLbl>` override.
+     */
+    seriesDataLabels?: ChartSeriesDataLabels | null;
+    /**
+     * `<c:errBars>` per-series error bars (ECMA-376 §21.2.2.20). Up to two
+     * (one per direction). Plus / minus deltas are absolute per-point values
+     * regardless of `errValType`.
+     */
+    errBars?: ChartErrBars[] | null;
+    /**
+     * `<c:bubbleSize>` per-point sizes for bubble charts (ECMA-376 §21.2.2.4).
+     * Drives marker radius — renderer treats the values as areas (radius
+     * scales by sqrt) so visual area is proportional to value, matching
+     * Excel. null / empty array = uniform marker size. Ignored for non-bubble
+     * series.
+     */
+    bubbleSizes?: (number | null)[] | null;
+    /**
+     * `<c:ser><c:smooth val>` (ECMA-376 §21.2.2.194) — line/area series flag
+     * requesting a smoothed (spline) curve through the points instead of straight
+     * segments. Only consulted for the line and area families (scatter carries its
+     * smoothing in `ChartModel.scatterStyle`). null/undefined/false = straight
+     * polyline (the default; byte-stable for series that never set it).
+     */
+    smooth?: boolean | null;
+    /**
+     * `<c:ser><c:trendline>` per-series trendlines (ECMA-376 §21.2.2.211,
+     * `CT_Trendline`). A series can carry several (e.g. a linear fit + a moving
+     * average). null/undefined/empty = no trendline (the default; byte-stable for
+     * series that never declare one).
+     */
+    trendLines?: ChartTrendline[] | null;
+    /**
+     * `<c:ser><c:spPr><a:ln><a:noFill/>` (ECMA-376 §21.2.2.198 CT_ShapeProperties
+     * → DrawingML §20.1.2.2.24 CT_LineProperties). true when the series connecting
+     * line is explicitly turned OFF. For a scatter/line series this OVERRIDES the
+     * chart-group `<c:scatterStyle>` (§21.2.2.42) / line default — Excel and
+     * PowerPoint draw markers only (no connecting line) even when the group style
+     * is `lineMarker`. null/undefined = no explicit line-off, so the group default
+     * governs (byte-stable for series that carry a paintable line).
+     */
+    lineHidden?: boolean | null;
+}
+/**
+ * `<c:ser><c:trendline>` (ECMA-376 §21.2.2.211). A regression/smoothing curve
+ * fitted to the series' data points.
+ */
+interface ChartTrendline {
+    /**
+     * `<c:trendlineType val>` (§21.2.2.213, `ST_TrendlineType` §21.2.3.50):
+     * "linear" | "exp" | "log" | "power" | "poly" | "movingAvg". The renderer
+     * currently draws "linear" (least squares) and "movingAvg"; other types parse
+     * but are not yet plotted (tracked as a follow-up).
+     */
+    trendlineType: string;
+    /** `<c:order val>` — polynomial order (`poly`, default 2). */
+    order?: number | null;
+    /** `<c:period val>` — moving-average window (`movingAvg`, default 2). */
+    period?: number | null;
+    /** `<c:forward val>` — units to extend the line past the last point. */
+    forward?: number | null;
+    /** `<c:backward val>` — units to extend the line before the first point. */
+    backward?: number | null;
+    /** `<c:intercept val>` — forced y-intercept (linear/exp). null = free fit. */
+    intercept?: number | null;
+    /** `<c:dispRSqr val="1">` — show the R² value (label; not yet rendered). */
+    dispRSqr?: boolean | null;
+    /** `<c:dispEq val="1">` — show the fit equation (label; not yet rendered). */
+    dispEq?: boolean | null;
+    /** `<c:spPr><a:ln><a:solidFill>` trendline color (hex without '#'). null =
+     *  inherit the series color. */
+    lineColor?: string | null;
+    /** `<c:spPr><a:ln w>` trendline width in EMU. */
+    lineWidthEmu?: number | null;
+}
+interface ChartDataPointOverride {
+    idx: number;
+    /** Resolved fill hex (no `#`). */
+    color?: string;
+    markerSymbol?: string;
+    markerSize?: number;
+    markerFill?: string;
+    markerLine?: string;
+    /**
+     * `<c:dPt><c:explosion val>` (ECMA-376 §21.2.2.61) — the amount this
      * pie/doughnut slice is moved out from the center. The schema type is
      * `CT_UnsignedInt` (unbounded `xsd:unsignedInt`); the spec text only says
      * "the amount the data point shall be moved from the center of the pie"
@@ -1314,7 +1786,7 @@ type HyperlinkTarget = {
  */
 declare function openExternalHyperlink(url: string, allowed?: readonly string[], win?: Pick<Window, 'open'> | undefined): boolean;
 //#endregion
-//#region dist/.types-work/find-highlight-gMP3FAnW.d.ts
+//#region dist/.types-work/find-highlight-CnpZn3yb.d.ts
 //#region packages/core/src/autoResize.d.ts
 interface AutoResizeOptions {
     /**
@@ -1501,7 +1973,7 @@ interface FindHighlightColors {
     active?: string;
 }
 //#endregion
-//#region dist/.types-work/renderer-CU7Ays06.d.ts
+//#region dist/.types-work/renderer-BwmBZ5GX.d.ts
 //#region packages/docx/src/types.d.ts
 interface DocxDocumentModel {
     section: SectionProps;
@@ -1889,7 +2361,7 @@ interface DocParagraph {
     spaceAfter: number;
     lineSpacing: LineSpacing | null;
     numbering: NumberingInfo | null;
-    tabStops: TabStop$1[];
+    tabStops: TabStop[];
     runs: DocRun[];
     /**
      * ECMA-376 §17.13.6.2 `<w:bookmarkStart w:name>` — names of the bookmarks that
@@ -1937,10 +2409,9 @@ interface DocParagraph {
     defaultFontFamilyEastAsia?: string | null;
     /** ECMA-376 §17.3.1.29 — the paragraph mark run's resolved `w:color` (direct
      *  pPr/rPr → pStyle chain → docDefaults; hex 6 without `#`, lowercased; an
-     *  explicit `auto` surfaces as absent, §17.3.2.6). The numbering level rPr
-     *  (§17.9.24) layers over the mark's run properties, so the renderer uses
-     *  this as the marker-color fallback when {@link NumberingInfo.color} is
-     *  absent. */
+     *  explicit `auto` surfaces as absent, §17.3.2.6). Compatibility rule
+     *  `word-numbering-marker-paragraph-mark-fallback` uses this when §17.9.24
+     *  leaves {@link NumberingInfo.color} absent. */
     paragraphMarkColor?: string | null;
     /**
      * ECMA-376 §17.3.1.6 `<w:bidi>` — right-to-left paragraph. `true` = RTL,
@@ -2032,7 +2503,7 @@ interface DocxRunBorder {
     /** pt spacing between the border and the run text (w:space) */
     space: number;
 }
-interface TabStop$1 {
+interface TabStop {
     /** tab stop position in pt (from the left of paragraph content area) */
     pos: number;
     /** ECMA-376 ST_TabJc. `num` is the list tab between a numbering marker and
@@ -2066,7 +2537,8 @@ interface NumberingInfo {
      *  it (the renderer treats absent as "left"). */
     jc?: string;
     /** ECMA-376 §17.3.2.26 ascii axis for the marker glyph, resolved through the
-     *  level's `rPr` (§17.9.6) merged over the paragraph's run formatting. The
+     *  level's `rPr` (§17.9.24) plus compatibility rule
+     *  `word-numbering-marker-paragraph-mark-fallback`. The
      *  renderer draws Latin marker chars (e.g. a decimal "1") with this family, so
      *  a heading whose ascii=Times renders its auto-number in Times (serif) even
      *  when eastAsia=Gothic. Absent ⇒ the renderer falls back to its default. */
@@ -2079,9 +2551,11 @@ interface NumberingInfo {
     /** ECMA-376 §17.9.24 — the numbering level rPr's `w:color` (hex 6 without
      *  `#`, lowercased). Colors the marker glyph only, never the paragraph's
      *  runs. Absent ⇒ the renderer falls back to
-     *  {@link DocParagraph.paragraphMarkColor} (§17.3.1.29 — the level rPr layers
-     *  over the paragraph mark's run properties) and finally to its
-     *  default ink. An explicit `w:val="auto"` is absent here + {@link colorAuto}. */
+     *  {@link DocParagraph.paragraphMarkColor} under compatibility rule
+     *  `word-numbering-marker-paragraph-mark-fallback`, then to its default ink.
+     *  §17.3.1.29 defines the
+     *  mark properties but not that fallback. An explicit `w:val="auto"` is
+     *  absent here + {@link colorAuto}. */
     color?: string | null;
     /** ECMA-376 §17.3.2.6 / ST_HexColorAuto (§17.18.39) — true when the level
      *  rPr carries an EXPLICIT `w:color w:val="auto"`. Auto names no concrete
@@ -2193,7 +2667,7 @@ interface PTabRun {
     /** Resolved run font size (pt) — matches the surrounding text's leader/gap. */
     fontSize: number;
 }
-type PathCmd$2 = {
+type PathCmd$1 = {
     cmd: 'moveTo';
     x: number;
     y: number;
@@ -2232,6 +2706,9 @@ interface AnchorHostMetrics {
     italic?: boolean;
 }
 interface ShapeRun {
+    /** ECMA-376 §20.4.2.8 — true when the shape is hosted by `<wp:inline>` and
+     * therefore advances the paragraph pen like an inline drawing object. */
+    inline?: boolean;
     widthPt: number;
     heightPt: number;
     /** X offset in pt */
@@ -2277,7 +2754,7 @@ interface ShapeRun {
     zOrder: number;
     /** Normalized [0,1] custom-geometry sub-paths. Empty when `presetGeometry`
      *  is set; the renderer chooses between buildCustomPath and buildShapePath. */
-    subpaths: PathCmd$2[][];
+    subpaths: PathCmd$1[][];
     /** OOXML <a:prstGeom prst> name (e.g. "rect", "ellipse", "rtTriangle").
      *  When set the renderer calls core's buildShapePath with `adjValues`. */
     presetGeometry?: string | null;
@@ -2402,6 +2879,13 @@ interface ShapeText$1 {
     text: string;
     fontSizePt: number;
     color?: string | null;
+    /** Resolved paragraph-mark run color used by compatibility rule
+     *  `word-numbering-marker-paragraph-mark-fallback` when the numbering level
+     *  has no explicit color; kept separate from the first content run's
+     *  compatibility-level {@link ShapeText.color}. `null` means the parser
+     *  resolved automatic/default ink; `undefined` preserves the legacy contract
+     *  for hand-built values that did not provide paragraph-mark facts. */
+    paragraphMarkColor?: string | null;
     fontFamily?: string | null;
     bold?: boolean;
     italic?: boolean;
@@ -2443,7 +2927,7 @@ interface ShapeText$1 {
      *  Absent/empty ⇒ only the automatic default-tab grid applies. The renderer
      *  feeds these to the SAME line engine the body uses so a `\t` inside a text box
      *  advances to its stop (the old shape wrapper dropped tabs entirely). */
-    tabStops?: TabStop$1[];
+    tabStops?: TabStop[];
     /** ECMA-376 §17.3.1.6 `<w:bidi>` — right-to-left text-box paragraph, resolved
      *  through the style chain like {@link DocParagraph.bidi}. `true` = RTL,
      *  `false` = explicitly LTR, absent = unspecified. Consumed as the paragraph
@@ -2481,23 +2965,41 @@ type ShapeFill = {
     color: string;
 } | {
     fillType: 'gradient';
-    stops: GradientStop$1[];
+    stops: GradientStop[];
     angle: number;
     gradType: string;
-};
-interface GradientStop$1 {
-    /** 0.0–1.0 */
-    position: number;
-    /** hex 6-char */
-    color: string;
-}
-interface FieldRun {
-    /** "page" | "numPages" | "other" */
-    fieldType: string;
-    instruction: string;
-    fallbackText: string;
-    bold: boolean;
-    italic: boolean;
+} | {
+    /** ECMA-376 §20.1.8.14 picture fill on a DrawingML shape. */
+    fillType: 'image';
+    imagePath: string;
+    mimeType: string;
+    /** Microsoft 2016 SVG original retained beside the raster fallback. */
+    svgImagePath?: string;
+    /** ECMA-376 §20.1.8.55 source-image crop. */
+    srcRect?: {
+        l: number;
+        t: number;
+        r: number;
+        b: number;
+    };
+    fillRect?: FillRect;
+    tile?: TileInfo;
+    alpha?: number;
+    duotone?: Duotone$1;
+};
+interface GradientStop {
+    /** 0.0–1.0 */
+    position: number;
+    /** hex 6-char */
+    color: string;
+}
+interface FieldRun {
+    /** "page" | "numPages" | "other" */
+    fieldType: string;
+    instruction: string;
+    fallbackText: string;
+    bold: boolean;
+    italic: boolean;
     underline: boolean;
     strikethrough: boolean;
     fontSize: number;
@@ -2624,7 +3126,8 @@ interface DocxTextRun {
      *  width, not the gap between glyphs. Absent ⇒ 100%. */
     charScale?: number;
     /** ECMA-376 §17.3.2.24 `<w:position w:val>` — baseline raise (positive) /
-     *  lower (negative) in POINTS, without changing the font size or line box.
+     *  lower (negative) in POINTS, without changing the font size. The shifted
+     *  ink still participates in the surrounding line's visible extent.
      *  Absent ⇒ no shift. */
     position?: number;
     /** ECMA-376 §17.3.2.19 `<w:kern w:val>` — font-kerning threshold in POINTS
@@ -3032,7 +3535,7 @@ interface DocxTextRunInfo {
     eastAsianVert?: boolean;
 }
 //#endregion
-//#region dist/.types-work/docx-VDKt2JLe.d.ts
+//#region dist/.types-work/docx-KCG5Gwuy.d.ts
 //#region packages/docx/src/worker-protocol.d.ts
 /** Serializable subset of RenderPageOptions (callbacks cannot cross the wire). */
 type WireRenderPageOptions = Omit<RenderPageOptions, 'onTextRun'>;
@@ -3742,929 +4245,457 @@ declare class DocxScrollViewer implements ZoomableViewer {
     private _wheelListener;
     /** Gesture-only pointer anchor for the NEXT `setScale`, in scrollHost-viewport
      *  px (`{ x, y }` from the wheel event, relative to the scroll host's top-left).
-     *  Set by the Ctrl/⌘+wheel handler right before it calls `setScale` so the zoom
-     *  pivots on the cursor ("zoom toward the pointer") in BOTH axes; consumed and
-     *  cleared by `setScale`. `null` for every non-gesture source (the public
-     *  `setScale`, the +/- steppers, `fitWidth`/`fitPage`, the resize re-fit), which
-     *  keep the historical viewport-TOP re-anchor so their behaviour is unchanged. */
-    private _pendingZoomAnchor;
-    /** Observes the container so a width change re-fits the base scale. Disconnected
-     *  in `destroy()`. */
-    private _resizeObserver;
-    /** The base fit scale at the last established/re-fit layout. `_onResize` divides
-     *  `_scale` by this to recover the current zoom multiplier so a width change
-     *  re-fits the base while preserving the user's zoom (design §11). */
-    private _prevBase;
-    /** The fit width (px) the base scale was last established at. Lets `_onResize`
-     *  skip the re-fit when only the height changed (a ResizeObserver fires on ANY
-     *  box change, but only a WIDTH change alters the fit-to-width base scale). */
-    private _lastFitWidth;
-    /** Resolved page-canvas `box-shadow` (design: the recipe drop shadow by
-     *  default). Resolved ONCE with `??` — NOT `||` — so `pageShadow: false`
-     *  survives as the "no shadow" sentinel (a `||` would treat `false` as absent
-     *  and wrongly re-apply the default). Applied by `_applyPageShadow` at EVERY
-     *  canvas-creation site (`_acquireSlot` and the double-buffer spare in
-     *  `_settleSlot`) so a recycled/re-mounted slot and a settle-swapped spare all
-     *  carry it. */
-    private readonly _pageShadow;
-    private readonly _find;
-    private _findActive;
-    constructor(container: HTMLElement, opts?: DocxScrollViewerOptions);
-    /**
-     * Load a DOCX from URL or ArrayBuffer and render the first window.
-     * UNSUPPORTED when an engine was injected via `opts.document` (throws) — the
-     * caller already owns the parsed engine.
-     */
-    load(source: string | ArrayBuffer): Promise<void>;
-    get pageCount(): number;
-    /** CSS px width of page `i` at the current scale. */
-    private _pageWidthPx;
-    /** CSS px height of page `i` at the current scale. */
-    private _pageHeightPx;
-    /** The fit width (px), deferring when the container is unlaid-out. An EXPLICIT
-     *  `opts.width` is the page's CSS-width contract and is returned UNCHANGED (the
-     *  gutters still apply around placement, not to the width). The container-derived
-     *  default instead targets `containerWidth − padL − padR` so a page sits INSIDE
-     *  the horizontal gutters at 100%. A non-positive result (gutters wider than the
-     *  container) is treated as unlaid-out — the same deferral as a zero-width box. */
-    private _fitWidthPx;
-    /** Base scale: first page's width fit to the fit-width. Returns 0 when the
-     *  container has no width yet (deferral). */
-    private _baseScale;
-    /**
-     * Recompute per-page heights + the spacer and re-mount the visible window.
-     *
-     * The viewer already calls this automatically after `load()`, an injected
-     * engine, a container resize, and a zoom, so most integrations never need it.
-     * It is public as a deliberate escape hatch: if the host mutates the layout in
-     * a way the `ResizeObserver` cannot observe (e.g. a CSS change on an ancestor
-     * that resizes the container without a box-size event, or a font that finishes
-     * loading after first paint), call `relayout()` to force a re-fit. Idempotent —
-     * safe to call repeatedly, and a no-op while the container has zero width (the
-     * fit is deferred until width appears, design §11).
-     */
-    relayout(): void;
-    private _recomputeHeights;
-    private _gap;
-    private _overscan;
-    /** Desk padding fed to `computeVisibleRange`: `paddingTop`/`paddingBottom`,
-     *  each defaulting to `gap` (uniform rhythm). Resolved here (not stored) to
-     *  mirror `_gap()`/`_overscan()`, and consumed at EVERY `computeVisibleRange`
-     *  call site so the padded offsets are the single source of geometry. */
-    private _pad;
-    /** Horizontal desk gutters: `paddingLeft`/`paddingRight`, each defaulting to
-     *  `gap` (uniform rhythm — the horizontal gutters match the vertical padding).
-     *  Consumed by `_fitWidthPx` (to shrink the container-derived fit), by
-     *  `_positionSlot` (the flush-left floor), and by `_syncSpacer` (the spacer
-     *  width). Resolved here (not stored) to mirror `_gap()`/`_pad()`. */
-    private _padH;
-    /** Index of the page whose slot spans content-offset `y` (largest `i` with
-     *  `offsets[i] <= y`), for the pointer-anchored zoom re-anchor. Mirrors the
-     *  `topIndex` search `computeVisibleRange` runs for the scrollTop, but for an
-     *  ARBITRARY content-y (the pointer, not the viewport top). Clamped into
-     *  `[0, n-1]`; a `y` below the first page (inside the leading pad) yields 0. */
-    private _pageIndexAtOffset;
-    private _range;
-    private _syncSpacer;
-    /** Horizontal scroll extent: the widest page (docx pages can differ in width)
-     *  plus both gutters. A spacer NARROWER than the container never creates a
-     *  scrollbar (scrollWidth = max(clientWidth, content)), so it is always safe to
-     *  set — it only matters when a zoomed-in page grows past the viewport, where it
-     *  gives the gutters something to scroll to on either side. Max over per-page
-     *  widths so the extent covers the widest page in the document. Called from
-     *  `_syncSpacer` and after every scale change (zoom / resize re-fit) so the
-     *  extent tracks the current page px width. */
-    private _syncSpacerWidth;
-    private _onScroll;
-    /** Mount/recycle slots for the current visible window. */
-    private _mountVisible;
-    /** Apply the resolved page-canvas shadow (design: recipe drop shadow by
-     *  default, `false` ⇒ none). Single source so `_acquireSlot` and the
-     *  double-buffer spare in `_settleSlot` stay in lock-step — a spare that missed
-     *  this would lose the shadow on the settle swap. `box-shadow` never affects
-     *  layout, so this is safe to (re)set on a live/pooled canvas without shifting
-     *  any offset. */
-    private _applyPageShadow;
-    private _acquireSlot;
-    private _recycleSlot;
-    private _positionSlot;
-    /** Device-pixel ratio for a render (opts override → window → 1). */
-    private _dpr;
-    /**
-     * Render page `i` into `slot`. Routes strictly on the constructor-resolved
-     * `_mode` (design §11 — no probing, no silent mis-pathing): `main` ⇒ paint the
-     * slot's canvas directly via `renderPage`; `worker` ⇒ transfer an ImageBitmap
-     * from `renderPageToBitmap`.
-     *
-     * Slot-identity guard: a slot recycled to a DIFFERENT page while a previous
-     * render is in flight must not repaint the stale page. `slot.renderedPage`
-     * tracks the page this slot is committed to; we stamp it up-front and bail on
-     * resolution if it changed (the engine's own token guard is per-canvas; this is
-     * the viewer's per-slot page-identity check).
-     *
-     * Render epoch (main path): pixel staleness after a mid-flight `setScale` is
-     * already handled by the engine's per-canvas token (the newer renderPage on the
-     * same canvas wins) — `setScale` recycles + re-mounts, and the re-mount always
-     * re-dispatches `renderPage` (renderedPage reset to -1), so a fresh render is
-     * always issued. But the viewer-side side effects of a STALE resolution — the
-     * text-layer build (its run geometry is at the OLD scale) and the renderedPage
-     * bookkeeping — must NOT run, or a superseded render would rebuild the overlay
-     * with stale x/y/w/h (the pool reuses slot objects, so the identity check alone
-     * can pass for an old-epoch resolution). We gate them on the captured epoch.
-     */
-    private _renderSlot;
-    /**
-     * IX1/IX-nav — the click handler passed to the text-layer overlay. When the
-     * caller supplied `onHyperlinkClick`, it fully owns the behaviour (the default
-     * is suppressed). Otherwise the built-in default is: an external link opens in
-     * a new tab through core `openExternalHyperlink` (URL sanitised against the
-     * safe scheme allowlist, `noopener,noreferrer`); an internal `<w:anchor>` link
-     * resolves its bookmark name to its destination page via
-     * {@link DocxDocument.getBookmarkPage} (ECMA-376 §17.16.23) and scrolls there
-     * with {@link scrollToPage}. An anchor naming no known bookmark is a safe no-op
-     * rather than a scroll to a guessed page.
-     *
-     * IX1 — returns `undefined` when `enableHyperlinks` is `false`, the single gate
-     * that disables hyperlink interactivity: {@link buildDocxTextLayer} treats a
-     * missing handler as "render link runs like plain runs", so no hit region,
-     * cursor, tooltip, listener, or navigation is wired (a custom
-     * `onHyperlinkClick` is suppressed too).
-     */
-    private _hyperlinkHandler;
-    /** A width-measurer primed with a run's `font` — used ONLY to clamp a §17.3.2.10
-     *  縦中横 selection span to its drawn one-em cell (#836). Mirrors DocxViewer's
-     *  `_measureForFont`. Returns a length-based fallback when canvas metrics are
-     *  unavailable so the caller still gets a callable (the overlay then sees scale
-     *  1 and leaves the span un-clamped). */
-    private _measureForFont;
-    /** A canvas's intended CSS box in px (the % denominators the overlay builders
-     *  expect). Reads the inline `style.width`/`height` set by the render path,
-     *  falling back to the backing-store size when unset; tolerates the `px` suffix. */
-    private _canvasCssPx;
-    /** Route an async render failure to `onError`, or `console.error` when none is
-     *  set (so failures are never fully silent), and never after teardown. */
-    private _reportRenderError;
-    /**
-     * Worker-mode slot render: dispatch `renderPageToBitmap`, transfer the result
-     * via a per-slot `bitmaprenderer` context, and manage the ImageBitmap lifecycle.
-     *
-     * Coalescing / drop-stale (design §11):
-     *  - Skip if page `i` is already in flight (a scroll storm won't double-dispatch).
-     *  - Skip if page `i` already left the mounted window before dispatch.
-     *  - On resolution, if `slot` is no longer THIS page's live slot (it recycled to
-     *    another page, or page `i` re-mounted onto a DIFFERENT slot while this render
-     *    was in flight), close the orphan bitmap and skip the paint. In that
-     *    re-mount case a live slot for `i` still awaits a render, so once we clear
-     *    the in-flight guard we re-dispatch it — a page that recycled and re-mounted
-     *    mid-flight must never stay blank.
-     *  - RENDER EPOCH: the dispatch captures `this._renderEpoch`. `setScale` bumps
-     *    the epoch, so a resolution whose captured epoch ≠ the live epoch is STALE
-     *    even when the SAME slot object is still mounted for page `i` (the pool
-     *    reuses slot objects, so the identity check alone can't catch a zoom that
-     *    happened mid-flight). A moved epoch ⇒ close the orphan + re-dispatch the
-     *    live slot at the new scale, never paint the old-scale bitmap.
-     */
-    private _renderSlotBitmap;
-    /**
-     * Set the absolute px-per-pt zoom scale, clamped inline to
-     * `[zoomMin ?? 0.1, zoomMax ?? 4]` (absolute bounds, XlsxViewer convention — NOT
-     * multiples of the base fit; design §3 keeps the clamp in the viewer, not core),
-     * then re-anchor VERTICALLY so the page currently under the viewport top stays
-     * fixed. A no-op when the clamped scale is unchanged. Called BEFORE the doc is
-     * loaded / the base fit is established, the clamped factor is LATCHED (IX9 F1,
-     * family-unified with the single-canvas viewers) and applied by `relayout()`
-     * once the layout establishes — `onScaleChange` fires then.
-     *
-     * FLICKER-FREE (design §7): this does NOT re-render the visible pages inline.
-     * It shows an immediate CSS preview (stretch the existing bitmaps, scale the
-     * overlays) and DEBOUNCES a full-resolution settle re-render for ZOOM_SETTLE_MS,
-     * so a wheel/pinch burst never blanks a page and coalesces into one crisp render.
-     *
-     * Re-anchor (written from scratch — XlsxViewer only re-anchors horizontally):
-     * capture `top = topIndex` and the intra-page fraction `intraFrac` from the
-     * CURRENT range BEFORE rescale; after recomputing heights at the new scale,
-     * `newScrollTop = offsets'[top] + intraFrac × heights'[top]`, clamped to
-     * `[0, totalHeight' − viewportHeight]`. Because a page's height scales linearly
-     * with `_scale`, the same fractional position maps exactly to the new geometry.
-     *
-     * CAVEAT — base fit below the floor: `relayout()` sets `_scale = base` WITHOUT
-     * clamping to `[zoomMin, zoomMax]`. If the base fit is below `zoomMin` (a wide
-     * page in a narrow container), the initial scale sits under the floor, but once
-     * the user zooms via `setScale` the clamp pins the minimum to `zoomMin`, so they
-     * can no longer return below the floor to the original base fit through this API.
-     */
-    setScale(scale: number): void;
-    /** IX9 {@link ZoomableViewer} — the current zoom factor, where `1` = 100% (a
-     *  page at its natural pt→px width). This is the viewer's absolute `_scale`
-     *  (`widthPt × PT_TO_PX × _scale` is the drawn width), so it reads `1` at true
-     *  100% and, after the initial fit-to-width, the base fit factor. Before the
-     *  fit is established it reports a latched pre-load `setScale` (IX9 F1) if one
-     *  is pending — matching what a single-canvas viewer would show — else `1`. */
-    getScale(): number;
-    /** IX9 {@link ZoomableViewer} — step up to the next rung of the shared zoom
-     *  ladder above the current factor (clamped to `zoomMax` by {@link setScale}). */
-    zoomIn(): void;
-    /** IX9 {@link ZoomableViewer} — step down to the next lower ladder rung. */
-    zoomOut(): void;
-    /**
-     * IX9 {@link ZoomableViewer} — fit a page's WIDTH to the container (the classic
-     * continuous-scroll "fit width"). Sets the scale to the width-fit base for the
-     * current container, then re-anchors + re-renders via {@link setScale}. Defers
-     * (no-op) while the container is unlaid-out. Note the `zoomMin`/`zoomMax` clamp
-     * still applies, so a fit below `zoomMin` pins to `zoomMin`.
-     */
-    fitWidth(): void;
-    /**
-     * IX9 {@link ZoomableViewer} — fit a WHOLE page (width and height) inside the
-     * container so one page is visible without scrolling; takes the tighter of the
-     * width/height fit. Uses the FIRST page's size (the continuous viewer's fit
-     * reference, matching the base-fit convention). Defers while unlaid-out.
-     */
-    fitPage(): void;
-    /** Shared fit for {@link fitWidth}/{@link fitPage}: the width-fit factor is the
-     *  established base (`_baseScale`); the page-fit additionally bounds by the
-     *  container height against the first page's height. Applies via {@link setScale}
-     *  so the flicker-free re-anchor / settle path and `onScaleChange` all run. */
-    private _fit;
-    /**
-     * CSS preview of the visible window at the current `_scale` (design §7
-     * mechanism 1), WITHOUT re-rendering. Slots leaving the window recycle normally;
-     * slots ENTERING the window mount fresh (rendered at the current scale directly,
-     * so they never need a preview); slots that STAY are repositioned and their
-     * canvas + text overlay are CSS-transformed to the new size (the device buffer
-     * is untouched — that is the whole point: no synchronous clear, no blank frame).
-     */
-    private _previewVisible;
-    /**
-     * CSS-preview a single already-mounted slot at the new geometry (design §7): the
-     * wrapper is repositioned + sized (via `_positionSlot`), the canvas bitmap is
-     * STRETCHED to the new CSS size (no `canvas.width` — the device buffer, and thus
-     * the drawn pixels, are left intact, just scaled by the browser), and the text
-     * overlay is scaled by `newScale / renderedScale` so it tracks the stretched
-     * page. `renderedScale <= 0` means the slot's first render hasn't resolved yet
-     * (nothing to stretch); the pending render captured the current scale, so it
-     * lands correct and no preview is needed.
-     */
-    private _previewSlot;
-    /** (Re)schedule the debounced settle re-render (design §7 mechanism 2). Resets
-     *  the timer on every call so a burst of `setScale` dispatches ONE settle
-     *  ZOOM_SETTLE_MS after the LAST call. Cleared in `destroy()`. */
-    private _scheduleSettle;
-    /** Full-resolution settle re-render of the visible window (design §7 mechanisms
-     *  2+3). Re-renders each mounted slot at the current scale via the double-buffer
-     *  swap (main) / same-canvas transfer (worker). Both modes rebuild the text
-     *  overlay from the fresh render's run geometry (IX6 — worker mode collects the
-     *  runs off-thread via `_renderSlotBitmap`) and clear the preview transform.
-     *  Dispatched at the CURRENT epoch; the existing epoch gate discards it if a
-     *  later `setScale` supersedes it mid-render. */
-    private _settleRender;
-    /**
-     * Settle-render one slot at the current scale (design §7 mechanism 3).
-     *
-     * WORKER: re-dispatch the bitmap render into the SAME canvas. The worker path
-     * sizes the device buffer and `transferFromImageBitmap`s it in ONE synchronous
-     * step (no await between `canvas.width = …` and the transfer), so the browser
-     * never composites an intermediate blank frame — no spare canvas is needed. The
-     * `renderedScale === _scale` gate in `_settleRender` plus the epoch gate inside
-     * `_renderSlotBitmap` keep this correct and idempotent.
-     *
-     * MAIN: `renderPage` (via renderDocumentToCanvas) synchronously sets
-     * `canvas.width = …` (which CLEARS the backing store to blank) BEFORE its first
-     * await and paints AFTER — so rendering into the on-screen canvas would flash it
-     * white. Render into a SPARE off-DOM canvas instead; only once it resolves at the
-     * current epoch do we swap it into the wrapper (replacing the old canvas, which is
-     * DISCARDED — the pooled unit is the slot, not the canvas). The old canvas keeps
-     * showing the stretched preview until the instant of the swap — blank-free.
-     */
-    private _settleSlot;
-    /**
-     * Scroll so page `index`'s top edge sits at the viewport top. Clamps `index` to
-     * `[0, pageCount-1]` (the pager convention) and the resulting scrollTop to
-     * `[0, totalHeight − viewportHeight]` so the last pages don't scroll past the
-     * end. A no-op when nothing is loaded or the document is empty.
-     *
-     * `opts.behavior` ('auto' | 'smooth', default 'auto') is honoured via
-     * `scrollHost.scrollTo({ top, behavior })` when the host supports it (a real
-     * browser); the stub-DOM has no `scrollTo`, so the fallback sets `scrollTop`
-     * directly (which is what the tests assert). We then call `_mountVisible` once.
-     *
-     * MOUNTING CAVEAT: synchronous mounting of the target page is guaranteed only on
-     * the DEFAULT/'auto' path — there `scrollTop` has already jumped to `top`, so the
-     * `_mountVisible` call reads the final scroll position and the target page's slots
-     * exist immediately. With `behavior: 'smooth'` the scroll animates ASYNCHRONOUSLY:
-     * `scrollTop` is still near the old position when `_mountVisible` runs, so the
-     * target page mounts lazily via the animation's subsequent `scroll` events, not
-     * from this call.
-     */
-    scrollToPage(index: number, opts?: {
-        behavior?: 'auto' | 'smooth';
-    }): void;
-    /** Search the complete document, including pages outside the virtualized
-     * mounted window. Matching is case-insensitive by default. */
-    findText(query: string, opts?: FindMatchesOptions): Promise<FindMatch<DocxMatchLocation>[]>;
-    /** Activate and reveal the next match, wrapping at the end. */
-    findNext(): Promise<FindMatch<DocxMatchLocation> | null>;
-    /** Activate and reveal the previous match, wrapping at the beginning. */
-    findPrev(): Promise<FindMatch<DocxMatchLocation> | null>;
-    /** Clear the current query and every mounted highlight. */
-    clearFind(): void;
-    private _activateMatch;
-    private _collectPageRuns;
-    private _redrawHighlights;
-    private _refreshFindRuns;
-    private _redrawSlotHighlights;
-    /**
-     * Re-fit the base scale on a container resize while PRESERVING the current zoom
-     * multiplier (design §11), then re-anchor + re-render. A `ResizeObserver` fires
-     * on any box change, but only a WIDTH change alters the fit-to-width base scale;
-     * a height-only change skips the re-fit yet STILL re-mounts the visible window
-     * (via `_mountVisible`), because a taller viewport reveals rows that were below
-     * the fold and would otherwise stay blank until the next scroll. Empty/unloaded
-     * ⇒ no-op; a still-zero width ⇒ defer.
-     *
-     * Zero-width recovery: a container that was 0-wide at construction never
-     * established a scale (`_scaleEstablished` is false), so the first non-zero
-     * resize establishes it here via `relayout()` — completing the T2 deferral.
-     *
-     * Re-fit math (zoom multiplier preserved):
-     *   mult      = _scale / _prevBase            (the user's zoom over the old base)
-     *   newScale  = newBase × mult
-     * Routing through `setScale(newScale)` bumps `_renderEpoch` (resize IS an epoch
-     * event — T4 banner) and re-anchors + CSS-previews + debounces a settle re-render
-     * of every slot at the new geometry, exactly like a zoom (design §7 flicker-free
-     * path — a rapid ResizeObserver burst therefore also coalesces into one settle).
-     * `setScale`'s clamp/no-op guards apply: an unchanged newScale (identical width)
-     * is a no-op there — so we short-circuit BEFORE it when the fit-width is
-     * unchanged (mounting the revealed window without a needless re-render), and
-     * after it we call `_mountVisible` again to cover the case where the clamp made
-     * `setScale` no-op yet the viewport still grew.
-     */
-    private _onResize;
-    get topVisiblePage(): number;
-    /** Return the owning engine's latest content-free package-usage snapshot. */
-    getResourceMetrics(): Promise<OoxmlResourceMetrics>;
-    /**
-     * Tear down the viewer: remove the DOM subtree and (only for a self-loaded
-     * engine) destroy the engine. An injected engine is left intact — the caller
-     * owns its lifecycle. Per-slot worker ImageBitmaps are closed on recycle.
-     */
-    destroy(): void;
-}
-//#endregion
-//#region packages/docx/src/text-layer.d.ts
-/**
- * Build the transparent text-selection overlay for a rendered docx page: one
- * absolutely-positioned, color-transparent `<span>` per {@link DocxTextRunInfo}
- * (emitted by `renderPage`'s `onTextRun`), so the browser's native selection
- * lands on the drawn glyphs. Extracted verbatim from `DocxViewer._buildTextLayer`
- * so both the pager (DocxViewer) and the continuous-scroll viewer (DocxScrollViewer)
- * share one implementation; also public API for integrators building their own
- * overlay (design §10). IX6 — usable in BOTH render modes: worker mode collects
- * the same `DocxTextRunInfo[]` off-thread and ships it back beside the bitmap, so
- * the overlay is built from identical geometry regardless of thread.
- *
- * Every span is positioned as a PERCENTAGE of `cssWidth`/`cssHeight` (the page's
- * intended CSS-px box), never literal px, and the container's own width/height are
- * left untouched (the caller sizes it `width:100%;height:100%`). This lets the
- * overlay track the canvas's ACTUAL rendered box even when a consumer scales the
- * canvas down with external CSS (`width:100%!important; height:auto`): the
- * `display:inline-block` wrapper shrinks with the canvas, the `100%` container
- * follows, and every `%`-placed span scales with it, so nothing overflows the
- * wrapper into an ancestor's scroll area.
- *
- * @param layer            the overlay div (sized `width:100%;height:100%` by the caller).
- * @param runs             per-run geometry from `renderPage({ onTextRun })`.
- * @param cssWidth         the page's intended CSS width (px, number) — the %
- *                         denominator for the x axis.
- * @param cssHeight        the page's intended CSS height (px, number) — the %
- *                         denominator for the y axis.
- * @param onHyperlinkClick IX1 — invoked when a run carrying a resolved
- *                         {@link HyperlinkTarget} is clicked. A hyperlink run's
- *                         span keeps its transparent glyphs (the visible link
- *                         colour/underline is already drawn on the canvas) but
- *                         gains `cursor:pointer`, a `title` tooltip (the URL or
- *                         bookmark ref) and this click handler. A plain
- *                         `<span>` — not an `<a href>` — is used deliberately so
- *                         the browser's own navigation can never bypass the
- *                         caller's URL sanitisation. When omitted, link runs are
- *                         rendered exactly like plain runs (no click affordance).
- * @param measureForFont   optional width-measurer factory (primed with a run's
- *                         `font`), used ONLY to clamp a §17.3.2.10 縦中横
- *                         (eastAsianVert) span to its drawn one-em cell (#836):
- *                         the span composes a `scaleX(run.w / naturalWidth)` so
- *                         its selection extent matches the compressed glyphs
- *                         instead of the run's natural ~2× width. When omitted,
- *                         a 縦中横 span keeps the bare rotate (no regression for
- *                         callers that do not thread a measurer).
- */
-declare function buildDocxTextLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], cssWidth: number, cssHeight: number, onHyperlinkClick?: (target: HyperlinkTarget) => void, measureForFont?: (font: string) => (s: string) => number): void;
-//#endregion
-//#region packages/docx/src/find-highlight-layer.d.ts
-/** One page's highlight input: the run-slices a match covers, and whether that
- *  match is the active one (emphasis colour). */
-interface DocxHighlightMatch {
-    slices: MatchRunSlice[];
-    active: boolean;
-}
-/** Format-specific compatibility alias for the shared colour contract. */
-type DocxHighlightColors = FindHighlightColors;
-/**
- * Populate a highlight overlay layer with one box per matched run-slice.
- *
- * Every box is positioned as a PERCENTAGE of `cssWidth`/`cssHeight`, and the
- * container's own size is left untouched (`width:100%;height:100%` from the
- * caller), so the highlights track the canvas's ACTUAL rendered box even when a
- * consumer scales the canvas down with external CSS — mirroring
- * {@link buildDocxTextLayer}.
- *
- * @param layer    the overlay div (cleared here; sized `100%` by the caller).
- * @param runs     the page's runs (same array the page was rendered/text-layered from).
- * @param matches  the page's matches (run-slices + active flag).
- * @param cssWidth  the page's intended CSS width (px, number) — the x-axis % denominator.
- * @param cssHeight the page's intended CSS height (px, number) — the y-axis % denominator.
- * @param measureForFont  returns a width-measurer primed with a run's `font`
- *                        (the viewer closes over a canvas 2d context). Kept as a
- *                        factory so the font is set once per run, not per glyph.
- * @param colors   optional colour overrides.
- */
-declare function buildDocxHighlightLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], matches: DocxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: DocxHighlightColors): void;
-declare namespace docx_d_exports {
-    export { AnchorHostMetrics, AutoResizeOptions, BodyElement, BorderSpec, CellBorders, CellElement, ChartRun, ColSpec, ColumnsSpec, DocComment, DocNote, DocParagraph, DocRevision, DocRun, DocSettings, DocTable, DocTableCell, DocTableRow, DocxDocument, DocxDocumentModel, DocxHighlightColors, DocxHighlightMatch, DocxMatchLocation, DocxRunBorder, DocxScrollViewer, DocxScrollViewerOptions, DocxTextRun, DocxTextRunInfo, DocxViewer, DocxViewerOptions, EmbeddedFontRef, FieldRun, FindHighlightColors, FindMatch, FindMatchesOptions, FramePr, GradientStop$1 as GradientStop, HeaderFooter, HeadersFooters, HyperlinkTarget, ImageRun, LineEnd, LineNumbering, LineSpacing, LoadOptions$2 as LoadOptions, NoteRef, NumberingInfo, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorSource, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, PTabRun, PageBorderEdge, PageBorders, PageNumType, ParaBorderEdge, ParagraphBorders, PathCmd$2 as PathCmd, RenderPageOptions, RenderPageToBitmapOptions, RubyAnnotation, RunRevision, SectionGeom, SectionProps, ShapeRun, ShapeText$1 as ShapeText, ShapeTextRun$1 as ShapeTextRun, TabStop$1 as TabStop, TableBorders, TblpPr, TextPath, WireRenderPageOptions, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, isOoxmlDecodedImageLimitError, noteText, openExternalHyperlink };
-}
-//#endregion
-//#region dist/.types-work/common-Bgczc_Eb.d.ts
-//#region packages/core/src/types/common.d.ts
-type PathCmd$1 = {
-    cmd: 'moveTo';
-    x: number;
-    y: number;
-} | {
-    cmd: 'lineTo';
-    x: number;
-    y: number;
-} | {
-    cmd: 'cubicBezTo';
-    x1: number;
-    y1: number;
-    x2: number;
-    y2: number;
-    x: number;
-    y: number;
-} | {
-    cmd: 'arcTo';
-    wr: number;
-    hr: number;
-    stAng: number;
-    swAng: number;
-} | {
-    cmd: 'close';
-};
-type Fill = SolidFill | NoFill | GradientFill | PatternFill | ImageFill;
-interface SolidFill {
-    fillType: 'solid';
-    color: string;
-}
-interface NoFill {
-    fillType: 'none';
-}
-interface GradientStop {
-    position: number;
-    color: string;
-}
-interface GradientFill {
-    fillType: 'gradient';
-    stops: GradientStop[];
-    /** degrees: 0 = left→right, 90 = top→bottom */
-    angle: number;
-    /** 'linear' | 'radial' */
-    gradType: string;
-}
-/**
- * Preset pattern fill — ECMA-376 §20.1.8.40 (CT_PatternFillProperties)
- * with `preset` drawn from §20.1.10.59 (ST_PresetPatternVal).
- */
-interface PatternFill {
-    fillType: 'pattern';
-    /** Foreground hex colour — used for the "1" pixels of the preset bitmap. */
-    fg: string;
-    /** Background hex colour — used for the "0" pixels. */
-    bg: string;
-    /** Preset name, e.g. "pct25", "horz", "diagCross", "lgGrid". */
-    preset: string;
-}
-/**
- * ECMA-376 §20.1.8.30 (CT_RelativeRect) — the destination rectangle a stretched
- * blip is mapped into, as edge insets relative to the fill region. Values are
- * fractions (ST_Percentage / 100000); **negative values let the image bleed
- * past the box (overscan)**. Absent edges default to 0.
- */
-interface FillRect {
-    l?: number;
-    t?: number;
-    r?: number;
-    b?: number;
-}
-/**
- * ECMA-376 §20.1.8.58 (CT_TileInfoProperties) — tiled blip-fill placement.
- * The blip repeats at its native size (scaled by sx/sy) across the fill box.
- * Mutually exclusive with {@link ImageFill.fillRect} (the `stretch` mode).
- */
-interface TileInfo {
-    /** Horizontal offset of the first tile, in EMU (`tx`). Default 0. */
-    tx: number;
-    /** Vertical offset of the first tile, in EMU (`ty`). Default 0. */
-    ty: number;
-    /** Horizontal tile scale as a fraction (`sx` / 100000). Default 1.0. */
-    sx: number;
-    /** Vertical tile scale as a fraction (`sy` / 100000). Default 1.0. */
-    sy: number;
-    /** Mirror mode: `'none' | 'x' | 'y' | 'xy'` (`flip`). Default `'none'`. */
-    flip: string;
-    /**
-     * Anchor corner the tile grid registers against:
-     * `tl|t|tr|l|ctr|r|bl|b|br` (`algn`). Default `'tl'`.
-     */
-    algn: string;
-}
-/**
- * Image fill — ECMA-376 §20.1.8.14 (CT_BlipFillProperties). The embedded blip
- * is carried as a zip path + MIME; the renderer fetches the bytes on demand via
- * {@link RenderOptions.fetchImage} (no base64 inlined at parse time). Both
- * fill-modes are modelled and mutually exclusive: `stretch` (§20.1.8.56) carries
- * {@link ImageFill.fillRect}; `tile` (§20.1.8.58) carries {@link ImageFill.tile}.
- */
-interface ImageFill {
-    fillType: 'image';
-    /**
-     * Embedded zip path of the blip (e.g. "word/media/image1.png"), for the lazy
-     * byte-on-demand pipeline. The renderer fetches the bytes via a path-keyed
-     * loader ({@link RenderOptions.fetchImage}) instead of inlining base64.
-     */
-    imagePath: string;
-    /** MIME type of the blip at {@link ImageFill.imagePath} (e.g. `image/png`). */
-    mimeType: string;
-    /**
-     * `<a:stretch><a:fillRect>` insets. Absent → fills the whole box (or the
-     * fill is tiled — see {@link ImageFill.tile}).
-     */
-    fillRect?: FillRect;
-    /**
-     * `<a:tile>` descriptor. Present only when the blipFill is tiled; mutually
-     * exclusive with {@link ImageFill.fillRect}.
-     */
-    tile?: TileInfo;
-    /** `a:blip > a:alphaModFix@amt` as a fraction (0.0–1.0). Absent = opaque. */
-    alpha?: number;
-    /**
-     * ECMA-376 §20.1.8.23 `<a:duotone>` recolour, resolved to its two endpoint
-     * colours (through the slide theme). Absent ⇒ no duotone. When present the
-     * renderer maps the blip's luminance ramp between the two colours (core
-     * `applyDuotone`) — the same recolour a `<p:pic>` duotone applies, wired onto
-     * the picture-FILL path (§20.1.8.14) by issue #889.
-     */
-    duotone?: Duotone$1;
-}
-interface Shadow {
-    color: string;
-    alpha: number;
-    blur: number;
-    dist: number;
-    /** degrees clockwise from East */
-    dir: number;
-}
-/** ECMA-376 §20.1.8.17 (CT_GlowEffect) — coloured halo with blur radius. */
-interface Glow {
-    color: string;
-    alpha: number;
-    /** Blur radius in EMU. */
-    radius: number;
-}
-/** ECMA-376 §20.1.8.31 (CT_SoftEdgesEffect) — feather radius in EMU. */
-interface SoftEdge {
-    radius: number;
-}
-/** ECMA-376 §20.1.8.27 (CT_ReflectionEffect) — mirrored copy below the
- *  shape with a linear alpha gradient. Carries the spec attributes whose
- *  defaults the renderer needs to interpret correctly. */
-interface Reflection {
-    blur: number;
-    dist: number;
-    /** Direction in degrees, clockwise from East. */
-    dir: number;
-    /** Start alpha (0–1). Default 1.0. */
-    stA: number;
-    /** Start position along the gradient (0–1). Default 0. */
-    stPos: number;
-    /** End alpha. Default 0. */
-    endA: number;
-    /** End position. Default 1.0. */
-    endPos: number;
-    /** Horizontal scale (1.0 = same width). */
-    sx: number;
-    /** Vertical scale (-1.0 = full mirror). */
-    sy: number;
-}
-interface ArrowEnd {
-    /** OOXML type: "none" | "triangle" | "stealth" | "diamond" | "oval" | "arrow" */
-    type: string;
-    /** Width multiplier: "sm" | "med" | "lg" */
-    w: string;
-    /** Length multiplier: "sm" | "med" | "lg" */
-    len: string;
-}
-interface Stroke {
-    color: string;
-    /** Width in EMU */
-    width: number;
-    /** Authored non-solid DrawingML line paint. Solid lines use `color`. */
-    fill?: Exclude<Fill, {
-        fillType: 'image';
-    } | {
-        fillType: 'none';
-    }>;
-    /** OOXML prstDash value: "dash", "dot", "dashDot", "lgDash", "lgDashDot", etc. */
-    dashStyle?: string;
-    /** Canvas line cap normalized from DrawingML/VML (`flat` → `butt`). */
-    lineCap?: CanvasLineCap;
-    /** Arrow head at the start of the line */
-    headEnd?: ArrowEnd;
-    /** Arrow head at the end of the line */
-    tailEnd?: ArrowEnd;
-    /**
-     * ECMA-376 §20.1.8.42 ST_CompoundLine. "sng" (default) | "dbl" |
-     * "thinThick" | "thickThin" | "tri". Absent means single line.
-     */
-    cmpd?: string;
-}
-interface TextBody$1 {
-    /** Vertical anchor: "t" | "ctr" | "b" */
-    verticalAnchor: string;
-    paragraphs: Paragraph$1[];
-    /** Default pt size from lstStyle (overrides renderer default when present) */
-    defaultFontSize: number | null;
-    /** Inherited bold from layout/master defRPr (null = not set, use false as final default) */
-    defaultBold: boolean | null;
-    /** Inherited italic from layout/master defRPr (null = not set, use false as final default) */
-    defaultItalic: boolean | null;
-    /** Text insets in EMU (defaults: lIns=rIns=91440, tIns=bIns=45720) */
-    lIns: number;
-    rIns: number;
-    tIns: number;
-    bIns: number;
-    /** "square" = wrap, "none" = no wrap */
-    wrap: string;
-    /** Text direction: "horz" | "vert" | "vert270" | "eaVert" etc. */
-    vert: string;
-    /** Auto-fit: "sp" = shape grows to fit text, "norm" = font shrinks, "none" = no fit */
-    autoFit: string;
-    /**
-     * `<a:normAutofit fontScale>` (ECMA-376 §21.1.2.1.3) — PowerPoint's stored,
-     * pre-computed font-shrink ratio for `autoFit === "norm"`, as a fraction
-     * (e.g. 0.625 for `fontScale="62500"`). Null/absent when PowerPoint stored no
-     * scale; the renderer then re-derives one. Applying the stored value matches
-     * PowerPoint exactly instead of guessing from our own text metrics.
-     */
-    fontScale?: number | null;
-    /** `<a:normAutofit lnSpcReduction>` — stored line-spacing reduction fraction
-     *  (e.g. 0.20 for `lnSpcReduction="20000"`). Null/absent when not stored. */
-    lnSpcReduction?: number | null;
-    /**
-     * `<a:bodyPr numCol>` (ECMA-376 §20.1.10.34) — number of text columns inside
-     * the shape. Defaults to 1; values > 1 cause the renderer to flow paragraphs
-     * across N columns left-to-right, top-to-bottom.
-     */
-    numCol?: number;
-    /** `<a:bodyPr spcCol>` — gap between columns in EMU. Default 0. */
-    spcCol?: number;
-}
-type SpaceLine = {
-    type: 'pct';
-    val: number;
-} | {
-    type: 'pts';
-    val: number;
-};
-/**
- * A paragraph's bullet marker. For `char`, the marker size is EITHER `sizePct`
- * (a percentage of the run size — ECMA-376 §21.1.2.4.9 `<a:buSzPct>`) OR `sizePts`
- * (an absolute size in points — §21.1.2.4.10 `<a:buSzPts>`), never both: they are
- * the one `EG_TextBulletSize` xsd:choice. `sizePts` is optional (absent when no
- * `<a:buSzPts>` was declared); when present it takes precedence over `sizePct`.
- */
-type Bullet$1 = {
-    type: 'none';
-} | {
-    type: 'inherit';
-} | {
-    type: 'char';
-    char: string;
-    color: string | null;
-    sizePct: number | null;
-    sizePts?: number;
-    fontFamily: string | null;
-} | {
-    type: 'autoNum';
-    numType: string;
-    startAt: number | null;
-    color: string | null;
-};
-interface TabStop {
-    /** Position in EMU from the LEADING text-inset edge of the text area —
-     *  logical, not physical (ECMA-376 §21.1.2.1): the left edge (after lIns)
-     *  in an LTR paragraph, the right edge (before rIns) in an RTL
-     *  (`<a:pPr rtl="1">`) paragraph. */
-    pos: number;
-    /** Alignment: "l" | "r" | "ctr" | "dec" */
-    algn: string;
-}
-interface Paragraph$1 {
-    /** Alignment: "l" | "ctr" | "r" | "just" */
-    alignment: string;
-    /** Left margin in EMU */
-    marL: number;
-    /** Right margin in EMU */
-    marR: number;
-    /** First-line indent in EMU (negative = hanging indent) */
-    indent: number;
-    spaceBefore: number | null;
-    spaceAfter: number | null;
-    spaceLine: SpaceLine | null;
-    /** List nesting level (0–8) */
-    lvl: number;
-    bullet: Bullet$1;
-    defFontSize: number | null;
-    defColor: string | null;
-    defBold: boolean | null;
-    defItalic: boolean | null;
-    defFontFamily: string | null;
-    /** Tab stops from pPr > tabLst */
-    tabStops: TabStop[];
-    /**
-     * `<a:pPr rtl="1">` — right-to-left paragraph (ECMA-376 §21.1.2.2.7).
-     * When true and no explicit `algn`, the parser-side default flips from
-     * "l" to "r"; renderers can also use this flag to flow runs RTL.
-     */
-    rtl?: boolean;
-    runs: TextRun[];
-}
-type TextRun = TextRunData | LineBreak | EquationRun;
-/**
- * An OMML equation embedded in a paragraph (ECMA-376 §22.1). Parsed into the
- * shared math AST and rendered by `@silurus/ooxml-core`'s math engine.
- * PowerPoint stores these as `a14:m` inside `mc:AlternateContent`.
- */
-interface EquationRun {
-    type: 'math';
-    /** Parsed OMML node list. */
-    nodes: MathNode[];
-    /** True for block (`m:oMathPara`) math, false for inline (`m:oMath`). */
-    display: boolean;
-    /** Paragraph default run size in pt, if declared; absent → renderer inherits. */
-    fontSize?: number | null;
-    /** Equation colour (hex, no '#') from the math run's rPr; absent → inherit. */
-    color?: string | null;
-}
-interface TextRunData {
-    type: 'text';
-    text: string;
-    /** null = not set, inherit from paragraph/body defaults */
-    bold: boolean | null;
-    /** null = not set, inherit from paragraph/body defaults */
-    italic: boolean | null;
-    underline: boolean;
-    /**
-     * Specific underline style when not the default single line. Values come
-     * from ECMA-376 §21.1.2.3.16 (ST_TextUnderlineType): "dbl", "heavy",
-     * "dotted", "dottedHeavy", "dash", "dashHeavy", "dashLong",
-     * "dashLongHeavy", "dotDash", "dotDashHeavy", "dotDotDash",
-     * "dotDotDashHeavy", "wavy", "wavyHeavy", "wavyDbl". Absent means either
-     * no underline (when `underline` is false) or the default single line.
-     */
-    underlineStyle?: string;
+     *  Set by the Ctrl/⌘+wheel handler right before it calls `setScale` so the zoom
+     *  pivots on the cursor ("zoom toward the pointer") in BOTH axes; consumed and
+     *  cleared by `setScale`. `null` for every non-gesture source (the public
+     *  `setScale`, the +/- steppers, `fitWidth`/`fitPage`, the resize re-fit), which
+     *  keep the historical viewport-TOP re-anchor so their behaviour is unchanged. */
+    private _pendingZoomAnchor;
+    /** Observes the container so a width change re-fits the base scale. Disconnected
+     *  in `destroy()`. */
+    private _resizeObserver;
+    /** The base fit scale at the last established/re-fit layout. `_onResize` divides
+     *  `_scale` by this to recover the current zoom multiplier so a width change
+     *  re-fits the base while preserving the user's zoom (design §11). */
+    private _prevBase;
+    /** The fit width (px) the base scale was last established at. Lets `_onResize`
+     *  skip the re-fit when only the height changed (a ResizeObserver fires on ANY
+     *  box change, but only a WIDTH change alters the fit-to-width base scale). */
+    private _lastFitWidth;
+    /** Resolved page-canvas `box-shadow` (design: the recipe drop shadow by
+     *  default). Resolved ONCE with `??` — NOT `||` — so `pageShadow: false`
+     *  survives as the "no shadow" sentinel (a `||` would treat `false` as absent
+     *  and wrongly re-apply the default). Applied by `_applyPageShadow` at EVERY
+     *  canvas-creation site (`_acquireSlot` and the double-buffer spare in
+     *  `_settleSlot`) so a recycled/re-mounted slot and a settle-swapped spare all
+     *  carry it. */
+    private readonly _pageShadow;
+    private readonly _find;
+    private _findActive;
+    constructor(container: HTMLElement, opts?: DocxScrollViewerOptions);
     /**
-     * Underline-only colour from rPr > uFill (ECMA-376 §21.1.2.3.20). Absent
-     * means the underline follows the text colour (uFillTx default).
+     * Load a DOCX from URL or ArrayBuffer and render the first window.
+     * UNSUPPORTED when an engine was injected via `opts.document` (throws) — the
+     * caller already owns the parsed engine.
      */
-    underlineColor?: string;
-    /** True when rPr strike is sngStrike or dblStrike. */
-    strikethrough: boolean;
+    load(source: string | ArrayBuffer): Promise<void>;
+    get pageCount(): number;
+    /** CSS px width of page `i` at the current scale. */
+    private _pageWidthPx;
+    /** CSS px height of page `i` at the current scale. */
+    private _pageHeightPx;
+    /** The fit width (px), deferring when the container is unlaid-out. An EXPLICIT
+     *  `opts.width` is the page's CSS-width contract and is returned UNCHANGED (the
+     *  gutters still apply around placement, not to the width). The container-derived
+     *  default instead targets `containerWidth − padL − padR` so a page sits INSIDE
+     *  the horizontal gutters at 100%. A non-positive result (gutters wider than the
+     *  container) is treated as unlaid-out — the same deferral as a zero-width box. */
+    private _fitWidthPx;
+    /** Base scale: first page's width fit to the fit-width. Returns 0 when the
+     *  container has no width yet (deferral). */
+    private _baseScale;
     /**
-     * True only when rPr strike = "dblStrike". Lets the renderer draw two parallel
-     * lines instead of one. ECMA-376 §21.1.2.3.10 (ST_TextStrikeType).
+     * Recompute per-page heights + the spacer and re-mount the visible window.
+     *
+     * The viewer already calls this automatically after `load()`, an injected
+     * engine, a container resize, and a zoom, so most integrations never need it.
+     * It is public as a deliberate escape hatch: if the host mutates the layout in
+     * a way the `ResizeObserver` cannot observe (e.g. a CSS change on an ancestor
+     * that resizes the container without a box-size event, or a font that finishes
+     * loading after first paint), call `relayout()` to force a re-fit. Idempotent —
+     * safe to call repeatedly, and a no-op while the container has zero width (the
+     * fit is deferred until width appears, design §11).
      */
-    strikeDouble?: boolean;
-    /** Font size in points */
-    fontSize: number | null;
-    color: string | null;
-    fontFamily: string | null;
+    relayout(): void;
+    private _recomputeHeights;
+    private _gap;
+    private _overscan;
+    /** Desk padding fed to `computeVisibleRange`: `paddingTop`/`paddingBottom`,
+     *  each defaulting to `gap` (uniform rhythm). Resolved here (not stored) to
+     *  mirror `_gap()`/`_overscan()`, and consumed at EVERY `computeVisibleRange`
+     *  call site so the padded offsets are the single source of geometry. */
+    private _pad;
+    /** Horizontal desk gutters: `paddingLeft`/`paddingRight`, each defaulting to
+     *  `gap` (uniform rhythm — the horizontal gutters match the vertical padding).
+     *  Consumed by `_fitWidthPx` (to shrink the container-derived fit), by
+     *  `_positionSlot` (the flush-left floor), and by `_syncSpacer` (the spacer
+     *  width). Resolved here (not stored) to mirror `_gap()`/`_pad()`. */
+    private _padH;
+    /** Index of the page whose slot spans content-offset `y` (largest `i` with
+     *  `offsets[i] <= y`), for the pointer-anchored zoom re-anchor. Mirrors the
+     *  `topIndex` search `computeVisibleRange` runs for the scrollTop, but for an
+     *  ARBITRARY content-y (the pointer, not the viewport top). Clamped into
+     *  `[0, n-1]`; a `y` below the first page (inside the leading pad) yields 0. */
+    private _pageIndexAtOffset;
+    private _range;
+    private _syncSpacer;
+    /** Horizontal scroll extent: the widest page (docx pages can differ in width)
+     *  plus both gutters. A spacer NARROWER than the container never creates a
+     *  scrollbar (scrollWidth = max(clientWidth, content)), so it is always safe to
+     *  set — it only matters when a zoomed-in page grows past the viewport, where it
+     *  gives the gutters something to scroll to on either side. Max over per-page
+     *  widths so the extent covers the widest page in the document. Called from
+     *  `_syncSpacer` and after every scale change (zoom / resize re-fit) so the
+     *  extent tracks the current page px width. */
+    private _syncSpacerWidth;
+    private _onScroll;
+    /** Mount/recycle slots for the current visible window. */
+    private _mountVisible;
+    /** Apply the resolved page-canvas shadow (design: recipe drop shadow by
+     *  default, `false` ⇒ none). Single source so `_acquireSlot` and the
+     *  double-buffer spare in `_settleSlot` stay in lock-step — a spare that missed
+     *  this would lose the shadow on the settle swap. `box-shadow` never affects
+     *  layout, so this is safe to (re)set on a live/pooled canvas without shifting
+     *  any offset. */
+    private _applyPageShadow;
+    private _acquireSlot;
+    private _recycleSlot;
+    private _positionSlot;
+    /** Device-pixel ratio for a render (opts override → window → 1). */
+    private _dpr;
     /**
-     * East Asian font family from rPr > a:ea (ECMA-376 §21.1.2.3.7),
-     * resolved through the theme. Renderer uses this for CJK glyphs when
-     * present; absent means CJK falls back to fontFamily.
+     * Render page `i` into `slot`. Routes strictly on the constructor-resolved
+     * `_mode` (design §11 — no probing, no silent mis-pathing): `main` ⇒ paint the
+     * slot's canvas directly via `renderPage`; `worker` ⇒ transfer an ImageBitmap
+     * from `renderPageToBitmap`.
+     *
+     * Slot-identity guard: a slot recycled to a DIFFERENT page while a previous
+     * render is in flight must not repaint the stale page. `slot.renderedPage`
+     * tracks the page this slot is committed to; we stamp it up-front and bail on
+     * resolution if it changed (the engine's own token guard is per-canvas; this is
+     * the viewer's per-slot page-identity check).
+     *
+     * Render epoch (main path): pixel staleness after a mid-flight `setScale` is
+     * already handled by the engine's per-canvas token (the newer renderPage on the
+     * same canvas wins) — `setScale` recycles + re-mounts, and the re-mount always
+     * re-dispatches `renderPage` (renderedPage reset to -1), so a fresh render is
+     * always issued. But the viewer-side side effects of a STALE resolution — the
+     * text-layer build (its run geometry is at the OLD scale) and the renderedPage
+     * bookkeeping — must NOT run, or a superseded render would rebuild the overlay
+     * with stale x/y/w/h (the pool reuses slot objects, so the identity check alone
+     * can pass for an old-epoch resolution). We gate them on the captured epoch.
      */
-    fontFamilyEa?: string;
+    private _renderSlot;
     /**
-     * Symbol font family from rPr > a:sym (ECMA-376 §21.1.2.3.10), resolved
-     * through the theme. PowerPoint stores symbol-font glyphs as Private-Use
-     * codepoints U+F020–U+F0FF; the renderer uses this font to resolve them.
-     * Absent means no symbol font was declared.
+     * IX1/IX-nav — the click handler passed to the text-layer overlay. When the
+     * caller supplied `onHyperlinkClick`, it fully owns the behaviour (the default
+     * is suppressed). Otherwise the built-in default is: an external link opens in
+     * a new tab through core `openExternalHyperlink` (URL sanitised against the
+     * safe scheme allowlist, `noopener,noreferrer`); an internal `<w:anchor>` link
+     * resolves its bookmark name to its destination page via
+     * {@link DocxDocument.getBookmarkPage} (ECMA-376 §17.16.23) and scrolls there
+     * with {@link scrollToPage}. An anchor naming no known bookmark is a safe no-op
+     * rather than a scroll to a guessed page.
+     *
+     * IX1 — returns `undefined` when `enableHyperlinks` is `false`, the single gate
+     * that disables hyperlink interactivity: {@link buildDocxTextLayer} treats a
+     * missing handler as "render link runs like plain runs", so no hit region,
+     * cursor, tooltip, listener, or navigation is wired (a custom
+     * `onHyperlinkClick` is suppressed too).
      */
-    fontFamilySym?: string;
-    /** Baseline shift in thousandths of a point. Positive = superscript, negative = subscript. */
-    baseline?: number;
+    private _hyperlinkHandler;
+    /** A width-measurer primed with a run's `font` — used ONLY to clamp a §17.3.2.10
+     *  縦中横 selection span to its drawn one-em cell (#836). Mirrors DocxViewer's
+     *  `_measureForFont`. Returns a length-based fallback when canvas metrics are
+     *  unavailable so the caller still gets a callable (the overlay then sees scale
+     *  1 and leaves the span un-clamped). */
+    private _measureForFont;
+    /** A canvas's intended CSS box in px (the % denominators the overlay builders
+     *  expect). Reads the inline `style.width`/`height` set by the render path,
+     *  falling back to the backing-store size when unset; tolerates the `px` suffix. */
+    private _canvasCssPx;
+    /** Route an async render failure to `onError`, or `console.error` when none is
+     *  set (so failures are never fully silent), and never after teardown. */
+    private _reportRenderError;
     /**
-     * Capitalisation transform — ECMA-376 §21.1.2.3.13 (ST_TextCapsType).
-     * 'all' renders text in upper case; 'small' uses small caps (rendered as
-     * upper case at ~80% size when no smcp font feature is available).
-     * 'none' or omitted leaves the text unchanged.
+     * Worker-mode slot render: dispatch `renderPageToBitmap`, transfer the result
+     * via a per-slot `bitmaprenderer` context, and manage the ImageBitmap lifecycle.
+     *
+     * Coalescing / drop-stale (design §11):
+     *  - Skip if page `i` is already in flight (a scroll storm won't double-dispatch).
+     *  - Skip if page `i` already left the mounted window before dispatch.
+     *  - On resolution, if `slot` is no longer THIS page's live slot (it recycled to
+     *    another page, or page `i` re-mounted onto a DIFFERENT slot while this render
+     *    was in flight), close the orphan bitmap and skip the paint. In that
+     *    re-mount case a live slot for `i` still awaits a render, so once we clear
+     *    the in-flight guard we re-dispatch it — a page that recycled and re-mounted
+     *    mid-flight must never stay blank.
+     *  - RENDER EPOCH: the dispatch captures `this._renderEpoch`. `setScale` bumps
+     *    the epoch, so a resolution whose captured epoch ≠ the live epoch is STALE
+     *    even when the SAME slot object is still mounted for page `i` (the pool
+     *    reuses slot objects, so the identity check alone can't catch a zoom that
+     *    happened mid-flight). A moved epoch ⇒ close the orphan + re-dispatch the
+     *    live slot at the new scale, never paint the old-scale bitmap.
      */
-    caps?: 'none' | 'small' | 'all';
+    private _renderSlotBitmap;
     /**
-     * Inter-character spacing in 100ths of a point — ECMA-376 §21.1.2.3.5
-     * (rPr @spc). Positive values add space, negative values tighten.
+     * Set the absolute px-per-pt zoom scale, clamped inline to
+     * `[zoomMin ?? 0.1, zoomMax ?? 4]` (absolute bounds, XlsxViewer convention — NOT
+     * multiples of the base fit; design §3 keeps the clamp in the viewer, not core),
+     * then re-anchor VERTICALLY so the page currently under the viewport top stays
+     * fixed. A no-op when the clamped scale is unchanged. Called BEFORE the doc is
+     * loaded / the base fit is established, the clamped factor is LATCHED (IX9 F1,
+     * family-unified with the single-canvas viewers) and applied by `relayout()`
+     * once the layout establishes — `onScaleChange` fires then.
+     *
+     * FLICKER-FREE (design §7): this does NOT re-render the visible pages inline.
+     * It shows an immediate CSS preview (stretch the existing bitmaps, scale the
+     * overlays) and DEBOUNCES a full-resolution settle re-render for ZOOM_SETTLE_MS,
+     * so a wheel/pinch burst never blanks a page and coalesces into one crisp render.
+     *
+     * Re-anchor (written from scratch — XlsxViewer only re-anchors horizontally):
+     * capture `top = topIndex` and the intra-page fraction `intraFrac` from the
+     * CURRENT range BEFORE rescale; after recomputing heights at the new scale,
+     * `newScrollTop = offsets'[top] + intraFrac × heights'[top]`, clamped to
+     * `[0, totalHeight' − viewportHeight]`. Because a page's height scales linearly
+     * with `_scale`, the same fractional position maps exactly to the new geometry.
+     *
+     * CAVEAT — base fit below the floor: `relayout()` sets `_scale = base` WITHOUT
+     * clamping to `[zoomMin, zoomMax]`. If the base fit is below `zoomMin` (a wide
+     * page in a narrow container), the initial scale sits under the floor, but once
+     * the user zooms via `setScale` the clamp pins the minimum to `zoomMin`, so they
+     * can no longer return below the floor to the original base fit through this API.
      */
-    letterSpacing?: number;
-    /** Set for OOXML field runs (e.g. "slidenum"). When set, renderer replaces text with field value. */
-    fieldType?: string;
+    setScale(scale: number): void;
+    /** IX9 {@link ZoomableViewer} — the current zoom factor, where `1` = 100% (a
+     *  page at its natural pt→px width). This is the viewer's absolute `_scale`
+     *  (`widthPt × PT_TO_PX × _scale` is the drawn width), so it reads `1` at true
+     *  100% and, after the initial fit-to-width, the base fit factor. Before the
+     *  fit is established it reports a latched pre-load `setScale` (IX9 F1) if one
+     *  is pending — matching what a single-canvas viewer would show — else `1`. */
+    getScale(): number;
+    /** IX9 {@link ZoomableViewer} — step up to the next rung of the shared zoom
+     *  ladder above the current factor (clamped to `zoomMax` by {@link setScale}). */
+    zoomIn(): void;
+    /** IX9 {@link ZoomableViewer} — step down to the next lower ladder rung. */
+    zoomOut(): void;
     /**
-     * Hyperlink target resolved from rPr > a:hlinkClick @r:id via the slide's _rels.
-     * For an external link this is the URL; for an internal slide jump it is the
-     * resolved internal part name (e.g. "../slides/slide3.xml"). Undefined for runs
-     * without a hyperlink. ECMA-376 §21.1.2.3.5 (CT_Hyperlink).
+     * IX9 {@link ZoomableViewer} — fit a page's WIDTH to the container (the classic
+     * continuous-scroll "fit width"). Sets the scale to the width-fit base for the
+     * current container, then re-anchors + re-renders via {@link setScale}. Defers
+     * (no-op) while the container is unlaid-out. Note the `zoomMin`/`zoomMax` clamp
+     * still applies, so a fit below `zoomMin` pins to `zoomMin`.
      */
-    hyperlink?: string;
+    fitWidth(): void;
     /**
-     * Raw `<a:hlinkClick @action>` string (e.g. "ppaction://hlinksldjump") when
-     * present — its presence marks {@link hyperlink} as an INTERNAL PowerPoint
-     * action (slide jump / first / last …) rather than an external URL. Undefined
-     * when the hlinkClick has no @action. ECMA-376 §21.1.2.3.5. (IX1)
+     * IX9 {@link ZoomableViewer} — fit a WHOLE page (width and height) inside the
+     * container so one page is visible without scrolling; takes the tighter of the
+     * width/height fit. Uses the FIRST page's size (the continuous viewer's fit
+     * reference, matching the base-fit convention). Defers while unlaid-out.
      */
-    hyperlinkAction?: string;
+    fitPage(): void;
+    /** Shared fit for {@link fitWidth}/{@link fitPage}: the width-fit factor is the
+     *  established base (`_baseScale`); the page-fit additionally bounds by the
+     *  container height against the first page's height. Applies via {@link setScale}
+     *  so the flicker-free re-anchor / settle path and `onScaleChange` all run. */
+    private _fit;
     /**
-     * Run-level drop shadow on glyphs (`<a:rPr><a:effectLst><a:outerShdw>`),
-     * ECMA-376 §20.1.8.45. Independent of the shape-level shadow on `spPr`.
-     * Absent means no run-level shadow.
+     * CSS preview of the visible window at the current `_scale` (design §7
+     * mechanism 1), WITHOUT re-rendering. Slots leaving the window recycle normally;
+     * slots ENTERING the window mount fresh (rendered at the current scale directly,
+     * so they never need a preview); slots that STAY are repositioned and their
+     * canvas + text overlay are CSS-transformed to the new size (the device buffer
+     * is untouched — that is the whole point: no synchronous clear, no blank frame).
      */
-    shadow?: Shadow;
+    private _previewVisible;
     /**
-     * Run-level glyph outline (`<a:rPr><a:ln w="..">`), ECMA-376 §20.1.2.2.24
-     * (CT_TextOutlineEffect). Renderer strokes each glyph with the given
-     * width / colour in addition to the normal fill. Absent means glyphs are
-     * fill-only.
+     * CSS-preview a single already-mounted slot at the new geometry (design §7): the
+     * wrapper is repositioned + sized (via `_positionSlot`), the canvas bitmap is
+     * STRETCHED to the new CSS size (no `canvas.width` — the device buffer, and thus
+     * the drawn pixels, are left intact, just scaled by the browser), and the text
+     * overlay is scaled by `newScale / renderedScale` so it tracks the stretched
+     * page. `renderedScale <= 0` means the slot's first render hasn't resolved yet
+     * (nothing to stretch); the pending render captured the current scale, so it
+     * lands correct and no preview is needed.
      */
-    outline?: TextOutline;
+    private _previewSlot;
+    /** (Re)schedule the debounced settle re-render (design §7 mechanism 2). Resets
+     *  the timer on every call so a burst of `setScale` dispatches ONE settle
+     *  ZOOM_SETTLE_MS after the LAST call. Cleared in `destroy()`. */
+    private _scheduleSettle;
+    /** Full-resolution settle re-render of the visible window (design §7 mechanisms
+     *  2+3). Re-renders each mounted slot at the current scale via the double-buffer
+     *  swap (main) / same-canvas transfer (worker). Both modes rebuild the text
+     *  overlay from the fresh render's run geometry (IX6 — worker mode collects the
+     *  runs off-thread via `_renderSlotBitmap`) and clear the preview transform.
+     *  Dispatched at the CURRENT epoch; the existing epoch gate discards it if a
+     *  later `setScale` supersedes it mid-render. */
+    private _settleRender;
     /**
-     * Run-level text highlight / marker colour (`<a:rPr><a:highlight>`),
-     * ECMA-376 §21.1.2.3.4. In DrawingML this is a full CT_Color (any
-     * srgbClr / schemeClr / sysClr / prstClr + transforms), unlike
-     * WordprocessingML's fixed 16-name highlight enum — so the parser already
-     * resolves it through the theme/clrMap. The value is a hex string without
-     * `#` (6-char opaque, or 8-char RRGGBBAA when an alpha transform applies);
-     * the renderer paints a background rectangle behind the run's glyphs.
-     * Absent means no highlight.
+     * Settle-render one slot at the current scale (design §7 mechanism 3).
+     *
+     * WORKER: re-dispatch the bitmap render into the SAME canvas. The worker path
+     * sizes the device buffer and `transferFromImageBitmap`s it in ONE synchronous
+     * step (no await between `canvas.width = …` and the transfer), so the browser
+     * never composites an intermediate blank frame — no spare canvas is needed. The
+     * `renderedScale === _scale` gate in `_settleRender` plus the epoch gate inside
+     * `_renderSlotBitmap` keep this correct and idempotent.
+     *
+     * MAIN: `renderPage` (via renderDocumentToCanvas) synchronously sets
+     * `canvas.width = …` (which CLEARS the backing store to blank) BEFORE its first
+     * await and paints AFTER — so rendering into the on-screen canvas would flash it
+     * white. Render into a SPARE off-DOM canvas instead; only once it resolves at the
+     * current epoch do we swap it into the wrapper (replacing the old canvas, which is
+     * DISCARDED — the pooled unit is the slot, not the canvas). The old canvas keeps
+     * showing the stretched preview until the instant of the swap — blank-free.
      */
-    highlight?: string;
-}
-/** Run-level glyph outline. Width is in OOXML EMU (12700 EMU = 1 pt). */
-interface TextOutline {
-    width: number;
-    /** Hex without '#'. Absent = inherit from text fill colour. */
-    color?: string;
-}
-interface LineBreak {
-    type: 'break';
-}
-interface RenderOptions {
-    width?: number;
-    defaultTextColor?: string | null;
-    dpr?: number;
-    majorFont?: string | null;
-    minorFont?: string | null;
-    /** Theme hyperlink colour (hex 6 chars). Used to colour hyperlink runs without an explicit colour. */
-    hlinkColor?: string | null;
+    private _settleSlot;
     /**
-     * Lazily resolve an archive-internal asset (by zip path) to a Blob. The
-     * renderer uses this to fetch posters and other large embedded assets on
-     * demand, keeping the parse output free of inlined base64.
+     * Scroll so page `index`'s top edge sits at the viewport top. Clamps `index` to
+     * `[0, pageCount-1]` (the pager convention) and the resulting scrollTop to
+     * `[0, totalHeight − viewportHeight]` so the last pages don't scroll past the
+     * end. A no-op when nothing is loaded or the document is empty.
+     *
+     * `opts.behavior` ('auto' | 'smooth', default 'auto') is honoured via
+     * `scrollHost.scrollTo({ top, behavior })` when the host supports it (a real
+     * browser); the stub-DOM has no `scrollTo`, so the fallback sets `scrollTop`
+     * directly (which is what the tests assert). We then call `_mountVisible` once.
+     *
+     * MOUNTING CAVEAT: synchronous mounting of the target page is guaranteed only on
+     * the DEFAULT/'auto' path — there `scrollTop` has already jumped to `top`, so the
+     * `_mountVisible` call reads the final scroll position and the target page's slots
+     * exist immediately. With `behavior: 'smooth'` the scroll animates ASYNCHRONOUSLY:
+     * `scrollTop` is still near the old position when `_mountVisible` runs, so the
+     * target page mounts lazily via the animation's subsequent `scroll` events, not
+     * from this call.
      */
-    fetchMedia?: (path: string) => Promise<Blob>;
+    scrollToPage(index: number, opts?: {
+        behavior?: 'auto' | 'smooth';
+    }): void;
+    /** Search the complete document, including pages outside the virtualized
+     * mounted window. Matching is case-insensitive by default. */
+    findText(query: string, opts?: FindMatchesOptions): Promise<FindMatch<DocxMatchLocation>[]>;
+    /** Activate and reveal the next match, wrapping at the end. */
+    findNext(): Promise<FindMatch<DocxMatchLocation> | null>;
+    /** Activate and reveal the previous match, wrapping at the beginning. */
+    findPrev(): Promise<FindMatch<DocxMatchLocation> | null>;
+    /** Clear the current query and every mounted highlight. */
+    clearFind(): void;
+    private _activateMatch;
+    private _collectPageRuns;
+    private _redrawHighlights;
+    private _refreshFindRuns;
+    private _redrawSlotHighlights;
     /**
-     * Lazily resolve an embedded image (by zip path + MIME) to a Blob. Twin of
-     * {@link RenderOptions.fetchMedia} for pictures and blip fills: the renderer
-     * fetches raster/SVG bytes on demand and decodes them (`createImageBitmap` /
-     * path-keyed `<img>`), so the parse output carries only paths, never base64.
+     * Re-fit the base scale on a container resize while PRESERVING the current zoom
+     * multiplier (design §11), then re-anchor + re-render. A `ResizeObserver` fires
+     * on any box change, but only a WIDTH change alters the fit-to-width base scale;
+     * a height-only change skips the re-fit yet STILL re-mounts the visible window
+     * (via `_mountVisible`), because a taller viewport reveals rows that were below
+     * the fold and would otherwise stay blank until the next scroll. Empty/unloaded
+     * ⇒ no-op; a still-zero width ⇒ defer.
+     *
+     * Zero-width recovery: a container that was 0-wide at construction never
+     * established a scale (`_scaleEstablished` is false), so the first non-zero
+     * resize establishes it here via `relayout()` — completing the T2 deferral.
+     *
+     * Re-fit math (zoom multiplier preserved):
+     *   mult      = _scale / _prevBase            (the user's zoom over the old base)
+     *   newScale  = newBase × mult
+     * Routing through `setScale(newScale)` bumps `_renderEpoch` (resize IS an epoch
+     * event — T4 banner) and re-anchors + CSS-previews + debounces a settle re-render
+     * of every slot at the new geometry, exactly like a zoom (design §7 flicker-free
+     * path — a rapid ResizeObserver burst therefore also coalesces into one settle).
+     * `setScale`'s clamp/no-op guards apply: an unchanged newScale (identical width)
+     * is a no-op there — so we short-circuit BEFORE it when the fit-width is
+     * unchanged (mounting the revealed window without a needless re-render), and
+     * after it we call `_mountVisible` again to cover the case where the clamp made
+     * `setScale` no-op yet the viewport still grew.
      */
-    fetchImage?: (path: string, mimeType: string) => Promise<Blob>;
+    private _onResize;
+    get topVisiblePage(): number;
+    /** Return the owning engine's latest content-free package-usage snapshot. */
+    getResourceMetrics(): Promise<OoxmlResourceMetrics>;
     /**
-     * When true, renderMedia draws only the poster frame — play/pause badges
-     * and progress bars are left to the caller. Set by the pptx presentSlide
-     * API so its interactive handle can own all control chrome without
-     * the static renderer drawing a duplicate play badge.
+     * Tear down the viewer: remove the DOM subtree and (only for a self-loaded
+     * engine) destroy the engine. An injected engine is left intact — the caller
+     * owns its lifecycle. Per-slot worker ImageBitmaps are closed on recycle.
      */
-    skipMediaControls?: boolean;
+    destroy(): void;
+}
+//#endregion
+//#region packages/docx/src/text-layer.d.ts
+/**
+ * Build the transparent text-selection overlay for a rendered docx page: one
+ * absolutely-positioned, color-transparent `<span>` per {@link DocxTextRunInfo}
+ * (emitted by `renderPage`'s `onTextRun`), so the browser's native selection
+ * lands on the drawn glyphs. Extracted verbatim from `DocxViewer._buildTextLayer`
+ * so both the pager (DocxViewer) and the continuous-scroll viewer (DocxScrollViewer)
+ * share one implementation; also public API for integrators building their own
+ * overlay (design §10). IX6 — usable in BOTH render modes: worker mode collects
+ * the same `DocxTextRunInfo[]` off-thread and ships it back beside the bitmap, so
+ * the overlay is built from identical geometry regardless of thread.
+ *
+ * Every span is positioned as a PERCENTAGE of `cssWidth`/`cssHeight` (the page's
+ * intended CSS-px box), never literal px, and the container's own width/height are
+ * left untouched (the caller sizes it `width:100%;height:100%`). This lets the
+ * overlay track the canvas's ACTUAL rendered box even when a consumer scales the
+ * canvas down with external CSS (`width:100%!important; height:auto`): the
+ * `display:inline-block` wrapper shrinks with the canvas, the `100%` container
+ * follows, and every `%`-placed span scales with it, so nothing overflows the
+ * wrapper into an ancestor's scroll area.
+ *
+ * @param layer            the overlay div (sized `width:100%;height:100%` by the caller).
+ * @param runs             per-run geometry from `renderPage({ onTextRun })`.
+ * @param cssWidth         the page's intended CSS width (px, number) — the %
+ *                         denominator for the x axis.
+ * @param cssHeight        the page's intended CSS height (px, number) — the %
+ *                         denominator for the y axis.
+ * @param onHyperlinkClick IX1 — invoked when a run carrying a resolved
+ *                         {@link HyperlinkTarget} is clicked. A hyperlink run's
+ *                         span keeps its transparent glyphs (the visible link
+ *                         colour/underline is already drawn on the canvas) but
+ *                         gains `cursor:pointer`, a `title` tooltip (the URL or
+ *                         bookmark ref) and this click handler. A plain
+ *                         `<span>` — not an `<a href>` — is used deliberately so
+ *                         the browser's own navigation can never bypass the
+ *                         caller's URL sanitisation. When omitted, link runs are
+ *                         rendered exactly like plain runs (no click affordance).
+ * @param measureForFont   optional width-measurer factory (primed with a run's
+ *                         `font`), used ONLY to clamp a §17.3.2.10 縦中横
+ *                         (eastAsianVert) span to its drawn one-em cell (#836):
+ *                         the span composes a `scaleX(run.w / naturalWidth)` so
+ *                         its selection extent matches the compressed glyphs
+ *                         instead of the run's natural ~2× width. When omitted,
+ *                         a 縦中横 span keeps the bare rotate (no regression for
+ *                         callers that do not thread a measurer).
+ */
+declare function buildDocxTextLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], cssWidth: number, cssHeight: number, onHyperlinkClick?: (target: HyperlinkTarget) => void, measureForFont?: (font: string) => (s: string) => number): void;
+//#endregion
+//#region packages/docx/src/find-highlight-layer.d.ts
+/** One page's highlight input: the run-slices a match covers, and whether that
+ *  match is the active one (emphasis colour). */
+interface DocxHighlightMatch {
+    slices: MatchRunSlice[];
+    active: boolean;
+}
+/** Format-specific compatibility alias for the shared colour contract. */
+type DocxHighlightColors = FindHighlightColors;
+/**
+ * Populate a highlight overlay layer with one box per matched run-slice.
+ *
+ * Every box is positioned as a PERCENTAGE of `cssWidth`/`cssHeight`, and the
+ * container's own size is left untouched (`width:100%;height:100%` from the
+ * caller), so the highlights track the canvas's ACTUAL rendered box even when a
+ * consumer scales the canvas down with external CSS — mirroring
+ * {@link buildDocxTextLayer}.
+ *
+ * @param layer    the overlay div (cleared here; sized `100%` by the caller).
+ * @param runs     the page's runs (same array the page was rendered/text-layered from).
+ * @param matches  the page's matches (run-slices + active flag).
+ * @param cssWidth  the page's intended CSS width (px, number) — the x-axis % denominator.
+ * @param cssHeight the page's intended CSS height (px, number) — the y-axis % denominator.
+ * @param measureForFont  returns a width-measurer primed with a run's `font`
+ *                        (the viewer closes over a canvas 2d context). Kept as a
+ *                        factory so the font is set once per run, not per glyph.
+ * @param colors   optional colour overrides.
+ */
+declare function buildDocxHighlightLayer(layer: HTMLDivElement, runs: DocxTextRunInfo[], matches: DocxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: DocxHighlightColors): void;
+declare namespace docx_d_exports {
+    export { AnchorHostMetrics, AutoResizeOptions, BodyElement, BorderSpec, CellBorders, CellElement, ChartRun, ColSpec, ColumnsSpec, DocComment, DocNote, DocParagraph, DocRevision, DocRun, DocSettings, DocTable, DocTableCell, DocTableRow, DocxDocument, DocxDocumentModel, DocxHighlightColors, DocxHighlightMatch, DocxMatchLocation, DocxRunBorder, DocxScrollViewer, DocxScrollViewerOptions, DocxTextRun, DocxTextRunInfo, DocxViewer, DocxViewerOptions, EmbeddedFontRef, FieldRun, FindHighlightColors, FindMatch, FindMatchesOptions, FramePr, GradientStop, HeaderFooter, HeadersFooters, HyperlinkTarget, ImageRun, LineEnd, LineNumbering, LineSpacing, LoadOptions$2 as LoadOptions, NoteRef, NumberingInfo, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorSource, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, PTabRun, PageBorderEdge, PageBorders, PageNumType, ParaBorderEdge, ParagraphBorders, PathCmd$1 as PathCmd, RenderPageOptions, RenderPageToBitmapOptions, RubyAnnotation, RunRevision, SectionGeom, SectionProps, ShapeRun, ShapeText$1 as ShapeText, ShapeTextRun$1 as ShapeTextRun, TabStop, TableBorders, TblpPr, TextPath, WireRenderPageOptions, autoResize, buildDocxHighlightLayer, buildDocxTextLayer, isOoxmlDecodedImageLimitError, noteText, openExternalHyperlink };
 }
 //#endregion
-//#region dist/.types-work/pptx-B9ExAlcU.d.ts
+//#region dist/.types-work/pptx-BVpCWU0A.d.ts
 //#region packages/pptx/src/types.d.ts
 /**
  * Picture bullet — ECMA-376 §21.1.2.4.2 `<a:buBlip><a:blip r:embed>`. The
@@ -4892,7 +4923,7 @@ interface ShapeElement {
     defaultTextColor: string | null;
     /** Custom geometry sub-paths (set only when geometry === "custGeom").
      *  Outer array: one entry per <a:path>; inner: path commands with coords in [0,1]. */
-    custGeom: PathCmd$1[][] | null;
+    custGeom: PathCmd$2[][] | null;
     /** First adjustment value from prstGeom avLst (e.g. trapezoid inset). Range 0–100000. */
     adj: number | null;
     /** Second adjustment value from prstGeom avLst (e.g. arrow head width). Range 0–100000. */
@@ -5192,7 +5223,7 @@ interface PictureElement {
      * Path2D and `ctx.clip()` before drawing the bitmap so the image is
      * trimmed to the laptop / device silhouette declared in the file.
      */
-    custGeom?: PathCmd$1[][] | null;
+    custGeom?: PathCmd$2[][] | null;
     /**
      * Drop shadow from `spPr > effectLst > outerShdw`. A `p:pic`'s `spPr` is
      * `CT_ShapeProperties` (ECMA-376 §19.3.1.37), so the same effects shapes
@@ -6596,10 +6627,10 @@ type PptxHighlightColors = FindHighlightColors;
  */
 declare function buildPptxHighlightLayer(layer: HTMLDivElement, runs: PptxTextRunInfo[], matches: PptxHighlightMatch[], cssWidth: number, cssHeight: number, measureForFont: (font: string) => (s: string) => number, colors?: PptxHighlightColors): void;
 declare namespace pptx_d_exports {
-    export { AutoResizeOptions, Bevel3d, BlipBullet, Bullet, Camera3d, ChartElement, ChartModel, ChartSeries, DimOptions, Fill, FillRect, FindHighlightColors, FindMatch, FindMatchesOptions, Glow, GradientFill, GradientStop, HiddenSlideMode, HyperlinkTarget, ImageFill, LightRig, LineBreak, LoadOptions$1 as LoadOptions, MediaElement, NoFill, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorSource, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, Paragraph, PathCmd$1 as PathCmd, PictureElement, PptxComment, PptxHighlightColors, PptxHighlightMatch, PptxMatchLocation, PptxPresentation, PptxScrollViewer, PptxScrollViewerOptions, PptxTextRunInfo, PptxViewer, PptxViewerOptions, Presentation, PresentationHandle, Reflection, RenderOptions, RenderSlideOptions, RenderSlideToBitmapOptions, Rot3d, Scene3d, Shadow, ShapeElement, Slide, SlideElement, SoftEdge, SolidFill, Sp3d, SpaceLine, Stroke, TabStop, TableCell, TableElement, TableRow, TextBody, TextRect, TextRun, TextRunCallback, TextRunData, TileInfo, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, isOoxmlDecodedImageLimitError, openExternalHyperlink, renderSlide };
+    export { AutoResizeOptions, Bevel3d, BlipBullet, Bullet, Camera3d, ChartElement, ChartModel, ChartSeries, DimOptions, Fill, FillRect, FindHighlightColors, FindMatch, FindMatchesOptions, Glow, GradientFill, GradientStop$1 as GradientStop, HiddenSlideMode, HyperlinkTarget, ImageFill, LightRig, LineBreak, LoadOptions$1 as LoadOptions, MediaElement, NoFill, OoxmlDecodedImageLimitError, OoxmlDecodedImageLimitMetric, OoxmlError, OoxmlErrorCode, OoxmlErrorSource, OoxmlErrorStage, OoxmlFormat, OoxmlResourceLimit, OoxmlResourceLimitError, OoxmlResourceLimitErrorDetails, OoxmlResourceLimits, OoxmlResourceMetric, OoxmlResourceMetrics, OoxmlResourceMetricsCheckpoint, OoxmlResourceName, OoxmlResourcePolicySnapshot, OoxmlResourceUsageSnapshot, OoxmlResourceViolation, Paragraph, PathCmd$2 as PathCmd, PictureElement, PptxComment, PptxHighlightColors, PptxHighlightMatch, PptxMatchLocation, PptxPresentation, PptxScrollViewer, PptxScrollViewerOptions, PptxTextRunInfo, PptxViewer, PptxViewerOptions, Presentation, PresentationHandle, Reflection, RenderOptions, RenderSlideOptions, RenderSlideToBitmapOptions, Rot3d, Scene3d, Shadow, ShapeElement, Slide, SlideElement, SoftEdge, SolidFill, Sp3d, SpaceLine, Stroke, TabStop$1 as TabStop, TableCell, TableElement, TableRow, TextBody, TextRect, TextRun, TextRunCallback, TextRunData, TileInfo, autoResize, buildPptxHighlightLayer, buildPptxTextLayer, isOoxmlDecodedImageLimitError, openExternalHyperlink, renderSlide };
 }
 //#endregion
-//#region dist/.types-work/xlsx-DJYn-XbI.d.ts
+//#region dist/.types-work/xlsx-Dyp8TxbZ.d.ts
 //#region packages/xlsx/src/types.d.ts
 interface Workbook {
     sheets: SheetMeta[];