pptx-react-viewer 3.0.3 → 3.1.0

package/dist/{useViewerBuildingBlocks-fh7rq4jc.d.ts.map → useViewerBuildingBlocks-DC1O_op4.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"useViewerBuildingBlocks-fh7rq4jc.d.ts","names":[],"sources":["../src/viewer/components/toolbar/toolbar-types.ts","../src/viewer/utils/table-band-style.tsx","../src/viewer/components/canvas/canvas-types.ts","../src/viewer/hooks/useAutosave.ts","../src/viewer/hooks/useViewerBuildingBlocks.ts"],"mappings":";;;;;UA4BiB;EAChB;EACA,MAAM;EACN;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA,iBAAiB;EACjB,mBAAmB;EACnB;EACA,cAAc;EACd,YAAY;EACZ;EACA;EACA,kBAAkB;EAClB,YAAY,MAAM;EAClB;EACA;;EAEA;;;;;;EAMA,kBAAkB,gBAAgB,OAAO;;EAEzC;EACA;EACA,sBAAsB,SAAS;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA,oBAAoB,MAAM;EAC1B;EACA;EACA;EACA,cAAc,WAAW;EACzB;EACA;EACA,oBAAoB;EACpB,iBAAiB,mBAAmB;EACpC;EACA;EACA;EACA,kBAAkB,MAAM;EACxB,oBAAoB;EACpB,oBAAoB;EACpB,wBAAwB;EACxB;EACA;EACA;;EAEA;EACA;EACA;EACA,yBAAyB;EACzB,gBAAgB;EAChB,kBAAkB;EAClB,kBAAkB;EAClB,kBAAkB;EAClB,mBAAmB;EACnB,aAAa;EACb,kBAAkB;EAClB,uBAAuB;EACvB;EACA;EACA;EACA;EACA,SAAS;EACT,cAAc;EACd,oBAAoB;;EAEpB;;EAEA;;EAEA,uBAAuB,SAAS,QAAQ;;EAExC;;EAEA;EACA;EACA;;EAEA;EACA,oBAAoB;EACpB,uBAAuB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA,oBAAoB,SAAS,QAAQ;;EAErC,sBAAsB,MAAM;EAC5B;EACA,wBAAwB;EACxB,eAAe;;EAEf;;EAEA,2BAA2B,QAAQ;;EAEnC;IAAe;IAAkB;;;EAEjC;;EAEA;EACA,0BAA0B,cAAc;;EAExC,iBAAiB;;EAEjB,6BAA6B,YAAY;;EAEzC,iBAAiB;EACjB,aAAa;EACb;EACA,0BAA0B;EAC1B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA,cAAc;EACd,qBAAqB,SAAS,QAAQ;EACtC;;;;;;EAMA;;EAEA;;EAEA;;;;;EAKA,yBAAyB;EACzB,kCAAkC,SAAS,QAAQ;;EAEnD,yBAAyB;;EAEzB;;EAEA;;EAEA;;;;;;;;;;;;;;;;;UC9NgB;EAChB,gBAAgB;EAChB,QAAQ;;;;UCUQ;EAChB,mBAAmB,QAAM,UAAU;EACnC,gBAAgB,QAAM,UAAU;EAChC,gBAAgB,QAAM,UAAU;EAChC;;UAuBgB;EAChB,aAAa;EACb,kBAAkB;EAClB,YAAY;EACZ,MAAM;EACN,MAAM;EACN;EACA;EACA,sBAAsB;EACtB,iBAAiB;EACjB;EACA;EACA;EACA,eAAe;EACf,kBAAkB;EAClB,uBAAuB;EACvB,WAAW;IAAQ;IAAc;;EACjC;;EAEA;EACA;;EAEA,YAAY;EACZ,QAAQ;IAAQ;IAAY;IAAiB;;EAC7C,4BAA4B,YAAY;EACxC;EAEA,UAAU,mBAAmB,GAAG,QAAM;EACtC,gBAAgB,mBAAmB,GAAG,QAAM;EAC5C,cAAc,mBAAmB,GAAG,QAAM;EAC1C,gBAAgB,mBAAmB,GAAG,QAAM;;EAE5C,qBAAqB,GAAG,QAAM;EAC9B,sBAAsB,mBAAmB,GAAG,QAAM,YAAY;EAC9D,0BACC,mBACA,GAAG,QAAM,YACT,YAAY;;EAGb,YAAY,mBAAmB;EAC/B,qBAAqB;EACrB;EACA;EACA,oBACC,MAAM,KAAK,2CACX;;EAGD,oBAAoB,mBAAmB,kBAAkB,kBAAkB;;;;;;EAM3E,2BAA2B,mBAAmB,SAAS,QAAQ;;;;;;EAM/D,gBAAgB,SAAS,QAAQ;;EAEjC,wBAAwB,mBAAmB;;EAE3C,oBAAoB,mBAAmB,kBAAkB;;EAEzD,cAAc;IACb;IACA;IACA;IACA;IACA;;;EAGD;;EAEA;;EAIA,aAAa;;EAEb;;EAEA;;EAEA,eAAe,QAAM;;EAErB,mBAAmB,KAAK;;EAExB,sBAAsB,OAAO;;EAE7B,qBAAqB;;EAIrB,iBAAiB,mBAAmB,QAAQ;;EAE5C,oBAAoB;;EAIpB,WAAW;;EAEX;;EAEA,wBAAwB;EACxB,eAAe,iBAAiB;EAChC,iBAAiB;EACjB,0BAA0B,iBAAiB;;;;;;EAQ3C,2BAA2B,YAAY;;EAIvC;;EAEA,qBAAqB,WAAW;;EAIhC,qBAAqB;;EAErB,eAAe,0BAA0B;;EAEzC;;EAIA,eAAe;;EAIf,oBAAoB;;EAIpB,uBAAuB,QAAM;;;;;EAO7B;;;;KCnMW;EACP;;EACA;EAAmB;;EACnB;;EACA;EAAgB;;EAChB;EAAgB;;UAEJ;;EAEhB;;EAEA;;EAEA,uBAAuB,QAAQ;;;;;;;;;EAS/B;;;;;;EAMA;;;;;EAKA;;;;;;;;;;;EAWA;;UAGgB;;EAEhB,gBAAgB;;EAEhB,uBAAuB;;iBAOR,YAAY,OAAO,mBAAmB;;;UCxBrC;;EAEhB,SAAS,cAAc;;EAEvB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,yBAAyB;;EAEzB,SAAS,MAAM,aAAa;EAC5B,mBAAmB,SAAS;EAC5B,iBAAiB;EACjB,uBAAuB;EACvB,gBAAgB,MAAM;EACtB,gBAAgB;EAChB,qBAAqB;EACrB,sBAAsB;;EAEtB;;EAEA;;EAEA;;UAOgB;;EAEhB,cAAc;;EAEd,aAAa;;EAEb,MAAM;;EAEN;;EAEA;;EAEA,gBAAgB;;iBAOD,wBACf,OAAO,+BACL"}
+{"version":3,"file":"useViewerBuildingBlocks-DC1O_op4.d.ts","names":[],"sources":["../src/viewer/components/toolbar/toolbar-types.ts","../src/viewer/utils/table-band-style.tsx","../src/viewer/components/canvas/canvas-types.ts","../src/viewer/hooks/useAutosave.ts","../src/viewer/hooks/useViewerBuildingBlocks.ts"],"mappings":";;;;;UA4BiB;EAChB;EACA,MAAM;EACN;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA,iBAAiB;EACjB,mBAAmB;EACnB;EACA,cAAc;EACd,YAAY;EACZ;EACA;EACA,kBAAkB;EAClB,YAAY,MAAM;EAClB;EACA;;EAEA;;;;;;EAMA,kBAAkB,gBAAgB,OAAO;;EAEzC;EACA;EACA,sBAAsB,SAAS;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA,oBAAoB,MAAM;EAC1B;EACA;EACA;EACA,cAAc,WAAW;EACzB;EACA;EACA,oBAAoB;EACpB,iBAAiB,mBAAmB;EACpC;EACA;EACA;EACA,kBAAkB,MAAM;EACxB,oBAAoB;EACpB,oBAAoB;EACpB,wBAAwB;EACxB;EACA;EACA;;EAEA;EACA;EACA;EACA,yBAAyB;EACzB,gBAAgB;EAChB,kBAAkB;EAClB,kBAAkB;EAClB,kBAAkB;EAClB,mBAAmB;EACnB,aAAa;EACb,kBAAkB;EAClB,uBAAuB;EACvB;EACA;EACA;EACA;EACA,SAAS;EACT,cAAc;EACd,oBAAoB;;EAEpB;;EAEA;;EAEA,uBAAuB,SAAS,QAAQ;;EAExC;;EAEA;EACA;EACA;;EAEA;EACA,oBAAoB;EACpB,uBAAuB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA,oBAAoB,SAAS,QAAQ;;EAErC,sBAAsB,MAAM;EAC5B;EACA,wBAAwB;EACxB,eAAe;;EAEf;;EAEA,2BAA2B,QAAQ;;EAEnC;IAAe;IAAkB;;;EAEjC;;EAEA;EACA,0BAA0B,cAAc;;EAExC,iBAAiB;;EAEjB,6BAA6B,YAAY;;EAEzC,iBAAiB;EACjB,aAAa;EACb;EACA,0BAA0B;EAC1B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA,cAAc;EACd,qBAAqB,SAAS,QAAQ;EACtC;;;;;;EAMA;;EAEA;;EAEA;;;;;EAKA,yBAAyB;EACzB,kCAAkC,SAAS,QAAQ;;EAEnD,yBAAyB;;EAEzB;;EAEA;;EAEA;;;;;;;;;;;;;;;;;UC9NgB;EAChB,gBAAgB;EAChB,QAAQ;;;;UCUQ;EAChB,mBAAmB,QAAM,UAAU;EACnC,gBAAgB,QAAM,UAAU;EAChC,gBAAgB,QAAM,UAAU;EAChC;;UAuBgB;EAChB,aAAa;EACb,kBAAkB;EAClB,YAAY;EACZ,MAAM;EACN,MAAM;EACN;EACA;EACA,sBAAsB;EACtB,iBAAiB;EACjB;EACA;EACA;EACA,eAAe;EACf,kBAAkB;EAClB,uBAAuB;EACvB,WAAW;IAAQ;IAAc;;EACjC;;EAEA;EACA;;EAEA,YAAY;EACZ,QAAQ;IAAQ;IAAY;IAAiB;;EAC7C,4BAA4B,YAAY;EACxC;EAEA,UAAU,mBAAmB,GAAG,QAAM;EACtC,gBAAgB,mBAAmB,GAAG,QAAM;EAC5C,cAAc,mBAAmB,GAAG,QAAM;EAC1C,gBAAgB,mBAAmB,GAAG,QAAM;;EAE5C,qBAAqB,GAAG,QAAM;EAC9B,sBAAsB,mBAAmB,GAAG,QAAM,YAAY;EAC9D,0BACC,mBACA,GAAG,QAAM,YACT,YAAY;;EAGb,YAAY,mBAAmB;EAC/B,qBAAqB;EACrB;EACA;EACA,oBACC,MAAM,KAAK,2CACX;;EAGD,oBAAoB,mBAAmB,kBAAkB,kBAAkB;;;;;;EAM3E,2BAA2B,mBAAmB,SAAS,QAAQ;;;;;;EAM/D,gBAAgB,SAAS,QAAQ;;EAEjC,wBAAwB,mBAAmB;;EAE3C,oBAAoB,mBAAmB,kBAAkB;;EAEzD,cAAc;IACb;IACA;IACA;IACA;IACA;;;EAGD;;EAEA;;EAIA,aAAa;;EAEb;;EAEA;;EAEA,eAAe,QAAM;;EAErB,mBAAmB,KAAK;;EAExB,sBAAsB,OAAO;;EAE7B,qBAAqB;;EAIrB,iBAAiB,mBAAmB,QAAQ;;EAE5C,oBAAoB;;EAIpB,WAAW;;EAEX;;EAEA,wBAAwB;EACxB,eAAe,iBAAiB;EAChC,iBAAiB;EACjB,0BAA0B,iBAAiB;;;;;;EAQ3C,2BAA2B,YAAY;;EAIvC;;EAEA,qBAAqB,WAAW;;EAIhC,qBAAqB;;EAErB,eAAe,0BAA0B;;EAEzC;;EAIA,eAAe;;EAIf,oBAAoB;;EAIpB,uBAAuB,QAAM;;;;;EAO7B;;;;KCnMW;EACP;;EACA;EAAmB;;EACnB;;EACA;EAAgB;;EAChB;EAAgB;;UAEJ;;EAEhB;;EAEA;;EAEA,uBAAuB,QAAQ;;;;;;;;;EAS/B;;;;;;EAMA;;;;;EAKA;;;;;;;;;;;EAWA;;UAGgB;;EAEhB,gBAAgB;;EAEhB,uBAAuB;;iBAOR,YAAY,OAAO,mBAAmB;;;UCxBrC;;EAEhB,SAAS,cAAc;;EAEvB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,yBAAyB;;EAEzB,SAAS,MAAM,aAAa;EAC5B,mBAAmB,SAAS;EAC5B,iBAAiB;EACjB,uBAAuB;EACvB,gBAAgB,MAAM;EACtB,gBAAgB;EAChB,qBAAqB;EACrB,sBAAsB;;EAEtB;;EAEA;;EAEA;;UAOgB;;EAEhB,cAAc;;EAEd,aAAa;;EAEb,MAAM;;EAEN;;EAEA;;EAEA,gBAAgB;;iBAOD,wBACf,OAAO,+BACL"}

