pptx-react-viewer 3.7.0 → 3.9.0

package/dist/internals.d.ts

@@ -2145,6 +2145,29 @@ interface PptxElementBase {
   y: number;
   width: number;
   height: number;
+  /**
+   * The exact EMU integer `x` was parsed from (the `a:off/@_x` this
+   * element's own `a:xfrm` carried on load), when the parser could resolve
+   * one. `x` itself is always `Math.round(xEmu / EMU_PER_PX)` at parse
+   * time, but that rounding is lossy: re-deriving EMU from `x` on save
+   * (`Math.round(x * EMU_PER_PX)`) can drift from the original value by up
+   * to half a pixel's worth of EMU on every load/save cycle even when
+   * nothing touched this element. Kept alongside `x` (not instead of it) so
+   * every consumer that only cares about on-screen position is unaffected;
+   * only the save-side xfrm writer (`resolveXfrmEmu` in
+   * `xfrm-emu-resolution.ts`) reads this, and only when `x` still equals
+   * `Math.round(xEmu / EMU_PER_PX)` (i.e. nothing moved this element since
+   * load) does it re-emit `xEmu` verbatim instead of re-quantizing `x`.
+   * `undefined` for an SDK-created element or one whose transform could not
+   * be resolved to a usable `a:off` on load.
+   */
+  xEmu?: number;
+  /** The exact EMU integer `y` was parsed from (`a:off/@_y`). See {@link xEmu}. */
+  yEmu?: number;
+  /** The exact EMU integer `width` was parsed from (`a:ext/@_cx`). See {@link xEmu}. */
+  widthEmu?: number;
+  /** The exact EMU integer `height` was parsed from (`a:ext/@_cy`). See {@link xEmu}. */
+  heightEmu?: number;
   rotation?: number;
   /** Skew along the X axis in degrees (parsed from `@_skewX` in 1/60000ths of a degree). */
   skewX?: number;
@@ -2394,7 +2417,38 @@ interface PptxChartDataPointPicture {
 //#region src/core/types/chart-pivot-format.d.ts
 interface PptxChartPivotFormat {
   index: number;
+  /**
+   * Typed projection of `spPr` (fill/stroke colour, stroke width, dash
+   * style). When the parser is given a colour resolver (the normal case: the
+   * runtime always supplies one), both a literal `a:srgbClr` and an
+   * `a:schemeClr` theme reference (with its `lumMod`/`lumOff`/`tint`/`shade`
+   * modifiers) resolve to a hex colour here, the same theme +
+   * `c:clrMapOvr` chain the rest of chart parsing uses. Without a resolver
+   * (e.g. a hand-built `PptxChartPivotFormat` with no theme to resolve
+   * against), only the literal case resolves. Either way the authored node
+   * is byte-preserved through {@link shapePropertiesXml} until this field is
+   * set to something that no longer matches what re-parses off the current
+   * XML; setting it then re-derives `shapePropertiesXml` on save (merged
+   * onto whatever was already authored, keeping an unrelated schemeClr
+   * reference alive when the colour itself is unchanged) unless
+   * `shapePropertiesXml` is set explicitly, which wins.
+   */
+  shapeProperties?: PptxChartShapeProps;
+  /**
+   * Typed projection of `txPr`'s `a:p/a:pPr/a:defRPr` (size/bold/italic/
+   * colour/family), the same shape a legend entry or data-table's text
+   * override models. Colour resolution mirrors {@link shapeProperties}
+   * (theme-resolved `schemeClr` when a colour resolver is supplied, literal
+   * `srgbClr` otherwise). See {@link txPrXml} for the raw fallback.
+   */
+  textStyle?: PptxChartLegendTextStyle;
+  /**
+   * Typed projection of `marker` (symbol/size/spPr). See {@link markerXml}
+   * for the raw fallback.
+   */
+  marker?: PptxChartMarker;
   shapePropertiesXml?: XmlObject | null;
+  txPrXml?: XmlObject | null;
   markerXml?: XmlObject | null;
   dataLabelXml?: XmlObject | null;
   extensionListXml?: XmlObject | null;
@@ -2587,20 +2641,6 @@ interface PptxChartTitleRun {
 }
 //#endregion
 //#region src/core/types/chart-user-shapes.d.ts
-/**
- * Types for chart drawing-overlay shapes (`c:userShapes`).
- *
- * A chart's `c:userShapes` element carries an `r:id` that references a
- * separate drawing part (`ppt/drawings/drawingN.xml`) whose root is a
- * `c:userShapes` element populated with `cdr:relSizeAnchor` /
- * `cdr:absSizeAnchor` wrappers around `sp` / `pic` / `cxnSp` shapes drawn on
- * top of the chart plot. These interfaces describe the parsed, renderable
- * overlay model. The raw reference is preserved separately on
- * {@link PptxChartData.userShapesXml} for verbatim round-trip save; this model
- * is render-only.
- *
- * @module pptx-types/chart-user-shapes
- */
 /** A single paragraph of overlay-shape text with light formatting. */
 interface PptxChartUserShapeParagraph {
   /** Joined run text of the paragraph. */
@@ -2616,6 +2656,112 @@ interface PptxChartUserShapeParagraph {
   /** Paragraph alignment (`a:pPr/@algn`): left / centre / right. */
   align?: 'l' | 'ctr' | 'r';
 }
+/**
+ * The DrawingML 2D group transform (`a:xfrm` inside `cdr:grpSpPr`) that
+ * anchors a `grpSp`'s own box ({@link off}/{@link ext}) and establishes the
+ * coordinate space its children are expressed in ({@link chOff}/{@link
+ * chExt}), all in EMU. A child's position within the group is mapped into
+ * the group's own box via
+ * `frac = (child.off - chOff) / chExt`, then applied to the enclosing
+ * anchor's box; see `flattenChartUserShapes` in
+ * `chart-user-shapes-parser.ts`.
+ */
+interface PptxChartUserShapeGroupTransform {
+  /** The group's own position in its parent's coordinate space, in EMU. */
+  off: {
+    x: number;
+    y: number;
+  };
+  /** The group's own size in its parent's coordinate space, in EMU. */
+  ext: {
+    cx: number;
+    cy: number;
+  };
+  /** Origin of the child coordinate space (`a:chOff`), in EMU. */
+  chOff: {
+    x: number;
+    y: number;
+  };
+  /** Size of the child coordinate space (`a:chExt`), in EMU. */
+  chExt: {
+    cx: number;
+    cy: number;
+  };
+  /**
+   * The group's own rotation in degrees (`a:xfrm/@rot`, stored in 60,000ths
+   * of a degree), when present. Rotates the whole group, and everything
+   * grouped inside it, as a rigid body about the CENTRE of the group's own
+   * box ({@link off}/{@link ext}); see `flattenChartUserShapes` in
+   * `chart-user-shapes-parser.ts` for how this composes onto each contained
+   * leaf's own {@link PptxChartUserShapeGroupChild.rotation}. Verified
+   * against real PowerPoint (COM): a `cdr:grpSp`'s `cdr:grpSpPr/a:xfrm` does
+   * carry `rot` the same way an ordinary shape's does.
+   */
+  rotation?: number;
+  /** The group's own horizontal flip (`a:xfrm/@flipH`), when present; composes onto children by XOR, see {@link rotation}'s doc. */
+  flipH?: boolean;
+  /** The group's own vertical flip (`a:xfrm/@flipV`), when present; composes onto children by XOR, see {@link rotation}'s doc. */
+  flipV?: boolean;
+}
+/**
+ * One shape grouped inside a `cdr:grpSp` (or a nested `cdr:grpSp` itself).
+ * Unlike a top-level {@link PptxChartUserShape}, a group child has no
+ * drawing anchor of its own: its position is expressed in its parent
+ * group's child coordinate space via {@link off}/{@link ext} (EMU, read
+ * from the child's own `a:xfrm`), not as a chart-relative fraction.
+ */
+interface PptxChartUserShapeGroupChild {
+  /** Shape kind, same vocabulary as {@link PptxChartUserShape.kind}. */
+  kind: 'sp' | 'cxnSp' | 'pic' | 'grpSp' | 'graphicFrame';
+  /** Position within the parent group's child coordinate space, in EMU. */
+  off: {
+    x: number;
+    y: number;
+  };
+  /** Size within the parent group's child coordinate space, in EMU. */
+  ext: {
+    cx: number;
+    cy: number;
+  };
+  /** Preset geometry name (`a:prstGeom/@prst`), defaulting to `"rect"`. */
+  prst?: string;
+  /** Resolved solid-fill hex colour, when present. */
+  fill?: string;
+  /** Resolved line/stroke hex colour, when present. */
+  stroke?: string;
+  /** Line width in points (`a:ln/@w` divided by 12700), when present. */
+  strokeWidth?: number;
+  /** Text paragraphs of the shape's `txBody`, when present. */
+  paragraphs?: PptxChartUserShapeParagraph[];
+  /**
+   * A `pic` child's alt text (`cdr:nvPicPr/cdr:cNvPr/@descr`), when present.
+   * Editable independently of {@link rawXml}'s otherwise-verbatim content:
+   * the serializer patches only this attribute onto the cloned raw node.
+   */
+  altText?: string;
+  /**
+   * This child's OWN rotation in degrees (`a:xfrm/@rot`), when present.
+   * Composes with every enclosing group's own
+   * {@link PptxChartUserShapeGroupTransform.rotation} (added) to produce the
+   * leaf's final on-screen rotation; see `flattenChartUserShapes`.
+   */
+  rotation?: number;
+  /** This child's OWN horizontal flip (`a:xfrm/@flipH`); composes with an ancestor group's flip by XOR. */
+  flipH?: boolean;
+  /** This child's OWN vertical flip (`a:xfrm/@flipV`); composes with an ancestor group's flip by XOR. */
+  flipV?: boolean;
+  /**
+   * Verbatim source XML of a `pic`/`graphicFrame` child, or of this node
+   * itself when `kind === 'grpSp'` and the nested group is untouched since
+   * parse. See {@link PptxChartUserShape.rawXml}'s doc for the same
+   * contract one level up.
+   */
+  rawXml?: XmlObject;
+  /** Present when `kind === 'grpSp'`: this nested group's own transform. */
+  transform?: PptxChartUserShapeGroupTransform;
+  /** Present when `kind === 'grpSp'`: this nested group's own children. */
+  children?: PptxChartUserShapeGroupChild[];
+}
 /**
  * A parsed chart-overlay shape positioned by a drawing anchor.
  *
@@ -2626,12 +2772,13 @@ interface PptxChartUserShapeParagraph {
 interface PptxChartUserShape {
   /**
    * Shape kind: text/preset shape, connector, picture, a group of the
-   * above (`grpSp`, flattened: each grouped child becomes its own entry
-   * reusing the anchor's own bounding box, an approximation since the
-   * group's internal chOff/chExt transform is not applied), or a bare
-   * placeholder for a `graphicFrame` anchor child (deep content such as a
-   * nested chart or table is out of scope; it only keeps the anchor's
-   * space accounted for instead of the whole overlay disappearing).
+   * above (`grpSp`, with its own {@link transform} and {@link children},
+   * nested arbitrarily; use `flattenChartUserShapes` from
+   * `chart-user-shapes-parser.ts` to get a flat, render-ready leaf list
+   * with the group transform already applied), or a bare placeholder for
+   * a `graphicFrame` anchor child (deep content such as a nested chart or
+   * table is out of scope; it only keeps the anchor's space accounted for
+   * instead of the whole overlay disappearing).
    */
   kind: 'sp' | 'cxnSp' | 'pic' | 'grpSp' | 'graphicFrame';
   /** Anchor kind that positioned the shape. */
@@ -2661,6 +2808,49 @@ interface PptxChartUserShape {
   strokeWidth?: number;
   /** Text paragraphs of the shape's `txBody`, when present. */
   paragraphs?: PptxChartUserShapeParagraph[];
+  /**
+   * A `pic` anchor's alt text (`cdr:nvPicPr/cdr:cNvPr/@descr`), when
+   * present. Editable independently of {@link rawXml}'s otherwise-verbatim
+   * content: the serializer patches only this attribute onto the cloned
+   * raw node, so a picture's blip and other markup are untouched.
+   */
+  altText?: string;
+  /**
+   * This shape's OWN rotation in degrees (`a:xfrm/@rot`, on `spPr/a:xfrm`
+   * for `sp`/`cxnSp`/`pic`, or directly on a top-level `graphicFrame`'s own
+   * `a:xfrm`), when present. A top-level anchor's position/size is governed
+   * by {@link from}/{@link to}/{@link ext}, never by this `a:xfrm`'s own
+   * `off`/`ext` (see {@link rawXml}'s doc), but `rot`/`flipH`/`flipV` on that
+   * same `a:xfrm` DO apply visually: verified against real PowerPoint (COM),
+   * which writes e.g. `<a:xfrm rot="1800000"><a:off .../><a:ext .../></a:xfrm>`
+   * on a rotated overlay shape's `spPr`, with the `off`/`ext` values
+   * unrelated to the anchor's own `cdr:from`/`cdr:to`.
+   */
+  rotation?: number;
+  /** This shape's OWN horizontal flip (`a:xfrm/@flipH`); see {@link rotation}'s doc. */
+  flipH?: boolean;
+  /** This shape's OWN vertical flip (`a:xfrm/@flipV`); see {@link rotation}'s doc. */
+  flipV?: boolean;
+  /**
+   * Verbatim source XML of a `pic` or `graphicFrame` anchor child (the
+   * `cdr:pic` / `cdr:graphicFrame` node itself, not the enclosing anchor),
+   * or of the `cdr:grpSp` node itself when `kind === 'grpSp'` and the
+   * group is untouched since parse (byte-identical passthrough). None of
+   * these three kinds have a reconstructable typed representation that is
+   * guaranteed lossless (a picture's blip reference, a nested chart/table's
+   * graphic content, or a group's exact child ordering/ids), so the
+   * serializer re-emits this verbatim when present instead of a lossy
+   * rebuild. Editing a shape inside a group (via the SDK's path-based
+   * overlay operations) clears the group's `rawXml` so the serializer
+   * regenerates it from {@link transform}/{@link children} instead. Absent
+   * for `sp`/`cxnSp`, which round-trip losslessly through their typed
+   * fields above.
+   */
+  rawXml?: XmlObject;
+  /** Present when `kind === 'grpSp'`: the group's own transform. */
+  transform?: PptxChartUserShapeGroupTransform;
+  /** Present when `kind === 'grpSp'`: the grouped children, nested arbitrarily. */
+  children?: PptxChartUserShapeGroupChild[];
 }
 //#endregion
 //#region src/core/types/chart.d.ts
@@ -2670,7 +2860,7 @@ interface PptxChartUserShape {
  * @example
  * ```ts
  * const type: PptxChartType = "bar";
- * // => "bar" — one of: "bar" | "line" | "pie" | "doughnut" | "area" | "scatter" | …
+ * // => "bar": one of: "bar" | "line" | "pie" | "doughnut" | "area" | "scatter" | …
  * ```
  */
 type PptxChartType = 'bar' | 'line' | 'pie' | 'ofPie' | 'doughnut' | 'area' | 'scatter' | 'bubble' | 'radar' | 'stock' | 'bar3D' | 'line3D' | 'pie3D' | 'area3D' | 'surface' | 'histogram' | 'waterfall' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap' | 'combo' | 'unknown';
@@ -2705,7 +2895,7 @@ type PptxBar3DShape = 'box' | 'cone' | 'coneToMax' | 'cylinder' | 'pyramid' | 'p
  * @example
  * ```ts
  * const type: PptxChartTrendlineType = "linear";
- * // => "linear" — one of: "linear" | "exponential" | "logarithmic" | "polynomial" | "power" | "movingAvg"
+ * // => "linear": one of: "linear" | "exponential" | "logarithmic" | "polynomial" | "power" | "movingAvg"
  * ```
  */
 type PptxChartTrendlineType = 'linear' | 'exponential' | 'logarithmic' | 'polynomial' | 'power' | 'movingAvg';
@@ -2756,7 +2946,7 @@ type PptxChartErrBarType = 'both' | 'minus' | 'plus';
  * @example
  * ```ts
  * const valType: PptxChartErrValType = "percentage";
- * // => "percentage" — one of: "cust" | "fixedVal" | "percentage" | "stdDev" | "stdErr"
+ * // => "percentage": one of: "cust" | "fixedVal" | "percentage" | "stdDev" | "stdErr"
  * ```
  */
 type PptxChartErrValType = 'cust' | 'fixedVal' | 'percentage' | 'stdDev' | 'stdErr';
@@ -2875,6 +3065,14 @@ interface PptxChartDataPoint {
   bubble3D?: boolean;
   /** Per-point picture-fill flags (`c:dPt/c:pictureOptions`). */
   picture?: PptxChartDataPointPicture;
+  /**
+   * This point's identity GUID (`c:dPt/c:extLst/c:ext/c16:uniqueId/@val`,
+   * the Office 2014+ `{C3380CC4-5D6E-409C-BE32-E72D297353CC}` chart
+   * extension), read-only here: an edited point keeps its existing
+   * `c:extLst` as passthrough (see `chart-datapoint-serializer.ts`), so this
+   * field exists for introspection rather than round-trip.
+   */
+  uniqueId?: string;
 }
 /** Schema values accepted by `c:dLblPos`. */
 type PptxChartDataLabelPosition = 'bestFit' | 'b' | 'ctr' | 'inBase' | 'inEnd' | 'l' | 'outEnd' | 'r' | 't';
@@ -2951,7 +3149,7 @@ interface PptxChartAxisFormatting extends PptxChartAxisLabelFormatting {
   axPos?: 'b' | 'l' | 'r' | 't';
   /** Unique axis identifier (c:axId/@val) used to link series to axes. */
   axisId?: number;
-  /** Cross-axis identifier — the axis this axis crosses. */
+  /** Cross-axis identifier: the axis this axis crosses. */
   crossAxisId?: number;
   /** Automatic crossing mode (`c:crosses`). Mutually exclusive with `crossesAt`. */
   crosses?: 'autoZero' | 'min' | 'max';
@@ -3203,6 +3401,54 @@ interface PptxChartSeries {
   waterfallOptions?: PptxChartWaterfallOptions;
   regionMapOptions?: PptxChartRegionMapOptions;
   treemapOptions?: PptxChartTreemapOptions;
+  /**
+   * Series-level picture-fill flags (`c:ser/c:pictureOptions`), legal
+   * wherever a per-point `c:dPt/c:pictureOptions` is (CT_BarSer): paints
+   * EVERY point in the series with one picture unless a `c:dPt` overrides it
+   * for that point alone. A point's own {@link PptxChartDataPoint.picture}
+   * takes precedence entirely (not merged field-by-field) when it resolves
+   * its own image; renderers fall back to this series-level picture only
+   * when the point has none of its own.
+   */
+  picture?: PptxChartDataPointPicture;
+  /**
+   * This series' identity GUID (`c:ser/c:extLst/c:ext/c16:uniqueId/@val`,
+   * the Office 2014+ `{C3380CC4-5D6E-409C-BE32-E72D297353CC}` chart
+   * extension). PowerPoint uses it to track a series across edits and
+   * collaborators independent of its `c:idx`/`c:order` position (the same
+   * role animation targeting and CRDT reconciliation need). An edited
+   * existing series keeps its own `c:extLst` as passthrough; a NEW series
+   * added by cloning an existing one as a template is given a freshly
+   * generated id rather than duplicating the template's (see
+   * `regenerateClonedUniqueId` in `chart-series-identity.ts`), since two
+   * series sharing one identity is exactly what this extension exists to
+   * prevent.
+   */
+  uniqueId?: string;
+}
+/**
+ * A series PowerPoint's "Chart Filters" feature hid from the plot while
+ * keeping it in the workbook (`c:<type>Chart/c:extLst/c:ext
+ * [@uri={02D57815-91ED-43cb-92C2-25804820EDAC}]/c15:filtered<Type>Series
+ * /c15:ser`). Read-mostly: {@link PptxChartData.filteredSeries} exists for
+ * introspection (AI tools, "unhide filtered series" UI) and round-trips as
+ * passthrough through the preserved chart XML when untouched. See
+ * `utils/chart-filtered-series.ts` for the parse rules and the idx-collision
+ * fix this modelling enables on save.
+ */
+interface PptxChartFilteredSeries {
+  /** `c15:ser/c:idx/@val`, the workbook column position this series still occupies. */
+  idx: number;
+  /** `c15:ser/c:order/@val`, defaulting to {@link idx} when absent. */
+  order: number;
+  /** Series name, from the hidden series' own `c:tx` cache. */
+  name?: string;
+  /** Category labels, from the hidden series' own `c:cat` cache. */
+  categories?: string[];
+  /** Data values, from the hidden series' own `c:val` cache. */
+  values?: number[];
+  /** This hidden series' own identity GUID (`c16:uniqueId`), when present. */
+  uniqueId?: string;
 }
 /**
  * Chart-level data-label options (`c:dLbls` directly under a chart-type
@@ -3226,6 +3472,19 @@ interface PptxChartDataLabelOptions {
   separator?: string;
   /** Show leader lines where supported (`c:showLeaderLines`). */
   showLeaderLines?: boolean;
+  /**
+   * Leader-line stroke styling for offset (pie/doughnut `outEnd`/`bestFit`)
+   * labels. Resolved from the base `c:leaderLines/c:spPr` when present, else
+   * falling back to the Office 2013+ chart15 extension's mirror
+   * (`c:extLst/c:ext/c15:leaderLines/c:spPr`, uri
+   * `{CE6537A1-D6FC-4f65-9D91-7224C49458BB}`), which is the one PowerPoint
+   * itself treats as authoritative when both are present. Confirmed against
+   * `e2e/fixtures/issue-132-gradient-fill.pptx` and
+   * `e2e/fixtures/issue-132-hr-deck.pptx`, both of which write only the
+   * extension form. `undefined` leaves the renderer's own default leader-line
+   * stroke.
+   */
+  leaderLineStyle?: PptxChartShapeProps;
   /**
    * Label position (`c:dLblPos`). Valid values depend on the chart type
    * (`ctr`, `inEnd`, `inBase`, `outEnd`, `bestFit`, `l`, `r`, `t`, `b`).
@@ -3379,12 +3638,12 @@ interface PptxBubbleChartOptions {
  *
  * All fields are optional and round-trip verbatim.
  *
- * - {@link rotX} — X-axis rotation in degrees (-90…90).
- * - {@link rotY} — Y-axis rotation in degrees (0…360).
- * - {@link depthPercent} — chart depth as a percentage of base width.
- * - {@link rAngAx} — `true` if axes meet at right angles.
- * - {@link perspective} — perspective angle in degrees (0…240).
- * - {@link hPercent} — height as a percentage of chart width.
+ * - {@link rotX}: X-axis rotation in degrees (-90…90).
+ * - {@link rotY}: Y-axis rotation in degrees (0…360).
+ * - {@link depthPercent}: chart depth as a percentage of base width.
+ * - {@link rAngAx}: `true` if axes meet at right angles.
+ * - {@link perspective}: perspective angle in degrees (0…240).
+ * - {@link hPercent}: height as a percentage of chart width.
  */
 interface PptxChartView3D {
   rotX?: number;
@@ -3398,12 +3657,17 @@ interface PptxChartView3D {
  * Chart "chrome" flags from `c:chart` that round-trip cleanly even when
  * rendering ignores them.
  *
- * - {@link autoTitleDeleted} — `c:autoTitleDeleted/@val`. Suppresses the
+ * - {@link autoTitleDeleted}: `c:autoTitleDeleted/@val`. Suppresses the
  *   auto-generated title for single-series charts.
- * - {@link dispBlanksAs} — `c:dispBlanksAs/@val`. How blank cells
+ * - {@link dispBlanksAs}: `c:dispBlanksAs/@val`. How blank cells
  *   render: `"gap"`, `"zero"`, or `"span"`.
- * - {@link showDLblsOverMax} — `c:showDLblsOverMax/@val`. Keeps data
+ * - {@link showDLblsOverMax}: `c:showDLblsOverMax/@val`. Keeps data
  *   labels visible for points exceeding the value-axis maximum.
+ * - {@link dispNaAsBlank}: the Office 2017+ chart extension
+ *   `c:extLst/c:ext/c16r3:dataDisplayOptions16/c16r3:dispNaAsBlank/@val`
+ *   (uri `{56B9EC1D-385E-4148-901F-78D8002777C0}`), PowerPoint's "Show #N/A
+ *   as an empty cell" chart option. Confirmed against real corpus markup
+ *   (`e2e/fixtures/chart-data-fidelity.pptx`).
  *
  * `c:plotVisOnly` lives on {@link PptxChartData.plotVisibleOnly} and is
  * intentionally not duplicated here.
@@ -3412,6 +3676,7 @@ interface PptxChartChrome {
   autoTitleDeleted?: boolean;
   dispBlanksAs?: 'gap' | 'zero' | 'span';
   showDLblsOverMax?: boolean;
+  dispNaAsBlank?: boolean;
 }
 /** Manual chart placement from `c:layout/c:manualLayout` (CT_ManualLayout). */
 interface PptxChartManualLayout {
@@ -3507,6 +3772,13 @@ interface PptxChartData {
   categoryLevels?: string[][];
   dateCategories?: PptxChartDateCategories;
   series: PptxChartSeries[];
+  /**
+   * Series hidden from the plot by PowerPoint's "Chart Filters" feature
+   * (Series tab) but still present in the workbook, aggregated across every
+   * chart-type container (combo charts can carry more than one). Absent
+   * when the chart has no such extension. See {@link PptxChartFilteredSeries}.
+   */
+  filteredSeries?: PptxChartFilteredSeries[];
   /** Chart style/formatting metadata. */
   style?: PptxChartStyle;
   /** Grouping mode for bar/area/line charts: 'clustered' | 'stacked' | 'percentStacked' */
@@ -3630,9 +3902,9 @@ interface PptxChartData {
   /**
    * Color cycling method from the chart color style part's `meth` attribute.
    *
-   * - `"cycle"` — repeat the palette colours in order (default)
-   * - `"withinLinear"` — gradient within each series
-   * - `"acrossLinear"` — gradient across series
+   * - `"cycle"`: repeat the palette colours in order (default)
+   * - `"withinLinear"`: gradient within each series
+   * - `"acrossLinear"`: gradient across series
    */
   colorMethod?: 'cycle' | 'withinLinear' | 'acrossLinear';
   /** Internal source color-style part path used for lossless dirty saves. */
@@ -5813,6 +6085,21 @@ interface PptxAccessibilityProperties {
    */
   isDecorative?: boolean;
 }
+/**
+ * Accessibility description/title from `p:cNvPr/@descr` / `@title` on a
+ * plain shape, text box or connector (`p:sp` / `p:cxnSp`). The same pair of
+ * attributes already round-trips for a graphic frame (see
+ * {@link TablePptxElement.altText}) and, `descr` only, for a picture
+ * ({@link PptxImageProperties.altText}); this mixin extends it to the three
+ * element kinds whose PowerPoint Alt Text pane data was previously dropped
+ * on load because neither field existed on the model.
+ */
+interface PptxNonVisualDescription {
+  /** `p:cNvPr/@descr`. */
+  altText?: string;
+  /** `p:cNvPr/@title`. */
+  title?: string;
+}
 /**
  * `a:cNvPicPr/@preferRelativeResize` (issue G13), a picture-only non-visual
  * property distinct from `a:picLocks`.
@@ -5845,7 +6132,7 @@ interface PptxPictureNonVisualProperties {
  * // => satisfies TextPptxElement
  * ```
  */
-interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'text';
 }
 /**
@@ -5863,7 +6150,7 @@ interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShape
  * // => satisfies ShapePptxElement
  * ```
  */
-interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxCustomPathProperties, PptxAccessibilityProperties {
+interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxCustomPathProperties, PptxAccessibilityProperties, PptxNonVisualDescription {
   type: 'shape';
 }
 /**
@@ -5885,7 +6172,7 @@ interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShap
  * // => satisfies ConnectorPptxElement
  * ```
  */
-interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'connector';
 }
 /**
@@ -6180,13 +6467,14 @@ interface MediaPptxElement extends PptxElementBase {
    */
   isLinked?: boolean;
   /**
-   * Accessibility description from `p:nvGraphicFramePr/p:cNvPr/@descr`.
-   * Only populated for the `p:graphicFrame`-shaped (SDK-created) media
-   * form; a `p:pic`-shaped media element's alt text is not currently
-   * parsed (see `PptxHandlerRuntimePictureParsing.ts`).
+   * Accessibility description. Read from `p:nvGraphicFramePr/p:cNvPr/@descr`
+   * for the `p:graphicFrame`-shaped (SDK-created) media form, or from
+   * `p:nvPicPr/p:cNvPr/@descr` for the `p:pic`-shaped media form (real
+   * PowerPoint's usual authoring shape for a video/audio placeholder); see
+   * `PptxHandlerRuntimePictureParsing.ts`.
    */
   altText?: string;
-  /** Accessibility title from `p:nvGraphicFramePr/p:cNvPr/@title`. Same scope note as {@link altText}. */
+  /** Accessibility title, from the same `@title` attribute on whichever `p:cNvPr` the media form uses. Same scope note as {@link altText}. */
   title?: string;
   /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
   extensionXml?: PptxGraphicFrameExtension[];
@@ -6213,6 +6501,46 @@ interface GroupPptxElement extends PptxElementBase {
   children: PptxElement[];
   /** Fill style extracted from the group's `p:grpSpPr`, used for `a:grpFill` inheritance. */
   groupFill?: ShapeStyle;
+  /**
+   * The SAME `p:grpSpPr` extraction as {@link groupFill}, kept whenever the
+   * group carries a `p:grpSpPr` at all, regardless of whether it resolved to
+   * a paintable fill.
+   *
+   * `groupFill` is `undefined` unless the group has a real fill, because
+   * `getGroupChildParentFill`/`groupChildInheritedFill` (the `a:grpFill`
+   * inheritance chain) must keep chaining through an ancestor's fill when
+   * THIS group has none of its own. A group whose `p:grpSpPr` authors only
+   * `a:effectLst` (shadow/glow/soft-edge/reflection, no fill) needs those
+   * effects to still reach the renderer, so they are kept here under a name
+   * that carries no fill-inheritance meaning. Currently only reflection is
+   * read from it (`getComputedEffectStyle`); the rest of `a:effectLst` on a
+   * group remains unsupported.
+   */
+  groupEffectStyle?: ShapeStyle;
+  /**
+   * Exact EMU the group's own `a:chOff`/`a:chExt` (the coordinate space its
+   * CHILDREN are authored in) were parsed from, alongside {@link
+   * PptxElementBase.xEmu} etc for the group's own placement in its PARENT's
+   * space. `undefined` when the source carried no usable `a:chOff`/`a:chExt`
+   * (an SDK-created group, or one whose `a:xfrm` had no child-space data).
+   *
+   * Used by `group-xfrm-preservation.ts`'s `hasCapturedChildSpace` to decide
+   * whether this group's original `a:chOff`/`a:chExt` can be re-emitted
+   * verbatim (always true once captured, regardless of whether anything in
+   * the subtree has moved or resized - only its DIRECT children's
+   * `a:off`/`a:ext` are recomputed, via `invertChildIntoGroupSpace`, when
+   * something changed), instead of the normalized `chOff 0,0` / `chExt ==
+   * ext` space the writer falls back to when this is `undefined` (or
+   * degenerate). See `group-shape-geometry.ts`'s module doc for why a group
+   * needs two coordinate systems at all.
+   */
+  chOffXEmu?: number;
+  /** See {@link chOffXEmu}. */
+  chOffYEmu?: number;
+  /** See {@link chOffXEmu}. */
+  chExtWidthEmu?: number;
+  /** See {@link chOffXEmu}. */
+  chExtHeightEmu?: number;
 }
 /**
  * A freehand ink / drawing stroke captured with a stylus or mouse.
@@ -6241,6 +6569,24 @@ interface InkPptxElement extends PptxElementBase {
    * variable-width strokes that reflect stylus/pen pressure.
    */
   inkPointPressures?: number[][];
+  /**
+   * Per-path arrays of per-point pen-tilt lean direction (degrees, straight
+   * from `PointerEvent.tiltX` on supporting hardware).
+   *
+   * Each entry corresponds to the path at the same index in `inkPaths`, and
+   * is paired positionally with {@link inkPointTiltY}. Present only when at
+   * least one point in the stroke reported a genuinely non-zero tilt: a
+   * device that never reports tilt (a mouse, or a stylus with no tilt
+   * sensor) leaves both arrays absent, the same way `inkPointPressures` is
+   * omitted when pressure never varies. When present, the renderer converts
+   * the raw `(tiltX, tiltY)` vector into a lean angle + magnitude (see
+   * `pptx-viewer-shared`'s `tiltChannelsFromVectors`) and widens the stroke
+   * perpendicular to the lean direction, approximating a chisel-tip
+   * calligraphy nib.
+   */
+  inkPointTiltX?: number[][];
+  /** Per-path, per-point pen-tilt lean direction (degrees), paired with {@link inkPointTiltX}. */
+  inkPointTiltY?: number[][];
   /** Unrecognised graphicFrame extLst extensions, captured verbatim for round-trip. */
   extensionXml?: PptxGraphicFrameExtension[];
 }
@@ -6274,6 +6620,20 @@ interface ContentPartInkStroke {
    * {@link tiltAngles}.
    */
   tiltMagnitudes?: number[];
+  /**
+   * Which InkML channel pair {@link tiltAngles}/{@link tiltMagnitudes} were
+   * decoded from: `'azimuthAltitude'` when the source declared `AZIMUTH`
+   * (optionally paired with `ALTITUDE`); omitted (implying `OTx`/`OTy`, i.e.
+   * `'vector'`) otherwise, including for tilt this library itself captured
+   * from the Draw tool's `PointerEvent.tiltX`/`tiltY`.
+   *
+   * A save that has to rewrite this content part's InkML (see
+   * `inkml-content-part-writer.ts`) uses this to re-declare the SAME channel
+   * pair the file already used, rather than always converting to `OTx`/`OTy`;
+   * the rendered lean is identical either way; only the written channel
+   * NAMES differ.
+   */
+  tiltEncoding?: 'vector' | 'azimuthAltitude';
 }
 /**
  * A content-part element wrapped in `mc:AlternateContent`.
@@ -7108,17 +7468,28 @@ interface PptxNativeAnimation {
    */
   afterEffect?: boolean;
   /**
-   * "After animation" end-state behaviour carried over from the matching
-   * {@link PptxElementAnimation.afterAnimation} entry for this effect's
-   * element. Not populated by the native-timing parser itself (there is no
-   * single `p:cTn` attribute for it): `applyAfterAnimationFromEditorList` in
-   * `pptx-viewer-shared` merges it in from the editor's per-element
-   * animation list before playback, since that is the model the animation
-   * panel writes `afterAnimation` into.
+   * "After animation" end-state behaviour: dim-to-colour, hide-after-
+   * animation, or hide-on-next-click. Populated directly by the
+   * native-timing parser (`native-animation-after-effect.ts`) when the
+   * effect's `p:cTn/p:subTnLst` carries PowerPoint's genuine after-effect
+   * shape, so a real-world deck's build shows up here even with no
+   * `pptx:editorMeta`. `applyAfterAnimationFromEditorList` in
+   * `pptx-viewer-shared` overrides this from the matching
+   * {@link PptxElementAnimation.afterAnimation} entry when the editor's
+   * per-element animation list has one (the model the animation panel
+   * writes `afterAnimation` into), so an edit through our own UI always wins.
    */
   afterAnimationAction?: PptxAfterAnimationAction;
-  /** Dim-to color hex, present when {@link afterAnimationAction} is `dimToColor`. */
+  /** Dim-to color hex, present when {@link afterAnimationAction} is `dimToColor` AND the dim target is an already-resolved `a:srgbClr`. */
   afterAnimationColor?: string;
+  /**
+   * The typed theme reference when a `dimToColor` target is an `a:schemeClr`
+   * (e.g. `accent2`) instead of `a:srgbClr`: this parse layer has no theme to
+   * resolve it to sRGB with (see {@link afterAnimationColor}'s doc), so a
+   * playback consumer resolves this against the deck's theme colour map.
+   * Mutually exclusive with {@link afterAnimationColor} being set.
+   */
+  afterAnimationColorRef?: PptxThemeColorRef;
   /**
    * Parsed `p:animEffect` filter descriptor. `presetId`/`presetClass` remain
    * the primary effect selector (see `resolveEffect` in `pptx-viewer-shared`);
@@ -7250,13 +7621,46 @@ interface PptxAnimationKeyframe {
    * fidelity; consumers may use it to drive computed animation values.
    */
   fmla?: string;
+  /**
+   * The typed theme reference when a `p:val/p:clrVal` stop is an
+   * `a:schemeClr` (e.g. `accent1`), including any `tint`/`shade`/`lumMod`/
+   * `lumOff`/`alpha` children. {@link value} keeps the bare scheme name for
+   * round-trip; a playback consumer needs this ref (resolved against the
+   * deck's theme colour map) to turn the stop into a real CSS colour, which
+   * the bare name alone cannot do. Absent for an `a:srgbClr` stop, whose
+   * {@link value} is already a resolved `#rrggbb` hex string.
+   */
+  colorRef?: PptxThemeColorRef;
 }
 /** One generic `p:anim` behaviour inside a composed PowerPoint effect. */
 interface PptxAttributeAnimation {
   /** Lowercased target attribute from `p:attrNameLst`. */
   attrName: string;
-  /** Authored value stops from this behaviour's `p:tavLst`. */
+  /**
+   * Authored value stops from this behaviour's `p:tavLst`. Empty when the
+   * behaviour instead uses the simpler `from`/`to`/`by` attribute form (see
+   * below); at least one of `keyframes`, `from`/`to`, or `by` is present.
+   */
   keyframes: PptxAnimationKeyframe[];
+  /**
+   * `p:anim/@_from` (a formula string, ECMA-376 S19.5.4 CT_TLAnimateBehavior):
+   * the absolute starting value, used instead of `p:tavLst` when the
+   * behaviour only has two endpoints. PowerPoint writes this form for some
+   * built-in presets (e.g. "Grow And Turn"'s `ppt_x` fly-in): a bare
+   * `p:anim from="..." to="..."` with no `p:tavLst` child at all. See
+   * `animation-ppt-formula-ground-truth.md` in `pptx-viewer-shared` for the
+   * real-PowerPoint sample this was found in.
+   */
+  from?: string;
+  /** `p:anim/@_to`: the absolute ending value. See {@link from}. */
+  to?: string;
+  /**
+   * `p:anim/@_by`: a DELTA formula added to wherever the attribute already
+   * stands (as opposed to `from`/`to`'s absolute values), typically paired
+   * with `p:cBhvr/@_additive="sum"` so it composites with a sibling
+   * behaviour driving the same attribute instead of replacing it.
+   */
+  by?: string;
   /** Duration from this behaviour's nested `p:cTn/@dur`. */
   durationMs?: number;
   /** Start offset from this behaviour's nested `p:stCondLst`. */
@@ -7265,8 +7669,11 @@ interface PptxAttributeAnimation {
    * Interpolation mode from this behaviour's own `@_calcmode`
    * (ST_TLAnimateBehaviorCalcMode, ECMA-376 S19.5.2): `discrete` snaps to
    * each `p:tav` stop with no interpolation, `lin` (the OOXML default)
-   * interpolates linearly, `fmla` evaluates `p:tav/@fmla` (not consulted at
-   * playback here; formulas are round-tripped only). Absent means `lin`.
+   * interpolates linearly. `fmla` as the WHOLE behaviour's calc mode has
+   * never been observed in a real PowerPoint file and is not consulted at
+   * playback; what PowerPoint actually writes is `calcmode="lin"` with a
+   * per-stop `p:tav/@fmla` (see {@link PptxAnimationKeyframe.fmla}), which
+   * IS consulted regardless of this field's value. Absent means `lin`.
    */
   calcMode?: 'discrete' | 'lin' | 'fmla';
 }
@@ -7292,16 +7699,31 @@ interface PptxColorAnimation {
    * companion to `@dir` for HSL colour-space animations.
    */
   path?: string;
-  /** Starting color as hex string. */
+  /** Starting color as hex string, or the bare scheme name (e.g. `accent1`) for a theme colour; see {@link fromColorRef}. */
   fromColor?: string;
-  /** Ending color as hex string. */
+  /** Ending color as hex string, or the bare scheme name; see {@link toColorRef}. */
   toColor?: string;
   /**
-   * Color delta (for "by" animations) as hex string. For HSL colour-space
-   * animations this retains the historical byte-packed compatibility value;
-   * consumers should prefer {@link hslDelta}, which preserves signed values.
+   * Color delta (for "by" animations) as hex string, or the bare scheme name;
+   * see {@link byColorRef}. For HSL colour-space animations this retains the
+   * historical byte-packed compatibility value; consumers should prefer
+   * {@link hslDelta}, which preserves signed values.
    */
   byColor?: string;
+  /**
+   * The typed theme reference when {@link fromColor} is an `a:schemeClr`
+   * (including `tint`/`shade`/`lumMod`/`lumOff`/`alpha`), so playback can
+   * resolve it against the deck's theme colour map. Absent when `fromColor`
+   * is already a resolved `#rrggbb` hex (an `a:srgbClr` stop).
+   */
+  fromColorRef?: PptxThemeColorRef;
+  /** The typed theme reference for {@link toColor}; see {@link fromColorRef}. */
+  toColorRef?: PptxThemeColorRef;
+  /**
+   * The typed theme reference for {@link byColor} (RGB colour space only; an
+   * HSL `by` is a signed delta, never a theme colour). See {@link fromColorRef}.
+   */
+  byColorRef?: PptxThemeColorRef;
   /**
    * Typed HSL delta from `p:by/p:hsl`. This preserves signed values and their
    * OOXML units without forcing them through the legacy byte-packed `byColor`
@@ -8514,13 +8936,13 @@ interface PptxSlide {
   backgroundPattern?: PptxSlideBackgroundPattern;
   /**
    * `<p:bgPr/@shadeToTitle>`: boolean flag instructing the renderer to
-   * shade the background gradient toward the title placeholder's text
-   * colour. Parsed and round-tripped here on the core model; the actual
-   * visual effect is applied by `pptx-viewer-shared`'s
+   * anchor the background gradient on the title placeholder as a
+   * rectangular path gradient (COM-measured against real PowerPoint;
+   * it does NOT recolour toward the title's text colour, despite the
+   * attribute's name). Parsed and round-tripped here on the core model;
+   * the actual visual effect is applied by `pptx-viewer-shared`'s
    * `getSlideBackgroundStyle` (see `render/background-shade-to-title.ts`),
-   * consumed by all five bindings, not by core itself. That module's
-   * docstring explains the approximation: no published ECMA-376 or
-   * MS-ODRAWXML text documents the exact legacy blend. Legacy PowerPoint
+   * consumed by all five bindings, not by core itself. Legacy PowerPoint
    * 97-2003 hint, not observed in any real-world corpus file this project
    * has collected and not settable from any modern PowerPoint UI; see
    * `docs/guide/limitations.md`.
@@ -10616,6 +11038,23 @@ declare class PptxHandler extends PptxHandlerCore {
 /** Supported merge shape operations (matching PowerPoint's Merge Shapes menu). */
 type MergeShapeOperation = 'union' | 'intersect' | 'subtract' | 'fragment' | 'combine';
 
+//#region src/render/animation-text-style-resolve.d.ts
+/**
+ * Framework-neutral text-style override a font-style emphasis effect applies
+ * on top of its target's own authored per-run bold/italic/underline/size/
+ * colour. Every binding maps this onto its own text container so it OVERRIDES
+ * the runs' inline styles (the runs carry explicit inline styles of their
+ * own, so plain CSS inheritance cannot reach them).
+ */
+interface TextStyleAnimationDescriptor {
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  /** Relative multiplier against each run's own authored font size. */
+  fontScale?: number;
+  color?: string;
+}
+
 /** Viewer interaction mode: read-only, edit, presentation, or master-view. */
 type ViewerMode = 'preview' | 'edit' | 'present' | 'master';
 /**
@@ -10781,6 +11220,16 @@ interface CollaborationConfig {
    */
   writeBackDebounceMs?: number;
 }
+//#endregion
+//#region src/render/animation-timeline-build-descriptors.d.ts
+/**
+ * `animation-timeline-build-descriptors` - staged-build (`p:bldChart` /
+ * `p:bldDgm`) reveal descriptor types, split out of `animation-timeline-types`
+ * to keep that module under the file-size limit. Re-exported from
+ * `animation-timeline-types` so existing imports are unaffected.
+ *
+ * @module render/animation-timeline-build-descriptors
+ */
 /**
  * Normalized staged-reveal mode for a chart graphic frame, derived from the
  * OOXML `a:bldChart/@bld` (or `p:bldOleChart/@bld`) token:
@@ -10814,12 +11263,12 @@ interface ChartRevealPoint {
  * Playback-time chart reveal state derived from AUTHORED `p:graphicEl`
  * indices (see `chart-reveal-descriptor`'s `resolveChartRevealDescriptor`),
  * rather than from click-count/time progress. Present on
- * {@link ElementAnimationState.chartReveal} only when every fired
- * chart-build step for the element carried index data; a renderer prefers
- * this over the progress-based `build`/`ElementBuildState` path when present,
- * since it reflects the real authored reveal set (correct even for a
- * reversed-order or gapped chart build), and falls back to `build` when
- * absent.
+ * {@link import('./animation-timeline-group').ElementAnimationState.chartReveal}
+ * only when every fired chart-build step for the element carried index data;
+ * a renderer prefers this over the progress-based `build`/`ElementBuildState`
+ * path when present, since it reflects the real authored reveal set (correct
+ * even for a reversed-order or gapped chart build), and falls back to `build`
+ * when absent.
  */
 interface ChartRevealDescriptor {
   /**
@@ -10840,12 +11289,13 @@ interface ChartRevealDescriptor {
  * Playback-time SmartArt diagram reveal state derived from AUTHORED
  * `p:graphicEl/p:dgm/@id` indices (see `diagram-reveal-descriptor`'s
  * `resolveDiagramRevealDescriptor`), rather than from click-count/time
- * progress. Present on {@link ElementAnimationState.diagramReveal} only when
- * every fired diagram-build step for the element carried `p:graphicEl` data.
- * A SmartArt renderer prefers this over the progress-based `build` /
- * {@link ElementBuildState} path when present, since it reflects the real
- * authored reveal set (correct even for a reversed-order or by-branch build),
- * and falls back to `build` when absent.
+ * progress. Present on
+ * {@link import('./animation-timeline-group').ElementAnimationState.diagramReveal}
+ * only when every fired diagram-build step for the element carried
+ * `p:graphicEl` data. A SmartArt renderer prefers this over the
+ * progress-based `build` / {@link ElementBuildState} path when present, since
+ * it reflects the real authored reveal set (correct even for a
+ * reversed-order or by-branch build), and falls back to `build` when absent.
  */
 interface DiagramRevealDescriptor {
   /**
@@ -10858,9 +11308,11 @@ interface DiagramRevealDescriptor {
   nodeIds: ReadonlySet<string>;
 }
 /**
- * Playback-time staged-build state surfaced on {@link ElementAnimationState}.
- * `progress` is the 0..1 fraction of the build revealed at the current playback
- * time; a consumer maps it to its own item COUNT (see `revealedStageCount`).
+ * Playback-time staged-build state surfaced on
+ * {@link import('./animation-timeline-group').ElementAnimationState}.
+ * `progress` is the 0..1 fraction of the build revealed at the current
+ * playback time; a consumer maps it to its own item COUNT (see
+ * `revealedStageCount`).
  */
 type ElementBuildState = {
   kind: 'chart';
@@ -10921,6 +11373,18 @@ interface ElementAnimationState {
    * `stroke: inherit`. Absent/false means no active stroke-colour animation.
    */
   animatesStroke?: boolean;
+  /**
+   * Active discrete font-style / colour / size override (see
+   * {@link import('./animation-timeline-step').TimelineStep.textStyle}) a
+   * font-style emphasis effect currently applies to this element's text,
+   * OVERRIDING the runs' own inline bold/italic/underline/size/colour.
+   * `animation-playback-engine.ts` writes this on step start and again on
+   * cleanup (held in full when the effect's `p:cTn/@fill` holds its end
+   * state, otherwise reverted); a text renderer maps it onto its run markup
+   * via `buildTextStyleOverrideCss` (`animation-text-style-css.ts`). Absent
+   * means no font-style emphasis effect is currently active on this element.
+   */
+  textStyle?: TextStyleAnimationDescriptor;
 }
 //#endregion
 //#region src/render/motion-path-authoring.d.ts
@@ -11836,6 +12300,16 @@ interface ReadOnlyRecommendation {
   readonly messageKey: string;
   /** Whether a binding's "read-only" toggle should default to on. */
   readonly defaultReadOnly: boolean;
+  /**
+   * Whether lifting this recommendation requires a correct password, rather
+   * than a plain "Edit anyway". True only for a `modifyVerifier` that carries
+   * a hash this viewer can actually check (`hashData` + `saltData` +
+   * `algorithmName`, see `checkModifyPassword`). "Mark as Final" is purely
+   * advisory and never requires one, and a `modifyVerifier` missing pieces of
+   * its hash cannot be verified either way, so both fall back to the plain
+   * "Edit anyway" a binding already had.
+   */
+  readonly requiresPassword: boolean;
 }
 interface CompatibilityWarningToast {
   /** Stable per-code id, since toasts are deduped by code (see module docs). */
@@ -12884,6 +13358,15 @@ interface UseYjsDocumentSyncInput {
    * when role === 'owner' and onWriteBack is set.
    */
   getSourceBytes?: () => Uint8Array | null;
+  /**
+   * Session-level save options (view properties, table styles, tags, deck
+   * properties, ...), built the same way as the Save/Export path
+   * (`buildDeckSaveOptions` in `pptx-viewer-shared`). Without this the
+   * write-back reloaded the source bytes and called `handler.save(slides)`
+   * with NO options, so an owner's write-back file dropped every
+   * session-level edit that lives outside `slides`.
+   */
+  getSaveOptions?: () => PptxHandlerSaveOptions;
   /**
    * Monotonic counter bumped each time the content-load pipeline finishes
    * applying a parsed deck to viewer state. A local load that lands while the
@@ -12900,7 +13383,7 @@ interface UseYjsDocumentSyncInput {
    */
   loadOrigin?: CollabLoadOrigin;
 }
-declare function useYjsDocumentSync({ doc, slides, templateElementsBySlideId, setSlides, isConnected, isSynced, config, getSourceBytes, loadVersion, loadOrigin }: UseYjsDocumentSyncInput): void;
+declare function useYjsDocumentSync({ doc, slides, templateElementsBySlideId, setSlides, isConnected, isSynced, config, getSourceBytes, getSaveOptions, loadVersion, loadOrigin }: UseYjsDocumentSyncInput): void;
 //#endregion
 //#region src/viewer/hooks/collaboration/useBroadcastFollower.d.ts
 interface UseBroadcastFollowerInput {
@@ -13107,6 +13590,18 @@ interface UsePresentationModeInput {
    */
   templateElementsBySlideId?: Record<string, PptxElement[]>;
   visibleSlideIndexes: number[];
+  /**
+   * The slide canvas size (px), in the same unit the elements' own
+   * `x`/`y`/`width`/`height` are authored in. Threaded to `useAnimationPlayback`
+   * so a `p:anim` formula that needs the animated shape's real box (e.g. Grow
+   * And Turn's `-#ppt_w/2` fly-in) can be resolved instead of falling back.
+   */
+  canvasSize?: {
+    width: number;
+    height: number;
+  };
+  /** The deck's resolved theme colour map, for a scheme-colour (`a:schemeClr`) animation stop. */
+  themeColorMap?: Readonly<Record<string, string>>;
   activeSlideIndex: number;
   containerRef: React.RefObject<HTMLElement | null>;
   /** Raw PPTX bytes: forwarded to audience window for content sharing. */
@@ -13602,6 +14097,16 @@ interface ViewerCoreState {
   /** Parsed table style definitions from `ppt/tableStyles.xml`. */
   tableStyleMap: ParsedTableStyleMap | undefined;
   setTableStyleMap: React$1.Dispatch<React$1.SetStateAction<ParsedTableStyleMap | undefined>>;
+  /** `ppt/tableStyles.xml`'s `<a:tblStyleLst @def>` default style GUID. */
+  tableStylesDefaultId: string | undefined;
+  setTableStylesDefaultId: React$1.Dispatch<React$1.SetStateAction<string | undefined>>;
+  /**
+   * Style GUIDs deleted from `tableStyleMap` via the table style editor,
+   * pending removal from `ppt/tableStyles.xml` on the next save. See
+   * `tableStyleSaveOptions` / `applyTableStyleDelete` in `pptx-viewer-shared`.
+   */
+  tableStylesToDelete: string[];
+  setTableStylesToDelete: React$1.Dispatch<React$1.SetStateAction<string[]>>;
   /** Available theme presets the user can switch between. */
   themeOptions: PptxThemeOption[];
   setThemeOptions: React$1.Dispatch<React$1.SetStateAction<PptxThemeOption[]>>;
@@ -13851,6 +14356,8 @@ interface UseLoadContentInput {
   setRecentColors: React.Dispatch<React.SetStateAction<string[]>>;
   setTheme: React.Dispatch<React.SetStateAction<PptxTheme | undefined>>;
   setTableStyleMap: React.Dispatch<React.SetStateAction<ParsedTableStyleMap | undefined>>;
+  setTableStylesDefaultId: React.Dispatch<React.SetStateAction<string | undefined>>;
+  setTableStylesToDelete: React.Dispatch<React.SetStateAction<string[]>>;
   setThemeOptions: React.Dispatch<React.SetStateAction<PptxThemeOption[]>>;
   setCustomShows: React.Dispatch<React.SetStateAction<PptxCustomShow[]>>;
   /**
@@ -13881,6 +14388,12 @@ interface UseLoadContentInput {
   }>>>;
   /** Whether the loaded deck recommends opening read-only (`p:modifyVerifier` / "Mark as Final"). */
   setReadOnlyRecommendation: React.Dispatch<React.SetStateAction<ReadOnlyRecommendation>>;
+  /**
+   * The deck's raw `p:modifyVerifier`, kept alongside the recommendation
+   * above so the read-only banner's password prompt can check a candidate
+   * password against it (`checkModifyPassword`, `pptx-viewer-shared`).
+   */
+  setModifyVerifier: React.Dispatch<React.SetStateAction<PptxModifyVerifier | undefined>>;
   /** Deck + slide compatibility-warning toast stack for this load. */
   setCompatToasts: React.Dispatch<React.SetStateAction<CompatibilityWarningToast[]>>;
   setLoading: React.Dispatch<React.SetStateAction<boolean>>;
@@ -13904,7 +14417,7 @@ interface UseLoadContentInput {
 interface UseLoadContentResult {
   handlerRef: React.MutableRefObject<PptxHandler | null>;
 }
-declare function useLoadContent({ content, clearSelection, history, setSlides, setTemplateElementsBySlideId, mediaDataUrls, setCanvasSize, setSlideSizeEmu, setHeaderFooter, setLayoutOptions, setSlideMasters, setModernCommentAuthors, setRecentColors, setTheme, setTableStyleMap, setThemeOptions, setCustomShows, setActiveCustomShowId, setSections, setPresentationProperties, setViewProperties, setNotesMaster, setHandoutMaster, setNotesCanvasSize, setCustomProperties, setTagCollections, setCoreProperties, setAppProperties, setEmbeddedFonts, setActiveSlideIndex, setHasMacros, setHasDigitalSignatures, setDigitalSignatureCount, setGuides, setReadOnlyRecommendation, setCompatToasts, setLoading, setError, setIsDirty, setIsEncrypted, onContentApplied, allowExternalImages }: UseLoadContentInput): UseLoadContentResult;
+declare function useLoadContent({ content, clearSelection, history, setSlides, setTemplateElementsBySlideId, mediaDataUrls, setCanvasSize, setSlideSizeEmu, setHeaderFooter, setLayoutOptions, setSlideMasters, setModernCommentAuthors, setRecentColors, setTheme, setTableStyleMap, setTableStylesDefaultId, setTableStylesToDelete, setThemeOptions, setCustomShows, setActiveCustomShowId, setSections, setPresentationProperties, setViewProperties, setNotesMaster, setHandoutMaster, setNotesCanvasSize, setCustomProperties, setTagCollections, setCoreProperties, setAppProperties, setEmbeddedFonts, setActiveSlideIndex, setHasMacros, setHasDigitalSignatures, setDigitalSignatureCount, setGuides, setReadOnlyRecommendation, setModifyVerifier, setCompatToasts, setLoading, setError, setIsDirty, setIsEncrypted, onContentApplied, allowExternalImages }: UseLoadContentInput): UseLoadContentResult;
 //#endregion
 //#region src/viewer/hooks/useElementOperations.d.ts
 /**
@@ -14315,6 +14828,105 @@ type TableOperationHandlers = TableStructHandlers & TableMergeHandlers;
 //#region src/viewer/hooks/useTableOperations.d.ts
 declare function useTableOperations(input: UseTableOperationsInput): TableOperationHandlers;
 //#endregion
+//#region src/viewer/hooks/useSerialize.d.ts
+interface UseSerializeInput {
+  slides: PptxSlide[];
+  /** Separated master/layout (template) elements, merged back at save time. */
+  templateElementsBySlideId: Record<string, PptxElement[]>;
+  activeSlideIndex: number;
+  /** The pixel canvas the raw Slide Size W/H inputs edit. */
+  canvasSize: CanvasSize;
+  /**
+   * The EMU `p:sldSz` the viewer is holding (seeded on load, replaced by a
+   * preset/orientation pick). Passed with `canvasSize` to
+   * `resolveSlideSizeSelection`, which keeps the EMU whenever the two still
+   * agree so a preset survives the save, and takes the pixels when the user
+   * has typed into the raw inputs.
+   */
+  slideSizeEmu?: SlideSizeEmu | undefined;
+  guides: Array<{
+    id: string;
+    axis: 'h' | 'v';
+    position: number;
+  }>;
+  headerFooter: PptxHeaderFooter;
+  presentationProperties: PptxPresentationProperties;
+  /**
+   * `ppt/viewProps.xml` (grid/snap/guides toggles, grid spacing). Optional so
+   * existing callers/tests that construct this input directly keep compiling;
+   * omitting it (or passing `undefined`) reproduces the PRE-EXISTING bug this
+   * field fixes: core falls back to `this.loadedViewProperties` (the file as
+   * it was FIRST opened) whenever the caller does not pass `viewProperties`
+   * explicitly, so every session change to the View-ribbon toggles was
+   * silently dropped. `useContentLifecycle` always passes `state.viewProperties`.
+   */
+  viewProperties?: PptxViewProperties | undefined;
+  /** Parsed `ppt/tableStyles.xml` map, edited via the table style editor. */
+  tableStyleMap?: ParsedTableStyleMap | undefined;
+  /** `<a:tblStyleLst @def>` default style GUID. */
+  tableStylesDefaultId?: string | undefined;
+  /** Style GUIDs deleted via the table style editor, pending removal on save. */
+  tableStylesToDelete?: string[];
+  customShows: Array<{
+    id: string;
+    name: string;
+    slideRIds: string[];
+  }>;
+  sections: PptxSection[];
+  coreProperties: PptxCoreProperties | undefined;
+  appProperties: PptxAppProperties | undefined;
+  customProperties: PptxCustomProperty[];
+  tagCollections: PptxTagCollection[];
+  /**
+   * The slide masters and their layouts, as View > Slide Master left them.
+   *
+   * Required, not optional: this was the one save option React never passed,
+   * and core rewrites a master or layout part only for the ones the caller
+   * hands back. Every master-view edit therefore showed on screen and was
+   * dropped by the save - a deleted master shape came back on reload, and a
+   * master background reverted to white. The other four bindings pass it.
+   * Core compares each part against the element list parsed at load and
+   * rewrites only what actually changed, so passing the whole array on every
+   * save costs an untouched deck nothing.
+   */
+  slideMasters: PptxSlideMaster[];
+  notesMaster: PptxNotesMaster | undefined;
+  handoutMaster: PptxHandoutMaster | undefined;
+  handlerRef: React$1.RefObject<PptxHandler | null>;
+  inlineEditingElementIdRef: React$1.MutableRefObject<string | null>;
+  inlineEditingTextRef: React$1.MutableRefObject<string>;
+  password?: string;
+  /**
+   * File > Fonts > "Embed fonts in the file". `false` passes
+   * `embeddedFontList: null`, which strips `p:embeddedFontLst`, the `/font`
+   * relationships and the `.fntdata` parts; `true` (the default) leaves core to
+   * re-embed whatever the deck arrived with. Before this the toggle reached no
+   * save call at all and the saved bytes were identical either way.
+   */
+  embedFonts?: boolean;
+  /**
+   * Why these bytes are being produced. Defaults to `'user-file'` (Save, Save
+   * As, Export, the imperative `getContent()`), which honours `password`.
+   * `'recovery-snapshot'` is for bytes the viewer reads back itself - the
+   * autosave snapshot and the re-serialise-then-reload cycle - and is always
+   * plaintext, because nothing on the way back in can supply the password.
+   * See `deck-save-encryption` in `pptx-viewer-shared` for the full rationale
+   * and the privacy tradeoff it accepts.
+   */
+  purpose?: DeckSavePurpose;
+}
+/**
+ * Serialise the live deck. `format` is the container to write (`pptx` when
+ * omitted; `ppsx`/`pptm`/... for Save As). Every save path in the binding
+ * (Save, Save As, `getContent()`, autosave, the theme-apply round trip) goes
+ * through this ONE function so they cannot drift: Save As used to hand-build
+ * its own options object and left out `viewProperties`, the table-style map
+ * and `embedFonts`, so a table style edited in the inspector reached the
+ * imperative `getContent()` bytes and NOT the file the user downloaded.
+ */
+type SerializeSlides = (format?: PptxSaveFormat) => Promise<Uint8Array | null>;
+declare function useSerialize(input: UseSerializeInput): SerializeSlides;
+//#endregion
 //#region src/viewer/hooks/export-handler-types.d.ts
 interface UseExportHandlersInput {
   slides: PptxSlide[];
@@ -14325,46 +14937,33 @@ interface UseExportHandlersInput {
   filePath: string | undefined;
   canvasStageRef: RefObject<HTMLDivElement | null>;
   setActiveSlideIndex: Dispatch<SetStateAction<number>>;
-  handlerRef: RefObject<PptxHandler | null>;
-  /** State from the viewer needed for save-as */
-  headerFooter: Record<string, unknown>;
-  presentationProperties: Record<string, unknown>;
+  /**
+   * The binding's one user-facing serialiser (`useSerialize`), which Save As
+   * calls with the chosen output format. Save As no longer assembles its own
+   * save options, so it cannot drift from Save again.
+   */
+  serializeSlides: SerializeSlides;
+  /** Presentation-level state carried into the deck-JSON export document. */
+  headerFooter: PptxHeaderFooter;
+  presentationProperties: PptxPresentationProperties;
   customShows: Array<{
     id: string;
     name: string;
     slideRIds: string[];
   }>;
-  sections: Array<{
-    id: string;
-    name: string;
-    color?: string;
-    collapsed?: boolean;
-  }>;
-  coreProperties: Record<string, unknown> | null;
-  appProperties: Record<string, unknown> | null;
-  customProperties: Array<Record<string, unknown>>;
-  tagCollections: Array<Record<string, unknown>>;
-  /** The slide masters and their layouts; see `UseExportSaveAsInput`. */
-  slideMasters: PptxSlideMaster[];
-  notesMaster: Record<string, unknown> | undefined;
-  handoutMaster: Record<string, unknown> | undefined;
-  guides: Array<{
-    id: string;
-    axis: 'h' | 'v';
-    position: number;
-  }>;
-  activeSlideIndexForGuides: number;
+  sections: PptxSection[];
+  coreProperties: PptxCoreProperties | undefined;
+  appProperties: PptxAppProperties | undefined;
+  customProperties: PptxCustomProperty[];
+  tagCollections: PptxTagCollection[];
+  notesMaster: PptxNotesMaster | undefined;
+  handoutMaster: PptxHandoutMaster | undefined;
   /** Live theme, carried into the deck-JSON export document. */
   theme: PptxTheme | undefined;
   /** Slide canvas size in CSS pixels, carried into the deck-JSON export. */
   canvasSize: CanvasSize;
-  /**
-   * The EMU `p:sldSz` the viewer holds. Save-As builds its own save options
-   * rather than reusing `useSerialize`, so without this a Slide Size edit
-   * reached Save and not Save As (or the backstage Save, which routes here).
-   */
+  /** The EMU `p:sldSz` the viewer holds, for the deck-JSON export's slide size. */
   slideSizeEmu?: SlideSizeEmu | undefined;
-  password?: string;
   /**
    * File > Options > Advanced > "Image Size and Quality"
    * (`resolveImageResolutionScale`), the raster-scale multiplier for PNG/PDF
@@ -14758,89 +15357,6 @@ interface AnnotationHandlersResult {
 }
 declare function useAnnotationHandlers(input: UseAnnotationHandlersInput): AnnotationHandlersResult;
 //#endregion
-//#region src/viewer/hooks/useSerialize.d.ts
-interface UseSerializeInput {
-  slides: PptxSlide[];
-  /** Separated master/layout (template) elements, merged back at save time. */
-  templateElementsBySlideId: Record<string, PptxElement[]>;
-  activeSlideIndex: number;
-  /** The pixel canvas the raw Slide Size W/H inputs edit. */
-  canvasSize: CanvasSize;
-  /**
-   * The EMU `p:sldSz` the viewer is holding (seeded on load, replaced by a
-   * preset/orientation pick). Passed with `canvasSize` to
-   * `resolveSlideSizeSelection`, which keeps the EMU whenever the two still
-   * agree so a preset survives the save, and takes the pixels when the user
-   * has typed into the raw inputs.
-   */
-  slideSizeEmu?: SlideSizeEmu | undefined;
-  guides: Array<{
-    id: string;
-    axis: 'h' | 'v';
-    position: number;
-  }>;
-  headerFooter: PptxHeaderFooter;
-  presentationProperties: PptxPresentationProperties;
-  /**
-   * `ppt/viewProps.xml` (grid/snap/guides toggles, grid spacing). Optional so
-   * existing callers/tests that construct this input directly keep compiling;
-   * omitting it (or passing `undefined`) reproduces the PRE-EXISTING bug this
-   * field fixes: core falls back to `this.loadedViewProperties` (the file as
-   * it was FIRST opened) whenever the caller does not pass `viewProperties`
-   * explicitly, so every session change to the View-ribbon toggles was
-   * silently dropped. `useContentLifecycle` always passes `state.viewProperties`.
-   */
-  viewProperties?: PptxViewProperties | undefined;
-  customShows: Array<{
-    id: string;
-    name: string;
-    slideRIds: string[];
-  }>;
-  sections: PptxSection[];
-  coreProperties: PptxCoreProperties | undefined;
-  appProperties: PptxAppProperties | undefined;
-  customProperties: PptxCustomProperty[];
-  tagCollections: PptxTagCollection[];
-  /**
-   * The slide masters and their layouts, as View > Slide Master left them.
-   *
-   * Required, not optional: this was the one save option React never passed,
-   * and core rewrites a master or layout part only for the ones the caller
-   * hands back. Every master-view edit therefore showed on screen and was
-   * dropped by the save - a deleted master shape came back on reload, and a
-   * master background reverted to white. The other four bindings pass it.
-   * Core compares each part against the element list parsed at load and
-   * rewrites only what actually changed, so passing the whole array on every
-   * save costs an untouched deck nothing.
-   */
-  slideMasters: PptxSlideMaster[];
-  notesMaster: PptxNotesMaster | undefined;
-  handoutMaster: PptxHandoutMaster | undefined;
-  handlerRef: React$1.RefObject<PptxHandler | null>;
-  inlineEditingElementIdRef: React$1.MutableRefObject<string | null>;
-  inlineEditingTextRef: React$1.MutableRefObject<string>;
-  password?: string;
-  /**
-   * File > Fonts > "Embed fonts in the file". `false` passes
-   * `embeddedFontList: null`, which strips `p:embeddedFontLst`, the `/font`
-   * relationships and the `.fntdata` parts; `true` (the default) leaves core to
-   * re-embed whatever the deck arrived with. Before this the toggle reached no
-   * save call at all and the saved bytes were identical either way.
-   */
-  embedFonts?: boolean;
-  /**
-   * Why these bytes are being produced. Defaults to `'user-file'` (Save, Save
-   * As, Export, the imperative `getContent()`), which honours `password`.
-   * `'recovery-snapshot'` is for bytes the viewer reads back itself - the
-   * autosave snapshot and the re-serialise-then-reload cycle - and is always
-   * plaintext, because nothing on the way back in can supply the password.
-   * See `deck-save-encryption` in `pptx-viewer-shared` for the full rationale
-   * and the privacy tradeoff it accepts.
-   */
-  purpose?: DeckSavePurpose;
-}
-declare function useSerialize(input: UseSerializeInput): () => Promise<Uint8Array | null>;
-//#endregion
 //#region src/viewer/hooks/useRecoveryDetection.d.ts
 interface UseRecoveryDetectionInput {
   filePath: string | undefined;
@@ -14875,6 +15391,18 @@ interface UsePresentationSetupInput {
   /** Master/layout shapes painted beneath each slide, by slide id (see `usePresentationMode`). */
   templateElementsBySlideId?: Record<string, PptxElement[]>;
   visibleSlideIndexes: number[];
+  /**
+   * The slide canvas size (px), in the same unit the elements' own
+   * `x`/`y`/`width`/`height` are authored in. Threaded to `useAnimationPlayback`
+   * so a `p:anim` formula that needs the animated shape's real box (e.g. Grow
+   * And Turn's `-#ppt_w/2` fly-in) can be resolved instead of falling back.
+   */
+  canvasSize?: {
+    width: number;
+    height: number;
+  };
+  /** The deck's resolved theme colour map, for a scheme-colour (`a:schemeClr`) animation stop. */
+  themeColorMap?: Readonly<Record<string, string>>;
   activeSlideIndex: number;
   containerRef: React.RefObject<HTMLElement | null>;
   /** Raw PPTX bytes: forwarded to audience window for content sharing. */
@@ -14985,7 +15513,11 @@ interface UseIOHandlersInput {
     canvasStageRef: React$1.RefObject<HTMLDivElement | null>;
   };
   handlerRef: React$1.RefObject<PptxHandler | null>;
-  serializeSlides: () => Promise<Uint8Array | null>;
+  /**
+   * The one user-facing serialiser (`useSerialize`). Save As passes it the
+   * output format, so the downloaded file carries every save option Save does.
+   */
+  serializeSlides: SerializeSlides;
   /**
    * Plaintext serialisation for bytes the viewer feeds straight back into its
    * own loader. "Apply theme" does exactly that, and the loader has no password
@@ -14994,7 +15526,6 @@ interface UseIOHandlersInput {
   serializeForRecovery: () => Promise<Uint8Array | null>;
   setContent: React$1.Dispatch<React$1.SetStateAction<ArrayBuffer | Uint8Array | null>>;
   onContentChange: ((content: Uint8Array) => void) | undefined;
-  password?: string;
   /** File > Options > Advanced > "Image Size and Quality" raster-scale multiplier. */
   imageExportScale?: number;
 }
@@ -15040,13 +15571,18 @@ interface UseContentLifecycleInput {
   allowExternalImages?: boolean;
   /** Forwarded to {@link useLoadContent}: see `useReadOnlyRecommendationState`. */
   setReadOnlyRecommendation: React$1.Dispatch<React$1.SetStateAction<ReadOnlyRecommendation>>;
+  /** Forwarded to {@link useLoadContent}: see `useReadOnlyRecommendationState`. */
+  setModifyVerifier: React$1.Dispatch<React$1.SetStateAction<PptxModifyVerifier | undefined>>;
   /** Forwarded to {@link useLoadContent}: see `useCompatibilityToastsState`. */
   setCompatToasts: React$1.Dispatch<React$1.SetStateAction<CompatibilityWarningToast[]>>;
 }
 interface ContentLifecycleResult {
   handlerRef: React$1.RefObject<PptxHandler | null>;
-  /** Serialise for the user: honours "Encrypt with Password". */
-  serializeSlides: () => Promise<Uint8Array | null>;
+  /**
+   * Serialise for the user: honours "Encrypt with Password". Takes the
+   * optional output container (`ppsx`/`pptm`/...) so Save As shares it.
+   */
+  serializeSlides: SerializeSlides;
   /**
    * Serialise for bytes the viewer reads back itself (autosave snapshot,
    * re-serialise-then-reload). Always plaintext, so recovery - which has no
@@ -15117,6 +15653,8 @@ interface UseViewerIntegrationInput {
   allowExternalImages?: boolean;
   /** Forwarded to `useContentLifecycle` -> `useLoadContent`: see `useReadOnlyRecommendationState`. */
   setReadOnlyRecommendation: Dispatch<SetStateAction<ReadOnlyRecommendation>>;
+  /** Forwarded to `useContentLifecycle` -> `useLoadContent`: see `useReadOnlyRecommendationState`. */
+  setModifyVerifier: Dispatch<SetStateAction<PptxModifyVerifier | undefined>>;
   /** Forwarded to `useContentLifecycle` -> `useLoadContent`: see `useCompatibilityToastsState`. */
   setCompatToasts: Dispatch<SetStateAction<CompatibilityWarningToast[]>>;
   canEdit: boolean;
@@ -15443,51 +15981,46 @@ interface UseDialogCustomShowsResult {
 declare function useDialogCustomShows(input: UseDialogCustomShowsInput): UseDialogCustomShowsResult;
 //#endregion
 //#region src/viewer/hooks/useExportSaveAs.d.ts
+/**
+ * useExportSaveAs: Save-As format handlers and the deck-JSON export.
+ *
+ * Save As is `useSerialize` with an output format. It used to assemble a
+ * SECOND save-options object of its own, and every option added to
+ * `useSerialize` afterwards (`viewProperties`, the table-style map and its
+ * default id / deletions, `embedFonts`) was missing from it: a table style
+ * edited in the inspector reached `getContent()` and autosave, but the file
+ * the backstage Save button downloaded came back with `ppt/tableStyles.xml`
+ * byte-identical to the original. The other four bindings route the format
+ * through their main builder; React now does too.
+ */
 interface UseExportSaveAsInput {
   slides: PptxSlide[];
   /** Separated master/layout (template) elements, merged back at save time. */
   templateElementsBySlideId: Record<string, PptxElement[]>;
   filePath: string | undefined;
-  handlerRef: RefObject<PptxHandler | null>;
-  headerFooter: Record<string, unknown>;
-  presentationProperties: Record<string, unknown>;
+  /** `useSerialize`'s callback: the one place save options are assembled. */
+  serializeSlides: SerializeSlides;
+  /** Presentation-level state, carried into the deck-JSON export document. */
+  headerFooter: PptxHeaderFooter;
+  presentationProperties: PptxPresentationProperties;
   customShows: Array<{
     id: string;
     name: string;
     slideRIds: string[];
   }>;
-  sections: Array<{
-    id: string;
-    name: string;
-    color?: string;
-    collapsed?: boolean;
-  }>;
-  coreProperties: Record<string, unknown> | null;
-  appProperties: Record<string, unknown> | null;
-  customProperties: Array<Record<string, unknown>>;
-  tagCollections: Array<Record<string, unknown>>;
-  /**
-   * The slide masters and their layouts, as View > Slide Master left them.
-   * Save As builds its own options rather than reusing `useSerialize`, so it
-   * needs the same array: without it a master-view edit reached Save and not
-   * Save As. (For a long while it reached neither.)
-   */
-  slideMasters: PptxSlideMaster[];
-  notesMaster: Record<string, unknown> | undefined;
-  handoutMaster: Record<string, unknown> | undefined;
-  guides: Array<{
-    id: string;
-    axis: 'h' | 'v';
-    position: number;
-  }>;
-  activeSlideIndexForGuides: number;
+  sections: PptxSection[];
+  coreProperties: PptxCoreProperties | undefined;
+  appProperties: PptxAppProperties | undefined;
+  customProperties: PptxCustomProperty[];
+  tagCollections: PptxTagCollection[];
+  notesMaster: PptxNotesMaster | undefined;
+  handoutMaster: PptxHandoutMaster | undefined;
   /** Live theme, carried into the deck-JSON export document. */
   theme: PptxTheme | undefined;
   /** Slide canvas size in CSS pixels, carried into the deck-JSON export. */
   canvasSize: CanvasSize;
   /** The EMU `p:sldSz` the viewer holds; see `UseExportHandlersInput`. */
   slideSizeEmu?: SlideSizeEmu | undefined;
-  password?: string;
 }
 interface ExportSaveAsResult {
   handleExportJson: () => void;
@@ -15622,6 +16155,18 @@ interface UseAnimationPlaybackInput {
   onPlayActionSound?: (soundPath: string) => void;
   /** When false, all animations are skipped (elements shown immediately). */
   showWithAnimation?: boolean;
+  /**
+   * The slide canvas size (px), in the same unit the elements' own
+   * `x`/`y`/`width`/`height` are authored in. Lets `PresentationAnimationController
+   * .fromSlide` resolve a `p:anim` formula that needs the animated shape's real
+   * box (e.g. Grow And Turn's `-#ppt_w/2` fly-in) instead of falling back.
+   */
+  canvasSize?: {
+    width: number;
+    height: number;
+  };
+  /** The deck's resolved theme colour map, for a scheme-colour (`a:schemeClr`) animation stop. */
+  themeColorMap?: Readonly<Record<string, string>>;
 }
 /** How a slide's animation timeline should be seeded when it becomes active. */
 interface SeedSlideAnimationOptions {