pptx-react-viewer 3.19.1 → 3.20.0

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-Z3KMGLXL.mjs';
-import './chunk-LBKKSCVS.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-DNQ3PGGU.mjs';
-export { getAnimationInitialStyle } from './chunk-RCUPQJVY.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-3KVLOKA6.mjs';
-export { LOCALE_CATALOG } from './chunk-MQUTXOET.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-2IBDKMY2.mjs';
+import './chunk-AYH6XSE7.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-5PDGHTRJ.mjs';
+export { getAnimationInitialStyle } from './chunk-FE4L26FT.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-N4FLKADC.mjs';
+export { LOCALE_CATALOG } from './chunk-AVTH627G.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/internals.d.ts

@@ -935,6 +935,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;
@@ -2395,6 +2402,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`)
@@ -2420,6 +2434,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
@@ -3073,6 +3093,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
@@ -3334,6 +3365,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).
@@ -3439,6 +3481,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
@@ -3477,6 +3526,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
@@ -3587,6 +3654,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. */