pptx-react-viewer 4.74.0 → 4.76.0

package/dist/viewer/index.d.ts

@@ -1,8 +1,8 @@
-import * as React from 'react';
-import React__default, { ReactNode, ReactElement, RefObject } from 'react';
 import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
 import { CollaborationRole, CollaborationConfig, HistoryTheme, ViewportFitOptions, ViewerFontSource, CanvasSize, DocumentStorage, CloudFileProvider, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, GoogleFontsOption, ListConversionScope, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PptxLoadLimits, PowerPointViewerAPI, ViewerCustomizationApi, BorrowedCollaborationAwareness } from 'ooxml-ui/pptx';
 export { CollaborationConfig, CollaborationRole, ElementClipboardPayload, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, SessionDeck, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ViewerMode, clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from 'ooxml-ui/pptx';
+import * as React from 'react';
+import React__default, { ReactNode, ReactElement, RefObject } from 'react';
 import { PptxAnimationPreset, ConnectorArrowType, PptxSlide, PptxElement, XmlObject, PptxCoreProperties, PptxElementAnimation, ShapeStyle, PptxSlideTransition, StrokeDashType, PptxNativeAnimation, PptxThemePreset, PptxThemeColorScheme, PptxThemeFontScheme, PptxHandler, PptxData } from 'ooxml-core/pptx';
 import { CollaborationWriteBackState, CollaborationState } from 'ooxml-core/collab';
 export { CollaborationState } from 'ooxml-core/collab';
@@ -14,6 +14,18 @@ import { LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
 import * as Y from 'yjs';
 import { Doc } from 'yjs';
 
+/** What the viewer passes `translate`: exactly the params of the call. */
+interface PptxTranslateParams {
+  readonly defaultValue?: string;
+  readonly count?: number;
+  readonly [name: string]: unknown;
+}
+/**
+ * A host translator for {@link PptxI18nProvider}: the text for a viewer key (`pptx.*`) in the
+ * host's active language. Return the key itself, an empty string, `null` or `undefined` for "no
+ * translation": the viewer then shows its built-in English text.
+ */
+type PptxTranslate = (key: string, params?: PptxTranslateParams) => string | null | undefined;
 /**
  * Union of all shape preset types that the viewer can insert or render.
  * Maps to OOXML `a:prstGeom` preset values (e.g. "rect", "ellipse").
@@ -351,6 +363,19 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   onModeChange?: (mode: ooxml_ui_pptx.ViewerMode) => void;
   /** Callback when the zoom level changes. */
   onZoomChange?: (zoom: number) => void;
+  /**
+   * Ribbon Display Options, the starting mode: `always` docks the tabs and commands above the
+   * slide (the default), `tabs` shows only the tab row (a chosen tab lays its commands over the
+   * slide until a press elsewhere or Escape), `fullScreen` hides the title bar and the ribbon
+   * until the strip at the top is pressed. Changing it later applies the mode without calling
+   * `onRibbonDisplayChange`.
+   */
+  ribbonDisplay?: ooxml_ui_pptx.RibbonDisplayMode;
+  /**
+   * Called when the user picks a Ribbon Display Option (the menu, Ctrl+F1, a double click on a
+   * tab). Not called when the host changes `ribbonDisplay`.
+   */
+  onRibbonDisplayChange?: (mode: ooxml_ui_pptx.RibbonDisplayMode) => void;
   /** Callback when element selection changes. */
   onSelectionChange?: (elementIds: string[]) => void;
   /** Callback when the total slide count changes (slide added/deleted). */
@@ -488,19 +513,25 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   /**
    * Initial locale code for File > Options > Language. Falls back to a persisted `localStorage`
    * choice, then `'en'`. Ignored inside a `PptxI18nProvider`, whose `locale` is the language.
+   * Without a provider it applies only while the viewer reads a configured react-i18next
+   * instance; with neither (for example `pptx-react-viewer/no-i18next` on its own) the viewer
+   * shows its built-in English text and ignores it.
    */
   defaultLocale?: string;
   /**
-   * Locale choices offered by File > Options > Language. Defaults to the codes registered on the
-   * host's `react-i18next` instance. Inside a `PptxI18nProvider` there is no default: pass two or
-   * more, together with `onLocaleChange`, to show the Language category.
+   * Locale choices offered by File > Options > Language. Without a provider they default to the
+   * codes registered on the host's `react-i18next` instance, and have no effect when the viewer
+   * reads no configured instance (see `defaultLocale`). Inside a `PptxI18nProvider` there is no
+   * default: pass two or more, together with `onLocaleChange`, to show the Language category.
    */
   availableLocales?: LocaleCatalogEntry[];
   /**
    * Called when the user picks a language from File > Options > Language. When provided, the
    * host owns applying and persisting the choice; otherwise the viewer applies and persists it
    * itself. Inside a `PptxI18nProvider` the host always owns the language: without this callback
-   * the Language category is left out.
+   * the Language category is left out. Without a provider, when the viewer reads no configured
+   * react-i18next instance (see `defaultLocale`), the Language category is left out and this is
+   * never called.
    */
   onLocaleChange?: (code: string) => void;
   /**
@@ -776,18 +807,6 @@ declare function getAnimationInitialStyle(preset: PptxAnimationPreset | undefine
  * access (e.g. serialising the current content for saving).
  */
 declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
-/** What the viewer passes `translate`: exactly the params of the call. */
-interface PptxTranslateParams {
-  readonly defaultValue?: string;
-  readonly count?: number;
-  readonly [name: string]: unknown;
-}
-/**
- * A host translator for {@link PptxI18nProvider}: the text for a viewer key (`pptx.*`) in the
- * host's active language. Return the key itself, an empty string, `null` or `undefined` for "no
- * translation": the viewer then shows its built-in English text.
- */
-type PptxTranslate = (key: string, params?: PptxTranslateParams) => string | null | undefined;
 interface PptxI18nProviderProps {
   /**
    * Translates a viewer key; see {@link PptxTranslate}. Keep it referentially stable (a

package/dist/viewer/index.js

@@ -1,9 +1,10 @@
 'use strict';
 
-var chunkD4WC35PL_js = require('../chunk-D4WC35PL.js');
-require('../chunk-LVEFHZ76.js');
-var chunkXG4WSJ4O_js = require('../chunk-XG4WSJ4O.js');
-var chunkP2COO2QO_js = require('../chunk-P2COO2QO.js');
+require('../chunk-P2IEKYVG.js');
+var chunkXTYBIJ2S_js = require('../chunk-XTYBIJ2S.js');
+require('../chunk-MU3BIZ2U.js');
+var chunkSEIVQGH5_js = require('../chunk-SEIVQGH5.js');
+var chunk6GFSF2ML_js = require('../chunk-6GFSF2ML.js');
 require('../chunk-PIRHQTI4.js');
 var pptx = require('ooxml-ui/pptx');
 
@@ -11,71 +12,71 @@ var pptx = require('ooxml-ui/pptx');
 
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkD4WC35PL_js.CollaborationStatusIndicator; }
+  get: function () { return chunkXTYBIJ2S_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkD4WC35PL_js.PowerPointViewer; }
-});
-Object.defineProperty(exports, "PptxI18nProvider", {
-  enumerable: true,
-  get: function () { return chunkD4WC35PL_js.PptxI18nProvider; }
+  get: function () { return chunkXTYBIJ2S_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkD4WC35PL_js.UserAvatarBar; }
+  get: function () { return chunkXTYBIJ2S_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.CollaborationProvider; }
+  get: function () { return chunkSEIVQGH5_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.RemoteUserCursors; }
+  get: function () { return chunkSEIVQGH5_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.clearAudienceContent; }
+  get: function () { return chunkSEIVQGH5_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.isAudienceTab; }
+  get: function () { return chunkSEIVQGH5_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.loadAudienceContent; }
+  get: function () { return chunkSEIVQGH5_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.parseAudienceNonce; }
+  get: function () { return chunkSEIVQGH5_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.storeAudienceContent; }
+  get: function () { return chunkSEIVQGH5_js.storeAudienceContent; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.useCollaborativeHistory; }
+  get: function () { return chunkSEIVQGH5_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.useCollaborativeState; }
+  get: function () { return chunkSEIVQGH5_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.usePresenceTracking; }
+  get: function () { return chunkSEIVQGH5_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.useThemeSwitching; }
+  get: function () { return chunkSEIVQGH5_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkXG4WSJ4O_js.useYjsProvider; }
+  get: function () { return chunkSEIVQGH5_js.useYjsProvider; }
+});
+Object.defineProperty(exports, "PptxI18nProvider", {
+  enumerable: true,
+  get: function () { return chunk6GFSF2ML_js.PptxI18nProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkP2COO2QO_js.getAnimationInitialStyle; }
+  get: function () { return chunk6GFSF2ML_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,

package/dist/viewer/index.mjs

@@ -1,6 +1,7 @@
-export { CollaborationStatusIndicator, PowerPointViewer, PptxI18nProvider, UserAvatarBar } from '../chunk-SQ7OASDY.mjs';
-import '../chunk-JZE6BORE.mjs';
-export { CollaborationProvider, RemoteUserCursors, clearAudienceContent, isAudienceTab, loadAudienceContent, parseAudienceNonce, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-CRC3V4UG.mjs';
-export { getAnimationInitialStyle } from '../chunk-FBSPQYRE.mjs';
+import '../chunk-Y53EC3JU.mjs';
+export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-OC4RP2CB.mjs';
+import '../chunk-RMEWSJZU.mjs';
+export { CollaborationProvider, RemoteUserCursors, clearAudienceContent, isAudienceTab, loadAudienceContent, parseAudienceNonce, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-PPOGAZ53.mjs';
+export { PptxI18nProvider, getAnimationInitialStyle } from '../chunk-N3YK2BCA.mjs';
 import '../chunk-UV2HVMKZ.mjs';
 export { forgetSessionDeck, getSessionTabId, loadSessionDeck, rememberSessionDeck, restoreSessionDeck } from 'ooxml-ui/pptx';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "4.74.0",
+	"version": "4.76.0",
 	"description": "pptx-viewer for React: a PowerPoint viewer and editor component to render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",
@@ -46,6 +46,11 @@
 			"import": "./dist/index.mjs",
 			"require": "./dist/index.js"
 		},
+		"./no-i18next": {
+			"types": "./dist/no-i18next.d.ts",
+			"import": "./dist/no-i18next.mjs",
+			"require": "./dist/no-i18next.js"
+		},
 		"./viewer": {
 			"types": "./dist/viewer/index.d.ts",
 			"import": "./dist/viewer/index.mjs",
@@ -112,7 +117,7 @@
 		}
 	},
 	"scripts": {
-		"build": "tsup && tsdown && node ../../scripts/merge-declarations.mjs && node ../../scripts/bundle-declarations.mjs index viewer/index i18n internals ai && node ../../scripts/merge-declarations.mjs .types-bundle && node ../../scripts/prune-stray-declarations.mjs dist index.d.ts viewer/index.d.ts i18n.d.ts internals.d.ts ai.d.ts && npx @tailwindcss/cli -i src/styles/pptx-viewer.css -o dist/pptx-viewer.css --minify && node scripts/build-canvas-css.mjs && node ../locales/scripts/copy-subpaths.mjs && node ../../scripts/compress-dist.mjs dist",
+		"build": "tsup && tsdown && node ../../scripts/merge-declarations.mjs && node ../../scripts/bundle-declarations.mjs index no-i18next viewer/index i18n internals ai && node ../../scripts/merge-declarations.mjs .types-bundle && node ../../scripts/prune-stray-declarations.mjs dist index.d.ts no-i18next.d.ts viewer/index.d.ts i18n.d.ts internals.d.ts ai.d.ts && npx @tailwindcss/cli -i src/styles/pptx-viewer.css -o dist/pptx-viewer.css --minify && node scripts/build-canvas-css.mjs && node ../locales/scripts/copy-subpaths.mjs && node ../../scripts/compress-dist.mjs dist",
 		"build:css": "npx @tailwindcss/cli -i src/styles/pptx-viewer.css -o dist/pptx-viewer.css --minify && node scripts/build-canvas-css.mjs",
 		"dev": "tsup --watch",
 		"typecheck": "tsc --noEmit --pretty",
@@ -126,8 +131,8 @@
 		"clsx": "^2.1.1",
 		"dompurify": "^3.4.17",
 		"html2canvas-pro": "^2.6.3",
-		"ooxml-core": "^1.48.1",
-		"ooxml-ui": "^1.49.0",
+		"ooxml-core": "^1.50.0",
+		"ooxml-ui": "^1.50.0",
 		"opentype.js": "^2.0.0",
 		"tailwind-merge": "^3.7.0"
 	},