pptx-react-viewer 4.74.0 → 4.76.0

package/dist/chunk-Y53EC3JU.mjs

@@ -0,0 +1,27 @@
+import { registerHostI18next } from './chunk-N3YK2BCA.mjs';
+import { useTranslation } from 'react-i18next';
+
+function isEmptyPlainObject(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  const plain = prototype === null || Object.getPrototypeOf(prototype) === null;
+  return plain && Object.keys(value).length === 0;
+}
+function isMissingInstance(result) {
+  return result.ready === false && isEmptyPlainObject(result.i18n);
+}
+var NO_FIELDS = {};
+function useHostI18next() {
+  const result = useTranslation();
+  if (isMissingInstance(result)) {
+    return null;
+  }
+  const { t, i18n } = result;
+  return {
+    t,
+    i18n: typeof i18n === "object" && i18n !== null ? i18n : NO_FIELDS
+  };
+}
+registerHostI18next(useHostI18next);

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, 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 * 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 { 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';
@@ -15,6 +15,18 @@ export { LOCALE_CATALOG, LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
 import { Doc } from 'yjs';
 import { Options } from 'html2canvas-pro';
 
+/** What the viewer passes `translate`: exactly the params of the call. */
+interface PptxTranslateParams {
+  readonly defaultValue?: string;
+  readonly count?: number;
+  readonly [name: string]: unknown;
+}
+/**
+ * A host translator for {@link PptxI18nProvider}: the text for a viewer key (`pptx.*`) in the
+ * host's active language. Return the key itself, an empty string, `null` or `undefined` for "no
+ * translation": the viewer then shows its built-in English text.
+ */
+type PptxTranslate = (key: string, params?: PptxTranslateParams) => string | null | undefined;
 /**
  * Union of all shape preset types that the viewer can insert or render.
  * Maps to OOXML `a:prstGeom` preset values (e.g. "rect", "ellipse").
@@ -182,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). */
@@ -319,19 +344,25 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   /**
    * Initial locale code for File > Options > Language. Falls back to a persisted `localStorage`
    * choice, then `'en'`. Ignored inside a `PptxI18nProvider`, whose `locale` is the language.
+   * Without a provider it applies only while the viewer reads a configured react-i18next
+   * instance; with neither (for example `pptx-react-viewer/no-i18next` on its own) the viewer
+   * shows its built-in English text and ignores it.
    */
   defaultLocale?: string;
   /**
-   * Locale choices offered by File > Options > Language. Defaults to the codes registered on the
-   * host's `react-i18next` instance. Inside a `PptxI18nProvider` there is no default: pass two or
-   * more, together with `onLocaleChange`, to show the Language category.
+   * Locale choices offered by File > Options > Language. Without a provider they default to the
+   * codes registered on the host's `react-i18next` instance, and have no effect when the viewer
+   * reads no configured instance (see `defaultLocale`). Inside a `PptxI18nProvider` there is no
+   * default: pass two or more, together with `onLocaleChange`, to show the Language category.
    */
   availableLocales?: LocaleCatalogEntry[];
   /**
    * Called when the user picks a language from File > Options > Language. When provided, the
    * host owns applying and persisting the choice; otherwise the viewer applies and persists it
    * itself. Inside a `PptxI18nProvider` the host always owns the language: without this callback
-   * the Language category is left out.
+   * the Language category is left out. Without a provider, when the viewer reads no configured
+   * react-i18next instance (see `defaultLocale`), the Language category is left out and this is
+   * never called.
    */
   onLocaleChange?: (code: string) => void;
   /**
@@ -607,18 +638,6 @@ declare function getAnimationInitialStyle(preset: PptxAnimationPreset | undefine
  * access (e.g. serialising the current content for saving).
  */
 declare const PowerPointViewer: React$1.ForwardRefExoticComponent<PowerPointViewerProps & React$1.RefAttributes<PowerPointViewerHandle>>;
-/** What the viewer passes `translate`: exactly the params of the call. */
-interface PptxTranslateParams {
-  readonly defaultValue?: string;
-  readonly count?: number;
-  readonly [name: string]: unknown;
-}
-/**
- * A host translator for {@link PptxI18nProvider}: the text for a viewer key (`pptx.*`) in the
- * host's active language. Return the key itself, an empty string, `null` or `undefined` for "no
- * translation": the viewer then shows its built-in English text.
- */
-type PptxTranslate = (key: string, params?: PptxTranslateParams) => string | null | undefined;
 interface PptxI18nProviderProps {
   /**
    * Translates a viewer key; see {@link PptxTranslate}. Keep it referentially stable (a
@@ -656,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;
@@ -927,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. */
@@ -951,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;
@@ -1091,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;
@@ -1133,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. */
@@ -1220,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;
@@ -1228,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. */
@@ -1255,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;
@@ -1266,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
@@ -1290,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 };