pptx-react-viewer 4.49.0 → 4.51.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
-import React$1__default 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, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, 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, DocumentStorage, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, 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, 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, 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';
@@ -302,21 +302,21 @@ interface PowerPointViewerProps extends ViewportFitOptions {
    */
   onThemeChange?: (key: string) => void;
   /**
-   * Initial locale code for File > Options > Language. Falls back to a
-   * persisted `localStorage` choice, then `'en'`.
+   * 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.
    */
   defaultLocale?: string;
   /**
-   * Locale choices offered by File > Options > Language. Defaults to the
-   * codes actually registered on the host's `react-i18next` instance
-   * (mapped through the shared `LOCALE_CATALOG` for display labels).
+   * 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.
    */
   availableLocales?: LocaleCatalogEntry[];
   /**
-   * Called when the user picks a language from File > Options > Language.
-   * When provided, the host owns applying and persisting the choice (the
-   * viewer will not call `i18n.changeLanguage` or touch `localStorage`
-   * itself); otherwise the viewer applies and persists it directly.
+   * 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.
    */
   onLocaleChange?: (code: string) => void;
   /**
@@ -546,6 +546,45 @@ 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>>;
+//#endregion
+//#region src/viewer/i18n/types.d.ts
+/** 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;
+//#endregion
+//#region src/viewer/i18n/provider.d.ts
+interface PptxI18nProviderProps {
+  /**
+   * Translates a viewer key; see {@link PptxTranslate}. Keep it referentially stable (a
+   * module-level function or `useCallback`): the viewer re-translates, re-rendering and re-running
+   * every translated effect, whenever `translate` or `locale` changes. To pick up messages loaded
+   * later for the same language, pass a new function.
+   */
+  readonly translate: PptxTranslate;
+  /**
+   * The host's active language: what the viewer reports and File > Options > Language shows as
+   * selected. A change re-translates the viewer, also when `translate` stays the same.
+   */
+  readonly locale: string;
+  readonly children?: ReactNode;
+}
+/**
+ * Translates every viewer component below it (`PowerPointViewer` and the standalone building
+ * blocks) through the host's own i18n library instead of react-i18next. A `PowerPointViewer`
+ * reads the provider nearest above it; a provider rendered inside the viewer is ignored, so the
+ * whole viewer shares one language. React only: the other bindings translate through their
+ * framework's i18n library or a `messages` dictionary.
+ */
+declare function PptxI18nProvider({ translate, locale, children }: PptxI18nProviderProps): ReactElement;
 
 //#region src/viewer/components/toolbar/toolbar-types.d.ts
 interface ToolbarProps {
@@ -617,6 +656,8 @@ interface ToolbarProps {
   onAddShape: () => void;
   onAddTable: (rows?: number, columns?: number) => void;
   onAddChart?: (chartKind: InsertChartKind) => void;
+  /** Opens the Insert Chart dialog; without it the Chart menu leaves "Insert Chart..." out. */
+  onOpenChartDialog?: () => void;
   onAddSmartArt: () => void;
   onAddEquation: () => void;
   onAddActionButton: (shapeType: string) => void;
@@ -1001,20 +1042,8 @@ interface SlideCanvasProps {
 }
 //#endregion
 //#region src/viewer/hooks/useAutosave.d.ts
-type AutosaveStatus = {
-  state: 'idle';
-} | {
-  state: 'disabled';
-  reason: string;
-} | {
-  state: 'saving';
-} | {
-  state: 'saved';
-  timestamp: number;
-} | {
-  state: 'error';
-  message: string;
-};
+/** The one autosave status every binding renders (`PptxAutosaveStatus` in `ooxml-ui/pptx`). */
+type AutosaveStatus = PptxAutosaveStatus;
 //#endregion
 //#region src/viewer/hooks/useViewerBuildingBlocks-types.d.ts
 interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
@@ -1127,5 +1156,5 @@ 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, ViewerLoadDetail };
+export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks, useViewerTheme };
+export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, PptxI18nProviderProps, PptxTranslate, PptxTranslateParams, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerLoadDetail };

