pptx-react-viewer 2.18.0 → 2.19.0

package/dist/{chunk-7XF6S4AM.mjs → chunk-ZMEYXAC6.mjs}

@@ -1,4 +1,4 @@
-import { ThemePresets, PptxMarkdownConverter } from './chunk-GODW6RNR.mjs';
+import { ThemePresets, PptxMarkdownConverter } from './chunk-XF3EOHY2.mjs';
 import { __export } from './chunk-XGB3TDIC.mjs';
 import * as mcp from 'pptx-viewer-mcp';
 import * as mcpSchemas from 'pptx-viewer-mcp/schemas';

package/dist/i18n.js

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

package/dist/i18n.mjs

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

package/dist/index.d.ts

@@ -203,11 +203,18 @@ interface XmlObject {
   [child: string]: XmlObject | XmlObject[] | string | undefined;
 }
 /**
- * Shape lock attributes from `p:cNvSpPr / a:spLocks`.
+ * Lock attributes from an element's non-visual properties node.
  *
  * When a flag is `true` the corresponding user interaction is disabled
  * in the editor (e.g. `noRotation` prevents free rotation of the shape).
  *
+ * One bag covers every family, but the families are NOT interchangeable in
+ * the file: `a:spLocks` (`CT_ShapeLocking`), `a:picLocks`, `a:cxnSpLocks`,
+ * `a:grpSpLocks` (`CT_GroupLocking`) and `a:graphicFrameLocks`
+ * (`CT_GraphicalObjectFrameLocking`) each declare their own attribute subset.
+ * `runtime/shape-lock-containers` holds that table and is what decides which
+ * of these fields may be written for a given element.
+ *
  * @example
  * ```ts
  * const locks: PptxShapeLocks = { noMove: true, noResize: true };
@@ -226,6 +233,14 @@ interface PptxShapeLocks {
   noAdjustHandles?: boolean;
   noChangeArrowheads?: boolean;
   noChangeShapeType?: boolean;
+  /**
+   * `a:graphicFrameLocks/@noDrilldown`: forbids selecting the individual
+   * parts inside a graphic frame (a chart series, a SmartArt node). Declared
+   * ONLY by `CT_GraphicalObjectFrameLocking`, so it is written for tables,
+   * charts, SmartArt, OLE objects and graphic-frame media, and never onto
+   * `a:spLocks` / `a:picLocks` / `a:cxnSpLocks` / `a:grpSpLocks`.
+   */
+  noDrilldown?: boolean;
   /**
    * Text-box flag from `p:cNvSpPr/@txBox`. Not a lock in the strict sense,
    * but it lives on the same non-visual-properties node as `a:spLocks`, so
@@ -10030,6 +10045,28 @@ interface PowerPointViewerProps {
   onOpenFile?: () => void;
   /** Whether editing actions are enabled */
   canEdit?: boolean;
