ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/render/options/quick-access.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+export interface QuickAccessCommandDefinition {
+    id: string;
+    labelKey: string;
+    /** Logical icon name bindings map to their icon set. */
+    icon: string;
+}
+export declare const QUICK_ACCESS_COMMAND_CATALOG: readonly QuickAccessCommandDefinition[];
+export declare const DEFAULT_QUICK_ACCESS_COMMAND_IDS: readonly string[];
+export declare function getQuickAccessCommand(id: string): QuickAccessCommandDefinition | undefined;
+/**
+ * The configured Quick Access commands a title bar must render BEYOND its
+ * dedicated Save/Undo/Redo buttons, in configured order, unknown ids dropped.
+ *
+ * Every binding needs exactly this list and four of the five used to skip it
+ * entirely, so their strips showed three buttons while the options model (and
+ * Angular) said four. Deriving it here is what makes "the strip follows File >
+ * Options" one decision instead of five.
+ */
+export declare function extraQuickAccessCommands(commandIds: readonly string[]): QuickAccessCommandDefinition[];
+/** Commands not yet on the toolbar, in catalog order. */
+export declare function availableQuickAccessCommands(commandIds: readonly string[]): QuickAccessCommandDefinition[];
+export declare function addQuickAccessCommand(commandIds: readonly string[], id: string): string[];
+export declare function removeQuickAccessCommand(commandIds: readonly string[], id: string): string[];
+export declare function moveQuickAccessCommand(commandIds: readonly string[], id: string, direction: 'up' | 'down'): string[];
+//# sourceMappingURL=quick-access.d.ts.map

package/dist/pptx/render/options/quick-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-access.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/quick-access.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,4BAA4B;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,4BAA4B,EAAE,SAAS,4BAA4B,EAe/E,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,SAAS,MAAM,EAK7D,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS,CAE1F;AAUD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACvC,UAAU,EAAE,SAAS,MAAM,EAAE,GAC3B,4BAA4B,EAAE,CAchC;AAED,yDAAyD;AACzD,wBAAgB,4BAA4B,CAC3C,UAAU,EAAE,SAAS,MAAM,EAAE,GAC3B,4BAA4B,EAAE,CAEhC;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAKzF;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5F;AAED,wBAAgB,sBAAsB,CACrC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,IAAI,GAAG,MAAM,GACtB,MAAM,EAAE,CAcV"}

package/dist/pptx/render/options/viewer-addins.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Options > Add-ins pane model: the viewer's optional capability modules,
+ * presented the way PowerPoint lists COM add-ins (name / location / type,
+ * grouped by active state). Bindings supply the runtime availability flags.
+ */
+export type ViewerAddinType = 'renderer' | 'converter' | 'collaboration' | 'localization';
+export interface ViewerAddinDefinition {
+    id: string;
+    nameKey: string;
+    descriptionKey: string;
+    type: ViewerAddinType;
+    /** Package or module the capability ships in. */
+    location: string;
+}
+export interface ViewerAddinStatus {
+    /** Addin id -> whether the capability is active in this host. */
+    [addinId: string]: boolean | undefined;
+}
+export interface ViewerAddinRow extends ViewerAddinDefinition {
+    active: boolean;
+}
+export declare const VIEWER_ADDIN_CATALOG: readonly ViewerAddinDefinition[];
+/** Rows for the Add-ins table, split into active/inactive by the host's status flags. */
+export declare function resolveViewerAddinRows(status?: ViewerAddinStatus): ViewerAddinRow[];
+/**
+ * Build an Add-ins status map from the runtime signals every binding can
+ * cheaply read: Options > Advanced > "Disable 3D rendering" (gates the two
+ * three.js-backed renderers) and whether a collaboration session is live.
+ * The remaining catalog entries (EMF/MTX converters, locales) have no
+ * runtime on/off switch, so they are left out and fall back to `active: true`
+ * in {@link resolveViewerAddinRows}.
+ */
+export declare function resolveViewerAddinStatus(disable3DRendering: boolean, collaborationActive: boolean): ViewerAddinStatus;
+//# sourceMappingURL=viewer-addins.d.ts.map

