pptx-vue-viewer 4.74.0 → 4.75.0

package/dist/index.d.ts

@@ -6,6 +6,12 @@ import { AutosaveRecord } from 'ooxml-ui/pptx';
 import { BACKSTAGE_CARD_IDS } from 'ooxml-ui/pptx';
 import { BACKSTAGE_PAGE_IDS } from 'ooxml-ui/pptx';
 import { BackstageCustomization } from 'ooxml-ui/pptx';
+import { BuildingBlockGroupPorts } from 'ooxml-ui/pptx';
+import { BuildingBlockRequest } from 'ooxml-ui/pptx';
+import { BuildingBlockResult } from 'ooxml-ui/pptx';
+import { BuildingBlockSessionPort } from 'ooxml-ui/pptx';
+import { BuildingBlockToolbarGroupId } from 'ooxml-ui/pptx';
+import { BuildingBlockToolbarView } from 'ooxml-ui/pptx';
 import { CANVAS_CONTEXT_MENU_COMMAND_IDS } from 'ooxml-ui/pptx';
 import { CanvasSize } from 'ooxml-ui/pptx';
 import { ChangeCaseMode } from 'ooxml-ui/pptx';
@@ -40,6 +46,7 @@ import { ElementUpdateOptions } from 'ooxml-ui/pptx';
 import { ExternalCollaborationAwareness } from 'ooxml-ui/pptx';
 import { ExternalCollaborationSession } from 'ooxml-ui/pptx';
 import { ExternalCollaborationSnapshot } from 'ooxml-ui/pptx';
+import { FindResult } from 'ooxml-ui/pptx';
 import { forgetSessionDeck } from 'ooxml-ui/pptx';
 import { getSessionTabId } from 'ooxml-ui/pptx';
 import { GoogleFontsOption } from 'ooxml-ui/pptx';