+  /**
+   * Recovery autosave: after an edit the deck is re-serialised (always as a
+   * plain, unencrypted package, because recovery has no password) and stashed
+   * in the shared IndexedDB store keyed by {@link filePath}. It is a crash-
+   * safety net and never replaces the user's real Save: the document stays
+   * dirty. On load, a newer snapshot is offered back through a recovery prompt.
+   *
+   * **The prop is a policy ceiling; the title-bar AutoSave toggle is the user's
+   * preference inside it.** `false` turns autosave off and makes the toggle
+   * inert (a user cannot switch on what the application forbade). `true` or
+   * omitted permits it, and the toggle decides, defaulting to on. Identical in
+   * all five bindings; see `resolveAutosaveActivation` in `pptx-viewer-shared`.
+   *
+   * @default true
+   */
+  autosave?: boolean;
+  /**
+   * Recovery cadence in milliseconds. An explicit value is a host policy and is
+   * honoured as given; omit it to follow the user's File > Options > Save >
+   * "Save AutoRecover information every N minutes" (two minutes by default).
+   */
+  autosaveIntervalMs?: number;
   /** Optional class name */
   className?: string;
   /**

package/dist/index.js

@@ -1,176 +1,176 @@
 'use strict';
 
-var chunkICZDMFF2_js = require('./chunk-ICZDMFF2.js');
-require('./chunk-MAVLV56S.js');
-var chunkASKYZ5ZY_js = require('./chunk-ASKYZ5ZY.js');
-var chunk4LWGAVAP_js = require('./chunk-4LWGAVAP.js');
-var chunkRTUGI4HQ_js = require('./chunk-RTUGI4HQ.js');
-var chunkWVDM36ZM_js = require('./chunk-WVDM36ZM.js');
+var chunkNFFV3RDS_js = require('./chunk-NFFV3RDS.js');
+require('./chunk-RPJ2BIQ7.js');
+var chunkIRLOXBO7_js = require('./chunk-IRLOXBO7.js');
+var chunkOVPJT4EQ_js = require('./chunk-OVPJT4EQ.js');
+var chunkMVKRI3CZ_js = require('./chunk-MVKRI3CZ.js');
+var chunk7ARD2J6Y_js = require('./chunk-7ARD2J6Y.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkICZDMFF2_js.PowerPointViewer; }
+  get: function () { return chunkNFFV3RDS_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkICZDMFF2_js.SlideCanvas; }
+  get: function () { return chunkNFFV3RDS_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkICZDMFF2_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkNFFV3RDS_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkICZDMFF2_js.SlideTemplatePreview; }
+  get: function () { return chunkNFFV3RDS_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkICZDMFF2_js.Toolbar; }
+  get: function () { return chunkNFFV3RDS_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkICZDMFF2_js.ViewerThemeProvider; }
+  get: function () { return chunkNFFV3RDS_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkICZDMFF2_js.useViewerTheme; }
+  get: function () { return chunkNFFV3RDS_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkASKYZ5ZY_js.renderToCanvas; }
+  get: function () { return chunkIRLOXBO7_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkASKYZ5ZY_js.useViewerBuildingBlocks; }
+  get: function () { return chunkIRLOXBO7_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunk4LWGAVAP_js.getAnimationInitialStyle; }
+  get: function () { return chunkOVPJT4EQ_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkRTUGI4HQ_js.LOCALE_CATALOG; }
+  get: function () { return chunkMVKRI3CZ_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunk7ARD2J6Y_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunk7ARD2J6Y_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunk7ARD2J6Y_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunk7ARD2J6Y_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.SLIDE_TEMPLATES; }
+  get: function () { return chunk7ARD2J6Y_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.THEME_CATALOG; }
+  get: function () { return chunk7ARD2J6Y_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunk7ARD2J6Y_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.buildSlideTemplateContent; }
+  get: function () { return chunk7ARD2J6Y_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.buildSlideTemplateSlide; }
+  get: function () { return chunk7ARD2J6Y_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.clearAllLocalViewerData; }
+  get: function () { return chunk7ARD2J6Y_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.clearStoredViewerPrefs; }
+  get: function () { return chunk7ARD2J6Y_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.defaultCssVars; }
+  get: function () { return chunk7ARD2J6Y_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.defaultRadius; }
+  get: function () { return chunk7ARD2J6Y_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.defaultThemeColors; }
+  get: function () { return chunk7ARD2J6Y_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.getLocalStorageUsageSummary; }
+  get: function () { return chunk7ARD2J6Y_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.isLegacyBinaryPresentation; }
+  get: function () { return chunk7ARD2J6Y_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.isSupportedPresentationFile; }
+  get: function () { return chunk7ARD2J6Y_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.presentationBaseName; }
+  get: function () { return chunk7ARD2J6Y_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.readStoredViewerPrefs; }
+  get: function () { return chunk7ARD2J6Y_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.resolveProfileInitial; }
+  get: function () { return chunk7ARD2J6Y_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk7ARD2J6Y_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.saveViewerProfile; }
+  get: function () { return chunk7ARD2J6Y_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.savedPresentationFileName; }
+  get: function () { return chunk7ARD2J6Y_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.themeToCssVars; }
+  get: function () { return chunk7ARD2J6Y_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.vermilionDarkColors; }
+  get: function () { return chunk7ARD2J6Y_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.vermilionDarkTheme; }
+  get: function () { return chunk7ARD2J6Y_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.vermilionLightColors; }
+  get: function () { return chunk7ARD2J6Y_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.vermilionLightTheme; }
+  get: function () { return chunk7ARD2J6Y_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.vermilionRadius; }
+  get: function () { return chunk7ARD2J6Y_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkWVDM36ZM_js.writeStoredViewerPrefs; }
+  get: function () { return chunk7ARD2J6Y_js.writeStoredViewerPrefs; }
 });

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-O7FTUUXP.mjs';
-import './chunk-7XF6S4AM.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-QUB5OSKY.mjs';
-export { getAnimationInitialStyle } from './chunk-BZOL6FXF.mjs';
-export { LOCALE_CATALOG } from './chunk-SNL6LBRX.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-GODW6RNR.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-YWJBD7KV.mjs';
+import './chunk-ZMEYXAC6.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-BO373PYH.mjs';
+export { getAnimationInitialStyle } from './chunk-MWEBCWVD.mjs';
+export { LOCALE_CATALOG } from './chunk-SQJBFMEX.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-XF3EOHY2.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/internals.d.ts

@@ -183,11 +183,18 @@ interface XmlObject {
   [child: string]: XmlObject | XmlObject[] | string | undefined;
 }
 /**
- * Shape lock attributes from `p:cNvSpPr / a:spLocks`.
+ * Lock attributes from an element's non-visual properties node.
  *
  * When a flag is `true` the corresponding user interaction is disabled
  * in the editor (e.g. `noRotation` prevents free rotation of the shape).
  *
+ * One bag covers every family, but the families are NOT interchangeable in
+ * the file: `a:spLocks` (`CT_ShapeLocking`), `a:picLocks`, `a:cxnSpLocks`,
+ * `a:grpSpLocks` (`CT_GroupLocking`) and `a:graphicFrameLocks`
+ * (`CT_GraphicalObjectFrameLocking`) each declare their own attribute subset.
+ * `runtime/shape-lock-containers` holds that table and is what decides which
+ * of these fields may be written for a given element.
+ *
  * @example
  * ```ts
  * const locks: PptxShapeLocks = { noMove: true, noResize: true };
@@ -206,6 +213,14 @@ interface PptxShapeLocks {
   noAdjustHandles?: boolean;
   noChangeArrowheads?: boolean;
   noChangeShapeType?: boolean;
+  /**
+   * `a:graphicFrameLocks/@noDrilldown`: forbids selecting the individual
+   * parts inside a graphic frame (a chart series, a SmartArt node). Declared
+   * ONLY by `CT_GraphicalObjectFrameLocking`, so it is written for tables,
+   * charts, SmartArt, OLE objects and graphic-frame media, and never onto
+   * `a:spLocks` / `a:picLocks` / `a:cxnSpLocks` / `a:grpSpLocks`.
+   */
+  noDrilldown?: boolean;
   /**
    * Text-box flag from `p:cNvSpPr/@txBox`. Not a lock in the strict sense,
    * but it lives on the same non-visual-properties node as `a:spLocks`, so
@@ -9490,6 +9505,31 @@ interface FontEmbeddingDescriptor {
   /** Present only when `interactive` is false. */
   disabledReasonKey?: string;
 }
