pptx-react-viewer 4.15.0 → 4.16.1

package/dist/viewer/index.d.ts

@@ -12861,6 +12861,25 @@ type ViewerOptionPrimitive = boolean | number | string;
  */
 type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
 //#endregion
+//#region src/render/customization/host-menu-commands.d.ts
+/** Snapshot of the slide on which the host command was offered. */
+interface HostCanvasMenuContext {
+  slideIndex: number;
+}
+/** Effective selection, including a single right-clicked element. */
+interface HostElementMenuContext extends HostCanvasMenuContext {
+  elementIds: readonly string[];
+}
+/** Plain text labels work identically in every framework. */
+interface HostMenuCommand<C> {
+  id: string;
+  label: string;
+  /** Default: a separate group above the built-in commands. */
+  group?: 'top' | 'bottom';
+  disabled?: boolean | ((context: C) => boolean);
+  onSelect: (context: C) => void;
+}
+//#endregion
 //#region src/render/customization/ribbon-control-catalog.d.ts
 declare const RIBBON_CONTROL_CATALOG: {
   readonly home: {
@@ -13208,6 +13227,7 @@ declare const RIBBON_CONTROL_CATALOG: {
       readonly label: 'Language';
       readonly controls: {
         readonly translate: 'Translate';
+        readonly language: 'Language';
       };
     };
     readonly comments: {
@@ -13442,6 +13462,9 @@ interface BackstageCustomization {
 }
 /** Right-click menu customisation. */
 interface ContextMenuCustomization {
+  /** Additional host commands, independent of the viewer's AI connection. */
+  extraElementCommands?: readonly HostMenuCommand<HostElementMenuContext>[];
+  extraCanvasCommands?: readonly HostMenuCommand<HostCanvasMenuContext>[];
   /** Entries to remove from the element (right-click on a shape) menu. */
   hiddenElementCommands?: readonly ContextMenuCommandId[];
   /** Entries to remove from the empty-canvas menu. */
@@ -13562,6 +13585,29 @@ interface ViewerCustomizationApi {
   setFeatureEnabled(feature: ViewerFeatureId, enabled: boolean): void;
   setDialogAvailable(dialog: ViewerDialogId, available: boolean): void;
 }
+//#endregion
+//#region src/render/ribbon-command-view.d.ts
+/** A host supplies translated labels and controlled state; shared owns markup. */
+interface RibbonCommandView {
+  id: RibbonControlId;
+  label: string;
+  icon: string;
+  title?: string;
+  disabled?: boolean;
+  active?: boolean;
+  pressed?: boolean;
+  expanded?: boolean;
+  hidden?: boolean;
+  compact?: boolean;
+  badge?: number;
+  /** Commands with the same column share a vertical stack. */
+  column?: number;
+}
+interface RibbonGroupView {
+  id: RibbonGroupId;
+  label: string;
+  commands: readonly RibbonCommandView[];
+}
 /**
  * A font supplied by the host application. The package never ships fonts:
  * applications provide a licensed URL, data URL, or blob URL for their users.
@@ -13677,6 +13723,57 @@ interface AccountAuthConfig {
   };
 }
 //#endregion
+//#region src/render/ribbon-galleries/gallery-types.d.ts
+/** Every gallery the ribbon offers. */
+type RibbonGalleryId = 'shapeStyles' | 'shapeEffects' | 'wordArtStyles' | 'pictureStyles' | 'pictureCorrections' | 'pictureColor' | 'pictureArtisticEffects' | 'bullets' | 'numbering' | 'tableStyles' | 'chartStyles' | 'chartColors' | 'chartQuickLayout' | 'smartArtStyles' | 'smartArtColors' | 'themeColors' | 'themeFonts';
+/** One tile. */
+interface RibbonGalleryItem {
+  /** Stable within its gallery; what `applyRibbonGalleryItem` takes. */
+  id: string;
+  /** i18n key of the tile's accessible name / tooltip. */
+  labelKey: string;
+  /** `{{name}}` interpolation values for `labelKey`. */
+  labelParams?: Readonly<Record<string, string | number>>;
+  /** English fallback for bindings whose dictionary lacks `labelKey`. */
+  label: string;
+  /**
+   * A complete, self-contained `<svg>` element (width/height/viewBox set).
+   * Built only from catalogue data and theme colours, never from user text,
+   * so it is safe to inject as markup.
+   */
+  previewSvg: string;
+  /**
+   * CSS `filter` the tile's preview carries (the Picture Adjust galleries),
+   * for a host that draws the thumbnail over a real image instead of
+   * `previewSvg`. Omitted when the preset has no CSS-expressible preview.
+   */
+  previewFilter?: string;
+  /** True when this entry is what the selection currently carries. */
+  applied: boolean;
+}
+/** A titled block of tiles (PowerPoint's "Theme Styles" / "Presets"). */
+interface RibbonGallerySection {
+  id: string;
+  /** i18n key of the section heading; omitted for an untitled section. */
+  titleKey?: string;
+  title?: string;
+  /** Tiles per row in the dropped-down grid. */
+  columns: number;
+  /** Preview tile size in CSS px (the SVG's own width/height). */
+  tileWidth: number;
+  tileHeight: number;
+  items: RibbonGalleryItem[];
+}
+interface RibbonGalleryDescriptor {
+  id: RibbonGalleryId;
+  /** i18n key of the gallery trigger / group caption. */
+  labelKey: string;
+  label: string;
+  sections: RibbonGallerySection[];
+  /** True when the selection cannot take this gallery (trigger disabled). */
+  disabled: boolean;
+}
+//#endregion
 //#region src/render/viewport-fit.d.ts
 /** Unscaled CSS pixels reserved on each side of the ordinary viewer viewport. */
 type ViewportFitPadding = number | {
@@ -13690,6 +13787,46 @@ interface ViewportFitOptions {
   /** Positive fit-factor ceiling; null allows enlargement without a ceiling. */
   maxFitScale?: number | null;
 }
+type ThemeEditorLabels = Record<string, string>;
+//#endregion
+//#region src/web-components/theme-editor.d.ts
+interface PptxUiThemeEditorElement extends HTMLElement {
+  theme: PptxTheme | undefined;
+  labels: ThemeEditorLabels;
+  disabled: boolean;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-theme-editor': PptxUiThemeEditorElement;
+  }
+}
+//#endregion
+//#region src/web-components/ribbon-section.d.ts
+interface PptxUiRibbonSectionElement extends HTMLElement {
+  groups: readonly RibbonGroupView[];
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-ribbon-section': PptxUiRibbonSectionElement;
+  }
+}
+//#endregion
+//#region src/web-components/ribbon-gallery-view.d.ts
+type GalleryTranslate = (key: string, params?: Readonly<Record<string, string | number>>) => string;
+interface PptxUiRibbonGalleryElement extends HTMLElement {
+  readonly trigger: HTMLButtonElement;
+  readonly popup: HTMLElement;
+  descriptor: RibbonGalleryDescriptor | undefined;
+  translateLabel: GalleryTranslate;
+  disabled: boolean;
+  open: boolean;
+  close(): void;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-ribbon-gallery': PptxUiRibbonGalleryElement;
+  }
+}
 //#endregion
 //#region src/web-components/subtitle-settings.d.ts
 interface PptxUiSubtitleSettingsElement extends HTMLElement {

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunk6ZPXMS64_js = require('../chunk-6ZPXMS64.js');
-require('../chunk-UP6PJEHM.js');
-var chunkHGO243GV_js = require('../chunk-HGO243GV.js');
-var chunkCNXVOFUW_js = require('../chunk-CNXVOFUW.js');
-var chunk2CSRCH4H_js = require('../chunk-2CSRCH4H.js');
-require('../chunk-XEYB25ZT.js');
+var chunkVVGYZBF5_js = require('../chunk-VVGYZBF5.js');
+require('../chunk-CWVPHCMJ.js');
+var chunkXVJSAY7C_js = require('../chunk-XVJSAY7C.js');
+var chunkRE6NDQH7_js = require('../chunk-RE6NDQH7.js');
+var chunk4VV5HJXQ_js = require('../chunk-4VV5HJXQ.js');
+require('../chunk-LJEI7O6S.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunk6ZPXMS64_js.CollaborationStatusIndicator; }
+  get: function () { return chunkVVGYZBF5_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk6ZPXMS64_js.PowerPointViewer; }
+  get: function () { return chunkVVGYZBF5_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunk6ZPXMS64_js.UserAvatarBar; }
+  get: function () { return chunkVVGYZBF5_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.CollaborationProvider; }
+  get: function () { return chunkXVJSAY7C_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.RemoteUserCursors; }
+  get: function () { return chunkXVJSAY7C_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.isAudienceTab; }
+  get: function () { return chunkXVJSAY7C_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.parseAudienceNonce; }
+  get: function () { return chunkXVJSAY7C_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.useCollaborativeHistory; }
+  get: function () { return chunkXVJSAY7C_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.useCollaborativeState; }
+  get: function () { return chunkXVJSAY7C_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.usePresenceTracking; }
+  get: function () { return chunkXVJSAY7C_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.useThemeSwitching; }
+  get: function () { return chunkXVJSAY7C_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkHGO243GV_js.useYjsProvider; }
+  get: function () { return chunkXVJSAY7C_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkCNXVOFUW_js.getAnimationInitialStyle; }
+  get: function () { return chunkRE6NDQH7_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.clearAudienceContent; }
+  get: function () { return chunk4VV5HJXQ_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.forgetSessionDeck; }
+  get: function () { return chunk4VV5HJXQ_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.getSessionTabId; }
+  get: function () { return chunk4VV5HJXQ_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.loadAudienceContent; }
+  get: function () { return chunk4VV5HJXQ_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.loadSessionDeck; }
+  get: function () { return chunk4VV5HJXQ_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.rememberSessionDeck; }
+  get: function () { return chunk4VV5HJXQ_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.restoreSessionDeck; }
+  get: function () { return chunk4VV5HJXQ_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunk2CSRCH4H_js.storeAudienceContent; }
+  get: function () { return chunk4VV5HJXQ_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-RQCAXUVQ.mjs';
-import '../chunk-AHJ4ND7Q.mjs';
-export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-DNWIW75I.mjs';
-export { getAnimationInitialStyle } from '../chunk-Q5VQ53R3.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-AIWEM7VE.mjs';
-import '../chunk-CJSIEITL.mjs';
+export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-6PWT46Y4.mjs';
+import '../chunk-QZSA3E4L.mjs';
+export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-VUI3VE7K.mjs';
+export { getAnimationInitialStyle } from '../chunk-KK2CFTKC.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-VUNRFZRR.mjs';
+import '../chunk-33XJSD62.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/dist/viewer/index.mjs.br

@@ -1,2 +1 @@
-�@��\�}�ѺR�vT���P
-;SC�b	�j,���ſ
Y�%�mK���]s9}�.��� ���" /�:ق�!��|��&����/����cYn\�[&�L����o�X�RG�uϗcK�09*�F�[��\i���Ʋ�l���xa�vW5Ə�O'� �mH/�U����#����DXw�����i�
+�@��8��ե�u��vT��7Ra��ΥS��ע(æ�	2�:�w�gے ��ޮ�L��xc�3�.H&n �&ώ<ق�!��t���WT������"I�_�-!FeƋ5O��B�Բ�*nR��y��@��D_Et��r��z�9uY���,�Y��J��<F?�<B��6��W���_Ĥ$¢�\Ƿg��Ens�.��

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "4.15.0",
+	"version": "4.16.1",
 	"description": "pptx-viewer for React: a PowerPoint viewer and editor component to render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",
@@ -120,7 +120,7 @@
 		"dompurify": "^3.4.15",
 		"html2canvas-pro": "^2.4.2",
 		"opentype.js": "^2.0.0",
-		"pptx-viewer-mcp": "^2.5.6",
+		"pptx-viewer-mcp": "^2.5.7",
 		"tailwind-merge": "^3.6.0"
 	},
 	"devDependencies": {