pptx-svelte-viewer 4.75.0 → 4.76.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
-import { PrintSettings, CanvasSize, RasterizeElementResult, RasterizeElementTilesResult, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, GoogleFontsOption, ListConversionScope, PptxLoadLimits, ToolbarActionId, RibbonAddInTab, RibbonDisplayMode, ViewerCustomization, DocumentStorage, CloudFileProvider, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, CollaborationInput, CollaborationConfig, CollaborationState, PowerPointViewerAPI, ViewerCustomizationApi, PptxAutosaveStatusKind, DeckSaveIntent, InlineTextDraft, AnimationGroup, AlignEdge, DistributeAxis, MergeShapeOperation, PasteSpecialFormat, CropSession, CropElementUpdate, TemplateElementMap, HistoryTheme, ElementBoxPatch, EditorHistoryController, InkStrokeView, InkPoint, MasterViewCrudAction, MasterViewCrudActionId, FreeformToolKind, EditPointsElementPatch, SlideTemplateId, SlideTemplateBuildOptions, SlidePasteRequest, RibbonTransitionDraft, CellCoord, CellRect, PendingInlineTextEdit, InlineListController, ElementClipboardPayload, TableStyleSaveOptions, FontEmbeddingDescriptor, InlineTextEditSnapshot, SnapGuideInput, CollaborationLivePatcher, InlineTextDraftSink, ResolvedKeyboardCustomization, MarqueeRect, ShapeAdjustmentHandleDescriptor, SnapLine, ResizeHandleId, ConnectorEndpointKind, CollaborationInlineEditor, FindResult, CollaborationTransport, YDocLike, YjsFactories, CollabProviderHandle, CollaborationHistoryTarget, RemoteCursor, SanitizedPresence, CollabLoadOrigin, BroadcastConfig, PptxSaveSnapshot, PptxSaveAcknowledgement, ElementAnimationState, AuthoredSlideRange, RunProgramNotice, ZoomNavigationTarget, PresentationSnapshot, AutosaveRecoveryPrompt, CompatibilityWarningToast, SlideSizeEmu, DeckWebfontProgress, LoadLimitTranslate, ReadOnlyRecommendation, ReadOnlyBannerPasswordError, ViewerOptions, ViewerOptionsStoreInit, ViewerPreferences, ToolbarTabId, ViewerOptionsGroupId, ViewerOptionPrimitive, ViewerOptionsConstraints, CompareResult, Guide, DeckViewPreferences, CollaborationShellState, ViewerMode, AutosaveDisabledReason, MobileSheetKey, CloudDocumentController, SaveProgressController, FieldSubstitutionContext, SlidesPaneLayoutGalleryRequest, ViewerBuildingBlockActions, BuildingBlockToolbarGroup, BuildingBlockToolbarControlId, FindHighlightTarget, PptxBuildingBlockSession, UseViewerBuildingBlocksActionsOptions, BuildingBlockToolbarGroupId } from 'ooxml-ui/pptx';
-export { AutosaveRecord, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCustomization, BuildingBlockRequest, BuildingBlockResult, CANVAS_CONTEXT_MENU_COMMAND_IDS, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationShellState, CollaborationState, CollaborationTransport, ConnectionStatus, ContextMenuCustomization, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, KeyboardCustomization, ListConversionScope, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, RIBBON_CONTROL_IDS, RIBBON_GROUP_IDS, RIBBON_TAB_IDS, RemoteCursor, ResolvedCustomization, RibbonContextualTabId, RibbonControlId, RibbonCustomization, RibbonGroupId, SanitizedPresence, SavedPresentationFormat, SessionDeck, ShortcutChord, SlidesPaneLayoutGalleryRequest, TOOLBAR_BUTTON_IDS, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, ViewerBuildingBlockActions, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerPanelId, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, describeCollaborationShellState, forgetSessionDeck, getAutosaveSnapshot, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, listAutosaveSnapshots, loadPresentationDeck, loadSessionDeck, parsePresentationSessionId, presentationBaseName, rememberSessionDeck, restoreSessionDeck, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from 'ooxml-ui/pptx';
+import { PrintSettings, CanvasSize, RasterizeElementResult, RasterizeElementTilesResult, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, GoogleFontsOption, ListConversionScope, PptxLoadLimits, ToolbarActionId, RibbonAddInTab, RibbonDisplayMode, ViewerCustomization, DocumentStorage, CloudFileProvider, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, CollaborationInput, CollaborationConfig, CollaborationState, PowerPointViewerAPI, ViewerCustomizationApi, PptxAutosaveStatusKind, DeckSaveIntent, InlineTextDraft, AnimationGroup, AlignEdge, DistributeAxis, MergeShapeOperation, PasteSpecialFormat, CropSession, CropElementUpdate, TemplateElementMap, HistoryTheme, ElementBoxPatch, EditorHistoryController, InkStrokeView, InkPoint, MasterViewCrudAction, MasterViewCrudActionId, FreeformToolKind, EditPointsElementPatch, SlideTemplateId, SlideTemplateBuildOptions, SlidePasteRequest, RibbonTransitionDraft, CellCoord, CellRect, PendingInlineTextEdit, InlineListController, ElementClipboardPayload, TableStyleSaveOptions, FontEmbeddingDescriptor, InlineTextEditSnapshot, SnapGuideInput, CollaborationLivePatcher, InlineTextDraftSink, ResolvedKeyboardCustomization, MarqueeRect, ShapeAdjustmentHandleDescriptor, SnapLine, ResizeHandleId, ConnectorEndpointKind, CollaborationInlineEditor, FindResult, CollaborationTransport, YDocLike, YjsFactories, CollabProviderHandle, CollaborationHistoryTarget, RemoteCursor, SanitizedPresence, CollabLoadOrigin, BroadcastConfig, PptxSaveSnapshot, PptxSaveAcknowledgement, ElementAnimationState, AuthoredSlideRange, RunProgramNotice, ZoomNavigationTarget, PresentationSnapshot, AutosaveRecoveryPrompt, CompatibilityWarningToast, SlideSizeEmu, DeckWebfontProgress, LoadLimitTranslate, ReadOnlyRecommendation, ReadOnlyBannerPasswordError, ViewerOptions, ViewerOptionsStoreInit, ViewerPreferences, ToolbarTabId, ViewerOptionsGroupId, ViewerOptionPrimitive, ViewerOptionsConstraints, CompareResult, Guide, DeckViewPreferences, CollaborationShellState, ViewerMode, AutosaveDisabledReason, MobileSheetKey, CloudDocumentController, SaveProgressController, FieldSubstitutionContext, SlidesPaneLayoutGalleryRequest, ViewerBuildingBlockActions, BuildingBlockToolbarGroup, BuildingBlockToolbarControlId, SlideFindHighlights, PptxBuildingBlockSession, UseViewerBuildingBlocksActionsOptions, BuildingBlockToolbarGroupId } from 'ooxml-ui/pptx';
+export { AutosaveRecord, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCustomization, BuildingBlockRequest, BuildingBlockResult, CANVAS_CONTEXT_MENU_COMMAND_IDS, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationShellState, CollaborationState, CollaborationTransport, ConnectionStatus, ContextMenuCustomization, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, ElementRenderErrorContext, ElementRenderErrorHandler, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, KeyboardCustomization, ListConversionScope, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, RIBBON_CONTROL_IDS, RIBBON_GROUP_IDS, RIBBON_TAB_IDS, RemoteCursor, ResolvedCustomization, RibbonContextualTabId, RibbonControlId, RibbonCustomization, RibbonGroupId, SanitizedPresence, SavedPresentationFormat, SessionDeck, ShortcutChord, SlidesPaneLayoutGalleryRequest, TOOLBAR_BUTTON_IDS, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, ViewerBuildingBlockActions, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerPanelId, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, describeCollaborationShellState, forgetSessionDeck, getAutosaveSnapshot, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, listAutosaveSnapshots, loadPresentationDeck, loadSessionDeck, parsePresentationSessionId, presentationBaseName, rememberSessionDeck, restoreSessionDeck, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from 'ooxml-ui/pptx';
 import { Component } from 'svelte';
 import { PptxAiConfig, PptxAiBridge } from 'ooxml-ui/pptx/ai';
 export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
@@ -308,6 +308,14 @@ interface PowerPointViewerProps extends ViewportFitOptions {
      * `localStorage` automatically.
      */
     onThemeChange?: (themeKey: string) => void;
+    /**
+     * Reports a slide element omitted after a render or effect error, on every surface of the
+     * viewer (canvas, thumbnails, slide show, reading view, previews), with
+     * `{ elementId, elementType, slideId }`. Camel-cased like `onThemeChange` because it is the
+     * same reporter option the building blocks take. Defaults to `console.error(error, context)`,
+     * also used when this callback throws.
+     */
+    onElementRenderError?: ooxml_ui_pptx.ElementRenderErrorHandler;
     /**
      * Initial File > Options > Language selection (locale code). Falls back to
      * a value persisted in `localStorage`, then the `locale` prop. Once the
@@ -3740,7 +3748,7 @@ declare const SlidesPane: Component<SlidesPaneProps>;
 declare const SlideThumbnail: Component<SlideThumbnailProps>;
 
 /** The viewer options the building blocks take (they mount no chrome of their own). */
-type ForwardedProps = 'fileName' | 'filePath' | 'initialSlide' | 'locale' | 'googleFonts' | 'listConversionScope' | 'allowExternalContent' | 'limits' | 'authorName' | 'collaboration' | 'fitPadding' | 'maxFitScale';
+type ForwardedProps = 'fileName' | 'filePath' | 'initialSlide' | 'locale' | 'googleFonts' | 'listConversionScope' | 'allowExternalContent' | 'limits' | 'authorName' | 'collaboration' | 'fitPadding' | 'maxFitScale' | 'onElementRenderError';
 interface ViewerBuildingBlocksOptions extends Pick<PowerPointViewerProps, ForwardedProps>, UseViewerBuildingBlocksActionsOptions {
     /** The presentation bytes, or null while no file is open. */
     content?: Uint8Array | ArrayBuffer | null | undefined;
@@ -3776,6 +3784,13 @@ interface ViewerBuildingBlocksState {
     readonly canUndo: boolean;
     readonly canRedo: boolean;
     readonly dirty: boolean;
+    /**
+     * Effective edit permission plus connection and presence counts, as React's `shellState`;
+     * pass it to `describeCollaborationShellState` for a localised status line.
+     */
+    readonly shellState: CollaborationShellState;
+    /** The shared `CollaborationState` of the room the canvas is in (`COLLABORATION_OFF` when none). */
+    readonly collaborationState: CollaborationState;
 }
 /** The DOM handles the canvas block reports back (the viewer state measures and listens through them). */
 interface ViewerBuildingBlocksCanvasHandles {
@@ -3802,8 +3817,8 @@ interface ViewerBuildingBlocks {
     runToolbarControl(id: BuildingBlockToolbarControlId): void;
     /** Props for the slides pane block (`createSlidesPaneProps` over the viewer state). */
     readonly slidesPaneProps: SlidesPaneProps;
-    /** The elements of the active slide holding find matches, for the canvas outline. */
-    readonly findHighlights: readonly FindHighlightTarget[];
+    /** The find matches of the active slide the canvas marks in the text, by element. */
+    readonly findHighlights: SlideFindHighlights;
     /** Translate a dictionary key with the blocks' locale. */
     t(key: string): string;
     /** The viewer state behind the blocks, for the imperative API (`deck`, `editingApi`, ...). */