+/** Everything a binding needs to render the recovery dialog, and nothing else. */
+interface AutosaveRecoveryPrompt {
+  /** IndexedDB key the snapshot is stored under (the deck's file path/name). */
+  readonly filePath: string;
+  /** When the snapshot was written (epoch ms). */
+  readonly timestamp: number;
+  /** Snapshot size in bytes. */
+  readonly size: number;
+  /** Whole minutes since it was written, floored at 0. */
+  readonly ageMinutes: number;
+  readonly titleKey: string;
+  readonly messageKey: string;
+  /** `size` is pre-formatted here because byte units are not translated. */
+  readonly messageParams: {
+    readonly file: string;
+    readonly size: string;
+  };
+  /** Relative age, reusing the existing autosave age keys. */
+  readonly ageKey: string;
+  readonly ageParams: {
+    readonly count: number;
+  };
+  readonly restoreKey: string;
+  readonly discardKey: string;
+}
 //#endregion
 //#region src/render/master-view.d.ts
 /** Which part the master view is currently pointed at. */
@@ -10420,9 +10460,25 @@ interface UseAutosaveInput {
   filePath: string | undefined;
   /** Serialise current editor state to a Uint8Array. */
   serializeSlides: () => Promise<Uint8Array | null>;
-  /** Autosave interval in seconds (default 120). */
+  /**
+   * Autosave interval in seconds.
+   *
+   * @deprecated Pass {@link intervalMs} instead. Seconds cannot express the
+   * short cadence a host may legitimately ask for, and the shared clamp it went
+   * through raised anything under 10s back to 10s, so an explicit host policy
+   * was silently overruled. Ignored when `intervalMs` is given.
+   */
   intervalSeconds?: number;
-  /** Whether autosave is enabled. */
+  /**
+   * Autosave interval in milliseconds, already resolved by the shared
+   * `resolveAutosaveIntervalMs` (host prop > File > Options > Save AutoRecover
+   * cadence > 120s default). Wins over {@link intervalSeconds}.
+   */
+  intervalMs?: number;
+  /**
+   * Whether autosave is enabled: the resolved `active` from the shared
+   * `resolveAutosaveActivation`, NOT the raw title-bar toggle.
+   */
   enabled?: boolean;
   /**
    * The values a snapshot is built from, read fresh on each tick.
@@ -12612,9 +12668,26 @@ interface UseRecoveryDetectionInput {
   loading: boolean;
   error: string | null;
   slideCount: number;
-  openVersionHistory: () => void;
+  /**
+   * Whether the host permits autosave (the shared `resolveAutosaveActivation`
+   * ceiling). A host that passed `autosave={false}` is never offered snapshots
+   * an earlier configuration left behind. Defaults to true.
+   */
+  autosaveAllowed?: boolean;
+  /** Load the recovered bytes into the viewer. */
+  onRestore?: (bytes: Uint8Array) => void;
+  /** Legacy behaviour: also open the Version History panel when one is found. */
+  openVersionHistory?: () => void;
+}
+interface UseRecoveryDetectionResult {
+  /** What the dialog should say, or null when there is nothing to offer. */
+  prompt: AutosaveRecoveryPrompt | null;
+  /** Accept: load the snapshot and close. */
+  restore: () => void;
+  /** Decline: drop the snapshot and close. */
+  discard: () => void;
 }
