pptx-svelte-viewer 4.5.0 → 4.7.0

package/dist/index.js

@@ -1,41 +1,55 @@
-import { $t as e, Ap as a, Fh as o, Hl as t, Ih as i, Lh as r, Nl as l, Ph as n, Rh as S, Sp as m, Ul as d, Uo as p, cs as h, dd as v, ds as T, fs as g, gs as P, in as c, kl as u, ls as f, oc as A, qu as C, sh as N, tf as k, vc as E, zc as D, zl as b } from "./transition-overlay-BfpjfjU4.js";
-import { i as I } from "./translator-C-KdhJw4.js";
-import { M as B, a as L, c as O, l as R, o as _, s as V, t as w } from "./export-Bln1wHMQ.js";
+import { $u as a, An as e, At as o, Ef as r, F as t, Fr as i, Hu as S, Ir as _, Iu as T, Ju as l, Ms as n, N as E, Pr as I, Qu as A, Rr as m, Tn as D, Tt as N, Vl as O, Vm as P, Xn as d, Ym as C, _p as p, a_ as c, bl as R, cc as g, cl as v, dc as u, fc as f, fn as B, gc as h, i_ as M, kg as V, lc as k, mn as F, o_ as b, pn as x, r_ as L, s_ as G, sf as X, xr as U, z as W } from "./transition-overlay-BjAhkWT1.js";
+import { i as y } from "./translator-D5VddVYr.js";
+import { M as K, a as z, c as J, l as Q, o as Y, s as $, t as j } from "./export-BmYgdMk2.js";
 import "./i18n.js";
 export {
-  e as PPTX_OPEN_ACCEPT,
-  c as PRESENTATION_OPEN_EXTENSIONS,
-  w as PowerPointViewer,
-  p as createImageElementFromFile,
-  h as defaultCssVars,
-  f as defaultRadius,
-  T as defaultThemeColors,
-  g as deleteAutosaveSnapshot,
-  P as describeCollaborationShellState,
-  L as exportAllSlidesToSvg,
-  _ as exportAllSlidesToSvgBlobs,
-  V as exportSlideAsSvg,
-  O as exportSlideToSvg,
-  R as exportSlideToSvgBlob,
-  A as forgetSessionDeck,
-  E as getAutosaveSnapshot,
-  D as getSessionTabId,
-  u as isLegacyBinaryPresentation,
-  l as isSupportedPresentationFile,
-  b as listAutosaveSnapshots,
-  t as loadPresentationDeck,
-  d as loadSessionDeck,
-  C as parsePresentationSessionId,
-  v as presentationBaseName,
-  I as registerTranslations,
-  k as rememberSessionDeck,
-  B as renderToCanvas,
-  m as restoreSessionDeck,
-  a as savedPresentationFileName,
-  N as themeToCssVars,
-  n as vermilionDarkColors,
-  o as vermilionDarkTheme,
-  i as vermilionLightColors,
-  r as vermilionLightTheme,
-  S as vermilionRadius
+  E as BACKSTAGE_CARD_IDS,
+  t as BACKSTAGE_PAGE_IDS,
+  W as CANVAS_CONTEXT_MENU_COMMAND_IDS,
+  N as EDITOR_SHORTCUT_ACTION_IDS,
+  o as ELEMENT_CONTEXT_MENU_COMMAND_IDS,
+  B as OPTIONS_PAGE_IDS,
+  x as OPTIONS_SECTION_IDS,
+  F as OPTIONS_SETTING_IDS,
+  D as PPTX_OPEN_ACCEPT,
+  e as PRESENTATION_OPEN_EXTENSIONS,
+  j as PowerPointViewer,
+  d as RIBBON_TAB_IDS,
+  U as TOOLBAR_BUTTON_IDS,
+  I as VIEWER_DIALOG_IDS,
+  i as VIEWER_EXPORT_FORMAT_IDS,
+  _ as VIEWER_FEATURE_IDS,
+  m as VIEWER_PANEL_IDS,
+  n as createImageElementFromFile,
+  g as defaultCssVars,
+  k as defaultRadius,
+  u as defaultThemeColors,
+  f as deleteAutosaveSnapshot,
+  h as describeCollaborationShellState,
+  z as exportAllSlidesToSvg,
+  Y as exportAllSlidesToSvgBlobs,
+  $ as exportSlideAsSvg,
+  J as exportSlideToSvg,
+  Q as exportSlideToSvgBlob,
+  v as forgetSessionDeck,
+  R as getAutosaveSnapshot,
+  O as getSessionTabId,
+  T as isLegacyBinaryPresentation,
+  S as isSupportedPresentationFile,
+  l as listAutosaveSnapshots,
+  A as loadPresentationDeck,
+  a as loadSessionDeck,
+  X as parsePresentationSessionId,
+  r as presentationBaseName,
+  y as registerTranslations,
+  p as rememberSessionDeck,
+  K as renderToCanvas,
+  P as restoreSessionDeck,
+  C as savedPresentationFileName,
+  V as themeToCssVars,
+  L as vermilionDarkColors,
+  M as vermilionDarkTheme,
+  c as vermilionLightColors,
+  b as vermilionLightTheme,
+  G as vermilionRadius
 };

