pptx-react-viewer 4.37.0 → 4.39.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React$1__default from 'react';
 import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
-import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, ReviewCommentsHost, CollaborationShellState } from 'ooxml-ui/pptx';
+import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, CanvasSize, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, ReviewCommentsHost, CollaborationShellState } 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, 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, 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 { LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
 export { LOCALE_CATALOG, LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
@@ -19,7 +19,7 @@ import { Options } from 'html2canvas-pro';
  */
 type SupportedShapeType = 'rect' | 'roundRect' | 'ellipse' | 'triangle' | 'rtTriangle' | 'diamond' | 'cylinder' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'hexagon' | 'octagon' | 'chevron' | 'star5' | 'star6' | 'star8' | 'plus' | 'heart' | 'cloud' | 'sun' | 'moon' | 'pie' | 'plaque' | 'teardrop' | 'line' | 'rtArrow' | 'leftArrow' | 'upArrow' | 'downArrow' | 'connector' | 'freeform';
 /** The pixel dimensions of the slide canvas (presentation slide size). */
-interface CanvasSize {
+interface CanvasSize$1 {
   /** Width of the canvas in CSS pixels. */
   width: number;
   /** Height of the canvas in CSS pixels. */
@@ -98,6 +98,13 @@ interface CollaborationContextValue {
   retry: () => void;
 }
 //#endregion
+//#region src/viewer/hooks/useLoadNotifications.d.ts
+/** What `onLoad` reports: the same detail the Svelte and vanilla bindings send. */
+interface ViewerLoadDetail {
+  slideCount: number;
+  canvasSize: CanvasSize;
+}
+//#endregion
 //#region src/viewer/types-ui.d.ts
 /**
  * Base handle interface for file viewer components.
@@ -165,6 +172,13 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   onSelectionChange?: (elementIds: string[]) => void;
   /** Callback when the total slide count changes (slide added/deleted). */
   onSlideCountChange?: (count: number) => void;
+  /**
+   * Fired each time a presentation finishes loading without an error, with the slide count
+   * and canvas size.
+   */
+  onLoad?: (detail: ViewerLoadDetail) => void;
+  /** Fired once per distinct load failure, with a human-readable message. */
+  onError?: (message: string) => void;
   /**
    * Host override for the File ▸ Open action. When provided, the built-in
    * native file picker is bypassed and this is invoked instead; the host is
@@ -551,7 +565,7 @@ interface ToolbarProps {
   onArmFreeformTool?: (tool: FreeformToolKind | null) => void;
   onAddTextBox: () => void;
   onAddShape: () => void;
-  onAddTable: () => void;
+  onAddTable: (rows?: number, columns?: number) => void;
   onAddChart?: (chartKind: InsertChartKind) => void;
   onAddSmartArt: () => void;
   onAddEquation: () => void;
@@ -685,6 +699,9 @@ interface ToolbarProps {
   onCompare?: () => void;
   onToggleComments?: () => void;
   isCommentsPanelOpen?: boolean;
+  /** The phone Insert sheet (opened from the bottom bar) and how it asks to close. */
+  isMobileInsertOpen?: boolean;
+  onCloseMobileInsert?: () => void;
   spellCheckActive?: boolean;
   slideCommentCount?: number;
   /** Review > Comments Previous / Next / Delete: the deck's slides and how to rewrite them. */
@@ -798,7 +815,7 @@ interface SlideCanvasProps {
   imagePaste?: CanvasImagePasteHandlers;
   activeSlide: PptxSlide | undefined;
   templateElements: PptxElement[];
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   zoom: ZoomViewport;
   mode: ViewerMode;
   canEdit: boolean;
@@ -1052,4 +1069,4 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
 export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks, useViewerTheme };
-export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult };
+export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerLoadDetail };

package/dist/index.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkL4E5A5DE_js = require('./chunk-L4E5A5DE.js');
-var chunkYAODOVJY_js = require('./chunk-YAODOVJY.js');
+var chunk2LNWGZPT_js = require('./chunk-2LNWGZPT.js');
+var chunkHOKZJLT5_js = require('./chunk-HOKZJLT5.js');
 var chunk43TOUP5U_js = require('./chunk-43TOUP5U.js');
 require('./chunk-W2IMY5SY.js');
 var pptx = require('ooxml-ui/pptx');
@@ -11,83 +11,83 @@ var i18n = require('ooxml-ui/pptx/i18n');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.PowerPointViewer; }
+  get: function () { return chunk2LNWGZPT_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.SlideCanvas; }
+  get: function () { return chunk2LNWGZPT_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunk2LNWGZPT_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.SlideTemplatePreview; }
+  get: function () { return chunk2LNWGZPT_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.THEME_CATALOG; }
+  get: function () { return chunk2LNWGZPT_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.Toolbar; }
+  get: function () { return chunk2LNWGZPT_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.ViewerThemeProvider; }
+  get: function () { return chunk2LNWGZPT_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.defaultCssVars; }
+  get: function () { return chunk2LNWGZPT_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.defaultRadius; }
+  get: function () { return chunk2LNWGZPT_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.defaultThemeColors; }
+  get: function () { return chunk2LNWGZPT_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk2LNWGZPT_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.themeToCssVars; }
+  get: function () { return chunk2LNWGZPT_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.useViewerTheme; }
+  get: function () { return chunk2LNWGZPT_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.vermilionDarkColors; }
+  get: function () { return chunk2LNWGZPT_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.vermilionDarkTheme; }
+  get: function () { return chunk2LNWGZPT_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.vermilionLightColors; }
+  get: function () { return chunk2LNWGZPT_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.vermilionLightTheme; }
+  get: function () { return chunk2LNWGZPT_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkL4E5A5DE_js.vermilionRadius; }
+  get: function () { return chunk2LNWGZPT_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkYAODOVJY_js.renderToCanvas; }
+  get: function () { return chunkHOKZJLT5_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkYAODOVJY_js.useViewerBuildingBlocks; }
+  get: function () { return chunkHOKZJLT5_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,

package/dist/index.mjs

@@ -1,5 +1,5 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-RXN5Q6CJ.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-RZIXD6X7.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-TYULCCA6.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-5XBS7MCX.mjs';
 export { getAnimationInitialStyle } from './chunk-UC2VQORY.mjs';
 import './chunk-Q3DHYOLK.mjs';
 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, 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 'ooxml-ui/pptx';

package/dist/internals.d.ts

@@ -13,7 +13,7 @@ import React$1, { Dispatch, SetStateAction, MutableRefObject, RefObject, Forward
  */
 type SupportedShapeType = 'rect' | 'roundRect' | 'ellipse' | 'triangle' | 'rtTriangle' | 'diamond' | 'cylinder' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'hexagon' | 'octagon' | 'chevron' | 'star5' | 'star6' | 'star8' | 'plus' | 'heart' | 'cloud' | 'sun' | 'moon' | 'pie' | 'plaque' | 'teardrop' | 'line' | 'rtArrow' | 'leftArrow' | 'upArrow' | 'downArrow' | 'connector' | 'freeform';
 /** The pixel dimensions of the slide canvas (presentation slide size). */
-interface CanvasSize {
+interface CanvasSize$1 {
   /** Width of the canvas in CSS pixels. */
   width: number;
   /** Height of the canvas in CSS pixels. */
@@ -296,7 +296,7 @@ interface ToolbarProps {
   onArmFreeformTool?: (tool: FreeformToolKind | null) => void;
   onAddTextBox: () => void;
   onAddShape: () => void;
-  onAddTable: () => void;
+  onAddTable: (rows?: number, columns?: number) => void;
   onAddChart?: (chartKind: InsertChartKind) => void;
   onAddSmartArt: () => void;
   onAddEquation: () => void;
@@ -430,6 +430,9 @@ interface ToolbarProps {
   onCompare?: () => void;
   onToggleComments?: () => void;
   isCommentsPanelOpen?: boolean;
+  /** The phone Insert sheet (opened from the bottom bar) and how it asks to close. */
+  isMobileInsertOpen?: boolean;
+  onCloseMobileInsert?: () => void;
   spellCheckActive?: boolean;
   slideCommentCount?: number;
   /** Review > Comments Previous / Next / Delete: the deck's slides and how to rewrite them. */
@@ -529,7 +532,7 @@ interface CanvasInteractionHandlers {
 //#region src/viewer/hooks/useEditorHistory.d.ts
 interface EditorHistoryInput {
   slides: PptxSlide[];
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   activeSlideIndex: number;
   templateElementsBySlideId: Record<string, PptxElement[]>;
   selectedElementId: string | null;
@@ -558,7 +561,7 @@ interface EditorHistoryInput {
    */
   onDirty?: () => void;
   setSlides: (slides: PptxSlide[]) => void;
-  setCanvasSize: (size: CanvasSize) => void;
+  setCanvasSize: (size: CanvasSize$1) => void;
   setActiveSlideIndex: (index: number) => void;
   setTemplateElementsBySlideId: (map: Record<string, PptxElement[]>) => void;
   setSelectedElementId: (id: string | null) => void;
@@ -667,7 +670,7 @@ declare function useElementOperations(input: UseElementOperationsInput): Element
 interface UseCanvasInteractionsInput {
   mode: ViewerMode;
   canEdit: boolean;
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   activeSlideIndex: number;
   selectedElementId: string | null;
   selectedElementIds: string[];
@@ -919,7 +922,7 @@ interface HyperlinkEditData {
 interface UseInsertElementsInput {
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   newShapeType: SupportedShapeType;
   selectedElements: PptxElement[];
   ops: ElementOperations;
@@ -930,7 +933,7 @@ interface InsertElementHandlers {
   addElement: (element: PptxElement) => void;
   handleAddTextBox: () => void;
   handleAddShape: () => void;
-  handleAddTable: () => void;
+  handleAddTable: (rows?: number, columns?: number) => void;
   handleAddChart: (chartKind: InsertChartKind) => void;
   handleInsertSmartArt: (layout: SmartArtLayout, defaultItems: string[]) => void;
   handleInsertEquation: (omml: Record<string, unknown>) => void;
@@ -1329,7 +1332,7 @@ interface UseViewerDialogsInput {
   /** Zero-based index of the active slide. */
   activeSlideIndex: number;
   /** Slide canvas dimensions (used for guide positioning). */
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   /** Ref to the container element (used for viewport width detection). */
   containerRef: React.RefObject<HTMLDivElement | null>;
   /** Custom shows defined in the presentation. */
@@ -1600,8 +1603,8 @@ interface ViewerCoreState extends InlineEditingState, EditPointsModeState {
   templateElementsBySlideId: Record<string, PptxElement[]>;
   setTemplateElementsBySlideId: React$1.Dispatch<React$1.SetStateAction<Record<string, PptxElement[]>>>;
   /** Width and height of the slide canvas in CSS pixels. */
-  canvasSize: CanvasSize;
-  setCanvasSize: React$1.Dispatch<React$1.SetStateAction<CanvasSize>>;
+  canvasSize: CanvasSize$1;
+  setCanvasSize: React$1.Dispatch<React$1.SetStateAction<CanvasSize$1>>;
   /**
    * `p:sldSz` in EMU, seeded from the loaded deck and updated by Design >
    * Slide Size. It is what a save persists: the pixel `canvasSize` above
@@ -1704,8 +1707,8 @@ interface ViewerCoreState extends InlineEditingState, EditPointsModeState {
   handoutMaster: PptxHandoutMaster | undefined;
   setHandoutMaster: React$1.Dispatch<React$1.SetStateAction<PptxHandoutMaster | undefined>>;
   /** Canvas dimensions for the notes page view (may differ from slide canvas). */
-  notesCanvasSize: CanvasSize | undefined;
-  setNotesCanvasSize: React$1.Dispatch<React$1.SetStateAction<CanvasSize | undefined>>;
+  notesCanvasSize: CanvasSize$1 | undefined;
+  setNotesCanvasSize: React$1.Dispatch<React$1.SetStateAction<CanvasSize$1 | undefined>>;
   /** User-defined custom document properties. */
   customProperties: PptxCustomProperty[];
   setCustomProperties: React$1.Dispatch<React$1.SetStateAction<PptxCustomProperty[]>>;
@@ -1792,6 +1795,9 @@ interface ViewerUIState {
   setToolbarSection: React.Dispatch<React.SetStateAction<ToolbarSection>>;
   isSlidesPaneOpen: boolean;
   setIsSlidesPaneOpen: React.Dispatch<React.SetStateAction<boolean>>;
+  /** The phone Insert sheet (bottom bar > Insert). */
+  isMobileInsertOpen: boolean;
+  setIsMobileInsertOpen: React.Dispatch<React.SetStateAction<boolean>>;
   isInspectorPaneOpen: boolean;
   setIsInspectorPaneOpen: React.Dispatch<React.SetStateAction<boolean>>;
   isSlideNotesCollapsed: boolean;
@@ -1921,7 +1927,7 @@ interface UseEditorOperationsInput {
   selectedElement: PptxElement | null;
   selectedElementId: string | null;
   selectedElementIds: string[];
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   dialogs: ViewerDialogsResult;
   presentation: UsePresentationModeResult;
   /** Display name for comment authoring. */
@@ -2016,7 +2022,7 @@ interface SlideCanvasProps {
   imagePaste?: CanvasImagePasteHandlers;
   activeSlide: PptxSlide | undefined;
   templateElements: PptxElement[];
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   zoom: ZoomViewport;
   mode: ViewerMode;
   canEdit: boolean;
@@ -2634,7 +2640,7 @@ interface SelectionBounds {
   maxY: number;
 }
 interface UseZoomViewportInput extends ViewportFitOptions {
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   selectedElements: PptxElement[];
 }
 interface UseZoomViewportResult {
@@ -2646,8 +2652,8 @@ interface UseZoomViewportResult {
   renderScaleRef: React.MutableRefObject<number>;
   scale: number;
   setScale: (scale: number) => void;
-  editorDimensions: CanvasSize | null;
-  setEditorDimensions: (dims: CanvasSize | null) => void;
+  editorDimensions: CanvasSize$1 | null;
+  setEditorDimensions: (dims: CanvasSize$1 | null) => void;
   fitScale: number;
   editorScale: number;
   handleZoomIn: () => void;
@@ -2789,7 +2795,7 @@ interface UseLoadContentInput {
   setSlides: React.Dispatch<React.SetStateAction<PptxSlide[]>>;
   setTemplateElementsBySlideId: React.Dispatch<React.SetStateAction<Record<string, PptxElement[]>>>;
   mediaDataUrls: Map<string, string>;
-  setCanvasSize: React.Dispatch<React.SetStateAction<CanvasSize>>;
+  setCanvasSize: React.Dispatch<React.SetStateAction<CanvasSize$1>>;
   /** Seeds the EMU `p:sldSz` that a save persists (see `ViewerCoreState.slideSizeEmu`). */
   setSlideSizeEmu: React.Dispatch<React.SetStateAction<SlideSizeEmu | undefined>>;
   setHeaderFooter: React.Dispatch<React.SetStateAction<PptxHeaderFooter>>;
@@ -2819,7 +2825,7 @@ interface UseLoadContentInput {
   setViewProperties: React.Dispatch<React.SetStateAction<PptxViewProperties | undefined>>;
   setNotesMaster: React.Dispatch<React.SetStateAction<PptxNotesMaster | undefined>>;
   setHandoutMaster: React.Dispatch<React.SetStateAction<PptxHandoutMaster | undefined>>;
-  setNotesCanvasSize: React.Dispatch<React.SetStateAction<CanvasSize | undefined>>;
+  setNotesCanvasSize: React.Dispatch<React.SetStateAction<CanvasSize$1 | undefined>>;
   setCustomProperties: React.Dispatch<React.SetStateAction<PptxCustomProperty[]>>;
   setTagCollections: React.Dispatch<React.SetStateAction<PptxTagCollection[]>>;
   setCoreProperties: React.Dispatch<React.SetStateAction<PptxCoreProperties | undefined>>;
@@ -2877,7 +2883,7 @@ declare function useLoadContent({ content, clearSelection, history, setSlides, s
 interface UsePointerHandlersInput {
   editorScale: number;
   canvasStageRef: React.RefObject<HTMLDivElement | null>;
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   activeSlide: PptxSlide | undefined;
   activeSlideIndex: number;
   gridSpacingPx: number;
@@ -2938,7 +2944,7 @@ interface UseSerializeInput {
   editTemplateMode?: boolean;
   masterViewTarget?: MasterViewTarget | null;
   /** The pixel canvas the raw Slide Size W/H inputs edit. */
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   /**
    * The EMU `p:sldSz` the viewer is holding (seeded on load, replaced by a
    * preset/orientation pick). Passed with `canvasSize` to
@@ -3067,7 +3073,7 @@ interface UseExportHandlersInput {
   /** Live theme, carried into the deck-JSON export document. */
   theme: PptxTheme | undefined;
   /** Slide canvas size in CSS pixels, carried into the deck-JSON export. */
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   /** The EMU `p:sldSz` the viewer holds, for the deck-JSON export's slide size. */
   slideSizeEmu?: SlideSizeEmu | undefined;
   /**
@@ -3182,7 +3188,7 @@ declare function useThemeHandlers(input: UseThemeHandlersInput): ThemeHandlersRe
 interface UsePropertyHandlersInput {
   slides: PptxSlide[];
   activeSlideIndex: number;
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   setContent: React.Dispatch<React.SetStateAction<ArrayBuffer | Uint8Array | null>>;
   setPresentationProperties: React.Dispatch<React.SetStateAction<PptxPresentationProperties>>;
   setCoreProperties: React.Dispatch<React.SetStateAction<PptxCoreProperties | null>>;
@@ -3410,7 +3416,7 @@ interface UseIOHandlersInput {
   state: ViewerState;
   slides: PptxSlide[];
   activeSlideIndex: number;
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   filePath: string | undefined;
   history: EditorHistoryResult;
   ops: ElementOperations;
@@ -3645,6 +3651,8 @@ interface ViewerIntegrationResult {
   recovery: UseRecoveryDetectionResult;
   isEncryptedDialogOpen: boolean;
   setIsEncryptedDialogOpen: Dispatch<SetStateAction<boolean>>;
+  /** Stable `PowerPointViewerAPI` view of the live handle (region `context.viewer`). */
+  viewerApi: PowerPointViewerAPI;
   /** The loaded core handler, exposed for the AI bridge (`getHandler`). */
   handlerRef: RefObject<PptxHandler | null>;
   /**
@@ -3971,7 +3979,7 @@ interface UseExportSaveAsInput {
   /** Live theme, carried into the deck-JSON export document. */
   theme: PptxTheme | undefined;
   /** Slide canvas size in CSS pixels, carried into the deck-JSON export. */
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   /** The EMU `p:sldSz` the viewer holds; see `UseExportHandlersInput`. */
   slideSizeEmu?: SlideSizeEmu | undefined;
 }
@@ -4426,7 +4434,7 @@ interface PresentationTransitionOverlayProps {
   /** Template/master elements that belong to the outgoing slide. */
   templateElements: PptxElement[];
   /** Canvas dimensions (slide width × height in EMU-derived px). */
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   /** Transition definition from the incoming slide. */
   transition: PptxSlideTransition;
   /** Resolved transition duration in ms. */
@@ -4467,7 +4475,7 @@ declare function PresentationTransitionOverlay({ outgoingSlide, templateElements
 //#endregion
 //#region src/viewer/components/MorphTransitionOverlay.d.ts
 interface MorphTransitionOverlayProps {
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   scale: number;
   morphPlan: MorphTransitionPlan;
   outgoingSlide: PptxSlide;
@@ -4491,7 +4499,7 @@ declare function MorphTransitionOverlay({ canvasSize, scale, morphPlan, outgoing
 interface SlideLayerProps {
   slide: PptxSlide;
   templateElements: PptxElement[];
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
 }
 declare function SlideLayer({ slide, templateElements, canvasSize }: SlideLayerProps): React$1.ReactElement;
 //#endregion
@@ -4500,7 +4508,7 @@ interface FragmentedTransitionLayerProps {
   layer: FragmentedLayer;
   slide: PptxSlide;
   templateElements: PptxElement[];
-  canvasSize: CanvasSize;
+  canvasSize: CanvasSize$1;
   scale: number;
   zIndex: number;
   layerName: 'outgoing' | 'incoming';