ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/render/animation-effects.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `animation-effects`  -  pure initial-style resolution for native-animation
+ * entrance effects. Returns a neutral {@link AnimationStyle} (camelCase inline
+ * style map); bindings cast it to their framework style type at the boundary.
+ *
+ * @module render/animation-effects
+ */
+import type { PptxAnimationPreset, PptxNativeAnimation } from 'ooxml-core/pptx';
+import type { AnimationStyle, EffectName } from './animation-timeline-types.js';
+/**
+ * Returns the initial CSS styles for an element before its entrance animation
+ * plays. For mask-reveal animations the element is visible but fully masked
+ * out (a mask composites with the element's own geometry `clip-path`, which a
+ * `clip-path` keyframe would clobber); for all other entrances it starts fully
+ * transparent.
+ */
+export declare function getInitialStyleForEffect(effect: EffectName): AnimationStyle;
+export declare function getAnimationInitialStyle(preset: PptxAnimationPreset | undefined, nativeAnimation?: PptxNativeAnimation): AnimationStyle;
+//# sourceMappingURL=animation-effects.d.ts.map

package/dist/pptx/render/animation-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-effects.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-effects.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAOhF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAuE7E;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CA2H3E;AAMD,wBAAgB,wBAAwB,CACvC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,eAAe,CAAC,EAAE,mBAAmB,GACnC,cAAc,CAahB"}

package/dist/pptx/render/animation-emphasis-blink-shimmer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `animation-emphasis-blink-shimmer` - CSS `@keyframes` for the two
+ * ribbon-only emphasis effects that have no existing keyframe anywhere in
+ * the catalogue: Blink (emph.35) and Shimmer (emph.36). See
+ * `animation-emphasis-ground-truth.ts` for the COM/UI-Automation evidence
+ * behind each shape.
+ *
+ * Registered in `animation-keyframes.ts`'s `KEYFRAME_DEFINITIONS` and mapped
+ * from `PRESET_ID_TO_EFFECT.emph[35]` / `[36]` in `animation-presets.ts`.
+ *
+ * @module render/animation-emphasis-blink-shimmer
+ */
+/** Effect-name keys these two keyframes are meant to be registered under once wired. */
+export type BlinkShimmerEffectName = 'blink' | 'shimmer';
+/**
+ * Ready-to-merge CSS `@keyframes` text, keyed exactly like
+ * `animation-keyframes.ts`'s `KEYFRAME_DEFINITIONS` (name -> full `@keyframes
+ * pptx-<name> { ... }` block, prefix included).
+ *
+ * - `blink` (emph.35): a hard on/off visibility toggle, distinct from
+ *   `pulse`'s smooth fade-and-grow (PowerPoint's own XML uses a discrete
+ *   `calcmode="discrete"` `style.visibility` hidden/visible pair, not a
+ *   continuous opacity ramp).
+ * - `shimmer` (emph.36): a brief horizontal wiggle paired with a shallow
+ *   80%/100% width squeeze-and-release, matching the `p:animScale` +
+ *   `ppt_w`-relative `p:anim` pair PowerPoint authors for it.
+ */
+export declare const BLINK_SHIMMER_KEYFRAME_DEFINITIONS: Record<BlinkShimmerEffectName, string>;
+//# sourceMappingURL=animation-emphasis-blink-shimmer.d.ts.map

package/dist/pptx/render/animation-emphasis-blink-shimmer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-emphasis-blink-shimmer.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-emphasis-blink-shimmer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,wFAAwF;AACxF,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAarF,CAAC"}

package/dist/pptx/render/animation-emphasis-ground-truth-early.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `animation-emphasis-ground-truth-early` - emphasis ground-truth rows for
+ * preset ids 1-19 (Change Fill Color through Object Color). Split out of
+ * `animation-emphasis-ground-truth.ts` to keep that module under the repo's
+ * file-size guideline; see that module's doc for the COM/UI-Automation
+ * methodology, and `animation-emphasis-ground-truth.ts` for the composed
+ * table this feeds.
+ *
+ * @module render/animation-emphasis-ground-truth-early
+ */
+import type { AnimationEmphasisGroundTruthRow } from './animation-emphasis-ground-truth-types.js';
+export declare const ANIMATION_EMPHASIS_GROUND_TRUTH_EARLY: readonly AnimationEmphasisGroundTruthRow[];
+//# sourceMappingURL=animation-emphasis-ground-truth-early.d.ts.map

package/dist/pptx/render/animation-emphasis-ground-truth-early.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-emphasis-ground-truth-early.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-emphasis-ground-truth-early.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAE/F,eAAO,MAAM,qCAAqC,EAAE,SAAS,+BAA+B,EAqH3F,CAAC"}

