pptx-react-viewer 3.7.0 → 3.8.0

package/dist/viewer/index.d.ts

@@ -2396,7 +2396,38 @@ interface PptxChartDataPointPicture {
 //#region src/core/types/chart-pivot-format.d.ts
 interface PptxChartPivotFormat {
   index: number;
+  /**
+   * Typed projection of `spPr` (fill/stroke colour, stroke width, dash
+   * style). When the parser is given a colour resolver (the normal case: the
+   * runtime always supplies one), both a literal `a:srgbClr` and an
+   * `a:schemeClr` theme reference (with its `lumMod`/`lumOff`/`tint`/`shade`
+   * modifiers) resolve to a hex colour here, the same theme +
+   * `c:clrMapOvr` chain the rest of chart parsing uses. Without a resolver
+   * (e.g. a hand-built `PptxChartPivotFormat` with no theme to resolve
+   * against), only the literal case resolves. Either way the authored node
+   * is byte-preserved through {@link shapePropertiesXml} until this field is
+   * set to something that no longer matches what re-parses off the current
+   * XML; setting it then re-derives `shapePropertiesXml` on save (merged
+   * onto whatever was already authored, keeping an unrelated schemeClr
+   * reference alive when the colour itself is unchanged) unless
+   * `shapePropertiesXml` is set explicitly, which wins.
+   */
+  shapeProperties?: PptxChartShapeProps;
+  /**
+   * Typed projection of `txPr`'s `a:p/a:pPr/a:defRPr` (size/bold/italic/
+   * colour/family), the same shape a legend entry or data-table's text
+   * override models. Colour resolution mirrors {@link shapeProperties}
+   * (theme-resolved `schemeClr` when a colour resolver is supplied, literal
+   * `srgbClr` otherwise). See {@link txPrXml} for the raw fallback.
+   */
+  textStyle?: PptxChartLegendTextStyle;
+  /**
+   * Typed projection of `marker` (symbol/size/spPr). See {@link markerXml}
+   * for the raw fallback.
+   */
+  marker?: PptxChartMarker;
   shapePropertiesXml?: XmlObject | null;
+  txPrXml?: XmlObject | null;
   markerXml?: XmlObject | null;
   dataLabelXml?: XmlObject | null;
   extensionListXml?: XmlObject | null;
@@ -2589,20 +2620,6 @@ interface PptxChartTitleRun {
 }
 //#endregion
 //#region src/core/types/chart-user-shapes.d.ts
-/**
- * Types for chart drawing-overlay shapes (`c:userShapes`).
- *
- * A chart's `c:userShapes` element carries an `r:id` that references a
- * separate drawing part (`ppt/drawings/drawingN.xml`) whose root is a
- * `c:userShapes` element populated with `cdr:relSizeAnchor` /
- * `cdr:absSizeAnchor` wrappers around `sp` / `pic` / `cxnSp` shapes drawn on
- * top of the chart plot. These interfaces describe the parsed, renderable
- * overlay model. The raw reference is preserved separately on
- * {@link PptxChartData.userShapesXml} for verbatim round-trip save; this model
- * is render-only.
- *
- * @module pptx-types/chart-user-shapes
- */
 /** A single paragraph of overlay-shape text with light formatting. */
 interface PptxChartUserShapeParagraph {
   /** Joined run text of the paragraph. */
@@ -2618,6 +2635,80 @@ interface PptxChartUserShapeParagraph {
   /** Paragraph alignment (`a:pPr/@algn`): left / centre / right. */
   align?: 'l' | 'ctr' | 'r';
 }
+/**
+ * The DrawingML 2D group transform (`a:xfrm` inside `cdr:grpSpPr`) that
+ * anchors a `grpSp`'s own box ({@link off}/{@link ext}) and establishes the
+ * coordinate space its children are expressed in ({@link chOff}/{@link
+ * chExt}), all in EMU. A child's position within the group is mapped into
+ * the group's own box via
+ * `frac = (child.off - chOff) / chExt`, then applied to the enclosing
+ * anchor's box; see `flattenChartUserShapes` in
+ * `chart-user-shapes-parser.ts`.
+ */
+interface PptxChartUserShapeGroupTransform {
+  /** The group's own position in its parent's coordinate space, in EMU. */
+  off: {
+    x: number;
+    y: number;
+  };
+  /** The group's own size in its parent's coordinate space, in EMU. */
+  ext: {
+    cx: number;
+    cy: number;
+  };
+  /** Origin of the child coordinate space (`a:chOff`), in EMU. */
+  chOff: {
+    x: number;
+    y: number;
+  };
+  /** Size of the child coordinate space (`a:chExt`), in EMU. */
+  chExt: {
+    cx: number;
+    cy: number;
+  };
+}
+/**
+ * One shape grouped inside a `cdr:grpSp` (or a nested `cdr:grpSp` itself).
+ * Unlike a top-level {@link PptxChartUserShape}, a group child has no
+ * drawing anchor of its own: its position is expressed in its parent
+ * group's child coordinate space via {@link off}/{@link ext} (EMU, read
+ * from the child's own `a:xfrm`), not as a chart-relative fraction.
+ */
+interface PptxChartUserShapeGroupChild {
+  /** Shape kind, same vocabulary as {@link PptxChartUserShape.kind}. */
+  kind: 'sp' | 'cxnSp' | 'pic' | 'grpSp' | 'graphicFrame';
+  /** Position within the parent group's child coordinate space, in EMU. */
+  off: {
+    x: number;
+    y: number;
+  };
+  /** Size within the parent group's child coordinate space, in EMU. */
+  ext: {
+    cx: number;
+    cy: number;
+  };
+  /** Preset geometry name (`a:prstGeom/@prst`), defaulting to `"rect"`. */
+  prst?: string;
+  /** Resolved solid-fill hex colour, when present. */
+  fill?: string;
+  /** Resolved line/stroke hex colour, when present. */
+  stroke?: string;
+  /** Line width in points (`a:ln/@w` divided by 12700), when present. */
+  strokeWidth?: number;
+  /** Text paragraphs of the shape's `txBody`, when present. */
+  paragraphs?: PptxChartUserShapeParagraph[];
+  /**
+   * Verbatim source XML of a `pic`/`graphicFrame` child, or of this node
+   * itself when `kind === 'grpSp'` and the nested group is untouched since
+   * parse. See {@link PptxChartUserShape.rawXml}'s doc for the same
+   * contract one level up.
+   */
+  rawXml?: XmlObject;
+  /** Present when `kind === 'grpSp'`: this nested group's own transform. */
+  transform?: PptxChartUserShapeGroupTransform;
+  /** Present when `kind === 'grpSp'`: this nested group's own children. */
+  children?: PptxChartUserShapeGroupChild[];
+}
 /**
  * A parsed chart-overlay shape positioned by a drawing anchor.
  *
@@ -2628,12 +2719,13 @@ interface PptxChartUserShapeParagraph {
 interface PptxChartUserShape {
   /**
    * Shape kind: text/preset shape, connector, picture, a group of the
-   * above (`grpSp`, flattened: each grouped child becomes its own entry
-   * reusing the anchor's own bounding box, an approximation since the
-   * group's internal chOff/chExt transform is not applied), or a bare
-   * placeholder for a `graphicFrame` anchor child (deep content such as a
-   * nested chart or table is out of scope; it only keeps the anchor's
-   * space accounted for instead of the whole overlay disappearing).
+   * above (`grpSp`, with its own {@link transform} and {@link children},
+   * nested arbitrarily; use `flattenChartUserShapes` from
+   * `chart-user-shapes-parser.ts` to get a flat, render-ready leaf list
+   * with the group transform already applied), or a bare placeholder for
+   * a `graphicFrame` anchor child (deep content such as a nested chart or
+   * table is out of scope; it only keeps the anchor's space accounted for
+   * instead of the whole overlay disappearing).
    */
   kind: 'sp' | 'cxnSp' | 'pic' | 'grpSp' | 'graphicFrame';
   /** Anchor kind that positioned the shape. */
@@ -2663,6 +2755,26 @@ interface PptxChartUserShape {
   strokeWidth?: number;
   /** Text paragraphs of the shape's `txBody`, when present. */
   paragraphs?: PptxChartUserShapeParagraph[];
+  /**
+   * Verbatim source XML of a `pic` or `graphicFrame` anchor child (the
+   * `cdr:pic` / `cdr:graphicFrame` node itself, not the enclosing anchor),
+   * or of the `cdr:grpSp` node itself when `kind === 'grpSp'` and the
+   * group is untouched since parse (byte-identical passthrough). None of
+   * these three kinds have a reconstructable typed representation that is
+   * guaranteed lossless (a picture's blip reference, a nested chart/table's
+   * graphic content, or a group's exact child ordering/ids), so the
+   * serializer re-emits this verbatim when present instead of a lossy
+   * rebuild. Editing a shape inside a group (via the SDK's path-based
+   * overlay operations) clears the group's `rawXml` so the serializer
+   * regenerates it from {@link transform}/{@link children} instead. Absent
+   * for `sp`/`cxnSp`, which round-trip losslessly through their typed
+   * fields above.
+   */
+  rawXml?: XmlObject;
+  /** Present when `kind === 'grpSp'`: the group's own transform. */
+  transform?: PptxChartUserShapeGroupTransform;
+  /** Present when `kind === 'grpSp'`: the grouped children, nested arbitrarily. */
+  children?: PptxChartUserShapeGroupChild[];
 }
 //#endregion
 //#region src/core/types/chart.d.ts
@@ -5815,6 +5927,21 @@ interface PptxAccessibilityProperties {
    */
   isDecorative?: boolean;
 }
+/**
+ * Accessibility description/title from `p:cNvPr/@descr` / `@title` on a
+ * plain shape, text box or connector (`p:sp` / `p:cxnSp`). The same pair of
+ * attributes already round-trips for a graphic frame (see
+ * {@link TablePptxElement.altText}) and, `descr` only, for a picture
+ * ({@link PptxImageProperties.altText}); this mixin extends it to the three
+ * element kinds whose PowerPoint Alt Text pane data was previously dropped
+ * on load because neither field existed on the model.
+ */
+interface PptxNonVisualDescription {
+  /** `p:cNvPr/@descr`. */
+  altText?: string;
+  /** `p:cNvPr/@title`. */
+  title?: string;
+}
 /**
  * `a:cNvPicPr/@preferRelativeResize` (issue G13), a picture-only non-visual
  * property distinct from `a:picLocks`.
@@ -5847,7 +5974,7 @@ interface PptxPictureNonVisualProperties {
  * // => satisfies TextPptxElement
  * ```
  */
-interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'text';
 }
 /**
@@ -5865,7 +5992,7 @@ interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShape
  * // => satisfies ShapePptxElement
  * ```
  */
-interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxCustomPathProperties, PptxAccessibilityProperties {
+interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxCustomPathProperties, PptxAccessibilityProperties, PptxNonVisualDescription {
   type: 'shape';
 }
 /**
@@ -5887,7 +6014,7 @@ interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShap
  * // => satisfies ConnectorPptxElement
  * ```
  */
-interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'connector';
 }
 /**

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunkTUSALM3A_js = require('../chunk-TUSALM3A.js');
-require('../chunk-3EJFZ7TE.js');
-var chunkOBE4TB76_js = require('../chunk-OBE4TB76.js');
-var chunkVIFDZIVX_js = require('../chunk-VIFDZIVX.js');
-var chunkDCNHUEWQ_js = require('../chunk-DCNHUEWQ.js');
-require('../chunk-W24OJ7H5.js');
+var chunk4222CHFH_js = require('../chunk-4222CHFH.js');
+require('../chunk-F5NPGNMA.js');
+var chunkDE3S3UHX_js = require('../chunk-DE3S3UHX.js');
+var chunkQWA5YEIZ_js = require('../chunk-QWA5YEIZ.js');
+var chunkSN5EUDIT_js = require('../chunk-SN5EUDIT.js');
+require('../chunk-L3ZIBQEB.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkTUSALM3A_js.CollaborationProvider; }
+  get: function () { return chunk4222CHFH_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkTUSALM3A_js.CollaborationStatusIndicator; }
+  get: function () { return chunk4222CHFH_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkTUSALM3A_js.PowerPointViewer; }
+  get: function () { return chunk4222CHFH_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkTUSALM3A_js.RemoteUserCursors; }
+  get: function () { return chunk4222CHFH_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkTUSALM3A_js.UserAvatarBar; }
+  get: function () { return chunk4222CHFH_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkOBE4TB76_js.isAudienceTab; }
+  get: function () { return chunkDE3S3UHX_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkOBE4TB76_js.parseAudienceNonce; }
+  get: function () { return chunkDE3S3UHX_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkOBE4TB76_js.useCollaborativeHistory; }
+  get: function () { return chunkDE3S3UHX_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkOBE4TB76_js.useCollaborativeState; }
+  get: function () { return chunkDE3S3UHX_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkOBE4TB76_js.usePresenceTracking; }
+  get: function () { return chunkDE3S3UHX_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkOBE4TB76_js.useThemeSwitching; }
+  get: function () { return chunkDE3S3UHX_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkOBE4TB76_js.useYjsProvider; }
+  get: function () { return chunkDE3S3UHX_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkVIFDZIVX_js.getAnimationInitialStyle; }
+  get: function () { return chunkQWA5YEIZ_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.clearAudienceContent; }
+  get: function () { return chunkSN5EUDIT_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.forgetSessionDeck; }
+  get: function () { return chunkSN5EUDIT_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.getSessionTabId; }
+  get: function () { return chunkSN5EUDIT_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.loadAudienceContent; }
+  get: function () { return chunkSN5EUDIT_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.loadSessionDeck; }
+  get: function () { return chunkSN5EUDIT_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.rememberSessionDeck; }
+  get: function () { return chunkSN5EUDIT_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.restoreSessionDeck; }
+  get: function () { return chunkSN5EUDIT_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkDCNHUEWQ_js.storeAudienceContent; }
+  get: function () { return chunkSN5EUDIT_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-TXY2E7VQ.mjs';
-import '../chunk-WKODF5ZU.mjs';
-export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-PC62KGU3.mjs';
-export { getAnimationInitialStyle } from '../chunk-JANUSAEK.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-NV55GU5V.mjs';
-import '../chunk-FGTMS7LR.mjs';
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-PFPKBNNZ.mjs';
+import '../chunk-RNP5HP4L.mjs';
+export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-UPJW34YG.mjs';
+export { getAnimationInitialStyle } from '../chunk-RHWQKZLB.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-6IMB5DNJ.mjs';
+import '../chunk-FRZIBZTE.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "3.7.0",
+	"version": "3.8.0",
 	"description": "React PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",
@@ -78,7 +78,7 @@
 		"clsx": "^2.1.1",
 		"dompurify": "^3.4.14",
 		"html2canvas-pro": "^2.3.2",
-		"pptx-viewer-mcp": "^2.2.0",
+		"pptx-viewer-mcp": "^2.3.0",
 		"tailwind-merge": "^3.6.0"
 	},
 	"devDependencies": {

package/dist/Area3DChartScene-AE2XYKDW.mjs.br

@@ -1 +0,0 @@
-[ "���_SM�A� ?~s�v��c�gt7c7B�%C2vmԖW��	�jT�%\�&RSy|yn?[����n>q4��C��9o,1�\Fx.e}��J���n����� ~Ĵ��h��r�w]��z7����E�}��:sr�����h�o�({���$���ǧ*���x��/"�D�z��K��8

package/dist/Bar3DChartScene-FQV62XOI.mjs.br

@@ -1,2 +0,0 @@
-W ��Vw�"ZS�FMx/�`	�m93'�G���^�?쀉z[B��ZZH�}:�9��I
-�d�0G���(;� ��/�?�~��t�֏�αf Pj����f�i�"B�KY_=_ɽ�x��E�"���V/�B�]Ż�t5.G���);��s�?��n�����i0;owB�T�`c��{*�

package/dist/Line3DChartScene-FEUY3PCE.mjs.br

@@ -1 +0,0 @@
-[ "���_SM�A� ?~s�v��c�gt7c7B�%C2vmԖW��	�jT�%\�&RSy|yn?[����n>q4��C��9o,1�\Fx.e}��J���n����� ~Ĵ��h��r�w]��z7����E�}��:sr�����h�o�({���$���ǧ*���x��/"�D�z��K��8