pptx-react-viewer 3.19.1 → 3.20.0

package/dist/viewer/index.d.ts

@@ -937,6 +937,13 @@ interface ShapeStyle {
   fillImageUrl?: string;
   /** How the image is sized within the shape: stretch to fill, or tile/repeat. */
   fillImageMode?: 'stretch' | 'tile';
+  /** Whether the image fill rotates/flips with the shape (`a:blipFill/@rotWithShape`).
+   *  Defaults to true per the schema; preserved for round-trip when the source
+   *  authored the attribute explicitly. When false, the shape's own geometry
+   *  (clip-path/outline) still carries the shape's rotation/flip, but the
+   *  picture content inside stays fixed to the page frame (upright), matching
+   *  PowerPoint. See `pptx-viewer-shared`'s `getImageFillCounterTransform`. */
+  fillImageRotWithShape?: boolean;
   fillGradientStops?: Array<{
     color: string;
     position: number;
@@ -2397,6 +2404,13 @@ type PptxChartPictureFormat = 'stretch' | 'stack' | 'stackScale';
  * "Picture or texture fill" with "Stack"/"Stretch" semantics on a bar/column
  * data point, distinct from the point's plain `c:spPr` solid/gradient fill.
  *
+ * `c:pictureOptions` is optional: a point/series whose `c:spPr` carries a bare
+ * `a:blipFill` with NO `c:pictureOptions` sibling at all is still a fully
+ * legal, common picture fill (PowerPoint's own default "stretch, no stack"
+ * when the format pane never touched the stack settings); `parseChartDataPointPicture`
+ * synthesizes this descriptor (`pictureFormat: 'stretch'`) in that case so the
+ * SAME render pipeline resolves it, rather than silently dropping the fill.
+ *
  * The flags parse purely (`parseChartDataPointPicture` in
  * `utils/chart-datapoint-serializer.ts`); {@link imageUrl} is a separate,
  * later addition populated by the runtime (`PptxHandlerRuntimeChartParsing.ts`)
@@ -2422,6 +2436,12 @@ interface PptxChartDataPointPicture {
    * when the point has no picture fill or the image could not be resolved.
    */
   imageUrl?: string;
+  /**
+   * Effective opacity (0-1) from the blip's `a:alphaModFix/@amt` (a
+   * thousandths-of-a-percent value, so `amt="60000"` is `0.6`). `undefined`
+   * when the blip carries no `alphaModFix`, meaning fully opaque.
+   */
+  opacity?: number;
 }
 //#endregion
 //#region src/core/types/chart-pivot-format.d.ts
@@ -3075,6 +3095,17 @@ interface PptxChartDataPoint {
   bubble3D?: boolean;
   /** Per-point picture-fill flags (`c:dPt/c:pictureOptions`). */
   picture?: PptxChartDataPointPicture;
+  /**
+   * A picture fill implied by a bare `c:dPt/c:spPr/a:blipFill` with NO
+   * sibling `c:pictureOptions` at all: still a fully legal "stretch, no
+   * stack" picture fill, just one PowerPoint's format pane never touched the
+   * stack settings for. Render-derived only: unlike {@link picture}, this is
+   * never written back on save (the original, untouched `c:spPr` already
+   * round-trips verbatim), so populating it can never desync the saved file
+   * from what was authored. See `chart-datapoint-picture.ts`'s
+   * `parseImplicitBlipPictureFill`.
+   */
+  impliedPicture?: PptxChartDataPointPicture;
   /**
    * This point's identity GUID (`c:dPt/c:extLst/c:ext/c16:uniqueId/@val`,
    * the Office 2014+ `{C3380CC4-5D6E-409C-BE32-E72D297353CC}` chart
@@ -3336,6 +3367,17 @@ interface PptxChartTreemapOptions {
  */
 interface PptxChartSeries {
   name: string;
+  /**
+   * This series' own `c:ser/c:idx/@val`. PowerPoint keys per-series identity
+   * (data-point picking, and the automatic marker-symbol cycle when no
+   * `c:marker/c:symbol` is authored) off this value, NOT off the series'
+   * position in this array: a series can be reordered (`c:order`) without its
+   * `idx` changing, and a chart with a deleted/filtered series leaves a gap
+   * (e.g. idx 1, 2 with no idx 0). Absent only for chart kinds this parser
+   * does not tag (rare); render code that needs it should fall back to the
+   * array position.
+   */
+  idx?: number;
   values: number[];
   /**
    * Per-series x values from `c:ser/c:xVal` (scatter and bubble series only).
@@ -3441,6 +3483,13 @@ interface PptxChartSeries {
    * when the point has none of its own.
    */
   picture?: PptxChartDataPointPicture;
+  /**
+   * A picture fill implied by a bare `c:ser/c:spPr/a:blipFill` with NO
+   * sibling `c:pictureOptions` at all. See
+   * {@link PptxChartDataPoint.impliedPicture}'s doc comment: same
+   * render-only, never-serialized-back convention, at the series level.
+   */
+  impliedPicture?: PptxChartDataPointPicture;
   /**
    * This series' identity GUID (`c:ser/c:extLst/c:ext/c16:uniqueId/@val`,
    * the Office 2014+ `{C3380CC4-5D6E-409C-BE32-E72D297353CC}` chart
@@ -3479,6 +3528,24 @@ interface PptxChartFilteredSeries {
   values?: number[];
   /** This hidden series' own identity GUID (`c16:uniqueId`), when present. */
   uniqueId?: string;
+  /**
+   * A full snapshot of the series as it looked the moment it was hidden
+   * (`render/chart-ext-editor-actions.ts`'s `hideChartSeries`), so
+   * `restoreFilteredSeries` can bring it back exactly as it was: full fill/
+   * line formatting, marker, data-label options, everything, not just the
+   * bare name/values/idx the other fields above capture.
+   *
+   * NOT derived from XML and NEVER written to disk (the save writer,
+   * `chart-filtered-series-writer.ts`, only reads the named fields above):
+   * this exists purely for the live "Chart Filters" hide/show round-trip
+   * within one editing session. A filtered series read from an actually
+   * parsed file (one that was already hidden when opened) has no snapshot
+   * to draw on, since real PowerPoint's `c15:ser` node is parsed only for
+   * the fields above (`chart-filtered-series.ts`'s `parseOneFilteredSeries`);
+   * `restoreFilteredSeries` falls back to reconstructing a bare series from
+   * those for that case, same as before this field existed.
+   */
+  originalSeries?: PptxChartSeries;
 }
 /**
  * Chart-level data-label options (`c:dLbls` directly under a chart-type
@@ -3589,6 +3656,14 @@ interface PptxChartStyle {
   legendPosition?: string;
   /** Per-series visibility and text-style overrides. */
   legendEntries?: PptxChartLegendEntry[];
+  /**
+   * The legend's own default text style (`c:legend/c:txPr`), falling back to
+   * the chart-wide default (`c:chartSpace/c:txPr`) when the legend has none
+   * of its own. Applies to every legend entry that has no per-entry
+   * `c:legendEntry/c:txPr` override (see {@link PptxChartLegendEntry.textStyle}),
+   * which always wins over this chart-level default.
+   */
+  legendTextStyle?: PptxChartLegendTextStyle;
   /** Whether the chart has a title. */
   hasTitle?: boolean;
   /** Whether gridlines are visible. */

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunkZHPBQVBK_js = require('../chunk-ZHPBQVBK.js');
-require('../chunk-YVZKXCML.js');
-var chunkAZEDCITO_js = require('../chunk-AZEDCITO.js');
-var chunk4WUGOCYU_js = require('../chunk-4WUGOCYU.js');
-var chunkEJSRXEXA_js = require('../chunk-EJSRXEXA.js');
-require('../chunk-BRJN3ZMG.js');
+var chunk7SFA4A2E_js = require('../chunk-7SFA4A2E.js');
+require('../chunk-WRXXPCZ7.js');
+var chunkW3RBIIZW_js = require('../chunk-W3RBIIZW.js');
+var chunkDW66NEST_js = require('../chunk-DW66NEST.js');
+var chunkNGWA6L3N_js = require('../chunk-NGWA6L3N.js');
+require('../chunk-I5LPYESF.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkZHPBQVBK_js.CollaborationProvider; }
+  get: function () { return chunk7SFA4A2E_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkZHPBQVBK_js.CollaborationStatusIndicator; }
+  get: function () { return chunk7SFA4A2E_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkZHPBQVBK_js.PowerPointViewer; }
+  get: function () { return chunk7SFA4A2E_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkZHPBQVBK_js.RemoteUserCursors; }
+  get: function () { return chunk7SFA4A2E_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkZHPBQVBK_js.UserAvatarBar; }
+  get: function () { return chunk7SFA4A2E_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkAZEDCITO_js.isAudienceTab; }
+  get: function () { return chunkW3RBIIZW_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkAZEDCITO_js.parseAudienceNonce; }
+  get: function () { return chunkW3RBIIZW_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkAZEDCITO_js.useCollaborativeHistory; }
+  get: function () { return chunkW3RBIIZW_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkAZEDCITO_js.useCollaborativeState; }
+  get: function () { return chunkW3RBIIZW_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkAZEDCITO_js.usePresenceTracking; }
+  get: function () { return chunkW3RBIIZW_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkAZEDCITO_js.useThemeSwitching; }
+  get: function () { return chunkW3RBIIZW_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkAZEDCITO_js.useYjsProvider; }
+  get: function () { return chunkW3RBIIZW_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunk4WUGOCYU_js.getAnimationInitialStyle; }
+  get: function () { return chunkDW66NEST_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.clearAudienceContent; }
+  get: function () { return chunkNGWA6L3N_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.forgetSessionDeck; }
+  get: function () { return chunkNGWA6L3N_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.getSessionTabId; }
+  get: function () { return chunkNGWA6L3N_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.loadAudienceContent; }
+  get: function () { return chunkNGWA6L3N_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.loadSessionDeck; }
+  get: function () { return chunkNGWA6L3N_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.rememberSessionDeck; }
+  get: function () { return chunkNGWA6L3N_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.restoreSessionDeck; }
+  get: function () { return chunkNGWA6L3N_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkEJSRXEXA_js.storeAudienceContent; }
+  get: function () { return chunkNGWA6L3N_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-Z3KMGLXL.mjs';
-import '../chunk-LBKKSCVS.mjs';
-export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-DNQ3PGGU.mjs';
-export { getAnimationInitialStyle } from '../chunk-RCUPQJVY.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-3KVLOKA6.mjs';
-import '../chunk-MQUTXOET.mjs';
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-2IBDKMY2.mjs';
+import '../chunk-AYH6XSE7.mjs';
+export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-5PDGHTRJ.mjs';
+export { getAnimationInitialStyle } from '../chunk-FE4L26FT.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-N4FLKADC.mjs';
+import '../chunk-AVTH627G.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

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