pptx-vanilla-viewer 3.4.0 → 3.6.0

package/dist/{transition-overlay-_0B-nMEW.d.ts → transition-overlay-C2lOs9rM.d.ts}

@@ -2,7 +2,7 @@ import "fast-xml-parser";
 import "jszip";
 import { Doc } from "yjs";
 import "opentype.js";
-//#region ../core/dist/text-operations-S-lI2aBz.d.ts
+//#region ../core/dist/text-operations-Ceqe6q6P.d.ts
 //#region src/core/types/actions.d.ts
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
@@ -1871,6 +1871,15 @@ interface TextStyle {
   textInnerShadowOffsetX?: number;
   /** Text inner shadow vertical offset in px. */
   textInnerShadowOffsetY?: number;
+  /**
+   * Original inner-shadow colour-choice XML (`a:innerShdw`'s
+   * `a:prstClr`/`a:schemeClr`/`a:srgbClr`/… child), preserved verbatim so an
+   * authored preset or theme colour round-trips instead of always being
+   * re-serialized as a resolved `a:srgbClr`. Mirrors {@link textGlowColorXml}.
+   */
+  textInnerShadowColorXml?: XmlObject;
+  /** Theme colour slot the inner shadow colour resolved from, when it is `a:schemeClr`. */
+  textInnerShadowColorRef?: PptxThemeColorRef;
   /** Preset shadow type from `a:prstShdw/@prst` (e.g. "shdw1"..."shdw20"). */
   textPresetShadowName?: string;
   /** Preset shadow colour as hex string. */
@@ -1883,6 +1892,18 @@ interface TextStyle {
   textPresetShadowDirection?: number;
   /** Text blur effect radius in px (`a:blur`). */
   textBlurRadius?: number;
+  /**
+   * Text soft-edge radius in px (`a:softEdge/@rad`).
+   *
+   * Feathers the glyph's own edges (a uniform blur of the alpha silhouette,
+   * the same effect a shape's `a:softEdge` gives its fill), unrelated to
+   * `a:blur` (which blurs the whole run, colour included) or a shadow. Never
+   * parsed before this field existed, so `a:softEdge` on a run was silently
+   * dropped: PowerPoint fades the glyphs to near-transparent at their
+   * outline (COM-verified, `audit-text` slide 14's "SOFTEDGE" run), while
+   * the viewer painted them fully crisp.
+   */
+  textSoftEdgeRadius?: number;
   /**
    * Raw `a:effectDag` XML node from `a:rPr`, preserved verbatim for
    * round-trip serialisation. Mirrors the shape-level
@@ -3515,6 +3536,15 @@ interface PptxChartHistogramOptions {
   intervalClosed?: 'l' | 'r';
   underflow?: number | 'auto';
   overflow?: number | 'auto';
+  /**
+   * `c:layoutPr/cx:aggregation` was authored instead of `cx:binning`: the
+   * raw rows are CATEGORICAL (a Pareto chart's `clusteredColumn` series
+   * counting occurrences of each authored category, COM-verified against
+   * charts-com.pptx slide 31 / chartEx6.xml), not a numeric range to bin.
+   * Mutually exclusive with `binSize`/`binCount`/`intervalClosed`, which
+   * only apply to a true numeric-value histogram.
+   */
+  aggregateByCategory?: boolean;
 }
 /** Office 2016 ChartEx waterfall series layout options. */
 interface PptxChartWaterfallOptions {
@@ -4179,6 +4209,18 @@ interface PptxChartData {
    * the source" and callers should treat it as `true`. Surface only.
    */
   wireframe?: boolean;
+  /**
+   * Whether the surface chart is the 2-D "top view" projection
+   * (`c:surfaceChart`, PowerPoint's "Contour" / "Wireframe Contour" types)
+   * rather than the 3-D isometric one (`c:surface3DChart`, "3-D Surface" /
+   * "3-D Surface (Wireframe)"). Both element names map to chart type
+   * `"surface"`; this bit is the only thing that tells the renderer which
+   * of the two projections PowerPoint actually drew, since a top-view
+   * surface has no Z-axis at all (only category and series axes) while the
+   * 3-D one draws all three. Surface only; `undefined` for every other
+   * chart type.
+   */
+  surfaceTopView?: boolean;
   /**
    * Scatter presentation mode (`c:scatterChart/c:scatterStyle/@val`).
    *
@@ -10365,7 +10407,7 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 //#endregion
-//#region ../core/dist/index-D4AXE4vG.d.ts
+//#region ../core/dist/index-CRVpXD8D.d.ts
 //#region src/core/types/theme-presets.d.ts
 /**
  * A complete theme preset that can be applied to a presentation.
@@ -12311,7 +12353,7 @@ interface ReflectionWrapperStyle {
   top: string;
   width: string;
   height: string;
-  /** Mirror (`scaleY(-1)`) composed with `@sx`/`@sy`/`@kx`/`@ky`/`@rot`. */
+  /** `scale(@sx, @sy)` (the sign of `@sy` IS the mirror) composed with `@kx`/`@ky`/`@rot`. */
   transform: string;
   /** Anchor point for the transform above, from `@algn` (default `center top`). */
   transformOrigin: string;
@@ -13476,6 +13518,27 @@ declare function loadPresentationDeck(sessionId: string): Promise<Uint8Array | n
 //#region src/render/presentation-blackboard.d.ts
 /** Blackout state, as carried by {@link PresentationSnapshot}. */
 type PresentationBlackout = PresentationSnapshot['blackout'];
+/** A logical editor command produced by one key press. */
+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';
+/** Every command a canvas context menu can offer, in no particular order. */
+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';
+//#endregion
+//#region src/render/canvas-context-menu-commands.d.ts
+/**
+ * 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. */
+type CanvasContextMenuCommandId = 'paste' | 'layout' | 'reset-slide' | 'format-background' | 'grid-and-guides' | 'ruler';
 //#endregion
 //#region src/render/paste-special.d.ts
 /** The four paste formats PowerPoint's Paste Options / Paste Special offer. */
@@ -13632,6 +13695,21 @@ interface AutosaveRecord {
   timestamp: number;
   size: number;
 }
+type BackstagePage = 'home' | 'new' | 'open' | 'info' | 'save' | 'saveAs' | 'print' | 'share' | 'export' | 'close' | 'account' | 'options';
+//#endregion
+//#region src/render/backstage-cards.d.ts
+/**
+ * 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.
+ */
+type BackstageCardId = 'protect' | 'inspect' | 'embedFonts' | 'signatures' | 'versionHistory' | 'saveAsPptx' | 'saveAsPpsx' | 'saveAsPptm' | 'saveAsPpt' | 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage' | 'print' | 'share';
 //#endregion
 //#region src/render/master-view-crud.d.ts
 /** One Slide Master view sidebar command. */
@@ -13686,7 +13764,141 @@ type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'rec
 /** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
 type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
 type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
+//#endregion
+//#region src/render/options/viewer-options.d.ts
+/**
+ * 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.
+ */
+type ScreenTipStyle = 'descriptions' | 'plain' | 'off';
+type DisplayOptimization = 'appearance' | 'compatibility';
+type ImageResolutionPreset = 'highFidelity' | 'ppi330' | 'ppi220' | 'ppi150' | 'ppi96';
+type OpenDocumentsView = 'savedView' | 'normal' | 'outline' | 'slideSorter' | 'notes';
+type DefaultExportFormat = 'pptx' | 'pdf' | 'png';
 type QuickAccessPosition = 'above' | 'below';
+type FeedbackSoundScheme = 'modern' | 'classic';
+type OptionsPrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+type OptionsPrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+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;
+}
+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;
+}
+/**
+ * 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.
+ */
+interface ViewerSaveOptions {
+  autoSave: boolean;
+  autoRecoverIntervalMinutes: number;
+  keepLastAutoRecoveredVersion: boolean;
+  defaultExportFormat: DefaultExportFormat;
+  cacheRetentionDays: number;
+  clearCacheOnClose: boolean;
+}
+interface ViewerAccessibilityOptions {
+  showAccessibilityStatus: boolean;
+  feedbackWithSound: boolean;
+  soundScheme: FeedbackSoundScheme;
+  showShortcutKeysInScreenTips: boolean;
+  reducedMotion: boolean;
+}
+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;
+}
+interface ViewerRibbonOptions {
+  /** Ribbon tabs unticked in Customize Ribbon. The File tab can never be hidden. */
+  hiddenTabIds: ToolbarTabId[];
+}
 interface ViewerQuickAccessOptions {
   visible: boolean;
   position: QuickAccessPosition;
@@ -13694,6 +13906,23 @@ interface ViewerQuickAccessOptions {
   /** Ordered ids from `QUICK_ACCESS_COMMAND_CATALOG`. */
   commandIds: string[];
 }
+interface ViewerTrustOptions {
+  openInProtectedView: boolean;
+  allowExternalContent: boolean;
+  confirmExternalHyperlinks: boolean;
+}
+interface ViewerOptions {
+  general: ViewerGeneralOptions;
+  proofing: ViewerProofingOptions;
+  save: ViewerSaveOptions;
+  accessibility: ViewerAccessibilityOptions;
+  advanced: ViewerAdvancedOptions;
+  ribbon: ViewerRibbonOptions;
+  quickAccess: ViewerQuickAccessOptions;
+  trust: ViewerTrustOptions;
+}
+type ViewerOptionsGroupId = keyof ViewerOptions;
+type ViewerOptionPrimitive = boolean | number | string;
 //#endregion
 //#region src/export/handout-layout.d.ts
 /**
@@ -13738,6 +13967,295 @@ interface PrintSettings {
   scaleToFit?: boolean;
 }
 //#endregion
+//#region src/render/options/viewer-options-controls.d.ts
+/**
+ * Control/section/tab descriptor types for the File > Options schema, plus
+ * the terse constructors the tab-definition modules build panes with.
+ */
+type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
+//#endregion
+//#region src/render/customization/customization-types.d.ts
+/** Keys of an options group whose value is a primitive (not an array). */
+type PrimitiveKeys<T> = { [K in keyof T]: T[K] extends ViewerOptionPrimitive ? K : never; }[keyof T] & 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.
+ */
+type OptionsSettingId = { [G in ViewerOptionsGroupId]: `${G}.${PrimitiveKeys<ViewerOptions[G]>}`; }[ViewerOptionsGroupId];
+/**
+ * A File > Options page: the ten PowerPoint categories plus `ai`, the AI
+ * assistant page a binding adds when the host configured an assistant.
+ */
+type OptionsPageId = ViewerOptionsTabId | 'ai';
+/**
+ * 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).
+ */
+type OptionsSectionId = `${ViewerOptionsTabId}.${string}`;
+/** Values a host forces onto settings. */
+type OptionsSettingValues = Partial<Record<OptionsSettingId, ViewerOptionPrimitive>>;
+/** Ribbon and toolbar customisation. */
+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[];
+}
+/** File > Options (the Settings dialog) customisation. */
+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;
+}
+/** File tab (backstage) customisation. */
+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[];
+}
+/** Right-click menu customisation. */
+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;
+}
+/**
+ * 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`).
+ */
+type ShortcutChord = string;
+/** Editor keyboard-shortcut customisation. */
+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[]>>;
+}
+/**
+ * Chrome regions a host can remove. Each id maps onto one region in every
+ * binding; see `VIEWER_PANEL_IDS` for the catalogue.
+ */
+type ViewerPanelId = 'statusBar' | 'slidesPane' | 'inspector' | 'notes' | 'quickAccessToolbar' | 'titleBar';
+/** Feature areas that can be switched off as a whole. */
+type ViewerFeatureId = 'ai' | 'collaboration' | 'comments' | 'presentMode';
+/** Dialogs (and the entry points that open them) a host can remove. */
+type ViewerDialogId = 'options' | 'share' | 'broadcast' | 'print' | 'export';
+/** Export formats offered by the File > Export page. */
+type ViewerExportFormatId = 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage';
+/**
+ * The whole customisation object. Every field is optional; omitted fields hide
+ * nothing and lock nothing.
+ */
+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[];
+}
+//#endregion
+//#region src/render/options/viewer-options-constraints.d.ts
+/** Locks and host defaults, both keyed `<group>.<key>`. */
+interface ViewerOptionsConstraints {
+  locked?: OptionsSettingValues;
+  defaults?: OptionsSettingValues;
+}
+//#endregion
+//#region src/render/options/viewer-options-store.d.ts
+/**
+ * Framework-neutral store behind the File > Options dialog.
+ *
+ * Holds a `ViewerOptions` snapshot, notifies subscribers on change, and
+ * persists a sparse diff into the shared `pptx-viewer-prefs` localStorage
+ * entry so choices survive reloads in every binding.
+ */
+type ViewerOptionsListener = (options: ViewerOptions) => void;
+interface ViewerOptionsStore {
+  getOptions(): ViewerOptions;
+  /** Replace the whole snapshot (e.g. hydrating from a host prop). */
+  setOptions(next: ViewerOptions): void;
+  /** Set one primitive value; ignores unknown keys and mismatched types. */
+  setValue(group: ViewerOptionsGroupId, key: string, value: ViewerOptionPrimitive): void;
+  getValue(group: ViewerOptionsGroupId, key: string): ViewerOptionPrimitive | undefined;
+  /** Toggle a ribbon tab's visibility. The File tab is always kept visible. */
+  setRibbonTabHidden(tabId: ToolbarTabId, hidden: boolean): void;
+  setQuickAccessCommands(commandIds: readonly string[]): void;
+  /** Reset every option (or one tab-group) back to defaults. */
+  reset(group?: ViewerOptionsGroupId): void;
+  subscribe(listener: ViewerOptionsListener): () => void;
+  /**
+   * Subscribe to ONE projection of the options, woken only when that
+   * projection changes.
+   *
+   * `subscribe` above wakes on every option change, which in a binding means
+   * the whole options consumer re-renders because the user toggled something
+   * unrelated. A ribbon control that reads `ribbon.hiddenTabIds` should not
+   * care that an autosave interval moved (issue #145).
+   *
+   * IMPORTANT for array/object slices: every write here deep-clones the whole
+   * options object (`cloneViewerOptions`), so a nested array is a NEW array
+   * after ANY change, even one that did not touch it. Under the default
+   * `Object.is` such a selector would fire on every write and buy nothing.
+   * Pass a value equality for those, e.g. the shared `sameArray`.
+   */
+  subscribeSelector<T>(selector: (options: ViewerOptions) => T, listener: (value: T, previous: T) => void, isEqual?: (a: T, b: T) => boolean): () => void;
+  /**
+   * Apply several option writes as ONE notification, so a multi-field
+   * operation costs a single render instead of one per field.
+   */
+  batch(write: () => void): void;
+  /**
+   * Apply host constraints (see `ViewerOptionsConstraints`): `locked` values
+   * are forced in and every later write to them is ignored; `defaults`
+   * replace the built-in defaults for settings the user never saved, and
+   * become what `reset` returns to. Replaces any previous constraints.
+   */
+  setConstraints(constraints: ViewerOptionsConstraints): void;
+  /** True when the host locked `<group>.<key>`. */
+  isLocked(group: ViewerOptionsGroupId, key: string): boolean;
+}
+//#endregion
+//#region src/render/customization/customization-catalog.d.ts
+declare const RIBBON_TAB_IDS: readonly ToolbarTabId[];
+declare const TOOLBAR_BUTTON_IDS: readonly ["share", "broadcast", "export", "undo", "redo", "record", "notes", "fullscreen", "zoom", "navigation"];
+declare const OPTIONS_PAGE_IDS: readonly OptionsPageId[];
+declare const OPTIONS_SECTION_IDS: readonly OptionsSectionId[];
+declare const OPTIONS_SETTING_IDS: readonly OptionsSettingId[];
+declare const BACKSTAGE_PAGE_IDS: readonly BackstagePage[];
+declare const BACKSTAGE_CARD_IDS: readonly BackstageCardId[];
+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"];
+declare const CANVAS_CONTEXT_MENU_COMMAND_IDS: readonly ["paste", "layout", "reset-slide", "format-background", "grid-and-guides", "ruler"];
+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"];
+declare const VIEWER_PANEL_IDS: readonly ["statusBar", "slidesPane", "inspector", "notes", "quickAccessToolbar", "titleBar"];
+declare const VIEWER_FEATURE_IDS: readonly ["ai", "collaboration", "comments", "presentMode"];
+declare const VIEWER_DIALOG_IDS: readonly ["options", "share", "broadcast", "print", "export"];
+declare const VIEWER_EXPORT_FORMAT_IDS: readonly ["pdf", "png", "video", "gif", "json", "copyImage"];
+//#endregion
+//#region src/render/customization/customization-keymap.d.ts
+/** A parsed `Mod+Shift+D` chord. */
+interface ParsedShortcutChord {
+  key: string;
+  mod: boolean;
+  ctrl: boolean;
+  meta: boolean;
+  alt: boolean;
+  shift: boolean;
+}
+/** The normalised keyboard slice of a resolved customisation. */
+interface ResolvedKeyboardCustomization {
+  disableAll: boolean;
+  disabled: ReadonlySet<EditorKeyActionName>;
+  remap: ReadonlyMap<EditorKeyActionName, readonly ParsedShortcutChord[]>;
+}
+//#endregion
+//#region src/render/customization/customization-resolve.d.ts
+/** The normalised, set-based view of a customisation. Treat as immutable. */
+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;
+}
+//#endregion
+//#region src/render/customization/customization-controller.d.ts
+/** The imperative methods every binding's component handle exposes. */
+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;
+}
+interface ViewerCustomizationController {
+  /** The helper methods, ready to spread onto a component handle. */
+  readonly api: ViewerCustomizationApi;
+  /** The normalised view the render sites read. Stable until the next change. */
+  getResolved(): ResolvedCustomization;
+  /** Subscribe to every change; returns the unsubscribe function. */
+  subscribe(listener: () => void): () => void;
+}
+//#endregion
 //#region src/render/inline-text-commit.d.ts
 /**
  * Reconcile a committed plain-text edit with an element's existing rich runs.
@@ -13895,5 +14413,5 @@ interface TransitionOverlayParams {
  */
 declare function playTransitionOverlay(params: TransitionOverlayParams): () => void;
 //#endregion