package/dist/pptx/render/options/viewer-addins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-addins.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-addins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,CAAC;AAE1F,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,eAAe,CAAC;IACtB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,iEAAiE;IACjE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,cAAe,SAAQ,qBAAqB;IAC5D,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,oBAAoB,EAAE,SAAS,qBAAqB,EA2ChE,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAKnF;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACvC,kBAAkB,EAAE,OAAO,EAC3B,mBAAmB,EAAE,OAAO,GAC1B,iBAAiB,CAMnB"}

package/dist/pptx/render/options/viewer-options-apply.d.ts

@@ -0,0 +1,86 @@
+import type { PrintSettings } from '../../export/print-document.js';
+import type { ToolbarTabDefinition } from '../toolbar-actions.js';
+import type { ImageResolutionPreset, ViewerOptions } from './viewer-options.js';
+/**
+ * Pure helpers that translate File > Options values into the behaviors the
+ * bindings actually wire: history depth, autosave cadence, tooltips, ribbon
+ * visibility, print defaults, image export quality, and protected view.
+ */
+/** Maximum undo steps for `EditorHistory({ maxDepth })`. */
+export declare function resolveHistoryDepth(options: ViewerOptions): number;
+/** AutoRecover cadence in seconds, honoring the shared minimum. */
+export declare function resolveAutosaveIntervalSeconds(options: ViewerOptions): number;
+/**
+ * Tooltip text for a chrome control under the current ScreenTip style:
+ * `off` suppresses tooltips entirely, `plain` drops the description, and
+ * shortcut hints append only while Accessibility > shortcut keys is on.
+ */
+export declare function resolveScreenTip(options: ViewerOptions, label: string, description?: string, shortcut?: string): string | undefined;
+/** Ribbon tabs after Customize Ribbon hiding; the File tab always survives. */
+export declare function resolveVisibleRibbonTabs(options: ViewerOptions, tabs?: readonly ToolbarTabDefinition[]): ToolbarTabDefinition[];
+/**
+ * Seed for print dialogs when "use the following print settings" is chosen;
+ * `undefined` keeps each dialog's own most-recent settings (PowerPoint's
+ * "Use the most recently used print settings").
+ */
+export declare function resolveDefaultPrintSettings(options: ViewerOptions): Partial<PrintSettings> | undefined;
+/** Target raster density in ppi for image export; `undefined` = lossless/high fidelity. */
+export declare function resolveImageResolutionPpi(preset: ImageResolutionPreset): number | undefined;
+/** Raster scale multiplier relative to the standard 96 ppi CSS pixel grid. */
+export declare function resolveImageResolutionScale(options: ViewerOptions): number;
+/** Whether the viewer should open documents read-only until editing is enabled. */
+export declare function shouldOpenInProtectedView(options: ViewerOptions): boolean;
+/** Whether following an external hyperlink should ask for confirmation first. */
+export declare function shouldConfirmExternalHyperlink(options: ViewerOptions, href: string): boolean;
+/** The six opt-in interactive-3D scene flags every binding exposes as host props. */
+export interface Rendering3DFlags {
+    smartArt3D: boolean;
+    surfaceChart3D: boolean;
+    barChart3D: boolean;
+    lineChart3D: boolean;
+    areaChart3D: boolean;
+    pieChart3D: boolean;
+}
+/**
+ * AND every host-supplied 3D opt-in flag with the viewer user's own
+ * Options > Advanced > "Disable 3D rendering" override.
+ *
+ * The host prop says "this deck may render its 3D scenes"; a viewer user on
+ * underpowered hardware needs a way to fall back to the flat 2D rendering
+ * regardless of what the host wired up. Each binding should pass its raw
+ * host props through this before feeding them to the SmartArt3D/*Chart3D
+ * context/provider/service that actually gates the WebGL scenes, so the
+ * override reaches every one of them uniformly instead of being wired (or
+ * missed) six separate times.
+ */
+export declare function resolve3DRenderingFlags(hostFlags: Rendering3DFlags, options: ViewerOptions): Rendering3DFlags;
+/** CSS class list for the viewer root reflecting display-affecting options. */
+export declare function resolveOptionRootClasses(options: ViewerOptions, prefix: string): string[];
+/**
+ * Whether a successful, explicit save should discard the AutoRecover
+ * snapshot for the deck just saved.
+ *
+ * PowerPoint's default behavior: once the user has saved, the snapshot that
+ * existed to recover unsaved work is stale (the file on disk already has it),
+ * so it is dropped. Options > Save > "Keep the last autosaved version if I
+ * close without saving" flips that off: the snapshot survives a successful
+ * save too, in case the user wants to roll back to it later.
+ */
+export declare function shouldDiscardAutosaveOnSuccessfulSave(options: ViewerOptions): boolean;
+/** Whether Options > Save > "clear cache on close" should wipe recovery snapshots for this deck. */
+export declare function shouldClearAutosaveCacheOnClose(options: ViewerOptions): boolean;
+/** The subset of an autosave record's metadata age-based pruning needs. */
+export interface AutosaveSnapshotAge {
+    readonly key: string;
+    readonly timestamp: number;
+}
+/**
+ * Snapshot keys older than Options > Save > "cache retention" (days), for
+ * periodic pruning. A non-positive or non-finite retention value prunes
+ * nothing rather than everything, since it means the option could not be
+ * read rather than "retain 0 days".
+ */
+export declare function resolveExpiredAutosaveSnapshots(snapshots: readonly AutosaveSnapshotAge[], options: ViewerOptions, now?: number): string[];
+/** Play the Accessibility > "feedback with sound" cue for a completed action. */
+export declare function playFeedbackSound(options: ViewerOptions): void;
+//# sourceMappingURL=viewer-options-apply.d.ts.map

