pptx-svelte-viewer 3.2.0 → 3.2.2

package/dist/index.d.ts

@@ -1229,7 +1229,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;
   /**
@@ -2166,6 +2173,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
@@ -4241,10 +4258,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
@@ -4295,10 +4317,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`.
@@ -5303,6 +5351,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. */
@@ -5567,6 +5631,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). */
@@ -5605,6 +5671,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). */
@@ -5639,6 +5707,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. */
@@ -5721,6 +5791,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. */
@@ -5769,6 +5841,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. */
@@ -5821,6 +5895,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';
@@ -5911,6 +5987,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. */
@@ -5956,6 +6036,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). */
@@ -5991,6 +6077,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. */
@@ -6080,6 +6168,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`. */
@@ -6236,6 +6332,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". */
@@ -6255,15 +6371,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 {
@@ -6380,6 +6508,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. */
@@ -7407,6 +7541,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/index.js

@@ -1,4 +1,4 @@
-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-BXumpOE0.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-Cwm0F4Ug.js";
 import { i as R } from "./translator-Cvwv7iQG.js";
 import "./i18n.js";
 export {