pptx-svelte-viewer 4.2.0 → 4.3.0

package/dist/internals.d.ts

@@ -1394,6 +1394,32 @@ interface TextStyle {
    * @see element-paragraph-geometry.ts
    */
   resolvedParagraphGeometry?: TextStyle;
+  /**
+   * Snapshot of the ELEMENT-scope `a:bodyPr` properties (vertical anchor,
+   * text direction, columns, overflow, autofit, body insets, text wrap, and
+   * the boolean/rotation attributes) as the load pipeline resolved them.
+   *
+   * A shape's own `a:bodyPr` is parsed first, then whatever it left
+   * `undefined` is back-filled from the placeholder / layout / master
+   * defaults (`applyPlaceholderBodyDefaults`), and a placeholder shape with
+   * no `a:bodyPr` of its own has the INHERITED one parsed as if it were its
+   * own. None of those three sources is distinguishable at
+   * `element.textStyle` once the cascade finishes, so a writer that
+   * re-emits every defined field turns an inherited anchor, inset, autofit
+   * mode or `rtlCol` into a value pinned on the slide forever (and an
+   * inherited `a:normAutofit` with no scale gets written back as
+   * `a:spAutoFit`, flipping AutoSize from "shrink text" to "resize shape").
+   *
+   * Present only on an `element.textStyle` that came from a parsed deck.
+   * The save path diffs the live style against this snapshot: a field that
+   * still matches is an inheritance artefact and the writer leaves the
+   * underlying `a:bodyPr` attribute untouched (whatever it already is,
+   * present or absent); a field that differs was authored or has since
+   * been edited and is written out.
+   *
+   * @see element-body-properties.ts
+   */
+  resolvedBodyProperties?: TextStyle;
   fontFamily?: string;
   fontSize?: number;
   /** When true, some form of autofit is in effect; see {@link autoFitMode} for which. */
@@ -1576,6 +1602,16 @@ interface TextStyle {
     align: 'l' | 'ctr' | 'r' | 'dec';
     leader?: 'none' | 'dot' | 'hyphen' | 'underscore';
   }>;
+  /**
+   * True when the paragraph's own `a:pPr` authored an EMPTY `<a:tabLst/>`
+   * (explicitly "no tab stops", overriding whatever the cascade would
+   * otherwise supply) rather than omitting the element entirely (inherit).
+   * fast-xml-parser gives a childless element as the empty string, so
+   * `tabLst` and no-`tabLst` are otherwise indistinguishable once `tabStops`
+   * comes back empty either way. Paragraph-scope only; not part of the
+   * element-level geometry cascade.
+   */
+  tabStopsExplicitEmpty?: boolean;
   /** Body text wrapping mode from `a:bodyPr/@wrap`. */
   textWrap?: 'square' | 'none';
   /** Preset text warp type from `a:bodyPr/a:prstTxWarp`. */
@@ -1618,6 +1654,20 @@ interface TextStyle {
    * serialised back on save, so it never disturbs the round-trip typefaces.
    */
   scriptFallbackFont?: string;
+  /**
+   * Set alongside {@link scriptFallbackFont} when the resolved {@link fontFamily}
+   * came only from the paragraph/list-style/theme CASCADE (the run's own
+   * `a:rPr` authored no `a:latin`/`a:ea`/`a:cs` of its own). A run always
+   * inherits SOME font this way (typically the theme's `+mn-lt`), so without
+   * this flag `fontFamily` was indistinguishable from a run that genuinely
+   * chose that font itself, and the renderer never applied the theme's
+   * per-script override (see #83): `+mn-lt` names only the LATIN member of
+   * the font scheme and was never meant to cover text in a different
+   * dominant script. An explicit `a:latin`/`a:ea`/`a:cs` authored on the run
+   * itself still always wins; only the cascade default yields to the
+   * script-specific override.
+   */
+  fontFamilyIsCascadeDefault?: boolean;
   /** Text language from `a:rPr/@lang`. */
   language?: string;
   /** Hyperlink mouse-over target from `a:hlinkMouseOver`. */
@@ -1970,6 +2020,18 @@ interface BulletInfo {
   /** When true, `<a:buSzTx/>` was specified — inherit the bullet size from
    *  the run text font size. */
   sizeInherit?: boolean;
+  /**
+   * True when this bullet resolution came from the paragraph's OWN `a:pPr`
+   * rather than the shape's `a:lstStyle`, an inherited placeholder, or the
+   * master's `a:defPPr` / `p:txStyles`. `resolveParagraphBulletInfo` walks
+   * that cascade and returns the first match, so without this flag a
+   * writer that re-emits every resolved `BulletInfo` in full pins an
+   * inherited bullet (e.g. a master `buFont="Arial"` / `buChar="•"`) onto
+   * every paragraph's own `a:pPr` the moment the slide is rewritten. The
+   * save path only writes the bullet group when this is `true`, mirroring
+   * how `paragraphProperties` gates every other per-paragraph field.
+   */
+  ownedByParagraph?: boolean;
 }
 /**
  * A single text run within a paragraph.
@@ -2012,6 +2074,23 @@ interface TextSegment {
   fieldParagraphPropertiesXml?: XmlObject;
   /** Raw OMML XML node for equation segments (from `a14:m` / `m:oMathPara`). */
   equationXml?: Record<string, unknown>;
+  /**
+   * The ORIGINAL top-level paragraph child that carried this equation,
+   * captured verbatim at parse time and keyed by its own tag: `{ 'a14:m':
+   * ... }`, `{ 'm:oMathPara': ... }`, `{ 'm:oMath': ... }`, or `{
+   * 'mc:AlternateContent': ... }` for an equation authored behind a
+   * Choice/Fallback switch. `equationXml` above is the resolved math content
+   * used for rendering (unwrapped one level for `a14:m`/`mc:AlternateContent`
+   * sources); this field exists solely so the writer can re-emit an UNTOUCHED
+   * equation byte-for-byte, Choice and Fallback both, instead of collapsing
+   * it to a bare math element PowerPoint's own writer never produces.
+   * `undefined` for a freshly inserted or edited equation, which the writer
+   * instead reconstructs from `equationXml` (always `{ 'm:oMathPara': ... }`
+   * or `{ 'm:oMath': ... }` for those cases). Any code that replaces
+   * `equationXml` on an existing segment must drop this field, or the writer
+   * would keep re-emitting the equation's OLD XML instead of the edit.
+   */
+  equationSourceXml?: Record<string, unknown>;
   /**
    * Optional equation number for numbered equations (e.g. "(1)", "(2.3)").
    * When present, the equation is rendered centered with the number right-aligned.
@@ -4998,6 +5077,18 @@ interface PptxSmartArtLayoutDefinition {
   rootNode: PptxSmartArtLayoutNode;
   /** Original definition retained for constraint evaluation and foreign rules. */
   rawXml?: XmlObject;
+  /**
+   * The un-parsed layout-definition part text (starting at `<dgm:layoutDef>`,
+   * XML declaration included). `rawXml` above loses the document order of
+   * differently-named siblings (the package-wide `fast-xml-parser`
+   * configuration groups children into one array per tag), which the
+   * per-point DiagramML engine (`core/utils/smartart-engine/`) needs to
+   * execute a `layoutNode` body's `forEach`/`choose`/`constrLst` statements
+   * in their real declared sequence - see that package's `ordered-xml.ts`.
+   * `undefined` when the part could not be read (matches `rawXml`'s own
+   * optionality); the engine falls back to the legacy interpreter then.
+   */
+  rawXmlText?: string;
 }
 //#endregion
 //#region src/core/types/smart-art-node.d.ts
@@ -6086,6 +6177,20 @@ interface PptxTableData {
    * present when there is at least one effect.
    */
   tableEffects?: ParsedTableStyleEffect[];
+  /**
+   * Table-cell-context default text size in points, resolved from the
+   * slide's master `p:otherStyle` (ECMA-376 §19.3.1.42 CT_TextListStyle,
+   * §19.3.1.52 for `p:txStyles`). PowerPoint sizes a table cell's text off
+   * this master default (commonly 18pt) whenever neither the run nor the
+   * (size-less) table style provides one; without it, cell text without an
+   * explicit `a:rPr@sz` fell back to the browser's own default font size
+   * (16px / 12pt) instead. A render-only hint: it is not part of any
+   * individual cell's parsed style and is never written back on save, so
+   * resaving an unstyled cell does not bake in an explicit size that was
+   * never authored. `undefined` when no master/otherStyle size resolves
+   * (renderers should leave the browser default in place in that case).
+   */
+  defaultCellFontSize?: number;
 }
 /**
  * A single fill reference within a table style section.
@@ -6111,6 +6216,14 @@ interface ParsedTableStyleFill {
   tint?: number;
   /** Shade value (0-100 000). */
   shade?: number;
+  /**
+   * Alpha (opacity) value (0-100 000, where 100 000 is fully opaque) from an
+   * `a:alpha` child of `a:schemeClr`/`a:srgbClr`. Several built-in table
+   * styles (e.g. "Light Style 1/3", "Themed Style 1/2") band their rows with
+   * a partially transparent tint of the theme colour rather than a tint/shade
+   * blend.
+   */
+  alpha?: number;
   /** Explicit sRGB hex colour (e.g. `#FF8800`) from `a:srgbClr`. */
   color?: string;
   /** The fill was `a:noFill`: renders transparent and clears lower layers. */
@@ -6738,6 +6851,20 @@ interface ContentPartInkStroke {
    * NAMES differ.
    */
   tiltEncoding?: 'vector' | 'azimuthAltitude';
+  /**
+   * Per-point timestamps (milliseconds), decoded from the source InkML
+   * trace's `T` channel when it declared one.
+   *
+   * Absent for the overwhelming majority of real decks: PowerPoint's own
+   * SaveAs output declares only `X`/`Y` and has no per-point time channel at
+   * all (see `contentpart-real-ink-roundtrip.test.ts`'s fixture), so this is
+   * populated only for InkML sources that genuinely author one (a captured
+   * digitizer session, OneNote, a Surface Hub export). When present, ink
+   * replay ("watch the ink get drawn") uses each stroke's own first/last
+   * timestamp to time its reveal instead of the fixed per-stroke cascade; see
+   * `pptx-viewer-shared`'s `render/ink-replay-timeline.ts`.
+   */
+  pointTimestamps?: number[];
 }
 /**
  * A content-part element wrapped in `mc:AlternateContent`.
@@ -6782,6 +6909,28 @@ interface ZoomPptxElement extends PptxElementBase, PptxImageProperties {
   summaryTargets?: SummaryZoomTarget[];
   /** Layout mode authored on the Summary Zoom container. */
   summaryLayout?: 'grid' | 'fixed';
+  /**
+   * `zmPr/@returnToParent` (MS-PPTX `CT_ZoomObjectProperties`, shared by all
+   * three Zoom kinds): whether continuing forward from the destination slide
+   * during a live show returns to this Zoom's origin slide instead of
+   * advancing linearly through the deck. OOXML default is `true` when the
+   * attribute is present but this codebase leaves it `undefined` when the
+   * source XML omits it, so a round-trip never fabricates the attribute.
+   * For `zoomType: 'summary'`, this mirrors the first tile's own value; see
+   * {@link SummaryZoomTarget.returnToParent} for the per-tile value.
+   */
+  returnToParent?: boolean;
+  /**
+   * `zmPr/@transitionDur` (MS-PPTX `CT_ZoomObjectProperties`): the
+   * zoom-transition length in milliseconds. PowerPoint's own writer emits a
+   * unitless decimal-millisecond value for every OOXML `ST_UniversalTimeOffset`
+   * this codebase has observed (see the media-trim/-fade parsers), so this
+   * follows the same convention rather than the full TIMEOFFSET grammar's
+   * unit suffixes. Undefined uses the destination slide's own transition.
+   * For `zoomType: 'summary'`, this mirrors the first tile's own value; see
+   * {@link SummaryZoomTarget.transitionDurationMs} for the per-tile value.
+   */
+  transitionDurationMs?: number;
 }
 /** A single section tile within a PowerPoint Summary Zoom container. */
 interface SummaryZoomTarget extends PptxImageProperties {
@@ -6797,6 +6946,10 @@ interface SummaryZoomTarget extends PptxImageProperties {
   offsetFactorY?: number;
   scaleFactorX?: number;
   scaleFactorY?: number;
+  /** This tile's own `zmPr/@returnToParent`; see {@link ZoomPptxElement.returnToParent}. */
+  returnToParent?: boolean;
+  /** This tile's own `zmPr/@transitionDur` in milliseconds; see {@link ZoomPptxElement.transitionDurationMs}. */
+  transitionDurationMs?: number;
   rawXml?: XmlObject;
 }
 /**
@@ -7517,6 +7670,17 @@ interface PptxAttributeAnimation {
    * IS consulted regardless of this field's value. Absent means `lin`.
    */
   calcMode?: 'discrete' | 'lin' | 'fmla';
+  /**
+   * `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).
+   */
+  bounceEnd?: number;
 }
 /** Signed HSL channel deltas parsed from `p:animClr/p:by/p:hsl`. */
 interface PptxHslColorDelta {
@@ -7598,7 +7762,19 @@ interface PptxTextAnimationTarget {
  * These map directly to OOXML condition event attribute values
  * (ISO/IEC 29500-1 S19.5.28 CT_TLTimeCondition).
  */
-type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick' | 'onMouseOver' | 'onMouseOut' | 'onNext' | 'onPrev' | 'onStopAudio' | 'onDblClick';
+type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick' | 'onMouseOver' | 'onMouseOut' | 'onNext' | 'onPrev' | 'onStopAudio' | 'onDblClick' | 'onMediaBookmark';
+/**
+ * `p14:bmkTgt` (Office 2010 `p14` extension, MS-OI29500): names the specific
+ * media element and bookmark an `evt="onMediaBookmark"` condition fires for.
+ * `bookmarkName` matches a `p14:bmk/@_name` on that media element's own
+ * `p14:bmkLst` (see `MediaBookmark.label` in `core/types/elements.ts`).
+ */
+interface PptxMediaBookmarkTarget {
+  /** `p14:bmkTgt/@_spid`: the media element's shape id. */
+  shapeId: string;
+  /** `p14:bmkTgt/@_bmkName`: the bookmark's name. */
+  bookmarkName: string;
+}
 /**
  * Structured representation of a single OOXML animation condition
  * from `p:cond` elements inside `p:stCondLst` or `p:endCondLst`.
@@ -7618,6 +7794,11 @@ type AnimationConditionEvent = 'onBegin' | 'onEnd' | 'begin' | 'end' | 'onClick'
 interface AnimationCondition {
   /** Event that triggers the condition. */
   event?: AnimationConditionEvent;
+  /**
+   * The media element/bookmark this condition fires for, when
+   * {@link event} is `onMediaBookmark`. See {@link PptxMediaBookmarkTarget}.
+   */
+  bookmarkTarget?: PptxMediaBookmarkTarget;
   /** Delay in milliseconds (from `@_delay`). "indefinite" is represented as -1. */
   delay?: number;
   /** Target time node ID reference (from `@_tn`). */

package/dist/internals.js

@@ -1,26 +1,26 @@
-import { An as a, Dc as n, G as T, If as i, Jf as t, Jt as S, Kt as e, Nt as A, Qf as _, Qn as E, Sf as I, Vf as o, at as N, dt as r, jn as R, mn as O, nt as D, or as M, qt as l, sc as L, t as P, vc as v, xf as F } from "./transition-overlay-BcUomRXK.js";
+import { $f as a, $n as T, Ac as i, Ef as n, G as t, Jt as S, Kf as e, Mn as A, Pt as E, Tf as _, Vf as o, Yt as I, ft as r, hn as N, jn as R, ot as O, qt as M, rp as D, rt as l, sr as P, t as L, uc as F, xc as K } from "./transition-overlay-BmUNA9xJ.js";
 export {
-  T as CINEMATIC_TRANSITION_KEYFRAMES,
-  D as DEFAULT_MORPH_DURATION_MS,
-  N as DEFAULT_TRANSITION_DURATION_MS,
+  t as CINEMATIC_TRANSITION_KEYFRAMES,
+  l as DEFAULT_MORPH_DURATION_MS,
+  O as DEFAULT_TRANSITION_DURATION_MS,
   r as EASE,
-  A as INSTANT,
-  e as P14_TRANSITION_KEYFRAMES,
-  l as P14_TRANSITION_KEYFRAMES_2,
-  S as P14_TRANSITION_KEYFRAMES_ALL,
-  P as PresentationTransitionOverlay,
-  O as RANDOM_ELIGIBLE_TYPES,
-  a as SLIDE_TRANSITION_KEYFRAMES,
-  R as SLIDE_TRANSITION_KEYFRAMES_CSS,
-  E as TRANSITION_SPEED_DURATION_MS,
-  M as WHEEL_SPOKE_COUNTS,
-  L as getCinematicTransitionAnimations,
-  v as getP14TransitionAnimations,
-  n as getSlideTransitionAnimations,
-  F as resolveDirection,
-  I as resolveDirection8,
-  i as resolveOrientation,
-  o as resolveSlideTransition,
-  t as resolveTransitionDurationMs,
-  _ as resolveWheelSpokeCount
+  E as INSTANT,
+  M as P14_TRANSITION_KEYFRAMES,
+  S as P14_TRANSITION_KEYFRAMES_2,
+  I as P14_TRANSITION_KEYFRAMES_ALL,
+  L as PresentationTransitionOverlay,
+  N as RANDOM_ELIGIBLE_TYPES,
+  R as SLIDE_TRANSITION_KEYFRAMES,
+  A as SLIDE_TRANSITION_KEYFRAMES_CSS,
+  T as TRANSITION_SPEED_DURATION_MS,
+  P as WHEEL_SPOKE_COUNTS,
+  F as getCinematicTransitionAnimations,
+  K as getP14TransitionAnimations,
+  i as getSlideTransitionAnimations,
+  _ as resolveDirection,
+  n as resolveDirection8,
+  o as resolveOrientation,
+  e as resolveSlideTransition,
+  a as resolveTransitionDurationMs,
+  D as resolveWheelSpokeCount
 };