package/dist/pptx/render/options/viewer-options-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-apply.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options-apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE7E;;;;GAIG;AAEH,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAGlE;AAED,mEAAmE;AACnE,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAG7E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAapB;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,SAAS,oBAAoB,EAAiB,GAClD,oBAAoB,EAAE,CAIxB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAUpC;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAa3F;AAED,8EAA8E;AAC9E,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAM1E;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAEzE;AAED,iFAAiF;AACjF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAK5F;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,aAAa,GACpB,gBAAgB,CAYlB;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAYzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAErF;AAED,oGAAoG;AACpG,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE/E;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC9C,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE,MAAmB,GACtB,MAAM,EAAE,CAOV;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CA0B9D"}

package/dist/pptx/render/options/viewer-options-constraints.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Host constraints on the File > Options store: settings LOCKED to a fixed
+ * value and host DEFAULTS that replace the built-in ones.
+ *
+ * Pure helpers; `createViewerOptionsStore` applies them on every write, so a
+ * locked value cannot be changed from any path (the dialog, a ribbon toggle
+ * writing through `setOptions`, a reset), and host defaults are never
+ * persisted as if the user had chosen them.
+ *
+ * @module render/options/viewer-options-constraints
+ */
+import type { OptionsSettingValues } from '../customization/customization-types.js';
+import type { ViewerOptions, ViewerOptionsGroupId } from './viewer-options.js';
+/** Locks and host defaults, both keyed `<group>.<key>`. */
+export interface ViewerOptionsConstraints {
+    locked?: OptionsSettingValues;
+    defaults?: OptionsSettingValues;
+}
+/** Split `<group>.<key>`, rejecting ids that do not name a primitive option. */
+export declare function parseOptionsSettingId(id: string): {
+    group: ViewerOptionsGroupId;
+    key: string;
+} | null;
+/** `options` with every locked value forced in (a new object; input untouched). */
+export declare function applyLockedOptions(options: ViewerOptions, locked: OptionsSettingValues | undefined): ViewerOptions;
+/** The built-in defaults with the host's defaults layered on top. */
+export declare function buildOptionsBaseline(defaults: OptionsSettingValues | undefined): ViewerOptions;
+/** True when `<group>.<key>` is locked. */
+export declare function isOptionLocked(locked: OptionsSettingValues | undefined, group: ViewerOptionsGroupId, key: string): boolean;
+/**
+ * The sparse diff of `options` against `baseline`, minus locked settings, for
+ * persistence: neither a host default nor a host lock is ever saved as the
+ * user's own choice.
+ */
+export declare function diffOptionsAgainstBaseline(options: ViewerOptions, baseline: ViewerOptions, locked: OptionsSettingValues | undefined): Partial<Record<ViewerOptionsGroupId, Record<string, unknown>>>;
+/**
+ * Move every setting that still sits at the OLD baseline (and that the user
+ * never saved) onto the NEW baseline, so changing a host default updates
+ * users who have not touched that setting and leaves the rest alone.
+ */
+export declare function rebaseOptions(options: ViewerOptions, previousBaseline: ViewerOptions, nextBaseline: ViewerOptions, userSaved: ReadonlySet<string>): ViewerOptions;
+//# sourceMappingURL=viewer-options-constraints.d.ts.map

