pptx-react-viewer 3.7.0 → 3.8.0

package/dist/internals.d.ts

@@ -2394,7 +2394,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 +2618,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 +2633,80 @@ 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;
+  };
+}
+/**
+ * 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[];
+  /**
+   * 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 +2717,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 +2753,26 @@ interface PptxChartUserShape {
   strokeWidth?: number;
   /** Text paragraphs of the shape's `txBody`, when present. */
   paragraphs?: PptxChartUserShapeParagraph[];
+  /**
+   * 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
@@ -5813,6 +5925,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 +5972,7 @@ interface PptxPictureNonVisualProperties {
  * // => satisfies TextPptxElement
  * ```
  */
-interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'text';
 }
 /**
@@ -5863,7 +5990,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 +6012,7 @@ interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShap
  * // => satisfies ConnectorPptxElement
  * ```
  */
-interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'connector';
 }
 /**
@@ -10781,6 +10908,23 @@ interface CollaborationConfig {
    */
   writeBackDebounceMs?: number;
 }
+//#endregion
+//#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;
+}
 /**
  * Normalized staged-reveal mode for a chart graphic frame, derived from the
  * OOXML `a:bldChart/@bld` (or `p:bldOleChart/@bld`) token:
@@ -10921,6 +11065,18 @@ interface ElementAnimationState {
    * `stroke: inherit`. Absent/false means no active stroke-colour animation.
    */
   animatesStroke?: boolean;
+  /**
+   * Active discrete font-style / colour / size override (see
+   * {@link 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
@@ -12884,6 +13040,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 +13065,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 {
@@ -13602,6 +13767,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 +14026,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[]>>;
   /**
@@ -13904,7 +14081,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, setCompatToasts, setLoading, setError, setIsDirty, setIsEncrypted, onContentApplied, allowExternalImages }: UseLoadContentInput): UseLoadContentResult;
 //#endregion
 //#region src/viewer/hooks/useElementOperations.d.ts
 /**
@@ -14315,6 +14492,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 +14601,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 +15021,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;
@@ -14985,7 +15165,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 +15178,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;
 }
@@ -15045,8 +15228,11 @@ interface UseContentLifecycleInput {
 }
 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
@@ -15443,51 +15629,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;