pptx-react-viewer 2.14.0 → 2.15.0

package/dist/viewer/index.d.ts

@@ -8566,6 +8566,64 @@ interface ViewerFontSource {
   weight?: string | number;
   style?: 'normal' | 'italic';
 }
+//#endregion
+//#region src/render/session-restore.d.ts
+/**
+ * session-restore: keep the deck a host app has open across a page refresh.
+ *
+ * A host (the demo apps, or any embedder) owns the bytes it hands to the
+ * viewer, so a plain reload drops them and the user lands back on the file
+ * dropzone with their presentation gone. This store remembers the open deck in
+ * IndexedDB and hands it back on the next load.
+ *
+ * Scope is deliberately per-tab: the record is keyed by an id kept in
+ * `sessionStorage`, which survives a reload but NOT a new tab. Refreshing
+ * restores the deck this tab had open, while a second tab opened on the same
+ * origin still starts on the landing page, and two tabs holding different decks
+ * never steal each other's content.
+ *
+ * `restoreSessionDeck` additionally prefers a NEWER autosave snapshot for the
+ * same file (see `./autosave-store`), so a refresh mid-edit comes back with the
+ * edited deck rather than the pristine bytes that were first opened.
+ *
+ * Every operation is best-effort: a blocked IndexedDB, a partitioned
+ * `sessionStorage`, or an exhausted quota degrades to "no restore", never to a
+ * thrown error in the host.
+ */
+/** A deck remembered for the current tab. */
+interface SessionDeck {
+  /** File name the deck was opened under, used as the autosave key. */
+  fileName: string;
+  /** The presentation bytes. */
+  data: Uint8Array;
+  /** When these bytes were remembered (epoch ms). */
+  timestamp: number;
+}
+/**
+ * This tab's session id, or `null` when `sessionStorage` is unavailable (a
+ * sandboxed iframe, or a browser with storage disabled).
+ *
+ * @param create Mint and persist an id when the tab does not have one yet.
+ *   Reads pass `false` so a fresh tab never claims another tab's record.
+ */
+declare function getSessionTabId(create?: boolean): string | null;
+/**
+ * Remember `data` as the deck this tab has open, so the next load can restore
+ * it. Resolves `false` when the browser refused to store it; callers treat that
+ * as "no restore available later", never as an error.
+ */
+declare function rememberSessionDeck(fileName: string, data: Uint8Array): Promise<boolean>;
+/** The deck remembered for this tab, or `null` when there is nothing to restore. */
+declare function loadSessionDeck(): Promise<SessionDeck | null>;
+/** Forget this tab's deck (the host closed it, or handed the tab to another flow). */
+declare function forgetSessionDeck(): Promise<void>;
+/**
+ * The deck to reopen on load: this tab's remembered bytes, upgraded to a newer
+ * autosave snapshot of the same file when the viewer wrote one after they were
+ * remembered. Without that upgrade a refresh mid-edit would silently roll the
+ * presentation back to the state it was opened in.
+ */
+declare function restoreSessionDeck(): Promise<SessionDeck | null>;
 /**
  * Store PPTX content bytes so the audience tab can retrieve them.
  * Called by the presenter before opening the audience window.
@@ -9752,5 +9810,5 @@ interface CollaborationStatusIndicatorProps {
 }
 declare function CollaborationStatusIndicator({ status, connectedCount, onRetry }: CollaborationStatusIndicatorProps): React__default.ReactElement;
 
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar, clearAudienceContent, getAnimationInitialStyle, isAudienceTab, loadAudienceContent, parseAudienceNonce, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider };
-export type { AccessibilityIssue, AnimationPresetOption, CanvasSize, CollaborationConfig, CollaborationContextValue, CollaborationRole, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementClipboardPayload, ElementContextMenuAction, ElementContextMenuState, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence, ViewerMode };
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar, clearAudienceContent, forgetSessionDeck, getAnimationInitialStyle, getSessionTabId, isAudienceTab, loadAudienceContent, loadSessionDeck, parseAudienceNonce, rememberSessionDeck, restoreSessionDeck, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider };
+export type { AccessibilityIssue, AnimationPresetOption, CanvasSize, CollaborationConfig, CollaborationContextValue, CollaborationRole, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementClipboardPayload, ElementContextMenuAction, ElementContextMenuState, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, SessionDeck, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence, ViewerMode };

package/dist/viewer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/viewer/components/collaboration/CollaborationProvider.tsx","../../src/viewer/components/collaboration/RemoteUserCursors.tsx","../../src/viewer/components/collaboration/UserAvatarBar.tsx","../../src/viewer/components/collaboration/CollaborationStatusIndicator.tsx"],"mappings":";;;;;;UA2CiB;;EAEhB,SAAS;EACT;EACA;EACA,UAAU,MAAM;;iBAGD,wBACf,QACA,aACA,cACA,YACE,6BAA6B,MAAM;;;UCtCrB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;iBAOe,oBACf,aACA,kBACA,aACA,gBACE,yBAAyB,MAAM;;;UCRjB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;iBAqDe,gBACf,aACA,eACA,gBACA,iBACA,QACA,cACE,qBAAqB,MAAM;;;UCrFb;;EAEhB,QAAQ;;EAER;;EAEA;;iBAkCe,+BACf,QACA,gBACA,WACE,oCAAoC,MAAM"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/viewer/components/collaboration/CollaborationProvider.tsx","../../src/viewer/components/collaboration/RemoteUserCursors.tsx","../../src/viewer/components/collaboration/UserAvatarBar.tsx","../../src/viewer/components/collaboration/CollaborationStatusIndicator.tsx"],"mappings":";;;;;;;UA2CiB;;EAEhB,SAAS;EACT;EACA;EACA,UAAU,MAAM;;iBAGD,wBACf,QACA,aACA,cACA,YACE,6BAA6B,MAAM;;;UCtCrB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;iBAOe,oBACf,aACA,kBACA,aACA,gBACE,yBAAyB,MAAM;;;UCRjB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;iBAqDe,gBACf,aACA,eACA,gBACA,iBACA,QACA,cACE,qBAAqB,MAAM;;;UCrFb;;EAEhB,QAAQ;;EAER;;EAEA;;iBAkCe,+BACf,QACA,gBACA,WACE,oCAAoC,MAAM"}

package/dist/viewer/index.js

@@ -1,76 +1,96 @@
 'use strict';
 
-var chunkHOIF5RQI_js = require('../chunk-HOIF5RQI.js');
-require('../chunk-QVQDC7HZ.js');
-var chunk7TEZJZ2O_js = require('../chunk-7TEZJZ2O.js');
-var chunkSMECSYCT_js = require('../chunk-SMECSYCT.js');
+var chunkN6MSPBMO_js = require('../chunk-N6MSPBMO.js');
+require('../chunk-CUFEHK42.js');
+var chunkTQMJGYGQ_js = require('../chunk-TQMJGYGQ.js');
+var chunkHZSUTVDQ_js = require('../chunk-HZSUTVDQ.js');
 require('../chunk-3ISYPBSX.js');
-var chunkPB7KVDNV_js = require('../chunk-PB7KVDNV.js');
+var chunkKA35ZMIP_js = require('../chunk-KA35ZMIP.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkHOIF5RQI_js.CollaborationProvider; }
+  get: function () { return chunkN6MSPBMO_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkHOIF5RQI_js.CollaborationStatusIndicator; }
+  get: function () { return chunkN6MSPBMO_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkHOIF5RQI_js.PowerPointViewer; }
+  get: function () { return chunkN6MSPBMO_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkHOIF5RQI_js.RemoteUserCursors; }
+  get: function () { return chunkN6MSPBMO_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkHOIF5RQI_js.UserAvatarBar; }
+  get: function () { return chunkN6MSPBMO_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunk7TEZJZ2O_js.isAudienceTab; }
+  get: function () { return chunkTQMJGYGQ_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunk7TEZJZ2O_js.parseAudienceNonce; }
+  get: function () { return chunkTQMJGYGQ_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunk7TEZJZ2O_js.useCollaborativeHistory; }
+  get: function () { return chunkTQMJGYGQ_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunk7TEZJZ2O_js.useCollaborativeState; }
+  get: function () { return chunkTQMJGYGQ_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunk7TEZJZ2O_js.usePresenceTracking; }
+  get: function () { return chunkTQMJGYGQ_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunk7TEZJZ2O_js.useThemeSwitching; }
+  get: function () { return chunkTQMJGYGQ_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunk7TEZJZ2O_js.useYjsProvider; }
+  get: function () { return chunkTQMJGYGQ_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkSMECSYCT_js.getAnimationInitialStyle; }
+  get: function () { return chunkHZSUTVDQ_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkPB7KVDNV_js.clearAudienceContent; }
+  get: function () { return chunkKA35ZMIP_js.clearAudienceContent; }
+});
+Object.defineProperty(exports, "forgetSessionDeck", {
+  enumerable: true,
+  get: function () { return chunkKA35ZMIP_js.forgetSessionDeck; }
+});
+Object.defineProperty(exports, "getSessionTabId", {
+  enumerable: true,
+  get: function () { return chunkKA35ZMIP_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkPB7KVDNV_js.loadAudienceContent; }
+  get: function () { return chunkKA35ZMIP_js.loadAudienceContent; }
+});
+Object.defineProperty(exports, "loadSessionDeck", {
+  enumerable: true,
+  get: function () { return chunkKA35ZMIP_js.loadSessionDeck; }
+});
+Object.defineProperty(exports, "rememberSessionDeck", {
+  enumerable: true,
+  get: function () { return chunkKA35ZMIP_js.rememberSessionDeck; }
+});
+Object.defineProperty(exports, "restoreSessionDeck", {
+  enumerable: true,
+  get: function () { return chunkKA35ZMIP_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkPB7KVDNV_js.storeAudienceContent; }
+  get: function () { return chunkKA35ZMIP_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-GROIHKI5.mjs';
-import '../chunk-2KRHLUCG.mjs';
-export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-T4NHPN76.mjs';
-export { getAnimationInitialStyle } from '../chunk-R7MGJCZN.mjs';
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-SHICB6DW.mjs';
+import '../chunk-WMZAM3UH.mjs';
+export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-PDUTW6MW.mjs';
+export { getAnimationInitialStyle } from '../chunk-56L4QYDT.mjs';
 import '../chunk-5YV26HMJ.mjs';
-export { clearAudienceContent, loadAudienceContent, storeAudienceContent } from '../chunk-5MMC7ZR3.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-3JTRZVYW.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "2.14.0",
+	"version": "2.15.0",
 	"description": "React PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",
@@ -78,7 +78,7 @@
 		"clsx": "^2.1.1",
 		"dompurify": "^3.4.12",
 		"html2canvas-pro": "^2.3.2",
-		"pptx-viewer-mcp": "^2.0.2",
+		"pptx-viewer-mcp": "^2.1.0",
 		"tailwind-merge": "^3.6.0"
 	},
 	"devDependencies": {