@silurus/ooxml 0.69.0 → 0.70.1

package/dist/types/xlsx.d.ts

@@ -206,166 +206,397 @@ export declare interface ChartAnchor {
     toColOff: number;
     toRow: number;
     toRowOff: number;
-    chart: ChartData;
+    /** The chart payload, already in the canonical {@link ChartModel} shape the
+     *  Rust parser emits. The parser adapts its internal parse structure into
+     *  `ChartModel` (formerly the TS `adaptChartData`); this is passed straight
+     *  to `renderChart`. */
+    chart: ChartModel;
+}
+
+export declare interface ChartDataLabelOverride {
+    idx: number;
+    /** Empty string = label deleted (skip drawing). */
+    text: string;
+    /** "l"|"r"|"t"|"b"|"ctr"|"outEnd"|"bestFit". undefined = inherit. */
+    position?: string;
+    fontColor?: string;
+    fontSizeHpt?: number;
+    /** `<a:defRPr b="1">` inside the per-idx rich text. */
+    fontBold?: boolean;
+}
+
+export declare interface ChartDataPointOverride {
+    idx: number;
+    /** Resolved fill hex (no `#`). */
+    color?: string;
+    markerSymbol?: string;
+    markerSize?: number;
+    markerFill?: string;
+    markerLine?: string;
+}
+
+export declare interface ChartErrBars {
+    /** "x" | "y". */
+    dir: string;
+    /** "plus" | "minus" | "both". */
+    barType: string;
+    plus: (number | null)[];
+    minus: (number | null)[];
+    noEndCap: boolean;
+    /** Resolved hex (no `#`). */
+    color?: string;
+    lineWidthEmu?: number;
+    /** "solid"|"dash"|"dot"|"dashDot"|... */
+    dash?: string;
 }
 
 /**
- * XLSX parser's raw chart output. Retains parser-native `barDir` + `grouping`
- * which the renderer combines into a canonical `ChartModel.chartType` (e.g.
- * `clusteredBarH`, `stackedBarPct`) at render time.
+ * `<c:manualLayout>` block. Fractions are of the chart-space rect.
+ * `xMode`/`yMode`: "edge" = absolute fraction from top-left, "factor" =
+ * fraction offset from default position.
  */
