pptx-react-viewer 4.54.0 → 4.56.0

package/dist/index.js

@@ -1,8 +1,9 @@
 'use strict';
 
-var chunkRB6MRBJI_js = require('./chunk-RB6MRBJI.js');
-var chunkISNT4VQN_js = require('./chunk-ISNT4VQN.js');
-var chunk3TN5SUQR_js = require('./chunk-3TN5SUQR.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');
 var i18n = require('ooxml-ui/pptx/i18n');
@@ -11,91 +12,95 @@ var i18n = require('ooxml-ui/pptx/i18n');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.PowerPointViewer; }
+  get: function () { return chunkCNCPFDFS_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "PptxI18nProvider", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.PptxI18nProvider; }
+  get: function () { return chunkCNCPFDFS_js.PptxI18nProvider; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.SlideCanvas; }
+  get: function () { return chunkCNCPFDFS_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkCNCPFDFS_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_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 chunkRB6MRBJI_js.THEME_CATALOG; }
+  get: function () { return chunkCNCPFDFS_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.Toolbar; }
+  get: function () { return chunkCNCPFDFS_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.ViewerThemeProvider; }
+  get: function () { return chunkCNCPFDFS_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.defaultCssVars; }
+  get: function () { return chunkCNCPFDFS_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.defaultRadius; }
+  get: function () { return chunkCNCPFDFS_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.defaultThemeColors; }
+  get: function () { return chunkCNCPFDFS_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkCNCPFDFS_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.themeToCssVars; }
+  get: function () { return chunkCNCPFDFS_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.useViewerTheme; }
+  get: function () { return chunkCNCPFDFS_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.vermilionDarkColors; }
+  get: function () { return chunkCNCPFDFS_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.vermilionDarkTheme; }
+  get: function () { return chunkCNCPFDFS_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.vermilionLightColors; }
+  get: function () { return chunkCNCPFDFS_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.vermilionLightTheme; }
+  get: function () { return chunkCNCPFDFS_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkRB6MRBJI_js.vermilionRadius; }
+  get: function () { return chunkCNCPFDFS_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkISNT4VQN_js.renderToCanvas; }
+  get: function () { return chunkBL2P6K67_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkISNT4VQN_js.useViewerBuildingBlocks; }
+  get: function () { return chunkBL2P6K67_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunk3TN5SUQR_js.getAnimationInitialStyle; }
+  get: function () { return chunk5KFSMXI4_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,

package/dist/index.mjs

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

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;