pptx-react-viewer 4.75.0 → 4.76.0

package/dist/i18n/de.cjs

@@ -4743,6 +4743,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "{{name}}-\xDCbergang",
   "pptx.ribbon.collapseRibbon": "Men\xFCband reduzieren",
   "pptx.ribbon.expandRibbon": "Men\xFCband erweitern",
+  "pptx.ribbon.displayOptions": "Men\xFCband-Anzeigeoptionen",
+  "pptx.ribbon.display.fullScreen": "Vollbildmodus",
+  "pptx.ribbon.display.tabs": "Nur Registerkarten anzeigen",
+  "pptx.ribbon.display.always": "Men\xFCband immer anzeigen",
+  "pptx.ribbon.showRibbon": "Men\xFCband anzeigen",
   "pptx.ribbon.open": "\xD6ffnen",
   "pptx.ribbon.openAnotherPresentation": "\xD6ffnen Sie eine andere Pr\xE4sentation",
   "pptx.ribbon.saveAsPptx": "Als .pptx speichern",

package/dist/i18n/de.mjs

@@ -4717,6 +4717,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "{{name}}-\xDCbergang",
   "pptx.ribbon.collapseRibbon": "Men\xFCband reduzieren",
   "pptx.ribbon.expandRibbon": "Men\xFCband erweitern",
+  "pptx.ribbon.displayOptions": "Men\xFCband-Anzeigeoptionen",
+  "pptx.ribbon.display.fullScreen": "Vollbildmodus",
+  "pptx.ribbon.display.tabs": "Nur Registerkarten anzeigen",
+  "pptx.ribbon.display.always": "Men\xFCband immer anzeigen",
+  "pptx.ribbon.showRibbon": "Men\xFCband anzeigen",
   "pptx.ribbon.open": "\xD6ffnen",
   "pptx.ribbon.openAnotherPresentation": "\xD6ffnen Sie eine andere Pr\xE4sentation",
   "pptx.ribbon.saveAsPptx": "Als .pptx speichern",

package/dist/i18n/es.cjs

@@ -4743,6 +4743,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transici\xF3n {{name}}",
   "pptx.ribbon.collapseRibbon": "Contraer la cinta",
   "pptx.ribbon.expandRibbon": "Expandir la cinta",
+  "pptx.ribbon.displayOptions": "Opciones de presentaci\xF3n de la cinta",
+  "pptx.ribbon.display.fullScreen": "Modo de pantalla completa",
+  "pptx.ribbon.display.tabs": "Mostrar solo pesta\xF1as",
+  "pptx.ribbon.display.always": "Mostrar siempre la cinta",
+  "pptx.ribbon.showRibbon": "Mostrar la cinta",
   "pptx.ribbon.open": "Abrir",
   "pptx.ribbon.openAnotherPresentation": "Abrir otra presentaci\xF3n",
   "pptx.ribbon.saveAsPptx": "Guardar como .pptx",

package/dist/i18n/es.mjs

@@ -4717,6 +4717,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transici\xF3n {{name}}",
   "pptx.ribbon.collapseRibbon": "Contraer la cinta",
   "pptx.ribbon.expandRibbon": "Expandir la cinta",
+  "pptx.ribbon.displayOptions": "Opciones de presentaci\xF3n de la cinta",
+  "pptx.ribbon.display.fullScreen": "Modo de pantalla completa",
+  "pptx.ribbon.display.tabs": "Mostrar solo pesta\xF1as",
+  "pptx.ribbon.display.always": "Mostrar siempre la cinta",
+  "pptx.ribbon.showRibbon": "Mostrar la cinta",
   "pptx.ribbon.open": "Abrir",
   "pptx.ribbon.openAnotherPresentation": "Abrir otra presentaci\xF3n",
   "pptx.ribbon.saveAsPptx": "Guardar como .pptx",

package/dist/i18n/fr.cjs