package/dist/pptx/render/animation-emphasis-ground-truth-late.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `animation-emphasis-ground-truth-late` - emphasis ground-truth rows for
+ * preset ids 20-41 (Color Wave through the two unnamed "3D" custom items).
+ * Split out of `animation-emphasis-ground-truth.ts` to keep that module
+ * under the repo's file-size guideline; see that module's doc for the
+ * COM/UI-Automation methodology, and `animation-emphasis-ground-truth.ts`
+ * for the composed table this feeds.
+ *
+ * @module render/animation-emphasis-ground-truth-late
+ */
+import type { AnimationEmphasisGroundTruthRow } from './animation-emphasis-ground-truth-types.js';
+export declare const ANIMATION_EMPHASIS_GROUND_TRUTH_LATE: readonly AnimationEmphasisGroundTruthRow[];
+//# sourceMappingURL=animation-emphasis-ground-truth-late.d.ts.map

package/dist/pptx/render/animation-emphasis-ground-truth-late.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-emphasis-ground-truth-late.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-emphasis-ground-truth-late.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAE/F,eAAO,MAAM,oCAAoC,EAAE,SAAS,+BAA+B,EAwJ1F,CAAC"}

package/dist/pptx/render/animation-emphasis-ground-truth-types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `animation-emphasis-ground-truth-types` - the row shape for the COM +
+ * UI-Automation emphasis ground-truth table. Split out of
+ * `animation-emphasis-ground-truth.ts` to keep that module under the repo's
+ * file-size guideline.
+ *
+ * @module render/animation-emphasis-ground-truth-types
+ */
+/** One COM/UIA-observed OOXML `p:cTn` + child-node signature for an emphasis preset id. */
+export interface AnimationEmphasisGroundTruthRow {
+    presetId: number;
+    /** `p:cTn/@presetSubtype`. */
+    presetSubtype: number;
+    /** The named `MsoAnimEffect` constant that reproduced this id via `AddEffect`, if any. */
+    msoName?: string;
+    /** The literal ribbon / "Add Emphasis Effect" dialog item name that reproduced this id via UI Automation, if any. */
+    ribbonName?: string;
+    /** `p:animEffect/@filter`, when the effect carries one. */
+    filter?: string;
+    /** `p:attrNameLst/p:attrName` values named by this effect's `p:anim`/`p:animClr`/`p:set` children, if any. */
+    attrNames?: readonly string[];
+    /** Which child animation node kinds the saved XML carried. */
+    children: ReadonlyArray<'animClr' | 'animScale' | 'animRot' | 'animMotion' | 'anim' | 'set'>;
+    /** `true` when the saved `<p:childTnLst>` was empty (no representable 2D animation). */
+    noAnimationContent?: boolean;
+}
+//# sourceMappingURL=animation-emphasis-ground-truth-types.d.ts.map

package/dist/pptx/render/animation-emphasis-ground-truth-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-emphasis-ground-truth-types.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-emphasis-ground-truth-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2FAA2F;AAC3F,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qHAAqH;IACrH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8GAA8G;IAC9G,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,EAAE,aAAa,CAAC,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;IAC7F,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/pptx/render/animation-emphasis-ground-truth.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `animation-emphasis-ground-truth` - raw COM + UI-Automation-derived facts
+ * about what OOXML `p:cTn` nodes retail PowerPoint actually writes for the
+ * emphasis preset catalogue, gathered for the W3-B pass that closed the "64
+ * emphasis preset IDs, only 8 covered" gap and resolved the emph.26 "Pulse
+ * vs Flash Bulb" question.
+ *
+ * Method, TWO independent techniques that cross-check each other:
+ *  1. `MainSequence.AddEffect(shape, <MsoAnimEffect>, missing, msoAnimTriggerOnPageClick)`
+ *     for every NAMED `MsoAnimEffect` constant in the 54-82 range (Change
+ *     Fill Color through Wave, per the official VBA enumeration docs), one
+ *     shape per slide, `SaveAs` to `.pptx`, then reading the saved
+ *     `ppt/slides/slideN.xml` for the effect's own `p:cTn/@presetClass` /
+ *     `@presetID` / `@presetSubtype` and its child animation node(s)
+ *     (`p:animEffect/@filter`, `p:anim`, `p:animClr`, `p:animScale`,
+ *     `p:animRot`, `p:animMotion`, `p:set`) plus every `p:attrName` it names.
+ *  2. UI Automation (`System.Windows.Automation`): selected a shape,
+ *     programmatically switched the ribbon to the Animations tab, and
+ *     INVOKED the literal gallery / "Add Emphasis Effect" dialog list items
+ *     by their displayed name, then read the same saved-XML facts. This was
+ *     required because five ribbon-only names (Pulse, Color Pulse, Object
+ *     Color, Blink, Shimmer, plus two unnamed "3D" group items) have NO
+ *     corresponding `MsoAnimEffect` constant, so method 1 alone cannot reach
+ *     them. Enumerating the "Add Emphasis Effect" dialog's full item tree via
+ *     UI Automation (`Basic` / `3D` / `Subtle` / `Moderate` / `Exciting`
+ *     groups, 26 items total) confirmed this ground truth covers the ENTIRE
+ *     PowerPoint-exposed emphasis catalogue: every dialog item resolves to a
+ *     row below, and no additional named effect was left un-enumerated.
+ *
+ * CONFIDENCE: every row below is a directly observed `presetId` plus its
+ * exact child-node shape; nothing here is inferred by name-matching against
+ * another table (contrast `animation-preset-ground-truth.ts`'s ids 27+ for
+ * entrance/exit, where classic `AddEffect` automation could not reproduce the
+ * full authored richness). `msoName` / `ribbonName` record which of the two
+ * methods reached a given id (a row can have either, or both, when the same
+ * preset is reachable both ways - e.g. id 26 has BOTH `FlashBulb` (method 1)
+ * and `Pulse` (method 2), which is the direct evidence that they are the same
+ * preset, not two effects that got swapped onto one id).
+ *
+ * The rows themselves are split into `animation-emphasis-ground-truth-early.ts`
+ * (ids 1-19) and `animation-emphasis-ground-truth-late.ts` (ids 20-41) to
+ * keep this module under the repo's file-size guideline; the row shape lives
+ * in `animation-emphasis-ground-truth-types.ts`.
+ *
+ * @module render/animation-emphasis-ground-truth
+ */
+import { ANIMATION_EMPHASIS_GROUND_TRUTH_EARLY } from './animation-emphasis-ground-truth-early.js';
+export type { AnimationEmphasisGroundTruthRow } from './animation-emphasis-ground-truth-types.js';
+export declare const ANIMATION_EMPHASIS_GROUND_TRUTH: readonly (typeof ANIMATION_EMPHASIS_GROUND_TRUTH_EARLY)[number][];
+//# sourceMappingURL=animation-emphasis-ground-truth.d.ts.map

