pptx-svelte-viewer 4.74.0 → 4.75.0

package/dist/viewer/index.d.ts

@@ -1,7 +1,7 @@
 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, GoogleFontsOption, ListConversionScope, PptxLoadLimits, ToolbarActionId, RibbonAddInTab, ViewerCustomization, DocumentStorage, CloudFileProvider, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, CollaborationInput, CollaborationConfig, CollaborationState, PowerPointViewerAPI, ViewerCustomizationApi, RemoteCursor, SanitizedPresence, PptxAutosaveStatusKind, DeckSaveIntent, InlineTextDraft, AnimationGroup, AlignEdge, DistributeAxis, MergeShapeOperation, PasteSpecialFormat, CropSession, CropElementUpdate, TemplateElementMap, HistoryTheme, ElementBoxPatch, EditorHistoryController, InkStrokeView, InkPoint, MasterViewCrudAction, MasterViewCrudActionId, FreeformToolKind, EditPointsElementPatch, SlideTemplateId, SlideTemplateBuildOptions, SlidePasteRequest, RibbonTransitionDraft, CellCoord, CellRect, PendingInlineTextEdit, InlineListController, ElementClipboardPayload, TableStyleSaveOptions, FontEmbeddingDescriptor, InlineTextEditSnapshot, SnapGuideInput, CollaborationLivePatcher, InlineTextDraftSink, ResolvedKeyboardCustomization, MarqueeRect, ShapeAdjustmentHandleDescriptor, SnapLine, ResizeHandleId, ConnectorEndpointKind, CollaborationInlineEditor, FindResult, ViewerPreferences, CollaborationTransport, YDocLike, YjsFactories, CollabProviderHandle, CollaborationHistoryTarget, CollabLoadOrigin, BroadcastConfig, ElementAnimationState, AuthoredSlideRange, RunProgramNotice, ZoomNavigationTarget, PresentationSnapshot, AutosaveRecoveryPrompt, CompatibilityWarningToast, SlideSizeEmu, DeckWebfontProgress, LoadLimitTranslate, ReadOnlyRecommendation, ReadOnlyBannerPasswordError, ViewerOptions, ViewerOptionsStoreInit, ToolbarTabId, ViewerOptionsGroupId, ViewerOptionPrimitive, ViewerOptionsConstraints, CompareResult, Guide, DeckViewPreferences, CloudDocumentController, SaveProgressController, ResolvedCustomization, ViewerMode, ViewportFitPadding, CollaborationShellState, AutosaveDisabledReason, MobileSheetKey, FieldSubstitutionContext, SlidesPaneLayoutGalleryRequest } from 'ooxml-ui/pptx';
