pptx-svelte-viewer 4.74.0 → 4.76.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, SlideFindHighlights, 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';
@@ -277,6 +277,14 @@ interface PowerPointViewerProps extends ViewportFitOptions {
      * `localStorage` automatically.
      */
     onThemeChange?: (themeKey: string) => void;
+    /**
+     * Reports a slide element omitted after a render or effect error, on every surface of the
+     * viewer (canvas, thumbnails, slide show, reading view, previews), with
+     * `{ elementId, elementType, slideId }`. Camel-cased like `onThemeChange` because it is the
+     * same reporter option the building blocks take. Defaults to `console.error(error, context)`,
+     * also used when this callback throws.
+     */
+    onElementRenderError?: ooxml_ui_pptx.ElementRenderErrorHandler;
     /**
      * Initial File > Options > Language selection (locale code). Falls back to
      * a value persisted in `localStorage`, then the `locale` prop. Once the
@@ -370,6 +378,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 +516,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. */
@@ -741,6 +762,8 @@ interface SlideCanvasProps {
     editingElementId?: string | null;
     /** Forwarded to `SlideStage`; see `SlideStageProps.selectedElementIds`. */
     selectedElementIds?: readonly string[];
+    /** The Find bar's matches, marked in the elements' text (`findTextHighlightsByElement`). */
+    findHighlights?: SlideFindHighlights;
     ontablecellcommit?: (elementId: string, rowIndex: number, cellIndex: number, text: string) => void;
     onsmartartnodecommit?: (elementId: string, nodeId: string, text: string) => void;
     onsmartartnodefill?: (elementId: string, nodeId: string, fill: string) => void;
@@ -2452,6 +2475,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 +2777,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 +2792,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 "../transition-overlay-SNUzj4xJ.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-B-KZgn51.js";
+import "../transition-overlay-DXsGFRMK.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/dist/{y-webrtc-CJ08ZGdW.js → y-webrtc-CRVjQaCd.js}

@@ -1,4 +1,4 @@
-import { A as pr, O as gr, k as Fe } from "./transition-overlay-SNUzj4xJ.js";
+import { M as Fe, N as pr, j as gr } from "./transition-overlay-DXsGFRMK.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.74.0",
+	"version": "4.76.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.51.0",
 		"opentype.js": "^2.0.0"
 	},
 	"devDependencies": {