package/dist/pptx/render/animation-emphasis-ground-truth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-emphasis-ground-truth.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-emphasis-ground-truth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAGhG,YAAY,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAE/F,eAAO,MAAM,+BAA+B,EAAE,SAAS,CAAC,OAAO,qCAAqC,CAAC,CAAC,MAAM,CAAC,EACzB,CAAC"}

package/dist/pptx/render/animation-fill-repeat.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `animation-fill-repeat`: pure decisions for `p:cTn/@fill`, `@repeatDur`
+ * and `@spd`, the three timing attributes the parse layer now surfaces on
+ * {@link PptxNativeAnimation} (see `animation-timing-attrs` in
+ * `ooxml-core/pptx`) but that the timeline builder previously ignored.
+ *
+ * Kept separate from `animation-timeline-helpers` (already near the 300 LOC
+ * guideline) so each binding's playback layer can pull in exactly this
+ * decision without growing that module further.
+ *
+ * @module render/animation-fill-repeat
+ */
+import type { PptxNativeAnimation } from 'ooxml-core/pptx';
+/** The subset of a native animation this module's functions need. */
+export type EffectTimingInput = Pick<PptxNativeAnimation, 'presetClass' | 'fill' | 'speedPct' | 'repeatCount' | 'repeatDurMs' | 'autoReverse'>;
+/** Adjusted duration + iteration count + end-state hold decision for a step. */
+export interface EffectTimingResolution {
+    /** Duration in ms after applying `@spd` (unchanged when `speedPct` is absent). */
+    durationMs: number;
+    /** CSS `animation-iteration-count` value: a finite count, or `Infinity`. */
+    iterationCount: number;
+    /** Total finite active window, including repeat and auto-reverse passes. */
+    activeDurationMs: number;
+    /** See {@link import('./animation-timeline-types').TimelineStep.holdEndState}. */
+    holdEndState: boolean;
+}
+/**
+ * Apply `@spd` (ST_Percentage, already normalized to a plain percentage by
+ * the parse layer) to a base duration. `150` plays at 1.5x speed (shorter
+ * duration); absent or non-positive leaves the duration unchanged.
+ */
+export declare function applySpeedToDuration(speedPct: number | undefined, baseDurationMs: number): number;
+/**
+ * Resolve the CSS iteration count from `@repeatCount` (already parsed to a
+ * finite multiplier or `Infinity`) or, when absent, from `@repeatDur`
+ * (a duration the effect should keep repeating for). `@repeatDur="indefinite"`
+ * parses to `Infinity` and wins outright; a finite `repeatDurMs` is divided by
+ * the (already speed-adjusted) per-iteration duration.
+ */
+export declare function resolveIterationCount(repeatCount: number | undefined, repeatDurMs: number | undefined, adjustedDurationMs: number): number;
+/**
+ * Whether the playback layer should keep a step's CSS animation attached once
+ * it finishes, per `p:cTn/@fill`.
+ *
+ * Scoped to `emph` and `path` steps: an entrance's held frame is already its
+ * natural resting style (clearing the animation is a no-op), and exit
+ * visibility is driven by `presetClass`, not by the CSS animation staying
+ * attached. `hold`, `freeze` and `transition` all persist the final frame;
+ * `remove` (explicit, or the OOXML default when `@fill` is absent) reverts.
+ */
+export declare function shouldHoldEndState(anim: Pick<PptxNativeAnimation, 'presetClass' | 'fill'>): boolean;
+/** Resolve all three timing decisions for one animation in a single call. */
+export declare function resolveEffectTiming(anim: EffectTimingInput, baseDurationMs: number): EffectTimingResolution;
+//# sourceMappingURL=animation-fill-repeat.d.ts.map

