pptx-svelte-viewer 4.74.0 → 4.75.0

package/dist/i18n/de.cjs

@@ -4743,6 +4743,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "{{name}}-\xDCbergang",
   "pptx.ribbon.collapseRibbon": "Men\xFCband reduzieren",
   "pptx.ribbon.expandRibbon": "Men\xFCband erweitern",
+  "pptx.ribbon.displayOptions": "Men\xFCband-Anzeigeoptionen",
+  "pptx.ribbon.display.fullScreen": "Vollbildmodus",
+  "pptx.ribbon.display.tabs": "Nur Registerkarten anzeigen",
+  "pptx.ribbon.display.always": "Men\xFCband immer anzeigen",
+  "pptx.ribbon.showRibbon": "Men\xFCband anzeigen",
   "pptx.ribbon.open": "\xD6ffnen",
   "pptx.ribbon.openAnotherPresentation": "\xD6ffnen Sie eine andere Pr\xE4sentation",
   "pptx.ribbon.saveAsPptx": "Als .pptx speichern",

package/dist/i18n/de.mjs

@@ -4717,6 +4717,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "{{name}}-\xDCbergang",
   "pptx.ribbon.collapseRibbon": "Men\xFCband reduzieren",
   "pptx.ribbon.expandRibbon": "Men\xFCband erweitern",
+  "pptx.ribbon.displayOptions": "Men\xFCband-Anzeigeoptionen",
+  "pptx.ribbon.display.fullScreen": "Vollbildmodus",
+  "pptx.ribbon.display.tabs": "Nur Registerkarten anzeigen",
+  "pptx.ribbon.display.always": "Men\xFCband immer anzeigen",
+  "pptx.ribbon.showRibbon": "Men\xFCband anzeigen",
   "pptx.ribbon.open": "\xD6ffnen",
   "pptx.ribbon.openAnotherPresentation": "\xD6ffnen Sie eine andere Pr\xE4sentation",
   "pptx.ribbon.saveAsPptx": "Als .pptx speichern",

package/dist/i18n/es.cjs

@@ -4743,6 +4743,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transici\xF3n {{name}}",
   "pptx.ribbon.collapseRibbon": "Contraer la cinta",
   "pptx.ribbon.expandRibbon": "Expandir la cinta",
+  "pptx.ribbon.displayOptions": "Opciones de presentaci\xF3n de la cinta",
+  "pptx.ribbon.display.fullScreen": "Modo de pantalla completa",
+  "pptx.ribbon.display.tabs": "Mostrar solo pesta\xF1as",
+  "pptx.ribbon.display.always": "Mostrar siempre la cinta",
+  "pptx.ribbon.showRibbon": "Mostrar la cinta",
   "pptx.ribbon.open": "Abrir",
   "pptx.ribbon.openAnotherPresentation": "Abrir otra presentaci\xF3n",
   "pptx.ribbon.saveAsPptx": "Guardar como .pptx",

package/dist/i18n/es.mjs

@@ -4717,6 +4717,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transici\xF3n {{name}}",
   "pptx.ribbon.collapseRibbon": "Contraer la cinta",
   "pptx.ribbon.expandRibbon": "Expandir la cinta",
+  "pptx.ribbon.displayOptions": "Opciones de presentaci\xF3n de la cinta",
+  "pptx.ribbon.display.fullScreen": "Modo de pantalla completa",
+  "pptx.ribbon.display.tabs": "Mostrar solo pesta\xF1as",
+  "pptx.ribbon.display.always": "Mostrar siempre la cinta",
+  "pptx.ribbon.showRibbon": "Mostrar la cinta",
   "pptx.ribbon.open": "Abrir",
   "pptx.ribbon.openAnotherPresentation": "Abrir otra presentaci\xF3n",
   "pptx.ribbon.saveAsPptx": "Guardar como .pptx",

package/dist/i18n/fr.cjs

@@ -4743,6 +4743,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transition {{name}}",
   "pptx.ribbon.collapseRibbon": "R\xE9duire le ruban",
   "pptx.ribbon.expandRibbon": "D\xE9velopper le ruban",
+  "pptx.ribbon.displayOptions": "Options d'affichage du ruban",
+  "pptx.ribbon.display.fullScreen": "Mode Plein \xE9cran",
+  "pptx.ribbon.display.tabs": "Afficher les onglets uniquement",
+  "pptx.ribbon.display.always": "Toujours afficher le ruban",
+  "pptx.ribbon.showRibbon": "Afficher le ruban",
   "pptx.ribbon.open": "Ouvrir",
   "pptx.ribbon.openAnotherPresentation": "Ouvrir une autre pr\xE9sentation",
   "pptx.ribbon.saveAsPptx": "Enregistrer sous .pptx",

package/dist/i18n/fr.mjs

