ooxml-ui 0.30.1 → 1.0.0

package/dist/pptx/render/animation-preset-labels.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `animation-preset-labels`: the naming layer over the two animation preset
+ * vocabularies, so no binding ever prints a wire token where an effect name
+ * belongs.
+ *
+ * WHY this module exists: an animation's effect is identified by one of two
+ * different vocabularies, and both of them were reaching the screen verbatim.
+ *
+ *  - The **editor vocabulary** (`PptxAnimationPreset`: `fadeIn`, `growTurnIn`,
+ *    `boldFlash`, ...) is what `PptxElementAnimation.entrance / emphasis / exit`
+ *    actually holds. It is what the ribbon galleries apply and what the parser
+ *    normalises a loaded deck's OOXML presets down to. Every timeline in every
+ *    binding printed this token raw, so users saw `fadeIn` where "Fade In"
+ *    belongs.
+ *  - The **OOXML catalogue vocabulary** (`entr.1`, `emph.26`, `path.loop.pretzel`
+ *    from `ooxml-core/pptx`'s `animation-preset-catalog`) is the full 266-entry
+ *    PowerPoint preset library. Its entries carry a hard-coded ENGLISH `label`,
+ *    which the Vue "Add animation > Effect" picker rendered directly, so that
+ *    control stayed English in every locale.
+ *
+ * Both vocabularies now resolve through i18n keys defined here, which means a
+ * missing name is a dictionary gap that `packages/locales`' coverage tests
+ * catch, not a plausible-looking wrong label produced by `keyToLabel`.
+ *
+ * WHY the catalogue key is a slug and not the preset id: the dictionaries are
+ * flat maps whose keys are dotted paths, and a catalogue id already contains
+ * dots (`path.line.up`). Folding them into one camelCase segment
+ * (`pathLineUp`) keeps every animation key at the same depth as the rest of the
+ * dictionary, so no translation framework has to be trusted to resolve a
+ * five-segment key against a flat map.
+ *
+ * Pure data + pure functions: no framework, no DOM.
+ *
+ * @module render/animation-preset-labels
+ */
+import type { PptxAnimationPreset, PptxElementAnimation } from 'ooxml-core/pptx';
+/**
+ * The minimal translate contract every binding can satisfy (react-i18next's
+ * `t`, vue-i18n's `t`, ngx-translate's `instant`, vanilla's `Translator`).
+ */
+export type AnimationLabelTranslate = (key: string) => string;
+/**
+ * Every `PptxAnimationPreset` value except `'none'`, i.e. every effect token
+ * that can end up on a `PptxElementAnimation` and therefore in a timeline row.
+ *
+ * Kept as a runtime array (the type is a bare union) so the dictionary coverage
+ * test can enumerate what the UI can reach instead of trusting a hand-kept list
+ * of "the ones we bothered to name".
+ */
+export declare const ANIMATION_PRESET_VALUES: readonly PptxAnimationPreset[];
+/**
+ * The i18n key naming an editor preset token, shared by every binding's ribbon
+ * gallery, inspector select and timeline row.
+ */
+export declare function animationPresetLabelKey(preset: string): string;
+/**
+ * Fold a catalogue preset id into one dictionary-key segment:
+ * `entr.1` -> `entr1`, `path.line.upLeft` -> `pathLineUpLeft`.
+ *
+ * Deterministic and collision-free across the whole catalogue, so the key can
+ * be derived at the call site instead of stored per preset.
+ */
+export declare function animationCatalogPresetSlug(presetId: string): string;
+/** The i18n key naming an OOXML catalogue preset (`entr.1`, `path.line.up`, ...). */
+export declare function animationCatalogPresetLabelKey(presetId: string): string;
+/**
+ * `true` when `token` is a catalogue id (`entr.1`) rather than an editor preset
+ * (`fadeIn`). The two vocabularies are told apart by the dot, which no
+ * `PptxAnimationPreset` value contains.
+ */
+export declare function isAnimationCatalogPresetId(token: string): boolean;
+/**
+ * The i18n key naming whatever effect an animation carries, whichever
+ * vocabulary its token came from. An entry with no preset resolves to "Motion
+ * Path" when it only carries a path, and to the generic "Animation" otherwise
+ * (which is what the bindings used to spell as the literal word `custom`).
+ *
+ * Always a key, never `undefined`, because Angular renders these through the
+ * `translate` pipe: resolving finished text in a component getter would freeze
+ * an `OnPush` view's wording at whatever language was active when it last
+ * rendered.
+ */
+export declare function animationEffectLabelKey(anim: PptxElementAnimation): string;
+/**
+ * The display name for an animation's effect.
+ *
+ * This is the single resolver every binding's timeline and effect chip calls,
+ * so all five spell the same animation the same way.
+ */
+export declare function animationEffectLabel(anim: PptxElementAnimation, translate: AnimationLabelTranslate): string;
+//# sourceMappingURL=animation-preset-labels.d.ts.map

package/dist/pptx/render/animation-preset-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-preset-labels.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-preset-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEjF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EA2CjE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,qFAAqF;AACrF,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAQ1E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,oBAAoB,EAC1B,SAAS,EAAE,uBAAuB,GAChC,MAAM,CAER"}

package/dist/pptx/render/animation-preset-labels.mjs

@@ -0,0 +1 @@
+export { ANIMATION_PRESET_VALUES, animationCatalogPresetLabelKey, animationCatalogPresetSlug, animationEffectLabel, animationEffectLabelKey, animationPresetLabelKey, isAnimationCatalogPresetId } from '../chunk-T7FRLIDM.mjs';

package/dist/pptx/render/animation-presets-emphasis.d.ts

@@ -0,0 +1,103 @@
+/**
+ * `animation-presets-emphasis` - OOXML emphasis presetId -> effect-name table,
+ * plus the filter-based emphasis presets (desaturate / darken / lighten /
+ * colour-remap) that render as a dynamic CSS `filter` keyframe rather than a
+ * static playback effect. Split out of `animation-presets.ts` to keep that
+ * module under the repo's file-size guideline; see `animation-presets.ts`
+ * for the composed `PRESET_ID_TO_EFFECT.emph` this feeds.
+ *
+ * @module render/animation-presets-emphasis
+ */
+import type { EffectName } from './animation-timeline-types.js';
+/**
+ * OOXML emphasis `p:cTn/@presetId` -> playback effect name.
+ *
+ * ==================================================================
+ * FULL GROUND TRUTH (this pass, 2026-09-05): every one of the 26 named
+ * effects in PowerPoint's own "Add Emphasis Effect" dialog (its Basic /
+ * 3D / Subtle / Moderate / Exciting categories, enumerated exhaustively
+ * via UI Automation) was reproduced and its raw OOXML inspected, via
+ * TWO independent COM methods that cross-check each other:
+ *  (1) `MainSequence.AddEffect(shape, <msoAnimEffect*>, 0,
+ *      msoAnimTriggerOnPageClick)` for every named `MsoAnimEffect`
+ *      constant in the 54-82 range (Change Fill Color..Wave per the
+ *      VBA docs), one shape per slide, SaveAs + raw XML inspection.
+ *  (2) UI Automation: selected a shape, switched the ribbon to the
+ *      Animations tab, and INVOKED the literal gallery / "Add
+ *      Emphasis Effect" dialog list items by their displayed name
+ *      (Pulse, Color Pulse, Object Color, Line/Fill/Font/Brush Color,
+ *      Underline, Blink, Shimmer, and the dialog's two unnamed "3D"
+ *      group items), SaveAs + raw XML inspection.
+ * Method (2) was required because five ribbon-only names (Pulse,
+ * Color Pulse, Object Color, Blink, Shimmer, plus two 3D-only
+ * effects) have NO corresponding `MsoAnimEffect` constant, so method
+ * (1) alone cannot reach them.
+ *
+ * RESULT ON THE KNOWN emph.26 QUESTION: emph.26 IS Pulse, and there is
+ * no separate "Pulse id" to find, because Pulse and Flash Bulb are the
+ * SAME preset under two different PowerPoint-history names.
+ * `msoAnimEffectFlashBulb` (method 1) and clicking the ribbon's
+ * literal "Pulse" gallery item (method 2) produced BYTE-IDENTICAL
+ * timing XML: `presetID="26" presetClass="emph" presetSubtype="0"`,
+ * `<p:animEffect transition="out" filter="fade">` with a
+ * `tmFilter="0,0;.2,.5;.8,.5;1,0"` flash curve PLUS a `<p:animScale>`
+ * to 105%/105% with `autoRev="1"` (grow-and-settle). The existing
+ * `pulse` mapping below was already correct; nothing was swapped.
+ * (Likewise emph.27 is BOTH `msoAnimEffectFlicker` and the ribbon's
+ * "Color Pulse" - the same pattern, one preset under two names.)
+ *
+ * Full resolved id -> effect table from this pass (see
+ * `animation-emphasis-ground-truth.ts` for the per-id raw XML this
+ * comment summarises):
+ *   1 Fill Color / Change Fill Color   20 Color Wave
+ *   2 Change Font                      21 Complementary Color
+ *   3 Font Color / Change Font Color   22 Complementary Color 2
+ *   4 Change Font Size                 23 Contrasting Color
+ *   5 Change Font Style                24 Darken
+ *   6 Grow/Shrink                      25 Desaturate
+ *   7 Line Color / Change Line Color   26 Pulse / Flash Bulb
+ *   8 Spin                             27 Color Pulse / Flicker
+ *   9 Transparency                     28 Grow With Color
+ *  10 Bold Flash                       30 Lighten
+ *  14 Blast                            31 Style Emphasis
+ *  15 Bold Reveal                      32 Teeter
+ *  16 Brush Color / Brush on Color     33 Vertical Grow
+ *  18 Underline / Brush on Underline   34 Wave
+ *  19 Object Color / Color Blend       35 Blink
+ *                                      36 Shimmer
+ *                                   40/41 3D-only (empty `<p:childTnLst>`,
+ *                                         no 2D-representable animation)
+ * ids 11/12/13/17/29/37/38/39 correspond to NO named `MsoAnimEffect`
+ * constant, NO item in the default ribbon gallery, and NO item in the
+ * full "Add Emphasis Effect" dialog (all 26 dialog items across all
+ * five of its categories were enumerated via UI Automation and every
+ * one of them resolves into the table above) - they are
+ * reserved/unreachable ids, not effects this pass failed to find, and
+ * are correctly absent from every table rather than guessed.
+ * ==================================================================
+ */
+export declare const EMPH_PRESETS: Record<number, EffectName>;
+/**
+ * Emphasis presets whose effect is a CSS `filter` pulse rather than a transform
+ * or opacity change. These are generated as dynamic `@keyframes` (see
+ * {@link import('./animation-timeline-helpers').buildDynamicKeyframe}) because
+ * there is no static keyframe for them.
+ *
+ * The `filterMid` is applied at the animation midpoint and eased back to the
+ * neutral value, matching PowerPoint's "emphasise then settle" feel. The preset
+ * IDs are a best-effort mapping of the ECMA-376 emphasis catalogue; any preset
+ * id not covered here (or by {@link EMPH_PRESETS}) still animates via the
+ * neutral emphasis fallback, so an unrecognised id is never dropped.
+ */
+export declare const EMPH_FILTER_PRESETS: Readonly<Record<number, {
+    name: string;
+    filterMid: string;
+}>>;
+/**
+ * Build a CSS `filter` emphasis `@keyframes` block (desaturate / darken /
+ * lighten) for an emphasis preset id in {@link EMPH_FILTER_PRESETS}. The filter
+ * is applied at the midpoint and eased back to neutral. Returns `undefined` for
+ * any preset id without a filter mapping.
+ */
+export declare function emphasisFilterKeyframeCss(presetId: number | undefined, name: string): string | undefined;
+//# sourceMappingURL=animation-presets-emphasis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation-presets-emphasis.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-presets-emphasis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA2BnD,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B7F,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CASpB"}

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

@@ -0,0 +1,12 @@
+/**
+ * `animation-presets-entrance` - OOXML entrance presetId -> effect-name table.
+ * Split out of `animation-presets.ts` to keep that module under the repo's
+ * file-size guideline; see `animation-presets.ts` for the composed
+ * `PRESET_ID_TO_EFFECT.entr` this feeds.
+ *
+ * @module render/animation-presets-entrance
+ */
+import type { EffectName } from './animation-timeline-types.js';
+/** OOXML entrance `p:cTn/@presetId` -> playback effect name. */
+export declare const ENTR_PRESETS: Record<number, EffectName>;
+//# sourceMappingURL=animation-presets-entrance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation-presets-entrance.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-presets-entrance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA0EnD,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * `animation-presets-exit` - OOXML exit presetId -> effect-name table. Split
+ * out of `animation-presets.ts` to keep that module under the repo's
+ * file-size guideline; see `animation-presets.ts` for the composed
+ * `PRESET_ID_TO_EFFECT.exit` this feeds.
+ *
+ * @module render/animation-presets-exit
+ */
+import type { EffectName } from './animation-timeline-types.js';
+/** OOXML exit `p:cTn/@presetId` -> playback effect name. */
+export declare const EXIT_PRESETS: Record<number, EffectName>;
+//# sourceMappingURL=animation-presets-exit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation-presets-exit.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-presets-exit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,4DAA4D;AAC5D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAkEnD,CAAC"}

package/dist/pptx/render/animation-presets-extended.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `animation-presets-extended` - the "extended" entrance/exit OOXML preset
+ * ids that `animation-presets.ts`'s `PRESET_ID_TO_EFFECT` spreads in, split
+ * out to keep that file under the repo's file-size guideline.
+ *
+ * GROUND TRUTH: the ids are COM-derived. Every `MsoAnimEffect` value was
+ * added through `MainSequence.AddEffect` (entrance, then `Effect.Exit =
+ * True`) and the saved `presetID` read back; a reverse pass (a deck with
+ * `presetID="k"` on slide `k`, reopened and read through `Effect.EffectType`)
+ * agrees. The real entrance/exit ids above 26 are 27-31, 34, 35, 37-43, 45,
+ * 47-56 and 58; 32, 33, 36, 44, 46, 57 and 59-68 are not presets and are
+ * deliberately absent. The previous table keyed ids 27+ by the object-model
+ * enum order, which drifts from the OOXML id from 32 up.
+ *
+ * WHAT PLAYS: a PowerPoint-authored deck carries the preset's real behaviour
+ * tree (`p:anim` / `p:animScale` / `p:animEffect` ...), and those nodes drive
+ * playback directly. The names below are the static fallback for an
+ * effect whose tree carries no usable behaviour, reusing the closest keyframe
+ * family. Each choice with no textual overlap to the real name is listed in
+ * `animation-preset-tables-consistency.test.ts`'s APPROXIMATION_ALLOWLIST.
+ *
+ * @module render/animation-presets-extended
+ */
+import type { EffectName } from './animation-timeline-types.js';
+/** entr.7/15/17/24/25 plus every real entrance id from 27 up. */
+export declare const EXTENDED_ENTR_PRESETS: Partial<Record<number, EffectName>>;
+/**
+ * exit.7/15/16/17/19/24/25 plus every real exit id from 27 up (exit.26/37
+ * and the 1-23 band live in `animation-presets-exit.ts`).
+ */
+export declare const EXTENDED_EXIT_PRESETS: Partial<Record<number, EffectName>>;
+//# sourceMappingURL=animation-presets-extended.d.ts.map

package/dist/pptx/render/animation-presets-extended.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-presets-extended.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-presets-extended.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA+BrE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAiCrE,CAAC"}

package/dist/pptx/render/animation-presets-subtypes.d.ts

@@ -0,0 +1,118 @@
+/**
+ * `animation-presets-subtypes` - `p:cTn/@presetSubtype` direction/variant
+ * lookup tables (Fly/Peek edge, Wipe travel direction, Split barn-door
+ * variant) and their filter-token inverses, for the mask-reveal directional
+ * keyframe builders. Split out of `animation-presets.ts` to keep that module
+ * under the repo's file-size guideline.
+ *
+ * @module render/animation-presets-subtypes
+ */
+import type { EffectName } from './animation-timeline-types.js';
+/** The four edges a Fly In/Out effect can travel from/to. */
+export type FlyEdge = 'left' | 'right' | 'top' | 'bottom';
+/**
+ * Map an OOXML `p:cTn/@presetSubtype` code to a {@link FlyEdge} for Fly In and
+ * Fly Out effects. PowerPoint encodes the direction as a bitmask on the object
+ * origin edge: 1=top, 2=right, 4=bottom, 8=left. Corners combine two bits
+ * (e.g. 12 = 8|4 = bottom-left) and fall back to their horizontal edge, which
+ * is the more visually distinct component. Unknown/absent codes are left to the
+ * caller (which keeps the preset default of bottom).
+ */
+export declare const FLY_SUBTYPE_TO_EDGE: Readonly<Record<number, FlyEdge>>;
+/**
+ * Map a Wipe `presetSubtype` to the edge the wipe works FROM: the edge an
+ * entrance reveals from first and an exit conceals from first.
+ *
+ * Subtype 1 pairs with `filter="wipe(up)"`, 2 with `wipe(right)`, 4 with
+ * `wipe(down)` and 8 with `wipe(left)`, and `wipe(X)` starts at edge X. The
+ * same bitmask Fly uses (1 = top, 2 = right, 4 = bottom, 8 = left).
+ * CreateVideo ground truth (200 px square, 2 s): Wipe subtype 4, PowerPoint's
+ * default "From Bottom", grows up from the bottom edge (visible top edge
+ * 361 -> 238 px over the first 1.2 s, bottom fixed at 370); the exit with
+ * subtype 1 conceals from the top down (top edge 170 -> 282, bottom fixed).
+ * An earlier reading of the filter token as the direction the front
+ * TRAVELS played every directional wipe entrance from the opposite side.
+ */
+export declare const WIPE_SUBTYPE_TO_EDGE: Readonly<Record<number, FlyEdge>>;
+/** Split (`barn`) subtype -> reveal orientation + in/out direction. */
+export type SplitVariant = 'splitHorizontalIn' | 'splitHorizontalOut' | 'splitVerticalIn' | 'splitVerticalOut';
+/**
+ * Map a Split `presetSubtype` to its barn-door variant. PowerPoint (COM
+ * `EffectParameters.Direction` on msoAnimEffectSplit, saved and read back)
+ * writes only 21 = `barn(inVertical)`, 26 = `barn(inHorizontal)`,
+ * 37 = `barn(outVertical)` and 42 = `barn(outHorizontal)`. 5 and 10 are kept
+ * for files that borrowed the Blinds codes for the two "out" variants.
+ */
+export declare const SPLIT_SUBTYPE_TO_VARIANT: Readonly<Record<number, SplitVariant>>;
+/**
+ * Inverse of the direction encoding documented on {@link WIPE_SUBTYPE_TO_EDGE}:
+ * maps the literal `p:animEffect/@filter="wipe(<token>)"` subtype token to the
+ * numeric `p:cTn/@presetSubtype` code PowerPoint pairs it with. Lets a
+ * filter-only animation (no `presetSubtype` of its own) reuse the exact same
+ * directional machinery ({@link import('./animation-directional').buildDirectionalKeyframe})
+ * as a preset-driven one, by synthesising the equivalent numeric code. See
+ * `resolveFilterPresetSubtype` in `animation-filter-effects`.
+ */
+export declare const WIPE_FILTER_TOKEN_TO_SUBTYPE: Readonly<Record<string, number>>;
+/**
+ * Inverse of {@link SPLIT_SUBTYPE_TO_VARIANT}, keyed by the literal
+ * `p:animEffect/@filter="barn(<token>)"` subtype token rather than the
+ * numeric `presetSubtype`. Same four codes, just re-keyed for filter-only
+ * decks; see `resolveFilterPresetSubtype` in `animation-filter-effects`.
+ */
+export declare const BARN_FILTER_TOKEN_TO_SUBTYPE: Readonly<Record<string, number>>;
+/**
+ * Direction/variant tokens for the `blinds`, `checkerboard`, and `randombar`
+ * `p:animEffect/@filter` families (ECMA-376/SMIL 2.0 Transition Effects).
+ * Unlike Wipe/Barn, this project has no COM-verified numeric
+ * `p:cTn/@presetSubtype` table for these three families, but PowerPoint
+ * pairs a preset-driven Blinds/Checkerboard/Random-Bars entrance with the
+ * exact same literal filter token regardless (the same pairing already
+ * relied on for Wipe/Barn, see {@link WIPE_SUBTYPE_TO_EDGE}'s doc), so
+ * reading `anim.effectFilter?.subtype` directly is a reliable signal that
+ * needs no numeric guessing.
+ */
+export type BlindsDirection = 'vertical' | 'horizontal';
+export type CheckerboardDirection = 'across' | 'down';
+export type RandomBarsDirection = 'vertical' | 'horizontal';
+/**
+ * Map a `wheel(<n>)` `p:animEffect/@filter` subtype token to the nearest of
+ * PowerPoint's five selectable Wheel "Spokes" Effect Option counts (the same
+ * `1, 2, 3, 4, 8` set `p:wheel/@spokes` uses for the Wheel SLIDE TRANSITION,
+ * see {@link import('./slide-transition-types').WHEEL_SPOKE_COUNTS}, reused
+ * here rather than re-declared). Defaults to 4 (this Effect Option's own
+ * default) when the token is absent or unparsable; the slide-transition
+ * schema's own default of 1 does not apply here, so this is a distinct
+ * resolver rather than a call to that module's `resolveWheelSpokeCount`
+ * (named differently to avoid a barrel-export collision with it).
+ */
+export declare function resolveAnimationWheelSpokeCount(subtypeToken: string | undefined): number;
+/**
+ * Redirect the DEFAULT `blindsIn`/`checkerboardIn`/`randomBarsIn`/`wheelIn`
+ * {@link EffectName} to its direction/spoke-count-aware variant, when the
+ * animation's own `p:animEffect/@filter` names a matching family with a
+ * recognised subtype token. Used by both `resolveEffect` (the presetId-driven
+ * primary path, `animation-timeline-helpers.ts`) and `resolveFilterEffect`
+ * (the filter-only fallback path, `animation-filter-effects.ts`) so a deck
+ * reaches the same subtype-aware keyframe regardless of which path resolved
+ * it. Returns `effect` unchanged when there is no filter, a family mismatch,
+ * or an unrecognised subtype token (falls back to PowerPoint's own default
+ * direction/spoke-count, matching the default keyframe's own choice).
+ */
+export declare function redirectMaskEffectByFilterSubtype(effect: EffectName | undefined, filter: {
+    family: string;
+    subtype?: string;
+} | undefined): EffectName | undefined;
+/**
+ * Redirect the default Box / Circle / Diamond / Plus EXIT (which closes in
+ * toward the centre, PowerPoint's "In") to its "Out" variant when the effect
+ * asks for that direction: the filter's own subtype token (`box(out)`), else,
+ * with no filter to read, `presetSubtype` 32. Mirrors how the entrance side
+ * honours the same token in {@link redirectMaskEffectByFilterSubtype}.
+ * Returns `effect` unchanged for any other effect or direction.
+ */
+export declare function redirectExitShapeByDirection(effect: EffectName | undefined, filter: {
+    family: string;
+    subtype?: string;
+} | undefined, presetSubtype: number | undefined): EffectName | undefined;
+//# sourceMappingURL=animation-presets-subtypes.d.ts.map

package/dist/pptx/render/animation-presets-subtypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-presets-subtypes.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-presets-subtypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAW7D,6DAA6D;AAC7D,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUjE,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKlE,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,YAAY,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,CAAC;AAEtB;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAO3E,CAAC;AAMF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzE,CAAC;AAMF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;AACxD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAexF;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,iCAAiC,CAChD,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACtD,UAAU,GAAG,SAAS,CAoCxB;AAeD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACxD,aAAa,EAAE,MAAM,GAAG,SAAS,GAC/B,UAAU,GAAG,SAAS,CASxB"}

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

@@ -0,0 +1,23 @@
+/**
+ * `animation-presets` - OOXML preset-id -> effect-name lookup tables for the
+ * native-animation timeline. Pure data, framework-free.
+ *
+ * The entrance/exit/emphasis tables and the presetSubtype direction/variant
+ * tables each live in their own module (kept under the repo's file-size
+ * guideline); this module composes them into the single
+ * {@link PRESET_ID_TO_EFFECT} map and re-exports everything else, so every
+ * existing import of `./animation-presets` keeps working unchanged.
+ *
+ * @module render/animation-presets
+ */
+import type { EffectName } from './animation-timeline-types.js';
+export { EMPH_FILTER_PRESETS, emphasisFilterKeyframeCss } from './animation-presets-emphasis.js';
+export { BARN_FILTER_TOKEN_TO_SUBTYPE, FLY_SUBTYPE_TO_EDGE, redirectExitShapeByDirection, redirectMaskEffectByFilterSubtype, resolveAnimationWheelSpokeCount, SPLIT_SUBTYPE_TO_VARIANT, WIPE_FILTER_TOKEN_TO_SUBTYPE, WIPE_SUBTYPE_TO_EDGE, } from './animation-presets-subtypes.js';
+export type { BlindsDirection, CheckerboardDirection, FlyEdge, RandomBarsDirection, SplitVariant, } from './animation-presets-subtypes.js';
+interface PresetIdMap {
+    entr: Record<number, EffectName>;
+    exit: Record<number, EffectName>;
+    emph: Record<number, EffectName>;
+}
+export declare const PRESET_ID_TO_EFFECT: PresetIdMap;
+//# sourceMappingURL=animation-presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation-presets.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,EACN,4BAA4B,EAC5B,mBAAmB,EACnB,4BAA4B,EAC5B,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,GACpB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACX,eAAe,EACf,qBAAqB,EACrB,OAAO,EACP,mBAAmB,EACnB,YAAY,GACZ,MAAM,8BAA8B,CAAC;AAMtC,UAAU,WAAW;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,mBAAmB,EAAE,WAIjC,CAAC"}

package/dist/pptx/render/animation-preview-behavior.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `animation-preview-behavior` - the editor's canvas preview of an entrance
+ * or exit, played from PowerPoint's own behaviour tree for the preset and
+ * direction (the one core's writer saves, see `capturedPresetNativeAnimation`)
+ * through the same player the slide show uses.
+ *
+ * The preset keyframes the preview used before only knew a handful of
+ * presets and moved a Fly In one element width with a fade; PowerPoint's
+ * starts it just off the slide edge with no fade. Playing the saved tree
+ * makes the preview show what the saved file will do in PowerPoint.
+ *
+ * @module render/animation-preview-behavior
+ */
+import type { PptxAnimationDirection, PptxAnimationPreset, PptxAnimationTimingCurve } from 'ooxml-core/pptx';
+import type { AnimationElementBox } from './animation-render-context.js';
+/** An element's box on its stage plus the stage size, both in px. */
+export interface PreviewGeometry {
+    box: AnimationElementBox;
+    slidePx: {
+        width: number;
+        height: number;
+    };
+}
+/** The descriptor shape `buildPreviewAnimation` returns. */
+export interface BehaviorPreviewDescriptor {
+    keyframeName: string;
+    keyframesCss: string;
+    cssAnimation: string;
+    durationMs: number;
+}
+/**
+ * Measure `element`'s box against its stage (its offset parent, laid out in
+ * unscaled slide px), or `undefined` when it is not laid out.
+ */
+export declare function measurePreviewGeometry(element: HTMLElement): PreviewGeometry | undefined;
+/**
+ * A preview descriptor playing PowerPoint's tree for `preset` at `direction`,
+ * or `undefined` when the preset is not an entrance/exit with a captured tree
+ * or the player cannot represent it (the caller keeps its preset keyframe).
+ */
+export declare function buildBehaviorPreview(preset: PptxAnimationPreset, options: {
+    direction?: PptxAnimationDirection;
+    durationMs?: number;
+    timingCurve?: PptxAnimationTimingCurve;
+}, geometry: PreviewGeometry): BehaviorPreviewDescriptor | undefined;
+//# sourceMappingURL=animation-preview-behavior.d.ts.map

package/dist/pptx/render/animation-preview-behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-preview-behavior.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-preview-behavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACX,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,MAAM,iBAAiB,CAAC;AAWzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,mBAAmB,CAAC;IACzB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS,CAiBxF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE;IACR,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACvC,EACD,QAAQ,EAAE,eAAe,GACvB,yBAAyB,GAAG,SAAS,CAuCvC"}

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

@@ -0,0 +1,54 @@
+/**
+ * `animation-preview`  -  pure preview-descriptor construction for the editor's
+ * animation panel: map an editor preset (+ direction / timing) to a CSS
+ * keyframe name, definition and shorthand. The DOM player that injects the
+ * `<style>` and toggles the element animation stays in each binding.
+ *
+ * @module render/animation-preview
+ */
+import type { PptxAnimationPreset, PptxAnimationDirection, PptxAnimationTimingCurve } from 'ooxml-core/pptx';
+import type { PreviewGeometry } from './animation-preview-behavior.js';
+/**
+ * Map a timing curve name to a CSS easing string.
+ * Supports the standard OOXML timing curves plus cubic-bezier extraction. An
+ * unset curve plays `linear`, like the `accel=0 decel=0` the writer saves.
+ */
+export declare function timingCurveToCss(curve?: PptxAnimationTimingCurve, cubicBezierValues?: string): string;
+export interface AnimationPreviewDescriptor {
+    /** CSS @keyframes name. */
+    keyframeName: string;
+    /** Full CSS @keyframes definition block. */
+    keyframesCss: string;
+    /** CSS animation shorthand value to apply. */
+    cssAnimation: string;
+    /** Duration in ms. */
+    durationMs: number;
+}
+/**
+ * Build a preview animation descriptor for a given preset.
+ *
+ * With `geometry` (the element's measured box on its stage, see
+ * `measurePreviewGeometry`), an entrance or exit plays PowerPoint's own
+ * behaviour tree for the preset and direction, exactly what the saved file
+ * does in PowerPoint; otherwise, or for a preset without one, the preset
+ * keyframe plays. Returns `undefined` if the preset doesn't have a known
+ * effect.
+ */
+export declare function buildPreviewAnimation(preset: PptxAnimationPreset, options?: {
+    direction?: PptxAnimationDirection;
+    durationMs?: number;
+    timingCurve?: PptxAnimationTimingCurve;
+    cubicBezier?: string;
+    geometry?: PreviewGeometry;
+}): AnimationPreviewDescriptor | undefined;
+/**
+ * Parse OOXML timing curve bezier values from `a:cTn/a:timing/a:curve`.
+ *
+ * OOXML stores bezier control points as attributes:
+ * - `x1`, `y1`  -  first control point (0..100000 range)
+ * - `x2`, `y2`  -  second control point (0..100000 range)
+ *
+ * Returns a CSS `cubic-bezier()` string, or undefined if not parseable.
+ */
+export declare function parseOoxmlBezierCurve(x1: number | undefined, y1: number | undefined, x2: number | undefined, y2: number | undefined): string | undefined;
+//# sourceMappingURL=animation-preview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation-preview.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAsDpE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,CAAC,EAAE,wBAAwB,EAChC,iBAAiB,CAAC,EAAE,MAAM,GACxB,MAAM,CASR;AAMD,MAAM,WAAW,0BAA0B;IAC1C,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE;IACT,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC3B,GACC,0BAA0B,GAAG,SAAS,CA+BxC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,EAAE,EAAE,MAAM,GAAG,SAAS,GACpB,MAAM,GAAG,SAAS,CAYpB"}

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

@@ -0,0 +1,57 @@
+/**
+ * `animation-render-context` - the geometry + theme lookup a slide's native
+ * animation timeline needs to resolve formulas that reference the animated
+ * shape's REAL box (e.g. Grow And Turn's `-#ppt_w/2` fly-in) and scheme-colour
+ * (`a:schemeClr`) stops in a `p:animClr` / `p:tavLst` colour ramp. Neither can
+ * be resolved from the animation node alone (see
+ * `animation-ppt-formula-ground-truth.md`), so `PresentationAnimationController
+ * .fromSlide` builds this once per slide from data every binding already
+ * loads: the slide's own elements (for geometry) and the deck's resolved
+ * theme colour map.
+ *
+ * @module render/animation-render-context
+ */
+import type { PptxSlide } from 'ooxml-core/pptx';
+/**
+ * A shape's authored box as a fraction (0..1) of the slide's own width/height,
+ * matching the `#ppt_x`/`#ppt_y`/`#ppt_w`/`#ppt_h` convention (`x`/`y` are the
+ * TOP-LEFT corner; a formula consumer derives the centre itself).
+ */
+export interface AnimationElementBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /**
+     * Slide width / height, when known. Motion paths are authored in slide
+     * fractions of each axis, so their real (paced) arc length needs it.
+     */
+    slideAspect?: number;
+}
+/**
+ * The context a slide's animation timeline resolves formulas/scheme colours
+ * against. Both members are independently optional in practice (a binding
+ * may have geometry but no theme, or vice versa); `getElementBox` always
+ * exists on a built context but returns `undefined` for an id it has no
+ * geometry for.
+ */
+export interface AnimationRenderContext {
+    /** The animated element's authored box (slide-fraction units), or `undefined` when unknown. */
+    getElementBox(elementId: string): AnimationElementBox | undefined;
+    /** The deck's resolved theme colour map (`accent1`.., `tx1`/`bg1`/`tx2`/`bg2` aliases), when loaded. */
+    themeColorMap?: Readonly<Record<string, string>>;
+}
+/** Slide canvas size, in the SAME px unit `PptxElement.x/y/width/height` are authored in. */
+export interface AnimationSlideSize {
+    widthPx: number;
+    heightPx: number;
+}
+/**
+ * Build the render context `PresentationAnimationController.fromSlide` threads
+ * into the timeline builder. Returns `undefined` when neither geometry nor a
+ * theme colour map is usable, so a caller with nothing to offer skips building
+ * a context at all and the timeline falls back to its existing self-only
+ * formula resolution / bare scheme-name fallback exactly as before.
+ */
+export declare function buildAnimationRenderContext(slide: PptxSlide, slideSize: AnimationSlideSize | undefined, themeColorMap: Readonly<Record<string, string>> | undefined): AnimationRenderContext | undefined;
+//# sourceMappingURL=animation-render-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation-render-context.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/animation-render-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACtC,+FAA+F;IAC/F,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAClE,wGAAwG;IACxG,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACjB;AASD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,kBAAkB,GAAG,SAAS,EACzC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACzD,sBAAsB,GAAG,SAAS,CAuBpC"}