-declare function useRecoveryDetection(input: UseRecoveryDetectionInput): void;
+declare function useRecoveryDetection(input: UseRecoveryDetectionInput): UseRecoveryDetectionResult;
 //#endregion
 //#region src/viewer/hooks/usePresentationSetup.d.ts
 interface UsePresentationSetupInput {
@@ -12734,15 +12807,18 @@ declare function useIOHandlers(input: UseIOHandlersInput): IOHandlersResult;
 interface UseContentLifecycleInput {
   content: ArrayBuffer | Uint8Array | null;
   filePath: string | undefined;
-  /** AutoSave toggle state; when false the recovery autosave timer is off. */
+  /**
+   * Whether autosave actually runs: the resolved `active` from the shared
+   * `resolveAutosaveActivation` (host `autosave` prop as a ceiling, title-bar
+   * toggle as the preference inside it), not the raw toggle.
+   */
   autosaveEnabled?: boolean;
   /**
-   * AutoRecover cadence in seconds, from
-   * `resolveAutosaveIntervalSeconds(File > Options > Save)`. React was the only
-   * binding that never passed one (vanilla, svelte and angular all resolve it),
-   * so the option's number field moved and the timer kept its 120s default.
+   * The resolved cadence in milliseconds, from the shared
+   * `resolveAutosaveIntervalMs` (host `autosaveIntervalMs` prop > File >
+   * Options > Save AutoRecover cadence > 120s default).
    */
-  autosaveIntervalSeconds?: number;
+  autosaveIntervalMs?: number;
   /**
    * File > Fonts > "Embed fonts in the file". Forwarded to `useSerialize`, so
    * turning it off actually strips the embedded font data on the next save.
@@ -12798,13 +12874,22 @@ interface UseViewerIntegrationInput {
   gridSpacingPx: number;
   content: ArrayBuffer | Uint8Array | null;
   filePath: string | undefined;
-  /** AutoSave toggle state from the title bar. */
+  /**
+   * Whether autosave actually runs: the shared `resolveAutosaveActivation`
+   * verdict (host `autosave` prop as a ceiling, title-bar toggle inside it).
+   */
   autosaveEnabled: boolean;
   /**
-   * AutoRecover cadence in seconds, resolved from File > Options > Save.
-   * Optional: omitting it keeps `useAutosave`'s 120s default.
+   * Whether the host permits autosave at all. Only the recovery prompt needs
+   * this separately from `autosaveEnabled`: a user who merely switched the
+   * toggle off should still be offered a snapshot from before the crash.
+   */
+  autosaveAllowed?: boolean;
+  /**
+   * The resolved cadence in milliseconds (shared `resolveAutosaveIntervalMs`).
+   * Optional: omitting it keeps the shared 120s AutoRecover default.
    */
-  autosaveIntervalSeconds?: number;
+  autosaveIntervalMs?: number;
   canEdit: boolean;
   mode: ViewerState['mode'];
   slides: PptxSlide[];
@@ -12835,6 +12920,8 @@ interface ViewerIntegrationResult {
   handleEnterPresenterView: AnnotationHandlersResult['handleEnterPresenterView'];
   handleEnterRehearsalMode: AnnotationHandlersResult['handleEnterRehearsalMode'];
   autosaveStatus: AutosaveStatus;
+  /** The crash-recovery prompt (shared descriptor) plus its accept/decline actions. */
+  recovery: UseRecoveryDetectionResult;
   isEncryptedDialogOpen: boolean;
   setIsEncryptedDialogOpen: Dispatch<SetStateAction<boolean>>;
   /** The loaded core handler, exposed for the AI bridge (`getHandler`). */