pptx-react-viewer 4.55.0 → 4.56.0

package/dist/index.d.ts

@@ -1,15 +1,17 @@
 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, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, GoogleFontsOption, 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, 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 { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, CanvasSize, DocumentStorage, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, GoogleFontsOption, 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, 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 { PptxAiConfig } from 'ooxml-ui/pptx/ai';
+export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
+import { PptxAiAssistant } from 'ooxml-ui/pptx/ai/host';
+export { PptxAiAssistant } from 'ooxml-ui/pptx/ai/host';
 import { LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
 export { LOCALE_CATALOG, LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
 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 { CollaborationWriteBackState, CollaborationState } from 'ooxml-core/collab';
 export { CollaborationState } from 'ooxml-core/collab';
-import { PptxAiConfig } from 'ooxml-ui/pptx/ai';
-export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
 import { Doc } from 'yjs';
 import { Options } from 'html2canvas-pro';
 
@@ -149,6 +151,19 @@ interface TableCellEditorState {
     col: number;
   }>;
 }
+/**
+ * Groups slides into named sections for the slides pane sidebar.
+ * Corresponds to OOXML `p15:section` elements in `presentation.xml`.
+ */
+interface SlideSectionGroup {
+  id: string;
+  label: string;
+  slideIndexes: number[];
+  /** Section highlight color from p15:sectionPr. */
+  color?: string;
+  /** Whether the section should start collapsed (from p15:sectionPr). */
+  defaultCollapsed?: boolean;
+}
 /** Identifies one of the ribbon-style toolbar tabs (home, insert, text, etc.). */
 type ToolbarSection = 'file' | 'home' | 'insert' | 'text' | 'arrange' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
 /** The active drawing/inking tool selected in the Draw toolbar tab. */
@@ -513,22 +528,30 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   ribbonAddIns?: readonly RibbonAddInTab[];
   /**
    * Opt in to the built-in AI assistant. When provided, a Sparkles toggle
-   * appears in the toolbar and opens a chat panel wired to this config; when
-   * omitted, no AI icon renders and no AI code is loaded (the panel and its
-   * `@ai-sdk/react` dependency are `React.lazy`-imported only on first open).
+   * appears in the toolbar and opens a chat panel; when omitted, no AI icon
+   * renders and no AI code is loaded (the panel and its `@ai-sdk/react`
+   * dependency are `React.lazy`-imported only on first open).
    *
-   * The host supplies the model connection (a backend `endpoint`, an in-browser
-   * `model`, or a custom `transport`) plus optional tool allow/deny lists and a
-   * write policy. Requires the optional `ai` and `@ai-sdk/react` peers.
+   * Pass a plain `PptxAiConfig` (supported and not deprecated), or the opaque
+   * handle `createAiAssistant(config)` returns (from `pptx-react-viewer/ai`, the
+   * opt-in entry that brings the chat panel). Both open the same panel. Only a
+   * value from `createAiAssistant` is read as a handle; any other value is a
+   * plain config, which the viewer does not validate. The config supplies the
+   * model connection (a backend `endpoint`, an in-browser `model`, or a custom
+   * `transport`) plus optional tool allow/deny lists and a write policy.
+   * Requires the optional `ai` and `@ai-sdk/react` peers.
    *
    * @example
    * ```tsx
-   * <PowerPointViewer content={bytes} ai={{ connection: { kind: 'model', model } }} />
+   * import { createAiAssistant } from 'pptx-react-viewer/ai';
+   *
+   * const assistant = createAiAssistant({ connection: { kind: 'endpoint', api: '/api/chat' } });
+   * <PowerPointViewer content={bytes} ai={assistant} />
    * ```
    *
    * @see {@link PptxAiConfig}
    */
-  ai?: PptxAiConfig;
+  ai?: PptxAiConfig | PptxAiAssistant;
   /**
    * Framework-neutral UI customisation. See docs/guide/customization.md.
    * Unioned with `hiddenActions`. A new object replaces the whole
@@ -1070,6 +1093,49 @@ interface SlideCanvasProps {
   outlineAuthoring?: OutlineAuthoringProps;
 }
 //#endregion
+//#region src/viewer/components/slides-pane/types.d.ts
+interface SlidesPaneSidebarProps {
+  slides: PptxSlide[];
+  templateElementsBySlideId: Record<string, PptxElement[]>;
+  activeSlideIndex: number;
+  canvasSize: CanvasSize$1;
+  sectionGroups: SlideSectionGroup[];
+  isOpen: boolean;
+  canEdit: boolean;
+  onSelectSlide: (index: number) => void;
+  onSlideContextMenu: (e: React$1__default.MouseEvent, index: number) => void;
+  onMoveSlide: (fromIndex: number, toIndex: number) => void;
+  onAddSlide: () => void;
+  onAddSlideAfter: (index: number) => void;
+  onDuplicateSlides: (indexes: number[]) => void;
+  onDeleteSlides: (indexes: number[]) => void;
+  onHideSlides: (indexes: number[]) => void;
+  /** Makes `index` active, then opens the Layout gallery anchored at (x, y). */
+  onOpenLayoutForSlide: (index: number, x: number, y: number) => void;
+  onCollapse: () => void;
+  onAddSection?: (name: string, afterSlideIndex: number) => void;
+  onRenameSection?: (sectionId: string, newName: string) => void;
+  onDeleteSection?: (sectionId: string) => void;
+  onMoveSectionUp?: (sectionId: string) => void;
+  onMoveSectionDown?: (sectionId: string) => void;
+  /**
+   * Persist the collapse flag onto the section model, so it round-trips
+   * through save exactly as it does in the other four bindings.
+   */
+  onToggleSectionCollapse?: (sectionId: string) => void;
+  /** Recorded rehearsal timings in ms, keyed by slide index. */
+  rehearsalTimings?: Record<number, number>;
+  /** Width of the panel in pixels (for resizable panels). */
+  panelWidth?: number;
+  /**
+   * Presentation-wide field context (date/header/footer/custom props) so
+   * thumbnails substitute the same field placeholders as the canvas.
+   */
+  fieldContext?: FieldSubstitutionContext;
+  /** Theme + table style map so thumbnails resolve table band/header colours. */
+  tableStyleContext?: TableStyleContext;
+}
+//#endregion
 //#region src/viewer/hooks/useAutosave.d.ts
 /** The one autosave status every binding renders (`PptxAutosaveStatus` in `ooxml-ui/pptx`). */
 type AutosaveStatus = PptxAutosaveStatus;
@@ -1128,6 +1194,12 @@ interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
   onOpenHeaderFooter?: () => void;
   /** Fired by the toolbar's "Share" button; the host owns rendering that dialog. */
   onOpenShareDialog?: () => void;
+  /**
+   * Fired by the "Layout" entry of a slide's context menu in `<SlidesPane>`,
+   * after that slide is made active; the host owns rendering the Layout
+   * gallery (for example anchored at the click point).
+   */
+  onOpenLayoutGallery?: (request: SlidesPaneLayoutGalleryRequest) => void;
 }
 interface ViewerBuildingBlocksResult {
   /** Connection and presence state for a custom status bar, or null when disabled. */
@@ -1143,6 +1215,12 @@ interface ViewerBuildingBlocksResult {
   toolbarProps: ToolbarProps;
   /** Flat, self-contained props for the standalone `<SlideCanvas>` component. */
   canvasProps: SlideCanvasProps;
+  /**
+   * Flat, self-contained props for the standalone `<SlidesPane>` component:
+   * the slide thumbnail rail `PowerPointViewer` shows beside the canvas.
+   * Its open state is the toolbar's sidebar toggle.
+   */
+  slidesPaneProps: SlidesPaneSidebarProps;
   /** Current viewer mode (edit, view, present, master). */
   mode: ViewerMode;
   /** True while the initial parse of `content` is in progress. */
@@ -1162,6 +1240,9 @@ declare function Toolbar(p: ToolbarProps): React$1__default.ReactElement;
 //#region src/viewer/components/SlideCanvas.d.ts
 declare function SlideCanvas(props: SlideCanvasProps): React$1.JSX.Element;
 //#endregion
+//#region src/viewer/components/SlidesPaneSidebar.d.ts
+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;
+//#endregion
 //#region src/viewer/components/SlideTemplateGalleryDialog.d.ts
 interface SlideTemplateGalleryDialogProps {
   isOpen: boolean;
@@ -1199,5 +1280,5 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
  */
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
-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 };
+export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, SlidesPaneSidebar as SlidesPane, Toolbar, ViewerThemeProvider, getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks, useViewerTheme };
+export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, PptxI18nProviderProps, PptxTranslate, PptxTranslateParams, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, SlidesPaneSidebarProps as SlidesPaneProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerLoadDetail };

package/dist/index.js

@@ -1,7 +1,8 @@
 'use strict';
 
-var chunkV7JICDSL_js = require('./chunk-V7JICDSL.js');
-var chunkOIQAJR57_js = require('./chunk-OIQAJR57.js');
+var chunkCNCPFDFS_js = require('./chunk-CNCPFDFS.js');
+require('./chunk-F6WCYCHV.js');
+var chunkBL2P6K67_js = require('./chunk-BL2P6K67.js');
 var chunk5KFSMXI4_js = require('./chunk-5KFSMXI4.js');
 require('./chunk-PIRHQTI4.js');
 var pptx = require('ooxml-ui/pptx');
@@ -11,87 +12,91 @@ var i18n = require('ooxml-ui/pptx/i18n');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.PowerPointViewer; }
+  get: function () { return chunkCNCPFDFS_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "PptxI18nProvider", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.PptxI18nProvider; }
+  get: function () { return chunkCNCPFDFS_js.PptxI18nProvider; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.SlideCanvas; }
+  get: function () { return chunkCNCPFDFS_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkCNCPFDFS_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.SlideTemplatePreview; }
+  get: function () { return chunkCNCPFDFS_js.SlideTemplatePreview; }
+});
+Object.defineProperty(exports, "SlidesPane", {
+  enumerable: true,
+  get: function () { return chunkCNCPFDFS_js.SlidesPaneSidebar; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.THEME_CATALOG; }
+  get: function () { return chunkCNCPFDFS_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.Toolbar; }
+  get: function () { return chunkCNCPFDFS_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.ViewerThemeProvider; }
+  get: function () { return chunkCNCPFDFS_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.defaultCssVars; }
+  get: function () { return chunkCNCPFDFS_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.defaultRadius; }
+  get: function () { return chunkCNCPFDFS_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.defaultThemeColors; }
+  get: function () { return chunkCNCPFDFS_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkCNCPFDFS_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.themeToCssVars; }
+  get: function () { return chunkCNCPFDFS_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.useViewerTheme; }
+  get: function () { return chunkCNCPFDFS_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.vermilionDarkColors; }
+  get: function () { return chunkCNCPFDFS_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.vermilionDarkTheme; }
+  get: function () { return chunkCNCPFDFS_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.vermilionLightColors; }
+  get: function () { return chunkCNCPFDFS_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.vermilionLightTheme; }
+  get: function () { return chunkCNCPFDFS_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkV7JICDSL_js.vermilionRadius; }
+  get: function () { return chunkCNCPFDFS_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkOIQAJR57_js.renderToCanvas; }
+  get: function () { return chunkBL2P6K67_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkOIQAJR57_js.useViewerBuildingBlocks; }
+  get: function () { return chunkBL2P6K67_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,

package/dist/index.mjs

@@ -1,5 +1,6 @@
-export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-EXSGJHOH.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-64BFLDBT.mjs';
+export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, SlidesPaneSidebar as SlidesPane, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-NESLWTLG.mjs';
+import './chunk-NE5JQMED.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-EZRO5ETF.mjs';
 export { getAnimationInitialStyle } from './chunk-MR3ZSEHS.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';

package/dist/internals.d.ts

@@ -1,4 +1,4 @@
-import { CollaborationRole, CollaborationConfig, HistoryTheme, 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, GoogleFontsOption, PptxLoadLimits, 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, HistoryTheme, PowerPointViewerAPI, ViewerCustomizationApi, PptxAutosaveStatus, ShapeAdjustmentHandleDescriptor, EditorHistoryController, 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, GoogleFontsOption, PptxLoadLimits, ToolbarActionId, SlidesPaneLayoutGalleryRequest, 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, PptxTheme, PptxSlideMaster, ShapeStyle, PptxCommentMention, SmartArtLayout, InkPptxElement, ShapePptxElement, MergeShapeOperation, PptxSlideTransition, PptxAction, PptxModernCommentAuthor, 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';
@@ -685,6 +685,8 @@ interface EditorHistoryResult {
    * behind them: a Slide Master view command removed a layout the package cannot get back.
    */
   forgetHistory: (reaches: (snapshot: EditorHistorySnapshot) => boolean) => void;
+  /** Route Undo and Redo through a room's history while attached (returns the detach). */
+  attachCollaboration: EditorHistoryController<EditorHistorySnapshot>['attachCollaboration'];
   /**
    * Pause (`true`) and resume (`false`) change tracking. A gallery hover preview swaps the
    * slides in for a moment; while tracking is held that is neither an undo step nor an edit, and
@@ -848,7 +850,7 @@ interface UseCanvasInteractionsInput {
    * (AutoCorrect, Options > Proofing). Applied only to user-typed commits,
    * never to programmatic segment remaps.
    */
-  transformCommittedText?: (text: string) => string;
+  transformCommittedText?: (text: string, previous?: string) => string;
 }
 declare function useCanvasInteractions(input: UseCanvasInteractionsInput): CanvasInteractionHandlers;
 //#endregion
@@ -1418,7 +1420,7 @@ interface UseTableOperationsInput {
   ops: ElementOperations;
   history: EditorHistoryResult;
   /** AutoCorrect transform applied to committed table-cell text edits. */
-  transformCommittedText?: (text: string) => string;
+  transformCommittedText?: (text: string, previous?: string) => string;
 }
 interface TableStructHandlers {
   handleCommitCellEdit: (elementId: string, rowIndex: number, colIndex: number, text: string) => void;
@@ -2088,7 +2090,7 @@ interface UseEditorOperationsInput {
   /** Ref to the loaded PPTX handler; populated by the content-lifecycle hook. */
   handlerRef?: React$1.RefObject<PptxHandler | null> | React$1.MutableRefObject<PptxHandler | null>;
   /** AutoCorrect transform applied to committed inline text edits. */
-  transformCommittedText?: (text: string) => string;
+  transformCommittedText?: (text: string, previous?: string) => string;
   /** Host keyboard customisation, forwarded to the Find shortcut. */
   keyboard?: ResolvedKeyboardCustomization;
 }
@@ -2308,6 +2310,49 @@ interface SlideCanvasProps {
   outlineAuthoring?: OutlineAuthoringProps;
 }
 //#endregion
+//#region src/viewer/components/slides-pane/types.d.ts
+interface SlidesPaneSidebarProps {
+  slides: PptxSlide[];
+  templateElementsBySlideId: Record<string, PptxElement[]>;
+  activeSlideIndex: number;
+  canvasSize: CanvasSize$1;
+  sectionGroups: SlideSectionGroup[];
+  isOpen: boolean;
+  canEdit: boolean;
+  onSelectSlide: (index: number) => void;
+  onSlideContextMenu: (e: React$1.MouseEvent, index: number) => void;
+  onMoveSlide: (fromIndex: number, toIndex: number) => void;
+  onAddSlide: () => void;
+  onAddSlideAfter: (index: number) => void;
+  onDuplicateSlides: (indexes: number[]) => void;
+  onDeleteSlides: (indexes: number[]) => void;
+  onHideSlides: (indexes: number[]) => void;
+  /** Makes `index` active, then opens the Layout gallery anchored at (x, y). */
+  onOpenLayoutForSlide: (index: number, x: number, y: number) => void;
+  onCollapse: () => void;
+  onAddSection?: (name: string, afterSlideIndex: number) => void;
+  onRenameSection?: (sectionId: string, newName: string) => void;
+  onDeleteSection?: (sectionId: string) => void;
+  onMoveSectionUp?: (sectionId: string) => void;
+  onMoveSectionDown?: (sectionId: string) => void;
+  /**
+   * Persist the collapse flag onto the section model, so it round-trips
+   * through save exactly as it does in the other four bindings.
+   */
+  onToggleSectionCollapse?: (sectionId: string) => void;
+  /** Recorded rehearsal timings in ms, keyed by slide index. */
+  rehearsalTimings?: Record<number, number>;
+  /** Width of the panel in pixels (for resizable panels). */
+  panelWidth?: number;
+  /**
+   * Presentation-wide field context (date/header/footer/custom props) so
+   * thumbnails substitute the same field placeholders as the canvas.
+   */
+  fieldContext?: FieldSubstitutionContext;
+  /** Theme + table style map so thumbnails resolve table band/header colours. */
+  tableStyleContext?: TableStyleContext;
+}
+//#endregion
 //#region src/viewer/hooks/useAutosave.d.ts
 /** The one autosave status every binding renders (`PptxAutosaveStatus` in `ooxml-ui/pptx`). */
 type AutosaveStatus = PptxAutosaveStatus;
@@ -2415,6 +2460,12 @@ interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
   onOpenHeaderFooter?: () => void;
   /** Fired by the toolbar's "Share" button; the host owns rendering that dialog. */
   onOpenShareDialog?: () => void;
+  /**
+   * Fired by the "Layout" entry of a slide's context menu in `<SlidesPane>`,
+   * after that slide is made active; the host owns rendering the Layout
+   * gallery (for example anchored at the click point).
+   */
+  onOpenLayoutGallery?: (request: SlidesPaneLayoutGalleryRequest) => void;
 }
 interface ViewerBuildingBlocksResult {
   /** Connection and presence state for a custom status bar, or null when disabled. */
@@ -2430,6 +2481,12 @@ interface ViewerBuildingBlocksResult {
   toolbarProps: ToolbarProps;
   /** Flat, self-contained props for the standalone `<SlideCanvas>` component. */
   canvasProps: SlideCanvasProps;
+  /**
+   * Flat, self-contained props for the standalone `<SlidesPane>` component:
+   * the slide thumbnail rail `PowerPointViewer` shows beside the canvas.
+   * Its open state is the toolbar's sidebar toggle.
+   */
+  slidesPaneProps: SlidesPaneSidebarProps;
   /** Current viewer mode (edit, view, present, master). */
   mode: ViewerMode;
   /** True while the initial parse of `content` is in progress. */
@@ -3126,7 +3183,7 @@ interface UseSerializeInput {
   inlineEditingTextRef: React$1.MutableRefObject<string>;
   inlineEditingSnapshotRef?: React$1.MutableRefObject<InlineTextEditSnapshot | undefined>;
   inlineEditingReaderRef?: React$1.MutableRefObject<PendingInlineEditReader | undefined>;
-  transformCommittedText?: (text: string) => string;
+  transformCommittedText?: (text: string, previous?: string) => string;
   password?: string;
   /**
    * File > Fonts > "Embed fonts in the file". `false` passes
@@ -3642,7 +3699,7 @@ interface UseContentLifecycleInput {
   actionSoundHandlerRef: React$1.MutableRefObject<PptxHandler | null>;
   setIsEncryptedDialogOpen: React$1.Dispatch<React$1.SetStateAction<boolean>>;
   password?: string;
-  transformCommittedText?: (text: string) => string;
+  transformCommittedText?: (text: string, previous?: string) => string;
   /** Forwarded to {@link useLoadContent}: fires after a parse applies. */
   onContentApplied?: () => void;
   /** Forwarded to {@link useLoadContent}: File > Options > Trust Center > "Allow external content". */
@@ -3718,7 +3775,7 @@ declare function useKeyboardShortcutWiring(input: UseKeyboardShortcutWiringInput
 //#endregion
 //#region src/viewer/hooks/useViewerIntegration.d.ts
 interface UseViewerIntegrationInput {
-  transformCommittedText?: (text: string) => string;
+  transformCommittedText?: (text: string, previous?: string) => string;
   state: ViewerState;
   zoom: UseZoomViewportResult;
   history: EditorHistoryResult;