pptx-react-viewer 4.45.0 → 4.47.0

package/dist/{chunk-Q3DHYOLK.mjs → chunk-UV2HVMKZ.mjs}

@@ -25,7 +25,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
   // If the importer is in node compatibility mode or this is not an ESM
   // file that has been converted to a CommonJS file using a Babel-
@@ -35,4 +34,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-export { __commonJS, __reExport, __require, __toESM };
+export { __commonJS, __require, __toESM };

package/dist/i18n.js

@@ -1,6 +1,6 @@
 'use strict';
 
-require('./chunk-W2IMY5SY.js');
+require('./chunk-PIRHQTI4.js');
 var i18n = require('ooxml-ui/pptx/i18n');
 
 

package/dist/i18n.js.br

@@ -1,2 +1,2 @@
-�
���ƞ-qK��wl`��b��]�@��k�����/4#؄$��
�P��T�B�	�^ޅ�t]����~�R�m&�A��'c��_��>��q��:�
-p����R��M3,|#*
+�
���tc/����b�h`��bdc'/��z9��_hF�	I6�6�(Y�6�n<��W�#z��k\o����6�� p�o����q��I)�q��z�p���k[��ğN�߈
+FC����qH�Q�{ŧ�-�_���M�׎Qg���Y�4G���h�S�</�;?NSMn\
U9���E�j�vp

package/dist/i18n.mjs

@@ -1,2 +1,2 @@
-import './chunk-Q3DHYOLK.mjs';
+import './chunk-UV2HVMKZ.mjs';
 export { LOCALE_CATALOG, keyToLabel, translationsEn } from 'ooxml-ui/pptx/i18n';

package/dist/i18n.mjs.br

@@ -1,3 +1,3 @@
-�7�import './chunk-Q3DHYOLK.mjs';
+�7�import './chunk-UV2HVMKZ.mjs';
 export { LOCALE_CATALOG, keyToLabel, translationsEn } from 'ooxml-ui/pptx/i18n';
 

package/dist/index.d.ts

@@ -1,16 +1,16 @@
 import * as React$1 from 'react';
 import React$1__default from 'react';
 import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
-import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, CanvasSize, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, ReviewCommentsHost, CollaborationShellState } from 'ooxml-ui/pptx';
+import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, CanvasSize, DocumentStorage, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, ReviewCommentsHost, CollaborationShellState } from 'ooxml-ui/pptx';
 export { AVATAR_COLOR_SWATCHES, AccountAuthConfig, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCustomization, CANVAS_CONTEXT_MENU_COMMAND_IDS, CollaborationConfig, CollaborationShellState, ContextMenuCustomization, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, KeyboardCustomization, LocalStorageUsageSummary, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewerAPI, RIBBON_TAB_IDS, ResolvedCustomization, RibbonCustomization, SLIDE_TEMPLATES, SavedPresentationFormat, ShortcutChord, SlideTemplateId, SlideTemplateSpec, StoredViewerPrefs, THEME_CATALOG, TOOLBAR_BUTTON_IDS, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarTabId, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerMode, ViewerPanelId, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from 'ooxml-ui/pptx';
 import { LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
 export { LOCALE_CATALOG, LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
-import { CollaborationState } from 'ooxml-core/collab';
+import { PptxCoreProperties, PptxAnimationPreset, PptxNativeAnimation, PptxSlide, PptxElement, TextStyle, InkPptxElement, ShapePptxElement, PptxAction, PptxComment, PptxElementAnimation, ConnectorPptxElement, ParsedTableStyleMap, PptxTheme, ShapeStyle, PptxLayoutOption, PptxLayoutPreview, PptxCustomShow, PptxSlideTransition, PptxPresentationProperties } from 'ooxml-core/pptx';
+import { CollaborationWriteBackState, CollaborationState } from 'ooxml-core/collab';
 export { CollaborationState } from 'ooxml-core/collab';
 import { PptxAiConfig } from 'ooxml-ui/pptx/ai';
 export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
 import { Doc } from 'yjs';
-import { PptxAnimationPreset, PptxNativeAnimation, PptxSlide, PptxElement, TextStyle, InkPptxElement, ShapePptxElement, PptxAction, PptxComment, PptxElementAnimation, ConnectorPptxElement, ParsedTableStyleMap, PptxTheme, ShapeStyle, PptxLayoutOption, PptxLayoutPreview, PptxCustomShow, PptxSlideTransition, PptxPresentationProperties } from 'ooxml-core/pptx';
 import { Options } from 'html2canvas-pro';
 
 //#region src/viewer/types-core.d.ts
@@ -50,7 +50,7 @@ declare function useViewerTheme(): ViewerTheme | undefined;
 //#endregion
 //#region src/viewer/hooks/collaboration/types.d.ts
 /** Connection lifecycle states for the Yjs WebSocket provider. */
-type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+type ConnectionStatus$1 = 'disconnected' | 'connecting' | 'connected' | 'error';
 /**
  * Presence data broadcast to other participants.
  * Cursor position is relative to the slide canvas (0..canvasWidth, 0..canvasHeight).
@@ -80,7 +80,7 @@ interface UserPresence {
 /** Value exposed by `CollaborationContext`. */
 interface CollaborationContextValue {
   /** Current WebSocket connection status. */
-  status: ConnectionStatus;
+  status: ConnectionStatus$1;
   /** Presence data for all remote users (excludes the local user). */
   remoteUsers: UserPresence[];
   /** Broadcast the local user's presence state. */
@@ -100,6 +100,10 @@ interface CollaborationContextValue {
   retry: () => void;
   /** The local awareness client id, once the session has one. */
   clientId?: number | null;
+  /** The owner's write-back status, as the document sync last reported it. */
+  writeBack?: CollaborationWriteBackState | undefined;
+  /** Called by the document sync with the write-back status (undefined clears it). */
+  reportWriteBack?: (state: CollaborationWriteBackState | undefined) => void;
 }
 //#endregion
 //#region src/viewer/hooks/useLoadNotifications.d.ts
@@ -181,7 +185,7 @@ interface PowerPointViewerProps extends ViewportFitOptions {
    * and canvas size.
    */
   onLoad?: (detail: ViewerLoadDetail) => void;
-  /** Fired once per distinct load failure, with a human-readable message. */
+  /** Fired once per distinct load failure, and for each failed Save / Save As, with a human-readable message. */
   onError?: (message: string) => void;
   /**
    * Host override for the File ▸ Open action. When provided, the built-in
@@ -192,6 +196,12 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   onOpenFile?: () => void;
   /** Whether editing actions are enabled */
   canEdit?: boolean;
+  /**
+   * Makes the deck read-only (default `false`). It is the inverse of the edit switch: true wins
+   * over it, false only lifts this restriction, so editing still needs the edit switch and
+   * is never granted over a collaboration `viewer` role or `capabilities.edit`.
+   */
+  readOnly?: boolean;
   /**
    * Recovery autosave: after an edit the deck is re-serialised (always as a
    * plain, unencrypted package, because recovery has no password) and stashed
@@ -214,6 +224,35 @@ interface PowerPointViewerProps extends ViewportFitOptions {
    * "Save AutoRecover information every N minutes" (two minutes by default).
    */
   autosaveIntervalMs?: number;
+  /**
+   * Host-owned storage (`DocumentStorage` from `ooxml-core/embedding`). When set,
+   * Save and Save As hand the bytes to `storage.save()` instead of downloading
+   * them, and recovery autosave snapshots go to the storage's recovery methods
+   * (`readRecovery` / `writeRecovery` / `clearRecovery`) instead of IndexedDB
+   * when it provides them.
+   */
+  storage?: DocumentStorage;
+  /** Fired with the serialised deck each time a recovery autosave snapshot is written. */
+  onAutosave?: (content: Uint8Array) => void;
+  /** Fired when the user enables or disables autosave (title bar or File > Options). */
+  onAutosaveToggle?: (enabled: boolean) => void;
+  /** Fired on every autosave lifecycle transition (`idle`, `saving`, `saved`, `error`). */
+  onAutosaveStatus?: (status: ViewerAutosaveStatus) => void;
+  /**
+   * Fired when a recovery snapshot left by a previous session is found for this deck. The
+   * built-in recovery prompt is shown as well.
+   */
+  onAutosaveRecovery?: (record: AutosaveRecord) => void;
+  /** Fired after any committed document edit (move, resize, text, undo, redo, ...). */
+  onChange?: () => void;
+  /** Fired with the changed fields when the user saves the document properties dialog. */
+  onPropertiesChange?: (updates: Partial<PptxCoreProperties>) => void;
+  /** Fired with the new speaker-notes text when the user edits the notes of a slide. */
+  onNotesUpdate?: (notes: string) => void;
+  /** Fired when presentation (slide show) mode is entered (`true`) or left (`false`). */
+  onPresentationChange?: (presenting: boolean) => void;
+  /** Fired on every collaboration connection-status transition. */
+  onCollaborationStatus?: (status: ConnectionStatus) => void;
   /** Optional class name */
   className?: string;
   /**
@@ -636,6 +675,8 @@ interface ToolbarProps {
   onExportGif: () => void;
   onExportJson: () => void;
   onOpenShareDialog?: () => void;
+  /** File > Save (the backstage Save item): reported to host storage as `save`, not Save As. */
+  onSave?: () => void;
   onSaveAsPptx: () => void;
   onSaveAsPpsx: () => void;
   onSaveAsPptm: () => void;

package/dist/index.js

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkKUQRWMIK_js = require('./chunk-KUQRWMIK.js');
-var chunk2YCROYR6_js = require('./chunk-2YCROYR6.js');
-var chunkVJZJESNT_js = require('./chunk-VJZJESNT.js');
-require('./chunk-W2IMY5SY.js');
+var chunkSSANGQ35_js = require('./chunk-SSANGQ35.js');
+var chunkMRSGNERC_js = require('./chunk-MRSGNERC.js');
+var chunkMA2BI7LX_js = require('./chunk-MA2BI7LX.js');
+require('./chunk-PIRHQTI4.js');
 var pptx = require('ooxml-ui/pptx');
 var i18n = require('ooxml-ui/pptx/i18n');
 
@@ -11,87 +11,87 @@ var i18n = require('ooxml-ui/pptx/i18n');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.PowerPointViewer; }
+  get: function () { return chunkSSANGQ35_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.SlideCanvas; }
+  get: function () { return chunkSSANGQ35_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkSSANGQ35_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.SlideTemplatePreview; }
+  get: function () { return chunkSSANGQ35_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.THEME_CATALOG; }
+  get: function () { return chunkSSANGQ35_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.Toolbar; }
+  get: function () { return chunkSSANGQ35_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.ViewerThemeProvider; }
+  get: function () { return chunkSSANGQ35_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.defaultCssVars; }
+  get: function () { return chunkSSANGQ35_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.defaultRadius; }
+  get: function () { return chunkSSANGQ35_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.defaultThemeColors; }
+  get: function () { return chunkSSANGQ35_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkSSANGQ35_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.themeToCssVars; }
+  get: function () { return chunkSSANGQ35_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.useViewerTheme; }
+  get: function () { return chunkSSANGQ35_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.vermilionDarkColors; }
+  get: function () { return chunkSSANGQ35_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.vermilionDarkTheme; }
+  get: function () { return chunkSSANGQ35_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.vermilionLightColors; }
+  get: function () { return chunkSSANGQ35_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.vermilionLightTheme; }
+  get: function () { return chunkSSANGQ35_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkKUQRWMIK_js.vermilionRadius; }
+  get: function () { return chunkSSANGQ35_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunk2YCROYR6_js.renderToCanvas; }
+  get: function () { return chunkMRSGNERC_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunk2YCROYR6_js.useViewerBuildingBlocks; }
+  get: function () { return chunkMRSGNERC_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkVJZJESNT_js.getAnimationInitialStyle; }
+  get: function () { return chunkMA2BI7LX_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,

package/dist/index.mjs

@@ -1,6 +1,6 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-VUE3EPTJ.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-66APV3YZ.mjs';
-export { getAnimationInitialStyle } from './chunk-FBN7UFW2.mjs';
-import './chunk-Q3DHYOLK.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-OWZSRPAH.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-HDOR67HF.mjs';
+export { getAnimationInitialStyle } from './chunk-BVQSH5SS.mjs';
+import './chunk-UV2HVMKZ.mjs';
 export { AVATAR_COLOR_SWATCHES, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, CANVAS_CONTEXT_MENU_COMMAND_IDS, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, RIBBON_TAB_IDS, SLIDE_TEMPLATES, TOOLBAR_BUTTON_IDS, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, saveViewerProfile, savedPresentationFileName, writeStoredViewerPrefs } from 'ooxml-ui/pptx';
 export { LOCALE_CATALOG } from 'ooxml-ui/pptx/i18n';

package/dist/internals.d.ts

@@ -1,6 +1,7 @@
-import { CollaborationRole, CollaborationConfig, PowerPointViewerAPI, ViewerCustomizationApi, ShapeAdjustmentHandleDescriptor, ChangeCaseMode, ResolvedKeyboardCustomization, FindResult, EditorImagePasteOptions, InsertChartKind, PasteSpecialFormat, SlidePasteRequest, SlideTemplateId, MorphTransitionPlan, ElementAnimationState, ZoomNavigationTarget, PresentationSnapshot, ViewerMode, ShapeAdjustmentDragState, InlineTextEditSnapshot, InlineListReadResult, FreeformToolKind, CollaborationLivePatcher, SlideSizeEmu, ElementClipboardPayload, CropSession, FontEmbeddingDescriptor, MasterViewTarget, ViewportFitOptions, CollaborationInput, ToolbarActionId, CollaborationShellState, AnimationApplyGroup, ReviewCommentsHost, RulerUnit, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, PresentationPointerTool, RunProgramNotice, BorrowedCollaborationAwareness, CollabLoadOrigin, AuthoredSlideRange, FragmentedLayer, PrintSettings, ThemeEditorEdit, CompareResult, ReadOnlyRecommendation, CompatibilityWarningToast, DeviceOrientation, ResolvedCustomization, DeckSavePurpose, ZoomExcursion, TouchGestureCallbacks, ViewerOptionsStore, ViewerOptions, AutosaveRecoveryPrompt, VirtualizedRange, ToolbarTabId } from 'ooxml-ui/pptx';
+import { CollaborationRole, CollaborationConfig, PowerPointViewerAPI, ViewerCustomizationApi, ShapeAdjustmentHandleDescriptor, ChangeCaseMode, ResolvedKeyboardCustomization, FindResult, EditorImagePasteOptions, InsertChartKind, PasteSpecialFormat, SlidePasteRequest, SlideTemplateId, MorphTransitionPlan, ElementAnimationState, ZoomNavigationTarget, PresentationSnapshot, DocumentStorage, ViewerMode, ShapeAdjustmentDragState, InlineTextEditSnapshot, InlineListReadResult, FreeformToolKind, CollaborationLivePatcher, SlideSizeEmu, ElementClipboardPayload, CropSession, FontEmbeddingDescriptor, MasterViewTarget, ViewportFitOptions, CollaborationInput, ToolbarActionId, CollaborationShellState, AnimationApplyGroup, ReviewCommentsHost, RulerUnit, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, PresentationPointerTool, RunProgramNotice, BorrowedCollaborationAwareness, CollabLoadOrigin, AuthoredSlideRange, DocumentSaveReason, FragmentedLayer, PrintSettings, ThemeEditorEdit, CompareResult, ReadOnlyRecommendation, CompatibilityWarningToast, DeviceOrientation, ResolvedCustomization, AutosaveRecord, DeckSavePurpose, ZoomExcursion, TouchGestureCallbacks, ViewerAutosaveStatus, ViewerOptionsStore, ViewerOptions, AutosaveRecoveryPrompt, VirtualizedRange, ToolbarTabId } from 'ooxml-ui/pptx';
 export { CINEMATIC_TRANSITION_KEYFRAMES, CollaborationConfig, DEFAULT_MORPH_DURATION_MS, DEFAULT_TRANSITION_DURATION_MS, DeviceOrientation, EASE, INSTANT, MOBILE_BREAKPOINT, P14_TRANSITION_KEYFRAMES, P14_TRANSITION_KEYFRAMES_2, P14_TRANSITION_KEYFRAMES_ALL, RANDOM_ELIGIBLE_TYPES, ResolvedDirection, ResolvedDirection8, SLIDE_TRANSITION_KEYFRAMES, SLIDE_TRANSITION_KEYFRAMES_CSS, SlideTransitionAnimations, TABLET_BREAKPOINT, TRANSITION_SPEED_DURATION_MS, TouchGestureCallbacks, VirtualizedRange, WHEEL_SPOKE_COUNTS, computeVirtualRange, getCinematicTransitionAnimations, getP14TransitionAnimations, getSlideTransitionAnimations, resolveDirection, resolveDirection8, resolveOrientation, resolveSlideTransition, resolveTransitionDurationMs, resolveWheelSpokeCount } from 'ooxml-ui/pptx';
 import { PptxSlide, PptxElement, PptxElementAnimation, TextStyle, PptxHeaderFooter, ShapeStyle, PptxCommentMention, SmartArtLayout, InkPptxElement, ShapePptxElement, MergeShapeOperation, PptxSlideTransition, PptxAction, PptxSlideMaster, PptxModernCommentAuthor, PptxTheme, ParsedTableStyleMap, PptxThemeOption, PptxCustomShow, PptxSection, PptxPresentationProperties, PptxViewProperties, PptxNotesMaster, PptxHandoutMaster, PptxCustomProperty, PptxTagCollection, PptxCoreProperties, PptxAppProperties, PptxEmbeddedFont, MasterViewTab, PptxSlideLayout, PptxHandler, PptxLayoutOption, PptxLayoutPreview, PptxComment, ConnectorPptxElement, PptxThemePreset, PptxThemeColorScheme, PptxThemeFontScheme, PptxData, PptxHandlerSaveOptions, PptxSaveFormat, TextSegment, PptxModifyVerifier } from 'ooxml-core/pptx';
+import { CollaborationWriteBackState } from 'ooxml-core/collab';
 import * as Y from 'yjs';
 import { Doc } from 'yjs';
 import React$1, { Dispatch, SetStateAction, MutableRefObject, RefObject, ForwardedRef } from 'react';
@@ -95,7 +96,7 @@ interface EditorHistorySnapshot {
 //#endregion
 //#region src/viewer/hooks/collaboration/types.d.ts
 /** Connection lifecycle states for the Yjs WebSocket provider. */
-type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+type ConnectionStatus$1 = 'disconnected' | 'connecting' | 'connected' | 'error';
 /**
  * Presence data broadcast to other participants.
  * Cursor position is relative to the slide canvas (0..canvasWidth, 0..canvasHeight).
@@ -125,7 +126,7 @@ interface UserPresence {
 /** Value exposed by `CollaborationContext`. */
 interface CollaborationContextValue {
   /** Current WebSocket connection status. */
-  status: ConnectionStatus;
+  status: ConnectionStatus$1;
   /** Presence data for all remote users (excludes the local user). */
   remoteUsers: UserPresence[];
   /** Broadcast the local user's presence state. */
@@ -145,6 +146,10 @@ interface CollaborationContextValue {
   retry: () => void;
   /** The local awareness client id, once the session has one. */
   clientId?: number | null;
+  /** The owner's write-back status, as the document sync last reported it. */
+  writeBack?: CollaborationWriteBackState | undefined;
+  /** Called by the document sync with the write-back status (undefined clears it). */
+  reportWriteBack?: (state: CollaborationWriteBackState | undefined) => void;
 }
 //#endregion
 //#region src/viewer/types-ui.d.ts
@@ -358,6 +363,8 @@ interface ToolbarProps {
   onExportGif: () => void;
   onExportJson: () => void;
   onOpenShareDialog?: () => void;
+  /** File > Save (the backstage Save item): reported to host storage as `save`, not Save As. */
+  onSave?: () => void;
   onSaveAsPptx: () => void;
   onSaveAsPpsx: () => void;
   onSaveAsPptm: () => void;
@@ -2213,6 +2220,8 @@ interface UseAutosaveInput {
    * `resolveAutosaveActivation`, NOT the raw title-bar toggle.
    */
   enabled?: boolean;
+  /** Host storage; its recovery methods replace IndexedDB when it has them. */
+  storage?: DocumentStorage;
   /**
    * The values a snapshot is built from, read fresh on each tick.
    *
@@ -2224,6 +2233,8 @@ interface UseAutosaveInput {
    * whenever it is unsure. Omit it and every tick writes, as before.
    */
   getChangeSources?: () => readonly unknown[];
+  /** Called with the serialised deck after each snapshot is written (the host's `onAutosave`). */
+  onSaved?: ((data: Uint8Array) => void) | undefined;
 }
 interface UseAutosaveResult {
   /** Current autosave status for display in the StatusBar. */
@@ -2489,7 +2500,7 @@ interface UseYjsProviderInput {
 }
 interface UseYjsProviderResult {
   /** Current WebSocket connection status. */
-  status: ConnectionStatus;
+  status: ConnectionStatus$1;
   /** The Yjs awareness instance (null until connected). */
   awareness: Awareness | null;
   /** The Yjs document (null until initialised). */
@@ -2590,7 +2601,7 @@ interface UseYjsDocumentSyncInput {
   setSlides: React.Dispatch<React.SetStateAction<PptxSlide[]>>;
   isConnected: boolean;
   isSynced?: boolean;
-  config?: Pick<CollaborationConfig, 'role' | 'onWriteBack' | 'writeBackDebounceMs' | 'externalSession' | 'sessionIntent'>;
+  config?: Pick<CollaborationConfig, 'role' | 'onWriteBack' | 'writeBackDebounceMs' | 'writeBackRetry' | 'externalSession' | 'sessionIntent'>;
   getSourceBytes?: () => Uint8Array | null;
   getSaveOptions?: () => PptxHandlerSaveOptions;
   loadVersion?: number;
@@ -2598,6 +2609,8 @@ interface UseYjsDocumentSyncInput {
   /** External readiness owns this channel together with full-deck writes. */
   livePatcher?: CollaborationLivePatcher;
   onReadOnlyChange?: (readOnly: boolean) => void;
+  /** Receives the owner's write-back status (undefined when the session ends). */
+  onWriteBackStatus?: (state: CollaborationWriteBackState | undefined) => void;
 }
 declare function useYjsDocumentSync(input: UseYjsDocumentSyncInput): void;
 //#endregion
@@ -3075,6 +3088,10 @@ interface UseExportHandlersInput {
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
   filePath: string | undefined;
+  /** Host `storage` prop: Save / Save As go to `storage.save()` instead of a download. */
+  storage?: DocumentStorage | undefined;
+  /** A Save / Save As failed (serialising, or the host's storage rejected). */
+  onSaveError?: ((error: unknown) => void) | undefined;
   canvasStageRef: RefObject<HTMLDivElement | null>;
   setActiveSlideIndex: Dispatch<SetStateAction<number>>;
   /**
@@ -3131,7 +3148,13 @@ interface ExportHandlersResult {
   handleExportVideo: () => Promise<void>;
   handleExportGif: () => Promise<void>;
   handleExportJson: () => void;
-  handleSaveAsFormat: (format: PptxSaveFormat) => Promise<void>;
+  /**
+   * Writes `format`. `reason` is the command that ran (Save As by default); resolves false when
+   * nothing was saved (no deck yet, or the save or the host's storage failed).
+   */
+  handleSaveAsFormat: (format: PptxSaveFormat, reason?: DocumentSaveReason) => Promise<boolean | void>;
+  /** File > Save: writes `.pptx`, reported to host storage as `save`. */
+  handleSave: () => void;
   handleSaveAsPptx: () => void;
   handleSaveAsPpsx: () => void;
   handleSaveAsPptm: () => void;
@@ -3226,6 +3249,10 @@ interface UsePropertyHandlersInput {
   setIsDirty: React.Dispatch<React.SetStateAction<boolean>>;
   ops: ElementOperations;
   history: EditorHistoryResult;
+  /** The host's `onPropertiesChange`: the fields a document-properties edit changed. */
+  onPropertiesChange?: ((updates: Partial<PptxCoreProperties>) => void) | undefined;
+  /** The host's `onNotesUpdate`: the new speaker-notes text of the active slide. */
+  onNotesUpdate?: ((notes: string) => void) | undefined;
 }
 interface PropertyHandlersResult {
   handleUpdateNotes: (text: string, segments?: TextSegment[]) => void;
@@ -3336,6 +3363,10 @@ interface UseRecoveryDetectionInput {
    * an earlier configuration left behind. Defaults to true.
    */
   autosaveAllowed?: boolean;
+  /** Host storage; the snapshot is read from its recovery methods when it has them. */
+  storage?: DocumentStorage;
+  /** Called with the stored record when a recovery snapshot is offered (the host's `onAutosaveRecovery`). */
+  onOffered?: ((record: AutosaveRecord) => void) | undefined;
   /** Load the recovered bytes into the viewer. */
   onRestore?: (bytes: Uint8Array) => void;
   /** Legacy behaviour: also open the Version History panel when one is found. */
@@ -3446,6 +3477,10 @@ interface UseIOHandlersInput {
   activeSlideIndex: number;
   canvasSize: CanvasSize$1;
   filePath: string | undefined;
+  /** Host `storage` prop, forwarded to the Save / Save As handlers. */
+  storage?: DocumentStorage | undefined;
+  /** Reports a failed Save / Save As to the host and the user. */
+  onSaveError?: ((error: unknown) => void) | undefined;
   history: EditorHistoryResult;
   ops: ElementOperations;
   zoom: {
@@ -3465,6 +3500,10 @@ interface UseIOHandlersInput {
   serializeForRecovery: () => Promise<Uint8Array | null>;
   setContent: React$1.Dispatch<React$1.SetStateAction<ArrayBuffer | Uint8Array | null>>;
   onContentChange: ((content: Uint8Array) => void) | undefined;
+  /** The host's `onPropertiesChange` (document-properties edits). */
+  onPropertiesChange?: ((updates: Partial<PptxCoreProperties>) => void) | undefined;
+  /** The host's `onNotesUpdate` (speaker-notes edits). */
+  onNotesUpdate?: ((notes: string) => void) | undefined;
   /** File > Options > Advanced > "Image Size and Quality" raster-scale multiplier. */
   imageExportScale?: number;
   /**
@@ -3498,6 +3537,10 @@ interface UseContentLifecycleInput {
    * Options > Save AutoRecover cadence > 120s default).
    */
   autosaveIntervalMs?: number;
+  /** Host `storage` prop: recovery snapshots go to its recovery methods when it has them. */
+  storage?: DocumentStorage;
+  /** The host's `onAutosave`: called with the bytes of each recovery snapshot written. */
+  onAutosave?: ((data: Uint8Array) => void) | undefined;
   /**
    * File > Fonts > "Embed fonts in the file". Forwarded to `useSerialize`, so
    * turning it off actually strips the embedded font data on the next save.
@@ -3600,6 +3643,10 @@ interface UseViewerIntegrationInput {
    * verdict (host `autosave` prop as a ceiling, title-bar toggle inside it).
    */
   autosaveEnabled: boolean;
+  /** Host `storage` prop: Save goes to it, and so do recovery snapshots when it keeps them. */
+  storage?: DocumentStorage;
+  /** A Save / Save As failed: report it to the host and the user. */
+  onSaveError?: (error: unknown) => void;
   /**
    * Whether the host permits autosave at all. Only the recovery prompt needs
    * this separately from `autosaveEnabled`: a user who merely switched the
@@ -3658,6 +3705,18 @@ interface UseViewerIntegrationInput {
   onZoomChange: ((zoom: number) => void) | undefined;
   onSelectionChange: ((ids: string[]) => void) | undefined;
   onSlideCountChange: ((count: number) => void) | undefined;
+  /** The host's `onAutosave`: bytes of each recovery snapshot written. */
+  onAutosave?: ((content: Uint8Array) => void) | undefined;
+  /** The host's `onAutosaveStatus`: every autosave lifecycle transition. */
+  onAutosaveStatus?: ((status: ViewerAutosaveStatus) => void) | undefined;
+  /** The host's `onAutosaveRecovery`: a recovery snapshot was offered. */
+  onAutosaveRecovery?: ((record: AutosaveRecord) => void) | undefined;
+  /** The host's `onPropertiesChange`: a document-properties edit. */
+  onPropertiesChange?: ((updates: Partial<PptxCoreProperties>) => void) | undefined;
+  /** The host's `onNotesUpdate`: a speaker-notes edit. */
+  onNotesUpdate?: ((notes: string) => void) | undefined;
+  /** The host's `onPresentationChange`: slide show mode entered or left. */
+  onPresentationChange?: ((presenting: boolean) => void) | undefined;
   /** Host UI customisation helpers, spread onto the imperative handle. */
   customizationApi?: ViewerCustomizationApi;
   /** Resolved host UI customisation, read by the keyboard shortcuts. */
@@ -3987,6 +4046,10 @@ interface UseExportSaveAsInput {
   /** Separated master/layout (template) elements, merged back at save time. */
   templateElementsBySlideId: Record<string, PptxElement[]>;
   filePath: string | undefined;
+  /** Host `storage` prop: when set, the saved bytes go to `storage.save()`, not a download. */
+  storage?: DocumentStorage | undefined;
+  /** Reports a failed Save / Save As (serialising, or the host's storage rejected). */
+  onSaveError?: ((error: unknown) => void) | undefined;
   /** `useSerialize`'s callback: the one place save options are assembled. */
   serializeSlides: SerializeSlides;
   /** Presentation-level state, carried into the deck-JSON export document. */
@@ -4013,7 +4076,10 @@ interface UseExportSaveAsInput {
 }
 interface ExportSaveAsResult {
   handleExportJson: () => void;
-  handleSaveAsFormat: (format: PptxSaveFormat) => Promise<void>;
+  /** Resolves false when nothing was saved (no deck yet, or the save or the host's storage failed). */
+  handleSaveAsFormat: (format: PptxSaveFormat, reason?: DocumentSaveReason) => Promise<boolean | void>;
+  /** File > Save: `.pptx`, reported to host storage as `save`. */
+  handleSave: () => void;
   handleSaveAsPptx: () => void;
   handleSaveAsPpsx: () => void;
   handleSaveAsPptm: () => void;
@@ -4544,4 +4610,4 @@ interface FragmentedTransitionLayerProps {
 declare function FragmentedTransitionLayer({ layer, slide, templateElements, canvasSize, scale, zIndex, layerName }: FragmentedTransitionLayerProps): React$1.ReactElement;
 
 export { FragmentedTransitionLayer, MIN_TOUCH_TARGET, MorphTransitionOverlay, PresentationTransitionOverlay, SlideLayer, computeToolbarVisibility, useAnimationPlayback, useAnnotationHandlers, useAudienceMode, useAutosave, useBroadcastFollower, useCanvasInteractions, useClipboardHandlers, useCollaborativeHistory, useCollaborativeState, useComments, useContentLifecycle, useDerivedElementState, useDerivedSlideState, useDialogCustomShows, useEditorHistory, useEditorOperations, useElementManipulation, useElementOperations, useExportHandlers, useExportSaveAs, useFindReplace, useFollowMode, useFontInjection, useGroupAlignLayerHandlers, useIOHandlers, useInsertElements, useIsMobile, useKeyboardInsets, useKeyboardShortcutWiring, useKeyboardShortcuts, useLayoutSwitching, useLoadContent, useMergeShapesHandler, useModalDismissDrag, usePointerHandlers, usePresenceTracking, usePresentationAnnotations, usePresentationKeyboard, usePresentationMode, usePresentationSetup, usePresenterWindow, usePrintHandlers, usePropertyHandlers, useRecoveryDetection, useReducedMotion, useRehearsalTimings, useResizablePanels, useSectionOperations, useSerialize, useSheetDismissDrag, useSlideManagement, useSlideNavigation, useSwipeNavigation, useTableOperations, useThemeHandlers, useThemeSwitching, useToolbarVisibility, useTouchGestures, useViewerBuildingBlocks, useViewerCoreState, useViewerDialogs, useViewerIntegration, useViewerOptions, useViewerState, useViewerUIState, useVirtualizedSlides, useYjsDocumentSync, useYjsProvider, useZoomNavigation, useZoomViewport };
-export type { AnnotationHandlersResult, AnnotationStroke, AutosaveStatus, CanvasInteractionHandlers, CollaborationContextValue, ConnectionStatus, ContentLifecycleResult, DerivedElementState, DerivedSlideState, EditorHistoryInput, EditorHistoryResult, EditorOperationsResult, ElementManipulationHandlers, ElementOperations, ExportHandlersResult, ExportSaveAsResult, FragmentedTransitionLayerProps, IOHandlersResult, InsertElementHandlers, LayoutSwitchingResult, MergeShapesHandlerInput, MergeShapesHandlers, ModalDismissDrag, ModalDismissDragHandlers, MorphTransitionOverlayProps, PresentationSetupResult, PresentationTool, PresentationTransitionOverlayProps, PrintHandlersResult, PropertyHandlersResult, SectionOperations, SheetDismissDrag, SheetDismissDragHandlers, SlideLayerProps, SlideManagementHandlers, TableOperationHandlers, ThemeHandlersResult, ThemeSwitchingResult, ToolbarVisibility, UseAnimationPlaybackInput, UseAnimationPlaybackResult, UseAnnotationHandlersInput, UseAutosaveInput, UseAutosaveResult, UseBroadcastFollowerInput, UseCanvasInteractionsInput, UseCollaborativeHistoryInput, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UseContentLifecycleInput, UseDerivedElementStateInput, UseDerivedSlideStateInput, UseDialogCustomShowsInput, UseDialogCustomShowsResult, UseEditorOperationsInput, UseElementManipulationInput, UseElementOperationsInput, UseExportHandlersInput, UseExportSaveAsInput, UseFollowModeInput, UseFollowModeResult, UseFontInjectionInput, UseIOHandlersInput, UseInsertElementsInput, UseIsMobileResult, UseKeyboardInsetsResult, UseKeyboardShortcutWiringInput, UseKeyboardShortcutsInput, UseLayoutSwitchingInput, UseLoadContentInput, UseLoadContentResult, UsePointerHandlersInput, UsePresenceTrackingInput, UsePresenceTrackingResult, UsePresentationAnnotationsResult, UsePresentationSetupInput, UsePresenterWindowInput, UsePresenterWindowResult, UsePrintHandlersInput, UsePropertyHandlersInput, UseRecoveryDetectionInput, UseReducedMotionResult, UseRehearsalTimingsInput, UseRehearsalTimingsResult, UseResizablePanelsResult, UseSectionOperationsInput, UseSerializeInput, UseSlideManagementInput, UseSlideNavigationInput, UseSlideNavigationResult, UseSwipeNavigationInput, UseSwipeNavigationResult, UseTableOperationsInput, UseThemeHandlersInput, UseThemeSwitchingInput, UseTouchGesturesInput, UseViewerBuildingBlocksInput, UseViewerCoreStateInput, UseViewerDialogsInput, UseViewerIntegrationInput, UseViewerOptionsResult, UseViewerStateInput, UseYjsDocumentSyncInput, UseYjsProviderInput, UseYjsProviderResult, UseZoomNavigationInput, UseZoomNavigationResult, UserPresence, ViewerBuildingBlocksResult, ViewerCoreState, ViewerDialogsResult, ViewerIntegrationResult, ViewerState, ViewerUIState, VirtualizedSlidesOptions, VirtualizedSlidesResult };
+export type { AnnotationHandlersResult, AnnotationStroke, AutosaveStatus, CanvasInteractionHandlers, CollaborationContextValue, ConnectionStatus$1 as ConnectionStatus, ContentLifecycleResult, DerivedElementState, DerivedSlideState, EditorHistoryInput, EditorHistoryResult, EditorOperationsResult, ElementManipulationHandlers, ElementOperations, ExportHandlersResult, ExportSaveAsResult, FragmentedTransitionLayerProps, IOHandlersResult, InsertElementHandlers, LayoutSwitchingResult, MergeShapesHandlerInput, MergeShapesHandlers, ModalDismissDrag, ModalDismissDragHandlers, MorphTransitionOverlayProps, PresentationSetupResult, PresentationTool, PresentationTransitionOverlayProps, PrintHandlersResult, PropertyHandlersResult, SectionOperations, SheetDismissDrag, SheetDismissDragHandlers, SlideLayerProps, SlideManagementHandlers, TableOperationHandlers, ThemeHandlersResult, ThemeSwitchingResult, ToolbarVisibility, UseAnimationPlaybackInput, UseAnimationPlaybackResult, UseAnnotationHandlersInput, UseAutosaveInput, UseAutosaveResult, UseBroadcastFollowerInput, UseCanvasInteractionsInput, UseCollaborativeHistoryInput, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UseContentLifecycleInput, UseDerivedElementStateInput, UseDerivedSlideStateInput, UseDialogCustomShowsInput, UseDialogCustomShowsResult, UseEditorOperationsInput, UseElementManipulationInput, UseElementOperationsInput, UseExportHandlersInput, UseExportSaveAsInput, UseFollowModeInput, UseFollowModeResult, UseFontInjectionInput, UseIOHandlersInput, UseInsertElementsInput, UseIsMobileResult, UseKeyboardInsetsResult, UseKeyboardShortcutWiringInput, UseKeyboardShortcutsInput, UseLayoutSwitchingInput, UseLoadContentInput, UseLoadContentResult, UsePointerHandlersInput, UsePresenceTrackingInput, UsePresenceTrackingResult, UsePresentationAnnotationsResult, UsePresentationSetupInput, UsePresenterWindowInput, UsePresenterWindowResult, UsePrintHandlersInput, UsePropertyHandlersInput, UseRecoveryDetectionInput, UseReducedMotionResult, UseRehearsalTimingsInput, UseRehearsalTimingsResult, UseResizablePanelsResult, UseSectionOperationsInput, UseSerializeInput, UseSlideManagementInput, UseSlideNavigationInput, UseSlideNavigationResult, UseSwipeNavigationInput, UseSwipeNavigationResult, UseTableOperationsInput, UseThemeHandlersInput, UseThemeSwitchingInput, UseTouchGesturesInput, UseViewerBuildingBlocksInput, UseViewerCoreStateInput, UseViewerDialogsInput, UseViewerIntegrationInput, UseViewerOptionsResult, UseViewerStateInput, UseYjsDocumentSyncInput, UseYjsProviderInput, UseYjsProviderResult, UseZoomNavigationInput, UseZoomNavigationResult, UserPresence, ViewerBuildingBlocksResult, ViewerCoreState, ViewerDialogsResult, ViewerIntegrationResult, ViewerState, ViewerUIState, VirtualizedSlidesOptions, VirtualizedSlidesResult };