-export declare interface ChartData {
-    /** Primary chart type: "bar"|"line"|"area"|"pie"|"doughnut"|"radar"|"scatter" */
-    chartType: string;
-    /** "col" (vertical bars) | "row" (horizontal bars) */
-    barDir: string;
-    /** "clustered"|"stacked"|"standard"|"percentStacked" */
-    grouping: string;
+export declare interface ChartManualLayout {
+    xMode: string;
+    yMode: string;
+    layoutTarget?: string;
+    x: number;
+    y: number;
+    w?: number;
+    h?: number;
+}
+
+export declare interface ChartModel {
+    chartType: ChartType;
     title: string | null;
     categories: string[];
-    series: XlsxChartSeries[];
-    /** Whether data labels are enabled (c:dLbls showVal/showPercent). */
-    showDataLabels?: boolean;
-    /** Category axis title (c:catAx/c:title). */
-    catAxisTitle?: string | null;
-    /** Value axis title (c:valAx/c:title). */
-    valAxisTitle?: string | null;
-    /** `<c:catAx><c:title>` run-prop font size (hpt), from the parser's
-     *  catAxisTitleSize. Distinct from `catAxisFontSizeHpt` (tick labels). */
-    catAxisTitleSize?: number | null;
-    /** `<c:catAx><c:title>` run-prop bold flag. */
-    catAxisTitleBold?: boolean | null;
-    /** `<c:catAx><c:title>` run-prop color (hex without '#'). */
-    catAxisTitleColor?: string | null;
-    /** `<c:valAx><c:title>` run-prop font size (hpt). */
-    valAxisTitleSize?: number | null;
-    /** `<c:valAx><c:title>` run-prop bold flag. */
-    valAxisTitleBold?: boolean | null;
-    /** `<c:valAx><c:title>` run-prop color (hex without '#'). */
-    valAxisTitleColor?: string | null;
-    /** True when <c:legend> is present. Absence means the legend is hidden. */
-    showLegend?: boolean;
-    /** `<c:legendPos val>` — "r"|"l"|"t"|"b"|"tr". null/undefined = default ("r"). */
-    legendPos?: 'r' | 'l' | 't' | 'b' | 'tr' | null;
-    /** Chart title font size in OOXML hundredths of a point (e.g. 1400 = 14pt). */
-    titleFontSizeHpt?: number | null;
-    /** Chart title font color as a hex string without '#' (srgbClr only). */
-    titleFontColor?: string | null;
-    /** Chart title font family from `<a:latin typeface>` (ECMA-376 §20.1.4.2.24). */
-    titleFontFace?: string | null;
-    /** Category axis tick-label font size in hpt (ECMA-376 §21.2.2.17 c:txPr). */
-    catAxisFontSizeHpt?: number | null;
-    /** Value axis tick-label font size in hpt. */
-    valAxisFontSizeHpt?: number | null;
-    /** Outer chartSpace background (ECMA-376 §21.2.2.5 `<c:spPr>`). Hex without
-     *  '#' for a solid fill, undefined for `<a:noFill/>` or an absent spPr.
-     *  Combine with `hasChartSpPr` to distinguish explicit-transparent from
-     *  default-opaque-white. */
-    chartBg?: string | null;
-    /** True when the parser saw a `<c:chartSpace><c:spPr>` element. Lets the
-     *  adapter tell "spec said noFill → transparent" from "no spPr → default". */
-    hasChartSpPr?: boolean;
-    /** `<c:legend><c:manualLayout>` fractions of chart space (§21.2.2.31). */
+    series: ChartSeries[];
+    /** Show data labels on bars / points / slices. */
+    showDataLabels: boolean;
+    /** Explicit Y-axis minimum (OOXML `<c:valAx><c:min>`). */
+    valMin: number | null;
+    /** Explicit Y-axis maximum (OOXML `<c:valAx><c:max>`). */
+    valMax: number | null;
+    catAxisTitle: string | null;
+    valAxisTitle: string | null;
+    /** `<c:catAx><c:delete val="1"/>`. */
+    catAxisHidden: boolean;
+    /** `<c:valAx><c:delete val="1"/>`. */
+    valAxisHidden: boolean;
+    /** `<c:catAx><c:spPr><a:ln><a:noFill>` — hide just the axis LINE; labels
+     *  and tick marks still render. Distinct from `catAxisHidden` (which
+     *  removes everything via `<c:delete val="1"/>`). */
+    catAxisLineHidden: boolean;
+    /** `<c:valAx><c:spPr><a:ln><a:noFill>` — hide just the axis LINE; labels
+     *  and tick marks still render. */
+    valAxisLineHidden: boolean;
+    /** Hex without '#'. From `<c:plotArea><c:spPr><a:solidFill>`. */
+    plotAreaBg: string | null;
+    /** Outer chartSpace background (hex without '#'). null when noFill/absent. */
+    chartBg: string | null;
+    /** True when `<c:legend>` is declared in the chart XML. False = no legend. */
+    showLegend: boolean;
+    /** `<c:legend><c:legendPos val>` — "r"|"l"|"t"|"b"|"tr". null = default (r). */
+    legendPos: 'r' | 'l' | 't' | 'b' | 'tr' | null;
+    /** `<c:catAx><c:crossBetween val="..."/>`. "between" inserts 0.5-step padding
+     *  on each end of the category axis; "midCat" anchors endpoints to the axes. */
+    catAxisCrossBetween: 'between' | 'midCat' | string;
+    /** `<c:valAx><c:majorTickMark>`. ECMA-376 default is "cross". */
+    valAxisMajorTickMark: 'cross' | 'out' | 'in' | 'none' | string;
+    /** `<c:catAx><c:majorTickMark>`. */
+    catAxisMajorTickMark: 'cross' | 'out' | 'in' | 'none' | string;
+    /** `<c:valAx | catAx><c:minorTickMark>`. ECMA-376 default is "none". */
+    valAxisMinorTickMark?: 'cross' | 'out' | 'in' | 'none' | string | null;
+    catAxisMinorTickMark?: 'cross' | 'out' | 'in' | 'none' | string | null;
+    /** Title font size in OOXML hundredths of a point (1600 = 16pt). null = default. */
+    titleFontSizeHpt: number | null;
+    /** Title font color as a hex string without '#' (e.g. "1B4332"). null = default. */
+    titleFontColor: string | null;
+    /** Title font family from `<a:latin typeface>` (ECMA-376 §20.1.4.2.24). null = default. */
+    titleFontFace: string | null;
+    /** `<c:catAx><c:txPr>` font size (hpt). null = fall back to proportional default. */
+    catAxisFontSizeHpt: number | null;
+    /** `<c:valAx><c:txPr>` font size (hpt). null = fall back to proportional default. */
+    valAxisFontSizeHpt: number | null;
+    /** `<c:catAx><c:txPr>…<a:solidFill>` tick-label color (hex without '#').
+     *  null = renderer default. Lets templates color category labels gray. */
+    catAxisFontColor?: string | null;
+    /** `<c:valAx><c:txPr>…<a:solidFill>` tick-label color (hex without '#'). */
+    valAxisFontColor?: string | null;
+    /** `<c:dLbls><c:txPr>` font size (hpt) for data-point value labels. */
+    dataLabelFontSizeHpt: number | null;
+    /** Waterfall subtotal category indices. */
+    subtotalIndices: number[];
+    /** `<c:legend><c:manualLayout>` absolute placement fractions of the chart
+     *  space (ECMA-376 §21.2.2.31). Overrides the default side-based legend
+     *  rectangle while still letting `legendPos` decide which side of the plot
+     *  gets the reserved band. null = use default layout. */
     legendManualLayout?: LegendManualLayout | null;
-    /** `<c:catAx><c:delete val="1"/>` — hide the category axis (§21.2.2.40). */
-    catAxisHidden?: boolean;
-    /** `<c:valAx><c:delete val="1"/>` — hide the value axis (§21.2.2.40). */
-    valAxisHidden?: boolean;
-    /** `<c:catAx><c:spPr><a:ln><a:noFill>` — line-only hide (labels stay). */
-    catAxisLineHidden?: boolean;
-    /** `<c:valAx><c:spPr><a:ln><a:noFill>` — line-only hide (labels stay). */
-    valAxisLineHidden?: boolean;
-    /** `<c:radarChart><c:radarStyle val>` — "standard" (line only, default),
-     *  "marker" (line + markers), "filled" (closed polygon with area fill).
-     *  Sample-1 "Biodiversity Index" uses "marker" — Excel renders no area
-     *  fill, but our renderer was filling at 25 % opacity regardless. */
-    radarStyle?: string | null;
-    /** `<c:valAx><c:numFmt@formatCode>` — number format for value-axis tick
-     *  labels (ECMA-376 §21.2.2.21). */
+    /**
+     * `<c:valAx><c:numFmt@formatCode>` — format code applied to value-axis tick
+     * labels (ECMA-376 §21.2.2.21). null = plain numeric formatting.
+     */
     valAxisFormatCode?: string | null;
-    /** `<c:barChart><c:gapWidth>` — space between category groups as a percent
-     *  of bar width (§21.2.2.13). */
+    /**
+     * `<c:barChart><c:gapWidth>` — space between category groups as a
+     * percentage of bar width (ECMA-376 §21.2.2.13). Default per spec is 150.
+     * null = renderer default.
+     */
     barGapWidth?: number | null;
-    /** `<c:barChart><c:overlap>` — signed percent overlap between bars in a
-     *  cluster (§21.2.2.25). Negative = gap. */
+    /**
+     * `<c:barChart><c:overlap>` — signed percentage overlap between bars in the
+     * same category cluster (ECMA-376 §21.2.2.25). Negative = gap, positive =
+     * overlap, 0 = flush. Range [-100, 100]. null = renderer default (0).
+     */
     barOverlap?: number | null;
-    /** `<c:dLbls><c:dLblPos>` — data label position (§21.2.2.16). */
+    /**
+     * `<c:dLbls><c:dLblPos>` — data label position (ECMA-376 §21.2.2.16).
+     * "ctr"|"inBase"|"inEnd"|"outEnd"|"l"|"r"|"t"|"b"|"bestFit" etc.
+     */
     dataLabelPosition?: string | null;
-    /** Hex (no `#`) for data label text color, resolved from `<c:dLbls><c:txPr>`. */
+    /** Hex (no `#`) for data label text, resolved from `<c:dLbls><c:txPr>`. */
     dataLabelFontColor?: string | null;
-    /** `<c:dLbls><c:numFmt@formatCode>` — chart-level override for data label
-     *  number format (§21.2.2.35). */
+    /**
+     * `<c:dLbls><c:numFmt@formatCode>` — chart-level override for data label
+     * number format (ECMA-376 §21.2.2.35). When absent, `valFormatCode` on each
+     * series is used.
+     */
     dataLabelFormatCode?: string | null;
     /** `<c:title>...defRPr@b>` chart title bold flag. */
-    titleFontBold?: boolean;
+    titleFontBold?: boolean | null;
     /** `<c:catAx><c:txPr>...defRPr@b>` X-axis tick label bold flag. */
-    catAxisFontBold?: boolean;
+    catAxisFontBold?: boolean | null;
     /** `<c:valAx><c:txPr>...defRPr@b>` Y-axis tick label bold flag. */
-    valAxisFontBold?: boolean;
-    /** `<c:catAx><c:crosses val>` (`autoZero` | `min` | `max`). Drives where
-     *  the X axis sits along the Y axis. Default `autoZero`. */
-    catAxisCrosses?: string;
-    /** `<c:catAx><c:crossesAt val>` explicit numeric crossing. */
-    catAxisCrossesAt?: number;
-    valAxisCrosses?: string;
-    valAxisCrossesAt?: number;
-    /** Axis line color (hex without `#`) and width in EMU, from
-     *  `<c:catAx|valAx><c:spPr><a:ln>`. */
-    catAxisLineColor?: string;
-    catAxisLineWidthEmu?: number;
-    valAxisLineColor?: string;
-    valAxisLineWidthEmu?: number;
+    valAxisFontBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop font size (hpt). Distinct from
+     *  `catAxisFontSizeHpt` (tick labels). null = renderer default. */
+    catAxisTitleFontSizeHpt?: number | null;
+    /** `<c:catAx><c:title>` run-prop bold flag. null = not bold. */
+    catAxisTitleFontBold?: boolean | null;
+    /** `<c:catAx><c:title>` run-prop color (hex without '#'). null = default. */
+    catAxisTitleFontColor?: string | null;
+    /** `<c:valAx><c:title>` run-prop font size (hpt). null = renderer default. */
+    valAxisTitleFontSizeHpt?: number | null;
+    /** `<c:valAx><c:title>` run-prop bold flag. null = not bold. */
+    valAxisTitleFontBold?: boolean | null;
+    /** `<c:valAx><c:title>` run-prop color (hex without '#'). null = default. */
+    valAxisTitleFontColor?: string | null;
     /** Explicit chart border color (hex without '#') from
      *  `<c:chartSpace><c:spPr><a:ln><a:solidFill><a:srgbClr>`. Only set when the
-     *  XML explicitly declares a paintable line (no default border). */
+     *  XML explicitly declares a paintable line; null otherwise (no default
+     *  border is drawn). */
     chartBorderColor?: string | null;
-    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. */
+    /** `<c:chartSpace><c:spPr><a:ln@w>` border width in EMU. null = 1px hairline
+     *  when a color is present. */
     chartBorderWidthEmu?: number | null;
-    /** `<c:catAx | valAx><c:majorTickMark val>` / `<c:minorTickMark val>` —
-     *  one of `none`/`out`/`in`/`cross` (ECMA-376 §21.2.2.49). */
-    catAxisMajorTickMark?: string;
-    catAxisMinorTickMark?: string;
-    valAxisMajorTickMark?: string;
-    valAxisMinorTickMark?: string;
-    /** `<c:catAx><c:numFmt@formatCode>` (or scatter X-axis valAx). */
-    catAxisFormatCode?: string;
-    /** `<c:catAx><c:scaling><c:min/max>` — explicit X-axis range. */
-    catAxisMin?: number;
-    catAxisMax?: number;
-    /** `<c:valAx><c:scaling><c:min/max>` — explicit Y-axis range. */
-    valAxisMin?: number;
-    valAxisMax?: number;
-    /** `<c:title><c:layout><c:manualLayout>` (§21.2.2.27) absolute placement. */
-    titleManualLayout?: ManualLayout;
-    /** `<c:plotArea><c:layout><c:manualLayout>` — `layoutTarget=inner` /
-     *  `outer` controls whether axes are inside the rect or outside. */
-    plotAreaManualLayout?: ManualLayout;
+    /**
+     * `<c:catAx><c:crosses val>` (`autoZero` | `min` | `max`). Drives the Y
+     * coordinate where the X axis is drawn. Default `autoZero` puts the X
+     * axis at y=0 — that's how Excel "Project Timeline" templates split
+     * milestones (positive Y) above and tasks (negative Y) below the axis.
+     */
+    catAxisCrosses?: string | null;
+    /** `<c:catAx><c:crossesAt val>` — explicit numeric override for the
+     *  crossing point. Takes precedence over `catAxisCrosses`. */
+    catAxisCrossesAt?: number | null;
+    valAxisCrosses?: string | null;
+    valAxisCrossesAt?: number | null;
+    /** Axis line color (hex without `#`) and width in EMU from
+     *  `<c:catAx|valAx><c:spPr><a:ln>`. */
+    catAxisLineColor?: string | null;
+    catAxisLineWidthEmu?: number | null;
+    valAxisLineColor?: string | null;
+    valAxisLineWidthEmu?: number | null;
+    /**
+     * `<c:catAx><c:numFmt@formatCode>` (or scatter X-axis valAx). When set,
+     * the renderer formats X-axis tick labels with this code (e.g. dates).
+     */
+    catAxisFormatCode?: string | null;
+    /**
+     * `<c:catAx><c:scaling><c:min/max>` — explicit X-axis range. Used by
+     * scatter / bubble charts whose X axis is numeric. null = derive from
+     * data extents.
+     */
+    catAxisMin?: number | null;
+    catAxisMax?: number | null;
+    /**
+     * `<c:title><c:layout><c:manualLayout>` (ECMA-376 §21.2.2.27) absolute
+     * placement for the chart title.
+     */
+    titleManualLayout?: ChartManualLayout | null;
+    /**
+     * `<c:plotArea><c:layout><c:manualLayout>` absolute placement for the
+     * plot area. `layoutTarget="inner"` (default) describes the inner plot
+     * rect (no axes / labels); `outer` describes the outer rect (axes
+     * included).
+     */
+    plotAreaManualLayout?: ChartManualLayout | null;
+    /**
+     * `<c:scatterChart><c:scatterStyle val>` (ECMA-376 §21.2.2.42). Drives
+     * whether scatter charts connect points with lines and whether those
+     * lines are smoothed. Values: "marker" (markers only — Excel default
+     * "Scatter"), "line" / "lineMarker" (straight segments), "smooth" /
+     * "smoothMarker" (cubic Bézier through points), "lineNoMarker",
+     * "smoothNoMarker". null = renderer default ("marker"). Only consulted
+     * for `chartType === "scatter"`; bubble ignores it.
+     */
+    scatterStyle?: string | null;
+    /**
+     * `<c:radarChart><c:radarStyle val>` (ECMA-376 §21.2.3.10). Controls
+     * whether radar series render as line + markers ("standard" / "marker")
+     * or as a closed polygon with area fill ("filled"). null = default
+     * ("standard" — line, no fill). Only consulted for `chartType === "radar"`.
+     */
+    radarStyle?: string | null;
+    /**
+     * Secondary value axis for combo charts (bar + line). When present, series
+     * with `useSecondaryAxis` are plotted against this axis's independent scale
+     * and the axis is drawn on the right edge of the plot. null/absent = single
+     * value axis (the common case). See {@link SecondaryValueAxis}.
+     */
+    secondaryValAxis?: SecondaryValueAxis | null;
 }
 
-export declare interface ConditionalFormat {
-    sqref: CellRange_2[];
-    rules: CfRule[];
+export declare 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;
 }
 
-export declare interface DataLabelOverride {
-    idx: number;
-    text: string;
-    /** "l"|"r"|"t"|"b"|"ctr"|"outEnd"|"bestFit" or undefined → inherit. */
+export declare interface ChartSeriesDataLabels {
+    showVal: boolean;
+    showCatName: boolean;
+    showSerName: boolean;
+    showPercent: boolean;
     position?: string;
     fontColor?: string;
-    fontSizeHpt?: number;
+    formatCode?: string;
+    /** Series-level bold default for data labels. */
     fontBold?: boolean;
+    /** Series-level font size for data labels (OOXML hundredths of a point). */
+    fontSizeHpt?: number;
 }
 
-export declare interface DataPointOverride {
-    idx: number;
-    color?: string;
-    markerSymbol?: string;
-    markerSize?: number;
-    markerFill?: string;
-    markerLine?: string;
+/**
+ * Canonical chart type vocabulary. Embeds direction (`H` = horizontal) and
+ * grouping (`Pct` = percent-stacked) so renderers do not need to inspect
+ * separate `barDir`/`grouping` fields.
+ */
+declare type ChartType = 'line' | 'stackedLine' | 'stackedLinePct' | 'clusteredBar' | 'clusteredBarH' | 'stackedBar' | 'stackedBarH' | 'stackedBarPct' | 'stackedBarHPct' | 'area' | 'stackedArea' | 'stackedAreaPct' | 'pie' | 'doughnut' | 'scatter' | 'bubble' | 'radar' | 'waterfall' | string;
+
+export declare interface ConditionalFormat {
+    sqref: CellRange_2[];
+    rules: CfRule[];
 }
 
+/** @deprecated Use `ChartDataLabelOverride` from @silurus/ooxml-core. */
+export declare type DataLabelOverride = ChartDataLabelOverride;
+
+/** @deprecated Use `ChartDataPointOverride` from @silurus/ooxml-core. */
+export declare type DataPointOverride = ChartDataPointOverride;
+
 /** One `<dataValidation>` rule (ECMA-376 §18.3.1.33). `type` is the constraint
  *  class (`list` | `whole` | `decimal` | `date` | `time` | `textLength` |
  *  `custom`); `operator` qualifies it (`between` | `notBetween` | `equal` | …).
@@ -404,19 +635,8 @@ export declare interface Dxf {
     numFmt?: NumFmt | null;
 }
 
-export declare interface ErrBars {
-    /** "x" | "y". */
-    dir: string;
-    /** "plus" | "minus" | "both". */
-    barType: string;
-    plus: (number | null)[];
-    minus: (number | null)[];
-    noEndCap: boolean;
-    /** Resolved RGB hex (no `#`). */
-    color?: string;
-    lineWidthEmu?: number;
-    dash?: string;
-}
+/** @deprecated Use `ChartErrBars` from @silurus/ooxml-core. */
+export declare type ErrBars = ChartErrBars;
 
 export declare interface GradientFillSpec {
     /** "linear" (default) or "path". */
@@ -434,6 +654,9 @@ export declare interface GradientFillSpec {
     }[];
 }
 
+/** How {@link XlsxViewer} presents hidden sheets (`<sheet state>`, §18.2.19). */
+export declare type HiddenSheetMode = 'show' | 'skip' | 'dim';
+
 export declare interface Hyperlink {
     col: number;
     row: number;
@@ -491,8 +714,11 @@ export declare interface ImageAnchor {
 }
 
 export declare interface LegendManualLayout {
+    /** `"edge"` = `x`/`y` are fractions from top-left of chart space;
+     *  `"factor"` = fractions offset from the default position. */
     xMode: string;
     yMode: string;
+    /** Fractions of chart space width/height. */
     x: number;
     y: number;
     w: number;
@@ -534,6 +760,21 @@ declare interface LoadOptions_2 {
      * via `@font-face` in your application CSS.
      */
     useGoogleFonts?: boolean;
+    /**
+     * Override the URL the parser worker fetches the WebAssembly module from.
+     *
+     * By default each format resolves the `.wasm` asset that ships next to its
+     * bundle (relative to the module URL), so no configuration is needed. Set
+     * this to serve the parser WASM from a CDN or a self-hosted path instead — a
+     * relative value is resolved against the current document URL. The same
+     * dependency-injection contract across docx / pptx / xlsx.
+     *
+     * The referenced file must be the matching format's `*_parser_bg.wasm`
+     * artifact (the one wasm-bindgen emitted for that parser); pointing it at a
+     * mismatched or missing file makes `load()` reject when the worker
+     * instantiates it.
+     */
+    wasmUrl?: string | URL;
     /**
      * Override the per-entry ZIP decompression cap (bytes) used by the zip-bomb
      * guard in the Rust parser. Defaults to 512 MiB. Raise it to load documents
@@ -541,6 +782,16 @@ declare interface LoadOptions_2 {
      * untrusted input. Zero / negative values fall back to the default.
      */
     maxZipEntryBytes?: number;
+    /**
+     * Reject the parse request if the parser worker does not answer within this
+     * many milliseconds. Opt-in safety net for a wedged or crashed worker that
+     * would otherwise leave `load()` pending forever. **Default: unlimited** —
+     * parsing a large document with heavy embedded media can legitimately take
+     * tens of seconds, so no timeout is imposed unless you set one. A worker that
+     * throws or fails to load already rejects immediately regardless of this
+     * value; this bound only covers the "silent, never-responds" case.
+     */
+    workerTimeoutMs?: number;
     /**
      * Opt-in OMML equation engine (MathJax + STIX Two Math, ~3 MB). Inject it
      * **once** here and every render of this document / presentation / workbook
@@ -553,15 +804,8 @@ declare interface LoadOptions_2 {
     math?: MathRenderer;
 }
 
-export declare interface ManualLayout {
-    xMode: string;
-    yMode: string;
-    layoutTarget?: string;
-    x: number;
-    y: number;
-    w?: number;
-    h?: number;
-}
+/** @deprecated Use `ChartManualLayout` from @silurus/ooxml-core. */
+export declare type ManualLayout = ChartManualLayout;
 
 /** Accent (`m:acc`), e.g. hat, bar, vector arrow over the base. */
 declare interface MathAccent {
@@ -840,20 +1084,48 @@ export declare interface RunFont {
     vertAlign?: 'superscript' | 'subscript';
 }
 
+/**
+ * A secondary value axis (combo charts). Mirrors the primary value-axis
+ * properties but lives in its own object so the flat primary-axis fields stay
+ * untouched. Parsed from the right-hand `<c:valAx>` (`axPos="r"`,
+ * `<c:crosses val="max">`).
+ */
+declare interface SecondaryValueAxis {
+    /** `<c:scaling><c:min val>`. null = derive from the series data. */
+    min: number | null;
+    /** `<c:scaling><c:max val>`. null = derive from the series data. */
+    max: number | null;
+    /** `<c:title>` plain text. null = no title. */
+    title: string | null;
+    /** `<c:delete val="1"/>` — hide labels/ticks entirely. */
+    hidden: boolean;
+    /** `<c:numFmt formatCode>` for tick labels. */
+    formatCode?: string | null;
+    /** `<c:txPr>…<a:solidFill>` tick-label color (hex without '#'). */
+    fontColor?: string | null;
+    /** `<c:txPr>` tick-label font size (hpt). */
+    fontSizeHpt?: number | null;
+    /** `<c:spPr><a:ln><a:solidFill>` axis-line color (hex without '#'). */
+    lineColor?: string | null;
+    /** `<c:spPr><a:ln w>` axis-line width in EMU. */
+    lineWidthEmu?: number | null;
+    /** `<c:spPr><a:ln><a:noFill>` — hide just the axis rule. */
+    lineHidden: boolean;
+    /** `<c:majorTickMark>` — "cross" (default) | "out" | "in" | "none". */
+    majorTickMark: string;
+    /** `<c:title>` run-prop font size (hpt). */
+    titleFontSizeHpt?: number | null;
+    /** `<c:title>` run-prop bold flag. */
+    titleFontBold?: boolean | null;
+    /** `<c:title>` run-prop color (hex without '#'). */
+    titleFontColor?: string | null;
+}
+
 declare type SelectionMode_2 = 'cells' | 'rows' | 'cols' | 'all';
 export { SelectionMode_2 as SelectionMode }
 
-export declare interface SeriesDataLabels {
-    showVal: boolean;
-    showCatName: boolean;
-    showSerName: boolean;
-    showPercent: boolean;
-    position?: string;
-    fontColor?: string;
-    formatCode?: string;
-    fontBold?: boolean;
-    fontSizeHpt?: number;
-}
+/** @deprecated Use `ChartSeriesDataLabels` from @silurus/ooxml-core. */
+export declare type SeriesDataLabels = ChartSeriesDataLabels;
 
 export declare interface ShapeAnchor {
     fromCol: number;
@@ -950,6 +1222,9 @@ export declare interface ShapeParagraph {
     /** `<a:pPr@indent>` — first-line indent in EMU (negative = hanging),
      *  ECMA-376 §21.1.2.2.7. Omitted (undefined) when unset. */
     indent?: number;
+    /** `<a:pPr>/<a:lnSpc>` line spacing (ECMA-376 §21.1.2.2.5). Direct-only;
+     *  omitted when unset. */
+    spaceLine?: SpaceLine | null;
     runs: ShapeTextRun[];
 }
 
@@ -959,6 +1234,27 @@ export declare interface ShapeText {
     anchor: string;
     /** `<a:bodyPr@wrap>` — `square` (wrap to width) | `none`. */
     wrap: string;
+    /** `<a:bodyPr>` autofit child — `'sp'` (`spAutoFit`), `'norm'` (`normAutofit`),
+     *  or `'none'` (`noAutofit`/absent). ECMA-376 §21.1.2.1.1-.3. Always present
+     *  (default `'none'`), mirroring the core `TextBody.autoFit`. */
+    autoFit?: string;
+    /** `<a:normAutofit@fontScale>` — stored font-shrink fraction (e.g. 0.625 for
+     *  `fontScale="62500"`). Null/absent when unset. Modeled for parity with
+     *  pptx; the xlsx renderer does not currently apply it. */
+    fontScale?: number | null;
+    /** `<a:normAutofit@lnSpcReduction>` — stored line-spacing reduction fraction
+     *  (e.g. 0.20 for `lnSpcReduction="20000"`). Null/absent when unset. */
+    lnSpcReduction?: number | null;
+    /** `<a:bodyPr@lIns>` — left text inset in EMU (ECMA-376 §21.1.2.1.1). Always
+     *  present; the spec default 91440 EMU (7.2 pt) when the attribute is absent.
+     *  Same EMU convention as `ShapeParagraph.marL`. */
+    lIns: number;
+    /** `<a:bodyPr@tIns>` — top text inset in EMU. Default 45720 (3.6 pt). */
+    tIns: number;
+    /** `<a:bodyPr@rIns>` — right text inset in EMU. Default 91440 (7.2 pt). */
+    rIns: number;
+    /** `<a:bodyPr@bIns>` — bottom text inset in EMU. Default 45720 (3.6 pt). */
+    bIns: number;
     paragraphs: ShapeParagraph[];
 }
 
@@ -976,6 +1272,18 @@ export declare type ShapeTextRun = {
     size: number;
     color?: string;
     fontFace?: string;
+    /** East-Asian typeface (`<a:ea@typeface>`, ECMA-376 §21.1.2.3.1). The
+     *  common Japanese encoding sets Meiryo here while leaving `<a:latin>`
+     *  default; the renderer floors the line box by this face's design line
+     *  too (see `drawShapeText`). Undefined when the run declares no `<a:ea>`. */
+    fontFaceEa?: string;
+    /** Complex-script typeface (`<a:cs@typeface>`, ECMA-376 §21.1.2.3.1).
+     *  Parsed/modeled but NOT used in the line-box floor: the cs face renders
+     *  only complex-script glyphs (Arabic/Hebrew/Thai), so flooring the whole
+     *  line box by it would over-grow Latin/CJK runs (deferred to per-glyph
+     *  handling — see `drawShapeText`). Undefined when the run declares no
+     *  `<a:cs>`. */
+    fontFaceCs?: string;
 } | {
     type: 'break';
 } | {
@@ -1002,8 +1310,16 @@ export declare interface SheetMeta {
      *  `#RRGGBB`. Surfaced at workbook-list time so tabs can be painted up front.
      *  Absent when the sheet declares no tab color. */
     tabColor?: string | null;
+    /** Sheet visibility (`<sheet state>`, ECMA-376 §18.2.19 `ST_SheetState`).
+     *  Absent ⇒ visible. `'veryHidden'` sheets are revealable only
+     *  programmatically in Excel. Read via `XlsxWorkbook.isHidden` /
+     *  `XlsxWorkbook.sheetVisibility`. */
+    visibility?: 'hidden' | 'veryHidden';
 }
 
+/** Sheet visibility (`<sheet state>`, ECMA-376 §18.2.19 `ST_SheetState`). */
+export declare type SheetVisibility = 'visible' | 'hidden' | 'veryHidden';
+
 export declare interface SlicerAnchor {
     fromCol: number;
     fromColOff: number;
@@ -1022,6 +1338,14 @@ export declare interface SlicerItem {
     selected: boolean;
 }
 
+declare type SpaceLine = {
+    type: 'pct';
+    val: number;
+} | {
+    type: 'pts';
+    val: number;
+};
+
 export declare interface Sparkline {
     /** 1-based row of the destination cell (`<xm:sqref>`). */
     row: number;
@@ -1216,51 +1540,10 @@ export declare interface Worksheet {
 }
 
 /**
- * XLSX parser's raw chart series (includes XLSX-only `seriesType` for mixed
- * charts). Adapted to `ChartSeries` from @silurus/ooxml-core before rendering.
+ * @deprecated Chart series are now the core {@link ChartModel}'s `ChartSeries`.
+ * Kept as an alias for backward-compatible imports.
  */
-export declare interface XlsxChartSeries {
-    name: string;
-    /** Chart sub-type for this series (allows mixed charts). */
-    seriesType: string;
-    categories: string[];
-    values: (number | null)[];
-    /** Explicit fill color hex (from c:spPr). Undefined = use palette. */
-    color?: string | null;
-    /** Marker visibility resolved from `<c:marker>`/chart-level default
-     *  (ECMA-376 §21.2.2.32). */
-    showMarker?: boolean;
-    /** `<c:val>/<c:numRef>/<c:formatCode>` — Excel number format for series
-     *  values (ECMA-376 §21.2.2.37). */
-    valFormatCode?: string | null;
-    /** `<c:ser><c:dLbls><c:txPr>…solidFill` — per-series data-label text color
-     *  (ECMA-376 §21.2.2.216). Takes precedence over the chart-level color so
-     *  each series can color its labels independently. */
-    labelColor?: string | null;
-    /** `<c:ser><c:order>` — stacking/legend display order (§21.2.2.28). */
-    order?: number;
-    /** `<c:marker><c:symbol val>` — point marker shape (ECMA-376 §21.2.2.32). */
-    markerSymbol?: string;
-    /** `<c:marker><c:size val>` — point marker side length in pt (§21.2.2.34). */
-    markerSize?: number;
-    /** `<c:marker><c:spPr>` resolved fill (no `#`). */
-    markerFill?: string;
-    /** `<c:marker><c:spPr><a:ln>` resolved stroke (no `#`). */
-    markerLine?: string;
-    /** `<c:dPt>` per-data-point overrides (§21.2.2.39). */
-    dataPointOverrides?: DataPointOverride[];
-    /** Per-idx custom data labels (`<c:dLbl idx>`, §21.2.2.45). Custom rich
-     *  text is flattened to plain string at parse time; CELLRANGE field
-     *  placeholders are resolved against the series' `<c15:datalabelsRange>`
-     *  cache. */
-    dataLabelOverrides?: DataLabelOverride[];
-    /** Series-level `<c:dLbls>` defaults applied to every point lacking its
-     *  own override. */
-    seriesDataLabels?: SeriesDataLabels;
-    /** `<c:errBars>` (§21.2.2.20). At parse time, plus / minus deltas are
-     *  resolved into absolute per-point values regardless of `errValType`. */
-    errBars?: ErrBars[];
-}
+export declare type XlsxChartSeries = ChartSeries;
 
 /** One cell comment. Sourced from the classic notes file `xl/commentsN.xml`
  *  (ECMA-376 §18.7) when present, otherwise from the Office-365 threaded
@@ -1297,6 +1580,10 @@ export declare interface XlsxTextRunInfo {
 
 export declare class XlsxViewer {
     private wb;
+    /** The single subtree root the constructor appended to the caller's
+     *  container. destroy() removes it to return the container to its original
+     *  (empty) state. */
+    private wrapper;
     private canvas;
     private canvasArea;
     private scrollHost;
@@ -1312,6 +1599,7 @@ export declare class XlsxViewer {
     private zoomSlider;
     private zoomLabel;
     private currentSheet;
+    private _hiddenSheetMode;
     private currentWorksheet;
     private opts;
     /** 'main' renders on this thread; 'worker' paints worker-produced bitmaps. */
@@ -1321,6 +1609,32 @@ export declare class XlsxViewer {
      *  main-mode 2d render path is never used on the same canvas. */
     private _bitmapCtx;
     private resizeObserver;
+    /**
+     * Pending `requestAnimationFrame` handle for a coalesced re-render, or `null`
+     * when none is scheduled. High-frequency event-driven repaints (scroll, live
+     * resize drag, selection drag, container resize) route through
+     * {@link scheduleRender} so at most one render runs per animation frame: a
+     * burst of scroll events within a single frame collapses to one draw at the
+     * frame's latest scroll position (`renderCurrentSheet` reads the live scroll
+     * offset, so "latest wins" needs no stored position). Explicit API calls
+     * (`showSheet`/`goToSheet`, `select`, `setScale`) stay synchronous — they must
+     * paint immediately, not a frame later. `destroy()` cancels any pending frame.
+     */
+    private _rafId;
+    /**
+     * Monotonic render-request counter for worker-mode stale-frame dropping.
+     * Every {@link renderCurrentSheet} bumps it and captures the value before it
+     * awaits the worker's bitmap; on resolution a captured value below the current
+     * one means a newer render was requested meanwhile (scroll moved on, the sheet
+     * switched, a zoom changed), so that bitmap is stale and must be closed and
+     * dropped instead of painted over the fresher frame. The WorkerBridge already
+     * correlates each request↔response by id, but requests overlap — a slow bitmap
+     * for an old scroll position can resolve after a newer one — so the viewer
+     * needs this generation guard, the single-canvas analogue of the pptx
+     * scroll-viewer's per-slot render epoch (PR #663). The main-thread path renders
+     * synchronously and cannot interleave, so it needs no guard.
+     */
+    private _renderSeq;
     /**
      * Start-anchored horizontal scroll position (the {@link effectiveScrollLeft}
      * value last produced by a real user scroll or a programmatic reset), kept
@@ -1429,6 +1743,10 @@ export declare class XlsxViewer {
     goToSheet(index: number): Promise<void>;
     nextSheet(): Promise<void>;
     prevSheet(): Promise<void>;
+    /** Next sheet index for sequential nav: skip mode jumps over hidden sheets. */
+    private _stepSheet;
+    /** Initial sheet for load() / entering skip mode: land on a visible sheet. */
+    private _initialSheet;
     /** Returns the cell at canvas-client coordinates, or null if outside the cell grid. */
     getCellAt(clientX: number, clientY: number): CellAddress | null;
     /** Returns the CSS-pixel rect of a cell within canvasArea, or null if not
@@ -1480,6 +1798,15 @@ export declare class XlsxViewer {
      * immediately.
      */
     setSelectionColor(color: string): void;
+    /**
+     * Switch the hidden-sheet mode at runtime: restyle the tabs and re-render.
+     * Entering `'skip'` while on a hidden sheet advances to the nearest visible.
+     */
+    setHiddenSheetMode(mode: HiddenSheetMode): Promise<void>;
+    /** The current hidden-sheet mode. */
+    get hiddenSheetMode(): HiddenSheetMode;
+    /** Number of non-hidden sheets (absolute `sheetCount` is unchanged). */
+    get visibleSheetCount(): number;
     /** Copy the selected cell range as tab-separated text to the clipboard. */
     private copySelection;
     private updateSelectionOverlay;
@@ -1535,6 +1862,13 @@ export declare class XlsxViewer {
     private updateNavButtons;
     private updateTabActive;
     private tabStyle;
+    /**
+     * Full inline style for the tab of sheet `i`, honoring the hidden-sheet mode:
+     * `'skip'` hides the tab of a hidden/veryHidden sheet (`display:none`); `'dim'`
+     * greys it but leaves it clickable; `'show'` styles every tab normally. Used
+     * by both buildTabs and updateTabActive so navigation never wipes the styling.
+     */
+    private tabCss;
     /** Excel-style zoom control pinned to the right end of the tab bar:
      *  `−  [────slider────]  +  100%`. Live-updates the cell scale on input. */
     private buildZoomControl;
@@ -1548,11 +1882,39 @@ export declare class XlsxViewer {
      *  aligned tab-nav width in sync. */
     setScale(scale: number): void;
     private updateSpacerSize;
+    /**
+     * Coalesce a re-render into the next animation frame. Called from the
+     * high-frequency event-driven paths (scroll, live column/row resize, drag-
+     * selection, container resize); a burst of these within one frame schedules a
+     * single {@link renderCurrentSheet}, avoiding the previous behavior where every
+     * scroll event forced its own synchronous full redraw. Already-scheduled frames
+     * are not re-scheduled — the one pending render reads the live scroll/scale
+     * state when it runs, so the most recent position always wins without threading
+     * a coordinate through. Falls back to a synchronous render when
+     * `requestAnimationFrame` is unavailable (e.g. a non-DOM host), preserving the
+     * old semantics there.
+     */
+    private scheduleRender;
     private renderCurrentSheet;
     private computeHeaderHighlight;
     get sheetNames(): string[];
     /** The underlying <canvas> element the grid is drawn on. */
     get canvasElement(): HTMLCanvasElement;
+    /**
+     * Tear down the viewer and release resources.
+     *
+     * The caller's container is returned to the state it had before construction
+     * (empty): the entire wrapper subtree the constructor appended is removed.
+     * All document-level listeners are detached — the keydown handler here, and
+     * the validation-panel outside-click handler via {@link hideValidationPanel}.
+     * Listeners on elements inside the wrapper (scrollHost, tabs, …) need no
+     * explicit removal: removing the subtree makes them unreachable and eligible
+     * for GC. Safe to call more than once.
+     *
+     * NOTE: the shared `<style>` in `document.head` is intentionally NOT removed —
+     * it is a class constant that any still-live viewer may depend on, and one
+     * leftover sheet is a bounded, harmless cost (see {@link ensureViewerStyleInjected}).
+     */
     destroy(): void;
 }
 
@@ -1605,6 +1967,19 @@ export declare interface XlsxViewerOptions extends LoadOptions_2 {
      * require `'main'` (the math engine cannot cross the worker boundary).
      */
     mode?: 'main' | 'worker';
+    /**
+     * How hidden / veryHidden sheets (`<sheet state>`, ECMA-376 §18.2.19) are
+     * presented:
+     * - `'show'` (default): every sheet gets a tab — current behavior.
+     * - `'skip'`: hidden/veryHidden sheets get no tab and are jumped over by
+     *   `nextSheet`/`prevSheet` and initial load; absolute indices are unchanged,
+     *   and an explicit `goToSheet(i)` to a hidden sheet is still honored.
+     * - `'dim'`: hidden/veryHidden tabs are shown greyed but stay selectable.
+     *
+     * Named to match the {@link XlsxViewer.hiddenSheetMode} getter and
+     * {@link XlsxViewer.setHiddenSheetMode} setter. Mirrors pptx `hiddenSlideMode`.
+     */
+    hiddenSheetMode?: HiddenSheetMode;
 }
 
 export declare class XlsxWorkbook {
@@ -1641,6 +2016,21 @@ export declare class XlsxWorkbook {
     /** Per-sheet tab colors (`#RRGGBB`) parallel to {@link sheetNames}.
      *  `null` for sheets that declare no tab color. */
     get tabColors(): (string | null)[];
+    /**
+     * Full visibility fact for the sheet at `sheetIndex` (0-based):
+     * `'visible'` | `'hidden'` | `'veryHidden'` (`<sheet state>`, ECMA-376
+     * §18.2.19). NOT clamped — out-of-range / non-integer ⇒ `'visible'`. This is a
+     * *fact*; deciding what to do with a hidden sheet (hide/skip/dim its tab) is
+     * {@link XlsxViewer}'s policy. `'veryHidden'` is revealable only
+     * programmatically in Excel; it is surfaced distinctly here.
+     */
+    sheetVisibility(sheetIndex: number): SheetVisibility;
+    /**
+     * Whether the sheet at `sheetIndex` is hidden or veryHidden. Convenience over
+     * {@link sheetVisibility}; mirrors {@link PptxPresentation.isHidden} (non-
+     * clamped: out-of-range / non-integer ⇒ `false`).
+     */
+    isHidden(sheetIndex: number): boolean;
     getWorksheet(sheetIndex: number): Promise<Worksheet>;
     /**
      * Fetch an embedded image's bytes by zip path (e.g. `xl/media/image1.png`),