package/dist/pptx/render/animation-fill-repeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-fill-repeat.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-fill-repeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CACnC,mBAAmB,EACnB,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,CACnF,CAAC;AAEF,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACtC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,YAAY,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAKjG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,kBAAkB,EAAE,MAAM,GACxB,MAAM,CAcR;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,MAAM,CAAC,GACrD,OAAO,CAKT;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,iBAAiB,EACvB,cAAc,EAAE,MAAM,GACpB,sBAAsB,CAgBxB"}

package/dist/pptx/render/animation-filter-effects.d.ts

@@ -0,0 +1,124 @@
+/**
+ * `animation-filter-effects`: resolves a `p:animEffect/@filter` descriptor
+ * (parsed onto {@link PptxNativeAnimation.effectFilter}) to an {@link EffectName}
+ * and, for the directional families, a synthesised numeric `presetSubtype`.
+ *
+ * `presetId`/`presetClass` remain the PRIMARY effect selector (see
+ * `resolveEffect` in `animation-timeline-helpers`); this module is consulted
+ * only as the FALLBACK, when no preset-table entry matches (an absent or
+ * unrecognised `presetId` - the situation a deck authored by a tool other
+ * than PowerPoint is in, since it may emit only the filter string).
+ *
+ * Every mapped family reuses machinery that already exists for preset-driven
+ * playback:
+ *  - `wipe` / `barn` reuse the exact same directional mask-reveal engine
+ *    (`buildDirectionalKeyframe`, `WIPE_SUBTYPE_TO_EDGE`,
+ *    `SPLIT_SUBTYPE_TO_VARIANT`) that a preset-driven Wipe/Split effect uses,
+ *    via the token->presetSubtype maps in `animation-presets`.
+ *  - `checkerboard` / `blinds` / `box` / `circle` / `wheel` / `dissolve` /
+ *    `fade` / `zoom` / `randombar` reuse the existing static `@keyframes`
+ *    (`checkerboardIn`, `blindsIn`, `boxIn`, `circleIn`, `wheelIn`,
+ *    `dissolveIn`/`Out`, `fadeIn`/`Out`, `zoomIn`/`Out`, `randomBarsIn`) built
+ *    for the SAME preset families in `animation-keyframes`.
+ *  - `slide` plays its own content-through-a-window keyframes
+ *    (`animation-slide-filter`), derived from CreateVideo frames of a
+ *    hand-authored `slide(fromLeft)`/`slide(fromBottom)` effect.
+ *  - `cover` / `uncover` / `push` / `pull` are not animated by PowerPoint at
+ *    all (the same CreateVideo method): the entrance appears at its start and
+ *    the exit vanishes at its end, so they resolve to `cutIn` / `cutOut`.
+ *  - `strips` resolves to the diagonal corner-to-corner sweep in
+ *    `animation-strips-reveal` (one keyframe per travel direction), the same
+ *    keyframes a preset-driven Strips effect (`presetID` 18) plays.
+ *  - `diamond` / `plus` reuse the box/circle mask-SIZE technique
+ *    (`diamondOut` / `plusOut` in `animation-mask-reveal`): a fixed mask
+ *    shape whose `mask-size` animates 0 -> full.
+ *  - `wedge` plays the two-sided angular sweep in `animation-wedge-reveal`
+ *    (the same keyframes as the Wedge preset, `presetID` 20).
+ *  - `comb` reuses `randomBarsIn`: both are an alternating-strip reveal of
+ *    the same shape family as `randombar`/`checkerboard`, and PowerPoint's
+ *    only structural difference (ordered teeth vs. random bars) is not worth
+ *    a second bespoke keyframe.
+ *  - `cut` is a new, genuinely distinct pair of keyframes (`cutIn`/`cutOut`)
+ *    that jump the element to its end state almost immediately rather than
+ *    animating gradually over the effect's duration, matching a SMIL `cut`
+ *    filter's "instant swap" semantics.
+ *  - `pixelate` defaults to the SAME `cutIn`/`cutOut` snap-to-end-state
+ *    keyframes `cut` uses (see {@link PIXELATE_SNAP_EFFECT}): COM
+ *    `CreateVideo` frame-diffing shows PowerPoint 2016 performs no animation
+ *    at all for this filter value, so matching PowerPoint's default means
+ *    matching `cut`'s instant swap, not animating something PowerPoint
+ *    itself does not. A genuinely blocky mosaic grid, built from a small
+ *    fixed set of self-contained SVG `<filter>` data-URIs stepped through
+ *    discrete `@keyframes` stops (see `animation-pixelate-filter`; each
+ *    visible cell shows the element's own real content at that position, not
+ *    a canvas rasterisation), remains available as an explicit opt-in via
+ *    {@link resolveFilterEffect}'s `pixelateMosaic` parameter, for a viewer
+ *    that would rather show something animating than PowerPoint's own
+ *    (rather anticlimactic) instant swap.
+ *  - `stretch` carries the same `fromLeft`/`fromRight`/`fromTop`/`fromBottom`
+ *    direction tokens as `slide` (SMIL 2.0 Transition Effects), so it reuses
+ *    {@link SLIDE_TOKEN_TO_SUFFIX} for the edge lookup (see
+ *    {@link resolveStretchEffect}), but resolves to a NEW pair of static
+ *    keyframes (`stretchIn*`/`stretchOut*`) rather than Fly's translate: a
+ *    directional non-uniform `scaleX`/`scaleY` pinned to the named edge via
+ *    `transform-origin`, standing in for SMIL's "elastic bar" stretch.
+ *  - `newsflash` has no subtype and is a new, genuinely distinct pair of
+ *    keyframes (`newsflashIn`/`newsflashOut`): a spin-and-zoom from/to a
+ *    near-zero point, approximating PowerPoint's own Newsflash effect.
+ *  - `random` per SMIL 2.0 literally means "pick one of the other known
+ *    transition types"; {@link resolveRandomEffect} (in the sibling
+ *    `animation-filter-random` module, split out to keep this file under the
+ *    repo's file-size guideline) does exactly that, deterministically, from
+ *    the animation's `targetId` rather than `Math.random()`.
+ *
+ * `image` has NO cheap CSS equivalent given this engine's one-element
+ * mask/keyframe architecture and is intentionally left out of
+ * {@link FILTER_FAMILY_EFFECT}: `resolveEffect` returning `undefined` for it
+ * lets the timeline builder's existing unmapped-preset safety net
+ * (`fallbackEffectForClass`) substitute the neutral `fadeIn`/`fadeOut`, so the
+ * effect is never silently dropped. See {@link GENERIC_FALLBACK_FILTER_FAMILIES}
+ * for why: `image` substitutes a second AUTHORED image mid-transition that the
+ * OOXML `p:animEffect` filter payload never carries, so there is nothing to
+ * substitute. (`pixelate` used to live in this same fallback bucket for the
+ * same architectural reason - "rasterising content is a canvas operation" -
+ * until `animation-pixelate-filter` showed a real SVG-filter mosaic fits the
+ * architecture after all; see `pixelate` above.)
+ *
+ * @module render/animation-filter-effects
+ */
+import type { PptxNativeAnimation } from 'ooxml-core/pptx';
+import type { EffectName } from './animation-timeline-types.js';
+/**
+ * Recognised ECMA-376 filter families with no bespoke mapping here. Each one
+ * falls through `resolveEffect` (returns `undefined`) to the timeline
+ * builder's generic entrance/exit fade safety net rather than being dropped.
+ * Exported so the shared test suite can assert every one of them actually
+ * reaches that fallback, and so this list is the single place documenting
+ * "known but approximated as fade". See the module doc for why `image`
+ * specifically has no cheap CSS equivalent in this architecture.
+ */
+export declare const GENERIC_FALLBACK_FILTER_FAMILIES: readonly string[];
+/**
+ * Resolve the fallback {@link EffectName} for a native animation's parsed
+ * `@filter`, or `undefined` when the family is unrecognised/unmapped (the
+ * caller's own generic fade safety net takes over in that case).
+ *
+ * @param pixelateMosaic - Opt-in override for the `pixelate` family only:
+ *   `true` plays the blocky mosaic reveal this renderer can build; omitted or
+ *   `false` (the default, matching PowerPoint's own behaviour) snaps the
+ *   element to its end state instead, via the same `cutIn`/`cutOut` keyframes
+ *   the `cut` filter family uses. See {@link PIXELATE_SNAP_EFFECT}.
+ */
+export declare function resolveFilterEffect(anim: PptxNativeAnimation, pixelateMosaic?: boolean): EffectName | undefined;
+/**
+ * Resolve the numeric `presetSubtype` to feed
+ * {@link import('./animation-directional').buildDirectionalKeyframe}: the
+ * animation's own `presetSubtype` when present (real preset data always
+ * wins), otherwise a value synthesised from the filter's subtype token for
+ * the two directional families (`wipe`, `barn`) that have one. Every other
+ * family (Strips carries its direction in its own effect name) returns
+ * `undefined`, matching `undefined`'s
+ * existing meaning of "use the non-directional static effect".
+ */
+export declare function resolveFilterPresetSubtype(anim: PptxNativeAnimation): number | undefined;
+//# sourceMappingURL=animation-filter-effects.d.ts.map