package/dist/pptx/render/options/viewer-options-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-constraints.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options-constraints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAyB,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGnG,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACxC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,MAAM,GACR;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYrD;AAwBD,mFAAmF;AACnF,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACtC,aAAa,CAOf;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GAAG,aAAa,CAI9F;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAC7B,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,KAAK,EAAE,oBAAoB,EAC3B,GAAG,EAAE,MAAM,GACT,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACtC,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAkBhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,aAAa,EAC/B,YAAY,EAAE,aAAa,EAC3B,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,aAAa,CAgBf"}

package/dist/pptx/render/options/viewer-options-controls.d.ts

@@ -0,0 +1,77 @@
+import type { ViewerOptionsGroupId } from './viewer-options.js';
+/**
+ * Control/section/tab descriptor types for the File > Options schema, plus
+ * the terse constructors the tab-definition modules build panes with.
+ */
+export type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
+export 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;
+    /**
+     * The host locked this setting (see `customizeOptionsTabs`): render the
+     * control disabled. Never set by the static schema itself.
+     */
+    readOnly?: boolean;
+}
+export interface ViewerOptionsToggleControl extends ControlBase {
+    kind: 'toggle';
+}
+export interface ViewerOptionsSelectControl extends ControlBase {
+    kind: 'select';
+    choices: readonly ViewerOptionsSelectChoice[];
+}
+export interface ViewerOptionsNumberControl extends ControlBase {
+    kind: 'number';
+    min: number;
+    max: number;
+    step?: number;
+    unitKey?: string;
+}
+export interface ViewerOptionsTextControl extends ControlBase {
+    kind: 'text';
+    maxLength?: number;
+}
+export type ViewerOptionsControl = ViewerOptionsToggleControl | ViewerOptionsSelectControl | ViewerOptionsNumberControl | ViewerOptionsTextControl;
+export 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' | 'customFonts';
+    controls: readonly ViewerOptionsControl[];
+}
+export 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[];
+}
+export declare function toggle(group: ViewerOptionsGroupId, key: string, labelKey: string, extra?: Partial<Pick<ViewerOptionsToggleControl, 'infoKey' | 'indent'>>): ViewerOptionsToggleControl;
+export declare function select(group: ViewerOptionsGroupId, key: string, labelKey: string, choiceList: readonly ViewerOptionsSelectChoice[]): ViewerOptionsSelectControl;
+export declare function numberControl(group: ViewerOptionsGroupId, key: string, labelKey: string, min: number, max: number, unitKey?: string): ViewerOptionsNumberControl;
+/**
+ * Clamp a File > Options number-control edit into its schema range.
+ *
+ * Returns `undefined` when `raw` does not parse to a finite number, so the
+ * caller can skip the commit and leave the field's prior value in place
+ * (matches the behaviour every binding except one already had).
+ */
+export declare function clampOptionNumber(raw: string, min: number, max: number): number | undefined;
+export declare function textControl(group: ViewerOptionsGroupId, key: string, labelKey: string): ViewerOptionsTextControl;
+export declare function choices(prefix: string, values: readonly string[]): ViewerOptionsSelectChoice[];
+export declare const SCREEN_TIP_CHOICES: ViewerOptionsSelectChoice[];
+export {};
+//# sourceMappingURL=viewer-options-controls.d.ts.map

package/dist/pptx/render/options/viewer-options-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-controls.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options-controls.ts"],"names":[],"mappings":"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"}

package/dist/pptx/render/options/viewer-options-schema.d.ts

@@ -0,0 +1,8 @@
+import type { ViewerOptionsTabDefinition, ViewerOptionsTabId } from './viewer-options-controls.js';
+/**
+ * The ten File > Options categories, in PowerPoint's order. Bindings render
+ * the dialog's category list and panes from this array.
+ */
+export declare const VIEWER_OPTIONS_TABS: readonly ViewerOptionsTabDefinition[];
+export declare function getViewerOptionsTab(id: ViewerOptionsTabId): ViewerOptionsTabDefinition;
+//# sourceMappingURL=viewer-options-schema.d.ts.map

