pptx-react-viewer 4.7.0 → 4.8.0

package/dist/viewer/index.d.ts

@@ -1297,6 +1297,27 @@ interface ShapeStyle {
    * `authored-shape-style.ts`'s `effectIsPurelyStyleMatrix`.
    */
   inheritedEffectStyle?: ShapeStyle;
+  /**
+   * Set by a style-matrix pick (the Shape Styles gallery): the shape's own
+   * `spPr` fill, outline and effects were replaced by `<p:style>`, so the
+   * writer clears whatever the retained `spPr` still authored before it
+   * writes the (now reference-owned) style. Never parsed; editor state only.
+   */
+  styleMatrixReset?: boolean;
+}
+/**
+ * The result of resolving a `<p:style>` block against the loaded theme.
+ *
+ * `shapeStyle` is exactly what the load pipeline would have produced for a
+ * shape whose `spPr` authors nothing and whose `<p:style>` is `styleXml`:
+ * the flat fill/outline/effect values a renderer needs, the reference indices
+ * and colours the writer re-emits, and the inheritance baselines that tell the
+ * writer to leave `spPr` empty while the flat values still agree with them.
+ */
+interface ResolvedStyleMatrix {
+  shapeStyle: ShapeStyle;
+  /** The text colour `<a:fontRef>` names, resolved to hex. */
+  fontColor?: string;
 }
 //#endregion
 //#region src/core/types/text.d.ts
@@ -2271,6 +2292,22 @@ interface TextSegment {
    * Used by the renderer to apply font family, colour, etc. to the `<rt>` element.
    */
   rubyStyle?: TextStyle;
+  /**
+   * The parsed `a:rubyPr` node, kept verbatim so its attributes (`hps`,
+   * `hpsRaise`, `hpsBaseText`, `lid`, ...) round-trip exactly; only an
+   * edited {@link rubyAlignment} is written over it on save.
+   */
+  rubyPropertiesXml?: XmlObject;
+  /**
+   * What each of a ruby run's two base-side `a:rPr`s authored on its own:
+   * `outer` is the containing `a:r`'s, `base` the `a:rubyBase` run's. The
+   * flat {@link style} merges both for rendering; these let the writer give
+   * each `a:rPr` back only its own properties (plus any later edit).
+   */
+  rubyRunAuthoredStyles?: {
+    outer?: TextStyle;
+    base?: TextStyle;
+  };
 }
 //#endregion
 //#region src/core/types/element-base.d.ts
