pptx-react-viewer 3.9.0 → 3.10.0

package/dist/{chunk-TEVGDXVW.js → chunk-Y6GG2OOW.js}

@@ -447,9 +447,20 @@ var translationsEn = {
   "pptx.accessibility.info": "Info: ",
   // Element-level alt text / title (shape, text box, connector). A picture's
   // own alt text field uses `pptx.image.altText` / `pptx.image.altTextPlaceholder`.
+  //
+  // `elementAccessibility.title` is deliberately NOT the bare word "Title":
+  // every graphic-frame kind that shows this section (table/chart/smartArt/
+  // media/ole, `shouldShowAccessibilitySection`) can ALSO have its own
+  // type-specific field captioned exactly "Title" (a chart's `pptx.chart.title`,
+  // an axis's `pptx.chart.axisTitle`). Two inspector fields with the identical
+  // accessible name broke `chart-title-runs.spec.ts`'s inspector edit in
+  // vanilla/svelte (Accessibility renders before the Chart section in those
+  // bindings' DOM, unlike React/Vue): a "first Title-labelled control" lookup
+  // silently edited this alt-text title instead of the chart's own title. See
+  // `chart-title-runs.test.ts`'s label-collision guard.
   "pptx.elementAccessibility.altText": "Alt text",
   "pptx.elementAccessibility.altTextPlaceholder": "Describe this element for accessibility",
-  "pptx.elementAccessibility.title": "Title",
+  "pptx.elementAccessibility.title": "Accessibility title",
   "pptx.elementAccessibility.titlePlaceholder": "Accessibility title (optional)",
   // Animations
   "pptx.animations.previewTooltip": "Preview animation on selected element",
@@ -800,6 +811,10 @@ var translationsEn = {
   "pptx.chart.removeLastSeries": "Remove last series",
   "pptx.chart.seriesShort": "Series",
   "pptx.chart.removeSeries": "Remove series",
+  "pptx.chart.chartFilters": "Chart filters",
+  "pptx.chart.hideSeries": "Hide {{name}}",
+  "pptx.chart.showSeries": "Show {{name}}",
+  "pptx.chart.valueFromCells": "Value from cells: {{name}}",
   "pptx.chart.removeCategory": "Remove category",
   "pptx.chart.axes": "Axes",
   "pptx.chart.min": "Min",
@@ -1401,6 +1416,24 @@ var translationsEn = {
   "pptx.ole.type": "Type",
   "pptx.ole.objectName": "Object Name",
   "pptx.ole.objectNamePlaceholder": "Used by screen readers and the Selection Pane",
+  "pptx.ole.editContent": "Edit content...",
+  "pptx.ole.editDialog.title": "Edit Embedded Object",
+  "pptx.ole.editDialog.tabSheet": "Spreadsheet",
+  "pptx.ole.editDialog.tabDocument": "Document",
+  "pptx.ole.editDialog.tabDeck": "Presentation",
+  "pptx.ole.editDialog.tabFile": "File",
+  "pptx.ole.editDialog.replaceFile": "Replace File...",
+  "pptx.ole.editDialog.replaceFileHint": "Choose a new file to replace this object's content.",
+  "pptx.ole.editDialog.save": "Save",
+  "pptx.ole.editDialog.cancel": "Cancel",
+  "pptx.ole.editDialog.emptyDocument": "This document has no paragraphs to edit.",
+  "pptx.ole.editDialog.emptySheet": "No spreadsheet data could be read from this object.",
+  "pptx.ole.editDialog.deckSlideLabel": "Slide {{number}}",
+  "pptx.ole.editDialog.deckEmpty": "This embedded presentation has no slides.",
+  "pptx.ole.editDialog.unsupported": "This object's content can't be edited directly here. Use Replace File to update it.",
+  "pptx.ole.editDialog.cellEditLabel": "Cell value",
+  "pptx.ole.editDialog.loading": "Loading content...",
+  "pptx.ole.editDialog.saveError": "Could not save the change.",
   // Presentation mode (annotations-on-exit prompt)
   "pptx.presentation.clearAnnotations": "Clear Annotations",
   "pptx.presentation.discardAnnotations": "Discard Annotations",
@@ -2348,6 +2381,29 @@ var translationsEn = {
   "pptx.animation.sound.none": "[No Sound]",
   "pptx.animation.sound.custom": "Choose sound file...",
   "pptx.animation.sound.chooseFile": "Choose an audio file",
+  "pptx.animation.sound.other": "Other Sound...",
+  "pptx.animation.sound.preview": "Preview sound",
+  // PowerPoint's 19 built-in stock sounds (Animation Effect Options > Sound
+  // and Transitions > Sound share this same gallery).
+  "pptx.animation.sound.applause": "Applause",
+  "pptx.animation.sound.arrow": "Arrow",
+  "pptx.animation.sound.bomb": "Bomb",
+  "pptx.animation.sound.breeze": "Breeze",
+  "pptx.animation.sound.camera": "Camera",
+  "pptx.animation.sound.cashRegister": "Cash Register",
+  "pptx.animation.sound.chime": "Chime",
+  "pptx.animation.sound.click": "Click",
+  "pptx.animation.sound.coin": "Coin",
+  "pptx.animation.sound.drumRoll": "Drum Roll",
+  "pptx.animation.sound.explosion": "Explosion",
+  "pptx.animation.sound.hammer": "Hammer",
+  "pptx.animation.sound.laser": "Laser",
+  "pptx.animation.sound.push": "Push",
+  "pptx.animation.sound.suction": "Suction",
+  "pptx.animation.sound.typewriter": "Typewriter",
+  "pptx.animation.sound.voltage": "Voltage",
+  "pptx.animation.sound.whoosh": "Whoosh",
+  "pptx.animation.sound.wind": "Wind",
   "pptx.animation.afterAnimation": "After animation",
   "pptx.animation.afterAnimation.none": "Don't Dim",
   "pptx.animation.afterAnimation.dimToColor": "Dim after animation",
@@ -2399,6 +2455,8 @@ var translationsEn = {
   "pptx.file.png": "PNG",
   "pptx.file.saveAsPpsx": "Save .ppsx",
   "pptx.file.saveAsPpsxTooltip": "Save as Slide Show (.ppsx)",
+  "pptx.file.saveAsPpt": "Save .ppt",
+  "pptx.file.saveAsPptTooltip": "Save as PowerPoint 97-2003 (.ppt)",
   "pptx.file.saveAsPptm": "Save .pptm",
   "pptx.file.saveAsPptmTooltip": "Save as Macro-Enabled (.pptm)",
   "pptx.file.saveAsPptx": "Save .pptx",
@@ -3501,6 +3559,8 @@ var translationsEn = {
   "pptx.backstage.card.saveAsPpsx.body": "Save a .ppsx file that opens directly in slide show.",
   "pptx.backstage.card.saveAsPptm.title": "Macro-Enabled Presentation",
   "pptx.backstage.card.saveAsPptm.body": "Preserve VBA content in a .pptm file.",
+  "pptx.backstage.card.saveAsPpt.title": "PowerPoint 97-2003 Presentation",
+  "pptx.backstage.card.saveAsPpt.body": "Save a binary .ppt copy compatible with older PowerPoint versions.",
   "pptx.backstage.card.pdf.title": "Create PDF",
   "pptx.backstage.card.pdf.body": "Publish a portable document with one page per slide.",
   "pptx.backstage.card.png.title": "Export current slide",

package/dist/i18n.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkTEVGDXVW_js = require('./chunk-TEVGDXVW.js');
+var chunkY6GG2OOW_js = require('./chunk-Y6GG2OOW.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkTEVGDXVW_js.LOCALE_CATALOG; }
+  get: function () { return chunkY6GG2OOW_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "keyToLabel", {
   enumerable: true,
-  get: function () { return chunkTEVGDXVW_js.keyToLabel; }
+  get: function () { return chunkY6GG2OOW_js.keyToLabel; }
 });
 Object.defineProperty(exports, "translationsEn", {
   enumerable: true,
-  get: function () { return chunkTEVGDXVW_js.translationsEn; }
+  get: function () { return chunkY6GG2OOW_js.translationsEn; }
 });

package/dist/i18n.mjs

@@ -1,2 +1,2 @@
-export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-JBSAKP4Z.mjs';
+export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-TAGG5YNA.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/index-CGKutKk1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-CGKutKk1.d.ts","names":[],"sources":["../../shared/dist/i18n/index.d.ts"],"mappings":";;;;;;;;;;;cAUc,gBAAgB;;;;;;;KAOzB,8BAA8B;;;;;;iBAMlB,WAAW;;;;UAIlB;;EAER;;EAEA;;EAEA;;;;;;;;cAQY,yBAAyB"}
+{"version":3,"file":"index-CGKutKk1.d.ts","names":[],"sources":["../../shared/dist/i18n/index.d.ts"],"mappings":";;;;;;;;;;;cAUqB,gBAAgB;;;;;;;KAOhC,8BAA8B;;;;;;iBAMX,WAAW;;;;UAIzB;;EAER;;EAEA;;EAEA;;;;;;;;cAQmB,yBAAyB"}

package/dist/index.d.ts

@@ -3096,6 +3096,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;
@@ -3137,6 +3149,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 {
@@ -3525,6 +3545,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 {
@@ -3799,6 +3835,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' */
@@ -4721,7 +4770,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 {
@@ -5354,6 +5491,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. */
@@ -6313,7 +6458,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.
  *
@@ -6391,6 +6536,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`. */
@@ -7310,10 +7464,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;
   /**
@@ -7873,10 +8044,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;
   /**
@@ -7891,7 +8076,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;
   /**
@@ -10239,7 +10426,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;
@@ -10335,8 +10522,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.
    *
@@ -11737,16 +11939,17 @@ interface ViewerFontSource {
  * working loader unreachable in practice. Whenever the loader learns a format,
  * exactly one list has to change.
  *
- * ## Read many, write one
+ * ## Read many, write several
  *
  * Input is a superset of output. We READ `.pptx`, `.ppsx`, `.pptm`, `.potx`,
- * legacy binary `.ppt` and portable `pptx-viewer-json`; we WRITE only the
- * OpenXML family. That asymmetry is deliberate (PowerPoint itself does the
- * same: open a 97-2003 deck and Save As offers `.pptx`), and it is why
- * {@link savedPresentationFileName} always REPLACES the source extension
- * rather than keeping it. A deck opened as `report.ppt` and saved as
- * `report.ppt` would be a file whose bytes and whose name disagree, which is
- * the kind of thing PowerPoint refuses to open.
+ * legacy binary `.ppt` and portable `pptx-viewer-json`; we WRITE the OpenXML
+ * family plus legacy binary `.ppt` (via `packages/core/src/core/ppt/writer/`,
+ * a real MS-PPT/OLE2 encoder, not a stub). `savedPresentationFileName`
+ * REPLACES the source extension with the extension of the format actually
+ * being written rather than keeping the source's: a deck opened as
+ * `report.pptx` and saved back as `.ppt` (or vice versa) must have its name
+ * agree with its bytes, which is the kind of mismatch PowerPoint itself
+ * refuses to open.
  *
  * This module deliberately imports nothing, so any layer (render, export, a
  * binding, a host app) can depend on it without risking an import cycle.
@@ -11775,10 +11978,14 @@ declare const PPTX_OPEN_ACCEPT: string;
  * before it hands bytes to the loader.
  */
 declare function isSupportedPresentationFile(name: string | null | undefined): boolean;
-/** True for the binary PowerPoint 97-2003 family, which we read but never write. */
+/**
+ * True for the binary PowerPoint 97-2003 family. `.ppt` itself is now also a
+ * SAVE target (see {@link SavedPresentationFormat}); `.pps`/`.pot` (97-2003
+ * show/template) remain read-only siblings sharing the same record format.
+ */
 declare function isLegacyBinaryPresentation(name: string | null | undefined): boolean;
-/** The formats the save path can produce. Binary `.ppt` is deliberately absent. */
-type SavedPresentationFormat = 'pptx' | 'ppsx' | 'pptm';
+/** The formats the save path can produce. */
+type SavedPresentationFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
 /**
  * The stem of a presentation file name: directories and any loadable extension
  * removed. `C:\decks\report.ppt` becomes `report`; a name with no recognised
@@ -11790,9 +11997,10 @@ declare function presentationBaseName(sourceName: string | null | undefined, fal
  * The name a saved copy should be offered under: the source stem plus the
  * extension of the format actually being written.
  *
- * This is what turns `report.ppt` into `report.pptx` on Save As. Output is
- * always an OpenXML package, so keeping the source extension would mislabel
- * the bytes.
+ * This is what turns `report.ppt` into `report.pptx` on a regular Save As,
+ * and `report.pptx` into `report.ppt` when the user explicitly picks the
+ * PowerPoint 97-2003 format. Keeping the source extension would mislabel the
+ * bytes either way.
  */
 declare function savedPresentationFileName(sourceName: string | null | undefined, format?: SavedPresentationFormat): string;
 //#endregion
@@ -12784,6 +12992,7 @@ interface ToolbarProps {
   onSaveAsPptx: () => void;
   onSaveAsPpsx: () => void;
   onSaveAsPptm: () => void;
+  onSaveAsPpt: () => void;
   hasMacros: boolean;
   onCopySlideAsImage: () => void;
   onPrint: () => void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/viewer/components/Toolbar.tsx","../src/viewer/components/SlideCanvas.tsx","../src/viewer/components/SlideTemplateGalleryDialog.tsx","../src/viewer/components/SlideTemplatePreview.tsx","../src/lib/canvas-export.ts"],"mappings":";;;;;;;;iBA+BgB,QAAQ,GAAG,eAAe,MAAM;;;iBCIhC,cACf,aACA,kBACA,YACA,MACA,MACA,SACA,kBACA,sBACA,iBACA,wBACA,mBACA,mBACA,eACA,kBACA,uBACA,WACA,UACA,eACA,YACA,WACA,QACA,2BACA,0BACA,SACA,eACA,aACA,eACA,mBACA,qBACA,yBACA,UACA,oBACA,oBACA,oBACA,mBACA,kBACA,yBACA,cACA,sBACA,kBACA,aACA,iBACA,kBACA,YACA,cACA,cACA,cACA,iBACA,oBACA,mBACA,eACA,kBACA,UACA,oBACA,sBACA,aACA,eACA,wBACA,uBACA,mBACA,yBACA,WACA,aACA,kBACA,cACA,mBACA,sBACA,YACE,mCAAgB,IAAA;;;UCrFF;EAChB;EACA;EACA,WAAW,YAAY;;EAEvB,SAAS;;iBAGM,6BACf,QACA,SACA,UACA,UACE,kCAAkC,MAAM;;;UCT1B;EAChB,YAAY;;EAEZ,SAAS;;iBAGM,uBACf,YACA,UACE,4BAA4B,MAAM;;;;;;;;;;;;;;;;;;;iBCGf,eACrB,SAAS,aACT,UAAS,QAAQ,WACf,QAAQ"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/viewer/components/Toolbar.tsx","../src/viewer/components/SlideCanvas.tsx","../src/viewer/components/SlideTemplateGalleryDialog.tsx","../src/viewer/components/SlideTemplatePreview.tsx","../src/lib/canvas-export.ts"],"mappings":";;;;;;;;wBA+BgB,QAAQ,GAAG,eAAe,MAAM;;;wBCIhC,cACf,aACA,kBACA,YACA,MACA,MACA,SACA,kBACA,sBACA,iBACA,wBACA,mBACA,mBACA,eACA,kBACA,uBACA,WACA,UACA,eACA,YACA,WACA,QACA,2BACA,0BACA,SACA,eACA,aACA,eACA,mBACA,qBACA,yBACA,UACA,oBACA,oBACA,oBACA,mBACA,kBACA,yBACA,cACA,sBACA,kBACA,aACA,iBACA,kBACA,YACA,cACA,cACA,cACA,iBACA,oBACA,mBACA,eACA,kBACA,UACA,oBACA,sBACA,aACA,eACA,wBACA,uBACA,mBACA,yBACA,WACA,aACA,kBACA,cACA,mBACA,sBACA,YACE,mCAAgB,IAAA;;;UCrFF;EAChB;EACA;EACA,WAAW,YAAY;;EAEvB,SAAS;;wBAGM,6BACf,QACA,SACA,UACA,UACE,kCAAkC,MAAM;;;UCT1B;EAChB,YAAY;;EAEZ,SAAS;;wBAGM,uBACf,YACA,UACE,4BAA4B,MAAM;;;;;;;;;;;;;;;;;;;wBCGf,eACrB,SAAS,aACT,UAAS,QAAQ,WACf,QAAQ"}