pptx-react-viewer 1.21.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,21 @@ 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
@@ -8034,6 +8059,16 @@ type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'rec
 type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
 type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
 
+/** 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
 /**
  * Union of all shape preset types that the viewer can insert or render.
@@ -8425,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.
    *

package/dist/viewer/index.js

@@ -1,10 +1,10 @@
 'use strict';
 
 require('../chunk-IKBO6CZC.js');
-var chunkPQUAAGKH_js = require('../chunk-PQUAAGKH.js');
-var chunk2YHX6IAW_js = require('../chunk-2YHX6IAW.js');
-require('../chunk-UGAJLDGZ.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 chunkPQUAAGKH_js.CollaborationProvider; }
+  get: function () { return chunkA6IFTYB5_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkPQUAAGKH_js.CollaborationStatusIndicator; }
+  get: function () { return chunkA6IFTYB5_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkPQUAAGKH_js.PowerPointViewer; }
+  get: function () { return chunkA6IFTYB5_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkPQUAAGKH_js.RemoteUserCursors; }
+  get: function () { return chunkA6IFTYB5_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkPQUAAGKH_js.UserAvatarBar; }
+  get: function () { return chunkA6IFTYB5_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.clearAudienceContent; }
+  get: function () { return chunkQVQTDWB7_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.getAnimationInitialStyle; }
+  get: function () { return chunkQVQTDWB7_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.isAudienceTab; }
+  get: function () { return chunkQVQTDWB7_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.loadAudienceContent; }
+  get: function () { return chunkQVQTDWB7_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.parseAudienceNonce; }
+  get: function () { return chunkQVQTDWB7_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.storeAudienceContent; }
+  get: function () { return chunkQVQTDWB7_js.storeAudienceContent; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.useCollaborativeHistory; }
+  get: function () { return chunkQVQTDWB7_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.useCollaborativeState; }
+  get: function () { return chunkQVQTDWB7_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.usePresenceTracking; }
+  get: function () { return chunkQVQTDWB7_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_js.useThemeSwitching; }
+  get: function () { return chunkQVQTDWB7_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunk2YHX6IAW_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-K6C5G2J6.mjs';
-export { clearAudienceContent, getAnimationInitialStyle, isAudienceTab, loadAudienceContent, parseAudienceNonce, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-2C3XYEFM.mjs';
-import '../chunk-FTJ5JKLB.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.21.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-JxHuwp4K.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PowerPointViewer-JxHuwp4K.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-DGauquE9.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-DGauquE9.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;;;;;;;;;;;;;;;;;;EAmBA,gBAAgB;;UAGA,+BAA+B,kBAAkB;EACjE,kBAAkB,QAAQ"}