package/dist/viewer/index.d.ts

@@ -1680,6 +1680,32 @@ interface TextStyle {
   textReflectionEndOpacity?: number;
   /** Text reflection offset distance in px. */
   textReflectionOffset?: number;
+  /**
+   * Text reflection fade direction (`a:rPr/a:effectLst/a:reflection/@fadeDir`)
+   * in degrees. Mirrors `ShapeStyle.reflectionFadeDirection`.
+   */
+  textReflectionFadeDirection?: number;
+  /**
+   * Text reflection horizontal scaling (`@sx`), same units as
+   * `ShapeStyle.reflectionScaleX` (1000ths of a percent, e.g. 100000 = 100%).
+   */
+  textReflectionScaleX?: number;
+  /** Text reflection vertical scaling (`@sy`). See `ShapeStyle.reflectionScaleY`. */
+  textReflectionScaleY?: number;
+  /**
+   * Text reflection horizontal skew (`@kx`) in 60000ths of a degree. See
+   * `ShapeStyle.reflectionSkewX`.
+   */
+  textReflectionSkewX?: number;
+  /** Text reflection vertical skew (`@ky`). See `ShapeStyle.reflectionSkewY`. */
+  textReflectionSkewY?: number;
+  /**
+   * Text reflection independent rotation (`@rot`) in degrees. See
+   * `ShapeStyle.reflectionRotation`.
+   */
+  textReflectionRotation?: number;
+  /** Text reflection anchor (`@algn`). See `ShapeStyle.reflectionAlignment`. */
+  textReflectionAlignment?: 'tl' | 't' | 'tr' | 'l' | 'ctr' | 'r' | 'bl' | 'b' | 'br';
   /** 3D extrusion/bevel settings on the text body. */
   text3d?: Text3DStyle;
   /** 3D scene (camera + light rig) settings on the text body (`a:bodyPr/a:scene3d`). */
@@ -5381,6 +5407,21 @@ interface ContentPartInkStroke {
    * variable-width strokes that reflect stylus/pen pressure.
    */
   pressures?: number[];
+  /**
+   * Per-point pen-tilt lean direction (radians), decoded from the source
+   * InkML's `OTx`/`OTy` tilt-offset channels or its `AZIMUTH` channel.
+   *
+   * When present (paired with {@link tiltMagnitudes}), the renderer widens
+   * each point perpendicular to the lean direction, approximating a
+   * calligraphic (chisel-tip) nib. Absent when the source declared no tilt
+   * channel, in which case rendering is unaffected.
+   */
+  tiltAngles?: number[];
+  /**
+   * Per-point pen-tilt strength (0 upright, 1 maximally leaned), paired with
+   * {@link tiltAngles}.
+   */
+  tiltMagnitudes?: number[];
 }
 /**
  * A content-part element wrapped in `mc:AlternateContent`.
@@ -5939,6 +5980,19 @@ interface PptxNativeAnimation {
   scaleZoomContents?: boolean;
   /** Parsed `p:tav` keyframes from `p:tavLst` (CT_TLAnimVariantList). */
   keyframes?: PptxAnimationKeyframe[];
+  /**
+   * The attribute {@link keyframes} drives, from the SAME node's
+   * `p:cBhvr/p:attrNameLst/p:attrName` (ECMA-376 S19.5.4). `p:tavLst` is
+   * schema-generic: without this, playback could see a numeric ramp but not
+   * know whether it targeted opacity, position, colour, or something with
+   * no CSS mapping. Lowercased and trimmed; common values seen in the wild
+   * (and written by this codebase's own animation writer) include
+   * `"style.opacity"`, `"style.color"`, `"style.visibility"`, `"fillcolor"`,
+   * `"stroke.color"`, `"r"` (rotation, only meaningful on `p:animRot`), and
+   * `"ppt_x"` / `"ppt_y"` (position, normally driven via `p:animMotion`
+   * instead). Absent when the behaviour carries no `p:attrNameLst`.
+   */
+  attrName?: string;
   /** Repeat count (e.g. `2`, `Infinity` for indefinite). */
   repeatCount?: number;
   /** Whether the animation plays in reverse after completion. */
@@ -6040,6 +6094,17 @@ interface PptxNativeAnimation {
   textTarget?: PptxTextAnimationTarget;
   /** Whether this animation is inside an exclusive container (`p:excl`). */
   exclusive?: boolean;
+  /**
+   * Identifies which `p:excl` container this animation belongs to, when
+   * {@link exclusive} is set. ECMA-376 S19.5.24 CT_TLExclusiveTimeNode: at
+   * most one direct child of an exclusive container may be active at a
+   * time, so starting one child stops any other currently-playing child of
+   * the SAME container. Two different `p:excl` containers on the same slide
+   * are independent groups; this id (assigned per container encountered
+   * during parsing, stable only within one parse's animation list) lets
+   * playback tell them apart. Absent when {@link exclusive} is unset.
+   */
+  exclGroupId?: number;
   /** Command type from `p:cmd` (@_type: call/evt/verb). */
   commandType?: string;
   /** Command string from `p:cmd` (@_cmd). */
@@ -6323,6 +6388,52 @@ interface PptxElementAnimation {
   soundPath?: string;
   /** Whether to stop any currently playing sound (`p:endSnd`). */
   stopSound?: boolean;
+  /**
+   * Pending, not-yet-embedded sound chosen in the authoring UI, as a
+   * `data:audio/...;base64,...` URL. Mirrors the `imageData` /
+   * `mediaData` pending-embed convention used elsewhere in the typed model:
+   * on save, the writer converts this to real bytes under `ppt/media/`,
+   * mints a relationship, and replaces this field with the resolved
+   * {@link soundRId} / {@link soundPath}. Cleared once embedded.
+   */
+  soundData?: string;
+  /**
+   * Display name for the chosen sound (e.g. the uploaded file's name),
+   * shown by the authoring UI's sound picker. Purely cosmetic; has no
+   * OOXML equivalent and is not required for playback.
+   */
+  soundFileName?: string;
+}
+/**
+ * A read-only anchor representing one of the deck's own effect groups: a
+ * top-level click group (`p:par` under `p:timing`'s main sequence) that this
+ * app did not author, so it is never exposed as an editable
+ * {@link PptxElementAnimation}.
+ *
+ * The authoring UI merges these anchors alongside `PptxSlide.animations` to
+ * render the FULL animation sequence (editor-authored and deck-native
+ * effects together) and lets an editor-authored entry be dragged to any
+ * position relative to them. `order` is the anchor's position among ALL
+ * top-level click groups (editor-owned and native) at load time, in the same
+ * numbering space as {@link PptxElementAnimation.order}, so the two
+ * populations sort into one coherent timeline.
+ *
+ * Anchors are never written back: on save, an untouched anchor's own click
+ * group is repositioned (if an editor-authored effect was dragged past it)
+ * but never mutated, so the deck's own effect stays byte-identical apart
+ * from its position in the sequence.
+ */
+interface PptxAnimationTimelineAnchor {
+  /**
+   * Position of this group among all top-level click groups in the main
+   * animation sequence at load time (dense, shared with editor entries'
+   * `order`).
+   */
+  order: number;
+  /** Shape id(s) this group's effects target, for a readable UI label. */
+  targetIds: string[];
+  /** Effect preset classes present in the group (entr/exit/emph/path). */
+  presetClasses: Array<'entr' | 'exit' | 'emph' | 'path'>;
 }
 //#endregion
 //#region src/core/types/embedded-font.d.ts
@@ -7026,8 +7137,19 @@ interface PptxSlideTransition {
   soundLoop?: boolean;
   /** Resolved transition sound media path within the package. */
   soundPath?: string;
-  /** Human-readable sound file name (extracted from soundPath). */
+  /** Human-readable sound file name (extracted from soundPath, or set by the
+   * UI when a new file is picked, before it has a soundPath at all). */
   soundFileName?: string;
+  /**
+   * A newly-picked local sound file awaiting embedding, as a `data:` URL.
+   * Set by the transitions ribbon's Sound picker (`applyTransitionSoundFile`
+   * in `pptx-viewer-shared`) when the user chooses a file that is not yet
+   * part of the package; mirrors `imageData`/`mediaData` on picture and media
+   * elements. The save pipeline (`embedTransitionSound`) writes the bytes to
+   * `ppt/media/`, mints a relationship, sets `soundRId`/`soundPath`, and
+   * clears this field so a later save does not re-embed the same bytes.
+   */
+  soundData?: string;
   /**
    * When true, the transition stops the currently-playing sound (OOXML `p:sndAc/p:endSnd`).
    * Mutually exclusive with `soundRId`/`soundPath` (which use `p:stSnd`).
@@ -7301,17 +7423,29 @@ interface PptxSlide {
   backgroundPattern?: PptxSlideBackgroundPattern;
   /**
    * `<p:bgPr/@shadeToTitle>`: boolean flag instructing the renderer to
-   * shade the background toward the title placeholder colour. Captured
-   * for lossless round-trip only; no renderer applies the visual effect.
-   * Documented as a known no-op in `docs/guide/limitations.md` (legacy
-   * PowerPoint 97-2003 hint, not observed in any real-world corpus file
-   * and not settable from any modern PowerPoint UI).
+   * shade the background gradient toward the title placeholder's text
+   * colour. Parsed and round-tripped here on the core model; the actual
+   * visual effect is applied by `pptx-viewer-shared`'s
+   * `getSlideBackgroundStyle` (see `render/background-shade-to-title.ts`),
+   * consumed by all five bindings, not by core itself. That module's
+   * docstring explains the approximation: no published ECMA-376 or
+   * MS-ODRAWXML text documents the exact legacy blend. Legacy PowerPoint
+   * 97-2003 hint, not observed in any real-world corpus file this project
+   * has collected and not settable from any modern PowerPoint UI; see
+   * `docs/guide/limitations.md`.
    *
    * ECMA-376 §19.3.1.2 (CT_BackgroundProperties).
    */
   backgroundShadeToTitle?: boolean;
   transition?: PptxSlideTransition;
   animations?: PptxElementAnimation[];
+  /**
+   * Read-only anchors for the deck's own (non-editor-authored) effect
+   * groups, merged with `animations` by the authoring UI so drag-to-reorder
+   * can target any position in the full sequence. See
+   * {@link PptxAnimationTimelineAnchor}.
+   */
+  animationTimelineAnchors?: PptxAnimationTimelineAnchor[];
   /** Native OOXML animation data parsed from `p:timing`. */
   nativeAnimations?: PptxNativeAnimation[];
   /** Preserved raw `p:timing` XML for lossless round-trip of native animations. */
@@ -8703,12 +8837,25 @@ interface IPptxHandlerRuntimeFactory {
  */
 /** Supported encryption algorithms. */
 type EncryptionAlgorithm = 'AES128' | 'AES256';
+/**
+ * Which OOXML encryption scheme to write when creating a password-protected
+ * file. Real PowerPoint can write and open either scheme; this library
+ * defaults to 'agile' (Office 2010+), matching PowerPoint's own default.
+ */
+type EncryptionScheme = 'agile' | 'standard';
 /** Encryption options for creating encrypted files. */
 interface EncryptionOptions {
   /** The encryption algorithm to use (defaults to AES256). */
   algorithm?: EncryptionAlgorithm;
   /** Number of hash iterations for key derivation (defaults to 100000). Lower values speed up tests. */
   spinCount?: number;
+  /**
+   * Which encryption scheme to write (defaults to 'agile'). 'standard'
+   * writes the ECMA-376 Standard scheme (Office 2007-compatible: a single
+   * password-derived AES-CBC key with a zero IV over the whole package),
+   * mirroring the scheme this library already knows how to decrypt.
+   */
+  encryptionScheme?: EncryptionScheme;
 }
 //#endregion
 //#region src/core/PptxHandlerCore.d.ts
@@ -10485,6 +10632,49 @@ interface PowerPointViewerProps {
    * to the SVG surface renderer. Default `false`.
    */
   surfaceChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js bar3D-chart renderer. When `true`,
+   * `bar3D` charts render as camera-orbitable real box meshes (drag to
+   * rotate, scroll to zoom) instead of the flat SVG oblique-projection
+   * illusion. Chart marks are not selectable/draggable in this mode.
+   * Requires the optional `three` peer dependency; when it is not installed
+   * (or the chart has no plottable grid, or it is a horizontal 3-D Bar), the
+   * viewer transparently falls back to the flat SVG bar3D renderer. Default
+   * `false`.
+   */
+  barChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js line3D-chart renderer. When `true`,
+   * `line3D` charts render as a camera-orbitable real tube-path mesh per
+   * series, one per depth ("series") plane (drag to rotate, scroll to zoom),
+   * instead of the flat SVG oblique-projection illusion. Chart marks are not
+   * selectable/draggable in this mode. Requires the optional `three` peer
+   * dependency; when it is not installed (or the chart has no plottable
+   * grid), the viewer transparently falls back to the flat SVG line3D
+   * renderer. Default `false`.
+   */
+  lineChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js area3D-chart renderer. When `true`,
+   * `area3D` charts render as a camera-orbitable real tube path + filled
+   * ribbon mesh per series, one per depth ("series") plane (drag to rotate,
+   * scroll to zoom), instead of the flat SVG oblique-projection illusion.
+   * Chart marks are not selectable/draggable in this mode. Requires the
+   * optional `three` peer dependency; when it is not installed (or the chart
+   * has no plottable grid), the viewer transparently falls back to the flat
+   * SVG area3D renderer. Default `false`.
+   */
+  areaChart3D?: boolean;
+  /**
+   * Opt in to the interactive Three.js pie3D-chart renderer. When `true`,
+   * `pie3D` charts render as camera-orbitable real wedge meshes (drag to
+   * rotate, scroll to zoom) instead of the flat SVG oblique-projection
+   * illusion. Chart marks are not selectable/draggable in this mode.
+   * Requires the optional `three` peer dependency; when it is not installed
+   * (or the chart has no plottable series), the viewer transparently falls
+   * back to the flat SVG pie3D renderer. Default `false`.
+   */
+  pieChart3D?: boolean;
   /**
    * Hide individual toolbar buttons and/or ribbon tabs instead of the whole
    * toolbar. Accepts any mix of button ids (`share`, `broadcast`, `export`,

package/dist/viewer/index.js

@@ -1,96 +1,96 @@
 'use strict';
 
-var chunkZ4RY432D_js = require('../chunk-Z4RY432D.js');
-require('../chunk-GJ7E44BG.js');
-var chunk7HUYHWQS_js = require('../chunk-7HUYHWQS.js');
-var chunkUU6NFFRR_js = require('../chunk-UU6NFFRR.js');
-require('../chunk-U6A5FWWE.js');
-var chunk35YJ5RLU_js = require('../chunk-35YJ5RLU.js');
+var chunkA5EUD6UU_js = require('../chunk-A5EUD6UU.js');
+require('../chunk-VQVC27WL.js');
+var chunkPOAZ53L5_js = require('../chunk-POAZ53L5.js');
+var chunk7JZLE56X_js = require('../chunk-7JZLE56X.js');
+require('../chunk-PIUB7R2K.js');
+var chunkT7BAPZBY_js = require('../chunk-T7BAPZBY.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkZ4RY432D_js.CollaborationProvider; }
+  get: function () { return chunkA5EUD6UU_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkZ4RY432D_js.CollaborationStatusIndicator; }
+  get: function () { return chunkA5EUD6UU_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkZ4RY432D_js.PowerPointViewer; }
+  get: function () { return chunkA5EUD6UU_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkZ4RY432D_js.RemoteUserCursors; }
+  get: function () { return chunkA5EUD6UU_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkZ4RY432D_js.UserAvatarBar; }
+  get: function () { return chunkA5EUD6UU_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunk7HUYHWQS_js.isAudienceTab; }
+  get: function () { return chunkPOAZ53L5_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunk7HUYHWQS_js.parseAudienceNonce; }
+  get: function () { return chunkPOAZ53L5_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunk7HUYHWQS_js.useCollaborativeHistory; }
+  get: function () { return chunkPOAZ53L5_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunk7HUYHWQS_js.useCollaborativeState; }
+  get: function () { return chunkPOAZ53L5_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunk7HUYHWQS_js.usePresenceTracking; }
+  get: function () { return chunkPOAZ53L5_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunk7HUYHWQS_js.useThemeSwitching; }
+  get: function () { return chunkPOAZ53L5_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunk7HUYHWQS_js.useYjsProvider; }
+  get: function () { return chunkPOAZ53L5_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkUU6NFFRR_js.getAnimationInitialStyle; }
+  get: function () { return chunk7JZLE56X_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.clearAudienceContent; }
+  get: function () { return chunkT7BAPZBY_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "forgetSessionDeck", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.forgetSessionDeck; }
+  get: function () { return chunkT7BAPZBY_js.forgetSessionDeck; }
 });
 Object.defineProperty(exports, "getSessionTabId", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.getSessionTabId; }
+  get: function () { return chunkT7BAPZBY_js.getSessionTabId; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.loadAudienceContent; }
+  get: function () { return chunkT7BAPZBY_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "loadSessionDeck", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.loadSessionDeck; }
+  get: function () { return chunkT7BAPZBY_js.loadSessionDeck; }
 });
 Object.defineProperty(exports, "rememberSessionDeck", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.rememberSessionDeck; }
+  get: function () { return chunkT7BAPZBY_js.rememberSessionDeck; }
 });
 Object.defineProperty(exports, "restoreSessionDeck", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.restoreSessionDeck; }
+  get: function () { return chunkT7BAPZBY_js.restoreSessionDeck; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunk35YJ5RLU_js.storeAudienceContent; }
+  get: function () { return chunkT7BAPZBY_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-CY24IMMZ.mjs';
-import '../chunk-EVXT7HLY.mjs';
-export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-YISXETNN.mjs';
-export { getAnimationInitialStyle } from '../chunk-QG7TXWXP.mjs';
-import '../chunk-L5MNLIQF.mjs';
-export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-M2TISD4A.mjs';
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-TIEUZCYQ.mjs';
+import '../chunk-PQNZCSB7.mjs';
+export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-VMLKJDA5.mjs';
+export { getAnimationInitialStyle } from '../chunk-SNWAM2XJ.mjs';
+import '../chunk-MKPSUHUH.mjs';
+export { clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from '../chunk-BP2L2KOZ.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "3.0.3",
+	"version": "3.1.0",
 	"description": "React PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",
@@ -76,13 +76,13 @@
 	},
 	"dependencies": {
 		"clsx": "^2.1.1",
-		"dompurify": "^3.4.13",
+		"dompurify": "^3.4.14",
 		"html2canvas-pro": "^2.3.2",
-		"pptx-viewer-mcp": "^2.1.6",
+		"pptx-viewer-mcp": "^2.1.7",
 		"tailwind-merge": "^3.6.0"
 	},
 	"devDependencies": {
-		"@ai-sdk/react": "^4.0.59",
+		"@ai-sdk/react": "^4.0.76",
 		"@tailwindcss/cli": "^4.3.3",
 		"@types/dompurify": "^3.2.0",
 		"@types/react": "^19.2.17",
@@ -97,7 +97,7 @@
 		"yjs": "^13.6.32"
 	},
 	"peerDependencies": {
-		"@ai-sdk/react": "^4.0.59",
+		"@ai-sdk/react": "^4.0.76",
 		"ai": ">=6 <8",
 		"fast-xml-parser": "^5.10.1",
 		"framer-motion": "^12.42.2",

package/dist/PowerPointViewer-SkkxAGKa.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PowerPointViewer-SkkxAGKa.d.ts","names":[],"sources":["../src/viewer/utils/animation-effects.ts","../src/viewer/PowerPointViewer.tsx"],"mappings":";;;;;iBAmBgB,yBACf,QAAQ,iCACR,kBAAkB,sBAChB,MAAM;;;;;;;;;;;;cCmGI,kCAAgB,0BAAA,wCAAA,cAAA"}