@@ -4743,6 +4743,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transition {{name}}",
   "pptx.ribbon.collapseRibbon": "R\xE9duire le ruban",
   "pptx.ribbon.expandRibbon": "D\xE9velopper le ruban",
+  "pptx.ribbon.displayOptions": "Options d'affichage du ruban",
+  "pptx.ribbon.display.fullScreen": "Mode Plein \xE9cran",
+  "pptx.ribbon.display.tabs": "Afficher les onglets uniquement",
+  "pptx.ribbon.display.always": "Toujours afficher le ruban",
+  "pptx.ribbon.showRibbon": "Afficher le ruban",
   "pptx.ribbon.open": "Ouvrir",
   "pptx.ribbon.openAnotherPresentation": "Ouvrir une autre pr\xE9sentation",
   "pptx.ribbon.saveAsPptx": "Enregistrer sous .pptx",

package/dist/i18n/fr.mjs

@@ -4717,6 +4717,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transition {{name}}",
   "pptx.ribbon.collapseRibbon": "R\xE9duire le ruban",
   "pptx.ribbon.expandRibbon": "D\xE9velopper le ruban",
+  "pptx.ribbon.displayOptions": "Options d'affichage du ruban",
+  "pptx.ribbon.display.fullScreen": "Mode Plein \xE9cran",
+  "pptx.ribbon.display.tabs": "Afficher les onglets uniquement",
+  "pptx.ribbon.display.always": "Toujours afficher le ruban",
+  "pptx.ribbon.showRibbon": "Afficher le ruban",
   "pptx.ribbon.open": "Ouvrir",
   "pptx.ribbon.openAnotherPresentation": "Ouvrir une autre pr\xE9sentation",
   "pptx.ribbon.saveAsPptx": "Enregistrer sous .pptx",

package/dist/i18n/zh-CN.cjs

