pptx-svelte-viewer 4.46.0 → 4.47.0

package/dist/viewer/index.d.ts

@@ -1,12 +1,12 @@
 import * as svelte from 'svelte';
 import { Component } from 'svelte';
 import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
-import { PrintSettings, CanvasSize, RasterizeElementResult, RasterizeElementTilesResult, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, ToolbarActionId, RibbonAddInTab, ViewerCustomization, CollaborationInput, CollaborationConfig, CollaborationState, PowerPointViewerAPI, ViewerCustomizationApi, RemoteCursor, SanitizedPresence, DeckSaveIntent, AnimationGroup, AlignEdge, DistributeAxis, MergeShapeOperation, PasteSpecialFormat, CropSession, CropElementUpdate, TemplateElementMap, ElementBoxPatch, InkStrokeView, InkPoint, MasterViewCrudAction, MasterViewCrudActionId, FreeformToolKind, EditPointsElementPatch, SlideTemplateId, SlideTemplateBuildOptions, SlidePasteRequest, RibbonTransitionDraft, CellCoord, CellRect, PendingInlineTextEdit, InlineListController, ElementClipboardPayload, TableStyleSaveOptions, FontEmbeddingDescriptor, InlineTextEditSnapshot, SnapGuideInput, CollaborationLivePatcher, ResolvedKeyboardCustomization, MarqueeRect, ShapeAdjustmentHandleDescriptor, SnapLine, ResizeHandleId, ConnectorEndpointKind, CollaborationInlineEditor, FindResult, ViewerPreferences, ViewportFitPadding, SlideSizeEmu, CollabLoadOrigin, AwarenessLike, CollaborationTransport, YDocLike, YjsFactories, ConnectionStatus, BroadcastConfig, ElementAnimationState, AuthoredSlideRange, RunProgramNotice, ZoomNavigationTarget, PresentationSnapshot, AutosaveRecoveryPrompt, CompatibilityWarningToast, ReadOnlyRecommendation, ModifyPasswordCheckResult, ViewerOptions, ViewerOptionsStoreInit, ToolbarTabId, ViewerOptionsGroupId, ViewerOptionPrimitive, ViewerOptionsConstraints, CompareResult, Guide, DeckViewPreferences, ResolvedCustomization, ViewerMode, CollaborationShellState, AutosaveDisabledReason, MobileSheetKey, FieldSubstitutionContext } from 'ooxml-ui/pptx';
+import { PrintSettings, CanvasSize, RasterizeElementResult, RasterizeElementTilesResult, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, ToolbarActionId, RibbonAddInTab, ViewerCustomization, DocumentStorage, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, CollaborationInput, CollaborationConfig, CollaborationState, PowerPointViewerAPI, ViewerCustomizationApi, RemoteCursor, SanitizedPresence, DeckSaveIntent, AnimationGroup, AlignEdge, DistributeAxis, MergeShapeOperation, PasteSpecialFormat, CropSession, CropElementUpdate, TemplateElementMap, ElementBoxPatch, InkStrokeView, InkPoint, MasterViewCrudAction, MasterViewCrudActionId, FreeformToolKind, EditPointsElementPatch, SlideTemplateId, SlideTemplateBuildOptions, SlidePasteRequest, RibbonTransitionDraft, CellCoord, CellRect, PendingInlineTextEdit, InlineListController, ElementClipboardPayload, TableStyleSaveOptions, FontEmbeddingDescriptor, InlineTextEditSnapshot, SnapGuideInput, CollaborationLivePatcher, ResolvedKeyboardCustomization, MarqueeRect, ShapeAdjustmentHandleDescriptor, SnapLine, ResizeHandleId, ConnectorEndpointKind, CollaborationInlineEditor, FindResult, ViewerPreferences, ViewportFitPadding, SlideSizeEmu, CollabLoadOrigin, AwarenessLike, CollaborationTransport, YDocLike, YjsFactories, BroadcastConfig, ElementAnimationState, AuthoredSlideRange, RunProgramNotice, ZoomNavigationTarget, PresentationSnapshot, AutosaveRecoveryPrompt, CompatibilityWarningToast, ReadOnlyRecommendation, ModifyPasswordCheckResult, ViewerOptions, ViewerOptionsStoreInit, ToolbarTabId, ViewerOptionsGroupId, ViewerOptionPrimitive, ViewerOptionsConstraints, CompareResult, Guide, DeckViewPreferences, ResolvedCustomization, ViewerMode, CollaborationShellState, AutosaveDisabledReason, MobileSheetKey, FieldSubstitutionContext } from 'ooxml-ui/pptx';
 export { CanvasSize, CollaborationShellState, CollaborationState, ConnectionStatus, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, InlineListController, InlineListReadResult, InlineTextEditSnapshot, RemoteCursor, SanitizedPresence, ViewerTheme, zoomInPercent, zoomOutPercent } from 'ooxml-ui/pptx';
 import { PptxAiConfig, PptxAiNotifyLevel, PptxAiBridge, PptxAiFocusedTarget, AiChangeBatch, AiCanvasHighlight, ToolCanvasTarget } from 'ooxml-ui/pptx/ai';
 export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
 import { LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
-import { PptxSlide, PptxData, SvgExportOptions, PptxSaveFormat, PptxElement, PptxChartData, PptxComment, PptxSlideMaster, PptxNotesMaster, PptxHandoutMaster, PptxSection, PptxHandler, PptxAnimationPreset, PptxHeaderFooter, PptxPresentationProperties, PptxCustomShow, PptxCoreProperties, PptxAppProperties, PptxCustomProperty, PptxTagCollection, TextSegment, MasterViewTab, ShapePptxElement, PptxLayoutOption, PptxLayoutPreview, PptxTransitionType, PptxSlideTransition, PptxTableData, PptxTheme, PptxViewProperties, PptxModernCommentAuthor, PptxCommentAuthor, PptxSlideSize, ParsedTableStyleMap, PptxModifyVerifier, PptxCompatibilityWarning, PptxEmbeddedFont, PptxThemeOption, PptxThemeColorScheme, PptxHandlerLoadOptions, PptxHandlerSaveOptions } from 'ooxml-core/pptx';
+import { PptxSlide, PptxData, SvgExportOptions, PptxCoreProperties, PptxSaveFormat, PptxElement, PptxChartData, PptxComment, PptxSlideMaster, PptxNotesMaster, PptxHandoutMaster, PptxSection, PptxHandler, PptxAnimationPreset, PptxHeaderFooter, PptxPresentationProperties, PptxCustomShow, PptxAppProperties, PptxCustomProperty, PptxTagCollection, TextSegment, MasterViewTab, ShapePptxElement, PptxLayoutOption, PptxLayoutPreview, PptxTransitionType, PptxSlideTransition, PptxTableData, PptxTheme, PptxViewProperties, PptxModernCommentAuthor, PptxCommentAuthor, PptxSlideSize, ParsedTableStyleMap, PptxModifyVerifier, PptxCompatibilityWarning, PptxEmbeddedFont, PptxThemeOption, PptxThemeColorScheme, PptxHandlerLoadOptions, PptxHandlerSaveOptions } from 'ooxml-core/pptx';
 
 /**
  * Animated-GIF export capture/encode pipeline. All the pure logic is shared:
@@ -415,6 +415,12 @@ interface PowerPointViewerProps extends ViewportFitOptions {
      * the toolbar. Default false (read-only viewer).
      */
     editable?: 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;
     /** Optional class name applied to the root element. */
     class?: string;
     /** Optional display name shown in the desktop title bar. */
@@ -498,8 +504,29 @@ interface PowerPointViewerProps extends ViewportFitOptions {
      * @default 120000 (Options > Save, "every 2 minutes")
      */
     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 serialized `.pptx` bytes after each successful autosave. */
     onautosave?: (bytes: Uint8Array) => 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 with the changed fields when the user edits the document properties. */
+    onpropertieschange?: (updates: Partial<PptxCoreProperties>) => 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;
     /**
      * Real-time collaboration configuration. When provided, the viewer connects
      * to the room (y-websocket or serverless y-webrtc), publishes local edits
@@ -800,6 +827,8 @@ interface AutosaveDeps {
     getIntervalMs: () => number;
     /** IndexedDB record key (host `filePath`); autosave is disabled without one. */
     getFilePath: () => string | undefined;
+    /** Host `storage` prop: recovery snapshots go to its recovery methods when it has them. */
+    getStorage?: () => DocumentStorage | undefined;
     /** The current editable slides (watched for edits). */
     getSlides: () => PptxSlide[];
     /**
@@ -1692,6 +1721,8 @@ interface EditorStateDeps {
      */
     setHandler?: (handler: PptxHandler, keepPrevious?: boolean, data?: PptxData) => void;
     onChange?: () => void;
+    /** The host's `onpropertieschange`: the core fields a user edit changed. */
+    onCorePropertiesChange?: (updates: Partial<PptxCoreProperties>) => void;
 }
 declare class EditorState {
     #private;
@@ -1963,7 +1994,12 @@ declare class EditorState {
     nudgeSelected: (dx: number, dy: number) => void;
     commitInlineText: (id: string, text: string, snapshot?: InlineTextEditSnapshot) => void;
     commitNotes: (notes: string, notesSegments?: TextSegment[]) => void;
-    updateDocumentProperties(core: PptxCoreProperties, app: PptxAppProperties, custom: PptxCustomProperty[]): void;
+    /**
+     * Replace the document properties as one undoable edit. `reported` is what the host's
+     * `onpropertieschange` hears (the dialog's saved core by default); pass `null` for an
+     * edit that is not a user change to the core properties (app or custom ones, the AI).
+     */
+    updateDocumentProperties(core: PptxCoreProperties, app: PptxAppProperties, custom: PptxCustomProperty[], reported?: Partial<PptxCoreProperties> | null): void;
     /**
      * Seed the deck's tag parts straight after a load. Deliberately NOT an undo
      * step: the load already cleared history, and treating the parsed value as
@@ -2346,6 +2382,9 @@ interface RibbonProps {
     onundo: () => void;
     onredo: () => void;
     onsave: () => void;
+    /** File > Save (backstage Save item); falls back to {@link ondownload}. */
+    onsavefile?: () => void;
+    /** Save As > PowerPoint Presentation (.pptx). */
     ondownload: () => void;
     ondownloadppsx: () => void;
     ondownloadpptm: () => void;
@@ -2884,7 +2923,9 @@ interface EditingApi {
     deleteSelected(): void;
     getSelectedElementId(): string | null;
     save(format?: PptxSaveFormat): Promise<Uint8Array>;
+    /** Save As `format` (reported to host storage as `saveAs`). */
     downloadAs(format: PptxSaveFormat, fileName?: string): Promise<void>;
+    /** File > Save as `.pptx` (reported to host storage as `save`). */
     downloadPptx(fileName?: string): Promise<void>;
 }
 
@@ -3259,6 +3300,8 @@ interface AutosaveRecoveryDeps {
     getFilePath: () => string | undefined;
     /** Public document name rendered in the recovery message. */
     getFileName?: () => string | undefined;
+    /** Host `storage` prop: recovery snapshots go to its recovery methods when it has them. */
+    getStorage?: () => DocumentStorage | undefined;
     /**
      * Whether recovery snapshots are permitted at all, which is the HOST prop
      * (`autosave !== false`) and not the user's toggle: someone who merely
@@ -3273,6 +3316,8 @@ interface AutosaveRecoveryDeps {
     getLoadCount: () => number;
     /** The loader's own load path, the same one the backstage recent list uses. */
     load: (bytes: Uint8Array) => Promise<void> | void;
+    /** The host's `onautosaverecovery`: called with the record when a snapshot is offered. */
+    onOffered?: (record: AutosaveRecord) => void;
 }
 declare class AutosaveRecoveryController {
     #private;
@@ -3311,8 +3356,10 @@ declare class CompatToastsState {
     get overflowCount(): number;
     dismiss(id: string): void;
     dismissAll(): void;
-    /** Clear the dismissal state for a newly loaded document. */
+    /** Clear the dismissal state (and any notice) for a newly loaded document. */
     reset(): void;
+    /** Show a notice (a failed Save) in the stack; shown again if it was dismissed. */
+    notify(toast: CompatibilityWarningToast): void;
 }
 
 /** Live viewer accessors + the panel-open hook the controller closes over. */
@@ -3499,7 +3546,12 @@ declare class ViewerOptionsState {
      * `resolveAutosaveIntervalMs` in shared, not re-invented here.
      */
     get autosaveIntervalSeconds(): number;
-    /** Options > Save > "Delete cached files": drop all recovery snapshots. */
+    /** Wire the host `storage` prop, so the cache sweeps run against the host's recovery store. */
+    bindStorage(storage: () => DocumentStorage | undefined): void;
+    /**
+     * Options > Save > "Delete cached files": drop all recovery snapshots (IndexedDB, or the
+     * host's recovery store when it lists its copies; otherwise retention is the host's job).
+     */
     clearCache(): Promise<void>;
     /**
      * Options > Save > "keep the last AutoRecover version": whether a
@@ -3714,6 +3766,8 @@ interface CreateViewerStateOptions {
     getAutosave: () => boolean | undefined;
     autosaveIntervalMs?: number;
     getFilePath: () => string | undefined;
+    /** Host `storage` prop: Save goes to `storage.save()`; recovery copies to its recovery methods. */
+    getStorage?: () => DocumentStorage | undefined;
     /** Host `authorName` prop: comment/reply author and the broadcast presenter name. */
     getAuthorName?: () => string | undefined;
     getInitialSlide: () => number;
@@ -3754,6 +3808,11 @@ interface CreateViewerStateOptions {
     onautosave?: (bytes: Uint8Array) => void;
     /** Fired when the host toggles AutoSave (title bar / Settings dialog). */
     onautosavetoggle?: (enabled: boolean) => void;
+    onautosavestatus?: (status: ViewerAutosaveStatus) => void;
+    onautosaverecovery?: (record: AutosaveRecord) => void;
+    onpropertieschange?: (updates: Partial<PptxCoreProperties>) => void;
+    onpresentationchange?: (presenting: boolean) => void;
+    oncollaborationstatus?: (status: ConnectionStatus) => void;
     onstartcollaboration?: (config: CollaborationConfig) => void;
     oncollaborationchange?: (state: CollaborationState) => void;
     onstopcollaboration?: () => void;

package/dist/viewer/index.js

@@ -1,5 +1,5 @@
-import "../transition-overlay-Ca1_ksUi.js";
-import { S as e, _ as a, a as S, b as o, c as v, d as n, f as d, g as r, h as b, i as p, l as c, m, n as g, o as x, p as w, r as C, s as T, t as $, u as y, v as s, x as t } from "../export-BK-HTwwB.js";
+import "../transition-overlay-C-ut2gr6.js";
+import { S as e, _ as a, a as S, b as o, c as v, d as n, f as d, g as r, h as b, i as p, l as c, m, n as g, o as x, p as w, r as C, s as T, t as $, u as y, v as s, x as t } from "../export-Bh9pAUzY.js";
 var P = e, V = t, u = s, A = a, R = r, f = o;
 export {
   A as CollaborationCursors,

package/dist/{y-webrtc-Bg6u2mji.js → y-webrtc-CFOloTcS.js}

@@ -1,4 +1,4 @@
-import { M as Fe, N as pr, j as gr } from "./transition-overlay-Ca1_ksUi.js";
+import { M as Fe, N as pr, j as gr } from "./transition-overlay-C-ut2gr6.js";
 import { $ as yr, A as br, B as Ct, D as mr, E as ut, F as _r, G as Ye, H as vr, I as Mt, J as je, K as wr, L as lt, M as se, O as Er, P as ae, R as ce, S as Cr, T as Rr, U as Rt, V as Sr, W as St, X as Tr, Y as ht, Z as Ar, _ as kr, a as Or, at as xr, b as Ge, c as Nr, d as Lr, et as Mr, f as Dr, g as Ir, i as Tt, it as Pr, j as it, k as Dt, l as jr, m as Ur, n as Br, nt as ft, o as It, ot as Fr, p as $r, q as Pt, r as $e, rt as jt, s as qr, st, t as Wr, tt as dt, u as Hr, v as Vr, w as Ut, x as Yr, y as Gr, z as Le } from "./awareness-BwmJcSKy.js";
 import "yjs";
 var zr = 1200, Kr = 2500, qe = 3e4, ot = (r) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-svelte-viewer",
-	"version": "4.46.0",
+	"version": "4.47.0",
 	"description": "pptx-viewer for Svelte 5: a PowerPoint viewer and editor component to render, edit, present, and export PPTX slides in the browser.",
 	"keywords": [
 		"office",
@@ -116,8 +116,8 @@
 		"html2canvas-pro": "^2.5.2",
 		"jspdf": "^4.2.1",
 		"jszip": "^3.10.2",
-		"ooxml-core": "^1.23.0",
-		"ooxml-ui": "^1.22.0",
+		"ooxml-core": "^1.24.0",
+		"ooxml-ui": "^1.23.0",
 		"opentype.js": "^2.0.0"
 	},
 	"devDependencies": {