pptx-svelte-viewer 3.0.2 → 3.1.0

package/dist/i18n.js

@@ -1,4 +1,4 @@
-import { a as s, c as e, i as t, n as r, o, r as n, s as i, t as l } from "./translator-CAcsC5k6.js";
+import { a as s, c as e, i as t, n as r, o, r as n, s as i, t as l } from "./translator-Dkvcrdba.js";
 export {
   o as LOCALE_CATALOG,
   l as createTranslator,

package/dist/index.d.ts

@@ -1678,6 +1678,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`). */
@@ -5379,6 +5405,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`.
@@ -5937,6 +5978,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. */
@@ -6038,6 +6092,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). */
@@ -6321,6 +6386,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
@@ -7024,8 +7135,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`).
@@ -7299,17 +7421,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. */
@@ -8701,12 +8835,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
@@ -10321,6 +10468,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;
     /**
      * Enable in-place editing: click to select an element, drag to move, use the
      * 8 handles to resize (Shift locks aspect) and the rotate handle to rotate,

package/dist/index.js

@@ -1,5 +1,5 @@
-import { $ as e, G as a, J as t, K as o, Q as i, W as r, X as n, Y as l, Z as S, a as d, at as m, c as p, ct as T, dt as v, et as P, ft as g, it as u, l as h, lt as c, mt as A, nt as C, o as N, ot as f, pt as k, q as D, rt as E, s as x, st as b, t as B, tt as I, u as O, ut as _ } from "./export-Bdkc32jU.js";
-import { i as R } from "./translator-CAcsC5k6.js";
+import { $ as e, G as a, J as t, K as o, Q as i, W as r, X as n, Y as l, Z as S, a as d, at as m, c as p, ct as T, dt as v, et as P, ft as g, it as u, l as h, lt as c, mt as A, nt as C, o as N, ot as f, pt as k, q as D, rt as E, s as x, st as b, t as B, tt as I, u as O, ut as _ } from "./export-DHNhKSg6.js";
+import { i as R } from "./translator-Dkvcrdba.js";
 import "./i18n.js";
 export {
   r as PPTX_OPEN_ACCEPT,