package/dist/pptx/render/animation-filter-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-filter-effects.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-filter-effects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAU3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA8D7D;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAAS,MAAM,EAAc,CAAC;AAwC7E;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,mBAAmB,EACzB,cAAc,CAAC,EAAE,OAAO,GACtB,UAAU,GAAG,SAAS,CAqCxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAexF"}

package/dist/pptx/render/animation-filter-random.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `animation-filter-random`: resolves the `random` SMIL/ECMA-376
+ * `p:animEffect/@filter` family (see `animation-filter-effects`'s module doc
+ * for how this fits the rest of the filter fallback).
+ *
+ * Per SMIL 2.0, `random` literally means "pick one of the other known
+ * transition types". This module does exactly that, against
+ * {@link RANDOM_EFFECT_POOL} (a curated subset of the OTHER
+ * already-implemented reveal/conceal pairs from `animation-filter-effects`).
+ * The pick is derived deterministically from the animation's `targetId` (a
+ * stable FNV-1a hash, see {@link fnv1aHash}) rather than `Math.random()`, so
+ * replaying the SAME element's SAME animation always resolves to the SAME
+ * effect (matching every other resolution in this module being a pure
+ * function of the input), while different elements/instances land on
+ * different picks.
+ *
+ * @module render/animation-filter-random
+ */
+import type { PptxNativeAnimation } from 'ooxml-core/pptx';
+import type { EffectName } from './animation-timeline-types.js';
+/**
+ * Resolve a `random` filter to one of {@link RANDOM_EFFECT_POOL}'s pairs. The
+ * pick is a pure function of the animation's `targetId` (falling back to the
+ * filter's raw token, then a constant, when a deck has no target id), so the
+ * SAME element's SAME animation always resolves to the SAME effect on replay
+ * (deterministic, testable) while different elements typically land on
+ * different picks, matching SMIL's "pick one of the other known transition
+ * types" semantics without a non-deterministic `Math.random()` call.
+ */
+export declare function resolveRandomEffect(anim: PptxNativeAnimation, isExit: boolean): EffectName;
+//# sourceMappingURL=animation-filter-random.d.ts.map