package/dist/pptx/render/options/viewer-options-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-schema.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAgBhG;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,0BAA0B,EAWpE,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,kBAAkB,GAAG,0BAA0B,CAMtF"}

package/dist/pptx/render/options/viewer-options-store.d.ts

@@ -0,0 +1,63 @@
+import type { ToolbarTabId } from '../toolbar-actions.js';
+import type { StoredViewerOptions, ViewerOptionPrimitive, ViewerOptions, ViewerOptionsGroupId } from './viewer-options.js';
+import type { ViewerOptionsConstraints } from './viewer-options-constraints.js';
+/**
+ * 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.
+ */
+export type ViewerOptionsListener = (options: ViewerOptions) => void;
+export 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;
+}
+export interface ViewerOptionsStoreInit {
+    /** Seed values layered over defaults before persisted values are applied. */
+    initial?: StoredViewerOptions;
+    /** Skip localStorage entirely (hosts that own persistence themselves). */
+    persist?: boolean;
+}
+export declare function createViewerOptionsStore(init?: ViewerOptionsStoreInit): ViewerOptionsStore;
+//# sourceMappingURL=viewer-options-store.d.ts.map

package/dist/pptx/render/options/viewer-options-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-store.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,KAAK,EACX,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAS7E;;;;;;GAMG;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;AAErE,MAAM,WAAW,kBAAkB;IAClC,UAAU,IAAI,aAAa,CAAC;IAC5B,oEAAoE;IACpE,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvF,QAAQ,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IACtF,6EAA6E;IAC7E,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/D,sBAAsB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5D,8DAA8D;IAC9D,KAAK,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;IACvD;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,CAAC,EACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,IAAI,EACzC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,GAC/B,MAAM,IAAI,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC5D,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,sBAAsB;IACtC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,kBAAkB,CA8F1F"}

package/dist/pptx/render/options/viewer-options-tabs-advanced.d.ts

@@ -0,0 +1,8 @@
+import type { ViewerOptionsTabDefinition } from './viewer-options-controls.js';
+/** Advanced, Customize Ribbon, Quick Access, Add-ins, and Trust Center tabs. */
+export declare const ADVANCED_TAB: ViewerOptionsTabDefinition;
+export declare const RIBBON_TAB: ViewerOptionsTabDefinition;
+export declare const QUICK_ACCESS_TAB: ViewerOptionsTabDefinition;
+export declare const ADD_INS_TAB: ViewerOptionsTabDefinition;
+export declare const TRUST_TAB: ViewerOptionsTabDefinition;
+//# sourceMappingURL=viewer-options-tabs-advanced.d.ts.map

package/dist/pptx/render/options/viewer-options-tabs-advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-tabs-advanced.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options-tabs-advanced.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAG5E,gFAAgF;AAEhF,eAAO,MAAM,YAAY,EAAE,0BAyJ1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,0BAaxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,0BAqB9B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,0BAMzB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,0BAoBvB,CAAC"}

package/dist/pptx/render/options/viewer-options-tabs-core.d.ts

@@ -0,0 +1,8 @@
+import type { ViewerOptionsTabDefinition } from './viewer-options-controls.js';
+/** General, Proofing, Save, Language, and Accessibility tab definitions. */
+export declare const GENERAL_TAB: ViewerOptionsTabDefinition;
+export declare const PROOFING_TAB: ViewerOptionsTabDefinition;
+export declare const SAVE_TAB: ViewerOptionsTabDefinition;
+export declare const LANGUAGE_TAB: ViewerOptionsTabDefinition;
+export declare const ACCESSIBILITY_TAB: ViewerOptionsTabDefinition;
+//# sourceMappingURL=viewer-options-tabs-core.d.ts.map

package/dist/pptx/render/options/viewer-options-tabs-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options-tabs-core.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options-tabs-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAU5E,4EAA4E;AAE5E,eAAO,MAAM,WAAW,EAAE,0BAiEzB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,0BAgE1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,0BAqDtB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,0BAM1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,0BAgD/B,CAAC"}

