pptx-react-viewer 1.20.0 → 1.22.0

package/dist/viewer/index.d.ts

@@ -82,6 +82,16 @@ interface ViewerTheme {
     cssVars?: Record<string, string>;
 }
 
+/** One selectable entry in the viewer chrome's built-in theme picker (File > Options > Appearance). */
+interface ThemeCatalogEntry {
+    /** Stable identifier persisted to storage and passed to `onThemeChange`. */
+    key: string;
+    /** `pptx.*` translation key for the entry's display label. */
+    labelKey: string;
+    /** The theme to apply, or `undefined` to reset to the built-in default. */
+    theme: ViewerTheme | undefined;
+}
+
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
  *
@@ -8008,6 +8018,56 @@ interface ElementClipboardPayload {
     element: PptxElement;
     isTemplate: boolean;
 }
+/**
+ * Optional hook point for hosts that want to wire a real sign-in flow into
+ * File > Account. Disabled by default: the Account page renders nothing
+ * extra unless a host explicitly opts in by passing `enabled: true`.
+ * See docs/guide for wiring instructions.
+ */
+interface AccountAuthConfig {
+    enabled: boolean;
+    onSignIn: () => void;
+    signedInUser?: {
+        name: string;
+        email?: string;
+        avatarUrl?: string;
+    };
+}
+
+/**
+ * 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;
+
+/** One selectable entry in the viewer chrome's built-in language picker (File > Options > Language). */
+interface LocaleCatalogEntry {
+  /** BCP-47-ish locale code, e.g. `'en'`, `'fr'`. Matches `pptx-viewer-locales`' exports. */
+  code: string;
+  /** English display name, used before a translation dictionary for the target locale is loaded. */
+  label: string;
+  /** The locale's own name for itself, e.g. `'Français'` for `fr`. */
+  nativeLabel: string;
+}
 
 //#region src/viewer/types-core.d.ts
 /**
@@ -8400,6 +8460,50 @@ interface PowerPointViewerProps {
    * @see {@link ViewerTheme} for the full type definition.
    */
   theme?: ViewerTheme;
+  /**
+   * Initial key into `availableThemes` (or the built-in `THEME_CATALOG`) for
+   * File > Options > Appearance. Ignored once the user picks a different
+   * entry in that session, and always overridden by the `theme` prop when
+   * both are supplied. Falls back to a persisted `localStorage` choice, then
+   * `'default'`.
+   */
+  defaultThemeKey?: string;
+  /**
+   * Theme choices offered by File > Options > Appearance. Defaults to the
+   * shared `THEME_CATALOG` (default/light/vermilionLight/vermilionDark).
+   */
+  availableThemes?: ThemeCatalogEntry[];
+  /**
+   * Called when the user picks a theme from File > Options > Appearance.
+   * When provided, the host owns persisting the choice (the viewer will not
+   * also write it to `localStorage`); otherwise the viewer persists it via
+   * the shared `writeStoredViewerPrefs` helper.
+   */
+  onThemeChange?: (key: string) => void;
+  /**
+   * Initial locale code for File > Options > Language. Falls back to a
+   * persisted `localStorage` choice, then `'en'`.
+   */
+  defaultLocale?: string;
+  /**
+   * Locale choices offered by File > Options > Language. Defaults to the
+   * codes actually registered on the host's `react-i18next` instance
+   * (mapped through the shared `LOCALE_CATALOG` for display labels).
+   */
+  availableLocales?: LocaleCatalogEntry[];
+  /**
+   * Called when the user picks a language from File > Options > Language.
+   * When provided, the host owns applying and persisting the choice (the
+   * viewer will not call `i18n.changeLanguage` or touch `localStorage`
+   * itself); otherwise the viewer applies and persists it directly.
+   */
+  onLocaleChange?: (code: string) => void;
+  /**
+   * Optional hook point for File > Account's sign-in section. Disabled by
+   * default (renders nothing extra); pass `{ enabled: true, onSignIn }` to
+   * surface a real sign-in flow.
+   */
+  accountAuth?: AccountAuthConfig;
   /**
    * Optional real-time collaboration configuration.
    *
@@ -8461,6 +8565,24 @@ interface PowerPointViewerProps {
    * back to the SVG `SmartArtRenderer`. Default `false`.
    */
   smartArt3D?: boolean;
