pptx-react-viewer 3.9.0 → 3.10.0

package/dist/index.js

@@ -1,176 +1,176 @@
 'use strict';
 
-var chunk3NIJ5HIZ_js = require('./chunk-3NIJ5HIZ.js');
-require('./chunk-K6Q6KLA6.js');
-var chunk5CPGDXD6_js = require('./chunk-5CPGDXD6.js');
-var chunkLBJAVP3H_js = require('./chunk-LBJAVP3H.js');
-var chunkG3JPCRKN_js = require('./chunk-G3JPCRKN.js');
-var chunkTEVGDXVW_js = require('./chunk-TEVGDXVW.js');
+var chunkDZ3HWACD_js = require('./chunk-DZ3HWACD.js');
+require('./chunk-HYUPPQJW.js');
+var chunkFHOUTYMB_js = require('./chunk-FHOUTYMB.js');
+var chunkXW46A7DN_js = require('./chunk-XW46A7DN.js');
+var chunk2Q2NFPXA_js = require('./chunk-2Q2NFPXA.js');
+var chunkY6GG2OOW_js = require('./chunk-Y6GG2OOW.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk3NIJ5HIZ_js.PowerPointViewer; }
+  get: function () { return chunkDZ3HWACD_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunk3NIJ5HIZ_js.SlideCanvas; }
+  get: function () { return chunkDZ3HWACD_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunk3NIJ5HIZ_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkDZ3HWACD_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunk3NIJ5HIZ_js.SlideTemplatePreview; }
+  get: function () { return chunkDZ3HWACD_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunk3NIJ5HIZ_js.Toolbar; }
+  get: function () { return chunkDZ3HWACD_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunk3NIJ5HIZ_js.ViewerThemeProvider; }
+  get: function () { return chunkDZ3HWACD_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunk3NIJ5HIZ_js.useViewerTheme; }
+  get: function () { return chunkDZ3HWACD_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunk5CPGDXD6_js.renderToCanvas; }
+  get: function () { return chunkFHOUTYMB_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunk5CPGDXD6_js.useViewerBuildingBlocks; }
+  get: function () { return chunkFHOUTYMB_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkLBJAVP3H_js.getAnimationInitialStyle; }
+  get: function () { return chunkXW46A7DN_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunk2Q2NFPXA_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunk2Q2NFPXA_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunk2Q2NFPXA_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunk2Q2NFPXA_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.SLIDE_TEMPLATES; }
+  get: function () { return chunk2Q2NFPXA_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.THEME_CATALOG; }
+  get: function () { return chunk2Q2NFPXA_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunk2Q2NFPXA_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.buildSlideTemplateContent; }
+  get: function () { return chunk2Q2NFPXA_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.buildSlideTemplateSlide; }
+  get: function () { return chunk2Q2NFPXA_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.clearAllLocalViewerData; }
+  get: function () { return chunk2Q2NFPXA_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.clearStoredViewerPrefs; }
+  get: function () { return chunk2Q2NFPXA_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.defaultCssVars; }
+  get: function () { return chunk2Q2NFPXA_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.defaultRadius; }
+  get: function () { return chunk2Q2NFPXA_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.defaultThemeColors; }
+  get: function () { return chunk2Q2NFPXA_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.getLocalStorageUsageSummary; }
+  get: function () { return chunk2Q2NFPXA_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.isLegacyBinaryPresentation; }
+  get: function () { return chunk2Q2NFPXA_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.isSupportedPresentationFile; }
+  get: function () { return chunk2Q2NFPXA_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.presentationBaseName; }
+  get: function () { return chunk2Q2NFPXA_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.readStoredViewerPrefs; }
+  get: function () { return chunk2Q2NFPXA_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.resolveProfileInitial; }
+  get: function () { return chunk2Q2NFPXA_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk2Q2NFPXA_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.saveViewerProfile; }
+  get: function () { return chunk2Q2NFPXA_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.savedPresentationFileName; }
+  get: function () { return chunk2Q2NFPXA_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.themeToCssVars; }
+  get: function () { return chunk2Q2NFPXA_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.vermilionDarkColors; }
+  get: function () { return chunk2Q2NFPXA_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.vermilionDarkTheme; }
+  get: function () { return chunk2Q2NFPXA_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.vermilionLightColors; }
+  get: function () { return chunk2Q2NFPXA_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.vermilionLightTheme; }
+  get: function () { return chunk2Q2NFPXA_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.vermilionRadius; }
+  get: function () { return chunk2Q2NFPXA_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkG3JPCRKN_js.writeStoredViewerPrefs; }
+  get: function () { return chunk2Q2NFPXA_js.writeStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkTEVGDXVW_js.LOCALE_CATALOG; }
+  get: function () { return chunkY6GG2OOW_js.LOCALE_CATALOG; }
 });

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-76Z3X6JX.mjs';
-import './chunk-3Y63XPIN.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-PCCM7NVY.mjs';
-export { getAnimationInitialStyle } from './chunk-NTWFXLZX.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-VQX7G75Z.mjs';
-export { LOCALE_CATALOG } from './chunk-JBSAKP4Z.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-KWHURCVT.mjs';
+import './chunk-T4ZRSRQZ.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-HJZA3O3S.mjs';
+export { getAnimationInitialStyle } from './chunk-M6GIPAY4.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-UKPGYJ7G.mjs';
+export { LOCALE_CATALOG } from './chunk-TAGG5YNA.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/internals.d.ts