package/dist/pptx/render/animation-filter-random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-filter-random.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-filter-random.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAkD7D;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,CAK1F"}

package/dist/pptx/render/animation-keyframes-emphasis-base.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `animation-keyframes-emphasis-base` - static CSS `@keyframes` definitions
+ * for the emphasis native-animation effects (the pure transform/opacity/color
+ * ones; Blink/Shimmer live in `animation-emphasis-blink-shimmer.ts`). Split
+ * out of `animation-keyframes.ts` to keep that module under the repo's
+ * file-size guideline; see `animation-keyframes.ts` for the composed lookup
+ * this feeds.
+ *
+ * @module render/animation-keyframes-emphasis-base
+ */
+export declare const EMPHASIS_KEYFRAME_DEFINITIONS: Record<string, string>;
+//# sourceMappingURL=animation-keyframes-emphasis-base.d.ts.map

package/dist/pptx/render/animation-keyframes-emphasis-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes-emphasis-base.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes-emphasis-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+DhE,CAAC"}

package/dist/pptx/render/animation-keyframes-entrance.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `animation-keyframes-entrance` - static CSS `@keyframes` definitions for the
+ * entrance native-animation effects. Split out of `animation-keyframes.ts` to
+ * keep that module under the repo's file-size guideline; see
+ * `animation-keyframes.ts` for the composed lookup this feeds.
+ *
+ * @module render/animation-keyframes-entrance
+ */
+export declare const ENTRANCE_KEYFRAME_DEFINITIONS: Record<string, string>;
+//# sourceMappingURL=animation-keyframes-entrance.d.ts.map

package/dist/pptx/render/animation-keyframes-entrance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes-entrance.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes-entrance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkLhE,CAAC"}

