pptx-svelte-viewer 3.3.0 → 3.5.0

package/dist/viewer/index.d.ts

@@ -10161,6 +10161,11 @@ interface SlideTemplateBuildOptions {
    */
   translate?: (key: string) => string;
 }
+/** A user-placed alignment guide: `axis: 'v'` is a vertical line at x=`position`. */
+interface SnapGuideInput {
+  axis: 'h' | 'v';
+  position: number;
+}
 /** A snap alignment line: `axis: 'v'` is a vertical line at x=`position`. */
 interface SnapLine {
   axis: 'h' | 'v';
@@ -10547,6 +10552,14 @@ interface PresentationInkStroke {
   points: PresentationInkPoint[];
 }
 //#endregion
+//#region src/render/alignment-guides.d.ts
+/** A single alignment guide, positioned in authored slide pixels. */
+interface Guide {
+  id: string;
+  axis: 'h' | 'v';
+  position: number;
+}
+//#endregion
 //#region src/render/find-replace.d.ts
 /** Identifies a single match of the find query at segment-level precision. */
 interface FindResult {
@@ -10707,6 +10720,19 @@ interface AutosaveRecoveryPrompt {
   readonly restoreKey: string;
   readonly discardKey: string;
 }
+//#endregion
+//#region src/render/master-view-crud.d.ts
+/** One Slide Master view sidebar command. */
+type MasterViewCrudActionId = 'addLayout' | 'duplicateLayout' | 'deleteLayout' | 'renameLayout' | 'addMaster' | 'duplicateMaster' | 'deleteMaster' | 'renameMaster';
+/** A framework-neutral descriptor for one sidebar button. */
+interface MasterViewCrudAction {
+  id: MasterViewCrudActionId;
+  /** i18n key for the button label (`pptx.masterView.<id>`). */
+  labelKey: string;
+  enabled: boolean;
+  /** i18n key explaining why the button is disabled, set only when it is. */
+  disabledReasonKey?: string;
+}
 /**
  * Why the deck is being serialised, which is a separate question from whether
  * the user protected it.
@@ -10785,6 +10811,28 @@ interface ViewerPreferences {
   snapToGrid: boolean;
   reducedMotion: boolean;
 }
+/**
+ * Viewer preferences plus the `ppt/viewProps.xml` fields the round-trip in
+ * {@link viewerPreferencesFromViewProperties} seeds from the deck itself. All
+ * optional, so a plain {@link ViewerPreferences} is assignable.
+ */
+interface DeckViewPreferences extends ViewerPreferences {
+  /** `p:viewPr/p:slideViewPr/p:cSldViewPr/@snapToObjects`. */
+  snapToObjects?: boolean;
+  /** `p:viewPr/p:slideViewPr/p:cSldViewPr/@showGuides`. */
+  showGuides?: boolean;
+  /** `p:viewPr/p:gridSpacing/@cx`, in positive DrawingML (EMU) units. */
+  gridSpacingCx?: number;
+  /** `p:viewPr/p:gridSpacing/@cy`, in positive DrawingML (EMU) units. */
+  gridSpacingCy?: number;
+}
+/** A `p:showPr/p:sldRg` custom range, resolved to 0-based deck indexes. */
+interface AuthoredSlideRange {
+  /** First slide of the range, 0-based, inclusive. */
+  readonly fromIndex: number;
+  /** Last slide of the range, 0-based, inclusive. */
+  readonly toIndex: number;
+}
 /**
  * Optional hook point for hosts that want to wire a real sign-in flow into
  * File > Account. Disabled by default: the Account page renders nothing
@@ -11024,6 +11072,44 @@ interface ViewerOptionsStoreInit {
   /** Skip localStorage entirely (hosts that own persistence themselves). */
   persist?: boolean;
 }
+//#endregion
+//#region src/render/editor-mutations.d.ts
+/**
+ * Pure, immutable slide-array mutations for the editor.
+ *
+ * Extracted from the Vanilla binding's `editor/editor-mutations` (the superset
+ * of the byte-for-byte-equivalent Svelte copy; Vue's `useEditorOperations`
+ * commit helpers do the same array math inline, reactivity mixed in). Every
+ * function takes the current `PptxSlide[]` and returns a brand-new array
+ * (untouched slides are reused by reference so the render layer can cheaply
+ * detect changes). All cloning defers to the core helpers (`cloneSlide`,
+ * `cloneElement`, `duplicateElement`); nothing is mutated in place.
+ */
+/** Geometry patch applied by drag / resize / rotate / nudge. */
+interface ElementBoxPatch {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  rotation: number;
+}
+type ReadOnlyRecommendationKind = 'modifyVerifier' | 'markedFinal' | null;
+interface ReadOnlyRecommendation {
+  readonly kind: ReadOnlyRecommendationKind;
+  /** i18n key for the banner/toast a binding shows for this recommendation. */
+  readonly messageKey: string;
+  /** Whether a binding's "read-only" toggle should default to on. */
+  readonly defaultReadOnly: boolean;
+}
+interface CompatibilityWarningToast {
+  /** Stable per-code id, since toasts are deduped by code (see module docs). */
+  readonly id: string;
+  readonly code: string;
+  readonly severity: 'info' | 'warning';
+  readonly messageKey: string;
+  /** `{{code}}` for the generic fallback key; `undefined` for a mapped code. */
+  readonly params?: Readonly<Record<string, string>>;
+}
 
 //#endregion
 //#region src/ai/change-diff.d.ts
@@ -11283,6 +11369,13 @@ interface PptxAiBridge {
   /** Surface a transient message in the host UI (toast / status line). */
   notify?(message: string, level?: PptxAiNotifyLevel): void;
 }
+/** One element ring to draw on the canvas: an explicit pick or a live-tool focus. */
+interface AiCanvasHighlight {
+  slideIndex: number;
+  elementId: string;
+  /** `pick` = persistent user pick; `active` = transient AI-is-working ring. */
+  variant: 'pick' | 'active';
+}
 //#endregion
 //#region src/ai/tool-target.d.ts
 /**
@@ -11883,6 +11976,8 @@ interface SlideCanvasProps {
     editTemplateMode?: boolean;
     /** Forwarded to `SlideStage`; see `SlideStageProps.editingElementId`. */
     editingElementId?: string | null;
+    /** Forwarded to `SlideStage`; see `SlideStageProps.selectedElementIds`. */
+    selectedElementIds?: readonly string[];
     ontablecellcommit?: (elementId: string, rowIndex: number, cellIndex: number, text: string) => void;
     onsmartartnodecommit?: (elementId: string, nodeId: string, text: string) => void;
     onsmartartnodefill?: (elementId: string, nodeId: string, fill: string) => void;
@@ -12280,25 +12375,6 @@ type LoadDocumentArgs = [
     customShows?: PptxCustomShow[]
 ];
 
-/**
- * Pure, immutable slide-array mutations for the Svelte editor.
- *
- * Mirrors the vanilla binding's `editor-mutations` (in turn the Vue binding's
- * `useEditorOperations` commit helpers), minus the reactivity: every function
- * takes the current `PptxSlide[]` and returns a brand-new array (untouched
- * slides are reused by reference so the render layer can cheaply detect
- * changes). All cloning defers to the core helpers (`cloneSlide`,
- * `cloneElement`, `duplicateElement`); nothing is mutated in place.
- */
-/** Geometry patch applied by drag / resize / rotate / nudge. */
-interface ElementBoxPatch {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    rotation: number;
-}
-
 /**
  * Z-order (paint-order) reordering for the Svelte editor.
  *
@@ -12306,8 +12382,8 @@ interface ElementBoxPatch {
  * `sendBackward`) are the shared, framework-agnostic operations from
  * `pptx-viewer-shared` (`render/element-operations`), where array index 0 is
  * the back and the last index is the front. This module only lifts them to the
- * slide-array shape the editor state stores, reusing the same immutable
- * `mapSlideElements` helper as the other mutations.
+ * slide-array shape the editor state stores, reusing the shared
+ * `reorderElementOnSlide` helper as the other mutations do.
  */
 /** Which way to move the selected element through the paint-order stack. */
 type ZOrderDirection = 'front' | 'back' | 'forward' | 'backward';
@@ -12467,6 +12543,28 @@ declare class EditorMasterController {
     setBackgroundColor(backgroundColor: string): void;
 }
 
+interface MasterViewCrudPrompts {
+    /** Ask for the new layout/master name; null/empty cancels the rename. */
+    promptName(currentName: string): string | null;
+    /** Surface a rejection (`notFound` / `inUse` / `lastMaster`) as translated copy. */
+    notify(message: string): void;
+    translate(key: string): string;
+}
+/** Drives the sidebar's Insert/Duplicate/Delete/Rename commands on {@link EditorState}. */
+declare class EditorMasterCrudController {
+    private readonly editor;
+    constructor(editor: EditorState);
+    /** The sidebar's action list (enabled/disabled + reason) for the current target. */
+    actions(): MasterViewCrudAction[];
+    /**
+     * Run one command against the CURRENT master-view target. A no-op outside
+     * master view, on a read-only deck, or when the action is disabled for the
+     * target (mirrors the sidebar's own gating, so a stray call through the
+     * public API cannot bypass it).
+     */
+    run(id: MasterViewCrudActionId, prompts: MasterViewCrudPrompts): Promise<boolean>;
+}
+
 interface PresentationMetadataHost {
     readonly editable: boolean;
     pushHistory(): void;
@@ -12492,6 +12590,13 @@ declare class EditorPresentationMetadata {
     private static clone;
     set(headerFooter?: PptxHeaderFooter, presentationProperties?: PptxPresentationProperties, customShows?: PptxCustomShow[]): void;
     updatePresentationProperties(next: PptxPresentationProperties): void;
+    /**
+     * Fold a picker's recent-colours list into `presentationProperties.mruColors`
+     * WITHOUT pushing undo history (wave-4 B6): PowerPoint's colour-picker MRU
+     * is not an undoable edit, mirroring how `editor.viewProperties` writes back
+     * the View > Grid/Guides/Snap toggles outside `pushHistory`/`commitChange`.
+     */
+    setMruColorsSilently(mruColors: readonly string[]): void;
     updateHeaderFooter(next: PptxHeaderFooter): void;
     updateCustomShows(next: PptxCustomShow[]): void;
     private commit;
@@ -12707,6 +12812,13 @@ interface EditorStateDeps {
      * case core re-emits the load-time dimensions verbatim.
      */
     getSlideSize?: () => PptxSlideSize | undefined;
+    /**
+     * Adopt a fresh handler in place of the loaded one. Master-view CRUD
+     * (`masterCrud`) rebuilds the package through core and comes back with a
+     * new `PptxHandler`; the loader owns handler lifecycle, so it disposes the
+     * previous one here. Optional for out-of-tree mounts and the unit tests.
+     */
+    setHandler?: (handler: PptxHandler) => void;
     onChange?: () => void;
 }
 declare class EditorState {
@@ -12740,6 +12852,28 @@ declare class EditorState {
      * undo stack owns.
      */
     theme: PptxTheme | undefined;
+    /**
+     * `ppt/viewProps.xml`, seeded from the load and kept in sync with the View >
+     * Grid/Guides/Snap toggles (wave 4 #5: `viewPropertiesPatchFromPreferences`
+     * writes the toggle state back in here). Deliberately outside
+     * {@link EditorSnapshot}, like {@link theme}: PowerPoint does not undo a view
+     * toggle, so this is session state that `saveEditorDocument` reads directly,
+     * never something `pushHistory`/`commitChange` touches.
+     */
+    viewProperties: PptxViewProperties | undefined;
+    /**
+     * Modern comment authors (`ppt/authors.xml`, Office 2021 `p188:author`),
+     * seeded from the load. Read-only round-trip metadata, like {@link theme}:
+     * the comment panel's @-mention typeahead (wave-4 B5) reads this to match
+     * against, never something a binding edits or that undo restores.
+     */
+    modernCommentAuthors: PptxModernCommentAuthor[];
+    /**
+     * Legacy comment authors (`ppt/commentAuthors.xml`), offered to the
+     * @-mention typeahead alongside {@link modernCommentAuthors}. Same
+     * read-only, non-undo lifecycle.
+     */
+    commentAuthors: PptxCommentAuthor[];
     /**
      * Families the deck embeds, offered as their own font-dropdown group. Write
      * through {@link adoptEmbeddedFontFamilies} so {@link embedFonts} is reseeded
@@ -12806,6 +12940,7 @@ declare class EditorState {
     readonly animationOps: EditorAnimationController;
     readonly inkOps: EditorInkController;
     readonly masterOps: EditorMasterController;
+    readonly masterCrud: EditorMasterCrudController;
     readonly formatPainter: EditorFormatPainterController;
     readonly equationOps: EditorEquationController;
     constructor(deps: EditorStateDeps);
@@ -12813,6 +12948,15 @@ declare class EditorState {
     get headerFooter(): PptxHeaderFooter;
     get presentationProperties(): PptxPresentationProperties;
     get customShows(): PptxCustomShow[];
+    /** The colour picker's "Recent colours" row (`p:clrMru`), most-recent-first. */
+    get mruColors(): string[];
+    /**
+     * Record a colour just picked in ANY colour picker (fill, line, text,
+     * background, table cell, chart series, ...) into the recent-colours row
+     * (wave-4 B6). Writes `presentationProperties.mruColors` OUTSIDE the undo
+     * stack, like the view-preferences write-back.
+     */
+    recordRecentColor(hex: string): void;
     get canRedo(): boolean;
     get selectedElementId(): string | null;
     get selectedElement(): PptxElement | undefined;
@@ -12824,6 +12968,8 @@ declare class EditorState {
     /** The loaded core handler, or null before a deck is open. Used by the
      *  Slides group for layout switching (`applyLayoutToSlide`). */
     getHandler(): PptxHandler | null;
+    /** Hand a rebuilt handler to the loader (see `EditorStateDeps.setHandler`). */
+    adoptHandler(handler: PptxHandler): void;
     /**
      * The `p:sldSz` the next save should write, or undefined to leave the
      * load-time dimensions alone. Slide size lives on the loader (it is not
@@ -12970,10 +13116,7 @@ interface EditorControllerDeps {
      */
     getGridSize?(): number;
     getSnapToShape?(): boolean;
-    getGuides?(): readonly {
-        axis: 'h' | 'v';
-        position: number;
-    }[];
+    getGuides?(): readonly SnapGuideInput[];
     /**
      * Transform inline-editor text at commit time (File > Options > Proofing
      * AutoCorrect); identity when unset.
@@ -13403,7 +13546,20 @@ declare class PresentationLoader {
      * `p:presentationPr`.
      */
     viewProperties: PptxViewProperties | undefined;
+    /** Write-protection verifier from `p:modifyVerifier` (`presentation.xml`). */
+    modifyVerifier: PptxModifyVerifier | undefined;
+    /**
+     * Every compatibility warning the load (and any save/patch so far this
+     * session) has raised, from `handler.getCompatibilityWarnings()`: unmodelled
+     * markup round-tripped only via `rawXml`, an external image reference that
+     * cannot be embedded, and so on. Feeds the compat-toast stack (wave 4 #3).
+     */
+    compatibilityWarnings: PptxCompatibilityWarning[];
     customShows: PptxCustomShow[];
+    /** Modern comment authors (`ppt/authors.xml`, Office 2021 `p188:author`), for the @-mention typeahead (wave-4 B5). */
+    modernCommentAuthors: PptxModernCommentAuthor[];
+    /** Legacy comment authors (`ppt/commentAuthors.xml`), round-tripped and offered to the typeahead alongside the modern list. */
+    commentAuthors: PptxCommentAuthor[];
     coreProperties: PptxCoreProperties | undefined;
     appProperties: PptxAppProperties | undefined;
     customProperties: PptxCustomProperty[];
@@ -13467,6 +13623,12 @@ declare class PresentationLoader {
     getLoadOptions: () => Pick<PptxHandlerLoadOptions, 'allowExternalImages'>;
     /** Parse a `.pptx` buffer into reactive viewer state. */
     load(raw: Uint8Array | ArrayBuffer, origin?: CollabLoadOrigin): Promise<void>;
+    /**
+     * Replace the live handler with one core rebuilt (master-view CRUD returns
+     * a fresh package rather than a patch). Disposes the previous handler; the
+     * Blob URLs stay valid because the media parts are unchanged.
+     */
+    adoptHandler(next: PptxHandler): void;
     /** Cancel in-flight loads, revoke Blob URLs, dispose the handler. */
     dispose(): void;
 }
@@ -13683,8 +13845,9 @@ interface EditingApi {
  *
  * The class owns the reactive per-element state map, the keyframes CSS, and the
  * interactive / hover trigger-shape id sets; the controller stays pure. The
- * clock (timers, requestAnimationFrame) + DOM effects live in
- * {@link module:presentation/animation-playback-helpers}.
+ * clock (timers, requestAnimationFrame) + DOM effects live in the shared
+ * {@link module:render/animation-playback-engine}, wired here with the local
+ * `./animation-sound` player.
  *
  * NOTE: the editor / inspector animation PREVIEW still uses the older shared
  * `buildClickGroups` model (see `AnimationsTab` / `editor-animation-controller`);
@@ -13788,6 +13951,14 @@ interface PresentationControllerDeps {
     exit?(): void;
     /** `p:showPr` "end with black slide"; defaults to on, like PowerPoint. */
     getEndWithBlackSlide?(): boolean | undefined;
+    /**
+     * Slide Show > Set Up Show > "Loop continuously until 'Esc'"
+     * (`p:presentationPr/@loopContinuously`), or the implicit loop of a kiosk
+     * (`showType === 'kiosk'`) show. When true, advancing past the last slide
+     * wraps to the show's first slide instead of raising the black end screen
+     * or exiting.
+     */
+    getLoopContinuously?(): boolean | undefined;
     /**
      * Membership of the custom show the user selected, or null/undefined for the
      * whole deck. Restricts and reorders the show; hiding still wins over it.
@@ -13802,6 +13973,24 @@ interface PresentationControllerDeps {
      * omitted opens unconditionally.
      */
     confirmUrl?(url: string): boolean;
+    /**
+     * The `p:showPr/p:sldRg` authored slide-range restriction (deck opens into
+     * slides `fromIndex..toIndex` rather than the whole deck), when no custom
+     * show is active. `resolveShowSlideIndexes` applies hiding and the active
+     * custom show first, same as `getActiveCustomShow`; this is the third,
+     * lowest-precedence restriction.
+     */
+    getAuthoredRange?(): AuthoredSlideRange | null | undefined;
+    /**
+     * The deck's custom shows, for `ppaction://customshow?id=<id>` (wave-4
+     * B7): the runner resolves `id` against this list to find the show's
+     * membership.
+     */
+    getCustomShows?(): readonly PptxCustomShow[];
+    /** Current active custom show id (or null for the whole deck), read back by `returnAfter`. */
+    getActiveCustomShowId?(): string | null;
+    /** Switch the active custom show (mirrors {@link getActiveCustomShow}'s source of truth). */
+    setActiveCustomShowId?(id: string | null): void;
 }
 declare class PresentationController {
     #private;
@@ -13853,6 +14042,17 @@ declare class PresentationController {
      * wraps a backward press off the first slide.
      */
     previousSlide(): void;
+    /**
+     * The deck index the show should OPEN on when entered from `activeIndex`
+     * (wave-4 B1): `activeIndex` itself when the show includes it ("From
+     * Current Slide"), otherwise the nearest show slide, per
+     * `presentationEntrySlideIndex`. Every entry point (status-bar button,
+     * ribbon From Current Slide, `setMode('present')`, the mobile toolbar) must
+     * seed the presentation index with this instead of the raw active slide, or
+     * a deck authored with a `p:showPr/p:sldRg` range (or a custom show that
+     * excludes the active slide) opens on a slide the show does not include.
+     */
+    entryIndex(activeIndex: number): number;
     /** Home: the show's first slide, which is not slide 1 when that one is hidden. */
     firstSlide(): void;
     /** End: the show's last slide, skipping trailing hidden slides. */
@@ -13966,13 +14166,32 @@ declare class AutosaveRecoveryController {
     dismiss(): void;
 }
 
-/** One element ring to draw on the canvas: an explicit pick or a live-tool focus. */
-interface AiCanvasHighlight {
-    slideIndex: number;
-    elementId: string;
-    /** `pick` = persistent user pick; `active` = transient AI-is-working ring. */
-    variant: 'pick' | 'active';
+/**
+ * CompatToastsState: the fidelity-loss toast stack shown after a load whose
+ * parse reported `PptxCompatibilityWarning`s (unmodelled markup, external
+ * image references, a chart workbook that could not be written back, and so
+ * on). Svelte port of Vue's `useCompatibilityToasts` composable.
+ *
+ * Toasts do not auto-hide (they are load diagnostics, not transient
+ * notices): they persist until dismissed, and `reset()` clears them for a
+ * newly loaded document, called from the same load-commit hook that resets
+ * the read-only recommendation.
+ */
+declare class CompatToastsState {
+    #private;
+    constructor(deps: {
+        getWarnings(): readonly PptxCompatibilityWarning[];
+    });
+    /** Every toast this load produced, dismissed ones excluded, capped at the visible limit. */
+    get visibleToasts(): CompatibilityWarningToast[];
+    /** How many more toasts exist beyond the visible limit. */
+    get overflowCount(): number;
+    dismiss(id: string): void;
+    dismissAll(): void;
+    /** Clear the dismissal state for a newly loaded document. */
+    reset(): void;
 }
+
 /** Live viewer accessors + the panel-open hook the controller closes over. */
 interface AiPanelControllerDeps {
     getActiveSlideIndex(): number;
@@ -14052,6 +14271,38 @@ interface AiCluster {
     readonly canvasHighlights: readonly AiCanvasHighlight[];
 }
 
+/**
+ * ReadOnlyRecommendationState: the Trust-Center-style banner shown when a
+ * loaded deck asks to be opened read-only (`p:modifyVerifier`, or `docProps/
+ * custom.xml`'s "Mark as Final"), and the lock that goes with it. Svelte port
+ * of Vue's `useReadOnlyRecommendation` composable.
+ *
+ * `locked` is meant to be ANDed into the SAME `getEditable` gate the viewer
+ * already reads (Protected View, collaboration read-only), not a second
+ * editability mechanism. `reset()` is called from the load-commit hook
+ * (`onContentApplied`) so a newly opened document is evaluated fresh even if
+ * a previous one was unlocked.
+ */
+declare class ReadOnlyRecommendationState {
+    #private;
+    constructor(deps: {
+        getModifyVerifier(): PptxModifyVerifier | undefined;
+        getCustomProperties(): PptxCustomProperty[];
+    });
+    /** The current recommendation (`kind: null` when the deck asks for nothing). */
+    get recommendation(): ReadOnlyRecommendation;
+    /** Whether the banner should render. */
+    get showBanner(): boolean;
+    /** Whether editing should currently be blocked because of this recommendation. */
+    get locked(): boolean;
+    /** "Edit anyway": lifts the lock and hides the banner for this document. */
+    editAnyway(): void;
+    /** "Dismiss": hides the banner but leaves the lock (if any) in place. */
+    dismiss(): void;
+    /** Re-arm the recommendation for a newly loaded document. */
+    reset(): void;
+}
+
 /**
  * ViewerOptionsState: the runes wrapper around the shared File > Options
  * store. Owns the reactive `options` snapshot (updated via the store's
@@ -14281,16 +14532,28 @@ declare class ViewerParityUiState {
     readingViewOpen: boolean;
     /** View tab > Outline View: the deck as one editable indented text document. */
     outlineViewOpen: boolean;
+    /** View > H/V Guides. Also seeded from the deck's `slideViewPr/@showGuides`. */
     showGuides: boolean;
+    /**
+     * "Snap to shape" (View ▸ Snap Objects to Other Objects): the on-drag
+     * alignment-guide snap. Also seeded from the deck's
+     * `slideViewPr/@snapToObjects` (shared's `DeckViewPreferences.snapToObjects`
+     * field; this binding's own historical name for the same toggle).
+     */
     snapToShape: boolean;
-    guides: {
-        axis: "h" | "v";
-        position: number;
-    }[];
-    preferences: ViewerPreferences;
+    guides: Guide[];
+    /**
+     * Also carries the deck-authored `snapToObjects`/`showGuides`/
+     * `gridSpacingCx`/`gridSpacingCy` fields (`DeckViewPreferences`, a superset
+     * of the base `ViewerPreferences` toggles), even though `showGuides` and
+     * `snapToShape` above are the fields this binding actually reads: keeping
+     * them here too is what lets `viewerPreferencesFromViewProperties` seed (and
+     * `viewPropertiesPatchFromPreferences` later read back) a single object.
+     */
+    preferences: DeckViewPreferences;
     constructor(editor: EditorState);
     syncAutosave(enabled: boolean): void;
-    updatePreferences(next: ViewerPreferences, onAutosaveChange: (enabled: boolean) => void): void;
+    updatePreferences(next: DeckViewPreferences, onAutosaveChange: (enabled: boolean) => void): void;
 }
 
 /**
@@ -14375,6 +14638,14 @@ interface ViewerStateBag {
     readonly editor: EditorState;
     readonly controller: EditorController;
     readonly parityUi: ViewerParityUiState;
+    /**
+     * The deck's own `p:modifyVerifier` / "Mark as Final" read-only
+     * recommendation and lock (wave 4 #2), mirroring the Protected View banner
+     * mechanism rather than inventing a second one.
+     */
+    readonly readOnlyRec: ReadOnlyRecommendationState;
+    /** Fidelity-loss toast stack (wave 4 #3), fed by `loader.compatibilityWarnings`. */
+    readonly compatToasts: CompatToastsState;
     readonly chromeUi: ChromeUiState;
     readonly findReplace: FindReplaceState;
     readonly collab: CollaborationController;

package/dist/viewer/index.js

@@ -1,22 +1,22 @@
-import { A as e, M as a, _ as s, c as t, d as i, f as l, gt as S, ht as n, i as v, j as o, l as d, n as p, o as b, p as g, r as c, s as x, t as w, u as T } from "../export-CL58Fm_4.js";
-var m = a, A = o, P = e;
+import { A as e, M as a, c as s, d as t, f as i, gt as l, ht as S, i as n, j as o, l as v, m as d, n as p, o as b, p as g, r as c, s as x, t as m, u as w } from "../export-C0RzyaUT.js";
+var T = a, A = o, P = e;
 export {
-  w as PowerPointViewer,
-  v as PresentationLoader,
-  m as Ribbon,
+  m as PowerPointViewer,
+  n as PresentationLoader,
+  T as Ribbon,
   P as SlideCanvas,
   c as ViewerState,
   A as ViewerToolbar,
-  i as clampSlideIndex,
-  s as createSvelteAiBridge,
+  t as clampSlideIndex,
+  d as createSvelteAiBridge,
   p as createViewerState,
   b as exportAllSlidesToSvg,
   x as exportAllSlidesToSvgBlobs,
-  t as exportSlideAsSvg,
-  d as exportSlideToSvg,
-  T as exportSlideToSvgBlob,
-  l as fitScale,
+  s as exportSlideAsSvg,
+  v as exportSlideToSvg,
+  w as exportSlideToSvgBlob,
+  i as fitScale,
   g as resolveNavigationKey,
-  n as zoomInPercent,
-  S as zoomOutPercent
+  S as zoomInPercent,
+  l as zoomOutPercent
 };

package/dist/viewer/presentation/action-runner-callbacks.d.ts

@@ -0,0 +1,18 @@
+import { PresentationActionRunner } from 'pptx-viewer-shared';
+import { PresentationControllerDeps } from './presentation-controller.svelte';
+/** Set while a `ppaction://customshow?...&return=true` sub-show is running. */
+export interface CustomShowReturnState {
+    previousId: string | null;
+    originIndex: number;
+}
+/**
+ * Builds the wave-4 B7 half of `PresentationActionRunner` (`lastViewed`,
+ * `customShow`, `openFile`, `openPresentation`, `playMedia`, `oleVerb`):
+ * split out of `PresentationController.handleStageClick` to keep that file
+ * under the repo's file-size budget. Pure glue over `deps` plus the small bit
+ * of cross-click state (`getLastViewedIndex`, `getCustomShowReturn` /
+ * `setCustomShowReturn`) the controller owns, since a `return=true` sub-show
+ * has to be restored by a LATER `advance()` call, not by this click itself.
+ */
+export declare function buildWaveFourActionCallbacks(deps: PresentationControllerDeps, getLastViewedIndex: () => number | undefined, setCustomShowReturn: (next: CustomShowReturnState | null) => void): Pick<PresentationActionRunner, 'lastViewed' | 'customShow' | 'openFile' | 'openPresentation' | 'playMedia' | 'oleVerb'>;
+//# sourceMappingURL=action-runner-callbacks.d.ts.map

package/dist/viewer/presentation/action-runner-callbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-runner-callbacks.d.ts","sourceRoot":"","sources":["../../../src/viewer/presentation/action-runner-callbacks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAWnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,0BAA0B,EAChC,kBAAkB,EAAE,MAAM,MAAM,GAAG,SAAS,EAC5C,mBAAmB,EAAE,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,KAAK,IAAI,GAC/D,IAAI,CACN,wBAAwB,EACxB,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,kBAAkB,GAAG,WAAW,GAAG,SAAS,CACvF,CAoDA"}

package/dist/viewer/presentation/animation-playback.svelte.d.ts

@@ -15,8 +15,9 @@ import { ElementAnimationState } from 'pptx-viewer-shared';
  *
  * The class owns the reactive per-element state map, the keyframes CSS, and the
  * interactive / hover trigger-shape id sets; the controller stays pure. The
- * clock (timers, requestAnimationFrame) + DOM effects live in
- * {@link module:presentation/animation-playback-helpers}.
+ * clock (timers, requestAnimationFrame) + DOM effects live in the shared
+ * {@link module:render/animation-playback-engine}, wired here with the local
+ * `./animation-sound` player.
  *
  * NOTE: the editor / inspector animation PREVIEW still uses the older shared
  * `buildClickGroups` model (see `AnimationsTab` / `editor-animation-controller`);

package/dist/viewer/presentation/animation-playback.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation-playback.svelte.d.ts","sourceRoot":"","sources":["../../../src/viewer/presentation/animation-playback.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAShE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,qBAAqB;IACrC,oEAAoE;IACpE,QAAQ,IAAI,SAAS,GAAG,SAAS,CAAC;IAClC,wDAAwD;IACxD,oBAAoB,CAAC,IAAI,OAAO,GAAG,SAAS,CAAC;IAC7C,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;CACrC;AAED,qBAAa,iBAAiB;;gBAkBjB,IAAI,EAAE,qBAAqB;IAavC,+EAA+E;IAC/E,IAAI,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAEtD;IAED,+DAA+D;IAC/D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,uEAAuE;IACvE,IAAI,0BAA0B,IAAI,WAAW,CAAC,MAAM,CAAC,CAEpD;IAED,2DAA2D;IAC3D,IAAI,oBAAoB,IAAI,WAAW,CAAC,MAAM,CAAC,CAE9C;IAED,mEAAmE;IACnE,IAAI,UAAU,IAAI,OAAO,CAExB;IAUD,iEAAiE;IACjE,WAAW,IAAI,IAAI;IAcnB,2EAA2E;IAC3E,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAmD9C;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAclB,0EAA0E;IAC1E,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYrD,mEAAmE;IACnE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAkB1C,mEAAmE;IACnE,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAKrC"}
+{"version":3,"file":"animation-playback.svelte.d.ts","sourceRoot":"","sources":["../../../src/viewer/presentation/animation-playback.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAkB,qBAAqB,EAAmB,MAAM,oBAAoB,CAAC;AAUjG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,qBAAqB;IACrC,oEAAoE;IACpE,QAAQ,IAAI,SAAS,GAAG,SAAS,CAAC;IAClC,wDAAwD;IACxD,oBAAoB,CAAC,IAAI,OAAO,GAAG,SAAS,CAAC;IAC7C,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;CACrC;AAED,qBAAa,iBAAiB;;gBAkBjB,IAAI,EAAE,qBAAqB;IAevC,+EAA+E;IAC/E,IAAI,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAEtD;IAED,+DAA+D;IAC/D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,uEAAuE;IACvE,IAAI,0BAA0B,IAAI,WAAW,CAAC,MAAM,CAAC,CAEpD;IAED,2DAA2D;IAC3D,IAAI,oBAAoB,IAAI,WAAW,CAAC,MAAM,CAAC,CAE9C;IAED,mEAAmE;IACnE,IAAI,UAAU,IAAI,OAAO,CAExB;IAUD,iEAAiE;IACjE,WAAW,IAAI,IAAI;IAcnB,2EAA2E;IAC3E,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAmD9C;;;;OAIG;IACH,OAAO,IAAI,OAAO;IAclB,0EAA0E;IAC1E,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYrD,mEAAmE;IACnE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAkB1C,mEAAmE;IACnE,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAKrC"}