package/dist/pptx/render/options/viewer-options.d.ts

@@ -0,0 +1,176 @@
+import type { ToolbarTabId } from '../toolbar-actions.js';
+import type { ViewerPreferences } from '../viewer-preferences.js';
+/**
+ * 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.
+ */
+export type ScreenTipStyle = 'descriptions' | 'plain' | 'off';
+export type DisplayOptimization = 'appearance' | 'compatibility';
+export type ImageResolutionPreset = 'highFidelity' | 'ppi330' | 'ppi220' | 'ppi150' | 'ppi96';
+export type OpenDocumentsView = 'savedView' | 'normal' | 'outline' | 'slideSorter' | 'notes';
+export type DefaultExportFormat = 'pptx' | 'pdf' | 'png';
+export type QuickAccessPosition = 'above' | 'below';
+export type FeedbackSoundScheme = 'modern' | 'classic';
+export type OptionsPrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+export type OptionsPrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+export 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;
+}
+export 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.
+ */
+export interface ViewerSaveOptions {
+    autoSave: boolean;
+    autoRecoverIntervalMinutes: number;
+    keepLastAutoRecoveredVersion: boolean;
+    defaultExportFormat: DefaultExportFormat;
+    cacheRetentionDays: number;
+    clearCacheOnClose: boolean;
+}
+export interface ViewerAccessibilityOptions {
+    /** Browser speech-recognition language; automatic follows the browser language. */
+    subtitleLanguage?: string;
+    showAccessibilityStatus: boolean;
+    feedbackWithSound: boolean;
+    soundScheme: FeedbackSoundScheme;
+    showShortcutKeysInScreenTips: boolean;
+    reducedMotion: boolean;
+}
+export 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;
+}
+export interface ViewerRibbonOptions {
+    /** Ribbon tabs unticked in Customize Ribbon. The File tab can never be hidden. */
+    hiddenTabIds: ToolbarTabId[];
+}
+export interface ViewerQuickAccessOptions {
+    visible: boolean;
+    position: QuickAccessPosition;
+    showCommandLabels: boolean;
+    /** Ordered ids from `QUICK_ACCESS_COMMAND_CATALOG`. */
+    commandIds: string[];
+}
+export interface ViewerTrustOptions {
+    openInProtectedView: boolean;
+    allowExternalContent: boolean;
+    confirmExternalHyperlinks: boolean;
+}
+export interface ViewerOptions {
+    general: ViewerGeneralOptions;
+    proofing: ViewerProofingOptions;
+    save: ViewerSaveOptions;
+    accessibility: ViewerAccessibilityOptions;
+    advanced: ViewerAdvancedOptions;
+    ribbon: ViewerRibbonOptions;
+    quickAccess: ViewerQuickAccessOptions;
+    trust: ViewerTrustOptions;
+}
+export type ViewerOptionsGroupId = keyof ViewerOptions;
+export type ViewerOptionPrimitive = boolean | number | string;
+export declare const DEFAULT_VIEWER_OPTIONS: ViewerOptions;
+declare function cloneOptions(options: ViewerOptions): ViewerOptions;
+export type StoredViewerOptions = {
+    [G in ViewerOptionsGroupId]?: Partial<ViewerOptions[G]>;
+};
+/** Merge a persisted partial over the defaults, dropping unknown keys. */
+export declare function mergeViewerOptions(stored: StoredViewerOptions | undefined): ViewerOptions;
+/** Sparse diff of `options` against the defaults, for lean persistence. */
+export declare function diffViewerOptions(options: ViewerOptions): StoredViewerOptions;
+/** Project the full options model onto the legacy six-toggle preferences surface. */
+export declare function viewerOptionsToPreferences(options: ViewerOptions): ViewerPreferences;
+/** Apply a legacy preference toggle back onto the options model. */
+export declare function applyPreferenceToOptions(options: ViewerOptions, key: keyof ViewerPreferences, value: boolean): ViewerOptions;
+export { cloneOptions as cloneViewerOptions };
+//# sourceMappingURL=viewer-options.d.ts.map

package/dist/pptx/render/options/viewer-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-options.d.ts","sourceRoot":"","sources":["../../../../src/pptx/render/options/viewer-options.ts"],"names":[],"mappings":"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"}