package/dist/pptx/render/animation-keyframes-exit-shapes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `animation-keyframes-exit-shapes`: CSS `@keyframes` definitions for the
+ * Box / Checkerboard / Blinds / Wheel / Random Bars / Diamond / Plus / Wedge
+ * EXIT effects. Split out of `animation-keyframes` to keep that module under
+ * the repo's file-size cap.
+ *
+ * Every preset id here was confirmed via COM automation (`AddEffect` +
+ * `Effect.Exit = True` + raw OOXML inspection on retail PowerPoint) to reuse
+ * the SAME numeric presetID as its entrance form, mirroring the
+ * already-documented Bounce/Rise Up/Circle pattern (see
+ * `animation-presets.ts`). Each keyframe below reuses the exact mask or
+ * transform technique already shipped for that effect's entrance keyframe in
+ * `animation-keyframes.ts`, just played in reverse (shown -> hidden) so the
+ * reveal closes instead of opening.
+ *
+ * @module render/animation-keyframes-exit-shapes
+ */
+/** The subset of {@link EffectName} whose `@keyframes` live in this module. */
+export type ExitShapeEffectName = 'boxOut' | 'circleOut' | 'checkerboardOut' | 'blindsOut' | 'wheelOut' | 'randomBarsOut' | 'diamondOut' | 'plusOut' | 'boxOutFromCenter' | 'circleOutFromCenter' | 'diamondOutFromCenter' | 'plusOutFromCenter' | 'wedgeOut' | 'peekOut' | 'peekOutDown' | 'splitOut';
+export declare const EXIT_SHAPE_KEYFRAME_DEFINITIONS: Record<ExitShapeEffectName, string>;
+//# sourceMappingURL=animation-keyframes-exit-shapes.d.ts.map

package/dist/pptx/render/animation-keyframes-exit-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes-exit-shapes.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes-exit-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAC5B,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,WAAW,GACX,UAAU,GACV,eAAe,GACf,YAAY,GACZ,SAAS,GACT,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,UAAU,GACV,SAAS,GACT,aAAa,GACb,UAAU,CAAC;AAEd,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAoF/E,CAAC"}

package/dist/pptx/render/animation-keyframes-exit.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `animation-keyframes-exit` - static CSS `@keyframes` definitions for the
+ * exit native-animation effects. Split out of `animation-keyframes.ts` to
+ * keep that module under the repo's file-size guideline; see
+ * `animation-keyframes.ts` for the composed lookup this feeds. (The
+ * Box/Checkerboard/Blinds/Wheel/RandomBars/Diamond/Plus/Wedge exit mask
+ * keyframes live separately in `animation-keyframes-exit-shapes.ts`.)
+ *
+ * @module render/animation-keyframes-exit
+ */
+export declare const EXIT_KEYFRAME_DEFINITIONS: Record<string, string>;
+//# sourceMappingURL=animation-keyframes-exit.d.ts.map

package/dist/pptx/render/animation-keyframes-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes-exit.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes-exit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6E5D,CAAC"}

package/dist/pptx/render/animation-keyframes-motion-family.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `animation-keyframes-motion-family` - CSS `@keyframes` definitions for the
+ * translate-driven entrance and exit effects added to close the OOXML
+ * entrance/exit preset catalogue gap (Boomerang, Credits, Float Up/Down,
+ * Glide, Curve Up/Down, Drop, Compress). Split out of `animation-keyframes`
+ * to keep that file under the repo's file-size guideline; see
+ * `animation-keyframes-rotation-family`'s module doc for the same
+ * confidence caveat about how these preset IDs were matched.
+ *
+ * @module render/animation-keyframes-motion-family
+ */
+export type MotionFamilyEffectNameKeys = 'boomerangIn' | 'boomerangOut' | 'creditsIn' | 'creditsOut' | 'floatUpIn' | 'floatDownOut' | 'glideIn' | 'glideOut' | 'curveUpIn' | 'curveDownOut' | 'dropIn' | 'dropOut' | 'compressIn';
+export declare const MOTION_FAMILY_KEYFRAME_DEFINITIONS: Record<MotionFamilyEffectNameKeys, string>;
+//# sourceMappingURL=animation-keyframes-motion-family.d.ts.map

package/dist/pptx/render/animation-keyframes-motion-family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes-motion-family.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes-motion-family.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,MAAM,0BAA0B,GACnC,aAAa,GACb,cAAc,GACd,WAAW,GACX,YAAY,GACZ,WAAW,GACX,cAAc,GACd,SAAS,GACT,UAAU,GACV,WAAW,GACX,cAAc,GACd,QAAQ,GACR,SAAS,GACT,YAAY,CAAC;AAEhB,eAAO,MAAM,kCAAkC,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CA4E3C,CAAC"}

