pptx-react-viewer 3.1.3 → 3.1.5

package/dist/viewer/index.d.ts

@@ -1231,7 +1231,14 @@ interface ShapeStyle {
  * // => both satisfy the TextStyle interface
  * ```
  */
+/** 2D linear transform matrix `[a, b, c, d]` for inherited group orientation. */
+type TextOrientationMatrix = [number, number, number, number];
 interface TextStyle {
+  /**
+   * Combined rotation/flip matrix inherited from ancestor groups.
+   * Used only to keep descendant text readable after nested group mirrors.
+   */
+  ancestorGroupTransform?: TextOrientationMatrix;
   /** Original `a:rPr` XML retained by projections that share the shape-text model. */
   runPropertiesXml?: XmlObject;
   /**
@@ -2168,6 +2175,16 @@ interface PlaceholderTextLevelStyle {
   lineSpacingExactPt?: number;
   spaceBefore?: number;
   spaceAfter?: number;
+  /** Default tab interval in CSS pixels (`a:lvlXpPr/@defTabSz`). */
+  defaultTabSize?: number;
+  /** Whether East Asian line-breaking rules are enabled. */
+  eaLineBreak?: boolean;
+  /** Whether Latin line-breaking rules are enabled. */
+  latinLineBreak?: boolean;
+  /** Font vertical alignment within the text line. */
+  fontAlignment?: string;
+  /** Whether end punctuation may hang outside the text frame. */
+  hangingPunctuation?: boolean;
 }
 //#endregion
 //#region src/core/types/chart-axis.d.ts
@@ -4243,10 +4260,15 @@ interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
   height: number;
   /** Rotation in degrees. */
   rotation?: number;
+  /** Horizontal/vertical mirrors declared on the cached drawing transform. */
+  flipHorizontal?: boolean;
+  flipVertical?: boolean;
   /** Skew along the X axis in degrees. */
   skewX?: number;
   /** Skew along the Y axis in degrees. */
   skewY?: number;
+  /** Preset-geometry adjustment values from `a:prstGeom/a:avLst`. */
+  shapeAdjustments?: Record<string, number>;
   /**
    * The cached shape declares `a:noFill`. Renderers must leave it unpainted
    * rather than substituting a palette colour, because these shapes usually sit
@@ -4297,10 +4319,36 @@ interface PptxSmartArtDrawingShape extends PptxCustomPathProperties {
   text?: string;
   /** Standard rich-text segments projected from the associated SmartArt node. */
   textSegments?: TextSegment[];
-  /** Font size in points. */
+  /** Font size in CSS pixels. */
   fontSize?: number;
   /** Font colour (hex). */
   fontColor?: string;
+  /** Authored font family from the first styled run. */
+  fontFamily?: string;
+  /** Authored font weight (400 or 700). */
+  fontWeight?: number;
+  /** Authored font style. */
+  fontStyle?: 'normal' | 'italic';
+  /** Absolute line height in CSS pixels from `a:spcPts`. */
+  lineHeight?: number;
+  /** Relative line height from `a:spcPct`. */
+  lineHeightRatio?: number;
+  /** Absolute spacing after a paragraph in CSS pixels. */
+  lineSpacingAfter?: number;
+  /** Relative spacing after a paragraph. */
+  lineSpacingAfterRatio?: number;
+  /** Text-body insets in CSS pixels. */
+  textInsetLeft?: number;
+  textInsetTop?: number;
+  textInsetRight?: number;
+  textInsetBottom?: number;
+  /** DiagramML text vertical anchor (`t`, `ctr`, or `b`). */
+  textVerticalAnchor?: string;
+  /** Independent DiagramML text-frame geometry from `dsp:txXfrm`. */
+  textFrameX?: number;
+  textFrameY?: number;
+  textFrameWidth?: number;
+  textFrameHeight?: number;
 }
 /**
  * Background / outline extracted from `dgm:bg` and `dgm:whole`.
@@ -5305,6 +5353,22 @@ interface MediaPptxElement extends PptxElementBase {
   posterFramePath?: string;
   /** Base64 data-URL for the poster frame image. */
   posterFrameData?: string;
+  /** Poster source crop from the left edge as a 0..1 fraction. */
+  cropLeft?: number;
+  /** Poster source crop from the top edge as a 0..1 fraction. */
+  cropTop?: number;
+  /** Poster source crop from the right edge as a 0..1 fraction. */
+  cropRight?: number;
+  /** Poster source crop from the bottom edge as a 0..1 fraction. */
+  cropBottom?: number;
+  /** Poster stretch-target inset from the left frame edge. */
+  fillRectLeft?: number;
+  /** Poster stretch-target inset from the top frame edge. */
+  fillRectTop?: number;
+  /** Poster stretch-target inset from the right frame edge. */
+  fillRectRight?: number;
+  /** Poster stretch-target inset from the bottom frame edge. */
+  fillRectBottom?: number;
   /** Whether media should play full-screen during presentation. */
   fullScreen?: boolean;
   /** Whether media should loop continuously. */
@@ -5569,6 +5633,8 @@ interface PptxNotesMaster {
   backgroundColor?: string;
   /** Background image data URL. */
   backgroundImage?: string;
+  /** Crop, tiling and image effects authored on the background blip fill. */
+  backgroundImageProperties?: PptxImageProperties;
   /** Placeholder shapes found on the notes master. */
   placeholders?: PptxPlaceholderFrame[];
   /** Editable elements on the notes master (header, footer, date, page number, slide image, notes body). */
@@ -5607,6 +5673,8 @@ interface PptxHandoutMaster {
   backgroundColor?: string;
   /** Background image data URL. */
   backgroundImage?: string;
+  /** Crop, tiling and image effects authored on the background blip fill. */
+  backgroundImageProperties?: PptxImageProperties;
   /** Placeholder shapes found on the handout master. */
   placeholders?: PptxPlaceholderFrame[];
   /** Editable elements on the handout master (header, footer, date, page number, slide placeholders). */
@@ -5641,6 +5709,8 @@ interface PptxSlideMaster {
   backgroundColor?: string;
   /** Background image data URL for the slide master. */
   backgroundImage?: string;
+  /** Crop, tiling and image effects authored on the background blip fill. */
+  backgroundImageProperties?: PptxImageProperties;
   /** Theme file path this master references. */
   themePath?: string;
   /** Layout paths associated with this master. */
@@ -5723,6 +5793,8 @@ interface PptxSlideLayout {
   backgroundColor?: string;
   /** Background image data URL for the layout. */
   backgroundImage?: string;
+  /** Crop, tiling and image effects authored on the background blip fill. */
+  backgroundImageProperties?: PptxImageProperties;
   /** Parsed element shapes on the layout. */
   elements?: PptxElement[];
   /** Placeholder shapes on the layout. */
@@ -5771,6 +5843,8 @@ interface PptxLayoutPreview {
   backgroundColor?: string;
   /** Background image data URL, when the layout or master declares one. */
   backgroundImage?: string;
+  /** Crop, tiling and image effects authored on the resolved background image. */
+  backgroundImageProperties?: PptxImageProperties;
   /** The layout's own artwork (pictures, shapes and static text). */
   elements: PptxElement[];
   /** Placeholder slots, drawn as outlined frames in the gallery. */
@@ -5823,6 +5897,8 @@ type PptxNativeAnimationKind = 'media';
 type PptxAnimationTarget = {
   type: 'shape';
   shapeId: string;
+  /** Whether `p:spTgt/p:bg` limits the effect to the shape background. */
+  backgroundOnly?: boolean;
   rawXml?: XmlObject;
 } | {
   type: 'slide';
@@ -5913,6 +5989,10 @@ interface PptxNativeAnimation {
   trigger?: PptxAnimationTrigger;
   /** Shape ID that triggers this animation when clicked (interactive sequence). */
   triggerShapeId?: string;
+  /** Whether this effect belongs to an OOXML `interactiveSeq`. */
+  interactiveSequence?: boolean;
+  /** Whether `p:endSync/p:rtn[@val="all"]` makes that sequence replayable. */
+  interactiveRestart?: boolean;
   /** Effect preset class (entr, exit, emph, path). */
   presetClass?: 'entr' | 'exit' | 'emph' | 'path';
   /** Effect preset sub-type identifier. */
@@ -5958,6 +6038,12 @@ interface PptxNativeAnimation {
   motionPathEditMode?: string;
   /** Comma-separated point-types string from `p:animMotion/@ptsTypes`. */
   motionPtsTypes?: string;
+  /** Authored path rotation in degrees from `p:animMotion/@rAng`. */
+  motionPathRotationAngle?: number;
+  /** Motion-path rotation centre X in slide percentage units (`p:rCtr/@x`). */
+  motionPathRotationCenterX?: number;
+  /** Motion-path rotation centre Y in slide percentage units (`p:rCtr/@y`). */
+  motionPathRotationCenterY?: number;
   /** Rotation angle in degrees for `p:animRot/@by` (converted from 60000ths). */
   rotationBy?: number;
   /** Starting rotation angle in degrees for `p:animRot/@from` (converted from 60000ths). */
@@ -5993,6 +6079,8 @@ interface PptxNativeAnimation {
    * instead). Absent when the behaviour carries no `p:attrNameLst`.
    */
   attrName?: string;
+  /** Every generic `p:anim` sibling composed by the authored effect. */
+  attributeAnimations?: PptxAttributeAnimation[];
   /** Repeat count (e.g. `2`, `Infinity` for indefinite). */
   repeatCount?: number;
   /** Whether the animation plays in reverse after completion. */
@@ -6082,6 +6170,14 @@ interface PptxNativeAnimation {
    * simultaneous effects at their true offsets instead of accumulating delays.
    */
   parGroupIndex?: number;
+  /**
+   * Absolute start offset of the enclosing effect-wrapper from its click group.
+   *
+   * Structural `p:par` wrappers can carry their own start conditions. Keeping
+   * this offset separate from the effect's delay prevents playback from
+   * replacing an authored absolute start with a duration-based approximation.
+   */
+  parGroupDelayMs?: number;
   /** Structured start conditions parsed from `p:stCondLst`. */
   startConditions?: AnimationCondition[];
   /** Structured end conditions parsed from `p:endCondLst`. */
@@ -6238,6 +6334,26 @@ interface PptxAnimationKeyframe {
    */
   fmla?: string;
 }
+/** One generic `p:anim` behaviour inside a composed PowerPoint effect. */
+interface PptxAttributeAnimation {
+  /** Lowercased target attribute from `p:attrNameLst`. */
+  attrName: string;
+  /** Authored value stops from this behaviour's `p:tavLst`. */
+  keyframes: PptxAnimationKeyframe[];
+  /** Duration from this behaviour's nested `p:cTn/@dur`. */
+  durationMs?: number;
+  /** Start offset from this behaviour's nested `p:stCondLst`. */
+  delayMs?: number;
+}
+/** Signed HSL channel deltas parsed from `p:animClr/p:by/p:hsl`. */
+interface PptxHslColorDelta {
+  /** Hue offset in degrees. OOXML stores this in 60000ths of a degree. */
+  hue: number;
+  /** Saturation offset in percentage points. */
+  saturation: number;
+  /** Lightness offset in percentage points. */
+  lightness: number;
+}
 /** Color animation data parsed from `p:animClr`. */
 interface PptxColorAnimation {
   /** Color interpolation space: "hsl" or "rgb". */
@@ -6257,15 +6373,27 @@ interface PptxColorAnimation {
   toColor?: string;
   /**
    * Color delta (for "by" animations) as hex string. For HSL colour-space
-   * animations the value encodes a delta over hue/sat/lum and is preserved
-   * verbatim from the source.
+   * animations this retains the historical byte-packed compatibility value;
+   * consumers should prefer {@link hslDelta}, which preserves signed values.
    */
   byColor?: string;
+  /**
+   * Typed HSL delta from `p:by/p:hsl`. This preserves signed values and their
+   * OOXML units without forcing them through the legacy byte-packed `byColor`
+   * representation.
+   */
+  hslDelta?: PptxHslColorDelta;
   /**
    * Target attribute from `p:attrNameLst` (e.g. "fillcolor", "style.color",
    * "stroke.color"). Used to determine which CSS property to animate.
    */
   targetAttribute?: string;
+  /**
+   * All sibling `p:animClr` behaviours authored for the same timing node.
+   * The top-level fields continue to mirror the first behaviour for backwards
+   * compatibility; this list is present only when there is more than one.
+   */
+  components?: readonly PptxColorAnimation[];
 }
 /** Text-level animation target from `p:txEl`. */
 interface PptxTextAnimationTarget {
@@ -6382,6 +6510,12 @@ interface PptxElementAnimation {
   motionPathEditMode?: string;
   /** Comma-separated point-types string for `p:animMotion/@ptsTypes`. */
   motionPtsTypes?: string;
+  /** Authored path rotation in degrees from `p:animMotion/@rAng`. */
+  motionPathRotationAngle?: number;
+  /** Motion-path rotation centre X in slide percentage units (`p:rCtr/@x`). */
+  motionPathRotationCenterX?: number;
+  /** Motion-path rotation centre Y in slide percentage units (`p:rCtr/@y`). */
+  motionPathRotationCenterY?: number;
   /** Sound relationship ID to play when animation triggers (`p:stSnd`). */
   soundRId?: string;
   /** Resolved sound file path from relationship. */
@@ -7409,6 +7543,8 @@ interface PptxSlide {
   elements: PptxElement[];
   backgroundColor?: string;
   backgroundImage?: string;
+  /** Crop, tiling and image effects authored on the background blip fill. */
+  backgroundImageProperties?: PptxImageProperties;
   backgroundGradient?: string;
   /**
    * Pattern fill on the slide background (`<a:pattFill>` inside `<p:bgPr>`).

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunkGCOGKBK3_js = require('../chunk-GCOGKBK3.js');
-require('../chunk-K4DUVYZ7.js');
-var chunkXBR7W47W_js = require('../chunk-XBR7W47W.js');
-var chunkOABOL32L_js = require('../chunk-OABOL32L.js');
+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 chunkHMZA25W2_js = require('../chunk-HMZA25W2.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkGCOGKBK3_js.CollaborationProvider; }
+  get: function () { return chunkZPF4L6SD_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkGCOGKBK3_js.CollaborationStatusIndicator; }
+  get: function () { return chunkZPF4L6SD_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkGCOGKBK3_js.PowerPointViewer; }
+  get: function () { return chunkZPF4L6SD_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkGCOGKBK3_js.RemoteUserCursors; }
+  get: function () { return chunkZPF4L6SD_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkGCOGKBK3_js.UserAvatarBar; }
+  get: function () { return chunkZPF4L6SD_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkXBR7W47W_js.isAudienceTab; }
+  get: function () { return chunkLXYDXLKZ_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkXBR7W47W_js.parseAudienceNonce; }
+  get: function () { return chunkLXYDXLKZ_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkXBR7W47W_js.useCollaborativeHistory; }
+  get: function () { return chunkLXYDXLKZ_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkXBR7W47W_js.useCollaborativeState; }
+  get: function () { return chunkLXYDXLKZ_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkXBR7W47W_js.usePresenceTracking; }
+  get: function () { return chunkLXYDXLKZ_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkXBR7W47W_js.useThemeSwitching; }
+  get: function () { return chunkLXYDXLKZ_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkXBR7W47W_js.useYjsProvider; }
+  get: function () { return chunkLXYDXLKZ_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkOABOL32L_js.getAnimationInitialStyle; }
+  get: function () { return chunkT2QG2HD5_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.clearAudienceContent; }
+  get: function () { return chunkYDEEINER_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.forgetSessionDeck; }
+  get: function () { return chunkYDEEINER_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.getSessionTabId; }
+  get: function () { return chunkYDEEINER_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.loadAudienceContent; }
+  get: function () { return chunkYDEEINER_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.loadSessionDeck; }
+  get: function () { return chunkYDEEINER_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.rememberSessionDeck; }
+  get: function () { return chunkYDEEINER_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.restoreSessionDeck; }
+  get: function () { return chunkYDEEINER_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkHMZA25W2_js.storeAudienceContent; }
+  get: function () { return chunkYDEEINER_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-5WH6UVWC.mjs';
-import '../chunk-Z3DEULRJ.mjs';
-export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-BZ6OM3H5.mjs';
-export { getAnimationInitialStyle } from '../chunk-ACVLIDUS.mjs';
+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 { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-SRAXNEJX.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "3.1.3",
+	"version": "3.1.5",
 	"description": "React PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",
@@ -100,7 +100,7 @@
 		"@ai-sdk/react": "^4.0.76",
 		"ai": ">=6 <8",
 		"fast-xml-parser": "^5.10.1",
-		"framer-motion": "^12.42.2",
+		"framer-motion": "^12.42.2 || ^13.1.1",
 		"i18next": "^26.3.6",
 		"jspdf": "^4.2.1",
 		"jszip": "^3.10.1",