@@ -4758,6 +4758,11 @@ var translations27 = {
   "pptx.ribbon.transitionTitle": "{{name}} \u5207\u6362",
   "pptx.ribbon.collapseRibbon": "\u6298\u53E0\u529F\u80FD\u533A",
   "pptx.ribbon.expandRibbon": "\u5C55\u5F00\u529F\u80FD\u533A",
+  "pptx.ribbon.displayOptions": "\u529F\u80FD\u533A\u663E\u793A\u9009\u9879",
+  "pptx.ribbon.display.fullScreen": "\u5168\u5C4F\u6A21\u5F0F",
+  "pptx.ribbon.display.tabs": "\u4EC5\u663E\u793A\u9009\u9879\u5361",
+  "pptx.ribbon.display.always": "\u59CB\u7EC8\u663E\u793A\u529F\u80FD\u533A",
+  "pptx.ribbon.showRibbon": "\u663E\u793A\u529F\u80FD\u533A",
   "pptx.ribbon.open": "\u6253\u5F00",
   "pptx.ribbon.openAnotherPresentation": "\u6253\u5F00\u53E6\u4E00\u4E2A\u6F14\u793A\u6587\u7A3F",
   "pptx.ribbon.saveAsPptx": "\u53E6\u5B58\u4E3A .pptx",

package/dist/i18n/zh-CN.mjs

@@ -4732,6 +4732,11 @@ var translations27 = {
   "pptx.ribbon.transitionTitle": "{{name}} \u5207\u6362",
   "pptx.ribbon.collapseRibbon": "\u6298\u53E0\u529F\u80FD\u533A",
   "pptx.ribbon.expandRibbon": "\u5C55\u5F00\u529F\u80FD\u533A",
+  "pptx.ribbon.displayOptions": "\u529F\u80FD\u533A\u663E\u793A\u9009\u9879",
+  "pptx.ribbon.display.fullScreen": "\u5168\u5C4F\u6A21\u5F0F",
+  "pptx.ribbon.display.tabs": "\u4EC5\u663E\u793A\u9009\u9879\u5361",
+  "pptx.ribbon.display.always": "\u59CB\u7EC8\u663E\u793A\u529F\u80FD\u533A",
+  "pptx.ribbon.showRibbon": "\u663E\u793A\u529F\u80FD\u533A",
   "pptx.ribbon.open": "\u6253\u5F00",
   "pptx.ribbon.openAnotherPresentation": "\u6253\u5F00\u53E6\u4E00\u4E2A\u6F14\u793A\u6587\u7A3F",
   "pptx.ribbon.saveAsPptx": "\u53E6\u5B58\u4E3A .pptx",

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
-import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, CanvasSize, DocumentStorage, CloudFileProvider, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, GoogleFontsOption, ListConversionScope, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PptxLoadLimits, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, ReviewCommentsHost, SlidesPaneLayoutGalleryRequest, CollaborationShellState, PptxAutosaveStatus } 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, ListConversionScope, 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, SlidesPaneLayoutGalleryRequest, 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 { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, CanvasSize, DocumentStorage, CloudFileProvider, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, GoogleFontsOption, ListConversionScope, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PptxLoadLimits, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, RibbonDisplayController, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, ReviewCommentsHost, UseViewerBuildingBlocksActionsOptions, SlidesPaneLayoutGalleryRequest, CollaborationShellState, PptxAutosaveStatus, ViewerBuildingBlockActions } from 'ooxml-ui/pptx';
+export { AVATAR_COLOR_SWATCHES, AccountAuthConfig, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCustomization, BuildingBlockActionId, BuildingBlockActionState, BuildingBlockFailureCode, BuildingBlockFindReplace, BuildingBlockLayoutActions, BuildingBlockRequest, BuildingBlockResult, CANVAS_CONTEXT_MENU_COMMAND_IDS, CollaborationConfig, CollaborationShellState, ContextMenuCustomization, DEFAULT_VIEWER_PROFILE, DocumentPropertiesActions, DocumentPropertiesPatch, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, FontEmbeddingActions, HostCanvasMenuContext, HostElementMenuContext, HostFileLimits, HostMenuCommand, HostSignatureInfo, KeyboardCustomization, ListConversionScope, LocalStorageUsageSummary, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PasswordProtectionActions, PowerPointViewerAPI, RIBBON_TAB_IDS, ResolvedCustomization, RibbonCustomization, SLIDE_TEMPLATES, SavedPresentationFormat, ShortcutChord, SignatureActions, SlideTemplateId, SlideTemplateSpec, SlidesPaneLayoutGalleryRequest, 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, ViewerBuildingBlockActions, 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 * as React$1 from 'react';
 import React$1__default, { ReactNode, ReactElement } from 'react';
-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 { PptxCoreProperties, PptxAnimationPreset, PptxNativeAnimation, PptxElement, PptxSlide, 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';
@@ -194,6 +194,19 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   onModeChange?: (mode: ooxml_ui_pptx.ViewerMode) => void;
   /** Callback when the zoom level changes. */
   onZoomChange?: (zoom: number) => void;
+  /**
+   * Ribbon Display Options, the starting mode: `always` docks the tabs and commands above the
+   * slide (the default), `tabs` shows only the tab row (a chosen tab lays its commands over the
+   * slide until a press elsewhere or Escape), `fullScreen` hides the title bar and the ribbon
+   * until the strip at the top is pressed. Changing it later applies the mode without calling
+   * `onRibbonDisplayChange`.
+   */
+  ribbonDisplay?: ooxml_ui_pptx.RibbonDisplayMode;
+  /**
+   * Called when the user picks a Ribbon Display Option (the menu, Ctrl+F1, a double click on a
+   * tab). Not called when the host changes `ribbonDisplay`.
+   */
+  onRibbonDisplayChange?: (mode: ooxml_ui_pptx.RibbonDisplayMode) => void;
   /** Callback when element selection changes. */
   onSelectionChange?: (elementIds: string[]) => void;
   /** Callback when the total slide count changes (slide added/deleted). */
@@ -662,6 +675,11 @@ interface ToolbarProps {
   isProtectedView?: boolean;
   /** Drops the Protected View override for this session. Only offered when `isProtectedView` is true. */
   onEnableEditing?: () => void;
+  /**
+   * The viewer's Ribbon Display Options controller. Optional: a ribbon rendered on its own
+   * stays in the default "always" mode.
+   */
+  ribbonDisplay?: RibbonDisplayController;
   isNarrowViewport: boolean;
   isSidebarCollapsed: boolean;
   isInspectorPaneOpen: boolean;
@@ -933,6 +951,13 @@ interface TableStyleContext {
   tableStyleMap?: ParsedTableStyleMap;
   theme?: PptxTheme;
 }
+/** Identifies the element omitted after a React client render or lifecycle error. */
+interface ElementRenderErrorContext {
+  elementId: string;
+  elementType: PptxElement['type'];
+  slideId?: string;
+}
+type ElementRenderErrorHandler = (error: Error, context: ElementRenderErrorContext) => void;
 /** Wiring for Edit Points and the Freeform: Shape / Curve tools. */
 interface OutlineAuthoringProps {
   /** The shape in Edit Points mode, or null. */
@@ -957,6 +982,8 @@ interface ZoomViewport {
   editorScale: number;
 }
 interface SlideCanvasProps {
+  /** Reports an element omitted after a React render/lifecycle error; defaults to console.error. */
+  onElementRenderError?: ElementRenderErrorHandler;
   /** The viewer-owned live channel; absent for static/custom non-collaborative canvases. */
   livePatcher?: CollaborationLivePatcher;
   registerInlineEditReader?: (elementId: string, read: () => InlineListReadResult) => () => void;
@@ -1097,6 +1124,8 @@ interface SlideCanvasProps {
   outlineAuthoring?: OutlineAuthoringProps;
 }
 interface SlidesPaneSidebarProps {
+  /** Reports an element omitted from a thumbnail; defaults to console.error. */
+  onElementRenderError?: ElementRenderErrorHandler;
   slides: PptxSlide[];
   templateElementsBySlideId: Record<string, PptxElement[]>;
   activeSlideIndex: number;
@@ -1139,7 +1168,9 @@ interface SlidesPaneSidebarProps {
 }
 /** The one autosave status every binding renders (`PptxAutosaveStatus` in `ooxml-ui/pptx`). */
 type AutosaveStatus = PptxAutosaveStatus;
-interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
+interface UseViewerBuildingBlocksInput extends ViewportFitOptions, UseViewerBuildingBlocksActionsOptions {
+  /** Reports an element omitted after a React render/lifecycle error; defaults to console.error. */
+  onElementRenderError?: ElementRenderErrorHandler;
   /** Optional collaboration, including a host-owned document and presence session. */
   collaboration?: CollaborationInput;
   /** PPTX content as ArrayBuffer/Uint8Array, or null/undefined while no file is loaded. */
@@ -1226,7 +1257,11 @@ interface ViewerBuildingBlocksResult {
    * Its open state is the toolbar's sidebar toggle.
    */
   slidesPaneProps: SlidesPaneSidebarProps;
-  /** Current viewer mode (edit, view, present, master). */
+  /**
+   * The effective mode, as every binding's building blocks report it: `preview` while the blocks
+   * may not edit (no `canEdit`, a collaboration viewer role), otherwise the viewer's mode (`edit`,
+   * `present`, `master`). `toolbarProps.mode` and `canvasProps.mode` keep the viewer's own mode.
+   */
   mode: ViewerMode;
   /** True while the initial parse of `content` is in progress. */
   loading: boolean;
@@ -1234,18 +1269,26 @@ interface ViewerBuildingBlocksResult {
   error: string | null;
   /** Current autosave-to-localStorage recovery status. */
   autosaveStatus: AutosaveStatus;
+  /**
+   * Operations and state for finishing picker, dialog and layout workflows from host-rendered
+   * controls: image / media insertion, hyperlink, SmartArt and equation editing, Find / Replace
+   * and layout apply / reset, plus which actions can run now. See `docs/react/hooks.md`.
+   */
+  actions: ViewerBuildingBlockActions;
 }
 declare function useViewerBuildingBlocks(input: UseViewerBuildingBlocksInput): ViewerBuildingBlocksResult;
 
 declare function Toolbar(p: ToolbarProps): React$1__default.ReactElement;
 declare function SlideCanvas(props: SlideCanvasProps): React$1.JSX.Element;
-declare function SlidesPaneSidebar({ slides, templateElementsBySlideId, activeSlideIndex, canvasSize, sectionGroups, isOpen, canEdit, onSelectSlide, onSlideContextMenu, onMoveSlide, onAddSlide, onAddSlideAfter, onDuplicateSlides, onDeleteSlides, onHideSlides, onOpenLayoutForSlide, onCollapse: _onCollapse, onAddSection, onRenameSection, onDeleteSection, onMoveSectionUp, onMoveSectionDown, onToggleSectionCollapse, rehearsalTimings, panelWidth, fieldContext, tableStyleContext }: SlidesPaneSidebarProps): React$1__default.ReactElement | null;
+declare function SlidesPaneSidebar(props: SlidesPaneSidebarProps): React$1__default.ReactElement;
 /**
  * A static, scaled-down drawing of one slide, as the slides pane shows it. It renders from the
  * slide model, so it follows unsaved edits. Feed it from `slidesPaneProps`:
  * `templateElementsBySlideId[slide.id]`, `canvasSize`, `fieldContext` and `tableStyleContext`.
  */
 interface SlideThumbnailProps {
+  /** Reports an element omitted from this preview; defaults to console.error. */
+  onElementRenderError?: ElementRenderErrorHandler;
   /** The slide to draw. A different slide object (every edit makes one) redraws it. */
   slide: PptxSlide;
   /** The slide's inherited layout and master elements, drawn beneath its own. */
@@ -1261,7 +1304,7 @@ interface SlideThumbnailProps {
   /** Theme + table style map for resolving table band/header colours. */
   tableStyleContext?: TableStyleContext;
 }
-declare function SlideThumbnailImpl({ slide, templateElements, canvasSize, previewWidth, fieldContext, tableStyleContext }: SlideThumbnailProps): React$1__default.ReactElement;
+declare function SlideThumbnailImpl({ slide, templateElements, canvasSize, previewWidth, fieldContext, tableStyleContext, onElementRenderError }: SlideThumbnailProps): React$1__default.ReactElement;
 declare const SlideThumbnail: React$1__default.MemoExoticComponent<typeof SlideThumbnailImpl>;
 interface SlideTemplateGalleryDialogProps {
   isOpen: boolean;
@@ -1272,11 +1315,12 @@ interface SlideTemplateGalleryDialogProps {
 }
 declare function SlideTemplateGalleryDialog({ isOpen, onClose, onInsert, scheme }: SlideTemplateGalleryDialogProps): React$1__default.ReactElement | null;
 interface SlideTemplatePreviewProps {
+  onElementRenderError?: ElementRenderErrorHandler;
   templateId: SlideTemplateId;
   /** Optional deck scheme so the preview shows the deck's theme colours. */
   scheme?: Record<string, string>;
 }
-declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePreviewProps): React$1__default.ReactElement;
+declare function SlideTemplatePreview({ templateId, scheme, onElementRenderError }: SlideTemplatePreviewProps): React$1__default.ReactElement;
 /**
  * A drop-in replacement for `html2canvas(element, options)` that first
  * resolves any oklch / oklab / lch / lab / color() values in the cloned
@@ -1296,4 +1340,4 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
 export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, SlideThumbnail, SlidesPaneSidebar as SlidesPane, Toolbar, ViewerThemeProvider, getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks, useViewerTheme };
-export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, PptxI18nProviderProps, PptxTranslate, PptxTranslateParams, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, SlideThumbnailProps, SlidesPaneSidebarProps as SlidesPaneProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerLoadDetail };
+export type { CollaborationContextValue, ElementRenderErrorContext, ElementRenderErrorHandler, PowerPointViewerHandle, PowerPointViewerProps, PptxI18nProviderProps, PptxTranslate, PptxTranslateParams, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, SlideThumbnailProps, SlidesPaneSidebarProps as SlidesPaneProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerLoadDetail };

package/dist/index.js

@@ -2,9 +2,9 @@
 
 var chunkLWGPHJHC_js = require('./chunk-LWGPHJHC.js');
 require('./chunk-P2IEKYVG.js');
-var chunkRJRDE3C2_js = require('./chunk-RJRDE3C2.js');
+var chunkXTYBIJ2S_js = require('./chunk-XTYBIJ2S.js');
 require('./chunk-MU3BIZ2U.js');
-var chunk3AZ6ESJU_js = require('./chunk-3AZ6ESJU.js');
+var chunkSEIVQGH5_js = require('./chunk-SEIVQGH5.js');
 var chunk6GFSF2ML_js = require('./chunk-6GFSF2ML.js');
 require('./chunk-PIRHQTI4.js');
 
@@ -156,91 +156,91 @@ Object.defineProperty(exports, "writeStoredViewerPrefs", {
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.PowerPointViewer; }
+  get: function () { return chunkXTYBIJ2S_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.SlideCanvas; }
+  get: function () { return chunkXTYBIJ2S_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkXTYBIJ2S_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.SlideTemplatePreview; }
+  get: function () { return chunkXTYBIJ2S_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "SlideThumbnail", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.SlideThumbnail; }
+  get: function () { return chunkXTYBIJ2S_js.SlideThumbnail; }
 });
 Object.defineProperty(exports, "SlidesPane", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.SlidesPaneSidebar; }
+  get: function () { return chunkXTYBIJ2S_js.SlidesPaneSidebar; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.THEME_CATALOG; }
+  get: function () { return chunkXTYBIJ2S_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.Toolbar; }
+  get: function () { return chunkXTYBIJ2S_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.ViewerThemeProvider; }
+  get: function () { return chunkXTYBIJ2S_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.defaultCssVars; }
+  get: function () { return chunkXTYBIJ2S_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.defaultRadius; }
+  get: function () { return chunkXTYBIJ2S_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.defaultThemeColors; }
+  get: function () { return chunkXTYBIJ2S_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkXTYBIJ2S_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.themeToCssVars; }
+  get: function () { return chunkXTYBIJ2S_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.useViewerTheme; }
+  get: function () { return chunkXTYBIJ2S_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.vermilionDarkColors; }
+  get: function () { return chunkXTYBIJ2S_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.vermilionDarkTheme; }
+  get: function () { return chunkXTYBIJ2S_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.vermilionLightColors; }
+  get: function () { return chunkXTYBIJ2S_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.vermilionLightTheme; }
+  get: function () { return chunkXTYBIJ2S_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkRJRDE3C2_js.vermilionRadius; }
+  get: function () { return chunkXTYBIJ2S_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunk3AZ6ESJU_js.renderToCanvas; }
+  get: function () { return chunkSEIVQGH5_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunk3AZ6ESJU_js.useViewerBuildingBlocks; }
+  get: function () { return chunkSEIVQGH5_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "PptxI18nProvider", {
   enumerable: true,

package/dist/index.mjs

@@ -1,7 +1,7 @@
 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, LOCALE_CATALOG, 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 './chunk-FFTZYNL4.mjs';
 import './chunk-Y53EC3JU.mjs';
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, SlideThumbnail, SlidesPaneSidebar as SlidesPane, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-DE4Y5F4T.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, SlideThumbnail, SlidesPaneSidebar as SlidesPane, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-OC4RP2CB.mjs';
 import './chunk-RMEWSJZU.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-AZLOOFU2.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-PPOGAZ53.mjs';
 export { PptxI18nProvider, getAnimationInitialStyle } from './chunk-N3YK2BCA.mjs';
 import './chunk-UV2HVMKZ.mjs';