@@ -4717,6 +4717,11 @@ var translations21 = {
   "pptx.ribbon.transitionTitle": "Transition {{name}}",
   "pptx.ribbon.collapseRibbon": "R\xE9duire le ruban",
   "pptx.ribbon.expandRibbon": "D\xE9velopper le ruban",
+  "pptx.ribbon.displayOptions": "Options d'affichage du ruban",
+  "pptx.ribbon.display.fullScreen": "Mode Plein \xE9cran",
+  "pptx.ribbon.display.tabs": "Afficher les onglets uniquement",
+  "pptx.ribbon.display.always": "Toujours afficher le ruban",
+  "pptx.ribbon.showRibbon": "Afficher le ruban",
   "pptx.ribbon.open": "Ouvrir",
   "pptx.ribbon.openAnotherPresentation": "Ouvrir une autre pr\xE9sentation",
   "pptx.ribbon.saveAsPptx": "Enregistrer sous .pptx",

package/dist/i18n/zh-CN.cjs

@@ -4758,6 +4758,11 @@ var translations27 = {
   "pptx.ribbon.transitionTitle": "{{name}} \u5207\u6362",
   "pptx.ribbon.collapseRibbon": "\u6298\u53E0\u529F\u80FD\u533A",
   "pptx.ribbon.expandRibbon": "\u5C55\u5F00\u529F\u80FD\u533A",
+  "pptx.ribbon.displayOptions": "\u529F\u80FD\u533A\u663E\u793A\u9009\u9879",
+  "pptx.ribbon.display.fullScreen": "\u5168\u5C4F\u6A21\u5F0F",
+  "pptx.ribbon.display.tabs": "\u4EC5\u663E\u793A\u9009\u9879\u5361",
+  "pptx.ribbon.display.always": "\u59CB\u7EC8\u663E\u793A\u529F\u80FD\u533A",
+  "pptx.ribbon.showRibbon": "\u663E\u793A\u529F\u80FD\u533A",
   "pptx.ribbon.open": "\u6253\u5F00",
   "pptx.ribbon.openAnotherPresentation": "\u6253\u5F00\u53E6\u4E00\u4E2A\u6F14\u793A\u6587\u7A3F",
   "pptx.ribbon.saveAsPptx": "\u53E6\u5B58\u4E3A .pptx",

package/dist/i18n/zh-CN.mjs

@@ -4732,6 +4732,11 @@ var translations27 = {
   "pptx.ribbon.transitionTitle": "{{name}} \u5207\u6362",
   "pptx.ribbon.collapseRibbon": "\u6298\u53E0\u529F\u80FD\u533A",
   "pptx.ribbon.expandRibbon": "\u5C55\u5F00\u529F\u80FD\u533A",
+  "pptx.ribbon.displayOptions": "\u529F\u80FD\u533A\u663E\u793A\u9009\u9879",
+  "pptx.ribbon.display.fullScreen": "\u5168\u5C4F\u6A21\u5F0F",
+  "pptx.ribbon.display.tabs": "\u4EC5\u663E\u793A\u9009\u9879\u5361",
+  "pptx.ribbon.display.always": "\u59CB\u7EC8\u663E\u793A\u529F\u80FD\u533A",
+  "pptx.ribbon.showRibbon": "\u663E\u793A\u529F\u80FD\u533A",
   "pptx.ribbon.open": "\u6253\u5F00",
   "pptx.ribbon.openAnotherPresentation": "\u6253\u5F00\u53E6\u4E00\u4E2A\u6F14\u793A\u6587\u7A3F",
   "pptx.ribbon.saveAsPptx": "\u53E6\u5B58\u4E3A .pptx",

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, 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, 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 } from 'ooxml-ui/pptx';
-export { AutosaveRecord, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCustomization, 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, 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, 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 { Component } from 'svelte';
 import { PptxAiConfig, PptxAiBridge } from 'ooxml-ui/pptx/ai';
 export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
@@ -401,6 +401,13 @@ interface PowerPointViewerProps extends ViewportFitOptions {
      * drawn as its items. The desktop ribbon shows them; the phone chrome does not.
      */
     ribbonAddIns?: readonly RibbonAddInTab[];
+    /**
+     * Starting Ribbon Display Options mode: `always` (Always show Ribbon, the
+     * default), `tabs` (Show tabs only) or `fullScreen` (Full-screen mode).
+     * Changing it from the host applies the mode; the user's own choices are
+     * reported through `onribbondisplaychange`.
+     */
+    ribbonDisplay?: RibbonDisplayMode;
     /**
      * Framework-neutral UI customisation. See docs/guide/customization.md.
      *
@@ -532,6 +539,12 @@ interface PowerPointViewerProps extends ViewportFitOptions {
     /** Fired before following a link; return false to cancel its default action. */
     onhyperlinkclick?: ooxml_ui_pptx.HyperlinkClickHandler;
     onzoomchange?: (zoom: number) => void;
+    /**
+     * Fired when the user picks a Ribbon Display Options mode (the menu on the
+     * tab row, Ctrl+F1, or a double click on a tab). Not fired when the host
+     * changes `ribbonDisplay`.
+     */
+    onribbondisplaychange?: (mode: RibbonDisplayMode) => void;
     onselectionchange?: (elementIds: string[]) => void;
     onslidecountchange?: (count: number) => void;
     /** Host override for the File > Open action. */
@@ -2504,7 +2517,7 @@ declare class ViewerState {
  * `PowerPointViewer` instance API. The undo/redo/save half lives in
  * `editing-api.ts` and the export half in `export/exporting-api.ts`.
  */
-type DeckApi = Omit<PowerPointViewerAPI, 'getContent' | 'undo' | 'redo' | 'canUndo' | 'canRedo'>;
+type DeckApi = Omit<PowerPointViewerAPI, 'getContent' | 'undo' | 'redo' | 'canUndo' | 'canRedo' | 'getSaveRevision' | 'getSaveSnapshot' | 'acknowledgeSave'>;
 
 /** The imperative editing API exposed on the `PowerPointViewer` instance. */
 interface EditingApi {
@@ -2519,6 +2532,12 @@ interface EditingApi {
     downloadAs(format: PptxSaveFormat, fileName?: string): Promise<void>;
     /** File > Save as `.pptx` (reported to host storage as `save`). */
     downloadPptx(fileName?: string): Promise<void>;
+    /** The revision of the document as it is now (see `createSaveRevisionController`). */
+    getSaveRevision(): number;
+    /** Serialise for a host that persists the deck itself; leaves the document dirty. */
+    getSaveSnapshot(): Promise<PptxSaveSnapshot>;
+    /** The host persisted `revision`: clean only if it is still current. */
+    acknowledgeSave(revision: number): PptxSaveAcknowledgement;
 }
 
 /**
@@ -3720,5 +3739,118 @@ interface SlideThumbnailProps {
 declare const SlidesPane: Component<SlidesPaneProps>;
 declare const SlideThumbnail: Component<SlideThumbnailProps>;
 
-export { PowerPointViewer, SlideThumbnail, SlidesPane, createSlidesPaneProps, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, registerTranslations, renderToCanvas };
-export type { AutosaveStatus, CreateSlidesPanePropsOptions, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PowerPointViewerApi, PowerPointViewerProps, PrintOptions, SlideThumbnailProps, SlidesPaneProps, SlidesPaneTableStyleContext, SvgExportAllOptions, SvgExportSingleSlideOptions, TranslationDictionary, Translator, ViewerLoadDetail };
+/** 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';
+interface ViewerBuildingBlocksOptions extends Pick<PowerPointViewerProps, ForwardedProps>, UseViewerBuildingBlocksActionsOptions {
+    /** The presentation bytes, or null while no file is open. */
+    content?: Uint8Array | ArrayBuffer | null | undefined;
+    /** Whether editing is enabled. Defaults to false (view-only). */
+    canEdit?: boolean | undefined;
+    /** Whether the built-in AutoRecover snapshots run. Off unless the host opts in. */
+    autosave?: boolean | undefined;
+    /** As React's `userName`: the author of comments (`authorName` wins when both are set). */
+    userName?: string | undefined;
+    /** Toolbar buttons to hide from the compact toolbar (`undo`, `redo`, `insert`, `zoom`, `navigation`). */
+    hiddenActions?: readonly ToolbarActionId[] | undefined;
+    onDirtyChange?: ((dirty: boolean) => void) | undefined;
+    onSlideChange?: ((index: number) => void) | undefined;
+    onLoad?: ((detail: ViewerLoadDetail) => void) | undefined;
+    onError?: ((message: string) => void) | undefined;
+    onContentChange?: ((content: Uint8Array) => void) | undefined;
+    onSelectionChange?: ((elementIds: string[]) => void) | undefined;
+    /**
+     * Fired by the "Layout" entry of a slide's context menu in the slides pane, after that slide is
+     * made active; the host owns rendering the Layout gallery.
+     */
+    onOpenLayoutGallery?: ((request: SlidesPaneLayoutGalleryRequest) => void) | undefined;
+}
+/** The state a custom shell renders around the blocks (a status line, Save enablement). */
+interface ViewerBuildingBlocksState {
+    /** The effective mode: `preview` while the blocks may not edit. */
+    readonly mode: ViewerMode;
+    readonly loading: boolean;
+    readonly error: string | null;
+    /** Zero-based active slide, -1 before a deck loads. */
+    readonly slideIndex: number;
+    readonly slideCount: number;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    readonly dirty: boolean;
+}
+/** The DOM handles the canvas block reports back (the viewer state measures and listens through them). */
+interface ViewerBuildingBlocksCanvasHandles {
+    setRoot(element: HTMLDivElement | undefined): void;
+    setStageHolder(element: HTMLDivElement | undefined): void;
+    setViewportSize(size: {
+        width: number;
+        height: number;
+    }): void;
+}
+/**
+ * The Svelte building blocks: create it once in the component that renders the blocks (it builds
+ * the viewer state, which registers effects and context) and hand it to `BuildingBlocksCanvas`,
+ * `BuildingBlocksToolbar` and `BuildingBlocksSlidesPane` as `blocks`. Every member is a live
+ * runes-backed getter, so reading it in a template or `$derived` tracks the editor.
+ */
+interface ViewerBuildingBlocks {
+    /** Host-owned workflows (pickers, dialogs, Find / Replace, layouts), shared by every binding. */
+    readonly actions: ViewerBuildingBlockActions;
+    readonly state: ViewerBuildingBlocksState;
+    /** The compact toolbar's groups and controls (existing dictionary keys, `describeBuildingBlockToolbar`). */
+    readonly toolbar: BuildingBlockToolbarGroup[];
+    /** Run a compact toolbar control (what the toolbar block's buttons call). */
+    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[];
+    /** Translate a dictionary key with the blocks' locale. */
+    t(key: string): string;
+    /** The viewer state behind the blocks, for the imperative API (`deck`, `editingApi`, ...). */
+    readonly viewerState: ViewerStateBag;
+    /** The shared session, for hosts that register further action groups. */
+    readonly session: PptxBuildingBlockSession;
+    /** What the canvas block reports back; not for hosts. */
+    readonly canvas: ViewerBuildingBlocksCanvasHandles;
+    /** Tear down the viewer state; also runs when the creating component is destroyed. */
+    destroy(): void;
+}
+
+/**
+ * The Svelte building blocks: the shared building-blocks session (`ooxml-ui/pptx`) over the Svelte
+ * editor's viewer state, with `BuildingBlocksCanvas`, `BuildingBlocksToolbar` and
+ * `BuildingBlocksSlidesPane` as the blocks. Call it once, synchronously in the script of the
+ * component that renders them (it creates the viewer state, which registers effects and context),
+ * with a function returning the current options so changes apply live. The blocks mount no
+ * dialogs or pickers: toolbar controls and canvas gestures that need one raise a request
+ * (`onRequest`, `actions.pending`) the host finishes with `actions`.
+ */
+declare function createViewerBuildingBlocks(getOptions: () => ViewerBuildingBlocksOptions): ViewerBuildingBlocks;
+
+/**
+ * Explicitly typed public exports of the building-block components, for the same reason as
+ * `viewer/components/typed-exports.ts`: the declaration bundling cannot resolve `.svelte`
+ * specifiers, so the published `.d.ts` goes through annotated constants.
+ */
+interface BuildingBlocksCanvasProps {
+    blocks: ViewerBuildingBlocks;
+    /** A viewer theme, as `PowerPointViewer`'s `theme`; unset inherits the host's tokens. */
+    theme?: ViewerTheme | undefined;
+    class?: string;
+}
+interface BuildingBlocksToolbarProps {
+    blocks: ViewerBuildingBlocks;
+    /** Show only these groups, in descriptor order. */
+    include?: readonly BuildingBlockToolbarGroupId[] | undefined;
+    class?: string;
+}
+interface BuildingBlocksSlidesPaneProps {
+    blocks: ViewerBuildingBlocks;
+    class?: string;
+}
+declare const BuildingBlocksCanvas: Component<BuildingBlocksCanvasProps>;
+declare const BuildingBlocksToolbar: Component<BuildingBlocksToolbarProps>;
+declare const BuildingBlocksSlidesPane: Component<BuildingBlocksSlidesPaneProps>;
+
+export { BuildingBlocksCanvas, BuildingBlocksSlidesPane, BuildingBlocksToolbar, PowerPointViewer, SlideThumbnail, SlidesPane, createSlidesPaneProps, createViewerBuildingBlocks, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, registerTranslations, renderToCanvas };
+export type { AutosaveStatus, BuildingBlocksCanvasProps, BuildingBlocksSlidesPaneProps, BuildingBlocksToolbarProps, CreateSlidesPanePropsOptions, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PowerPointViewerApi, PowerPointViewerProps, PrintOptions, SlideThumbnailProps, SlidesPaneProps, SlidesPaneTableStyleContext, SvgExportAllOptions, SvgExportSingleSlideOptions, TranslationDictionary, Translator, ViewerBuildingBlocks, ViewerBuildingBlocksOptions, ViewerBuildingBlocksState, ViewerLoadDetail };