package/dist/index.js

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk2ZXXHNNR_js = require('./chunk-2ZXXHNNR.js');
-var chunkME5QRTVS_js = require('./chunk-ME5QRTVS.js');
-var chunkJAI42EXQ_js = require('./chunk-JAI42EXQ.js');
+var chunkVI5DQRQZ_js = require('./chunk-VI5DQRQZ.js');
+var chunkV3XADJ2O_js = require('./chunk-V3XADJ2O.js');
+var chunkZ22RD3E2_js = require('./chunk-Z22RD3E2.js');
 require('./chunk-PIRHQTI4.js');
 var pptx = require('ooxml-ui/pptx');
 var i18n = require('ooxml-ui/pptx/i18n');
@@ -11,87 +11,91 @@ var i18n = require('ooxml-ui/pptx/i18n');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.PowerPointViewer; }
+  get: function () { return chunkVI5DQRQZ_js.PowerPointViewer; }
+});
+Object.defineProperty(exports, "PptxI18nProvider", {
+  enumerable: true,
+  get: function () { return chunkVI5DQRQZ_js.PptxI18nProvider; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.SlideCanvas; }
+  get: function () { return chunkVI5DQRQZ_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkVI5DQRQZ_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.SlideTemplatePreview; }
+  get: function () { return chunkVI5DQRQZ_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.THEME_CATALOG; }
+  get: function () { return chunkVI5DQRQZ_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.Toolbar; }
+  get: function () { return chunkVI5DQRQZ_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.ViewerThemeProvider; }
+  get: function () { return chunkVI5DQRQZ_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.defaultCssVars; }
+  get: function () { return chunkVI5DQRQZ_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.defaultRadius; }
+  get: function () { return chunkVI5DQRQZ_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.defaultThemeColors; }
+  get: function () { return chunkVI5DQRQZ_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkVI5DQRQZ_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.themeToCssVars; }
+  get: function () { return chunkVI5DQRQZ_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.useViewerTheme; }
+  get: function () { return chunkVI5DQRQZ_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.vermilionDarkColors; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.vermilionDarkTheme; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.vermilionLightColors; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.vermilionLightTheme; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunk2ZXXHNNR_js.vermilionRadius; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkME5QRTVS_js.renderToCanvas; }
+  get: function () { return chunkV3XADJ2O_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkME5QRTVS_js.useViewerBuildingBlocks; }
+  get: function () { return chunkV3XADJ2O_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkJAI42EXQ_js.getAnimationInitialStyle; }
+  get: function () { return chunkZ22RD3E2_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,

package/dist/index.mjs

@@ -1,6 +1,6 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-YKLL2Z33.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-Z62JFXMZ.mjs';
-export { getAnimationInitialStyle } from './chunk-PFV626ED.mjs';
+export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-ETJ752B5.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-ACFR4LFQ.mjs';
+export { getAnimationInitialStyle } from './chunk-ZCGYPCZM.mjs';
 import './chunk-UV2HVMKZ.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';
 export { LOCALE_CATALOG } from 'ooxml-ui/pptx/i18n';

package/dist/internals.d.ts

@@ -1,10 +1,10 @@
-import { CollaborationRole, CollaborationConfig, PowerPointViewerAPI, ViewerCustomizationApi, ShapeAdjustmentHandleDescriptor, ChangeCaseMode, ResolvedKeyboardCustomization, FindResult, EditorImagePasteOptions, InsertChartKind, PasteSpecialFormat, SlidePasteRequest, SlideTemplateId, MorphTransitionPlan, ElementAnimationState, ZoomNavigationTarget, PresentationSnapshot, DocumentStorage, ViewerMode, ShapeAdjustmentDragState, InlineTextEditSnapshot, InlineListReadResult, FreeformToolKind, CollaborationLivePatcher, SlideSizeEmu, ElementClipboardPayload, CropSession, FontEmbeddingDescriptor, MasterViewTarget, ViewportFitOptions, CollaborationInput, ToolbarActionId, CollaborationShellState, AnimationApplyGroup, ReviewCommentsHost, RulerUnit, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, PresentationPointerTool, RunProgramNotice, BorrowedCollaborationAwareness, CollabLoadOrigin, AuthoredSlideRange, DocumentSaveReason, FragmentedLayer, PrintSettings, ThemeEditorEdit, CompareResult, ReadOnlyRecommendation, CompatibilityWarningToast, DeviceOrientation, ResolvedCustomization, AutosaveRecord, DeckSavePurpose, ZoomExcursion, TouchGestureCallbacks, ViewerAutosaveStatus, ViewerOptionsStore, ViewerOptions, AutosaveRecoveryPrompt, VirtualizedRange, ToolbarTabId } from 'ooxml-ui/pptx';
+import { CollaborationRole, CollaborationConfig, PowerPointViewerAPI, ViewerCustomizationApi, PptxAutosaveStatus, ShapeAdjustmentHandleDescriptor, ChangeCaseMode, ResolvedKeyboardCustomization, FindResult, EditorImagePasteOptions, InsertChartKind, InsertChartOptions, PasteSpecialFormat, SlidePasteRequest, SlideTemplateId, MorphTransitionPlan, ElementAnimationState, ZoomNavigationTarget, PresentationSnapshot, DocumentStorage, InlineTextDraftSink, ViewerMode, ShapeAdjustmentDragState, GestureKind, PointerLike, InlineTextEditSnapshot, InlineListReadResult, FreeformToolKind, CollaborationLivePatcher, SlideSizeEmu, ElementClipboardPayload, CropSession, FontEmbeddingDescriptor, MasterViewTarget, ViewportFitOptions, CollaborationInput, ToolbarActionId, CollaborationShellState, AnimationApplyGroup, ReviewCommentsHost, RulerUnit, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, PresentationPointerTool, RunProgramNotice, BorrowedCollaborationAwareness, CollabLoadOrigin, AuthoredSlideRange, DocumentSaveReason, FragmentedLayer, PrintSettings, ThemeEditorEdit, CompareResult, ReadOnlyRecommendation, CompatibilityWarningToast, DeviceOrientation, ResolvedCustomization, AutosaveRecord, DeckSavePurpose, ZoomExcursion, TouchGestureCallbacks, ViewerAutosaveStatus, ViewerOptionsStore, ViewerOptions, AutosaveRecoveryPrompt, VirtualizedRange, ToolbarTabId } from 'ooxml-ui/pptx';
 export { CINEMATIC_TRANSITION_KEYFRAMES, CollaborationConfig, DEFAULT_MORPH_DURATION_MS, DEFAULT_TRANSITION_DURATION_MS, DeviceOrientation, EASE, INSTANT, MOBILE_BREAKPOINT, P14_TRANSITION_KEYFRAMES, P14_TRANSITION_KEYFRAMES_2, P14_TRANSITION_KEYFRAMES_ALL, RANDOM_ELIGIBLE_TYPES, ResolvedDirection, ResolvedDirection8, SLIDE_TRANSITION_KEYFRAMES, SLIDE_TRANSITION_KEYFRAMES_CSS, SlideTransitionAnimations, TABLET_BREAKPOINT, TRANSITION_SPEED_DURATION_MS, TouchGestureCallbacks, VirtualizedRange, WHEEL_SPOKE_COUNTS, computeVirtualRange, getCinematicTransitionAnimations, getP14TransitionAnimations, getSlideTransitionAnimations, resolveDirection, resolveDirection8, resolveOrientation, resolveSlideTransition, resolveTransitionDurationMs, resolveWheelSpokeCount } from 'ooxml-ui/pptx';
 import { PptxSlide, PptxElement, PptxElementAnimation, TextStyle, PptxHeaderFooter, ShapeStyle, PptxCommentMention, SmartArtLayout, InkPptxElement, ShapePptxElement, MergeShapeOperation, PptxSlideTransition, PptxAction, PptxSlideMaster, PptxModernCommentAuthor, PptxTheme, ParsedTableStyleMap, PptxThemeOption, PptxCustomShow, PptxSection, PptxPresentationProperties, PptxViewProperties, PptxNotesMaster, PptxHandoutMaster, PptxCustomProperty, PptxTagCollection, PptxCoreProperties, PptxAppProperties, PptxEmbeddedFont, MasterViewTab, PptxSlideLayout, PptxHandler, PptxLayoutOption, PptxLayoutPreview, PptxComment, ConnectorPptxElement, PptxThemePreset, PptxThemeColorScheme, PptxThemeFontScheme, PptxData, PptxHandlerSaveOptions, PptxSaveFormat, TextSegment, PptxModifyVerifier } from 'ooxml-core/pptx';
 import { CollaborationWriteBackState } from 'ooxml-core/collab';
 import * as Y from 'yjs';
 import { Doc } from 'yjs';
-import React$1, { Dispatch, SetStateAction, MutableRefObject, RefObject, ForwardedRef } from 'react';
+import React$1, { MutableRefObject, Dispatch, SetStateAction, RefObject, ForwardedRef } from 'react';
 
 //#region src/viewer/types-core.d.ts
 /**
@@ -305,6 +305,8 @@ interface ToolbarProps {
   onAddShape: () => void;
   onAddTable: (rows?: number, columns?: number) => void;
   onAddChart?: (chartKind: InsertChartKind) => void;
+  /** Opens the Insert Chart dialog; without it the Chart menu leaves "Insert Chart..." out. */
+  onOpenChartDialog?: () => void;
   onAddSmartArt: () => void;
   onAddEquation: () => void;
   onAddActionButton: (shapeType: string) => void;
@@ -516,6 +518,73 @@ interface InlineEditingState {
   registerInlineEditReader?: (elementId: string, read: () => InlineListReadResult) => () => void;
 }
 //#endregion
+//#region src/viewer/hooks/pointer-handler-types.d.ts
+interface UsePointerHandlersInput {
+  editorScale: number;
+  canvasStageRef: React.RefObject<HTMLDivElement | null>;
+  canvasSize: CanvasSize$1;
+  activeSlide: PptxSlide | undefined;
+  activeSlideIndex: number;
+  gridSpacingPx: number;
+  dragStateRef: React.MutableRefObject<DragState | null>;
+  resizeStateRef: React.MutableRefObject<ResizeState | null>;
+  shapeAdjustmentDragStateRef: React.MutableRefObject<ShapeAdjustmentDragState | null>;
+  marqueeStateRef: React.MutableRefObject<MarqueeSelectionState | null>;
+  /**
+   * Set on pointer-up when a drag/resize/adjustment gesture actually moved the
+   * element, so the click handler can tell a genuine "click an already-selected
+   * element to edit it" apart from the trailing click a completed gesture
+   * leaves behind. See {@link import('./viewer-core-state-types').ViewerCoreState.justInteractedRef}.
+   */
+  justInteractedRef: React.MutableRefObject<boolean>;
+  /** When true, pointer commits target the per-slide template store. */
+  editTemplateMode: boolean;
+  snapToGrid: boolean;
+  snapToShape: boolean;
+  guides: Array<{
+    id: string;
+    axis: 'h' | 'v';
+    position: number;
+  }>;
+  /** Template (master/layout) elements for the active slide (drag/marquee source while editing templates). */
+  templateElements: PptxElement[];
+  elementLookup: Map<string, PptxElement>;
+  setMarqueeSelectionState: React.Dispatch<React.SetStateAction<MarqueeSelectionState | null>>;
+  setSnapLines: React.Dispatch<React.SetStateAction<Array<{
+    axis: string;
+    position: number;
+  }>>>;
+  setTemplateElementsBySlideId: React.Dispatch<React.SetStateAction<Record<string, PptxElement[]>>>;
+  setPointerCommitNonce: React.Dispatch<React.SetStateAction<number>>;
+  effectiveSelectedIds: string[];
+  applySelection: (primaryId: string | null, ids?: string[]) => void;
+  clearSelection: () => void;
+  updateSlides: (updater: (s: PptxSlide[]) => PptxSlide[]) => void;
+  updateElementById: (id: string, updates: Partial<PptxElement>) => void;
+  markDirty: () => void;
+  /**
+   * Collaboration live-preview channel. Drag/resize write geometry straight to
+   * the DOM (no React state churn per frame), so without this remote peers saw
+   * nothing until pointer-up. Optional: absent in standalone building-block
+   * compositions, dormant when not collaborating.
+   */
+  livePatcher?: CollaborationLivePatcher;
+  /**
+   * Receives the canvas's move/resize gesture controller (see
+   * canvas-gestures.ts) so the press handlers can start it. Optional: a
+   * composition without it still arms and disarms the gesture records.
+   */
+  gestureRef?: React.MutableRefObject<CanvasGestures | null>;
+}
+//#endregion
+//#region src/viewer/hooks/canvas-gestures.d.ts
+interface CanvasGestures {
+  /** Start the gesture armed in `dragStateRef` (move) or `resizeStateRef` (resize). */
+  begin(kind: Exclude<GestureKind, 'rotate'>, id: string, pointer: PointerLike): void;
+  isActive(): boolean;
+  dispose(): void;
+}
+//#endregion
 //#region src/viewer/hooks/canvas-interaction-types.d.ts
 /**
  * Shared type for canvas interaction handler signatures.
@@ -552,7 +621,8 @@ interface EditorHistoryInput {
   error: string | null;
   /**
    * Undo-stack depth (File > Options > Advanced > "Maximum number of undos",
-   * resolved via the shared `resolveHistoryDepth`). Defaults to 120.
+   * resolved via the shared `resolveHistoryDepth`). Defaults to the shared
+   * `DEFAULT_EDITOR_HISTORY_DEPTH`.
    */
   maxHistoryEntries?: number;
   hasActivePointerInteraction: () => boolean;
@@ -714,6 +784,8 @@ interface UseCanvasInteractionsInput {
    * `ViewerCoreState.justInteractedRef`.
    */
   justInteractedRef: React.MutableRefObject<boolean>;
+  /** The move/resize gesture controller a press starts (set by `usePointerHandlers`). */
+  gestureRef?: React.MutableRefObject<CanvasGestures | null>;
   setInlineEditingElementId: React.Dispatch<React.SetStateAction<string | null>>;
   setInlineEditingText: React.Dispatch<React.SetStateAction<string>>;
   setContextMenuState: React.Dispatch<React.SetStateAction<ElementContextMenuState | null>>;
@@ -949,7 +1021,7 @@ interface InsertElementHandlers {
   handleAddTextBox: () => void;
   handleAddShape: () => void;
   handleAddTable: (rows?: number, columns?: number) => void;
-  handleAddChart: (chartKind: InsertChartKind) => void;
+  handleAddChart: (chartKind: InsertChartKind, options?: InsertChartOptions) => void;
   handleInsertSmartArt: (layout: SmartArtLayout, defaultItems: string[]) => void;
   handleInsertEquation: (omml: Record<string, unknown>) => void;
   handleUpdateEquation: (omml: Record<string, unknown>) => void;
@@ -1421,6 +1493,9 @@ interface ViewerDialogsResult {
   /** Whether the Insert SmartArt dialog is visible. */
   isSmartArtDialogOpen: boolean;
   setIsSmartArtDialogOpen: React.Dispatch<React.SetStateAction<boolean>>;
+  /** Whether the Insert Chart dialog is visible. */
+  isChartDialogOpen: boolean;
+  setIsChartDialogOpen: React.Dispatch<React.SetStateAction<boolean>>;
   /** Whether the equation (MathML/OMML) editor dialog is visible. */
   isEquationDialogOpen: boolean;
   setIsEquationDialogOpen: React.Dispatch<React.SetStateAction<boolean>>;
@@ -1569,6 +1644,8 @@ interface ViewerCoreState extends InlineEditingState, EditPointsModeState {
   mediaInputRef: React$1.RefObject<HTMLInputElement | null>;
   /** Mutable ref mirroring `activeSlideIndex` for use in event handlers that must not re-subscribe on index change. */
   activeSlideIndexRef: React$1.MutableRefObject<number>;
+  /** The autosave engine, which receives in-progress inline text (set by useAutosave). */
+  autosaveDraftSinkRef: React$1.MutableRefObject<InlineTextDraftSink | null>;
   /** Tracks the in-progress drag operation (move) for element(s). */
   dragStateRef: React$1.MutableRefObject<DragState | null>;
   /** Tracks the in-progress resize operation for an element. */
@@ -1594,6 +1671,11 @@ interface ViewerCoreState extends InlineEditingState, EditPointsModeState {
    * that made a single Ctrl+Z look like it did nothing.
    */
   justInteractedRef: React$1.MutableRefObject<boolean>;
+  /**
+   * The canvas's move/resize gesture controller, set by `usePointerHandlers`
+   * and started by the press handlers (see canvas-gestures.ts).
+   */
+  gestureControllerRef: React$1.MutableRefObject<CanvasGestures | null>;
   /**
    * Interim ("live preview") Y.Doc write channel. Drag/resize and inline
    * typing publish through it so remote peers see the gesture before it
@@ -2179,20 +2261,8 @@ interface SlideCanvasProps {
 }
 //#endregion
 //#region src/viewer/hooks/useAutosave.d.ts
-type AutosaveStatus = {
-  state: 'idle';
-} | {
-  state: 'disabled';
-  reason: string;
-} | {
-  state: 'saving';
-} | {
-  state: 'saved';
-  timestamp: number;
-} | {
-  state: 'error';
-  message: string;
-};
+/** The one autosave status every binding renders (`PptxAutosaveStatus` in `ooxml-ui/pptx`). */
+type AutosaveStatus = PptxAutosaveStatus;
 interface UseAutosaveInput {
   /** Whether the document has unsaved changes. */
   isDirty: boolean;
@@ -2204,9 +2274,8 @@ interface UseAutosaveInput {
    * Autosave interval in seconds.
    *
    * @deprecated Pass {@link intervalMs} instead. Seconds cannot express the
-   * short cadence a host may legitimately ask for, and the shared clamp it went
-   * through raised anything under 10s back to 10s, so an explicit host policy
-   * was silently overruled. Ignored when `intervalMs` is given.
+   * short cadence a host may legitimately ask for. Ignored when `intervalMs`
+   * is given.
    */
   intervalSeconds?: number;
   /**
@@ -2223,18 +2292,18 @@ interface UseAutosaveInput {
   /** Host storage; its recovery methods replace IndexedDB when it has them. */
   storage?: DocumentStorage;
   /**
-   * The values a snapshot is built from, read fresh on each tick.
-   *
-   * `isDirty` stays true from the first edit until the user performs a real
-   * save, so on its own it makes the timer re-serialize and rewrite an
-   * identical deck every N seconds forever. Vue, Svelte and Vanilla never had
-   * that problem because they debounce on the slides array being reassigned;
-   * this is the same trigger, and `shouldWriteAutosaveSnapshot` writes
-   * whenever it is unsure. Omit it and every tick writes, as before.
+   * The values a snapshot is built from (reassigned, never mutated), read on
+   * every render. While `isDirty`, a change in any of them is an edit that
+   * starts the AutoRecover interval; unchanged values never cause a rewrite.
+   * Omit it and only the clean-to-dirty transition counts as an edit.
    */
   getChangeSources?: () => readonly unknown[];
   /** Called with the serialised deck after each snapshot is written (the host's `onAutosave`). */
   onSaved?: ((data: Uint8Array) => void) | undefined;
+  /** Receives the engine so in-progress inline text counts as an edit (`reportInlineTextDraft`). */
+  inlineDraftSinkRef?: MutableRefObject<InlineTextDraftSink | null>;
+  /** The element whose inline editor is open; a closed editor's draft is dropped. */
+  getInlineEditingId?: () => string | null;
 }
 interface UseAutosaveResult {
   /** Current autosave status for display in the StatusBar. */
@@ -2499,7 +2568,7 @@ interface UseYjsProviderInput {
   config?: CollaborationConfig;
 }
 interface UseYjsProviderResult {
-  /** Current WebSocket connection status. */
+  /** Current connection status. */
   status: ConnectionStatus$1;
   /** The Yjs awareness instance (null until connected). */
   awareness: Awareness | null;
@@ -2511,24 +2580,19 @@ interface UseYjsProviderResult {
    * Whether the provider completed its initial document sync. Local doc
    * writes should be gated on this so a late joiner never seeds its
    * bootstrap deck into a room whose content has not arrived yet. Websocket
-   * flips it on the provider's 'synced' event; webrtc flips it on peer sync
-   * or after {@link INITIAL_SYNC_GRACE_MS} (a lone fresh-room peer never
-   * receives a sync event).
+   * flips it on the provider's sync event; webrtc on peer sync or after the
+   * grace period (a lone fresh-room peer never receives a sync event).
    */
   synced: boolean;
   /** Manually retry the connection after a timeout or error. */
   retry: () => void;
 }
 /**
- * Lazily loads `yjs` and `y-websocket`, creates a Y.Doc and
- * WebSocketProvider, and tracks the connection lifecycle.
+ * Lazily loads `yjs` and the transport, creates a Y.Doc and provider, and
+ * tracks the connection lifecycle through the shared session controller.
+ * The Yjs packages are dynamically imported so they are fully tree-shaken
+ * when collaboration is not enabled.
  *
- * If the connection does not succeed within {@link CONNECTION_TIMEOUT_MS},
- * the provider is torn down and status moves to `'error'`. The consumer
- * can call `retry()` to attempt a fresh connection.
- *
- * The Yjs packages are dynamically imported so they are fully
- * tree-shaken when collaboration is not enabled.
  * This low-level hook owns built-in transports only. Use useCollaborativeState
  * (or the full/headless viewer) to attach a host-owned external session.
  */
@@ -2915,59 +2979,6 @@ interface UseLoadContentResult {
 }
 declare function useLoadContent({ content, clearSelection, history, setSlides, setTemplateElementsBySlideId, mediaDataUrls, setCanvasSize, setSlideSizeEmu, setHeaderFooter, setFirstSlideNumber, setLayoutOptions, setSlideMasters, setModernCommentAuthors, setRecentColors, setTheme, setTableStyleMap, setTableStylesDefaultId, setTableStylesToDelete, setThemeOptions, setCustomShows, setActiveCustomShowId, setSections, setPresentationProperties, setViewProperties, setNotesMaster, setHandoutMaster, setNotesCanvasSize, setCustomProperties, setTagCollections, setCoreProperties, setAppProperties, setEmbeddedFonts, setActiveSlideIndex, setHasMacros, setHasDigitalSignatures, setDigitalSignatureCount, setGuides, setReadOnlyRecommendation, setModifyVerifier, setCompatToasts, setLoading, setError, setIsDirty, setIsEncrypted, onContentApplied, allowExternalImages, initialSlide }: UseLoadContentInput): UseLoadContentResult;
 //#endregion
-//#region src/viewer/hooks/pointer-handler-types.d.ts
-interface UsePointerHandlersInput {
-  editorScale: number;
-  canvasStageRef: React.RefObject<HTMLDivElement | null>;
-  canvasSize: CanvasSize$1;
-  activeSlide: PptxSlide | undefined;
-  activeSlideIndex: number;
-  gridSpacingPx: number;
-  dragStateRef: React.MutableRefObject<DragState | null>;
-  resizeStateRef: React.MutableRefObject<ResizeState | null>;
-  shapeAdjustmentDragStateRef: React.MutableRefObject<ShapeAdjustmentDragState | null>;
-  marqueeStateRef: React.MutableRefObject<MarqueeSelectionState | null>;
-  /**
-   * Set on pointer-up when a drag/resize/adjustment gesture actually moved the
-   * element, so the click handler can tell a genuine "click an already-selected
-   * element to edit it" apart from the trailing click a completed gesture
-   * leaves behind. See {@link import('./viewer-core-state-types').ViewerCoreState.justInteractedRef}.
-   */
-  justInteractedRef: React.MutableRefObject<boolean>;
-  /** When true, pointer commits target the per-slide template store. */
-  editTemplateMode: boolean;
-  snapToGrid: boolean;
-  snapToShape: boolean;
-  guides: Array<{
-    id: string;
-    axis: 'h' | 'v';
-    position: number;
-  }>;
-  /** Template (master/layout) elements for the active slide (drag/marquee source while editing templates). */
-  templateElements: PptxElement[];
-  elementLookup: Map<string, PptxElement>;
-  setMarqueeSelectionState: React.Dispatch<React.SetStateAction<MarqueeSelectionState | null>>;
-  setSnapLines: React.Dispatch<React.SetStateAction<Array<{
-    axis: string;
-    position: number;
-  }>>>;
-  setTemplateElementsBySlideId: React.Dispatch<React.SetStateAction<Record<string, PptxElement[]>>>;
-  setPointerCommitNonce: React.Dispatch<React.SetStateAction<number>>;
-  effectiveSelectedIds: string[];
-  applySelection: (primaryId: string | null, ids?: string[]) => void;
-  clearSelection: () => void;
-  updateSlides: (updater: (s: PptxSlide[]) => PptxSlide[]) => void;
-  updateElementById: (id: string, updates: Partial<PptxElement>) => void;
-  markDirty: () => void;
-  /**
-   * Collaboration live-preview channel. Drag/resize write geometry straight to
-   * the DOM (no React state churn per frame), so without this remote peers saw
-   * nothing until pointer-up. Optional: absent in standalone building-block
-   * compositions, dormant when not collaborating.
-   */
-  livePatcher?: CollaborationLivePatcher;
-}
-//#endregion
 //#region src/viewer/hooks/usePointerHandlers.d.ts
 declare function usePointerHandlers(input: UsePointerHandlersInput): void;
 //#endregion