pptx-react-viewer 4.44.0 → 4.46.0

package/dist/index.d.ts

@@ -5,6 +5,8 @@ import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontS
 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';
+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';
@@ -96,6 +98,12 @@ interface CollaborationContextValue {
   synced: boolean;
   /** Manually retry the WebSocket connection after a timeout or error. */
   retry: () => void;
+  /** The local awareness client id, once the session has one. */
+  clientId?: number | null;
+  /** The owner's write-back status, as the document sync last reported it. */
+  writeBack?: CollaborationWriteBackState | undefined;
+  /** Called by the document sync with the write-back status (undefined clears it). */
+  reportWriteBack?: (state: CollaborationWriteBackState | undefined) => void;
 }
 //#endregion
 //#region src/viewer/hooks/useLoadNotifications.d.ts
@@ -314,6 +322,13 @@ interface PowerPointViewerProps extends ViewportFitOptions {
    * Share dialog. The host app should clear the `collaboration` prop.
    */
   onStopCollaboration?: () => void;
+  /**
+   * Reports the shared `CollaborationState` (the contract Word, Excel and Visio
+   * use): called when a session starts or stops (the off state), and when its
+   * connection status, synced flag or people change. Works for viewer-owned and
+   * host-owned (`collaboration.session`) sessions; unchanged states are not repeated.
+   */
+  onCollaborationChange?: (state: CollaborationState) => void;
   /**
    * Default values for the Share dialog fields. The host app should provide
    * these to control the session name, user display name, and server URL.
@@ -976,6 +991,13 @@ interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
   filePath?: string;
   /** Display name for the toolbar's file-name-aware controls (e.g. title bar hosts build themselves). */
   fileName?: string;
+  /**
+   * Zero-based slide shown after each load, clamped into the deck, as `PowerPointViewer`'s
+   * `initialSlide`. It is applied in the same render that shows the loaded deck, so slide 1 is
+   * never shown first. Changing it later applies to the next load, not the current slide; use
+   * the handle's `goTo` to move an open deck.
+   */
+  initialSlide?: number;
   /** Whether the built-in autosave-to-localStorage recovery timer is active. Defaults to true. */
   autosaveEnabled?: boolean;
   /** Display name used as the author for comments. */

package/dist/index.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkYIYIJB3X_js = require('./chunk-YIYIJB3X.js');
-var chunkOYK6O2UM_js = require('./chunk-OYK6O2UM.js');
+var chunk2J3467IB_js = require('./chunk-2J3467IB.js');
+var chunkAMXSOQRH_js = require('./chunk-AMXSOQRH.js');
 var chunkVJZJESNT_js = require('./chunk-VJZJESNT.js');
 require('./chunk-W2IMY5SY.js');
 var pptx = require('ooxml-ui/pptx');
@@ -11,83 +11,83 @@ var i18n = require('ooxml-ui/pptx/i18n');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.PowerPointViewer; }
+  get: function () { return chunk2J3467IB_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.SlideCanvas; }
+  get: function () { return chunk2J3467IB_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunk2J3467IB_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.SlideTemplatePreview; }
+  get: function () { return chunk2J3467IB_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.THEME_CATALOG; }
+  get: function () { return chunk2J3467IB_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.Toolbar; }
+  get: function () { return chunk2J3467IB_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.ViewerThemeProvider; }
+  get: function () { return chunk2J3467IB_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.defaultCssVars; }
+  get: function () { return chunk2J3467IB_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.defaultRadius; }
+  get: function () { return chunk2J3467IB_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.defaultThemeColors; }
+  get: function () { return chunk2J3467IB_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk2J3467IB_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.themeToCssVars; }
+  get: function () { return chunk2J3467IB_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.useViewerTheme; }
+  get: function () { return chunk2J3467IB_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.vermilionDarkColors; }
+  get: function () { return chunk2J3467IB_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.vermilionDarkTheme; }
+  get: function () { return chunk2J3467IB_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.vermilionLightColors; }
+  get: function () { return chunk2J3467IB_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.vermilionLightTheme; }
+  get: function () { return chunk2J3467IB_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkYIYIJB3X_js.vermilionRadius; }
+  get: function () { return chunk2J3467IB_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkOYK6O2UM_js.renderToCanvas; }
+  get: function () { return chunkAMXSOQRH_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkOYK6O2UM_js.useViewerBuildingBlocks; }
+  get: function () { return chunkAMXSOQRH_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,

package/dist/index.mjs

@@ -1,5 +1,5 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-W6PDVBAF.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-NXOETWSO.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-CLHUOZSY.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-UQFIRJGG.mjs';
 export { getAnimationInitialStyle } from './chunk-FBN7UFW2.mjs';
 import './chunk-Q3DHYOLK.mjs';
 export { AVATAR_COLOR_SWATCHES, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, CANVAS_CONTEXT_MENU_COMMAND_IDS, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, RIBBON_TAB_IDS, SLIDE_TEMPLATES, TOOLBAR_BUTTON_IDS, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, saveViewerProfile, savedPresentationFileName, writeStoredViewerPrefs } from 'ooxml-ui/pptx';

package/dist/internals.d.ts

@@ -1,6 +1,7 @@
 import { CollaborationRole, CollaborationConfig, PowerPointViewerAPI, ViewerCustomizationApi, ShapeAdjustmentHandleDescriptor, ChangeCaseMode, ResolvedKeyboardCustomization, FindResult, EditorImagePasteOptions, InsertChartKind, PasteSpecialFormat, SlidePasteRequest, SlideTemplateId, MorphTransitionPlan, ElementAnimationState, ZoomNavigationTarget, PresentationSnapshot, 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, FragmentedLayer, PrintSettings, ThemeEditorEdit, CompareResult, ReadOnlyRecommendation, CompatibilityWarningToast, DeviceOrientation, ResolvedCustomization, DeckSavePurpose, ZoomExcursion, TouchGestureCallbacks, 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';
@@ -143,6 +144,12 @@ interface CollaborationContextValue {
   synced: boolean;
   /** Manually retry the WebSocket connection after a timeout or error. */
   retry: () => void;
+  /** The local awareness client id, once the session has one. */
+  clientId?: number | null;
+  /** The owner's write-back status, as the document sync last reported it. */
+  writeBack?: CollaborationWriteBackState | undefined;
+  /** Called by the document sync with the write-back status (undefined clears it). */
+  reportWriteBack?: (state: CollaborationWriteBackState | undefined) => void;
 }
 //#endregion
 //#region src/viewer/types-ui.d.ts
@@ -2243,6 +2250,13 @@ interface UseViewerBuildingBlocksInput extends ViewportFitOptions {
   filePath?: string;
   /** Display name for the toolbar's file-name-aware controls (e.g. title bar hosts build themselves). */
   fileName?: string;
+  /**
+   * Zero-based slide shown after each load, clamped into the deck, as `PowerPointViewer`'s
+   * `initialSlide`. It is applied in the same render that shows the loaded deck, so slide 1 is
+   * never shown first. Changing it later applies to the next load, not the current slide; use
+   * the handle's `goTo` to move an open deck.
+   */
+  initialSlide?: number;
   /** Whether the built-in autosave-to-localStorage recovery timer is active. Defaults to true. */
   autosaveEnabled?: boolean;
   /** Display name used as the author for comments. */
@@ -2546,7 +2560,7 @@ interface UseCollaborativeStateInput {
   canvasWidth: number;
   canvasHeight: number;
 }
-declare function useCollaborativeState({ config, canvasWidth, canvasHeight }: UseCollaborativeStateInput): CollaborationContextValue | null;
+declare function useCollaborativeState({ config: requested, canvasWidth, canvasHeight }: UseCollaborativeStateInput): CollaborationContextValue | null;
 //#endregion
 //#region src/viewer/hooks/collaboration/useCollaborativeHistory.d.ts
 interface UseCollaborativeHistoryInput {
@@ -2581,7 +2595,7 @@ interface UseYjsDocumentSyncInput {
   setSlides: React.Dispatch<React.SetStateAction<PptxSlide[]>>;
   isConnected: boolean;
   isSynced?: boolean;
-  config?: Pick<CollaborationConfig, 'role' | 'onWriteBack' | 'writeBackDebounceMs' | 'externalSession' | 'sessionIntent'>;
+  config?: Pick<CollaborationConfig, 'role' | 'onWriteBack' | 'writeBackDebounceMs' | 'writeBackRetry' | 'externalSession' | 'sessionIntent'>;
   getSourceBytes?: () => Uint8Array | null;
   getSaveOptions?: () => PptxHandlerSaveOptions;
   loadVersion?: number;
@@ -2589,6 +2603,8 @@ interface UseYjsDocumentSyncInput {
   /** External readiness owns this channel together with full-deck writes. */
   livePatcher?: CollaborationLivePatcher;
   onReadOnlyChange?: (readOnly: boolean) => void;
+  /** Receives the owner's write-back status (undefined when the session ends). */
+  onWriteBackStatus?: (state: CollaborationWriteBackState | undefined) => void;
 }
 declare function useYjsDocumentSync(input: UseYjsDocumentSyncInput): void;
 //#endregion