@@ -3076,6 +3076,18 @@ interface PptxChartDataPoint {
 }
 /** Schema values accepted by `c:dLblPos`. */
 type PptxChartDataLabelPosition = 'bestFit' | 'b' | 'ctr' | 'inBase' | 'inEnd' | 'l' | 'outEnd' | 'r' | 't';
+/**
+ * `c15:dlblRangeCache`/`c15:datalabelsRange` (CT_SeriesDataLabelsRange):
+ * PowerPoint 2013+'s "Value From Cells" custom label source, one cell range
+ * supplying every label in a group (chart-type or series `c:dLbls`), with a
+ * cache aligned to point order. See `utils/chart-data-labels-range.ts`.
+ */
+interface PptxChartDataLabelsRange {
+  /** `c15:f`: the cell range formula (e.g. `Sheet1!$D$2:$D$5`). */
+  formula: string;
+  /** `c15:dlblRangeCache`: cached label text, index-aligned with data points. */
+  cache: string[];
+}
 /** Individual data label override (c:dLbl). */
 interface PptxChartDataLabel {
   idx: number;
@@ -3117,6 +3129,14 @@ interface PptxChartDataLabel {
    * over any chart/series-level default when set.
    */
   spPr?: PptxChartShapeProps;
+  /**
+   * `c15:xForSave`: this override exists only so its properties survive a
+   * save/reload round trip; PowerPoint merges it back onto the series'
+   * default label on load. Round-tripped as-is (an edited chart keeps an
+   * existing point's whole `extLst`, this flag included); introspection
+   * only otherwise. See `utils/chart-data-labels-range.ts`.
+   */
+  savedForCompatibilityOnly?: boolean;
 }
 /** Axis number format. */
 interface PptxChartAxisNumFmt {
@@ -3505,6 +3525,22 @@ interface PptxChartDataLabelOptions {
    * (point > series > chart-type).
    */
   txPr?: PptxChartLegendTextStyle;
+  /**
+   * PowerPoint 2013+ "Value From Cells", series-wide form
+   * (`c15:datalabelsRange`, chart15 uri `{CE6537A1-...}`): one cell range
+   * supplies every label in this group, aligned by point index. A
+   * SERIES-WIDE alternative to the per-point `c15:dlblFieldTable` mechanism
+   * (already resolved into {@link PptxChartDataLabel.text} at parse time).
+   * See `utils/chart-data-labels-range.ts`.
+   */
+  dataLabelsRange?: PptxChartDataLabelsRange;
+  /**
+   * `c15:showDataLabelsRange` at the SAME level as {@link dataLabelsRange}:
+   * whether every label in this group resolves through the range's cache.
+   * Distinct from the per-point {@link PptxChartDataLabel} flag of the same
+   * XML name. Only meaningful when {@link dataLabelsRange} is set.
+   */
+  showDataLabelsRange?: boolean;
 }
 /** Typed text defaults for a single chart legend entry. */
 interface PptxChartLegendTextStyle {
@@ -3779,6 +3815,19 @@ interface PptxChartData {
    * when the chart has no such extension. See {@link PptxChartFilteredSeries}.
    */
   filteredSeries?: PptxChartFilteredSeries[];
+  /**
+   * `c15:filteredSeriesTitle`: the auto-generated series title text (e.g.
+   * "Series 3") PowerPoint preserved when the chart filter hid the series
+   * whose data would otherwise have supplied it. See
+   * `utils/chart-ext-titles.ts`. Read-mostly like {@link filteredSeries}.
+   */
+  filteredSeriesTitle?: string;
+  /**
+   * `c15:filteredCategoryTitle`: the auto-numbered category labels ("1",
+   * "2", "3", ...) PowerPoint preserved when the chart filter hid the
+   * category axis source entirely. See `utils/chart-ext-titles.ts`.
+   */
+  filteredCategoryTitle?: string[];
   /** Chart style/formatting metadata. */
   style?: PptxChartStyle;
   /** Grouping mode for bar/area/line charts: 'clustered' | 'stacked' | 'percentStacked' */
@@ -4701,7 +4750,95 @@ interface PptxSmartArtLayoutNode {
   rules?: PptxSmartArtNumericRule[];
   /** `dgm:shape`: this node's own preset geometry override, when present. */
   shape?: PptxSmartArtLayoutNodeShape;
+  /**
+   * `dgm:presOf` (CT_PresentationOf, same iterator shape as `dgm:forEach`):
+   * which data-model point(s) this node's OWN text/geometry binds to -
+   * `axis: ['self']` the point currently being iterated, `['des']` all of
+   * its descendants, `['ch']` its direct children, and so on. Absent or
+   * empty `axis` (including a bare `<dgm:presOf/>`) means the node carries
+   * no text of its own (a pure positioning/decoration wrapper - `composite`,
+   * `sp` spacer, connector cap). See `smartart-layout-interpreter-item-
+   * roles.ts`, the one consumer: it is what lets the interpreter tell a
+   * text-bearing per-item role (a list layout's `childText`, a card
+   * layout's `roleText`/`bodyText`) apart from a same-generation sibling
+   * that positions or decorates instead.
+   */
+  presentationOf?: PptxSmartArtIteratorAttributes;
+  /**
+   * EVERY `dgm:constr` reachable from this node, including ones declared
+   * inside a `dgm:choose`/`dgm:if`/`dgm:else` that wraps THIS layoutNode's
+   * `constrLst` (a genuinely conditional constraint set, e.g. one branch
+   * per data-point count - `gear`'s composite positions its `gear1`/
+   * `gear2`/`gear3` slots this way, so its plain, direct-child-only
+   * `constraints` above is empty for it). Stops at a nested `dgm:layoutNode`
+   * boundary: that child's own conditional constrLst becomes ITS
+   * `allConstraints`, not folded into the parent's. Read-only /
+   * interpretation-only - `constraints` above (this node's own DIRECT
+   * constrLst) remains the one `applySmartArtLayoutDefinition` round-trips,
+   * so editing an unrelated property can never collapse a genuinely
+   * conditional constrLst into a single branch. `undefined` when this node
+   * declares no constrLst at all, in or out of a choose (the common case);
+   * otherwise a superset of `constraints` (every branch, blindly unioned -
+   * this interpreter does not evaluate `dgm:choose` conditions when
+   * indexing constraints, matching the same "flatten both branches"
+   * convention `nestedLayoutNodes` already uses for `children`). See
+   * `smartart-constraint-solver.ts`'s `buildConstraintIndex`, the only
+   * consumer.
+   */
+  allConstraints?: PptxSmartArtConstraint[];
   children?: PptxSmartArtLayoutNode[];
+  /**
+   * The iterator attributes of the ENCLOSING `dgm:forEach` this node was
+   * found through, when `nestedLayoutNodes` (`smartart-layout-definition
+   * .ts`) reached it by walking one - as opposed to being a direct child of
+   * its parent layoutNode, or reached only through a `dgm:choose` wrapper
+   * (a condition, not an iteration, leaves this `undefined`).
+   *
+   * `forEach` above records a node's OWN direct `dgm:forEach` children
+   * (which wrap ITS descendants); this is the opposite direction - the
+   * forEach that wraps the node ITSELF, one level up. A layoutNode can sit
+   * inside more than one enclosing forEach only via nesting, so this is
+   * always the SINGLE nearest one, not a list.
+   *
+   * This is what tells a genuinely repeated per-child template
+   * (`axis="ch"`, `ptType` absent or `"node"`) apart from a once-only or
+   * transition-only sibling that merely happens to sit inside SOME
+   * `dgm:forEach` (a `ptType="parTrans"`/`"sibTrans"` connector, or
+   * `axis="followSib" cnt="1"`) - both can be direct siblings under the
+   * SAME parent layoutNode (`lProcess1`'s `vertFlow` has one forEach for
+   * its `parTrans` connector and a SEPARATE one, `axis="ch"`, for its
+   * repeated `child` items; `vertFlow.forEach` bundles both, but only
+   * `child.forEachOrigin` says which ONE produced it). See
+   * `smartart-layout-interpreter-item-roles-recursive.ts`, the one
+   * consumer. Read-only / interpretation-only, like `allConstraints`:
+   * never round-tripped by `applySmartArtLayoutDefinition`.
+   */
+  forEachOrigin?: PptxSmartArtIteratorAttributes;
+  /**
+   * The condition of the NEAREST enclosing `dgm:if` this node was found
+   * through, when `nestedLayoutNodes` (`smartart-layout-definition.ts`)
+   * reached it via a `dgm:choose`'s `if` branch (as opposed to a direct
+   * child, a `dgm:else` branch - always `undefined` here, see below - or a
+   * `dgm:forEach`, which sets {@link forEachOrigin} instead). Lets a
+   * caller that already has the data-model node list decide whether this
+   * node's OWN branch is genuinely live for a specific point, instead of
+   * treating every choose-flattened branch as unconditionally present
+   * (`nestedLayoutNodes`' pre-existing "flatten every branch" convention,
+   * still the default when this is absent or a caller does not evaluate
+   * it) - e.g. `cycle-matrix--fallback-n2.pptx`'s `child1group`..
+   * `child4group`, each gated on a DIFFERENT top-level point existing and
+   * having its own child (`axis="ch ch" st="N 1" cnt="1 0" func="cnt"
+   * op="gte" val="1"`).
+   *
+   * Deliberately `undefined` for a `dgm:else` branch: ECMA-376 defines it
+   * as "none of the sibling ifs matched", which would need the FULL
+   * sibling list's conditions negated and ANDed together, not a single
+   * condition - no gallery fixture measured needs an else branch's own
+   * guard yet, so it is left unconditional (rendered by default, matching
+   * the pre-existing flatten-everything behaviour) rather than guessed at.
+   * Evaluate with `smartart-layout-interpreter-when.ts`'s `evaluateWhen`.
+   */
+  chooseGuard?: PptxSmartArtWhen;
 }
 /** Metadata and root node from DiagramML CT_DiagramDefinition. */
 interface PptxSmartArtLayoutDefinition {
@@ -5334,6 +5471,14 @@ interface PptxSmartArtData {
    * Consulted by the fallback layout engine for direction/org-chart hints.
    */
   presLayoutVars?: PptxSmartArtPresLayoutVars;
+  /**
+   * The deck's own theme minor-Latin font (`a:fontScheme/a:minorFont/a:latin/
+   * @typeface`): what SmartArt text actually renders in when no per-run
+   * `a:latin` override is present (the common case - see
+   * `smartart-layout-item-font-size.ts`'s font-fit, the one consumer).
+   * Undefined when the theme carries no font scheme at all.
+   */
+  themeMinorFont?: string;
   /** Relationship ID for the diagram data part (for round-trip save). */
   dataRelId?: string;
   /** Relationship ID for the diagram layout part. */
@@ -6293,7 +6438,7 @@ interface SmartArtPptxElement extends PptxElementBase {
  *
  * Used to show type-specific icons and previews in the editor.
  */
-type OleObjectType = 'excel' | 'word' | 'pdf' | 'visio' | 'mathtype' | 'package' | 'unknown';
+type OleObjectType = 'excel' | 'word' | 'powerpoint' | 'pdf' | 'visio' | 'mathtype' | 'package' | 'unknown';
 /**
  * An OLE (Object Linking and Embedding) object.
  *
@@ -6371,6 +6516,15 @@ interface OlePptxElement extends PptxElementBase {
    * `false`; `undefined` means the source authored no explicit value.
    */
   oleUpdateAutomatic?: boolean;
+  /**
+   * Set by the in-viewer OLE content editors (`ole-edit-api.ts`) whenever
+   * `oleEmbeddedData` and/or `previewImageData` have been changed in memory
+   * and still need to be written back into the saved package. Never
+   * authored from a parsed file; purely an in-memory save signal, mirroring
+   * `PptxSlide.isDirty`. The save writer clears it once the pending write
+   * has been queued.
+   */
+  oleContentDirty?: boolean;
   /** Accessibility description from `p:nvGraphicFramePr/p:cNvPr/@descr`. */
   altText?: string;
   /** Accessibility title from `p:nvGraphicFramePr/p:cNvPr/@title`. */
@@ -7300,10 +7454,27 @@ interface PptxNativeAnimation {
   buildLevel?: number;
   /** Group ID linking a `p:bldP` entry to its timing animation node. */
   groupId?: string;
-  /** Sound relationship ID to play when animation triggers (`p:stSnd`). */
+  /**
+   * Sound relationship ID to play when animation triggers. Modern PowerPoint
+   * (COM-verified against 2016) writes this as a `p:audio/p:cMediaNode`
+   * sibling of the effect's own `p:childTnLst`, targeting `p:sndTgt` rather
+   * than a shape; the legacy `p:stSnd` form (directly on `p:cTn`) is still
+   * accepted on load for round-trip of older-authored decks, but PowerPoint
+   * itself no longer writes it and does not recognise it back
+   * (`Effect.EffectInformation.SoundEffect` reads empty against it).
+   */
   soundRId?: string;
   /** Resolved sound file path from relationship. */
   soundPath?: string;
+  /**
+   * The embedded sound's `@_name` (from `p:snd`/`p:sndTgt`). For one of
+   * PowerPoint's 19 built-in stock sounds this is the exact upper-case file
+   * name PowerPoint itself writes (e.g. `"CHIMES.WAV"`); see
+   * `pptx-viewer-shared`'s `effect-sound-catalogue.ts`, which matches this
+   * value back to a gallery entry. Absent for a custom sound with no name,
+   * or when unresolved.
+   */
+  soundName?: string;
   /** Whether to stop any currently playing sound (`p:endSnd`). */
   stopSound?: boolean;
   /**
@@ -7863,10 +8034,24 @@ interface PptxElementAnimation {
   motionPathRotationCenterX?: number;
   /** Motion-path rotation centre Y in slide percentage units (`p:rCtr/@y`). */
   motionPathRotationCenterY?: number;
-  /** Sound relationship ID to play when animation triggers (`p:stSnd`). */
+  /**
+   * Sound relationship ID to play when animation triggers. Written on save
+   * as a `p:audio/p:cMediaNode` sibling of the effect's own `p:childTnLst`
+   * (see `PptxNativeAnimation.soundRId` for the COM-verified detail).
+   */
   soundRId?: string;
   /** Resolved sound file path from relationship. */
   soundPath?: string;
+  /**
+   * The `@_name` to write on the embedded sound (`p:sndTgt`). For a stock
+   * gallery pick this is the exact PowerPoint file name (e.g.
+   * `"CHIMES.WAV"`), which is what makes PowerPoint itself recognise the
+   * sound as that built-in entry when it reopens the saved deck (there is no
+   * separate "built-in" flag anywhere in the schema). Set by
+   * `pptx-viewer-shared`'s `setEffectSound` when the pick carries a
+   * `soundName`; absent for a custom file with no meaningful name.
+   */
+  soundName?: string;
   /** Whether to stop any currently playing sound (`p:endSnd`). */
   stopSound?: boolean;
   /**
@@ -7881,7 +8066,9 @@ interface PptxElementAnimation {
   /**
    * Display name for the chosen sound (e.g. the uploaded file's name),
    * shown by the authoring UI's sound picker. Purely cosmetic; has no
-   * OOXML equivalent and is not required for playback.
+   * OOXML equivalent and is not required for playback. For a stock gallery
+   * pick, the UI derives its label from {@link soundName} via the catalogue
+   * instead of this field.
    */
   soundFileName?: string;
   /**
@@ -10229,7 +10416,7 @@ interface PptxHandlerLoadOptions {
   allowExternalImages?: boolean;
 }
 /** Output format for the save pipeline. */
-type PptxSaveFormat = 'pptx' | 'ppsx' | 'pptm';
+type PptxSaveFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
 interface PptxHandlerSaveOptions {
   headerFooter?: PptxHeaderFooter;
   presentationProperties?: PptxPresentationProperties;
@@ -10325,8 +10512,23 @@ interface PptxHandlerSaveOptions {
    * - `'pptx'` (default): Standard presentation.
    * - `'ppsx'`: Slide-show file (opens in presentation mode).
    * - `'pptm'`: Macro-enabled presentation (requires VBA data).
+   * - `'ppt'`: Legacy binary PowerPoint 97-2003 presentation. Bypasses the
+   *   OOXML ZIP pipeline entirely; see `PptxHandlerRuntimeSaveLegacyPpt`.
+   *   Elements with no binary equivalent (charts, SmartArt, media, OLE, ink,
+   *   3D models) are degraded to a rasterised preview picture or a labelled
+   *   placeholder, each reported via a `scope: 'save'`-adjacent
+   *   `PptxCompatibilityWarning`.
    */
   outputFormat?: PptxSaveFormat;
+  /**
+   * Password for RC4 CryptoAPI encryption of a `'ppt'`-format save. Ignored
+   * for every other {@link outputFormat}; encrypting a `.pptx`/`.ppsx`/`.pptm`
+   * save uses {@link IPptxHandlerRuntime.saveEncrypted}'s separate AES/Agile
+   * OLE2 wrapping instead, since the legacy binary format's own encryption
+   * scheme is embedded directly in the `.ppt` stream rather than wrapping an
+   * already-produced package.
+   */
+  pptPassword?: string;
   /**
    * Embedded fonts to write back (or add) to the saved PPTX.
    *
@@ -12303,11 +12505,13 @@ interface ReadOnlyRecommendation {
   /**
    * 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.
+   * a hash this viewer can actually check (`hashData` plus a resolvable
+   * algorithm, see `checkModifyPassword`; `saltData` is optional and NOT
+   * required, a missing salt is still checkable). "Mark as Final" is purely
+   * advisory and never requires one, and a `modifyVerifier` with no hash at
+   * all, or naming an algorithm this viewer does not implement, cannot be
+   * verified either way, so both fall back to the plain "Edit anyway" a
+   * binding already had.
    */
   readonly requiresPassword: boolean;
 }
@@ -12666,6 +12870,7 @@ interface ToolbarProps {
   onSaveAsPptx: () => void;
   onSaveAsPpsx: () => void;
   onSaveAsPptm: () => void;
+  onSaveAsPpt: () => void;
   hasMacros: boolean;
   onCopySlideAsImage: () => void;
   onPrint: () => void;
@@ -14984,6 +15189,7 @@ interface ExportHandlersResult {
   handleSaveAsPptx: () => void;
   handleSaveAsPpsx: () => void;
   handleSaveAsPptm: () => void;
+  handleSaveAsPpt: () => void;
   handleCancelExport: () => void;
   exportModalOpen: boolean;
   exportModalTitle: string;
@@ -16028,6 +16234,7 @@ interface ExportSaveAsResult {
   handleSaveAsPptx: () => void;
   handleSaveAsPpsx: () => void;
   handleSaveAsPptm: () => void;
+  handleSaveAsPpt: () => void;
 }
 declare function useExportSaveAs(input: UseExportSaveAsInput): ExportSaveAsResult;
 //#endregion