+import { PrintSettings, CanvasSize, RasterizeElementResult, RasterizeElementTilesResult, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, GoogleFontsOption, ListConversionScope, PptxLoadLimits, ToolbarActionId, RibbonAddInTab, RibbonDisplayMode, ViewerCustomization, DocumentStorage, CloudFileProvider, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, CollaborationInput, CollaborationConfig, CollaborationState, PowerPointViewerAPI, ViewerCustomizationApi, RemoteCursor, SanitizedPresence, PptxAutosaveStatusKind, DeckSaveIntent, InlineTextDraft, AnimationGroup, AlignEdge, DistributeAxis, MergeShapeOperation, PasteSpecialFormat, CropSession, CropElementUpdate, TemplateElementMap, HistoryTheme, ElementBoxPatch, EditorHistoryController, InkStrokeView, InkPoint, MasterViewCrudAction, MasterViewCrudActionId, FreeformToolKind, EditPointsElementPatch, SlideTemplateId, SlideTemplateBuildOptions, SlidePasteRequest, RibbonTransitionDraft, CellCoord, CellRect, PendingInlineTextEdit, InlineListController, ElementClipboardPayload, TableStyleSaveOptions, FontEmbeddingDescriptor, InlineTextEditSnapshot, SnapGuideInput, CollaborationLivePatcher, InlineTextDraftSink, ResolvedKeyboardCustomization, MarqueeRect, ShapeAdjustmentHandleDescriptor, SnapLine, ResizeHandleId, ConnectorEndpointKind, CollaborationInlineEditor, FindResult, RibbonDisplayController, ViewerPreferences, CollaborationTransport, YDocLike, YjsFactories, CollabProviderHandle, CollaborationHistoryTarget, CollabLoadOrigin, BroadcastConfig, PptxSaveSnapshot, PptxSaveAcknowledgement, ElementAnimationState, AuthoredSlideRange, RunProgramNotice, ZoomNavigationTarget, PresentationSnapshot, AutosaveRecoveryPrompt, CompatibilityWarningToast, SlideSizeEmu, DeckWebfontProgress, LoadLimitTranslate, ReadOnlyRecommendation, ReadOnlyBannerPasswordError, ViewerOptions, ViewerOptionsStoreInit, ToolbarTabId, ViewerOptionsGroupId, ViewerOptionPrimitive, ViewerOptionsConstraints, CompareResult, Guide, DeckViewPreferences, CloudDocumentController, SaveProgressController, ResolvedCustomization, ViewerMode, ViewportFitPadding, CollaborationShellState, AutosaveDisabledReason, MobileSheetKey, FieldSubstitutionContext, SlidesPaneLayoutGalleryRequest } from 'ooxml-ui/pptx';
 export { CanvasSize, CollaborationShellState, CollaborationState, ConnectionStatus, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, InlineListController, InlineListReadResult, InlineTextEditSnapshot, RemoteCursor, SanitizedPresence, SlidesPaneLayoutGalleryRequest, ViewerTheme, zoomInPercent, zoomOutPercent } from 'ooxml-ui/pptx';
 import { PptxAiConfig, PptxAiBridge } from 'ooxml-ui/pptx/ai';
 export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
