pptx-svelte-viewer 4.4.0 → 4.6.0

package/dist/index.d.ts

@@ -1805,6 +1805,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. */
@@ -1817,6 +1826,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
@@ -3449,6 +3470,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 {
@@ -4113,6 +4143,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`).
    *
@@ -12369,6 +12411,27 @@ declare function forgetSessionDeck(): Promise<void>;
 declare function restoreSessionDeck(): Promise<SessionDeck | null>;
 declare function parsePresentationSessionId(hash: string): string | null;
 declare function loadPresentationDeck(sessionId: string): Promise<Uint8Array | null>;
+/** 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/image-file-insertion.d.ts
 /**
@@ -12403,6 +12466,21 @@ declare function listAutosaveSnapshots(): Promise<Array<{
 }>>;
 /** Delete a snapshot, rejecting when IndexedDB cannot commit the transaction. */
 declare function deleteAutosaveSnapshot(filePath: string): Promise<boolean>;
+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';
 /**
  * Optional hook point for hosts that want to wire a real sign-in flow into
  * File > Account. Disabled by default: the Account page renders nothing
@@ -12445,6 +12523,165 @@ type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'rec
 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;
+  showCommandLabels: boolean;
+  /** 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
 /**
  * Pure handout layout calculations, shared by every binding's print path.
@@ -12488,6 +12725,226 @@ 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/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;
+}
+//#endregion
 //#region src/render/viewport-fit.d.ts
 /** Unscaled CSS pixels reserved on each side of the ordinary viewer viewport. */
 type ViewportFitPadding = number | {
@@ -12969,6 +13426,18 @@ interface PowerPointViewerProps extends ViewportFitOptions {
      * hidden, matching the pre-existing always-visible behaviour.
      */
     hiddenActions?: ToolbarActionId[];
+    /**
+     * Framework-neutral UI customisation. See docs/guide/customization.md.
+     *
+     * Hides ribbon tabs, toolbar buttons, Options pages / sections / settings,
+     * File tab pages and cards, context-menu entries, panels, features and
+     * dialogs; locks settings and sets host defaults; disables or remaps editor
+     * shortcuts. Unioned with `hiddenActions`. Passing a NEW object replaces the
+     * whole customisation, discarding edits made through the imperative
+     * helpers (`hideRibbonTab`, `lockSetting`, ...) on the component instance;
+     * mutating the same object in place is not observed.
+     */
+    customization?: ViewerCustomization;
     /**
      * Show the speaker-notes panel and its toolbar toggle. Default true. The
      * panel is plain-text only and reads the active slide's notes; pass
@@ -13159,9 +13628,10 @@ interface PowerPointViewerProps extends ViewportFitOptions {
 /**
  * Imperative editing API exposed on the `<PowerPointViewer>` component
  * instance (via `bind:this`). Mirrors the vanilla binding's `EditorController`
- * surface subset the host drives directly.
+ * surface subset the host drives directly, plus the shared UI-customisation
+ * helpers (`ViewerCustomizationApi`: `hideRibbonTab`, `lockSetting`, ...).
  */
-interface PowerPointViewerApi extends PowerPointViewerAPI {
+interface PowerPointViewerApi extends PowerPointViewerAPI, ViewerCustomizationApi {
     /** Undo the last committed edit. */
     undo(): void;
     /** Redo the last undone edit. */
@@ -13264,5 +13734,5 @@ declare const PowerPointViewer: Component<PowerPointViewerProps, PowerPointViewe
  */
 type AutosaveStatus = 'idle' | 'disabled' | 'saving' | 'saved' | 'error';
 
-export { PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewer, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, describeCollaborationShellState, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, forgetSessionDeck, getAutosaveSnapshot, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, listAutosaveSnapshots, loadPresentationDeck, loadSessionDeck, parsePresentationSessionId, presentationBaseName, registerTranslations, rememberSessionDeck, renderToCanvas, restoreSessionDeck, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius };
-export type { AutosaveRecord, AutosaveStatus, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationShellState, CollaborationTransport, ConnectionStatus, ElementUpdate, ElementUpdateOptions, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, PowerPointViewerApi, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy, PrintOptions, RemoteCursor, SanitizedPresence, SavedPresentationFormat, SessionDeck, SvgExportAllOptions, SvgExportSingleSlideOptions, TranslationDictionary, Translator, ViewerLoadDetail, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };
+export { BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, CANVAS_CONTEXT_MENU_COMMAND_IDS, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewer, RIBBON_TAB_IDS, TOOLBAR_BUTTON_IDS, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, describeCollaborationShellState, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, forgetSessionDeck, getAutosaveSnapshot, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, listAutosaveSnapshots, loadPresentationDeck, loadSessionDeck, parsePresentationSessionId, presentationBaseName, registerTranslations, rememberSessionDeck, renderToCanvas, restoreSessionDeck, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius };
+export type { AutosaveRecord, AutosaveStatus, BackstageCustomization, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationShellState, CollaborationTransport, ConnectionStatus, ContextMenuCustomization, ElementUpdate, ElementUpdateOptions, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, KeyboardCustomization, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PowerPointViewerApi, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy, PrintOptions, RemoteCursor, ResolvedCustomization, RibbonCustomization, SanitizedPresence, SavedPresentationFormat, SessionDeck, ShortcutChord, SvgExportAllOptions, SvgExportSingleSlideOptions, TranslationDictionary, Translator, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerLoadDetail, ViewerPanelId, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };

package/dist/index.js

@@ -1,41 +1,55 @@
-import { $t as e, Ah as a, Al as o, Bl as r, Bo as t, El as i, Ic as l, Il as n, Mh as S, Nh as m, Tp as d, Wu as p, Zd as h, _p as T, as as v, cs as c, hc as g, in as P, jh as u, kh as A, ls as C, nh as E, os as N, ps as k, rc as f, sd as D, zl as I } from "./transition-overlay-CfsPqlES.js";
-import { i as x } from "./translator-Dn-ANCp2.js";
-import { M as _, a as F, c as O, l as L, o as R, s as V, t as w } from "./export-BUx-Kmlc.js";
+import { As as a, Bc as e, Ih as o, Ls as r, M as t, Ms as i, Nn as S, Ns as T, Oc as _, P as l, R as n, Xt as E, Yt as I, Zp as A, Zt as N, _r as D, _t as O, am as m, as as d, bt as P, cn as p, dg as C, eu as g, fg as v, fu as R, gu as u, hu as c, ir as h, kf as B, ks as M, lg as f, ou as k, pg as x, pn as L, sl as V, ug as b, vr as F, xd as G, xr as X, yr as U, zd as W } from "./transition-overlay-Dkooknvn.js";
+import { i as w } from "./translator-DC6tH5v7.js";
+import { M as Z, a as z, c as H, l as Y, o as j, s as q, t as J } from "./export-zzqiDncO.js";
 import "./i18n.js";
 export {
-  e as PPTX_OPEN_ACCEPT,
-  P as PRESENTATION_OPEN_EXTENSIONS,
-  w as PowerPointViewer,
-  t as createImageElementFromFile,
-  v as defaultCssVars,
-  N as defaultRadius,
-  c as defaultThemeColors,
-  C as deleteAutosaveSnapshot,
-  k as describeCollaborationShellState,
-  F as exportAllSlidesToSvg,
-  R as exportAllSlidesToSvgBlobs,
-  V as exportSlideAsSvg,
-  O as exportSlideToSvg,
-  L as exportSlideToSvgBlob,
-  f as forgetSessionDeck,
-  g as getAutosaveSnapshot,
-  l as getSessionTabId,
-  i as isLegacyBinaryPresentation,
-  o as isSupportedPresentationFile,
-  n as listAutosaveSnapshots,
-  I as loadPresentationDeck,
-  r as loadSessionDeck,
-  p as parsePresentationSessionId,
-  D as presentationBaseName,
-  x as registerTranslations,
-  h as rememberSessionDeck,
-  _ as renderToCanvas,
-  T as restoreSessionDeck,
-  d as savedPresentationFileName,
-  E as themeToCssVars,
-  A as vermilionDarkColors,
-  a as vermilionDarkTheme,
-  u as vermilionLightColors,
-  S as vermilionLightTheme,
-  m as vermilionRadius
+  t as BACKSTAGE_CARD_IDS,
+  l as BACKSTAGE_PAGE_IDS,
+  n as CANVAS_CONTEXT_MENU_COMMAND_IDS,
+  O as EDITOR_SHORTCUT_ACTION_IDS,
+  P as ELEMENT_CONTEXT_MENU_COMMAND_IDS,
+  I as OPTIONS_PAGE_IDS,
+  E as OPTIONS_SECTION_IDS,
+  N as OPTIONS_SETTING_IDS,
+  p as PPTX_OPEN_ACCEPT,
+  L as PRESENTATION_OPEN_EXTENSIONS,
+  J as PowerPointViewer,
+  S as RIBBON_TAB_IDS,
+  h as TOOLBAR_BUTTON_IDS,
+  D as VIEWER_DIALOG_IDS,
+  F as VIEWER_EXPORT_FORMAT_IDS,
+  U as VIEWER_FEATURE_IDS,
+  X as VIEWER_PANEL_IDS,
+  d as createImageElementFromFile,
+  M as defaultCssVars,
+  a as defaultRadius,
+  i as defaultThemeColors,
+  T as deleteAutosaveSnapshot,
+  r as describeCollaborationShellState,
+  z as exportAllSlidesToSvg,
+  j as exportAllSlidesToSvgBlobs,
+  q as exportSlideAsSvg,
+  H as exportSlideToSvg,
+  Y as exportSlideToSvgBlob,
+  _ as forgetSessionDeck,
+  e as getAutosaveSnapshot,
+  V as getSessionTabId,
+  g as isLegacyBinaryPresentation,
+  k as isSupportedPresentationFile,
+  R as listAutosaveSnapshots,
+  c as loadPresentationDeck,
+  u as loadSessionDeck,
+  G as parsePresentationSessionId,
+  W as presentationBaseName,
+  w as registerTranslations,
+  B as rememberSessionDeck,
+  Z as renderToCanvas,
+  A as restoreSessionDeck,
+  m as savedPresentationFileName,
+  o as themeToCssVars,
+  f as vermilionDarkColors,
+  b as vermilionDarkTheme,
+  C as vermilionLightColors,
+  v as vermilionLightTheme,
+  x as vermilionRadius
 };