pptx-angular-viewer 1.30.1 → 1.31.1

package/types/pptx-angular-viewer.d.ts

@@ -1914,10 +1914,16 @@ interface EditorHistoryOptions {
  * already-cloned snapshots.
  */
 declare class EditorHistory<T> {
-    private readonly _maxDepth;
+    private _maxDepth;
     private readonly _past;
     private readonly _future;
     constructor(options?: EditorHistoryOptions);
+    /**
+     * Change the maximum undo depth at runtime (File > Options > Advanced >
+     * "Maximum number of undos"). Trims the past stack immediately if the new
+     * limit is smaller.
+     */
+    setMaxDepth(maxDepth: number): void;
     /** True when at least one undo step is available. */
     get canUndo(): boolean;
     /** True when at least one redo step is available. */
@@ -4018,10 +4024,6 @@ interface ShortcutReferenceItem {
     shortcut: string;
 }
 declare const SHORTCUT_REFERENCE_ITEMS: readonly ShortcutReferenceItem[];
-interface ViewerPreferenceToggle {
-    key: keyof ViewerPreferences;
-    labelKey: string;
-}
 
 interface SpeechAlternative {
     readonly transcript: string;
@@ -4127,95 +4129,140 @@ type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transition
 type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
 
 /**
- * Minimal GIF89a encoder (pure JS, no external dependency) plus pure
- * frame-planning helpers — shared by the React, Vue, and Angular bindings.
- *
- * The encoder uses median-cut colour quantisation (256 colours per frame) and
- * LZW compression. It carries no DOM/browser dependency — it operates on
- * pre-extracted `ImageData` objects — so each binding owns the rasterisation
- * (grabbing a canvas, calling `getImageData`) and the `Blob` wrapping, while
- * the byte encoding lives here once.
- *
- * No npm GIF library is depended on; this self-contained source replaces the
- * three previously-duplicated copies (React `export-gif-encoder.ts`, Vue
- * `gif-encoder.ts`, Angular `gif-export-helpers.ts`).
- */
-/** A single GIF frame descriptor produced by the planning helpers. */
-interface GifFramePlan {
-    /** 0-based slide index this frame corresponds to. */
-    slideIndex: number;
-    /** Frame delay in **centiseconds** (1 cs = 10 ms), as required by GIF89a. */
-    delayCs: number;
-}
-/** Options controlling GIF frame planning. */
-interface GifPlanOptions {
-    /** Total number of slides in the presentation. */
-    totalSlides: number;
-    /**
-     * Duration each slide is shown, in **milliseconds** (default: 2000).
-     * Per-slide overrides can be supplied via {@link slideTimingsMs}.
-     */
-    slideDurationMs?: number;
-    /**
-     * Per-slide duration overrides in milliseconds (index maps to slide index).
-     * When a slide's index is present here its value takes precedence over
-     * {@link slideDurationMs}.
-     */
-    slideTimingsMs?: number[];
+ * 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;
+}
+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;
+}
+interface ViewerSaveOptions {
+    autoSave: boolean;
+    autoRecoverIntervalMinutes: number;
+    keepLastAutoRecoveredVersion: boolean;
+    defaultExportFormat: DefaultExportFormat;
+    embedFonts: boolean;
+    embedAllFontCharacters: boolean;
+    cacheRetentionDays: number;
+    clearCacheOnClose: boolean;
+}
+interface ViewerAccessibilityOptions {
+    showAccessibilityStatus: boolean;
+    feedbackWithSound: boolean;
+    soundScheme: FeedbackSoundScheme;
+    showShortcutKeysInScreenTips: boolean;
+    reducedMotion: boolean;
 }
-/**
- * Compute the ordered list of {@link GifFramePlan} objects for a presentation.
- * All timing is derived here; nothing browser-specific is touched.
- */
-declare function planGifFrames(opts: GifPlanOptions): GifFramePlan[];
-/**
- * Convert a slide duration in milliseconds to a GIF89a frame delay in
- * centiseconds (1 cs = 10 ms), clamped to a minimum of 1 cs.
- */
-declare function msToFrameDelayCs(ms: number): number;
-/**
- * Clamp canvas/image dimensions so neither side exceeds `maxSide` pixels while
- * preserving the aspect ratio. When both dimensions are already within the
- * limit the original values are returned unchanged.
- */
-declare function clampGifDimensions(width: number, height: number, maxSide?: number): {
-    width: number;
-    height: number;
-};
-/** A single animated-GIF frame: raw RGBA pixels plus its dimensions. */
-interface GifFrame {
-    imageData: ImageData;
-    width: number;
-    height: number;
-    /**
-     * Optional per-frame delay in **centiseconds** (1 cs = 10 ms). When set it
-     * overrides the encoder-level delay for this frame only, which is how
-     * per-slide durations from {@link planGifFrames} flow into the encoder.
-     */
-    delayCs?: number;
+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;
+    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;
+
+/**
+ * Quick Access Toolbar command catalog and list-editing helpers, backing the
+ * Options > Quick Access Toolbar pane and the title-bar QAT strip.
+ *
+ * Ids map onto actions every binding already exposes; each binding resolves
+ * an id to its own icon + handler when rendering the strip.
+ */
+interface QuickAccessCommandDefinition {
+    id: string;
+    labelKey: string;
+    /** Logical icon name bindings map to their icon set. */
+    icon: string;
 }
-/** Options for {@link encodeGif}. */
-interface EncodeGifOptions {
-    /**
-     * Frame delay in **centiseconds** (1 cs = 10 ms). Applies to every frame
-     * that does not carry its own {@link GifFrame.delayCs} override.
-     * Default: 200 cs (2 s).
-     */
-    delayCs?: number;
-    /** Number of times the animation loops (0 = loop forever, default). */
-    loopCount?: number;
+
+interface ViewerAddinStatus {
+    /** Addin id -> whether the capability is active in this host. */
+    [addinId: string]: boolean | undefined;
 }
-/**
- * Encode an ordered list of RGBA frames into an animated GIF89a byte sequence.
- *
- * Accepts either a bare `delayCs` number (React/Vue call style) or an
- * {@link EncodeGifOptions} object (Angular call style) as the second argument.
- *
- * @param frames Ordered frame descriptors (all must share identical dimensions).
- * @param delay  Per-frame delay in centiseconds, or an options object.
- * @returns Raw GIF89a bytes.
- */
-declare function encodeGif(frames: GifFrame[], delay?: number | EncodeGifOptions): Uint8Array;
 
 /**
  * Pure handout layout calculations, shared by every binding's print path.
@@ -4339,6 +4386,176 @@ interface PrintHtmlDocumentOptions {
  */
 declare function buildPrintHtmlDocument(options: PrintHtmlDocumentOptions): string;
 
+/**
+ * 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';
+interface ViewerOptionsSelectChoice {
+    value: string;
+    labelKey: string;
+}
+interface ControlBase {
+    group: ViewerOptionsGroupId;
+    key: string;
+    labelKey: string;
+    /** Optional "(i)" tooltip body, mirroring PowerPoint's info bubbles. */
+    infoKey?: string;
+    /** Renders indented under the preceding control, PowerPoint-style. */
+    indent?: boolean;
+}
+interface ViewerOptionsToggleControl extends ControlBase {
+    kind: 'toggle';
+}
+interface ViewerOptionsSelectControl extends ControlBase {
+    kind: 'select';
+    choices: readonly ViewerOptionsSelectChoice[];
+}
+interface ViewerOptionsNumberControl extends ControlBase {
+    kind: 'number';
+    min: number;
+    max: number;
+    step?: number;
+    unitKey?: string;
+}
+interface ViewerOptionsTextControl extends ControlBase {
+    kind: 'text';
+    maxLength?: number;
+}
+type ViewerOptionsControl = ViewerOptionsToggleControl | ViewerOptionsSelectControl | ViewerOptionsNumberControl | ViewerOptionsTextControl;
+interface ViewerOptionsSection {
+    id: string;
+    titleKey: string;
+    /** Optional explanatory paragraph under the section title. */
+    descriptionKey?: string;
+    /** Marks a bespoke block a binding renders itself (e.g. the theme picker). */
+    special?: 'themePicker' | 'clearCache' | 'shortcutReference';
+    controls: readonly ViewerOptionsControl[];
+}
+interface ViewerOptionsTabDefinition {
+    id: ViewerOptionsTabId;
+    labelKey: string;
+    /** Headline shown at the top of the pane. */
+    descriptionKey: string;
+    /** Pane needing a bespoke view instead of (or on top of) `sections`. */
+    custom?: 'language' | 'ribbon' | 'quickAccess' | 'addIns';
+    sections: readonly ViewerOptionsSection[];
+}
+
+/**
+ * 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;
+}
+
+/**
+ * Minimal GIF89a encoder (pure JS, no external dependency) plus pure
+ * frame-planning helpers — shared by the React, Vue, and Angular bindings.
+ *
+ * The encoder uses median-cut colour quantisation (256 colours per frame) and
+ * LZW compression. It carries no DOM/browser dependency — it operates on
+ * pre-extracted `ImageData` objects — so each binding owns the rasterisation
+ * (grabbing a canvas, calling `getImageData`) and the `Blob` wrapping, while
+ * the byte encoding lives here once.
+ *
+ * No npm GIF library is depended on; this self-contained source replaces the
+ * three previously-duplicated copies (React `export-gif-encoder.ts`, Vue
+ * `gif-encoder.ts`, Angular `gif-export-helpers.ts`).
+ */
+/** A single GIF frame descriptor produced by the planning helpers. */
+interface GifFramePlan {
+    /** 0-based slide index this frame corresponds to. */
+    slideIndex: number;
+    /** Frame delay in **centiseconds** (1 cs = 10 ms), as required by GIF89a. */
+    delayCs: number;
+}
+/** Options controlling GIF frame planning. */
+interface GifPlanOptions {
+    /** Total number of slides in the presentation. */
+    totalSlides: number;
+    /**
+     * Duration each slide is shown, in **milliseconds** (default: 2000).
+     * Per-slide overrides can be supplied via {@link slideTimingsMs}.
+     */
+    slideDurationMs?: number;
+    /**
+     * Per-slide duration overrides in milliseconds (index maps to slide index).
+     * When a slide's index is present here its value takes precedence over
+     * {@link slideDurationMs}.
+     */
+    slideTimingsMs?: number[];
+}
+/**
+ * Compute the ordered list of {@link GifFramePlan} objects for a presentation.
+ * All timing is derived here; nothing browser-specific is touched.
+ */
+declare function planGifFrames(opts: GifPlanOptions): GifFramePlan[];
+/**
+ * Convert a slide duration in milliseconds to a GIF89a frame delay in
+ * centiseconds (1 cs = 10 ms), clamped to a minimum of 1 cs.
+ */
+declare function msToFrameDelayCs(ms: number): number;
+/**
+ * Clamp canvas/image dimensions so neither side exceeds `maxSide` pixels while
+ * preserving the aspect ratio. When both dimensions are already within the
+ * limit the original values are returned unchanged.
+ */
+declare function clampGifDimensions(width: number, height: number, maxSide?: number): {
+    width: number;
+    height: number;
+};
+/** A single animated-GIF frame: raw RGBA pixels plus its dimensions. */
+interface GifFrame {
+    imageData: ImageData;
+    width: number;
+    height: number;
+    /**
+     * Optional per-frame delay in **centiseconds** (1 cs = 10 ms). When set it
+     * overrides the encoder-level delay for this frame only, which is how
+     * per-slide durations from {@link planGifFrames} flow into the encoder.
+     */
+    delayCs?: number;
+}
+/** Options for {@link encodeGif}. */
+interface EncodeGifOptions {
+    /**
+     * Frame delay in **centiseconds** (1 cs = 10 ms). Applies to every frame
+     * that does not carry its own {@link GifFrame.delayCs} override.
+     * Default: 200 cs (2 s).
+     */
+    delayCs?: number;
+    /** Number of times the animation loops (0 = loop forever, default). */
+    loopCount?: number;
+}
+/**
+ * Encode an ordered list of RGBA frames into an animated GIF89a byte sequence.
+ *
+ * Accepts either a bare `delayCs` number (React/Vue call style) or an
+ * {@link EncodeGifOptions} object (Angular call style) as the second argument.
+ *
+ * @param frames Ordered frame descriptors (all must share identical dimensions).
+ * @param delay  Per-frame delay in centiseconds, or an options object.
+ * @returns Raw GIF89a bytes.
+ */
+declare function encodeGif(frames: GifFrame[], delay?: number | EncodeGifOptions): Uint8Array;
+
 /**
  * Pure video (WebM) export planning helpers shared by every binding's video
  * export. Frame-segment timing, fps -> frame-interval maths, and MediaRecorder
@@ -6334,6 +6551,56 @@ declare class ViewerMobileSheetService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ViewerMobileSheetService>;
 }
 
+declare class ViewerOptionsService {
+    /**
+     * Optional: `inject()` needs an active injection context, which plain
+     * `new ViewerOptionsService()` (used by the colocated unit tests) does not
+     * provide. Outside DI the subscription simply lives as long as the instance.
+     */
+    private readonly destroyRef;
+    private readonly translate;
+    /** Imperative store: hydrates from and persists to `pptx-viewer-prefs`. */
+    readonly store: ViewerOptionsStore;
+    private readonly _options;
+    /** Reactive File > Options snapshot; a new object per change. */
+    readonly options: _angular_core.Signal<ViewerOptions>;
+    constructor();
+    setValue(group: ViewerOptionsGroupId, key: string, value: ViewerOptionPrimitive): void;
+    setRibbonTabHidden(tabId: ToolbarTabId, hidden: boolean): void;
+    setQuickAccessCommands(commandIds: readonly string[]): void;
+    reset(group?: ViewerOptionsGroupId): void;
+    /** Restore a snapshot wholesale (the dialog's Cancel semantics). */
+    restore(snapshot: ViewerOptions): void;
+    /** Undo-stack depth for `new EditorHistory({ maxDepth })`. */
+    historyDepth(): number;
+    /** AutoRecover cadence in seconds for the autosave engine. */
+    autosaveIntervalSeconds(): number;
+    /** Print-dialog seed; `undefined` keeps the dialog's own recents. */
+    printDefaults(): Partial<PrintSettings> | undefined;
+    /** Option-driven CSS classes for the viewer root (`pptx-ng-*` prefixed). */
+    rootClasses(): string[];
+    /** Tooltip text under the current ScreenTip style (undefined = suppress). */
+    screenTip(label: string, description?: string, shortcut?: string): string | undefined;
+    /** Run the enabled AutoCorrect rules over a committed run of text. */
+    autoCorrect(text: string): string;
+    /** Play the Accessibility "feedback with sound" cue for a completed action. */
+    playFeedback(): void;
+    /** Whether Trust Center forces the deck to open read-only. */
+    protectedView(): boolean;
+    /**
+     * Gate an external hyperlink activation. Returns `true` when navigation may
+     * proceed (no confirmation required, or the user confirmed the prompt).
+     */
+    confirmExternalHyperlink(href: string): boolean;
+    /**
+     * Options > Save > "Delete cached files": purge every autosave recovery
+     * snapshot from the shared IndexedDB store. Resolves with the purge count.
+     */
+    clearCache(): Promise<number>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ViewerOptionsService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ViewerOptionsService>;
+}
+
 /**
  * presentation-annotations-helpers.ts: Pure geometry helpers for presentation
  * ink annotations (pen, highlighter, eraser, laser).
@@ -6500,8 +6767,8 @@ declare class PowerPointViewerComponent {
     readonly content: _angular_core.InputSignal<ArrayBuffer | Uint8Array<ArrayBufferLike> | null>;
     /** Licensed fonts supplied by the host application. No fonts are bundled. */
     readonly fontsInput: _angular_core.InputSignal<ViewerFontSource[]>;
-    /** Whether editing actions are enabled. (Editor chrome not yet ported.) */
-    readonly canEdit: _angular_core.InputSignal<boolean>;
+    /** Whether editing actions are enabled (host input; see {@link canEdit}). */
+    readonly canEditInput: _angular_core.InputSignal<boolean>;
     /** Optional class applied to the root element. */
     readonly class: _angular_core.InputSignal<string>;
     /** Theme configuration for customising the viewer's appearance. Always wins over a File > Options > Appearance selection; see {@link defaultThemeKey}. */
@@ -6626,6 +6893,7 @@ declare class PowerPointViewerComponent {
     protected readonly presenterWindow: PresenterWindowService;
     private readonly destroyRef;
     protected readonly dialogs: ViewerDialogsService;
+    protected readonly viewerOpts: ViewerOptionsService;
     private readonly compareSvc;
     protected readonly xport: ViewerExportService;
     protected readonly findReplace: ViewerFindReplaceService;
@@ -6650,6 +6918,12 @@ declare class PowerPointViewerComponent {
     private readonly encryptedNotice;
     /** The `<main>` host; used to locate the live `.pptx-ng-canvas-stage`. */
     private readonly mainEl;
+    /**
+     * Effective edit permission: the host's `canEdit` input gated by Trust
+     * Center > "Open presentations in Protected View", which forces the deck
+     * read-only while enabled (File > Options wiring, mirrors PowerPoint).
+     */
+    protected readonly canEdit: _angular_core.Signal<boolean>;
     protected readonly activeSlideIndex: _angular_core.WritableSignal<number>;
     /** Slides to display: the editable deck when `canEdit`, else the loaded deck. */
     protected readonly displaySlides: _angular_core.Signal<readonly PptxSlide[]>;
@@ -6735,8 +7009,17 @@ declare class PowerPointViewerComponent {
     protected readonly spellCheck: _angular_core.WritableSignal<boolean>;
     /** User override that suppresses viewer animations and transitions. */
     protected readonly reducedMotion: _angular_core.WritableSignal<boolean>;
-    /** Snapshot consumed by the settings dialog. */
+    /**
+     * The six legacy preference toggles as a snapshot, kept in a guarded
+     * two-way sync with the File > Options store (see the constructor).
+     */
     protected readonly viewerSettings: _angular_core.Signal<ViewerPreferences>;
+    /**
+     * Root class list: the host `class` input, the reduced-motion override, and
+     * the option-driven display classes (`resolveOptionRootClasses`, so e.g.
+     * hardware-acceleration and compatibility-display choices are styleable).
+     */
+    protected readonly rootClasses: _angular_core.Signal<string[]>;
     /** Whether the Insert SmartArt gallery dialog is open. */
     protected readonly showSmartArtInsert: _angular_core.WritableSignal<boolean>;
     /** The single selected element on the active slide (for the inspector). */
@@ -6855,8 +7138,10 @@ declare class PowerPointViewerComponent {
     protected addGuide(axis: 'x' | 'y'): void;
     /** Swap the deck for a restored version-history snapshot. */
     protected onRestoreVersion(bytes: Uint8Array): void;
-    /** Apply Settings dialog changes to the live editor state. */
-    protected onSettingsChange(settings: ViewerSettings): void;
+    /** Apply one legacy preference snapshot onto the scattered live signals. */
+    private applyPreferenceSnapshot;
+    /** Dispatch a Quick Access Toolbar command id to its existing handler. */
+    protected onQuickAccessCommand(id: string): void;
     /**
      * Mobile "Format" slot: surface the inspector for the current selection.
      * On mobile the format pane starts closed (React parity: the canvas owns
@@ -6891,7 +7176,7 @@ declare class PowerPointViewerComponent {
     /** Resolve the live slide-stage element within `<main>`. */
     private stageElement;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PowerPointViewerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PowerPointViewerComponent, "pptx-viewer", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "fontsInput": { "alias": "fonts"; "required": false; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; "defaultThemeKey": { "alias": "defaultThemeKey"; "required": false; "isSignal": true; }; "availableThemes": { "alias": "availableThemes"; "required": false; "isSignal": true; }; "onThemeChange": { "alias": "onThemeChange"; "required": false; "isSignal": true; }; "defaultLocale": { "alias": "defaultLocale"; "required": false; "isSignal": true; }; "availableLocales": { "alias": "availableLocales"; "required": false; "isSignal": true; }; "onLocaleChange": { "alias": "onLocaleChange"; "required": false; "isSignal": true; }; "accountAuth": { "alias": "accountAuth"; "required": false; "isSignal": true; }; "filePath": { "alias": "filePath"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "collaboration": { "alias": "collaboration"; "required": false; "isSignal": true; }; "authorName": { "alias": "authorName"; "required": false; "isSignal": true; }; "shareDefaults": { "alias": "shareDefaults"; "required": false; "isSignal": true; }; "onOpenFile": { "alias": "onOpenFile"; "required": false; "isSignal": true; }; "smartArt3D": { "alias": "smartArt3D"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; }, { "activeSlideChange": "activeSlideChange"; "dirtyChange": "dirtyChange"; "contentChange": "contentChange"; "propertiesChange": "propertiesChange"; "modeChange": "modeChange"; "zoomChange": "zoomChange"; "selectionChange": "selectionChange"; "slideCountChange": "slideCountChange"; "startCollaboration": "startCollaboration"; "stopCollaboration": "stopCollaboration"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PowerPointViewerComponent, "pptx-viewer", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "fontsInput": { "alias": "fonts"; "required": false; "isSignal": true; }; "canEditInput": { "alias": "canEdit"; "required": false; "isSignal": true; }; "class": { "alias": "class"; "required": false; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; "defaultThemeKey": { "alias": "defaultThemeKey"; "required": false; "isSignal": true; }; "availableThemes": { "alias": "availableThemes"; "required": false; "isSignal": true; }; "onThemeChange": { "alias": "onThemeChange"; "required": false; "isSignal": true; }; "defaultLocale": { "alias": "defaultLocale"; "required": false; "isSignal": true; }; "availableLocales": { "alias": "availableLocales"; "required": false; "isSignal": true; }; "onLocaleChange": { "alias": "onLocaleChange"; "required": false; "isSignal": true; }; "accountAuth": { "alias": "accountAuth"; "required": false; "isSignal": true; }; "filePath": { "alias": "filePath"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "collaboration": { "alias": "collaboration"; "required": false; "isSignal": true; }; "authorName": { "alias": "authorName"; "required": false; "isSignal": true; }; "shareDefaults": { "alias": "shareDefaults"; "required": false; "isSignal": true; }; "onOpenFile": { "alias": "onOpenFile"; "required": false; "isSignal": true; }; "smartArt3D": { "alias": "smartArt3D"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; }, { "activeSlideChange": "activeSlideChange"; "dirtyChange": "dirtyChange"; "contentChange": "contentChange"; "propertiesChange": "propertiesChange"; "modeChange": "modeChange"; "zoomChange": "zoomChange"; "selectionChange": "selectionChange"; "slideCountChange": "slideCountChange"; "startCollaboration": "startCollaboration"; "stopCollaboration": "stopCollaboration"; }, never, never, true, never>;
 }
 
 /** A selected chart sub-part, scoped to the chart element that owns it. */
@@ -7246,7 +7531,7 @@ declare class ZoomTargetService {
  * `PowerPointViewerComponent`'s children (ribbon, slide canvas, inspector,
  * dialogs, ...) rely on via `inject()`.
  */
-declare const POWER_POINT_VIEWER_PROVIDERS: readonly [typeof LoadContentService, typeof ExportService, typeof EditorStateService, typeof ChartPartSelectionService, typeof TableSelectionService, typeof EmbeddedFontsService, typeof CollaborationService, typeof AccessibilityService, typeof AutosaveService, typeof PrintService, typeof IsMobileService, typeof SmartArt3DService, typeof FieldContextService, typeof ZoomTargetService, typeof ViewerDialogsService, typeof ViewerCompareService, typeof ViewerExportService, typeof ViewerFindReplaceService, typeof ViewerCustomShowsService, typeof ViewerCollaborationSessionService, typeof ViewerCanvasEditingService, typeof ViewerCollabCursorService, typeof ViewerDocumentPropertiesService, typeof ViewerFileIOService, typeof ViewerFormatPainterService, typeof ViewerInspectorPanelService, typeof ViewerKeyboardService, typeof ViewerMobileSheetService, typeof ViewerPresentationModeService, typeof ViewerThemeGalleryService, typeof ViewerTouchGesturesService, typeof ViewerZoomService];
+declare const POWER_POINT_VIEWER_PROVIDERS: readonly [typeof LoadContentService, typeof ExportService, typeof EditorStateService, typeof ChartPartSelectionService, typeof TableSelectionService, typeof EmbeddedFontsService, typeof CollaborationService, typeof AccessibilityService, typeof AutosaveService, typeof PrintService, typeof IsMobileService, typeof SmartArt3DService, typeof FieldContextService, typeof ZoomTargetService, typeof ViewerDialogsService, typeof ViewerCompareService, typeof ViewerExportService, typeof ViewerFindReplaceService, typeof ViewerCustomShowsService, typeof ViewerCollaborationSessionService, typeof ViewerCanvasEditingService, typeof ViewerCollabCursorService, typeof ViewerDocumentPropertiesService, typeof ViewerFileIOService, typeof ViewerFormatPainterService, typeof ViewerInspectorPanelService, typeof ViewerKeyboardService, typeof ViewerMobileSheetService, typeof ViewerOptionsService, typeof ViewerPresentationModeService, typeof ViewerThemeGalleryService, typeof ViewerTouchGesturesService, typeof ViewerZoomService];
 
 /** Drawing tool IDs (mirrors React DRAW_TOOLS). */
 type DrawTool$1 = 'select' | 'pen' | 'highlighter' | 'eraser' | 'freeform';
@@ -11646,19 +11931,16 @@ declare class ViewerExtraDialogsComponent {
     readonly filePath: _angular_core.InputSignal<string | undefined>;
     /** Custom shows offered in the set-up-slide-show "show slides" fieldset. */
     readonly customShows: _angular_core.InputSignal<PptxCustomShow[]>;
-    /** Live viewer preferences surfaced by the settings dialog. */
-    readonly settings: _angular_core.InputSignal<ViewerPreferences>;
     readonly themeKey: _angular_core.InputSignal<string>;
     readonly availableThemes: _angular_core.InputSignal<readonly ThemeCatalogEntry[]>;
     readonly localeCode: _angular_core.InputSignal<string>;
     readonly availableLocales: _angular_core.InputSignal<readonly LocaleCatalogEntry[]>;
     /** Fired with a restored `.pptx` version's bytes; the host swaps the deck. */
     readonly restoreContent: _angular_core.OutputEmitterRef<Uint8Array<ArrayBufferLike>>;
-    /** Fired whenever a settings toggle changes. */
-    readonly settingsChange: _angular_core.OutputEmitterRef<ViewerPreferences>;
     readonly themeKeySelect: _angular_core.OutputEmitterRef<string>;
     readonly localeSelect: _angular_core.OutputEmitterRef<string>;
     protected readonly svc: ViewerDialogsService;
+    protected readonly viewerOpts: ViewerOptionsService;
     protected readonly compare: ViewerCompareService;
     protected readonly editor: EditorStateService;
     protected readonly loader: LoadContentService;
@@ -11681,6 +11963,8 @@ declare class ViewerExtraDialogsComponent {
     promptKeepAnnotations(map: SlideAnnotationMap): void;
     /** Persist the pending presentation ink as `ink` elements on their slides. */
     onKeepAnnotations(): void;
+    /** Options > Save > "Delete cached files": purge autosave recovery snapshots. */
+    protected onClearOptionsCache(): void;
     /** Drop the pending presentation ink. */
     onDiscardAnnotations(): void;
     /** Insert a new equation element, or update the one currently being edited. */
@@ -11692,7 +11976,7 @@ declare class ViewerExtraDialogsComponent {
     /** Clear any save password. */
     onRemovePassword(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ViewerExtraDialogsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ViewerExtraDialogsComponent, "pptx-viewer-extra-dialogs", never, { "activeSlideIndex": { "alias": "activeSlideIndex"; "required": false; "isSignal": true; }; "selectedElementId": { "alias": "selectedElementId"; "required": false; "isSignal": true; }; "filePath": { "alias": "filePath"; "required": false; "isSignal": true; }; "customShows": { "alias": "customShows"; "required": false; "isSignal": true; }; "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "themeKey": { "alias": "themeKey"; "required": false; "isSignal": true; }; "availableThemes": { "alias": "availableThemes"; "required": false; "isSignal": true; }; "localeCode": { "alias": "localeCode"; "required": false; "isSignal": true; }; "availableLocales": { "alias": "availableLocales"; "required": false; "isSignal": true; }; }, { "restoreContent": "restoreContent"; "settingsChange": "settingsChange"; "themeKeySelect": "themeKeySelect"; "localeSelect": "localeSelect"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ViewerExtraDialogsComponent, "pptx-viewer-extra-dialogs", never, { "activeSlideIndex": { "alias": "activeSlideIndex"; "required": false; "isSignal": true; }; "selectedElementId": { "alias": "selectedElementId"; "required": false; "isSignal": true; }; "filePath": { "alias": "filePath"; "required": false; "isSignal": true; }; "customShows": { "alias": "customShows"; "required": false; "isSignal": true; }; "themeKey": { "alias": "themeKey"; "required": false; "isSignal": true; }; "availableThemes": { "alias": "availableThemes"; "required": false; "isSignal": true; }; "localeCode": { "alias": "localeCode"; "required": false; "isSignal": true; }; "availableLocales": { "alias": "availableLocales"; "required": false; "isSignal": true; }; }, { "restoreContent": "restoreContent"; "themeKeySelect": "themeKeySelect"; "localeSelect": "localeSelect"; }, never, never, true, never>;
 }
 
 declare class EquationEditorDialogComponent {
@@ -12072,29 +12356,55 @@ declare class ShortcutPanelComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ShortcutPanelComponent, "pptx-shortcut-panel", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "close": "close"; }, never, never, true, never>;
 }
 
+/** One dialog-level option edit (group + key + new primitive value). */
+interface OptionValueChange {
+    group: ViewerOptionsGroupId;
+    key: string;
+    value: ViewerOptionPrimitive;
+}
+
+/** One Customize Ribbon checkbox edit. */
+interface RibbonTabHiddenChange {
+    tabId: ToolbarTabId;
+    hidden: boolean;
+}
+
 declare class SettingsDialogComponent {
     readonly open: _angular_core.InputSignal<boolean>;
-    readonly settings: _angular_core.InputSignal<ViewerPreferences>;
-    /** Selected `THEME_CATALOG` (or `availableThemes`) key, for the Appearance tab. */
+    /** Full File > Options snapshot rendered by every pane. */
+    readonly options: _angular_core.InputSignal<ViewerOptions>;
+    /** Selected theme catalog key, for General > Appearance. */
     readonly themeKey: _angular_core.InputSignal<string>;
-    /** Theme choices offered by the Appearance tab. Defaults to the built-in `THEME_CATALOG`. */
     readonly availableThemes: _angular_core.InputSignal<readonly ThemeCatalogEntry[]>;
-    /** Active locale code, for the Language tab. */
+    /** Active locale code, for the Language category. */
     readonly localeCode: _angular_core.InputSignal<string>;
-    /** Locale choices offered by the Language tab. Defaults to the built-in `LOCALE_CATALOG`. */
     readonly availableLocales: _angular_core.InputSignal<readonly LocaleCatalogEntry[]>;
-    readonly settingsChange: _angular_core.OutputEmitterRef<ViewerPreferences>;
-    /** Fired when the user picks an Appearance tab swatch. */
+    /** Availability flags for the Add-ins pane (unset ids default to active). */
+    readonly addinStatus: _angular_core.InputSignal<ViewerAddinStatus | undefined>;
+    readonly optionChange: _angular_core.OutputEmitterRef<OptionValueChange>;
+    /** Restore a snapshot wholesale (Cancel semantics). */
+    readonly restoreOptions: _angular_core.OutputEmitterRef<ViewerOptions>;
+    readonly ribbonTabHiddenChange: _angular_core.OutputEmitterRef<RibbonTabHiddenChange>;
+    readonly quickAccessCommandsChange: _angular_core.OutputEmitterRef<string[]>;
+    /** Reset one tab-group (or everything when `undefined`). */
+    readonly resetOptions: _angular_core.OutputEmitterRef<keyof ViewerOptions | undefined>;
+    readonly clearCache: _angular_core.OutputEmitterRef<void>;
     readonly themeKeySelect: _angular_core.OutputEmitterRef<string>;
-    /** Fired when the user picks a Language tab entry. */
     readonly localeSelect: _angular_core.OutputEmitterRef<string>;
     readonly close: _angular_core.OutputEmitterRef<void>;
-    protected readonly activeTab: _angular_core.WritableSignal<"language" | "general" | "appearance" | "shortcuts">;
-    protected readonly specs: readonly ViewerPreferenceToggle[];
-    protected readonly shortcuts: readonly pptx_angular_viewer.ShortcutReferenceItem[];
-    protected toggle(key: keyof ViewerSettings): void;
+    protected readonly tabs: readonly ViewerOptionsTabDefinition[];
+    protected readonly activeTabId: _angular_core.WritableSignal<ViewerOptionsTabId>;
+    protected readonly activeTab: _angular_core.Signal<ViewerOptionsTabDefinition>;
+    /** Snapshot taken when the dialog opens, restored by Cancel. */
+    private snapshot;
+    private wasOpen;
+    constructor();
+    /** Cancel: restore the on-open snapshot, then close. */
+    protected cancel(): void;
+    /** Escape confirms (keeps edits), mirroring React's dialog. */
+    protected onEscape(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SettingsDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SettingsDialogComponent, "pptx-settings-dialog", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "themeKey": { "alias": "themeKey"; "required": false; "isSignal": true; }; "availableThemes": { "alias": "availableThemes"; "required": false; "isSignal": true; }; "localeCode": { "alias": "localeCode"; "required": false; "isSignal": true; }; "availableLocales": { "alias": "availableLocales"; "required": false; "isSignal": true; }; }, { "settingsChange": "settingsChange"; "themeKeySelect": "themeKeySelect"; "localeSelect": "localeSelect"; "close": "close"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SettingsDialogComponent, "pptx-settings-dialog", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; "themeKey": { "alias": "themeKey"; "required": false; "isSignal": true; }; "availableThemes": { "alias": "availableThemes"; "required": false; "isSignal": true; }; "localeCode": { "alias": "localeCode"; "required": false; "isSignal": true; }; "availableLocales": { "alias": "availableLocales"; "required": false; "isSignal": true; }; "addinStatus": { "alias": "addinStatus"; "required": false; "isSignal": true; }; }, { "optionChange": "optionChange"; "restoreOptions": "restoreOptions"; "ribbonTabHiddenChange": "ribbonTabHiddenChange"; "quickAccessCommandsChange": "quickAccessCommandsChange"; "resetOptions": "resetOptions"; "clearCache": "clearCache"; "themeKeySelect": "themeKeySelect"; "localeSelect": "localeSelect"; "close": "close"; }, never, never, true, never>;
 }
 
 declare class SettingsAppearanceTabComponent {
@@ -12119,7 +12429,7 @@ declare class AccountPageComponent {
     readonly accountAuth: _angular_core.InputSignal<AccountAuthConfig | undefined>;
     private readonly translate;
     protected readonly swatches: readonly string[];
-    protected readonly version = "1.30.0";
+    protected readonly version = "1.31.0";
     protected readonly profile: _angular_core.WritableSignal<ViewerProfile>;
     protected readonly initial: _angular_core.Signal<string>;
     protected readonly usage: _angular_core.WritableSignal<LocalStorageUsageSummary | null>;
@@ -14682,10 +14992,14 @@ declare class TitleBarComponent {
     readonly findReplaceOpen: _angular_core.InputSignal<boolean>;
     /** Toolbar buttons the host wants hidden (gates Undo/Redo independently). */
     readonly hiddenActions: _angular_core.InputSignal<ToolbarActionId[]>;
+    /** Live Quick Access Toolbar options (File > Options > Quick Access). */
+    readonly quickAccess: _angular_core.InputSignal<ViewerQuickAccessOptions | null>;
     readonly toggleAutosave: _angular_core.OutputEmitterRef<void>;
     readonly save: _angular_core.OutputEmitterRef<void>;
     readonly undo: _angular_core.OutputEmitterRef<void>;
     readonly redo: _angular_core.OutputEmitterRef<void>;
+    /** A configured Quick Access command was pressed (catalog id). */
+    readonly quickCommand: _angular_core.OutputEmitterRef<string>;
     readonly toggleFindReplace: _angular_core.OutputEmitterRef<void>;
     readonly commandSearch: _angular_core.OutputEmitterRef<string>;
     private readonly translate;
@@ -14718,6 +15032,20 @@ declare class TitleBarComponent {
     protected readonly toolbar: ToolbarVisibility;
     protected readonly searchQuery: _angular_core.WritableSignal<string>;
     protected readonly searchFocused: _angular_core.WritableSignal<boolean>;
+    /** Resolved Quick Access options (host-supplied, or the default trio+). */
+    protected readonly qat: _angular_core.Signal<ViewerQuickAccessOptions>;
+    /**
+     * Configured Quick Access commands beyond the dedicated save/undo/redo
+     * buttons (which keep their own gating + labels). Rendered as text-label
+     * buttons routed through {@link onQuickCommand}.
+     */
+    protected readonly extraQuickCommands: _angular_core.Signal<QuickAccessCommandDefinition[]>;
+    /**
+     * Route a Quick Access press: keep the dedicated save/undo/redo outputs
+     * (existing host wiring, `hiddenActions` gating) and forward everything
+     * else through the generic {@link quickCommand} output.
+     */
+    protected onQuickCommand(id: string): void;
     protected readonly commandResults: _angular_core.Signal<CommandSearchEntry[]>;
     /** The i18n key for the save-location status text (next to the file name). */
     protected readonly statusKey: _angular_core.Signal<string>;
@@ -14728,7 +15056,7 @@ declare class TitleBarComponent {
     protected onSearchBlur(): void;
     protected onSearchKeyDown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TitleBarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TitleBarComponent, "pptx-title-bar", never, { "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "isDirty": { "alias": "isDirty"; "required": false; "isSignal": true; }; "autosaveStatus": { "alias": "autosaveStatus"; "required": false; "isSignal": true; }; "autosaveEnabled": { "alias": "autosaveEnabled"; "required": false; "isSignal": true; }; "canUndo": { "alias": "canUndo"; "required": false; "isSignal": true; }; "canRedo": { "alias": "canRedo"; "required": false; "isSignal": true; }; "undoLabel": { "alias": "undoLabel"; "required": false; "isSignal": true; }; "redoLabel": { "alias": "redoLabel"; "required": false; "isSignal": true; }; "findReplaceOpen": { "alias": "findReplaceOpen"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; }, { "toggleAutosave": "toggleAutosave"; "save": "save"; "undo": "undo"; "redo": "redo"; "toggleFindReplace": "toggleFindReplace"; "commandSearch": "commandSearch"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TitleBarComponent, "pptx-title-bar", never, { "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "isDirty": { "alias": "isDirty"; "required": false; "isSignal": true; }; "autosaveStatus": { "alias": "autosaveStatus"; "required": false; "isSignal": true; }; "autosaveEnabled": { "alias": "autosaveEnabled"; "required": false; "isSignal": true; }; "canUndo": { "alias": "canUndo"; "required": false; "isSignal": true; }; "canRedo": { "alias": "canRedo"; "required": false; "isSignal": true; }; "undoLabel": { "alias": "undoLabel"; "required": false; "isSignal": true; }; "redoLabel": { "alias": "redoLabel"; "required": false; "isSignal": true; }; "findReplaceOpen": { "alias": "findReplaceOpen"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; "quickAccess": { "alias": "quickAccess"; "required": false; "isSignal": true; }; }, { "toggleAutosave": "toggleAutosave"; "save": "save"; "undo": "undo"; "redo": "redo"; "quickCommand": "quickCommand"; "toggleFindReplace": "toggleFindReplace"; "commandSearch": "commandSearch"; }, never, never, true, never>;
 }
 
 /**