+  /**
+   * Hide individual toolbar buttons and/or ribbon tabs instead of the whole
+   * toolbar. Accepts any mix of button ids (`share`, `broadcast`, `export`,
+   * `undo`, `redo`, `record`, `notes`, `fullscreen`, `zoom`, `navigation`)
+   * and ribbon-tab ids (`file`, `home`, `insert`, `draw`, `design`,
+   * `transitions`, `animations`, `slideShow`, `record`, `review`, `view`,
+   * `help`). `zoom` and `navigation` each hide their whole control cluster
+   * (zoom in/out/fit; previous/next slide), not each sub-button. `record`
+   * is shared between the quick-access Record button and the Record ribbon
+   * tab: hiding it hides both. Omitted or empty hides nothing (default,
+   * fully backward compatible).
+   *
+   * @example
+   * ```tsx
+   * <PowerPointViewer content={bytes} hiddenActions={['share', 'broadcast', 'record']} />
+   * ```
+   */
+  hiddenActions?: ToolbarActionId[];
 }
 interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI {
   getContent: () => Promise<Uint8Array>;

package/dist/viewer/index.js

@@ -1,10 +1,10 @@
 'use strict';
 
 require('../chunk-IKBO6CZC.js');
-var chunkKRK367H5_js = require('../chunk-KRK367H5.js');
-var chunkLXUMBK2O_js = require('../chunk-LXUMBK2O.js');
-require('../chunk-BXACB3BG.js');
-require('../chunk-4SRCC7NB.js');
+var chunkA6IFTYB5_js = require('../chunk-A6IFTYB5.js');
+var chunkQVQTDWB7_js = require('../chunk-QVQTDWB7.js');
+require('../chunk-VSNXVKJI.js');
+require('../chunk-ZISXRMDJ.js');
 require('../chunk-AD3EAEY6.js');
 require('../chunk-QGM4M3NI.js');
 
@@ -12,65 +12,65 @@ require('../chunk-QGM4M3NI.js');
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkKRK367H5_js.CollaborationProvider; }
+  get: function () { return chunkA6IFTYB5_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkKRK367H5_js.CollaborationStatusIndicator; }
+  get: function () { return chunkA6IFTYB5_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkKRK367H5_js.PowerPointViewer; }
+  get: function () { return chunkA6IFTYB5_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkKRK367H5_js.RemoteUserCursors; }
+  get: function () { return chunkA6IFTYB5_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkKRK367H5_js.UserAvatarBar; }
+  get: function () { return chunkA6IFTYB5_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.clearAudienceContent; }
+  get: function () { return chunkQVQTDWB7_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.getAnimationInitialStyle; }
+  get: function () { return chunkQVQTDWB7_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.isAudienceTab; }
+  get: function () { return chunkQVQTDWB7_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.loadAudienceContent; }
+  get: function () { return chunkQVQTDWB7_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.parseAudienceNonce; }
+  get: function () { return chunkQVQTDWB7_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.storeAudienceContent; }
+  get: function () { return chunkQVQTDWB7_js.storeAudienceContent; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.useCollaborativeHistory; }
+  get: function () { return chunkQVQTDWB7_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.useCollaborativeState; }
+  get: function () { return chunkQVQTDWB7_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.usePresenceTracking; }
+  get: function () { return chunkQVQTDWB7_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.useThemeSwitching; }
+  get: function () { return chunkQVQTDWB7_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkLXUMBK2O_js.useYjsProvider; }
+  get: function () { return chunkQVQTDWB7_js.useYjsProvider; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
 import '../chunk-T5U6P2JH.mjs';
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-TUVSZMLW.mjs';
-export { clearAudienceContent, getAnimationInitialStyle, isAudienceTab, loadAudienceContent, parseAudienceNonce, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-UDJHJM5B.mjs';
-import '../chunk-GG2KBJSN.mjs';
-import '../chunk-4LPWBQTH.mjs';
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-7P7QQGTI.mjs';
+export { clearAudienceContent, getAnimationInitialStyle, isAudienceTab, loadAudienceContent, parseAudienceNonce, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-DZUI64SO.mjs';
+import '../chunk-5SBQZEKD.mjs';
+import '../chunk-E3KJKCSV.mjs';
 import '../chunk-3ZGCM6RC.mjs';
 import '../chunk-6DZX6EAA.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "1.20.0",
+	"version": "1.22.0",
 	"description": "React PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",

package/dist/PowerPointViewer-C4d7SKZf.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PowerPointViewer-C4d7SKZf.d.ts","names":[],"sources":["../src/viewer/utils/animation-effects.ts","../src/viewer/PowerPointViewer.tsx"],"mappings":";;;;;iBAmBgB,yBACf,QAAQ,iCACR,kBAAkB,sBAChB,MAAM;;;;;;;;;;;;cC4DI,kCAAgB,0BAAA,wCAAA,cAAA"}

package/dist/i18n.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"i18n.d.ts","names":[],"sources":["../../shared/dist/i18n/index.d.ts"],"mappings":";;;;;;;;;;cASc,gBAAgB;;;;;;;KAOzB,8BAA8B;;;;;;iBAMlB,WAAW"}

package/dist/types-BK7Nt13M.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-BK7Nt13M.d.ts","names":[],"sources":["../src/viewer/types-core.ts","../src/theme/context.tsx","../src/viewer/hooks/collaboration/types.ts","../src/viewer/types-ui.ts"],"mappings":";;;;;;;;;;KA+BY;;;;;KAqCA;;UAgBK;;EAEhB;;EAEA;;;;;;;;UAagB;;EAEhB;;EAEA;;EAEA;;EAEA,oBAAoB;IAAiB;IAAW;;;EAEhD,QAAQ,YAAY;;EAEpB;;EAEA;EACA;;;KAIW;;;;;;UAOK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;EAEA,OAAO;;EAEP;EACA;EACA;EACA;;;;;;;UAQgB;EAChB;EACA;EACA;EACA;EACA;;;;;;;UAQgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;UAoBgB;EAChB;EACA;EACA;EACA,QAAQ;EACR,2BAA2B,eAAe;EAC1C;;;UAQgB;EAChB;EACA;EACA;EACA;;;;;;;UAQgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAQgB;EAChB;EACA,OAAO,QAAQ;;;;UCxOC;EAChB,QAAQ;EACR,UAAU,MAAM;;;;;;;;;;iBAWD,sBAAsB,OAAO,YAAY,2CAAwB,IAAA;;;;;iBAYjE,kBAAkB;;;;KCOtB;;;;;UAUK;;EAEhB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,OAAO;;;UAQS;;EAEhB,QAAQ;;EAER,aAAa;;EAEb,oBAAoB,QAAQ,QAAQ,KAAK;;EAEzC;;EAEA,QAAQ;;EAER,KAAK;;;;;EAKL;;EAEA;;;;;;;;;;UC7EgB;;EAEhB,kBAAkB,iBAAiB;;;UAQnB;EAChB,MAAM;EACN;EACA,MAAM,QAAM;;;UAQI;EAChB;EACA;EACA;;;KAIW;;;;;;UA8BK;EAChB;EACA;EACA;EACA;EACA;EACA;;;UAQgB;EAChB;EACA;;EAEA;;EAEA,gBAAgB;IAAQ;IAAa;;;;UAIrB;EAChB;EACA;EACA;EACA,OAAO,QAAM;EACb,SAAS;;;UAIO;EAChB;EACA;EACA,MAAM;EACN;EACA,OAAO;;;UAQS;EAChB;EACA;EACA,WAAW;;;;;;UAWK;EAChB;EACA;EACA;;EAEA;;EAEA;;;KAQW;;KAGA;;KAiBA;;UAOK;EAChB;EACA;;;UAIgB;EAChB;EACA;EACA;EACA;;;UAQgB;EAChB,OAAO;EACP;;;UAIgB;EAChB,OAAO;EACP;;;UAIgB;EAChB,OAAO;EACP;;;UAIgB;EAChB,OAAO,YAAY;EACnB;;;UAIgB;EAChB,OAAO,QAAQ;EACf;;UAOgB;;EAEhB,SAAS;;EAET,QAAQ;;EAER;;;;;EAKA;;EAEA,iBAAiB;EACjB,mBAAmB,SAAS;;EAE5B,uBAAuB;;EAEvB,gBAAgB,mCAAmC;;EAEnD,gBAAgB;;EAEhB,qBAAqB;;EAErB,sBAAsB;;;;;;;EAOtB;;EAGA;;EAEA;;;;;EAMA;;;;;;;;;;;;;;;;;;;;;EAsBA,QAlD4B;;;;;;;;;;;;;;;;;;;;;EAwE5B,gBAAgB;;;;;;EAOhB,wBAAwB,QAAQ;;;;;EAMhC;;;;;;;;;;;;;;;;;EAkBA;IACC;IACA;IACA;;;;;;;;;EAUD;;UAGgB,+BAA+B,kBAAkB;EACjE,kBAAkB,QAAQ"}