pptx-react-viewer 1.24.0 → 1.25.0

package/dist/index.d.ts

@@ -5740,6 +5740,150 @@ declare function clearAllLocalViewerData(): Promise<void>;
 /** Persist an updated profile via the shared viewer-prefs store. */
 declare function saveViewerProfile(profile: ViewerProfile): void;
 //#endregion
+//#region src/render/toolbar-actions.d.ts
+/**
+ * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
+ * catalogue of every top-level toolbar button and ribbon tab a host app can
+ * independently hide. Each binding exposes a `hiddenActions?: ToolbarActionId[]`
+ * prop, threads it down to the relevant render sites, and gates them with
+ * `isActionHidden`. Default (`undefined` / `[]`) hides nothing, matching
+ * today's always-visible behaviour.
+ *
+ * `TOOLBAR_TABS` is also the canonical ribbon-tab list/order, replacing the
+ * copy hand-duplicated in each binding (React's `TOOLBAR_SECTIONS`, Vue's
+ * `ribbon-constants.ts`, Angular's `RIBBON_TABS`, etc.) so the tab set can't
+ * drift between bindings. Per-tab icons stay in each binding (icon libraries
+ * differ per framework); only id + i18n key + order are shared here.
+ */
+/**
+ * A single toolbar button/control that can be hidden independently of the
+ * ribbon tab it may also appear inside. `zoom` and `navigation` each cover a
+ * whole control cluster (zoom in/out/fit, prev/next) rather than each button
+ * in it, matching how hosts actually want to hide/keep them as a unit.
+ */
+type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'record' | 'notes' | 'fullscreen' | 'zoom' | 'navigation';
+/** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
+type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
+type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
+//#endregion
+//#region src/render/options/viewer-options.d.ts
+/**
+ * Full PowerPoint "File > Options" parity model.
+ *
+ * Groups mirror the ten categories of PowerPoint's Options dialog. Values are
+ * flat primitives per group so the dialog panes can be rendered generically
+ * from `VIEWER_OPTIONS_SCHEMA` in every binding. The legacy six-toggle
+ * `ViewerPreferences` surface stays supported via the mapping helpers below.
+ */
+type ScreenTipStyle = 'descriptions' | 'plain' | 'off';
+type DisplayOptimization = 'appearance' | 'compatibility';
+type ImageResolutionPreset = 'highFidelity' | 'ppi330' | 'ppi220' | 'ppi150' | 'ppi96';
+type OpenDocumentsView = 'savedView' | 'normal' | 'outline' | 'slideSorter' | 'notes';
+type DefaultExportFormat = 'pptx' | 'pdf' | 'png';
+type QuickAccessPosition = 'above' | 'below';
+type FeedbackSoundScheme = 'modern' | 'classic';
+type OptionsPrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+type OptionsPrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+interface ViewerGeneralOptions {
+  displayOptimization: DisplayOptimization;
+  showMiniToolbar: boolean;
+  enableLivePreview: boolean;
+  collapseRibbonAutomatically: boolean;
+  collapseSearchByDefault: boolean;
+  screenTipStyle: ScreenTipStyle;
+  userName: string;
+  userInitials: string;
+  showStartScreen: boolean;
+}
+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;
+}
+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 StoredViewerOptions = { [G in ViewerOptionsGroupId]?: Partial<ViewerOptions[G]>; };
+//#endregion
 //#region src/render/viewer-prefs-storage.d.ts
 /**
  * `localStorage`-backed viewer chrome preferences (theme/locale/profile),
@@ -5759,6 +5903,8 @@ interface StoredViewerPrefs {
   localeCode?: string;
   /** Local-only display profile shown in File > Account. */
   profile?: ViewerProfile;
+  /** Sparse File > Options diff against `DEFAULT_VIEWER_OPTIONS`. */
+  options?: StoredViewerOptions;
 }
 /** Read all persisted viewer preferences. Returns `{}` when unavailable, unset, or corrupt. */
 declare function readStoredViewerPrefs(): StoredViewerPrefs;
@@ -5766,32 +5912,6 @@ declare function readStoredViewerPrefs(): StoredViewerPrefs;
 declare function writeStoredViewerPrefs(patch: Partial<StoredViewerPrefs>): void;
 /** Remove all persisted viewer preferences. Silently no-ops when storage is unavailable. */
 declare function clearStoredViewerPrefs(): void;