@@ -370,6 +370,13 @@ interface PowerPointViewerProps extends ViewportFitOptions {
      * drawn as its items. The desktop ribbon shows them; the phone chrome does not.
      */
     ribbonAddIns?: readonly RibbonAddInTab[];
+    /**
+     * Starting Ribbon Display Options mode: `always` (Always show Ribbon, the
+     * default), `tabs` (Show tabs only) or `fullScreen` (Full-screen mode).
+     * Changing it from the host applies the mode; the user's own choices are
+     * reported through `onribbondisplaychange`.
+     */
+    ribbonDisplay?: RibbonDisplayMode;
     /**
      * Framework-neutral UI customisation. See docs/guide/customization.md.
      *
@@ -501,6 +508,12 @@ interface PowerPointViewerProps extends ViewportFitOptions {
     /** Fired before following a link; return false to cancel its default action. */
     onhyperlinkclick?: ooxml_ui_pptx.HyperlinkClickHandler;
     onzoomchange?: (zoom: number) => void;
+    /**
+     * Fired when the user picks a Ribbon Display Options mode (the menu on the
+     * tab row, Ctrl+F1, or a double click on a tab). Not fired when the host
+     * changes `ribbonDisplay`.
+     */
+    onribbondisplaychange?: (mode: RibbonDisplayMode) => void;
     onselectionchange?: (elementIds: string[]) => void;
     onslidecountchange?: (count: number) => void;
     /** Host override for the File > Open action. */
@@ -2452,6 +2465,8 @@ declare class ChromeUiState {
  */
 interface RibbonProps {
     fileName?: string;
+    /** Ribbon Display Options: the viewer's one controller (menu, peek, collapse). */
+    ribbonDisplay: RibbonDisplayController;
     /** History-tracked editor state; Home/Insert tab groups read/write it directly. */
     editor: EditorState;
     /** Reactive Find & Replace panel state, owned by the host so it can navigate the viewer. */
@@ -2752,7 +2767,7 @@ declare class ViewerState {
  * `PowerPointViewer` instance API. The undo/redo/save half lives in
  * `editing-api.ts` and the export half in `export/exporting-api.ts`.
  */
-type DeckApi = Omit<PowerPointViewerAPI, 'getContent' | 'undo' | 'redo' | 'canUndo' | 'canRedo'>;
+type DeckApi = Omit<PowerPointViewerAPI, 'getContent' | 'undo' | 'redo' | 'canUndo' | 'canRedo' | 'getSaveRevision' | 'getSaveSnapshot' | 'acknowledgeSave'>;
 
 /** The imperative editing API exposed on the `PowerPointViewer` instance. */
 interface EditingApi {
@@ -2767,6 +2782,12 @@ interface EditingApi {
     downloadAs(format: PptxSaveFormat, fileName?: string): Promise<void>;
     /** File > Save as `.pptx` (reported to host storage as `save`). */
     downloadPptx(fileName?: string): Promise<void>;
+    /** The revision of the document as it is now (see `createSaveRevisionController`). */
+    getSaveRevision(): number;
+    /** Serialise for a host that persists the deck itself; leaves the document dirty. */
+    getSaveSnapshot(): Promise<PptxSaveSnapshot>;
+    /** The host persisted `revision`: clean only if it is still current. */
+    acknowledgeSave(revision: number): PptxSaveAcknowledgement;
 }
 
 /**

package/dist/viewer/index.js

@@ -1,28 +1,28 @@
-import { C as a, S as o, _ as s, a as r, b as i, c as t, d as l, f as S, g as n, h as d, i as p, l as v, m as c, n as m, o as b, p as g, r as x, s as P, t as w, u as T, v as u, w as y, x as A, y as C } from "../export-BSqJw7u_.js";
+import { C as a, D as o, E as s, S as r, T as i, _ as t, a as l, b as S, c as n, d, g as v, h as p, i as c, l as m, m as b, n as g, o as x, r as P, s as T, t as w, v as y, w as A, x as C, y as V } from "../export-CVudgvaM.js";
 import "../transition-overlay-SNUzj4xJ.js";
 export {
-  m as CollaborationCursors,
-  x as EditorLayer,
-  T as PowerPointViewer,
-  g as PresentationLoader,
-  p as RemoteSelectionOverlay,
-  r as Ribbon,
-  b as SlideCanvas,
-  P as SlideThumbnail,
-  t as SlidesPane,
-  S as ViewerState,
-  v as ViewerToolbar,
-  C as clampSlideIndex,
+  g as CollaborationCursors,
+  P as EditorLayer,
+  d as PowerPointViewer,
+  v as PresentationLoader,
+  c as RemoteSelectionOverlay,
+  l as Ribbon,
+  x as SlideCanvas,
+  T as SlideThumbnail,
+  n as SlidesPane,
+  p as ViewerState,
+  m as ViewerToolbar,
+  r as clampSlideIndex,
   w as createSlidesPaneProps,
-  y as createSvelteAiBridge,
-  l as createViewerState,
-  c as exportAllSlidesToSvg,
-  d as exportAllSlidesToSvgBlobs,
-  n as exportSlideAsSvg,
-  s as exportSlideToSvg,
-  u as exportSlideToSvgBlob,
-  i as fitScale,
+  o as createSvelteAiBridge,
+  b as createViewerState,
+  t as exportAllSlidesToSvg,
+  y as exportAllSlidesToSvgBlobs,
+  V as exportSlideAsSvg,
+  S as exportSlideToSvg,
+  C as exportSlideToSvgBlob,
+  a as fitScale,
   A as resolveNavigationKey,
-  o as zoomInPercent,
-  a as zoomOutPercent
+  i as zoomInPercent,
+  s as zoomOutPercent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-svelte-viewer",
-	"version": "4.74.0",
+	"version": "4.75.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",
@@ -121,8 +121,8 @@
 		"html2canvas-pro": "^2.6.3",
 		"jspdf": "^4.2.1",
 		"jszip": "^3.10.2",
-		"ooxml-core": "^1.49.0",
-		"ooxml-ui": "^1.49.1",
+		"ooxml-core": "^1.50.0",
+		"ooxml-ui": "^1.50.0",
 		"opentype.js": "^2.0.0"
 	},
 	"devDependencies": {