package/dist/pptx/render/animation-keyframes-rotation-family.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `animation-keyframes-rotation-family` - CSS `@keyframes` definitions for the
+ * rotation/spin-driven entrance and exit effects added to close the OOXML
+ * entrance/exit preset catalogue gap (Spiral In/Out, Pinwheel, Whip, Rotate,
+ * Center Revolve, Light Speed, Flip, Fold, Unfold, and the exit-side
+ * `spinnerOut` that pairs with the existing `spinnerIn`).
+ *
+ * Every one of these plays a shape whose OOXML identity is either
+ * COM-confirmed by numeric presetID (`animation-preset-ground-truth.ts`) or
+ * matched by NAME against the already-COM-verified authoring/catalog tables;
+ * see the module doc on `EffectName` in `animation-timeline-types.ts` for what
+ * that means for confidence. Each is a genuinely new visual (not a reuse of an
+ * existing keyframe), split out of `animation-keyframes` to keep that file
+ * under the repo's file-size guideline.
+ *
+ * @module render/animation-keyframes-rotation-family
+ */
+export type RotationFamilyEffectNameKeys = 'spiralIn' | 'spiralOut' | 'pinwheelIn' | 'pinwheelOut' | 'whipIn' | 'whipOut' | 'rotateIn' | 'rotateOut' | 'centerRevolveIn' | 'centerRevolveOut' | 'spinnerOut' | 'lightSpeedIn' | 'lightSpeedOut' | 'flipIn' | 'flipOut' | 'foldIn' | 'foldOut' | 'unfoldIn' | 'unfoldOut';
+export declare const ROTATION_FAMILY_KEYFRAME_DEFINITIONS: Record<RotationFamilyEffectNameKeys, string>;
+//# sourceMappingURL=animation-keyframes-rotation-family.d.ts.map

package/dist/pptx/render/animation-keyframes-rotation-family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes-rotation-family.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes-rotation-family.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,MAAM,4BAA4B,GACrC,UAAU,GACV,WAAW,GACX,YAAY,GACZ,aAAa,GACb,QAAQ,GACR,SAAS,GACT,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,YAAY,GACZ,cAAc,GACd,eAAe,GACf,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,UAAU,GACV,WAAW,CAAC;AAEf,eAAO,MAAM,oCAAoC,EAAE,MAAM,CAAC,4BAA4B,EAAE,MAAM,CAuG/C,CAAC"}

package/dist/pptx/render/animation-keyframes-scale-spin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `animation-keyframes-scale-spin`: CSS `@keyframes` definitions for the
+ * `stretch` and `newsflash` SMIL/ECMA-376 `p:animEffect/@filter` families
+ * (see `animation-filter-effects`'s module doc for how these fit the rest of
+ * the filter fallback). Split out of `animation-keyframes` to keep that
+ * file under the repo's file-size guideline; merged back into its
+ * `KEYFRAME_DEFINITIONS` lookup table.
+ *
+ * Neither family has a dedicated mask shape (`animation-mask-reveal`):
+ * both are transform-only, not reveals.
+ *  - `stretch` is a directional non-uniform SCALE: the element stretches out
+ *    from the named edge (pinned there via `transform-origin`) past its
+ *    resting size, then snaps back, standing in for the classic "elastic
+ *    bar" stretch transition.
+ *  - `newsflash` is a spin-and-zoom from/to a near-zero point: rotation
+ *    settles to/from 0deg as scale grows/shrinks from/to near zero, with a
+ *    small overshoot for a "snap into place" read, approximating
+ *    PowerPoint's own Newsflash effect.
+ *
+ * @module render/animation-keyframes-scale-spin
+ */
+type ScaleSpinEffectName = 'stretchInLeft' | 'stretchInRight' | 'stretchInTop' | 'stretchInBottom' | 'stretchOutLeft' | 'stretchOutRight' | 'stretchOutTop' | 'stretchOutBottom' | 'newsflashIn' | 'newsflashOut';
+export declare const SCALE_SPIN_KEYFRAME_DEFINITIONS: Record<ScaleSpinEffectName, string>;
+export {};
+//# sourceMappingURL=animation-keyframes-scale-spin.d.ts.map

package/dist/pptx/render/animation-keyframes-scale-spin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes-scale-spin.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes-scale-spin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,KAAK,mBAAmB,GACrB,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,cAAc,CAAC;AAElB,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAoDjC,CAAC"}

package/dist/pptx/render/animation-keyframes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `animation-keyframes` - CSS `@keyframes` definitions for every static
+ * native-animation effect, keyed by {@link EffectName}. Pure data + a lookup
+ * helper. Names are prefixed `pptx-` (distinct from `animation-css`'s
+ * `pptx-vue-` editor-preset keyframes).
+ *
+ * The entrance/exit/emphasis base tables each live in their own module (kept
+ * under the repo's file-size guideline); this module composes them into the
+ * single {@link getEffectKeyframes} lookup.
+ *
+ * @module render/animation-keyframes
+ */
+import type { EffectName } from './animation-timeline-types.js';
+export declare function getEffectKeyframes(effect: EffectName): string;
+//# sourceMappingURL=animation-keyframes.d.ts.map

package/dist/pptx/render/animation-keyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-keyframes.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-keyframes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAuC7D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE7D"}