pptx-react-viewer 3.1.5 → 3.2.0

package/dist/viewer/index.d.ts

@@ -223,6 +223,12 @@ interface PptxShapeLocks {
    * `a:spLocks` / `a:picLocks` / `a:cxnSpLocks` / `a:grpSpLocks`.
    */
   noDrilldown?: boolean;
+  /**
+   * `a:picLocks/@noCrop`: forbids cropping the picture. Declared ONLY by
+   * `CT_PictureLocking`, so it is written for pictures (and media authored as
+   * a `p:pic`) and never onto the other lock elements.
+   */
+  noCrop?: boolean;
   /**
    * Text-box flag from `p:cNvSpPr/@txBox`. Not a lock in the strict sense,
    * but it lives on the same non-visual-properties node as `a:spLocks`, so
@@ -2164,13 +2170,32 @@ interface PlaceholderTextLevelStyle {
   bulletSizePercent?: number;
   /** Bullet colour from `a:buClr` as hex string. */
   bulletColor?: string;
+  /**
+   * The colour-choice node inside `a:buClr` this level's {@link bulletColor}
+   * resolved from (`a:schemeClr` / `a:sysClr` / `a:prstClr` / `a:srgbClr`,
+   * transforms included), mirroring `BulletInfo.colorXml`. Re-emitted
+   * verbatim on save so a themed bullet is not downgraded to a literal
+   * `a:srgbClr`. Absent when the level declares no bullet colour.
+   */
+  bulletColorXml?: XmlObject;
   /** Bullet size in points from `a:buSzPts`. */
   bulletSizePts?: number;
   /** True when `a:buNone` is present at this level. */
   bulletNone?: boolean;
   marginLeft?: number;
+  /** Paragraph right margin in px (from `@_marR` EMU). */
+  marginRight?: number;
   indent?: number;
+  /**
+   * Paragraph alignment as a `TextStyle['align']` token (`left`, `center`,
+   * `right`, `justify`, `justLow`, `dist`, `thaiDist`), never the raw OOXML
+   * `@algn` value.
+   */
   alignment?: string;
+  /** Right-to-left paragraph direction (`@rtl`). */
+  rtl?: boolean;
+  /** Tab stops from `a:tabLst/a:tab` (positions in px). */
+  tabStops?: TextStyle['tabStops'];
   lineSpacing?: number;
   lineSpacingExactPt?: number;
   spaceBefore?: number;
@@ -2396,6 +2421,20 @@ type PptxChartType = 'bar' | 'line' | 'pie' | 'ofPie' | 'doughnut' | 'area' | 's
  * ```
  */
 type PptxChartBarDirection = 'col' | 'bar';
+/**
+ * 3-D bar/column shape (OOXML `ST_Shape`, `c:bar3DChart/c:shape/@val` or a
+ * per-series `c:ser/c:shape` override). `coneToMax` / `pyramidToMax` scale
+ * the cone/pyramid so it reaches full height at the value axis maximum,
+ * appearing truncated below it; the plain `cone`/`pyramid` always come to a
+ * full point at the bar's own value.
+ *
+ * @example
+ * ```ts
+ * const shape: PptxBar3DShape = "cylinder";
+ * // => "cylinder", one of: "box" | "cone" | "coneToMax" | "cylinder" | "pyramid" | "pyramidToMax"
+ * ```
+ */
+type PptxBar3DShape = 'box' | 'cone' | 'coneToMax' | 'cylinder' | 'pyramid' | 'pyramidToMax';
 /**
  * Supported trendline regression types.
  *
@@ -2824,6 +2863,12 @@ interface PptxChartSeries {
    * series.
    */
   seriesChartType?: PptxChartType;
+  /**
+   * Per-series 3-D bar/column shape override (`c:ser/c:shape`), legal only
+   * inside a bar3D chart-type container. Overrides {@link PptxChartData.barShape}
+   * for this series alone.
+   */
+  shape?: PptxBar3DShape;
   boxWhiskerOptions?: PptxChartBoxWhiskerOptions;
   histogramOptions?: PptxChartHistogramOptions;
   waterfallOptions?: PptxChartWaterfallOptions;
@@ -3125,6 +3170,28 @@ interface PptxChartData {
    * default), so only horizontal bar charts need to carry the field.
    */
   barDirection?: PptxChartBarDirection;
+  /**
+   * 3-D bar/column shape (`c:bar3DChart/c:shape/@val`). Bar3D only; a plain
+   * bar chart has no `c:shape` element. A per-series `c:ser/c:shape`
+   * ({@link PptxChartSeries.shape}) overrides this for that series.
+   */
+  barShape?: PptxBar3DShape;
+  /**
+   * Radar chart drawing style (`c:radarChart/c:radarStyle/@val`). `standard`
+   * draws an outline only, `marker` adds markers at each vertex (PowerPoint's
+   * own default for every radar chart it authors), and `filled` paints the
+   * enclosed polygon with the series fill and omits markers. Radar only.
+   */
+  radarStyle?: 'standard' | 'marker' | 'filled';
+  /**
+   * Whether a surface chart renders as a wireframe grid rather than a solid
+   * coloured surface (`c:surfaceChart/c:wireframe/@val` or
+   * `c:surface3DChart/c:wireframe/@val`, both modeled as chart type
+   * `"surface"`). A `CT_Boolean` element: absent from the source XML
+   * defaults to `true` per schema, so `undefined` here means "not present in
+   * the source" and callers should treat it as `true`. Surface only.
+   */
+  wireframe?: boolean;
   /**
    * Scatter presentation mode (`c:scatterChart/c:scatterStyle/@val`).
    *
@@ -3322,6 +3389,26 @@ interface PptxBackgroundRemovalMark {
  * // => retains the middle of the image; the marks list stays empty
  * ```
  */
+/**
+ * Snapshot of the a14 Corrections / Color panel values as they were read from
+ * the file, kept on {@link PptxImageEffects.prerenderedCorrections} so a
+ * renderer can tell a baked-in value from one changed in this library.
+ */
+interface PptxImagePrerenderedCorrections {
+  sharpenSoften?: {
+    amount: number;
+  };
+  brightnessContrast?: {
+    bright?: number;
+    contrast?: number;
+  };
+  colorTemperature?: {
+    colorTemp: number;
+  };
+  colorSaturation?: {
+    sat: number;
+  };
+}
 interface PptxBackgroundRemoval {
   /** Top edge of the retained rectangle (0..1 fraction of the image height). */
   top: number;
@@ -3388,18 +3475,71 @@ interface PptxImageEffects {
    */
   backgroundRemoval?: PptxBackgroundRemoval;
   /**
-   * `a14:imgLayer/@r:embed` — relationship id of the PRISTINE original image
+   * `a14:imgLayer/@r:embed`: relationship id of the PRISTINE original image
    * the baked effects were derived from (PowerPoint stores it as an HD Photo
    * `.wdp` part, which browsers cannot decode).
    */
   originalImageRelId?: string;
+  /**
+   * PowerPoint 2010+ Corrections panel "Sharpen/Soften"
+   * (`a14:sharpenSoften/@amount`). Raw as the XML carries it: 1/1000ths of a
+   * percent, `-100000` (fully softened) .. `100000` (fully sharpened).
+   * Edit-time metadata like the artistic effects: PowerPoint bakes the result
+   * into the stored bitmap.
+   */
+  sharpenSoften?: {
+    amount: number;
+  };
+  /**
+   * PowerPoint 2010+ Corrections panel "Brightness/Contrast"
+   * (`a14:brightnessContrast/@bright`, `@contrast`). Raw 1/1000ths of a
+   * percent, `-100000` .. `100000`. Distinct from the legacy `a:blip/@bright`
+   * + `@contrast` pair in {@link PptxImageEffects.brightness} /
+   * {@link PptxImageEffects.contrast}, which PowerPoint 2007 wrote and which
+   * a renderer still applies.
+   */
+  brightnessContrast?: {
+    bright?: number;
+    contrast?: number;
+  };
+  /**
+   * PowerPoint 2010+ Color panel "Color Tone"
+   * (`a14:colorTemperature/@colorTemp`). Raw Kelvin value, `1500` .. `11500`;
+   * `6500` is neutral.
+   */
+  colorTemperature?: {
+    colorTemp: number;
+  };
+  /**
+   * PowerPoint 2010+ Color panel "Color Saturation" (`a14:saturation/@sat`).
+   * Raw 1/1000ths of a percent: `100000` is unchanged, `0` is grayscale,
+   * `400000` the maximum. Named `colorSaturation` because
+   * {@link PptxImageEffects.saturation} is the viewer-side -100..100 knob
+   * that has no OOXML counterpart.
+   */
+  colorSaturation?: {
+    sat: number;
+  };
+  /**
+   * The Corrections / Color panel values ALREADY baked into the image data,
+   * which a renderer must not apply a second time. The a14 counterpart of
+   * {@link PptxImageEffects.artisticPrerenderedEffect}: PowerPoint writes the
+   * corrected bitmap to the main `a:blip` and keeps the pristine original in
+   * `a14:imgLayer` (measured on a real deck: the stored PNG is a monotone tonal
+   * transform of the `.wdp` original, slope 0.7 for `contrast="-40000"`).
+   *
+   * Holds the VALUES rather than a boolean so that changing one of the four
+   * fields in this library's inspector still renders: a field that differs
+   * from its snapshot is applied, one that matches is skipped.
+   */
+  prerenderedCorrections?: PptxImagePrerenderedCorrections;
   /** Alpha modulation fixed: non-negative percentage (100 means unchanged opacity). */
   alphaModFix?: number;
   /** Original alpha modulation fixed node, including foreign attributes. */
   alphaModFixRawXml?: XmlObject;
-  /** Bi-level threshold — converts to 1-bit black/white (0-100). */
+  /** Bi-level threshold: converts to 1-bit black/white (0-100). */
   biLevel?: number;
-  /** Colour change — swap one colour range for another (used for transparency keying). */
+  /** Colour change: swap one colour range for another (used for transparency keying). */
   clrChange?: {
     clrFrom: string;
     clrTo: string;
@@ -3422,11 +3562,11 @@ interface PptxImageEffects {
     /** Original effect XML, including colour transforms and foreign attributes. */
     rawXml?: XmlObject;
   };
-  /** Alpha ceiling (`a:alphaCeiling`) — clamps any non-zero alpha to fully opaque. Boolean flag. */
+  /** Alpha ceiling (`a:alphaCeiling`): clamps any non-zero alpha to fully opaque. Boolean flag. */
   alphaCeiling?: boolean;
   /** Original alpha ceiling node, including foreign attributes. */
   alphaCeilingRawXml?: XmlObject;
-  /** Alpha floor (`a:alphaFloor`) — clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
+  /** Alpha floor (`a:alphaFloor`): clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
   alphaFloor?: boolean;
   /** Original alpha floor node, including foreign attributes. */
   alphaFloorRawXml?: XmlObject;
@@ -3450,16 +3590,16 @@ interface PptxImageEffects {
      */
     amt?: number;
   };
-  /** Alpha replace (`a:alphaRepl`) — replaces alpha with the given fixed-percent value (0..100). */
+  /** Alpha replace (`a:alphaRepl`): replaces alpha with the given fixed-percent value (0..100). */
   alphaRepl?: number;
   /** Original alpha replace node, including foreign attributes. */
   alphaReplRawXml?: XmlObject;
-  /** Alpha bi-level (`a:alphaBiLevel`) — threshold (0..100) above which alpha becomes fully opaque. */
+  /** Alpha bi-level (`a:alphaBiLevel`): threshold (0..100) above which alpha becomes fully opaque. */
   alphaBiLevel?: number;
   /** Original alpha bi-level node, including foreign attributes. */
   alphaBiLevelRawXml?: XmlObject;
   /**
-   * Colour replace (`a:clrRepl`) — replaces all colour information in an image
+   * Colour replace (`a:clrRepl`): replaces all colour information in an image
    * with the given solid colour. Stores the raw colour child to preserve scheme
    * colour references and modifiers.
    */
@@ -3469,24 +3609,24 @@ interface PptxImageEffects {
     /** Raw opaque colour XML for round-trip. */
     rawXml?: Record<string, unknown>;
   };
-  /** Luminance modulation (`a:lum`) — bright/contrast as fixed percentages (0..100). */
+  /** Luminance modulation (`a:lum`): bright/contrast as fixed percentages (0..100). */
   lum?: {
     bright?: number;
     contrast?: number;
   };
-  /** HSL modulation (`a:hsl`) — hue (0..360 degrees), saturation/luminance (-100..100). */
+  /** HSL modulation (`a:hsl`): hue (0..360 degrees), saturation/luminance (-100..100). */
   hsl?: {
     hue?: number;
     sat?: number;
     lum?: number;
   };
-  /** Image-effect tint (`a:tint` inside blip) — hue (0..360), amount (-100..100). */
+  /** Image-effect tint (`a:tint` inside blip): hue (0..360), amount (-100..100). */
   tint?: {
     hue?: number;
     amt?: number;
   };
   /**
-   * Fill overlay (`a:fillOverlay`) — overlays a fill on top of the blip.
+   * Fill overlay (`a:fillOverlay`): overlays a fill on top of the blip.
    * Stores blend mode and the raw inner fill XML for round-trip.
    */
   fillOverlay?: {
@@ -3528,7 +3668,7 @@ interface PptxImageEffects {
       background?: string;
     };
   };
-  /** Blur (`a:blur`) — radius in EMU and grow flag. */
+  /** Blur (`a:blur`): radius in EMU and grow flag. */
   blur?: {
     rad?: number;
     grow?: boolean;
@@ -3540,12 +3680,12 @@ interface PptxImageEffects {
  * @example
  * ```ts
  * const shape: PptxCropShape = "ellipse";
- * // => "ellipse" — one of: none | ellipse | roundedRect | triangle | diamond | pentagon | hexagon | star
+ * // => "ellipse": one of: none | ellipse | roundedRect | triangle | diamond | pentagon | hexagon | star
  * ```
  */
 type PptxCropShape = 'none' | 'ellipse' | 'roundedRect' | 'triangle' | 'diamond' | 'pentagon' | 'hexagon' | 'star';
 /**
- * Image content mixin — present on image and picture elements.
+ * Image content mixin: present on image and picture elements.
  *
  * Contains the decoded image data (base64 data URL or archive path),
  * alt text, crop insets, tiling settings, and image effects.
@@ -3615,7 +3755,16 @@ interface PptxImageProperties {
   dpi?: number;
   /** Image recolour/artistic effect properties. */
   imageEffects?: PptxImageEffects;
-  /** Crop-to-shape — CSS clip-path shape name. */
+  /**
+   * Crop-to-shape (CSS clip-path shape name).
+   *
+   * PowerPoint implements "Crop to Shape" by writing the picture's own
+   * `a:prstGeom`, so this is a typed view over `shapeType`: on load it is
+   * derived from the preset (`ellipse` -> `'ellipse'`, `roundRect` ->
+   * `'roundedRect'`, `star5` -> `'star'`, ...; see
+   * `utils/crop-shape-geometry`), and on save a changed value rewrites the
+   * preset. `'none'` / `undefined` leaves the geometry alone.
+   */
   cropShape?: PptxCropShape;
 }
 //#endregion
@@ -7532,7 +7681,11 @@ interface PptxSlide {
    */
   slideId?: string;
   sourceSlideId?: string;
-  /** Optional author-supplied slide name (set via `SlideBuilder.setName`). */
+  /**
+   * The slide name, `p:cSld/@name`: loaded from the part, written back on
+   * save (an empty string clears the attribute), and settable via
+   * `SlideBuilder.setName`.
+   */
   name?: string;
   layoutPath?: string;
   layoutName?: string;

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunkZPF4L6SD_js = require('../chunk-ZPF4L6SD.js');
-require('../chunk-LGVNUG3G.js');
-var chunkLXYDXLKZ_js = require('../chunk-LXYDXLKZ.js');
-var chunkT2QG2HD5_js = require('../chunk-T2QG2HD5.js');
-var chunkYDEEINER_js = require('../chunk-YDEEINER.js');
-require('../chunk-SWRY3SI5.js');
+var chunkRRAL4Y7V_js = require('../chunk-RRAL4Y7V.js');
+require('../chunk-Q52HT4EZ.js');
+var chunkARQGUUYU_js = require('../chunk-ARQGUUYU.js');
+var chunkB6UIVRFA_js = require('../chunk-B6UIVRFA.js');
+var chunkFJDZ7AEE_js = require('../chunk-FJDZ7AEE.js');
+require('../chunk-ALO4ZOHQ.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkZPF4L6SD_js.CollaborationProvider; }
+  get: function () { return chunkRRAL4Y7V_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkZPF4L6SD_js.CollaborationStatusIndicator; }
+  get: function () { return chunkRRAL4Y7V_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkZPF4L6SD_js.PowerPointViewer; }
+  get: function () { return chunkRRAL4Y7V_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkZPF4L6SD_js.RemoteUserCursors; }
+  get: function () { return chunkRRAL4Y7V_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkZPF4L6SD_js.UserAvatarBar; }
+  get: function () { return chunkRRAL4Y7V_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkLXYDXLKZ_js.isAudienceTab; }
+  get: function () { return chunkARQGUUYU_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkLXYDXLKZ_js.parseAudienceNonce; }
+  get: function () { return chunkARQGUUYU_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkLXYDXLKZ_js.useCollaborativeHistory; }
+  get: function () { return chunkARQGUUYU_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkLXYDXLKZ_js.useCollaborativeState; }
+  get: function () { return chunkARQGUUYU_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkLXYDXLKZ_js.usePresenceTracking; }
+  get: function () { return chunkARQGUUYU_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkLXYDXLKZ_js.useThemeSwitching; }
+  get: function () { return chunkARQGUUYU_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkLXYDXLKZ_js.useYjsProvider; }
+  get: function () { return chunkARQGUUYU_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkT2QG2HD5_js.getAnimationInitialStyle; }
+  get: function () { return chunkB6UIVRFA_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.clearAudienceContent; }
+  get: function () { return chunkFJDZ7AEE_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.forgetSessionDeck; }
+  get: function () { return chunkFJDZ7AEE_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.getSessionTabId; }
+  get: function () { return chunkFJDZ7AEE_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.loadAudienceContent; }
+  get: function () { return chunkFJDZ7AEE_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.loadSessionDeck; }
+  get: function () { return chunkFJDZ7AEE_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.rememberSessionDeck; }
+  get: function () { return chunkFJDZ7AEE_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.restoreSessionDeck; }
+  get: function () { return chunkFJDZ7AEE_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkYDEEINER_js.storeAudienceContent; }
+  get: function () { return chunkFJDZ7AEE_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-P3VXXUZM.mjs';
-import '../chunk-QOLYY7E3.mjs';
-export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-A2UAUSJM.mjs';
-export { getAnimationInitialStyle } from '../chunk-BPWSJLLG.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-XIHK52SB.mjs';
-import '../chunk-ARJE3V6V.mjs';
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-PPNXPEEZ.mjs';
+import '../chunk-RX6FE24O.mjs';
+export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-UHR7EYFM.mjs';
+export { getAnimationInitialStyle } from '../chunk-FMEEIS6L.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-G7UBIKAG.mjs';
+import '../chunk-RHSA5BW5.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

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

package/dist/SurfaceChart3DScene-CRUGJSCY.mjs.br

@@ -1 +0,0 @@
-i ��Nu�HI�\�i�9od��(3�T@Џ�_v��n+el`ѫP��N�WI!P93�p�/M�~�!�@�c���e��mn�j�~=���j#�o�ݗ�˖P��+�|�]�>ym�[g�D��E�hqh��w=�G����Ubc5��V�$s�_�տ&�]�fo}mnIq��t�֔cG�o"�TZz��KJW�?
W