@@ -4182,6 +4219,14 @@ interface PptxChartData {
   style?: PptxChartStyle;
   /** Grouping mode for bar/area/line charts: 'clustered' | 'stacked' | 'percentStacked' */
   grouping?: 'clustered' | 'stacked' | 'percentStacked';
+  /**
+   * The source `c:grouping` was `standard`, which {@link grouping} folds into
+   * `'clustered'` (a 2D bar chart draws the two the same). A 3D chart draws
+   * `standard` differently: each series on its own depth row. The writer
+   * emits `standard` again while `grouping` is still `'clustered'`, so the
+   * chart round-trips unchanged.
+   */
+  groupingStandard?: boolean;
   /**
    * Whether the first (or only) series varies its point colours
    * (`c:varyColors/@val`). Pie/doughnut default this on; single-series
@@ -5579,6 +5624,14 @@ interface PptxSmartArtNode {
    * quick-style variation) applied to every other node.
    */
   coherent3DOff?: boolean;
+  /**
+   * The layout variables PowerPoint recorded for each presentation node
+   * this point drives (`dgm:prSet/@presName` -> `dgm:presLayoutVars`
+   * variable -> `@val`), e.g. `{ hierRoot1: { hierBranch: 'l' } }` for an
+   * org-chart manager set to "Left Hanging". Read-only: the presentation
+   * points themselves round-trip verbatim.
+   */
+  presLayoutVarsByName?: Record<string, Record<string, string>>;
   /**
    * Per-run text + run-properties for the node's first paragraph, captured at
    * parse time. When the joined run text still equals {@link text} (the node
@@ -5648,6 +5701,16 @@ interface PptxSmartArtQuickStyleLabel {
   name: string;
   /** Theme-resolved `dgm:style` refs for this label's role, when available. */
   resolvedStyle?: PptxSmartArtResolvedStyleRef;
+  /**
+   * The label's own `dgm:scene3d` (per-shape camera + light rig). PowerPoint
+   * copies it onto a shape's cached `a:scene3d` unless it is the default
+   * front camera with a `threePt` light (see `applySmartArtQuickStyle3d`).
+   */
+  scene3d?: Pptx3DScene;
+  /** The label's own `dgm:sp3d` (bevel / extrusion / contour / material); absent when empty. */
+  shape3d?: Pptx3DShape;
+  /** The label's `dgm:txPr/a:sp3d` label-text extrusion (Bird's Eye Scene). */
+  text3d?: Text3DStyle;
 }
 /** CT_CTStyleLabel metadata from a color-transform definition. */
 interface PptxSmartArtColorStyleLabel {
@@ -5715,9 +5778,10 @@ interface PptxSmartArtQuickStyle extends PptxSmartArtDefinitionMetadata {
    * for the "Scene" quick styles (Brick, Flat, Metallic, Sunset, Bird's Eye
    * Scene). One camera renders the whole diagram; per-shape `a:scene3d` is
    * absent for those styles (see `PptxSmartArtDrawingShape.scene3d`). Each
-   * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`,
-   * but PowerPoint bakes those fully resolved onto each cached shape's own
-   * `dsp:spPr/a:sp3d`, so only the diagram-level scene is exposed here.
+   * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`
+   * ({@link PptxSmartArtQuickStyleLabel.scene3d} / `shape3d` / `text3d`),
+   * which PowerPoint bakes onto each cached shape; they are re-applied when a
+   * structural edit regenerates the shapes.
    */
   scene3d?: Pptx3DScene;
 }
@@ -5848,6 +5912,11 @@ interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
   fillNone?: boolean;
   /** Solid fill colour (hex). */
   fillColor?: string;
+  /**
+   * Opacity (0..1) of the solid fill, from the colour's `a:alpha` (Basic Venn
+   * paints its circles at 50% so overlaps blend). Absent when opaque.
+   */
+  fillOpacity?: number;
   /**
    * Gradient fill stops when the cached shape uses `a:gradFill`. Positions are
    * 0..100 (percent). Renderers emit an SVG/CSS gradient instead of a flat box.
@@ -11256,6 +11325,8 @@ interface IPptxHandlerRuntime {
   updateThemeColorScheme(colorScheme: PptxThemeColorScheme): Promise<void>;
   updateThemeFontScheme(fontScheme: PptxThemeFontScheme): Promise<void>;
   updateThemeName(name: string): Promise<void>;
+  /** Resolve a `<p:style>` node against the loaded theme (see PptxHandlerRuntimeStyleMatrixResolve). */
+  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
   applyTheme(colorScheme: PptxThemeColorScheme, fontScheme: PptxThemeFontScheme, themeName?: string): Promise<void>;
   load(data: ArrayBuffer, options?: PptxHandlerLoadOptions): Promise<PptxData>;
   getChartDataForGraphicFrame(slidePath: string, graphicFrame: XmlObject | undefined): Promise<PptxChartData | undefined>;
@@ -11551,6 +11622,14 @@ declare class PptxHandlerCore {
    * @param name - New display name for the theme.
    */
   updateThemeName(name: string): Promise<void>;
+  /**
+   * Resolve a `<p:style>` block (`a:lnRef` / `a:fillRef` / `a:effectRef` /
+   * `a:fontRef`) against the loaded theme, exactly as the load path would for
+   * a shape whose `spPr` authors nothing. Apply the returned `shapeStyle` to a
+   * shape and it renders like PowerPoint's Shape Styles entry and saves as a
+   * bare `<p:style>` with an empty `spPr`, which is what PowerPoint writes.
+   */
+  resolveStyleMatrixReferences(styleXml: XmlObject): ResolvedStyleMatrix;
   /**
    * Apply a complete theme in one call (colour scheme + font scheme + optional name).
    *

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunkVF4RA27Q_js = require('../chunk-VF4RA27Q.js');
-require('../chunk-2BM4GBFZ.js');
-var chunkSR7ETIBF_js = require('../chunk-SR7ETIBF.js');
-var chunkFYAOOACZ_js = require('../chunk-FYAOOACZ.js');
-var chunkAQIXKTAT_js = require('../chunk-AQIXKTAT.js');
-require('../chunk-UIAU3NR2.js');
+var chunkNV2H57Q4_js = require('../chunk-NV2H57Q4.js');
+require('../chunk-UTP22QYH.js');
+var chunkQ7NWWIPQ_js = require('../chunk-Q7NWWIPQ.js');
+var chunkSAYZSUNQ_js = require('../chunk-SAYZSUNQ.js');
+var chunkYF2BQIW3_js = require('../chunk-YF2BQIW3.js');
+require('../chunk-LTBTG2QB.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkVF4RA27Q_js.CollaborationStatusIndicator; }
+  get: function () { return chunkNV2H57Q4_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkVF4RA27Q_js.PowerPointViewer; }
+  get: function () { return chunkNV2H57Q4_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkVF4RA27Q_js.UserAvatarBar; }
+  get: function () { return chunkNV2H57Q4_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.CollaborationProvider; }
+  get: function () { return chunkQ7NWWIPQ_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.RemoteUserCursors; }
+  get: function () { return chunkQ7NWWIPQ_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.isAudienceTab; }
+  get: function () { return chunkQ7NWWIPQ_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.parseAudienceNonce; }
+  get: function () { return chunkQ7NWWIPQ_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.useCollaborativeHistory; }
+  get: function () { return chunkQ7NWWIPQ_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.useCollaborativeState; }
+  get: function () { return chunkQ7NWWIPQ_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.usePresenceTracking; }
+  get: function () { return chunkQ7NWWIPQ_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.useThemeSwitching; }
+  get: function () { return chunkQ7NWWIPQ_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkSR7ETIBF_js.useYjsProvider; }
+  get: function () { return chunkQ7NWWIPQ_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkFYAOOACZ_js.getAnimationInitialStyle; }
+  get: function () { return chunkSAYZSUNQ_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.clearAudienceContent; }
+  get: function () { return chunkYF2BQIW3_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.forgetSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.getSessionTabId; }
+  get: function () { return chunkYF2BQIW3_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.loadAudienceContent; }
+  get: function () { return chunkYF2BQIW3_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.loadSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.rememberSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.restoreSessionDeck; }
+  get: function () { return chunkYF2BQIW3_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkAQIXKTAT_js.storeAudienceContent; }
+  get: function () { return chunkYF2BQIW3_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-UBYFLXAU.mjs';
-import '../chunk-E5OIDWHO.mjs';
-export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-OECUSL2B.mjs';
-export { getAnimationInitialStyle } from '../chunk-5J6NW3YS.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-QLDHUKH2.mjs';
-import '../chunk-WIEBQGQI.mjs';
+export { CollaborationStatusIndicator, PowerPointViewer, UserAvatarBar } from '../chunk-KHEJXP4I.mjs';
+import '../chunk-Q4XJSJYI.mjs';
+export { CollaborationProvider, RemoteUserCursors, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-SOMUGI3Y.mjs';
+export { getAnimationInitialStyle } from '../chunk-SSXGPYBF.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-NPZOVIHG.mjs';
+import '../chunk-YPDPSXPK.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/dist/viewer/index.mjs.br

@@ -1,3 +1,2 @@
-�@��&�i�%AS�Ju�i�n:�H��ͯ�iV
-�H�
-�wSS9��Ƣ9,]|
+�@��w���\W�k��ڧ�����
+'{}�������[�EsX��7@"���mIA�ە��c��ĉ�Ʉ

package/package.json

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