@@ -81,6 +88,7 @@ import { PptxAiContextStrategy } from 'ooxml-ui/pptx/ai';
 import { PptxAiToolName } from 'ooxml-ui/pptx/ai';
 import { PptxAiUIMessage } from 'ooxml-ui/pptx/ai';
 import { PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
+import { PptxBuildingBlockSession } from 'ooxml-ui/pptx';
 import { PptxCoreProperties } from 'ooxml-core/pptx';
 import { PptxCustomProperty } from 'ooxml-core/pptx';
 import { PptxCustomShow } from 'ooxml-core/pptx';
@@ -107,14 +115,19 @@ import { RIBBON_TAB_IDS } from 'ooxml-ui/pptx';
 import { RibbonAddInTab } from 'ooxml-ui/pptx';
 import { RibbonContextualTabId } from 'ooxml-ui/pptx';
 import { RibbonCustomization } from 'ooxml-ui/pptx';
+import { RibbonDisplayController } from 'ooxml-ui/pptx';
+import { RibbonDisplayMode } from 'ooxml-ui/pptx';
+import { RibbonDisplayState } from 'ooxml-ui/pptx';
 import { RulerUnit } from 'ooxml-ui/pptx';
 import { SanitizedPresence } from 'ooxml-ui/pptx';
 import { savedPresentationFileName } from 'ooxml-ui/pptx';
 import { SavedPresentationFormat } from 'ooxml-ui/pptx';
 import { SectionSlideGroup } from 'ooxml-ui/pptx';
 import { SessionDeck } from 'ooxml-ui/pptx';
+import { ShallowRef } from 'vue';
 import { ShapeStyle } from 'ooxml-core/pptx';
 import { ShortcutChord } from 'ooxml-ui/pptx';
+import { SlidePasteRequest } from 'ooxml-ui/pptx';
 import { SlidesPaneLayoutGalleryRequest } from 'ooxml-ui/pptx';
 import { SlideTemplateId } from 'ooxml-ui/pptx';
 import { storeAudienceContent } from 'ooxml-ui/pptx';
@@ -126,6 +139,7 @@ import { TOOLBAR_BUTTON_IDS } from 'ooxml-ui/pptx';
 import { ToolbarActionId } from 'ooxml-ui/pptx';
 import { ToolbarButtonId } from 'ooxml-ui/pptx';
 import { ToolbarTabId } from 'ooxml-ui/pptx';
+import { UseViewerBuildingBlocksActionsOptions } from 'ooxml-ui/pptx';
 import { vermilionDarkColors } from 'ooxml-ui/pptx';
 import { vermilionDarkTheme } from 'ooxml-ui/pptx';
 import { vermilionLightColors } from 'ooxml-ui/pptx';
@@ -136,6 +150,7 @@ import { VIEWER_EXPORT_FORMAT_IDS } from 'ooxml-ui/pptx';
 import { VIEWER_FEATURE_IDS } from 'ooxml-ui/pptx';
 import { VIEWER_PANEL_IDS } from 'ooxml-ui/pptx';
 import { ViewerAutosaveStatus } from 'ooxml-ui/pptx';
+import { ViewerBuildingBlockActions } from 'ooxml-ui/pptx';
 import { ViewerCustomization } from 'ooxml-ui/pptx';
 import { ViewerCustomizationApi } from 'ooxml-ui/pptx';
 import { ViewerDialogId } from 'ooxml-ui/pptx';
@@ -165,64 +180,66 @@ declare const __VLS_base_2: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, Compo
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 declare const __VLS_export: DefineComponent<PowerPointViewerProps, PowerPointViewerExpose, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
-    change: () => any;
-    error: (message: string) => any;
-    load: (detail: ViewerLoadDetail) => any;
-    "collaboration-status": (status: ConnectionStatus) => any;
-    autosave: (content: Uint8Array<ArrayBufferLike>) => any;
     "dirty-change": (isDirty: boolean) => any;
     "content-change": (content: Uint8Array<ArrayBufferLike>) => any;
+    autosave: (content: Uint8Array<ArrayBufferLike>) => any;
     "active-slide-change": (value: number) => any;
     "zoom-change": (value: number) => any;
     "slide-count-change": (value: number) => any;
+    "ribbon-display-change": (mode: RibbonDisplayMode) => any;
     "mode-change": (mode: string) => any;
     "selection-change": (elementIds: string[]) => any;
     "start-collaboration": (config: CollaborationConfig) => any;
     "stop-collaboration": () => any;
     "collaboration-change": (state: CollaborationState) => any;
+    load: (detail: ViewerLoadDetail) => any;
+    error: (message: string) => any;
     "autosave-toggle": (enabled: boolean) => any;
     "autosave-status": (status: ViewerAutosaveStatus) => any;
     "autosave-recovery": (record: AutosaveRecord) => any;
+    change: () => any;
     "properties-change": (updates: Partial< PptxCoreProperties>) => any;
     "notes-update": (notes: string) => any;
     "presentation-change": (presenting: boolean) => any;
+    "collaboration-status": (status: ConnectionStatus) => any;
 }, string, PublicProps, Readonly<PowerPointViewerProps> & Readonly<{
-    onChange?: (() => any) | undefined;
-    onError?: ((message: string) => any) | undefined;
-    onLoad?: ((detail: ViewerLoadDetail) => any) | undefined;
-    "onCollaboration-status"?: ((status: ConnectionStatus) => any) | undefined;
-    onAutosave?: ((content: Uint8Array<ArrayBufferLike>) => any) | undefined;
     "onDirty-change"?: ((isDirty: boolean) => any) | undefined;
     "onContent-change"?: ((content: Uint8Array<ArrayBufferLike>) => any) | undefined;
+    onAutosave?: ((content: Uint8Array<ArrayBufferLike>) => any) | undefined;
     "onActive-slide-change"?: ((value: number) => any) | undefined;
     "onZoom-change"?: ((value: number) => any) | undefined;
     "onSlide-count-change"?: ((value: number) => any) | undefined;
+    "onRibbon-display-change"?: ((mode: RibbonDisplayMode) => any) | undefined;
     "onMode-change"?: ((mode: string) => any) | undefined;
     "onSelection-change"?: ((elementIds: string[]) => any) | undefined;
     "onStart-collaboration"?: ((config: CollaborationConfig) => any) | undefined;
     "onStop-collaboration"?: (() => any) | undefined;
     "onCollaboration-change"?: ((state: CollaborationState) => any) | undefined;
+    onLoad?: ((detail: ViewerLoadDetail) => any) | undefined;
+    onError?: ((message: string) => any) | undefined;
     "onAutosave-toggle"?: ((enabled: boolean) => any) | undefined;
     "onAutosave-status"?: ((status: ViewerAutosaveStatus) => any) | undefined;
     "onAutosave-recovery"?: ((record: AutosaveRecord) => any) | undefined;
+    onChange?: (() => any) | undefined;
     "onProperties-change"?: ((updates: Partial< PptxCoreProperties>) => any) | undefined;
     "onNotes-update"?: ((notes: string) => any) | undefined;
     "onPresentation-change"?: ((presenting: boolean) => any) | undefined;
+    "onCollaboration-status"?: ((status: ConnectionStatus) => any) | undefined;
 }>, {
-    allowExternalContent: boolean;
-    canEdit: boolean;
     autosave: boolean;
+    canEdit: boolean;
     readOnly: boolean;
+    showToolbar: boolean;
+    showThumbnails: boolean;
+    showCompatibilityToasts: boolean;
+    smartArt3D: boolean;
+    surfaceChart3D: boolean;
     barChart3D: boolean;
     lineChart3D: boolean;
     areaChart3D: boolean;
     pieChart3D: boolean;
-    surfaceChart3D: boolean;
-    smartArt3D: boolean;
     googleFonts: GoogleFontsOption_2;
-    showToolbar: boolean;
-    showThumbnails: boolean;
-    showCompatibilityToasts: boolean;
+    allowExternalContent: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 declare const __VLS_export_10: DefineComponent<{
@@ -257,6 +274,12 @@ declare const __VLS_export_11: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, Co
     onFollow?: ((clientId: number | null) => any) | undefined;
 }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
+declare const __VLS_export_12: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+declare const __VLS_export_13: DefineComponent<__VLS_Props_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+declare const __VLS_export_14: DefineComponent<__VLS_Props_9, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
 declare const __VLS_export_2: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 
 declare const __VLS_export_3: __VLS_WithSlots_2<typeof __VLS_base_2, __VLS_Slots_2>;
@@ -293,26 +316,26 @@ declare const __VLS_export_4: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, Com
     "onToggle-section-collapse"?: ((sectionId: string) => any) | undefined;
 }>, {
     canEdit: boolean;
+    theme: PptxTheme;
     locale: string;
+    customProperties: readonly PptxCustomProperty[];
+    templateElementsBySlideId: Record<string, PptxElement[]>;
     headerFooter: PptxHeaderFooter;
-    theme: PptxTheme;
     tableStyleMap: ParsedTableStyleMap;
     firstSlideNumber: number;
     mediaDataUrls: Map<string, string>;
-    templateElementsBySlideId: Record<string, PptxElement[]>;
-    customProperties: readonly PptxCustomProperty[];
     sectionGroups: SectionGroup[];
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 declare const __VLS_export_5: DefineComponent<SlideThumbnailProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<SlideThumbnailProps> & Readonly<{}>, {
+    theme: PptxTheme;
     locale: string;
+    customProperties: readonly PptxCustomProperty[];
     headerFooter: PptxHeaderFooter;
-    theme: PptxTheme;
     tableStyleMap: ParsedTableStyleMap;
     firstSlideNumber: number;
     mediaDataUrls: Map<string, string>;
     templateElements: PptxElement[];
-    customProperties: readonly PptxCustomProperty[];
     previewWidth: number;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
@@ -594,6 +617,20 @@ declare type __VLS_Props_6 = {
     followedClientId: number | null;
 };
 
+declare type __VLS_Props_7 = {
+    blocks: ViewerBuildingBlocks;
+};
+
+declare type __VLS_Props_8 = {
+    blocks: ViewerBuildingBlocks;
+};
+
+declare type __VLS_Props_9 = {
+    blocks: ViewerBuildingBlocks;
+    /** Render only these groups. */
+    groups?: readonly BuildingBlockToolbarGroupId[];
+};
+
 declare type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
 
 declare type __VLS_Slots_2 = ReturnType<typeof __VLS_template_2>['__VLS_Slots'];
@@ -630,10 +667,60 @@ export { BACKSTAGE_PAGE_IDS }
 
 export { BackstageCustomization }
 
+export { BuildingBlockRequest }
+
+export { BuildingBlockResult }
+
+declare interface BuildingBlocksBridge {
+    readonly engine: Readonly<ShallowRef<BuildingBlocksEngine | null>>;
+    readonly host: BuildingBlocksHost;
+    /** The viewer's imperative handle, set by the canvas block. */
+    readonly viewer: ShallowRef<PowerPointViewerExpose | null>;
+    /** The viewer registers its engine; returns the function that unregisters it. */
+    attach(engine: BuildingBlocksEngine): () => void;
+}
+
+export declare const BuildingBlocksCanvas: typeof __VLS_export_12;
+
+/**
+ * What the viewer behind the canvas block publishes, read at call time: the session port over its
+ * own editor state, the dialog group ports, the view operations and what the slides pane draws.
+ * Every getter reads the viewer's refs, so reading them from a computed or a render tracks them.
+ */
+declare interface BuildingBlocksEngine {
+    /** The members of the session port the viewer owns (the host's options are added around them). */
+    readonly session: Omit<BuildingBlockSessionPort, 'fileLimits' | 'onRequest' | 'onCancel'>;
+    readonly groups: BuildingBlockGroupPorts;
+    state(): Omit<ViewerBuildingBlocksState, 'mode'> & {
+        mode: string;
+        canEdit: boolean;
+    };
+    readonly view: BuildingBlockToolbarView;
+    /** The shortcut help flag's mirror: close it (`actions.cancel()`). */
+    closeShortcuts(): void;
+    /** What the slides pane block draws and which operations it maps its events onto. */
+    slidesPane(): SlidesPaneBinding;
+    /** The matches the canvas outlines for the host find bar. */
+    findHighlights(): FindHighlightState;
+}
+
+/** What the viewer calls on the host side: requests and the mirrored shortcut help. */
+declare interface BuildingBlocksHost {
+    request(request: BuildingBlockRequest): void;
+    announceShortcuts(open: boolean): void;
+}
+
+export declare const BuildingBlocksSlidesPane: typeof __VLS_export_13;
+
+export declare const BuildingBlocksToolbar: typeof __VLS_export_14;
+
 export { CANVAS_CONTEXT_MENU_COMMAND_IDS }
 
 export { CanvasSize }
 
+/** Viewer props the building blocks decide themselves (they mount no chrome). */
+declare type ChromeProps = 'content' | 'canEdit' | 'readOnly' | 'showToolbar' | 'showThumbnails' | 'showCompatibilityToasts';
+
 export { clearAudienceContent }
 
 /**
@@ -703,6 +790,12 @@ export { ExternalCollaborationSession }
 
 export { ExternalCollaborationSnapshot }
 
+declare interface FindHighlightState {
+    matches: readonly FindResult[];
+    current: number;
+    slideIndex: number;
+}
+
 export declare const FollowModeBar: typeof __VLS_export_11;
 
 export { forgetSessionDeck }
@@ -768,6 +861,7 @@ export { PowerPointViewerAPI }
  *  - `onActiveSlideChange` → `@active-slide-change`
  *  - `onModeChange`        → `@mode-change`
  *  - `onZoomChange`        → `@zoom-change`
+ *  - `onRibbonDisplayChange` → `@ribbon-display-change`
  *  - `onSelectionChange`   → `@selection-change`
  *  - `onSlideCountChange`  → `@slide-count-change`
  *  - `onLoad`              → `@load`
@@ -783,6 +877,11 @@ export declare interface PowerPointViewerEmits {
     (e: 'content-change' | 'autosave', content: Uint8Array): void;
     /** Fired when the active slide, zoom level, or slide count changes. */
     (e: 'active-slide-change' | 'zoom-change' | 'slide-count-change', value: number): void;
+    /**
+     * Fired only when the user picks a Ribbon Display Options mode (the menu,
+     * Ctrl+F1, a double click on a tab), never for a change of the `ribbonDisplay` prop.
+     */
+    (e: 'ribbon-display-change', mode: RibbonDisplayMode): void;
     /** Fired when the viewer mode changes. */
     (e: 'mode-change', mode: string): void;
     /** Fired when element selection changes. */
@@ -1071,6 +1170,14 @@ export declare interface PowerPointViewerProps {
      * `true`; `false` leaves the canvas (and the thumbnail pane, if shown).
      */
     showToolbar?: boolean;
+    /**
+     * Ribbon Display Options: the starting mode. `always` (the default) docks
+     * the tabs and commands above the slide; `tabs` shows only the tab row and
+     * lays a chosen tab's commands over the slide; `fullScreen` hides the title
+     * bar and the ribbon behind a strip. A later change from the host applies
+     * without firing `ribbon-display-change`.
+     */
+    ribbonDisplay?: RibbonDisplayMode;
     /**
      * Show the slide thumbnail pane. Default `true`. The pane still follows
      * the user's own collapse toggle and the `slidesPane` customisation panel.
@@ -1179,6 +1286,10 @@ export { PRESENTATION_OPEN_EXTENSIONS }
 export { presentationBaseName }
 
 declare interface Props extends RibbonProps {
+    /** Ribbon Display Options state; absent, the ribbon docks as in `always` mode. */
+    ribbonDisplay?: RibbonDisplayState;
+    /** The viewer's Ribbon Display Options controller (menu, tab clicks, double clicks). */
+    ribbonDisplayController?: RibbonDisplayController;
 }
 
 /**
@@ -1542,6 +1653,28 @@ export declare const SlideCanvas: typeof __VLS_export_2;
 
 export declare const SlidesPane: typeof __VLS_export_4;
 
+/** The viewer's slide rail inputs and operations, as `ViewerSlideRail` reads them. */
+declare interface SlidesPaneBinding {
+    slides: readonly PptxSlide[];
+    activeSlideIndex: number;
+    canvasSize: {
+        width: number;
+        height: number;
+    };
+    mediaDataUrls: Map<string, string>;
+    canEdit: boolean;
+    sectionGroups: SectionGroup[];
+    headerFooter: PptxHeaderFooter | undefined;
+    customProperties: readonly PptxCustomProperty[] | undefined;
+    firstSlideNumber: number | undefined;
+    theme: PptxTheme | undefined;
+    tableStyleMap: ParsedTableStyleMap | undefined;
+    goTo(index: number): void;
+    toggleSlideHidden(index: number): void;
+    slideOps: UseSlideOperationsResult;
+    sectionOps: UseSectionOperationsResult;
+}
+
 /**
  * Deck-level state the slide thumbnail rail needs so its thumbnails draw what
  * the canvas draws. Every field is optional: an omitted field reads as "the
@@ -1793,6 +1926,40 @@ export declare interface UsePresenceTrackingResult {
     followUser: (clientId: number | null) => void;
 }
 
+declare interface UseSectionOperationsResult {
+    /**
+     * Insert a new section after the slide at `afterSlideIndex`, claiming that
+     * slide and the following contiguous run that shares its current section.
+     */
+    addSection: (name: string, afterSlideIndex: number) => void;
+    /** Rename a section and propagate the name to its slides. */
+    renameSection: (sectionId: string, newName: string) => void;
+    /** Remove a section, merging its slides into the previous section. */
+    deleteSection: (sectionId: string) => void;
+    /** Move a section one position earlier in the list. */
+    moveSectionUp: (sectionId: string) => void;
+    /** Move a section one position later in the list. */
+    moveSectionDown: (sectionId: string) => void;
+    /** Reassign the slides at `slideIndexes` to the target section. */
+    moveSlidesToSection: (slideIndexes: number[], targetSectionId: string) => void;
+    /** Flip the `collapsed` flag on a section. */
+    toggleSectionCollapse: (sectionId: string) => void;
+    /** Slides grouped by section, in deck order (leading no-section group first). */
+    slidesBySection: ComputedRef<SectionGroup[]>;
+}
+
+declare interface UseSlideOperationsResult {
+    /** Insert after the given index, or after the active slide when omitted. */
+    addSlide: (afterIndex?: number) => void;
+    /** Remove the slide at `index` (no-op when only one slide remains). */
+    deleteSlide: (index: number) => void;
+    /** Deep-clone the slide at `index` and insert the copy right after it. */
+    duplicateSlide: (index: number) => void;
+    pasteSlides: (request: SlidePasteRequest) => void;
+    /** Reorder the slide at `from` to position `to`. */
+    moveSlide: (from: number, to: number) => void;
+}
+
 /**
  * Returns a computed `style` object of CSS custom properties derived from
  * the given theme. Bind this onto the viewer root element's `:style`.
@@ -1801,6 +1968,15 @@ export declare interface UsePresenceTrackingResult {
  */
 export declare function useThemeStyle(theme: MaybeRefOrGetter<ViewerTheme | undefined>): ComputedRef<CSSProperties | undefined>;
 
+/**
+ * The Vue building blocks: the shared building-blocks session (`ooxml-ui/pptx`) over the Vue
+ * viewer. Render `<BuildingBlocksCanvas :blocks>` (the deck loads there), then any of
+ * `<BuildingBlocksToolbar>` and `<BuildingBlocksSlidesPane>`. The blocks mount no dialogs or
+ * pickers: controls and gestures that need one raise a request (`onRequest`, `actions.pending`)
+ * the host finishes with `actions`.
+ */
+export declare function useViewerBuildingBlocks(input: MaybeRefOrGetter<ViewerBuildingBlocksOptions>): ViewerBuildingBlocks;
+
 /**
  * Returns the active `ViewerTheme` (if any) from the nearest
  * `provideViewerTheme` ancestor.
@@ -1835,6 +2011,60 @@ export { VIEWER_FEATURE_IDS }
 
 export { VIEWER_PANEL_IDS }
 
+export { ViewerBuildingBlockActions }
+
+export declare interface ViewerBuildingBlocks {
+    /** Host-owned workflows (pickers, dialogs, Find / Replace, layouts); see the Vue docs. */
+    readonly actions: ComputedRef<ViewerBuildingBlockActions>;
+    /** The state for a custom shell. */
+    readonly state: ComputedRef<ViewerBuildingBlocksState>;
+    /** The effective mode (`preview` while the blocks may not edit). */
+    readonly mode: ComputedRef<ViewerMode>;
+    readonly loading: ComputedRef<boolean>;
+    readonly error: ComputedRef<string | null>;
+    /** The viewer's imperative handle (save, export, zoom, ...); null until the canvas mounts. */
+    readonly viewer: Readonly<ShallowRef<PowerPointViewerExpose | null>>;
+    /** The options the blocks currently run with. */
+    readonly options: ComputedRef<ViewerBuildingBlocksOptions>;
+    /** The shared session behind `actions` (for hosts that register further groups). */
+    readonly session: PptxBuildingBlockSession;
+    /** Wiring between the three blocks; used by the block components, not part of the API. */
+    readonly bridge: BuildingBlocksBridge;
+}
+
+export declare interface ViewerBuildingBlocksOptions extends Omit<PowerPointViewerProps, ChromeProps>, 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), as React's `canEdit`. */
+    canEdit?: boolean | undefined;
+    onContentChange?: ((content: Uint8Array) => void) | undefined;
+    onDirtyChange?: ((dirty: boolean) => void) | undefined;
+    onActiveSlideChange?: ((index: number) => void) | undefined;
+    onModeChange?: ((mode: string) => void) | undefined;
+    onZoomChange?: ((zoom: number) => void) | undefined;
+    onSelectionChange?: ((ids: string[]) => void) | undefined;
+    onSlideCountChange?: ((count: number) => 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). */
+export declare interface ViewerBuildingBlocksState {
+    /** `preview` until a canvas is mounted and the host grants editing. */
+    mode: ViewerMode;
+    loading: boolean;
+    error: string | null;
+    /** Zero-based active slide, -1 before a deck loads. */
+    slideIndex: number;
+    slideCount: number;
+    canUndo: boolean;
+    canRedo: boolean;
+    dirty: boolean;
+}
+
 export { ViewerCustomization }
 
 export { ViewerCustomizationApi }