-export { RANDOM_ELIGIBLE_TYPES as $, PptxSmartArtData as $n, savedPresentationFileName as $t, FieldSubstitutionContext as A, PptxComment as An, canInteractWithElement as At, MobileSheetKey as B, PptxEmbeddedFont as Bn, loadPresentationDeck as Bt, ElementAnimationState as C, PptxAnimationRepeatMode as Cn, ViewerMode as Ct, ExternalCollaborationAwareness as D, PptxAnimationTrigger as Dn, WHEEL_SPOKE_COUNTS as Dt, ElementUpdateOptions as E, PptxAnimationTimingCurve as En, ViewportFitPadding as Et, InlineTextEditSnapshot as F, PptxCustomProperty as Fn, getP14TransitionAnimations as Ft, PPTX_OPEN_ACCEPT as G, PptxModernCommentAuthor as Gn, rememberSessionDeck as Gt, P14_TRANSITION_KEYFRAMES as H, PptxHeaderFooter as Hn, overlayInlineTextSnapshot as Ht, InlineTextSelection as I, PptxCustomShow as In, getSessionTabId as It, PowerPointViewerAPI as J, PptxPresentationProperties as Jn, resolveOrientation as Jt, PRESENTATION_OPEN_EXTENSIONS as K, PptxModifyVerifier as Kn, resolveDirection as Kt, InsertChartKind as L, PptxData as Ln, getSlideTransitionAnimations as Lt, Guide as M, PptxCommentMention as Mn, describeCollaborationShellState as Mt, INSTANT as N, PptxCompatibilityWarning as Nn, forgetSessionDeck as Nt, ExternalCollaborationSession as O, PptxAppProperties as On, ZoomNavigationTarget as Ot, InlineListReadResult as P, PptxCoreProperties as Pn, getCinematicTransitionAnimations as Pt, PrintSettings as Q, PptxSlideTransition as Qn, restoreSessionDeck as Qt, MasterViewCrudAction as R, PptxElement as Rn, isLegacyBinaryPresentation as Rt, EASE as S, PptxAnimationPreset as Sn, ViewerFontSource as St, ElementUpdate as T, PptxAnimationTimelineAnchor as Tn, ViewportFitOptions as Tt, P14_TRANSITION_KEYFRAMES_2 as U, PptxImageEffects as Un, parsePresentationSessionId as Ut, ModifyPasswordCheckResult as V, PptxHandoutMaster as Vn, loadSessionDeck as Vt, P14_TRANSITION_KEYFRAMES_ALL as W, PptxLayoutPreview as Wn, presentationBaseName as Wt, PresentationPointerTool as X, PptxSlide as Xn, resolveTransitionDurationMs as Xt, PresentationBlackout as Y, PptxSection as Yn, resolveSlideTransition as Yt, PresentationSnapshot as Z, PptxSlideMaster as Zn, resolveWheelSpokeCount as Zt, CompatibilityWarningToast as _, OleObjectType as _n, TextSegment as _r, SlideTransitionAnimations as _t, AnimationGroup as a, defaultThemeColors as an, PptxTheme as ar, RulerUnit as at, DEFAULT_MORPH_DURATION_MS as b, PptxAfterAnimationAction as bn, TextAdvancedChanges as bt, CanvasSize as c, vermilionLightTheme as cn, PptxThemeFontScheme as cr, SLIDE_TRANSITION_KEYFRAMES_CSS as ct, CollabLoadOrigin as d, PptxHandlerSaveOptions as dn, PptxViewProperties as dr, SessionDeck as dt, ThemeCatalogEntry as en, PptxSmartArtNodeStyle as er, ReadOnlyRecommendation as et, CollaborationConfig as f, PptxSaveFormat as fn, ShapeStyle as fr, ShapePresetType as ft, CollaborationTransport as g, MediaPptxElement as gn, TablePptxElement as gr, SlideTemplateId as gt, CollaborationShellState as h, MasterViewTab as hn, SmartArtLayoutType as hr, SlideSizeRescaleMode as ht, AlignEdge as i, defaultRadius as in, PptxTextStyleLevels as ir, RibbonTransitionDraft as it, GradientState as j, PptxCommentAuthor as jn, createImageElementFromFile as jt, ExternalCollaborationSnapshot as k, PptxChartData as kn, buildInlineTextCommitPatch as kt, ChangeCaseMode as l, AccessibilityIssue as ln, PptxThemeOption as lr, SanitizedPresence as lt, CollaborationRole as m, ElementAction as mn, SmartArtLayout as mr, SlideSizeEmu as mt, playTransitionOverlay as n, ViewerThemeColors as nn, PptxTableData as nr, ResolvedDirection as nt, AutosaveRecord as o, themeToCssVars as on, PptxThemeColorRef as or, RunProgramNotice as ot, CollaborationLivePatcher as p, SvgExportOptions as pn, SmartArtColorScheme as pr, ShareDefaults as pt, PasteSpecialFormat as q, PptxNotesMaster as qn, resolveDirection8 as qt, AccountAuthConfig as r, defaultCssVars as rn, PptxTagCollection as rr, ResolvedDirection8 as rt, CINEMATIC_TRANSITION_KEYFRAMES as s, vermilionDarkTheme as sn, PptxThemeColorScheme as sr, SLIDE_TRANSITION_KEYFRAMES as st, TransitionOverlayParams as t, ViewerTheme as tn, PptxTableCellStyle as tr, RemoteCursor as tt, ChartPartRef as u, PptxHandler as un, PptxTransitionType as ur, SavedPresentationFormat as ut, ConnectionStatus as v, OlePptxElement as vn, TextStyle as vr, StrokeToInkElementOpts as vt, ElementClipboardPayload as w, PptxAnimationSequence as wn, ViewerQuickAccessOptions as wt, DEFAULT_TRANSITION_DURATION_MS as x, PptxAnimationDirection as xn, ToolbarActionId as xt, CssStyleMap as y, ParsedTableStyleMap as yn, XmlObject as yr, TRANSITION_SPEED_DURATION_MS as yt, MasterViewCrudActionId as z, PptxElementAnimation as zn, isSupportedPresentationFile as zt };
-//# sourceMappingURL=transition-overlay-_0B-nMEW.d.ts.map
+export { MobileSheetKey as $, PptxSaveFormat as $n, ShapeStyle as $r, VIEWER_PANEL_IDS as $t, DEFAULT_TRANSITION_DURATION_MS as A, parsePresentationSessionId as An, PptxImageEffects as Ar, RunProgramNotice as At, ExternalCollaborationSession as B, savedPresentationFileName as Bn, PptxSmartArtData as Br, SlideSizeRescaleMode as Bt, CollaborationTransport as C, getSessionTabId as Cn, PptxCustomShow as Cr, RemoteCursor as Ct, ContextMenuCustomization as D, loadPresentationDeck as Dn, PptxEmbeddedFont as Dr, RibbonCustomization as Dt, ContextMenuCommandId as E, isSupportedPresentationFile as En, PptxElementAnimation as Er, ResolvedDirection8 as Et, ElementAnimationState as F, resolveOrientation as Fn, PptxPresentationProperties as Fr, SessionDeck as Ft, INSTANT as G, defaultRadius as Gn, PptxTextStyleLevels as Gr, TRANSITION_SPEED_DURATION_MS as Gt, FieldSubstitutionContext as H, ViewerTheme as Hn, PptxTableCellStyle as Hr, SlideTransitionAnimations as Ht, ElementClipboardPayload as I, resolveSlideTransition as In, PptxSection as Ir, ShapePresetType as It, InlineTextSelection as J, vermilionDarkTheme as Jn, PptxThemeColorScheme as Jr, ToolbarButtonId as Jt, InlineListReadResult as K, defaultThemeColors as Kn, PptxTheme as Kr, TextAdvancedChanges as Kt, ElementUpdate as L, resolveTransitionDurationMs as Ln, PptxSlide as Lr, ShareDefaults as Lt, EDITOR_SHORTCUT_ACTION_IDS as M, rememberSessionDeck as Mn, PptxModernCommentAuthor as Mr, SLIDE_TRANSITION_KEYFRAMES_CSS as Mt, ELEMENT_CONTEXT_MENU_COMMAND_IDS as N, resolveDirection as Nn, PptxModifyVerifier as Nr, SanitizedPresence as Nt, CssStyleMap as O, loadSessionDeck as On, PptxHandoutMaster as Or, RibbonTransitionDraft as Ot, EditorKeyActionName as P, resolveDirection8 as Pn, PptxNotesMaster as Pr, SavedPresentationFormat as Pt, MasterViewCrudActionId as Q, PptxHandlerSaveOptions as Qn, PptxViewProperties as Qr, VIEWER_FEATURE_IDS as Qt, ElementUpdateOptions as R, resolveWheelSpokeCount as Rn, PptxSlideMaster as Rr, ShortcutChord as Rt, CollaborationShellState as S, getP14TransitionAnimations as Sn, PptxCustomProperty as Sr, ReadOnlyRecommendation as St, ConnectionStatus as T, isLegacyBinaryPresentation as Tn, PptxElement as Tr, ResolvedDirection as Tt, GradientState as U, ViewerThemeColors as Un, PptxTableData as Ur, StrokeToInkElementOpts as Ut, ExternalCollaborationSnapshot as V, ThemeCatalogEntry as Vn, PptxSmartArtNodeStyle as Vr, SlideTemplateId as Vt, Guide as W, defaultCssVars as Wn, PptxTagCollection as Wr, TOOLBAR_BUTTON_IDS as Wt, KeyboardCustomization as X, AccessibilityIssue as Xn, PptxThemeOption as Xr, VIEWER_DIALOG_IDS as Xt, InsertChartKind as Y, vermilionLightTheme as Yn, PptxThemeFontScheme as Yr, ToolbarTabId as Yt, MasterViewCrudAction as Z, PptxHandler as Zn, PptxTransitionType as Zr, VIEWER_EXPORT_FORMAT_IDS as Zt, ChartPartRef as _, canInteractWithElement as _n, PptxComment as _r, PresentationPointerTool as _t, AnimationGroup as a, TextStyle as ai, ViewerFeatureId as an, OlePptxElement as ar, OptionsPageId as at, CollaborationLivePatcher as b, forgetSessionDeck as bn, PptxCompatibilityWarning as br, RANDOM_ELIGIBLE_TYPES as bt, BACKSTAGE_PAGE_IDS as c, ViewerOptionPrimitive as cn, PptxAnimationDirection as cr, OptionsSettingValues as ct, BackstagePage as d, ViewerQuickAccessOptions as dn, PptxAnimationSequence as dr, P14_TRANSITION_KEYFRAMES_ALL as dt, SmartArtColorScheme as ei, ViewerCustomization as en, SvgExportOptions as er, ModifyPasswordCheckResult as et, CANVAS_CONTEXT_MENU_COMMAND_IDS as f, ViewportFitOptions as fn, PptxAnimationTimelineAnchor as fr, PPTX_OPEN_ACCEPT as ft, ChangeCaseMode as g, buildInlineTextCommitPatch as gn, PptxChartData as gr, PresentationBlackout as gt, CanvasSize as h, ZoomNavigationTarget as hn, PptxAppProperties as hr, PowerPointViewerAPI as ht, AlignEdge as i, TextSegment as ii, ViewerExportFormatId as in, OleObjectType as ir, OptionsCustomization as it, EASE as j, presentationBaseName as jn, PptxLayoutPreview as jr, SLIDE_TRANSITION_KEYFRAMES as jt, DEFAULT_MORPH_DURATION_MS as k, overlayInlineTextSnapshot as kn, PptxHeaderFooter as kr, RulerUnit as kt, BackstageCardId as l, ViewerOptionsStore as ln, PptxAnimationPreset as lr, P14_TRANSITION_KEYFRAMES as lt, CanvasContextMenuCommandId as m, WHEEL_SPOKE_COUNTS as mn, PptxAnimationTrigger as mr, PasteSpecialFormat as mt, playTransitionOverlay as n, SmartArtLayoutType as ni, ViewerCustomizationController as nn, MasterViewTab as nr, OPTIONS_SECTION_IDS as nt, AutosaveRecord as o, XmlObject as oi, ViewerFontSource as on, ParsedTableStyleMap as or, OptionsSectionId as ot, CINEMATIC_TRANSITION_KEYFRAMES as p, ViewportFitPadding as pn, PptxAnimationTimingCurve as pr, PRESENTATION_OPEN_EXTENSIONS as pt, InlineTextEditSnapshot as q, themeToCssVars as qn, PptxThemeColorRef as qr, ToolbarActionId as qt, AccountAuthConfig as r, TablePptxElement as ri, ViewerDialogId as rn, MediaPptxElement as rr, OPTIONS_SETTING_IDS as rt, BACKSTAGE_CARD_IDS as s, ViewerMode as sn, PptxAfterAnimationAction as sr, OptionsSettingId as st, TransitionOverlayParams as t, SmartArtLayout as ti, ViewerCustomizationApi as tn, ElementAction as tr, OPTIONS_PAGE_IDS as tt, BackstageCustomization as u, ViewerPanelId as un, PptxAnimationRepeatMode as ur, P14_TRANSITION_KEYFRAMES_2 as ut, CollabLoadOrigin as v, createImageElementFromFile as vn, PptxCommentAuthor as vr, PresentationSnapshot as vt, CompatibilityWarningToast as w, getSlideTransitionAnimations as wn, PptxData as wr, ResolvedCustomization as wt, CollaborationRole as x, getCinematicTransitionAnimations as xn, PptxCoreProperties as xr, RIBBON_TAB_IDS as xt, CollaborationConfig as y, describeCollaborationShellState as yn, PptxCommentMention as yr, PrintSettings as yt, ExternalCollaborationAwareness as z, restoreSessionDeck as zn, PptxSlideTransition as zr, SlideSizeEmu as zt };
+//# sourceMappingURL=transition-overlay-C2lOs9rM.d.ts.map