package/dist/internals.d.ts

@@ -1481,8 +1481,16 @@ interface TextStyle {
   textOutlineWidth?: number;
   /** Text outline colour as hex string (`a:rPr > a:ln > a:solidFill`). */
   textOutlineColor?: string;
+  /** Text outline dash preset (`a:rPr > a:ln > a:prstDash/@val`), e.g. `dash`; absent for solid. */
+  textOutlineDash?: string;
   /** When true, the text body has no fill (`a:rPr > a:noFill`), producing hollow/outline-only text. */
   textFillNone?: boolean;
+  /**
+   * When true, the run authored an EMPTY `<a:effectLst/>`: an explicit "no
+   * effects" override that blocks an inherited shadow or glow. Kept so a
+   * rewrite re-emits it instead of letting the inherited effect return.
+   */
+  textEffectsExplicitNone?: boolean;
   /** Superscript/subscript baseline shift as percentage (`a:rPr/@baseline`). Positive = super, negative = sub. */
   baseline?: number;
   /** Character spacing in hundredths of a point (`a:rPr/@spc`). */
@@ -1516,6 +1524,25 @@ interface TextStyle {
   textFillPatternForeground?: string;
   /** Text-level pattern background colour. */
   textFillPatternBackground?: string;
+  /**
+   * Raw `a:rPr > a:blipFill` XML, preserved verbatim for round-trip
+   * serialization AND as the input to the image resolution pass that fills
+   * in {@link textFillBlipUrl} (parsing a run's fill happens synchronously,
+   * with no zip/relationship access at that point; resolving the blip to a
+   * displayable URL needs both, so it happens in a later async pass over
+   * the slide's parsed elements, mirroring how a shape's OWN image fill is
+   * resolved). A picture-filled text run (`a:rPr > a:blipFill`) was
+   * documented as handled ("Handles gradient fills, pattern fills, and
+   * image fills on text runs") but never actually parsed, so it silently
+   * fell through to the run's plain `color` and rendered solid black
+   * (COM-verified: `audit-text` slide 13's "PICTURE FILL" run shows the
+   * fill image through the glyphs in PowerPoint).
+   */
+  textFillBlipXml?: XmlObject;
+  /** Resolved displayable URL for {@link textFillBlipXml}, or the archive-relative path when unresolved (lazy decode). */
+  textFillBlipUrl?: string;
+  /** Tiling mode for {@link textFillBlipUrl} (`a:blipFill/a:tile` present -> 'tile', else 'stretch'). */
+  textFillBlipMode?: 'stretch' | 'tile';
   hyperlink?: string;
   /** Relationship ID for the hyperlink (`a:hlinkClick/@r:id`) — preserved for round-trip serialization. */
   hyperlinkRId?: string;
@@ -1601,6 +1628,13 @@ interface TextStyle {
     position: number;
     align: 'l' | 'ctr' | 'r' | 'dec';
     leader?: 'none' | 'dot' | 'hyphen' | 'underscore';
+    /**
+     * True when the source spelled out the schema-default `@algn="l"`, so the
+     * writer re-emits it instead of treating it as an omitted default.
+     */
+    alignAuthored?: boolean;
+    /** True when the source spelled out the schema-default `@leader="none"`. */
+    leaderAuthored?: boolean;
   }>;
   /**
    * True when the paragraph's own `a:pPr` authored an EMPTY `<a:tabLst/>`
@@ -1964,6 +1998,19 @@ interface TextStyle {
    * convention used for {@link bulletInfo} / {@link endParaRunProperties}).
    */
   paragraphDefaultRunPropertiesXml?: XmlObject;
+  /**
+   * The bullet colour / size / typeface children (`a:buClrTx`, `a:buClr`,
+   * `a:buSzTx`, `a:buSzPct`, `a:buSzPts`, `a:buFontTx`, `a:buFont`) a
+   * paragraph authored in its own `<a:pPr>` WITHOUT a bullet type
+   * (`a:buNone` / `a:buChar` / `a:buAutoNum` / `a:buBlip`), captured
+   * verbatim in source order. Such a paragraph restyles an inherited bullet
+   * rather than declaring one, so its {@link BulletInfo} resolves from the
+   * cascade and is (correctly) not written back; without this capture the
+   * paragraph's own override vanished on every rewrite.
+   *
+   * Only meaningful on a paragraph's own authored properties.
+   */
+  paragraphBulletPropertiesXml?: XmlObject;
 }
 /**
  * Structured bullet metadata attached to the first {@link TextSegment}
@@ -3109,6 +3156,26 @@ type PptxChartMarkerSymbol = 'circle' | 'dash' | 'diamond' | 'dot' | 'none' | 'p
  */
 type PptxChartScatterStyle = 'none' | 'line' | 'lineMarker' | 'marker' | 'smooth' | 'smoothMarker';
 /** Shape properties extracted from c:spPr for chart formatting. */
+/**
+ * A render-ready gradient fill from a chart `c:spPr/a:gradFill` (chart area,
+ * plot area or series). Positions are 0..100; a linear gradient's `angle` is
+ * in degrees clockwise from left-to-right (`a:lin/@ang`); a radial (`a:path`)
+ * gradient centres on `focalPoint` (0..1 fractions of the box), the middle
+ * when absent.
+ */
+interface PptxChartGradientFill {
+  type: 'linear' | 'radial';
+  stops: Array<{
+    color: string;
+    position: number;
+    opacity?: number;
+  }>;
+  angle?: number;
+  focalPoint?: {
+    x: number;
+    y: number;
+  };
+}
 interface PptxChartShapeProps {
   fillColor?: string;
   strokeColor?: string;
@@ -3434,6 +3501,12 @@ interface PptxChartSeries {
    */
   idx?: number;
   values: number[];
+  /**
+   * Series gradient fill (`c:ser/c:spPr/a:gradFill`), painted on every mark
+   * of the series that has no per-point override. Render-only: the series'
+   * own `c:spPr` round-trips untouched.
+   */
+  gradientFill?: PptxChartGradientFill;
   /**
    * Per-series x values from `c:ser/c:xVal` (scatter and bubble series only).
    *
@@ -3608,6 +3681,12 @@ interface PptxChartFilteredSeries {
  * and `c:dLblPos`.
  */
 interface PptxChartDataLabelOptions {
+  /** Label box fill/outline (`c:dLbls/c:spPr`), see `chart-data-label-box.ts`. */
+  labelShape?: PptxChartShapeProps;
+  /** Callout geometry of the label box (`c15:spPr/a:prstGeom/@prst`, e.g. `wedgeRectCallout`). */
+  calloutShape?: string;
+  /** The chart15 extension's `c15:showLeaderLines`, which wins for a moved label's leader line. */
+  extLeaderLines?: boolean;
   /** Show the numeric value (`c:showVal`). */
   showValue?: boolean;
   /** Show the category name (`c:showCatName`). */
@@ -3733,6 +3812,10 @@ interface PptxChartStyle {
   chartAreaFill?: string;
   /** Plot-area fill from `c:plotArea/c:spPr`. See {@link chartAreaFill}. */
   plotAreaFill?: string;
+  /** Chart-area gradient (`c:chartSpace/c:spPr/a:gradFill`); wins over {@link chartAreaFill}. */
+  chartAreaGradient?: PptxChartGradientFill;
+  /** Plot-area gradient (`c:plotArea/c:spPr/a:gradFill`); wins over {@link plotAreaFill}. */
+  plotAreaGradient?: PptxChartGradientFill;
   /** Whether data labels are shown. */
   hasDataLabels?: boolean;
   /** Chart-level data-label content/position options (when `hasDataLabels`). */
@@ -7099,7 +7182,15 @@ type PptxAnimationTimingCurve = 'ease' | 'ease-in' | 'ease-out' | 'linear';
 /** Repeat mode for animations. */
 type PptxAnimationRepeatMode = 'untilNextClick' | 'untilEndOfSlide';
 /** Animation trigger type from OOXML `p:cTn`. */
-type PptxAnimationTrigger = 'onClick' | 'onShapeClick' | 'onHover' | 'afterPrevious' | 'withPrevious' | 'afterDelay';
+type PptxAnimationTrigger = 'onClick' | 'onShapeClick' | 'onHover' | 'afterPrevious' | 'withPrevious' | 'afterDelay' |
+/**
+ * Starts when a media element's playback reaches a named bookmark
+ * (PowerPoint's "Trigger > On Bookmark"). The media element is
+ * {@link PptxElementAnimation.triggerShapeId} and the bookmark
+ * {@link PptxElementAnimation.triggerBookmark}; saved as an interactive
+ * sequence gated on `p:cond evt="onMediaBookmark"` with a `p14:bmkTgt`.
+ */
+'onMediaBookmark';
 /**
  * Native animation kind. The historic shape-targeted preset animations are
  * implicitly the default kind (`undefined`). Media animations (`p:audio`,
@@ -7252,8 +7343,13 @@ interface PptxNativeAnimation {
   target?: PptxAnimationTarget;
   /** Trigger type. */
   trigger?: PptxAnimationTrigger;
-  /** Shape ID that triggers this animation when clicked (interactive sequence). */
+  /**
+   * Shape ID that triggers this animation: the clicked shape of an
+   * interactive sequence, or the media element of an `onMediaBookmark` one.
+   */
   triggerShapeId?: string;
+  /** Bookmark name an `onMediaBookmark` interactive sequence waits for. */
+  triggerBookmark?: string;
   /** Whether this effect belongs to an OOXML `interactiveSeq`. */
   interactiveSequence?: boolean;
   /** Whether `p:endSync/p:rtn[@val="all"]` makes that sequence replayable. */
@@ -7752,12 +7848,15 @@ interface PptxAttributeAnimation {
   /**
    * `p:anim/@_p14:bounceEnd` (Office 2010 `p14` extension attribute,
    * MS-OI29500), normalized to a 0-1 fraction of this behaviour's own
-   * duration. PowerPoint's Fly In "Bounce End" effect option writes this on
-   * the position-ramp `p:anim` node(s): the fraction of the duration at
-   * which the primary travel completes, with the remainder spent bouncing
-   * and settling at the final value. Mirrored verbatim by PowerPoint onto
-   * the enclosing `p:cTn/@_p14:presetBounceEnd`. Absent for every animation
-   * that doesn't use this effect option (the overwhelming majority).
+   * duration. PowerPoint's "Bounce End" effect option (COM:
+   * `Effect.Timing.BounceEnd` + `BounceEndIntensity`) writes this on the
+   * position-ramp `p:anim` node(s): the share of the duration spent
+   * BOUNCING at the end. Measured from PowerPoint's own CreateVideo frames,
+   * the travel completes at `1 - bounceEnd` and the rest is a damped
+   * oscillation about the final value (see shared's `animation-bounce-end`).
+   * Mirrored verbatim by PowerPoint onto the enclosing
+   * `p:cTn/@_p14:presetBounceEnd`. Absent for every animation that doesn't
+   * use this effect option (the overwhelming majority).
    */
   bounceEnd?: number;
 }
@@ -7935,9 +8034,24 @@ interface PptxElementAnimation {
   durationMs?: number;
   delayMs?: number;
   order?: number;
+  /**
+   * The {@link order} the loader derived from the slide's `p:timing` tree for
+   * an entry whose `pptx:editorMeta` record authored no `@order`. The tree
+   * already expresses that position (and every load re-derives it), so the
+   * writer omits `@order` while `order` still equals this value; a reorder
+   * changes `order` and the attribute is written again. Load-time bookkeeping
+   * only; never set it by hand.
+   */
+  orderFromTimeline?: number;
   trigger?: PptxAnimationTrigger;
-  /** Shape ID that triggers this animation when clicked (interactive sequence). */
+  /**
+   * Shape ID that triggers this animation: the shape clicked for
+   * `onShapeClick`, or the media element whose bookmark fires it for
+   * `onMediaBookmark`.
+   */
   triggerShapeId?: string;
+  /** Bookmark name (`p14:bmk/@name`) an `onMediaBookmark` trigger waits for. */
+  triggerBookmark?: string;
   timingCurve?: PptxAnimationTimingCurve;
   repeatCount?: number;
   repeatMode?: PptxAnimationRepeatMode;

package/dist/internals.js

@@ -1,26 +1,26 @@
-import { G as a, Jt as t, Mc as T, Mn as i, Nn as n, Pt as S, Rf as e, Vc as _, Yt as A, er as E, ft as o, gn as I, lr as N, mp as r, ot as R, qt as O, rt as M, sp as D, t as l, tp as P, vp as L, xc as v, zf as F } from "./transition-overlay-BfpjfjU4.js";
+import { Cl as a, Ct as T, Hn as n, Lm as i, Nm as e, Or as S, Pl as _, Tm as t, Ul as A, Vr as E, Y as o, _t as I, ar as r, bn as N, em as R, en as O, mt as l, or as m, t as M, tm as D, xn as L, ym as P, yn as C } from "./transition-overlay-BjAhkWT1.js";
 export {
-  a as CINEMATIC_TRANSITION_KEYFRAMES,
-  M as DEFAULT_MORPH_DURATION_MS,
-  R as DEFAULT_TRANSITION_DURATION_MS,
-  o as EASE,
-  S as INSTANT,
-  O as P14_TRANSITION_KEYFRAMES,
-  t as P14_TRANSITION_KEYFRAMES_2,
-  A as P14_TRANSITION_KEYFRAMES_ALL,
-  l as PresentationTransitionOverlay,
-  I as RANDOM_ELIGIBLE_TYPES,
-  i as SLIDE_TRANSITION_KEYFRAMES,
-  n as SLIDE_TRANSITION_KEYFRAMES_CSS,
-  E as TRANSITION_SPEED_DURATION_MS,
-  N as WHEEL_SPOKE_COUNTS,
-  v as getCinematicTransitionAnimations,
-  T as getP14TransitionAnimations,
-  _ as getSlideTransitionAnimations,
-  e as resolveDirection,
-  F as resolveDirection8,
+  o as CINEMATIC_TRANSITION_KEYFRAMES,
+  l as DEFAULT_MORPH_DURATION_MS,
+  I as DEFAULT_TRANSITION_DURATION_MS,
+  T as EASE,
+  O as INSTANT,
+  C as P14_TRANSITION_KEYFRAMES,
+  N as P14_TRANSITION_KEYFRAMES_2,
+  L as P14_TRANSITION_KEYFRAMES_ALL,
+  M as PresentationTransitionOverlay,
+  n as RANDOM_ELIGIBLE_TYPES,
+  r as SLIDE_TRANSITION_KEYFRAMES,
+  m as SLIDE_TRANSITION_KEYFRAMES_CSS,
+  S as TRANSITION_SPEED_DURATION_MS,
+  E as WHEEL_SPOKE_COUNTS,
+  a as getCinematicTransitionAnimations,
+  _ as getP14TransitionAnimations,
+  A as getSlideTransitionAnimations,
+  R as resolveDirection,
+  D as resolveDirection8,
   P as resolveOrientation,
-  D as resolveSlideTransition,
-  r as resolveTransitionDurationMs,
-  L as resolveWheelSpokeCount
+  t as resolveSlideTransition,
+  e as resolveTransitionDurationMs,
+  i as resolveWheelSpokeCount
 };