-//#endregion
-//#region src/render/toolbar-actions.d.ts
-/**
- * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
- * catalogue of every top-level toolbar button and ribbon tab a host app can
- * independently hide. Each binding exposes a `hiddenActions?: ToolbarActionId[]`
- * prop, threads it down to the relevant render sites, and gates them with
- * `isActionHidden`. Default (`undefined` / `[]`) hides nothing, matching
- * today's always-visible behaviour.
- *
- * `TOOLBAR_TABS` is also the canonical ribbon-tab list/order, replacing the
- * copy hand-duplicated in each binding (React's `TOOLBAR_SECTIONS`, Vue's
- * `ribbon-constants.ts`, Angular's `RIBBON_TABS`, etc.) so the tab set can't
- * drift between bindings. Per-tab icons stay in each binding (icon libraries
- * differ per framework); only id + i18n key + order are shared here.
- */
-/**
- * A single toolbar button/control that can be hidden independently of the
- * ribbon tab it may also appear inside. `zoom` and `navigation` each cover a
- * whole control cluster (zoom in/out/fit, prev/next) rather than each button
- * in it, matching how hosts actually want to hide/keep them as a unit.
- */
-type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'record' | 'notes' | 'fullscreen' | 'zoom' | 'navigation';
-/** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
-type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
-type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
 
 //#endregion
 //#region src/i18n/locale-catalog.d.ts

package/dist/index.js

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunk3YMK5VLS_js = require('./chunk-3YMK5VLS.js');
-var chunkGKST4OS7_js = require('./chunk-GKST4OS7.js');
-var chunkI5SO5OV4_js = require('./chunk-I5SO5OV4.js');
-var chunkZISXRMDJ_js = require('./chunk-ZISXRMDJ.js');
+var chunkEM77GISR_js = require('./chunk-EM77GISR.js');
+var chunkIHHK6WEQ_js = require('./chunk-IHHK6WEQ.js');
+var chunkVKOVFVDJ_js = require('./chunk-VKOVFVDJ.js');
+var chunk2EFVXYNA_js = require('./chunk-2EFVXYNA.js');
 require('./chunk-KV3EOLP3.js');
 require('./chunk-QGM4M3NI.js');
 
@@ -11,121 +11,121 @@ require('./chunk-QGM4M3NI.js');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk3YMK5VLS_js.PowerPointViewer; }
+  get: function () { return chunkEM77GISR_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunk3YMK5VLS_js.SlideCanvas; }
+  get: function () { return chunkEM77GISR_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunk3YMK5VLS_js.Toolbar; }
+  get: function () { return chunkEM77GISR_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunk3YMK5VLS_js.ViewerThemeProvider; }
+  get: function () { return chunkEM77GISR_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunk3YMK5VLS_js.useViewerTheme; }
+  get: function () { return chunkEM77GISR_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkGKST4OS7_js.getAnimationInitialStyle; }
+  get: function () { return chunkIHHK6WEQ_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkGKST4OS7_js.renderToCanvas; }
+  get: function () { return chunkIHHK6WEQ_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkGKST4OS7_js.useViewerBuildingBlocks; }
+  get: function () { return chunkIHHK6WEQ_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunkVKOVFVDJ_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunkVKOVFVDJ_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.THEME_CATALOG; }
+  get: function () { return chunkVKOVFVDJ_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunkVKOVFVDJ_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.clearAllLocalViewerData; }
+  get: function () { return chunkVKOVFVDJ_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.clearStoredViewerPrefs; }
+  get: function () { return chunkVKOVFVDJ_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.defaultCssVars; }
+  get: function () { return chunkVKOVFVDJ_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.defaultRadius; }
+  get: function () { return chunkVKOVFVDJ_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.defaultThemeColors; }
+  get: function () { return chunkVKOVFVDJ_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.getLocalStorageUsageSummary; }
+  get: function () { return chunkVKOVFVDJ_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.readStoredViewerPrefs; }
+  get: function () { return chunkVKOVFVDJ_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.resolveProfileInitial; }
+  get: function () { return chunkVKOVFVDJ_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkVKOVFVDJ_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.saveViewerProfile; }
+  get: function () { return chunkVKOVFVDJ_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.themeToCssVars; }
+  get: function () { return chunkVKOVFVDJ_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.vermilionDarkColors; }
+  get: function () { return chunkVKOVFVDJ_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.vermilionDarkTheme; }
+  get: function () { return chunkVKOVFVDJ_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.vermilionLightColors; }
+  get: function () { return chunkVKOVFVDJ_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.vermilionLightTheme; }
+  get: function () { return chunkVKOVFVDJ_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.vermilionRadius; }
+  get: function () { return chunkVKOVFVDJ_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkI5SO5OV4_js.writeStoredViewerPrefs; }
+  get: function () { return chunkVKOVFVDJ_js.writeStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkZISXRMDJ_js.LOCALE_CATALOG; }
+  get: function () { return chunk2EFVXYNA_js.LOCALE_CATALOG; }
 });

package/dist/index.mjs

@@ -1,6 +1,6 @@
-export { PowerPointViewer, SlideCanvas, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-PUQ6GIOM.mjs';
-export { getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks } from './chunk-YJVMOX2Y.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-KPT54MHG.mjs';
-export { LOCALE_CATALOG } from './chunk-E3KJKCSV.mjs';
+export { PowerPointViewer, SlideCanvas, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-NKSIDFYP.mjs';
+export { getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks } from './chunk-VDALVGDT.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-QOBKJKLT.mjs';
+export { LOCALE_CATALOG } from './chunk-M3SIFXWD.mjs';
 import './chunk-LDZQNYWL.mjs';
 import './chunk-6DZX6EAA.mjs';