pptx-vue-viewer 4.5.0 → 4.6.0

package/dist/index.d.ts

@@ -540,6 +540,33 @@ declare type BackgroundInput = {
     source: string;
 };
 
+export declare const BACKSTAGE_CARD_IDS: readonly BackstageCardId[];
+
+export declare const BACKSTAGE_PAGE_IDS: readonly BackstagePage[];
+
+/**
+ * Every action card the File-tab backstage can show, keyed by the operation it
+ * triggers rather than by its wording.
+ *
+ * The five bindings used to hardcode a title and a body string each, which made
+ * the whole backstage untranslatable and let the copy drift: the same card
+ * carried four different descriptions depending on which binding you opened it
+ * in. Both halves now live here as a dictionary key plus an English fallback,
+ * so a wording change lands everywhere at once and a translator only has to
+ * translate it once.
+ */
+declare type BackstageCardId = 'protect' | 'inspect' | 'embedFonts' | 'signatures' | 'versionHistory' | 'saveAsPptx' | 'saveAsPpsx' | 'saveAsPptm' | 'saveAsPpt' | 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage' | 'print' | 'share';
+
+/** File tab (backstage) customisation. */
+export declare interface BackstageCustomization {
+    /** Navigation entries (pages) to remove from the File tab. */
+    hiddenPages?: readonly BackstagePage[];
+    /** Action cards to remove from the pages that show them. */
+    hiddenCards?: readonly BackstageCardId[];
+}
+
+declare type BackstagePage = 'home' | 'new' | 'open' | 'info' | 'save' | 'saveAs' | 'print' | 'share' | 'export' | 'close' | 'account' | 'options';
+
 /**
  * 3-D effect properties, text warp (WordArt) presets, and scene/shape bevel
  * definitions parsed from OOXML `a:sp3d`, `a:scene3d`, and `a:bodyPr/a:prstTxWarp`.
@@ -678,6 +705,24 @@ declare interface BulletInfo {
     ownedByParagraph?: boolean;
 }
 
+export declare const CANVAS_CONTEXT_MENU_COMMAND_IDS: readonly ["paste", "layout", "reset-slide", "format-background", "grid-and-guides", "ruler"];
+
+/**
+ * The right-click menu for the empty slide canvas (no element under the
+ * cursor), as distinct from {@link ./context-menu-commands}'s per-element menu.
+ *
+ * Right-clicking empty canvas used to do nothing at all in every binding: React
+ * and Vue both bailed out early (`getElementIdFromEvent` returns `null`, so the
+ * handler just returns) rather than opening a menu, and the other three never
+ * wired a handler for it either. PowerPoint offers Paste, Layout, Reset,
+ * Format Background and view toggles (Grid and Guides, Ruler) from this menu;
+ * this module is the one list every binding renders instead of five omissions.
+ *
+ * @module render/canvas-context-menu-commands
+ */
+/** Every command the empty-canvas context menu can offer, in no particular order. */
+declare type CanvasContextMenuCommandId = 'paste' | 'layout' | 'reset-slide' | 'format-background' | 'grid-and-guides' | 'ruler';
+
 /** Canvas dimensions in pixels. */
 export declare interface CanvasSize {
     width: number;
@@ -1083,6 +1128,21 @@ declare interface ContentPartPptxElement extends PptxElementBase {
     inkPartRawXml?: XmlObject;
 }
 
+/** Every command a canvas context menu can offer, in no particular order. */
+declare type ContextMenuCommandId = 'copy' | 'cut' | 'paste' | 'duplicate' | 'edit-text' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'ai-ask' | 'ai-fix' | 'comment' | 'hyperlink' | 'table-insert-row-above' | 'table-insert-row-below' | 'table-delete-row' | 'table-insert-col-left' | 'table-insert-col-right' | 'table-delete-col' | 'table-merge-selected' | 'table-merge-right' | 'table-merge-down' | 'table-split' | 'group' | 'ungroup' | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape' | 'delete';
+
+/** Right-click menu customisation. */
+export declare interface ContextMenuCustomization {
+    /** Entries to remove from the element (right-click on a shape) menu. */
+    hiddenElementCommands?: readonly ContextMenuCommandId[];
+    /** Entries to remove from the empty-canvas menu. */
+    hiddenCanvasCommands?: readonly CanvasContextMenuCommandId[];
+    /** Remove the element context menu entirely. */
+    disableElementMenu?: boolean;
+    /** Remove the empty-canvas context menu entirely. */
+    disableCanvasMenu?: boolean;
+}
+
 /**
  * Decode a local image File/Blob into a centred element, fitting the slide
  * without upscaling. Dimensions are slide pixels; image bytes are preserved.
@@ -1233,6 +1293,8 @@ declare interface CustomGeometryTextRect {
  */
 export declare function defaultCssVars(): Record<string, string>;
 
+declare type DefaultExportFormat = 'pptx' | 'pdf' | 'png';
+
 /** Default border-radius. */
 export declare const defaultRadius = "0.5rem";
 
@@ -1274,9 +1336,16 @@ declare interface DeltaOp {
  */
 export declare function describeCollaborationShellState(state: Pick<CollaborationShellState, 'canEdit' | 'status' | 'connectedCount'>, translate: CollaborationShellTranslate): string;
 
+declare type DisplayOptimization = 'appearance' | 'compatibility';
+
 /** Active drawing/inking tool. Mirrors React `DrawingTool`. */
 export declare type DrawingTool = 'select' | 'pen' | 'highlighter' | 'eraser' | 'freeform';
 
+export declare const EDITOR_SHORTCUT_ACTION_IDS: readonly ["undo", "redo", "copy", "cut", "paste", "duplicate", "delete", "selectAll", "group", "ungroup", "nudge", "prevSlide", "nextSlide", "escape", "find", "findReplace", "toggleShortcuts", "alignLeft", "alignCenter", "alignRight", "alignJustify", "increaseFontSize", "decreaseFontSize", "copyFormat", "pasteFormat", "newSlide", "hyperlink", "clearFormatting", "cycleSelectionNext", "cycleSelectionPrev", "pasteSpecial"];
+
+/** A logical editor command produced by one key press. */
+declare type EditorKeyActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find' | 'findReplace' | 'toggleShortcuts' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'increaseFontSize' | 'decreaseFontSize' | 'copyFormat' | 'pasteFormat' | 'newSlide' | 'hyperlink' | 'clearFormatting' | 'cycleSelectionNext' | 'cycleSelectionPrev' | 'pasteSpecial';
+
 /** Typed CT_AlphaOutsetEffect with original XML retained for lossless edits. */
 declare interface EffectDagAlphaOutset {
     kind: 'alphaOutset';
@@ -1342,6 +1411,8 @@ declare interface EffectDagXfrm {
     ty?: number;
 }
 
+export declare const ELEMENT_CONTEXT_MENU_COMMAND_IDS: readonly ["copy", "cut", "paste", "duplicate", "edit-text", "bring-forward", "send-backward", "bring-front", "send-back", "ai-ask", "ai-fix", "comment", "hyperlink", "table-insert-row-above", "table-insert-row-below", "table-delete-row", "table-insert-col-left", "table-insert-col-right", "table-delete-col", "table-merge-selected", "table-merge-right", "table-merge-down", "table-split", "group", "ungroup", "save-as-picture", "edit-alt-text", "size-and-position", "format-shape", "delete"];
+
 /** Opaque clipboard payload: only its presence gates the Paste button. */
 export declare type ElementClipboardPayload = Record<string, unknown>;
 
@@ -1446,6 +1517,8 @@ export declare interface ExternalCollaborationSnapshot {
     synced: boolean;
 }
 
+declare type FeedbackSoundScheme = 'modern' | 'classic';
+
 declare type FillInput = {
     type: 'solid';
     color: string;
@@ -1630,6 +1703,8 @@ declare interface ImagePptxElement extends PptxElementBase, PptxShapeProperties,
     type: 'image';
 }
 
+declare type ImageResolutionPreset = 'highFidelity' | 'ppi330' | 'ppi220' | 'ppi150' | 'ppi96';
+
 /**
  * A freehand ink / drawing stroke captured with a stylus or mouse.
  *
@@ -1819,6 +1894,19 @@ export declare function isLegacyBinaryPresentation(name: string | null | undefin
  */
 export declare function isSupportedPresentationFile(name: string | null | undefined): boolean;
 
+/** Editor keyboard-shortcut customisation. */
+export declare interface KeyboardCustomization {
+    /** Turn every editor shortcut off (the host owns the keyboard). */
+    disableAll?: boolean;
+    /** Editor commands whose shortcut is turned off. */
+    disabled?: readonly EditorKeyActionName[];
+    /**
+     * Replacement chords per command. A remapped command no longer answers to
+     * its built-in chord; it answers to the chord(s) given here instead.
+     */
+    remap?: Partial<Record<EditorKeyActionName, ShortcutChord | readonly ShortcutChord[]>>;
+}
+
 /** A `{ path, name }` layout option for the New-Slide dropdown. */
 export declare interface LayoutOption {
     path: string;
@@ -2190,12 +2278,78 @@ declare interface OlePptxElement extends PptxElementBase {
     extensionXml?: PptxGraphicFrameExtension[];
 }
 
+declare type OpenDocumentsView = 'savedView' | 'normal' | 'outline' | 'slideSorter' | 'notes';
+
+export declare const OPTIONS_PAGE_IDS: readonly OptionsPageId[];
+
+export declare const OPTIONS_SECTION_IDS: readonly OptionsSectionId[];
+
+export declare const OPTIONS_SETTING_IDS: readonly OptionsSettingId[];
+
+/** File > Options (the Settings dialog) customisation. */
+export declare interface OptionsCustomization {
+    /** Whole pages to remove from the dialog's category rail. */
+    hiddenPages?: readonly OptionsPageId[];
+    /** Sections (`<page>.<section>`) to remove from their page. */
+    hiddenSections?: readonly OptionsSectionId[];
+    /** Individual settings (`<group>.<key>`) to remove wherever they appear. */
+    hiddenSettings?: readonly OptionsSettingId[];
+    /**
+     * Settings pinned to a fixed value. The value is forced into the options
+     * store, user edits to it are ignored, and the control renders read-only.
+     * Add the id to `hiddenSettings` too to lock it invisibly.
+     */
+    locked?: OptionsSettingValues;
+    /**
+     * Host defaults: the value a setting starts at when the user has not saved
+     * a choice of their own. "Reset" returns to these, not to the built-ins.
+     */
+    defaults?: OptionsSettingValues;
+}
+
+/**
+ * A File > Options page: the ten PowerPoint categories plus `ai`, the AI
+ * assistant page a binding adds when the host configured an assistant.
+ */
+export declare type OptionsPageId = ViewerOptionsTabId | 'ai';
+
+declare type OptionsPrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+
+declare type OptionsPrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+
+/**
+ * One section of an Options page, addressed as `<page>.<section>`, for
+ * example `general.personalize` or `advanced.print`. The full list is
+ * `OPTIONS_SECTION_IDS` (derived from the schema at runtime).
+ */
+export declare type OptionsSectionId = `${ViewerOptionsTabId}.${string}`;
+
+/**
+ * One File > Options setting, addressed as `<group>.<key>`, for example
+ * `general.userName` or `advanced.showGrid`. The union is derived from the
+ * `ViewerOptions` model itself, so a typo is a compile error.
+ */
+export declare type OptionsSettingId = { [G in ViewerOptionsGroupId]: `${G}.${PrimitiveKeys<ViewerOptions[G]>}`; }[ViewerOptionsGroupId];
+
+/** Values a host forces onto settings. */
+export declare type OptionsSettingValues = Partial<Record<OptionsSettingId, ViewerOptionPrimitive>>;
+
 /**
  * Parse the session nonce from the current page URL hash. Returns `null` if the
  * hash is not in the expected `#pptx-audience&nonce=<uuid>` form.
  */
 export declare function parseAudienceNonce(): string | null;
 
+/** A parsed `Mod+Shift+D` chord. */
+declare interface ParsedShortcutChord {
+    key: string;
+    mod: boolean;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+    shift: boolean;
+}
+
 /**
  * Table background style (CT_TableBackgroundStyle, ECMA-376 §21.1.3.7).
  *
@@ -2838,7 +2992,7 @@ export declare interface PowerPointViewerEmits {
  * </script>
  * ```
  */
-export declare interface PowerPointViewerExpose extends PowerPointViewerAPI {
+export declare interface PowerPointViewerExpose extends PowerPointViewerAPI, ViewerCustomizationApi {
     /** Serialise the current presentation to `.pptx` bytes. */
     getContent: () => Promise<Uint8Array>;
 }
@@ -2988,6 +3142,17 @@ export declare interface PowerPointViewerProps {
      * @see {@link ToolbarActionId}
      */
     hiddenActions?: ToolbarActionId[];
+    /**
+     * Framework-neutral UI customisation. See docs/guide/customization.md.
+     *
+     * Hides ribbon tabs/buttons, Options pages/sections/settings, File tab
+     * pages/cards, context-menu commands, panels, features and dialogs; locks
+     * settings or sets host defaults; disables or remaps editor shortcuts.
+     * Unioned with `hiddenActions`. The imperative helpers on the component
+     * handle (`hideRibbonTab`, `lockSetting`, ...) edit the same state, and a
+     * NEW object passed here replaces those imperative edits wholesale.
+     */
+    customization?: ViewerCustomization;
     /**
      * Initial theme-catalog selection key (e.g. `'vermilionDark'`), used only
      * when no persisted preference exists. Has no effect when the `theme` prop
@@ -11521,6 +11686,9 @@ declare interface PresentationThemeInput {
     };
 }
 
+/** Keys of an options group whose value is a primitive (not an array). */
+declare type PrimitiveKeys<T> = { [K in keyof T]: T[K] extends ViewerOptionPrimitive ? K : never; }[keyof T] & string;
+
 declare interface Props extends RibbonProps {
 }
 
@@ -11535,6 +11703,8 @@ declare interface Props extends RibbonProps {
  */
 export declare function provideViewerTheme(theme: MaybeRefOrGetter<ViewerTheme | undefined>): void;
 
+declare type QuickAccessPosition = 'above' | 'below';
+
 /**
  * Remember `data` as the deck this tab has open, so the next load can restore
  * it. Resolves `false` when the browser refused to store it; callers treat that
@@ -11638,6 +11808,33 @@ export declare function renderToCanvas(element: HTMLElement, options?: Partial<O
 
 declare type Resolvable<T> = T | (() => T | Promise<T>);
 
+/** The normalised, set-based view of a customisation. Treat as immutable. */
+export declare interface ResolvedCustomization {
+    hiddenActions: ReadonlySet<ToolbarActionId>;
+    hiddenOptionsPages: ReadonlySet<OptionsPageId>;
+    hiddenOptionsSections: ReadonlySet<OptionsSectionId>;
+    hiddenSettings: ReadonlySet<OptionsSettingId>;
+    lockedSettings: OptionsSettingValues;
+    defaultSettings: OptionsSettingValues;
+    hiddenBackstagePages: ReadonlySet<BackstagePage>;
+    hiddenBackstageCards: ReadonlySet<BackstageCardId>;
+    hiddenElementCommands: ReadonlySet<ContextMenuCommandId>;
+    hiddenCanvasCommands: ReadonlySet<CanvasContextMenuCommandId>;
+    elementMenuEnabled: boolean;
+    canvasMenuEnabled: boolean;
+    hiddenPanels: ReadonlySet<ViewerPanelId>;
+    disabledFeatures: ReadonlySet<ViewerFeatureId>;
+    hiddenDialogs: ReadonlySet<ViewerDialogId>;
+    keyboard: ResolvedKeyboardCustomization;
+}
+
+/** The normalised keyboard slice of a resolved customisation. */
+declare interface ResolvedKeyboardCustomization {
+    disableAll: boolean;
+    disabled: ReadonlySet<EditorKeyActionName>;
+    remap: ReadonlyMap<EditorKeyActionName, readonly ParsedShortcutChord[]>;
+}
+
 /**
  * The deck to reopen on load: this tab's remembered bytes, upgraded to a newer
  * autosave snapshot of the same file when the viewer wrote one after they were
@@ -11646,6 +11843,16 @@ declare type Resolvable<T> = T | (() => T | Promise<T>);
  */
 export declare function restoreSessionDeck(): Promise<SessionDeck | null>;
 
+export declare const RIBBON_TAB_IDS: readonly ToolbarTabId[];
+
+/** Ribbon and toolbar customisation. */
+export declare interface RibbonCustomization {
+    /** Ribbon tabs to remove (the File tab included, unlike Customize Ribbon). */
+    hiddenTabs?: readonly ToolbarTabId[];
+    /** Top-level toolbar buttons / control clusters to remove. */
+    hiddenButtons?: readonly ToolbarButtonId[];
+}
+
 /**
  * Aggregate ribbon contract (state + callbacks). Mirrors React `ToolbarProps`.
  * The shell (`RibbonToolbar.vue`) passes the relevant subset to each section.
@@ -11906,6 +12113,16 @@ export declare function savedPresentationFileName(sourceName: string | null | un
 /** The formats the save path can produce. */
 export declare type SavedPresentationFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
 
+/**
+ * Full PowerPoint "File > Options" parity model.
+ *
+ * Groups mirror the ten categories of PowerPoint's Options dialog. Values are
+ * flat primitives per group so the dialog panes can be rendered generically
+ * from `VIEWER_OPTIONS_SCHEMA` in every binding. The legacy six-toggle
+ * `ViewerPreferences` surface stays supported via the mapping helpers below.
+ */
+declare type ScreenTipStyle = 'descriptions' | 'plain' | 'off';
+
 /**
  * session-restore: keep the deck a host app has open across a page refresh.
  *
@@ -12454,6 +12671,13 @@ declare interface ShapeStyle {
     inheritedEffectStyle?: ShapeStyle;
 }
 
+/**
+ * A shortcut chord in the form `Mod+Shift+D`: modifiers `Mod` (Ctrl on
+ * Windows/Linux, Cmd on macOS), `Ctrl`, `Meta`, `Alt`, `Shift`, joined by `+`,
+ * followed by a `KeyboardEvent.key` value (`D`, `Delete`, `ArrowLeft`, `F2`).
+ */
+export declare type ShortcutChord = string;
+
 /**
  * Fluent builder for a single slide.
  *
@@ -13845,6 +14069,8 @@ declare interface ThemeCatalogEntry {
  */
 export declare function themeToCssVars(theme: ViewerTheme | undefined, omitDefaults?: boolean): Record<string, string>;
 
+export declare const TOOLBAR_BUTTON_IDS: readonly ["share", "broadcast", "export", "undo", "redo", "record", "notes", "fullscreen", "zoom", "navigation"];
+
 export declare type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
 
 /**
@@ -14119,6 +14345,142 @@ export declare const vermilionLightTheme: ViewerTheme;
 /** Shared border-radius for the vermilion presets (slightly sharper than the default). */
 export declare const vermilionRadius = "0.375rem";
 
+export declare const VIEWER_DIALOG_IDS: readonly ["options", "share", "broadcast", "print", "export"];
+
+export declare const VIEWER_EXPORT_FORMAT_IDS: readonly ["pdf", "png", "video", "gif", "json", "copyImage"];
+
+export declare const VIEWER_FEATURE_IDS: readonly ["ai", "collaboration", "comments", "presentMode"];
+
+export declare const VIEWER_PANEL_IDS: readonly ["statusBar", "slidesPane", "inspector", "notes", "quickAccessToolbar", "titleBar"];
+
+declare interface ViewerAccessibilityOptions {
+    showAccessibilityStatus: boolean;
+    feedbackWithSound: boolean;
+    soundScheme: FeedbackSoundScheme;
+    showShortcutKeysInScreenTips: boolean;
+    reducedMotion: boolean;
+}
+
+declare interface ViewerAdvancedOptions {
+    autoSelectEntireWord: boolean;
+    allowTextDragAndDrop: boolean;
+    maximumUndoSteps: number;
+    useSmartCutAndPaste: boolean;
+    showPasteOptionsButton: boolean;
+    imageDefaultResolution: ImageResolutionPreset;
+    doNotCompressImages: boolean;
+    chartPropertiesFollowDataPoint: boolean;
+    recentPresentationsCount: number;
+    showVerticalRuler: boolean;
+    showGrid: boolean;
+    snapToGrid: boolean;
+    disableHardwareAcceleration: boolean;
+    /**
+     * Force every opt-in interactive 3D scene (SmartArt, bar/line/area/pie/
+     * surface charts) to fall back to its flat 2D rendering, even when the
+     * host has enabled that scene via its own `smartArt3D`/`*Chart3D` prop.
+     * A host opting in says "this deck may want 3D"; this is the viewer
+     * user's own override for when the WebGL scenes it renders are too much
+     * for their machine. See `resolve3DRenderingFlags`.
+     */
+    disable3DRendering: boolean;
+    /**
+     * `p:animEffect/@filter="pixelate"` defaults to snapping the element to
+     * its end state (`cutIn`/`cutOut`), matching PowerPoint's own behaviour
+     * (COM `CreateVideo` frame-diffing shows PowerPoint performs no animation
+     * at all for this filter value). This turns on the blocky mosaic reveal
+     * this renderer can build instead, for a viewer that would rather show
+     * something animating than PowerPoint's own instant swap. See
+     * `resolveFilterEffect` in `animation-filter-effects.ts` and
+     * `docs/guide/visual-effects.md`.
+     */
+    pixelateMosaicAnimation: boolean;
+    openDocumentsView: OpenDocumentsView;
+    slideShowShowMenuOnRightClick: boolean;
+    slideShowShowPopupToolbar: boolean;
+    slideShowPromptKeepInkAnnotations: boolean;
+    slideShowEndWithBlackSlide: boolean;
+    printInBackground: boolean;
+    printHighQuality: boolean;
+    printUseMostRecentSettings: boolean;
+    printWhat: OptionsPrintWhat;
+    printColorMode: OptionsPrintColorMode;
+    printHiddenSlides: boolean;
+    printScaleToFit: boolean;
+    printFrameSlides: boolean;
+}
+
+/**
+ * The whole customisation object. Every field is optional; omitted fields hide
+ * nothing and lock nothing.
+ */
+export declare interface ViewerCustomization {
+    ribbon?: RibbonCustomization;
+    options?: OptionsCustomization;
+    backstage?: BackstageCustomization;
+    contextMenu?: ContextMenuCustomization;
+    keyboard?: KeyboardCustomization;
+    /** Chrome regions to remove (`true` hides). */
+    hiddenPanels?: readonly ViewerPanelId[];
+    /** Feature areas to switch off (their buttons, menus, pages and panels). */
+    disabledFeatures?: readonly ViewerFeatureId[];
+    /** Dialogs to remove, along with every entry point that opens them. */
+    hiddenDialogs?: readonly ViewerDialogId[];
+    /** Export formats to remove from File > Export. */
+    hiddenExportFormats?: readonly ViewerExportFormatId[];
+}
+
+/** The imperative methods every binding's component handle exposes. */
+export declare interface ViewerCustomizationApi {
+    /** The current customisation object (a snapshot; do not mutate). */
+    getCustomization(): ViewerCustomization;
+    /** Replace the whole customisation. */
+    setCustomization(next: ViewerCustomization): void;
+    /** Merge a partial customisation (see `mergeCustomization`). */
+    updateCustomization(patch: ViewerCustomization): void;
+    /** Drop every customisation, back to the stock UI. */
+    resetCustomization(): void;
+    hideRibbonTab(tab: ToolbarTabId): void;
+    showRibbonTab(tab: ToolbarTabId): void;
+    hideToolbarButton(button: ToolbarButtonId): void;
+    showToolbarButton(button: ToolbarButtonId): void;
+    hideOptionsPage(page: OptionsPageId): void;
+    showOptionsPage(page: OptionsPageId): void;
+    hideOptionsSection(section: OptionsSectionId): void;
+    showOptionsSection(section: OptionsSectionId): void;
+    hideSetting(setting: OptionsSettingId): void;
+    showSetting(setting: OptionsSettingId): void;
+    /** Pin a setting to `value`; `hidden` also removes it from the dialog. */
+    lockSetting(setting: OptionsSettingId, value: ViewerOptionPrimitive, hidden?: boolean): void;
+    unlockSetting(setting: OptionsSettingId): void;
+    /** Set (or with `undefined`, clear) the host default for a setting. */
+    setSettingDefault(setting: OptionsSettingId, value: ViewerOptionPrimitive | undefined): void;
+    hideBackstagePage(page: BackstagePage): void;
+    showBackstagePage(page: BackstagePage): void;
+    hideBackstageCard(card: BackstageCardId): void;
+    showBackstageCard(card: BackstageCardId): void;
+    hideContextMenuCommand(command: ContextMenuCommandId): void;
+    showContextMenuCommand(command: ContextMenuCommandId): void;
+    hideCanvasContextMenuCommand(command: CanvasContextMenuCommandId): void;
+    showCanvasContextMenuCommand(command: CanvasContextMenuCommandId): void;
+    disableShortcut(action: EditorKeyActionName): void;
+    enableShortcut(action: EditorKeyActionName): void;
+    /** Move a command onto new chord(s); `undefined` restores the built-in chord. */
+    remapShortcut(action: EditorKeyActionName, chords: ShortcutChord | readonly ShortcutChord[] | undefined): void;
+    setPanelVisible(panel: ViewerPanelId, visible: boolean): void;
+    setFeatureEnabled(feature: ViewerFeatureId, enabled: boolean): void;
+    setDialogAvailable(dialog: ViewerDialogId, available: boolean): void;
+}
+
+/** Dialogs (and the entry points that open them) a host can remove. */
+export declare type ViewerDialogId = 'options' | 'share' | 'broadcast' | 'print' | 'export';
+
+/** Export formats offered by the File > Export page. */
+export declare type ViewerExportFormatId = 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage';
+
+/** Feature areas that can be switched off as a whole. */
+export declare type ViewerFeatureId = 'ai' | 'collaboration' | 'comments' | 'presentMode';
+
 /**
  * A font supplied by the host application. The package never ships fonts:
  * applications provide a licensed URL, data URL, or blob URL for their users.
@@ -14131,12 +14493,112 @@ declare interface ViewerFontSource {
     style?: 'normal' | 'italic';
 }
 
+declare interface ViewerGeneralOptions {
+    displayOptimization: DisplayOptimization;
+    showMiniToolbar: boolean;
+    enableLivePreview: boolean;
+    collapseRibbonAutomatically: boolean;
+    collapseSearchByDefault: boolean;
+    screenTipStyle: ScreenTipStyle;
+    userName: string;
+    userInitials: string;
+    showStartScreen: boolean;
+    /**
+     * Lets the user hand a local font file to the viewer so decks authored
+     * with a font the browser lacks render with the real face.
+     *
+     * Off by default. The registration reads a file the user picks and adds it
+     * to the page's font set for the session, which is a capability a host
+     * embedding the viewer should opt into rather than inherit.
+     */
+    enableCustomFontUpload: boolean;
+}
+
 /** Viewer interaction mode: read-only, edit, presentation, or master-view. */
 export declare type ViewerMode = 'preview' | 'edit' | 'present' | 'master';
 
 /** Viewer interaction mode. Mirrors React `ViewerMode`. */
 declare type ViewerMode_2 = 'preview' | 'edit' | 'present' | 'master';
 
+declare type ViewerOptionPrimitive = boolean | number | string;
+
+declare interface ViewerOptions {
+    general: ViewerGeneralOptions;
+    proofing: ViewerProofingOptions;
+    save: ViewerSaveOptions;
+    accessibility: ViewerAccessibilityOptions;
+    advanced: ViewerAdvancedOptions;
+    ribbon: ViewerRibbonOptions;
+    quickAccess: ViewerQuickAccessOptions;
+    trust: ViewerTrustOptions;
+}
+
+declare type ViewerOptionsGroupId = keyof ViewerOptions;
+
+/**
+ * Control/section/tab descriptor types for the File > Options schema, plus
+ * the terse constructors the tab-definition modules build panes with.
+ */
+declare type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
+
+/**
+ * Chrome regions a host can remove. Each id maps onto one region in every
+ * binding; see `VIEWER_PANEL_IDS` for the catalogue.
+ */
+export declare type ViewerPanelId = 'statusBar' | 'slidesPane' | 'inspector' | 'notes' | 'quickAccessToolbar' | 'titleBar';
+
+declare interface ViewerProofingOptions {
+    autoCorrectTwoInitialCapitals: boolean;
+    autoCorrectCapitalizeFirstLetter: boolean;
+    autoCorrectCapitalizeDayNames: boolean;
+    autoCorrectSmartQuotes: boolean;
+    autoCorrectHyphensToDash: boolean;
+    autoCorrectFractions: boolean;
+    autoCorrectOrdinals: boolean;
+    ignoreUppercase: boolean;
+    ignoreWordsWithNumbers: boolean;
+    ignoreInternetAddresses: boolean;
+    flagRepeatedWords: boolean;
+    checkSpellingAsYouType: boolean;
+    hideSpellingErrors: boolean;
+}
+
+declare interface ViewerQuickAccessOptions {
+    visible: boolean;
+    position: QuickAccessPosition;
+    showCommandLabels: boolean;
+    /** Ordered ids from `QUICK_ACCESS_COMMAND_CATALOG`. */
+    commandIds: string[];
+}
+
+declare interface ViewerRibbonOptions {
+    /** Ribbon tabs unticked in Customize Ribbon. The File tab can never be hidden. */
+    hiddenTabIds: ToolbarTabId[];
+}
+
+/**
+ * File > Options > Save.
+ *
+ * Font embedding deliberately has NO entry here. It is owned by the File >
+ * Fonts panel, whose toggle is the one the save path reads (see
+ * `render/font-embedding`: `describeFontEmbedding` decides the toggle's start
+ * position and whether it can do anything at all, `embeddedFontSaveOptions`
+ * turns it into the `PptxHandler.save()` slice). This group used to carry a
+ * second `embedFonts` boolean, plus an `embedAllFontCharacters` companion, and
+ * neither was read by anything: the pane moved a switch that changed no saved
+ * byte, while the panel next door moved the real one. Two switches for one
+ * setting, one of them lying, is worse than one switch in a less
+ * PowerPoint-shaped place.
+ */
+declare interface ViewerSaveOptions {
+    autoSave: boolean;
+    autoRecoverIntervalMinutes: number;
+    keepLastAutoRecoveredVersion: boolean;
+    defaultExportFormat: DefaultExportFormat;
+    cacheRetentionDays: number;
+    clearCacheOnClose: boolean;
+}
+
 /**
  * Full viewer theme configuration.
  *
@@ -14217,6 +14679,12 @@ export declare interface ViewerThemeColors {
     ring: string;
 }
 
+declare interface ViewerTrustOptions {
+    openInProtectedView: boolean;
+    allowExternalContent: boolean;
+    confirmExternalHyperlinks: boolean;
+}
+
 /** Host layout policy, independent of authored slide dimensions and user zoom. */
 export declare interface ViewportFitOptions {
     /** Per-side padding. Omission keeps the binding's existing decorative allowance. */

package/dist/index.js

@@ -1,3 +1,3 @@
-import { $l as a, $u as s, C as e, Ci as o, Ep as r, Ff as t, Gp as i, Hc as l, Hp as n, Nd as c, Qn as p, Qu as d, S as m, Up as u, Vp as w, Wp as S, Xl as b, Xs as C, Xt as f, Yt as g, ac as j, bl as v, cc as E, cu as R, dc as V, et as X, hp as k, it as x, kf as y, ms as F, oc as H, sd as M, su as P, w as Q, x as T, yi as $, zl as h } from "./useViewerSettingsDialog-D3fF9v6l.js";
-import { A as z, E as A, M as B, T as D, a as G, c as I, i as N, j as O, k as U, l as W, n as Y, r as q, s as J, t as K, w as L } from "./viewer-DK5UNDHj.js";
-export { p as AUDIENCE_HASH, W as CollaborationCursors, U as CollaborationStatusIndicator, f as ElementRenderer, J as FollowModeBar, $ as PPTX_OPEN_ACCEPT, o as PRESENTATION_OPEN_EXTENSIONS, G as PowerPointViewer, I as RemoteSelectionOverlay, D as RibbonToolbar, L as SlideCanvas, g as SlideStage, F as clearAudienceContent, A as cn, C as createImageElementFromFile, j as defaultCssVars, H as defaultRadius, E as defaultThemeColors, V as describeCollaborationShellState, T as exportAllSlidesToSvg, m as exportAllSlidesToSvgBlobs, e as exportSlideToSvg, Q as exportSlideToSvgBlob, l as forgetSessionDeck, v as getSessionTabId, h as isAudienceTab, b as isLegacyBinaryPresentation, a as isSupportedPresentationFile, P as loadAudienceContent, R as loadSessionDeck, d as parseAudienceNonce, s as parsePresentationSessionId, M as presentationBaseName, z as provideViewerTheme, c as rememberSessionDeck, X as renderToCanvas, y as restoreSessionDeck, t as savedPresentationFileName, k as storeAudienceContent, r as themeToCssVars, x as useCollaboration, K as useCollaborativeHistory, Y as useCollaborativeState, q as usePresenceTracking, O as useThemeStyle, B as useViewerTheme, N as useYjsProvider, w as vermilionDarkColors, n as vermilionDarkTheme, u as vermilionLightColors, S as vermilionLightTheme, i as vermilionRadius };
+import { C as a, Ca as s, Cd as e, Ec as i, Fa as o, Fr as r, Ia as t, Md as l, Mi as m, Mr as n, Mu as w, Nu as c, Oc as d, Oi as p, Pa as u, Qn as C, Qp as S, Ra as M, S as b, Tc as g, Vl as f, Vp as j, Xi as R, Xt as V, Yt as v, _i as E, _m as F, et as O, fc as P, gi as T, gm as h, hi as k, hm as x, if as y, ir as I, it as Q, jc as X, ks as _, ll as A, mm as B, ou as D, pm as N, sp as Y, sr as q, tp as z, tr as G, w as H, wd as J, wu as K, x as L, yu as U } from "./useViewerSettingsDialog-ln5W1gt1.js";
+import { A as W, E as Z, M as $, T as aa, a as sa, c as ea, i as ia, j as oa, k as ra, l as ta, n as la, r as ma, s as na, t as wa, w as ca } from "./viewer-UZOm0R5A.js";
+export { C as AUDIENCE_HASH, G as BACKSTAGE_CARD_IDS, I as BACKSTAGE_PAGE_IDS, q as CANVAS_CONTEXT_MENU_COMMAND_IDS, ta as CollaborationCursors, ra as CollaborationStatusIndicator, n as EDITOR_SHORTCUT_ACTION_IDS, r as ELEMENT_CONTEXT_MENU_COMMAND_IDS, V as ElementRenderer, na as FollowModeBar, k as OPTIONS_PAGE_IDS, T as OPTIONS_SECTION_IDS, E as OPTIONS_SETTING_IDS, p as PPTX_OPEN_ACCEPT, m as PRESENTATION_OPEN_EXTENSIONS, sa as PowerPointViewer, R as RIBBON_TAB_IDS, ea as RemoteSelectionOverlay, aa as RibbonToolbar, ca as SlideCanvas, v as SlideStage, s as TOOLBAR_BUTTON_IDS, u as VIEWER_DIALOG_IDS, o as VIEWER_EXPORT_FORMAT_IDS, t as VIEWER_FEATURE_IDS, M as VIEWER_PANEL_IDS, _ as clearAudienceContent, Z as cn, P as createImageElementFromFile, g as defaultCssVars, i as defaultRadius, d as defaultThemeColors, X as describeCollaborationShellState, L as exportAllSlidesToSvg, b as exportAllSlidesToSvgBlobs, a as exportSlideToSvg, H as exportSlideToSvgBlob, A as forgetSessionDeck, f as getSessionTabId, D as isAudienceTab, U as isLegacyBinaryPresentation, K as isSupportedPresentationFile, w as loadAudienceContent, c as loadSessionDeck, e as parseAudienceNonce, J as parsePresentationSessionId, l as presentationBaseName, W as provideViewerTheme, y as rememberSessionDeck, O as renderToCanvas, z as restoreSessionDeck, Y as savedPresentationFileName, j as storeAudienceContent, S as themeToCssVars, Q as useCollaboration, wa as useCollaborativeHistory, la as useCollaborativeState, ma as usePresenceTracking, oa as useThemeStyle, $ as useViewerTheme, ia as useYjsProvider, N as vermilionDarkColors, B as vermilionDarkTheme, x as vermilionLightColors, h as vermilionLightTheme, F as vermilionRadius };