pptx-vanilla-viewer 2.9.0 → 2.11.0

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import "jszip";
 import { ChatTransport, LanguageModel, ToolSet, UIMessage } from "ai";
 import "pptx-viewer-mcp";
 import { Options } from "html2canvas-pro";
-//#region ../core/dist/text-operations-BtHy_zMG.d.ts
+//#region ../core/dist/text-operations-B8ed8e82.d.ts
 //#region src/core/types/actions.d.ts
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
@@ -3144,6 +3144,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;
@@ -3185,6 +3197,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 {
@@ -3573,6 +3593,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 {
@@ -3847,6 +3883,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' */
@@ -4769,7 +4818,108 @@ 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 conditions of EVERY enclosing `dgm:if` this node was found through,
+   * outermost first, when `nestedLayoutNodes` (`smartart-layout-
+   * definition.ts`) reached it via one or more `dgm:choose`'s `if` branches
+   * (as opposed to a direct child, a `dgm:else` branch contributing no
+   * condition of its own - see below - or a `dgm:forEach`, which sets
+   * {@link forEachOrigin} instead). ALL must hold (evaluate `!== false`,
+   * per {@link chooseGuard}'s own AND semantics - see `evaluateWhen`) for
+   * this node's branch to be genuinely live. A caller that already has the
+   * data-model node list can use this 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"`).
+   *
+   * A CHAIN, not a single condition, because a node can sit inside NESTED
+   * `dgm:choose`s whose OWN conditions are each individually necessary -
+   * `sub-step-process--hier5.pptx`'s `chLin1`..`chLin7` each sit inside
+   * BOTH an outer `dgm:if func="pos" op="equ" val="N"` (which one of the
+   * 7 hand-duplicated per-position templates this is) AND an inner,
+   * nearly-vacuous `dgm:if func="cnt" op="gte" val="1"` (has >= 1 point at
+   * all) - keeping only the NEAREST (inner) one, as an earlier single-
+   * condition design did, loses the ONE piece of information (the outer
+   * `pos` guard) that actually discriminates `chLin1` from `chLin2`.
+   *
+   * A `dgm:else` branch contributes NO condition of its own (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, matching the pre-existing
+   * flatten-everything behaviour) but does NOT clear any OUTER ancestor
+   * guard already accumulated before it. Evaluate with `smartart-layout-
+   * interpreter-when.ts`'s `evaluateWhen`, once per entry, ANDed.
+   */
+  chooseGuard?: PptxSmartArtWhen[];
 }
 /** Metadata and root node from DiagramML CT_DiagramDefinition. */
 interface PptxSmartArtLayoutDefinition {
@@ -5402,6 +5552,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. */
@@ -6361,7 +6519,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.
  *
@@ -6439,6 +6597,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`. */
@@ -7368,10 +7535,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;
   /**
@@ -7931,10 +8115,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;
   /**
@@ -7949,7 +8147,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;
   /**
@@ -9644,7 +9844,7 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 //#endregion
-//#region ../core/dist/index-0zviqnUe.d.ts
+//#region ../core/dist/index-C93FwBlY.d.ts
 //#region src/core/types/theme-presets.d.ts
 /**
  * A complete theme preset that can be applied to a presentation.
@@ -10298,7 +10498,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;
@@ -10394,8 +10594,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.
    *
@@ -11795,16 +12010,17 @@ interface SlideSizeEmu {
  * 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.
@@ -11819,9 +12035,9 @@ interface SlideSizeEmu {
  * suite, which asserts a `.ppt` loads to the same model as the `.pptx` it was
  * exported from.
  */
-declare const PRESENTATION_OPEN_EXTENSIONS: readonly ['.pptx', '.ppsx', '.pptm', '.potx', '.ppt', '.json'];
+export declare const PRESENTATION_OPEN_EXTENSIONS: readonly ['.pptx', '.ppsx', '.pptm', '.potx', '.ppt', '.json'];
 /** Comma-separated `accept` attribute for a presentation file input. */
-declare const PPTX_OPEN_ACCEPT: string;
+export declare const PPTX_OPEN_ACCEPT: string;
 /**
  * True when a picked / dropped file's name looks like something the loader can
  * open. Use this instead of a hand-rolled `endsWith` chain: a drop handler that
@@ -11832,27 +12048,32 @@ declare const PPTX_OPEN_ACCEPT: string;
  * `PptxHandler.load()`; this is only the cheap pre-filter a drop target needs
  * 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. */
-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';
+export declare function isSupportedPresentationFile(name: string | null | undefined): boolean;
+/**
+ * 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.
+ */
+export declare function isLegacyBinaryPresentation(name: string | null | undefined): boolean;
+/** 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
  * extension is kept whole, so `Untitled Presentation` survives intact rather
  * than losing everything after its last dot.
  */
-declare function presentationBaseName(sourceName: string | null | undefined, fallback?: string): string;
+export declare function presentationBaseName(sourceName: string | null | undefined, fallback?: string): string;
 /**
  * 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;
+export declare function savedPresentationFileName(sourceName: string | null | undefined, format?: SavedPresentationFormat): string;
 //#endregion
 //#region src/render/session-restore.d.ts
 /**
@@ -11893,24 +12114,24 @@ interface SessionDeck {
  * @param create Mint and persist an id when the tab does not have one yet.
  *   Reads pass `false` so a fresh tab never claims another tab's record.
  */
-declare function getSessionTabId(create?: boolean): string | null;
+export declare function getSessionTabId(create?: boolean): string | null;
 /**
  * Remember `data` as the deck this tab has open, so the next load can restore
  * it. Resolves `false` when the browser refused to store it; callers treat that
  * as "no restore available later", never as an error.
  */
-declare function rememberSessionDeck(fileName: string, data: Uint8Array): Promise<boolean>;
+export declare function rememberSessionDeck(fileName: string, data: Uint8Array): Promise<boolean>;
 /** The deck remembered for this tab, or `null` when there is nothing to restore. */
-declare function loadSessionDeck(): Promise<SessionDeck | null>;
+export declare function loadSessionDeck(): Promise<SessionDeck | null>;
 /** Forget this tab's deck (the host closed it, or handed the tab to another flow). */
-declare function forgetSessionDeck(): Promise<void>;
+export declare function forgetSessionDeck(): Promise<void>;
 /**
  * The deck to reopen on load: this tab's remembered bytes, upgraded to a newer
  * autosave snapshot of the same file when the viewer wrote one after they were
  * remembered. Without that upgrade a refresh mid-edit would silently roll the
  * presentation back to the state it was opened in.
  */
-declare function restoreSessionDeck(): Promise<SessionDeck | null>;
+export declare function restoreSessionDeck(): Promise<SessionDeck | null>;
 /** Optional seed values for the share start form. */
 interface ShareDefaults {
   roomId?: string;
@@ -11962,8 +12183,8 @@ interface PresentationInkStroke {
   width: number;
   points: PresentationInkPoint[];
 }
-declare function parsePresentationSessionId(hash: string): string | null;
-declare function loadPresentationDeck(sessionId: string): Promise<Uint8Array | null>;
+export declare function parsePresentationSessionId(hash: string): string | null;
+export declare function loadPresentationDeck(sessionId: string): Promise<Uint8Array | null>;
 //#endregion
 //#region src/render/presentation-blackboard.d.ts
 /** Blackout state, as carried by {@link PresentationSnapshot}. */
@@ -12204,11 +12425,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;
 }
@@ -12252,7 +12475,7 @@ type TranslationMessages = Record<string, Record<string, string>>;
  * Build a {@link Translator} for a locale. `messages[locale]` (when provided)
  * wins over the built-in English dictionary; English is always the fallback.
  */
-declare function createTranslator(locale?: string, messages?: TranslationMessages): Translator;
+export declare function createTranslator(locale?: string, messages?: TranslationMessages): Translator;
 //#endregion
 //#region src/viewer/state/store.d.ts
 /**
@@ -12273,7 +12496,7 @@ interface Store<T extends object> {
   /** Subscribe to state changes; returns an unsubscribe function. */
   subscribe(listener: StoreListener<T>): () => void;
 }
-declare function createStore<T extends object>(initial: T): Store<T>;
+export declare function createStore<T extends object>(initial: T): Store<T>;
 //#endregion
 //#region src/viewer/render/types.d.ts
 /** Discriminant values of the {@link PptxElement} union (`'text'`, `'chart'`, ...). */
@@ -12494,7 +12717,7 @@ interface ElementRendererRegistry {
  * `./elements`) installs the built-in renderers plus the typed placeholder
  * fallback.
  */
-declare function createElementRendererRegistry(): ElementRendererRegistry;
+export declare function createElementRendererRegistry(): ElementRendererRegistry;
 //#endregion
 //#region src/viewer/render/dom.d.ts
 /**
@@ -12502,11 +12725,11 @@ declare function createElementRendererRegistry(): ElementRendererRegistry;
  * of camelCase (`backgroundColor`) and kebab-case (`background-color`) keys;
  * both are normalised to `style.setProperty` calls.
  */
-declare function applyStyleMap(el: HTMLElement | SVGElement, style: CssStyleMap): void;
+export declare function applyStyleMap(el: HTMLElement | SVGElement, style: CssStyleMap): void;
 /** Create an element with an optional class and style map. */
-declare function createEl<K extends keyof HTMLElementTagNameMap>(doc: Document, tag: K, className?: string, style?: CssStyleMap): HTMLElementTagNameMap[K];
+export declare function createEl<K extends keyof HTMLElementTagNameMap>(doc: Document, tag: K, className?: string, style?: CssStyleMap): HTMLElementTagNameMap[K];
 /** Create a namespaced SVG element with optional attributes. */
-declare function createSvgEl<K extends keyof SVGElementTagNameMap>(doc: Document, tag: K, attrs?: Record<string, string | number | undefined>): SVGElementTagNameMap[K];
+export declare function createSvgEl<K extends keyof SVGElementTagNameMap>(doc: Document, tag: K, attrs?: Record<string, string | number | undefined>): SVGElementTagNameMap[K];
 //#endregion
 //#region src/viewer/render/slide-stage.d.ts
 interface SlideStageOptions {
@@ -12607,7 +12830,7 @@ interface SlideStageOptions {
  * unscaled canvas size, so the caller should wrap it in a box sized to
  * `canvasSize * scale` (the viewer's stage host and thumbnails both do).
  */
-declare function renderSlideStage(options: SlideStageOptions): HTMLElement;
+export declare function renderSlideStage(options: SlideStageOptions): HTMLElement;
 //#endregion
 //#region src/viewer/render/elements/index.d.ts
 /**
@@ -12618,7 +12841,7 @@ declare function renderSlideStage(options: SlideStageOptions): HTMLElement;
  * `contentPart`, `zoom`, and `model3d`. Only unknown extension elements fall
  * through to the typed placeholder fallback.
  */
-declare function createDefaultRegistry(): ElementRendererRegistry;
+export declare function createDefaultRegistry(): ElementRendererRegistry;
 //#endregion
 //#region src/viewer/state/viewer-state.d.ts
 /** Why the last password attempt failed; see `checkModifyPassword` (`pptx-viewer-shared`). */
@@ -12897,7 +13120,7 @@ interface ViewerState {
    */
   compatToasts: CompatibilityWarningToast[];
 }
-declare function createInitialViewerState(): ViewerState;
+export declare function createInitialViewerState(): ViewerState;
 //#endregion
 //#region src/viewer/editor/editor-animation-actions.d.ts
 /**
@@ -12956,6 +13179,8 @@ interface AnimationActions {
     dataUrl: string;
     fileName?: string;
   } | undefined): void;
+  /** Stage one of PowerPoint's 19 built-in stock sounds by catalogue id. */
+  setAnimationStockSound(elementId: string, catalogueId: string): void;
   reorderAnimation(elementId: string, direction: 'up' | 'down'): void;
   moveAnimation(elementId: string, index: number): void;
 }
@@ -13169,6 +13394,8 @@ interface InspectorActions {
   setTitle(text: string): void;
   /** Set the selected OLE element's Object Name (`p:oleObj/@name`). */
   setOleName(name: string): void;
+  /** Patch an in-place OLE content edit (see `InspectorHandlers.setOleContent`). */
+  setOleContent(patch: Partial<OlePptxElement>): void;
   setChartData(data: PptxChartData): void;
   setMediaProperties(patch: Partial<MediaPptxElement>): void;
   setTableHeaderRow(enabled: boolean): void;
@@ -13437,6 +13664,12 @@ interface InspectorState {
   oleIsLinked: boolean;
   /** The OLE object's author-assigned name (`p:oleObj/@name`), if any. */
   oleName: string | undefined;
+  /**
+   * The full selected OLE element, feeding the "Edit content" dialog (which
+   * needs `oleEmbeddedData`/`oleFileExtension`/`oleShowAsIcon` etc., not just
+   * the flattened fields above). `undefined` when the selection isn't OLE.
+   */
+  oleElement: OlePptxElement | undefined;
   x: number;
   y: number;
   width: number;
@@ -13725,6 +13958,7 @@ interface RibbonFileHandlers {
   save(): void;
   saveAsPpsx(): void;
   saveAsPptm(): void;
+  saveAsPpt(): void;
   exportPng(): void;
   copySlideAsImage(): void;
   exportPdf(): void;
@@ -14046,7 +14280,7 @@ interface Ribbon {
  * never called, and a hidden button/cluster inside a tab is never built by
  * that tab's own module (see `ribbon-types.ts` handlers vs. this file).
  */
-declare function createRibbon(doc: Document, t: Translator, handlers: RibbonHandlers, hiddenActions?: readonly ToolbarActionId[], accountAuth?: AccountAuthConfig): Ribbon;
+export declare function createRibbon(doc: Document, t: Translator, handlers: RibbonHandlers, hiddenActions?: readonly ToolbarActionId[], accountAuth?: AccountAuthConfig): Ribbon;
 //#endregion
 //#region src/viewer/ui/shortcut-panel.d.ts
 interface ShortcutPanel {
@@ -14589,7 +14823,7 @@ interface PptxAiBridge {
  * module is that dictionary for the demos, shared so all three stay in sync
  * instead of drifting into three separate copies.
  */
-declare const translationsEn: Record<string, string>;
+export declare const translationsEn: Record<string, string>;
 /**
  * Every key in the English dictionary. A new locale dictionary typed as
  * `Record<TranslationKey, string>` gets a compile error for any key it's
@@ -14602,7 +14836,7 @@ type TranslationKey = keyof typeof translationsEn;
  * explicit dictionary entry exists yet. Takes the last segment and converts
  * camelCase to Title Case, e.g. "pptx.slideSorter.zoomIn" -> "Zoom In".
  */
-declare function keyToLabel(key: string): string;
+export declare function keyToLabel(key: string): string;
 //#endregion
 //#region src/i18n/locale-catalog.d.ts
 /** One selectable entry in the viewer chrome's built-in language picker (File > Options > Language). */
@@ -14765,9 +14999,9 @@ interface ExportPdfOptions {
 //#endregion
 //#region src/viewer/export/export-svg.d.ts
 /** Export one parsed slide as resolution-independent SVG markup. */
-declare function exportSlideToSvg(slide: PptxSlide, width: number, height: number, options?: SvgExportOptions): string;
+export declare function exportSlideToSvg(slide: PptxSlide, width: number, height: number, options?: SvgExportOptions): string;
 /** Export the selected slides in a parsed presentation as SVG markup. */
-declare function exportAllSlidesToSvg(data: PptxData, options?: SvgExportOptions): string[];
+export declare function exportAllSlidesToSvg(data: PptxData, options?: SvgExportOptions): string[];
 //#endregion
 //#region src/viewer/export/render-to-canvas.d.ts
 /**
@@ -14781,7 +15015,7 @@ declare function exportAllSlidesToSvg(data: PptxData, options?: SvgExportOptions
  * per-binding. `html2canvas-pro` is imported dynamically so it stays out of
  * the main bundle until export is actually used.
  */
-declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
+export declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 //#endregion
 //#region src/viewer/load/source.d.ts
 /**
@@ -15384,7 +15618,7 @@ declare abstract class ViewerExportHost implements ViewerExportApi {
  * builds chrome inside `container`, loads `options.source` when given, and
  * re-renders through a tiny reactive store.
  */
-declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance, ChromeHost {
+export declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance, ChromeHost {
   readonly container: HTMLElement;
   readonly doc: Document;
   readonly options: PptxViewerOptions;
@@ -15780,11 +16014,11 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   private remountChrome;
 }
 /** Create a PowerPoint viewer inside `container` (see {@link PptxViewerOptions}). */
-declare function createPptxViewer(container: HTMLElement, options?: PptxViewerOptions): PptxViewerInstance;
+export declare function createPptxViewer(container: HTMLElement, options?: PptxViewerOptions): PptxViewerInstance;
 //#endregion
 //#region src/viewer/styles/inject.d.ts
 /** The complete viewer stylesheet text (for hosts that self-manage CSS). */
-declare function getViewerCss(): string;
+export declare function getViewerCss(): string;
 //#endregion
-export { type AccountAuthConfig, type AutosaveRecord, type AutosaveStatus, type CollaborationConfig, type CollaborationRole, type CollaborationTransport, type ConnectionStatus, type CssStyleMap, type EditActions, type ElementRenderContext, type ElementRenderer, type ElementRendererRegistry, type ExportGifOptions, type ExportPdfOptions, type ExportProgress, type ExportVideoOptions, type FindReplaceActions, type OpenPrintWindow, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, type PptxAiBridge, type PptxAiConfig, type PptxAiConnection, type PptxAiContextStrategy, type PptxAiToolName, type PptxAiWritePolicy, type PptxElement, type PptxElementType, type PptxHandler, type PptxSlide, PptxViewer, type PptxViewerCallbacks, type PptxViewerInstance, type PptxViewerOptions, type PptxViewerSource, type PrintOptions, type Ribbon, type RibbonDesignHandlers, type RibbonDrawHandlers, type RibbonDrawState, type RibbonEditState, type RibbonFileHandlers, type RibbonHandlers, type RibbonInsertHandlers, type RibbonNavHandlers, type RibbonNavState, type RibbonPrimaryHandlers, type RibbonSelectionState, type RibbonSlideShowHandlers, type RibbonTabId, type SavedPresentationFormat, type SessionDeck, type SlideStageOptions, type Store, type SvgExportOptions, type ToolbarActionId, type TranslationKey, type TranslationMessages, type Translator, type ViewerState, type ViewerTheme, type ViewerThemeColors, type ZoomLevel, applyStyleMap, createDefaultRegistry, createEl, createElementRendererRegistry, createInitialViewerState, createPptxViewer, createRibbon, createStore, createSvgEl, createTranslator, defaultCssVars, defaultRadius, defaultThemeColors, exportAllSlidesToSvg, exportSlideToSvg, forgetSessionDeck, getSessionTabId, getViewerCss, isLegacyBinaryPresentation, isSupportedPresentationFile, keyToLabel, loadPresentationDeck, loadSessionDeck, parsePresentationSessionId, presentationBaseName, rememberSessionDeck, renderSlideStage, renderToCanvas, restoreSessionDeck, savedPresentationFileName, themeToCssVars, translationsEn, vermilionDarkTheme, vermilionLightTheme };
+export { type AccountAuthConfig, type AutosaveRecord, type AutosaveStatus, type CollaborationConfig, type CollaborationRole, type CollaborationTransport, type ConnectionStatus, type CssStyleMap, type EditActions, type ElementRenderContext, type ElementRenderer, type ElementRendererRegistry, type ExportGifOptions, type ExportPdfOptions, type ExportProgress, type ExportVideoOptions, type FindReplaceActions, type OpenPrintWindow, type PptxAiBridge, type PptxAiConfig, type PptxAiConnection, type PptxAiContextStrategy, type PptxAiToolName, type PptxAiWritePolicy, type PptxElement, type PptxElementType, type PptxHandler, type PptxSlide, type PptxViewerCallbacks, type PptxViewerInstance, type PptxViewerOptions, type PptxViewerSource, type PrintOptions, type Ribbon, type RibbonDesignHandlers, type RibbonDrawHandlers, type RibbonDrawState, type RibbonEditState, type RibbonFileHandlers, type RibbonHandlers, type RibbonInsertHandlers, type RibbonNavHandlers, type RibbonNavState, type RibbonPrimaryHandlers, type RibbonSelectionState, type RibbonSlideShowHandlers, type RibbonTabId, type SavedPresentationFormat, type SessionDeck, type SlideStageOptions, type Store, type SvgExportOptions, type ToolbarActionId, type TranslationKey, type TranslationMessages, type Translator, type ViewerState, type ViewerTheme, type ViewerThemeColors, type ZoomLevel, defaultCssVars, defaultRadius, defaultThemeColors, themeToCssVars, vermilionDarkTheme, vermilionLightTheme };
 //# sourceMappingURL=index.d.ts.map