@pixerate/editor 0.58.0 → 0.59.0

package/dist/animation-editor/index.d.ts

@@ -1,5 +1,5 @@
-import { b as AnimationEasing } from '../easing-CNGk-W6d.js';
-import { b as AnimationLoopMode, c as AnimationPlayer, C as Clock } from '../player-W-5DX3Go.js';
+import { b as AnimationEasing } from '../easing-lM0Xo9Ni.js';
+import { b as AnimationLoopMode, c as AnimationPlayer, C as Clock } from '../player-DV4Jujdq.js';
 import { V as VectorDocument, a as VectorNode, b as VectorBounds, c as VectorSvgExportOptions } from '../svg-Dh17jCyA.js';
 import { a as MotionBehavior } from '../behavior-Ymbld6jL.js';
 import { A as AffineMatrix, B as BezierPath } from '../bezier-DYBvLgUH.js';
@@ -31,6 +31,11 @@ interface MotionScene {
     loop?: AnimationLoopMode;
     /** Frame rate used to sample motion that a target format cannot express exactly (default 30). */
     fps?: number;
+    /**
+     * Stepped time for every command that gives none: changes hold on a grid of this many frames
+     * per second ("on twos" at 12), for a hand-drawn look. Default: smooth.
+     */
+    steps?: number;
     /** Wanted length in seconds `[min, max]`; `check` warns outside it. */
     target?: [number, number];
     /** Parameters a Flair effect made from this scene exposes (see `toFlairVectorEffect`). */
@@ -55,6 +60,8 @@ type MotionCamera = (MotionRect | {
 }) & {
     ease?: AnimationEasing;
     ms?: number;
+    /** Zoom at a steady rate (the size changes by the same factor each moment) instead of linearly. */
+    geometric?: boolean;
 };
 /** One beat of the animation. */
 interface MotionShot {
@@ -73,7 +80,7 @@ interface MotionShot {
 interface MotionCommandBase {
     /** Node ids from the artwork (groups animate as one). */
     targets: string[];
-    /** Length in ms for each target (each type has a default; `draw` follows the path length). */
+    /** Length in ms for each target, one cycle when repeating (each type has a default; `draw` follows the path length; a spring `ease` lasts until it settles). */
     duration?: number;
     /** Wait this many ms before starting (default 0). */
     delay?: number;
@@ -81,9 +88,23 @@ interface MotionCommandBase {
     stagger?: number;
     /** `after` (default) starts when the commands before it finish; `previous` starts with the command before. */
     with?: 'after' | 'previous';
+    /** An easing; a spring with no `duration` lasts until it settles. */
     ease?: AnimationEasing;
     /** Why this command is here (for people and agents reading the scene). */
     note?: string;
+    /**
+     * Play the change this many times (a whole number, default 1); `duration` is one cycle. Not
+     * for `enter`, `exit` or `wait`.
+     */
+    repeat?: number;
+    /**
+     * How repeats follow each other: `loop` (default) starts each cycle afresh, `mirror` plays
+     * every other one backwards, `offset` carries on from where the last ended (rotate by 90,
+     * repeat 4: a full turn). Colours and shapes offset like `loop`.
+     */
+    repeatMode?: 'loop' | 'mirror' | 'offset';
+    /** Stepped time: hold the change on a grid of this many frames per second (default: the scene's `steps`, else smooth). */
+    steps?: number;
 }
 type MotionEnterStyle = 'fade' | 'pop' | 'grow' | 'slide' | 'draw' | 'zoom' | 'rise' | 'wipe' | 'iris' | 'split';
 type MotionExitStyle = 'fade' | 'shrink' | 'slide' | 'undraw' | 'wipe';
@@ -161,6 +182,8 @@ interface MotionScaleCommand extends MotionCommandBase {
         x: number;
         y: number;
     };
+    /** Grow at a steady rate (the same factor each moment), which reads as an even zoom. */
+    geometric?: boolean;
 }
 /** Changes opacity (0–1). */
 interface MotionFadeCommand extends MotionCommandBase {
@@ -271,6 +294,7 @@ type MotionCommand = MotionEnterCommand | MotionExitCommand | MotionDrawCommand
 type MotionCommandType = MotionCommand['type'];
 declare const MOTION_COMMAND_TYPES: readonly MotionCommandType[];
 declare const MOTION_ENTER_STYLES: readonly MotionEnterStyle[];
+declare const MOTION_REPEAT_MODES: readonly ["loop", "mirror", "offset"];
 declare const MOTION_EXIT_STYLES: readonly MotionExitStyle[];
 declare const MOTION_IRIS_SHAPES: readonly MotionIrisShape[];
 declare const MOTION_SPLIT_ORIENTATIONS: readonly MotionSplitOrientation[];
@@ -388,6 +412,10 @@ declare const MOTION_ISSUE_CODES: {
         readonly severity: "warning";
         readonly wording: "A change is too quick to follow.";
     };
+    readonly 'spring-cut-short': {
+        readonly severity: "warning";
+        readonly wording: "A spring is given a duration shorter than it takes to settle, so it jumps to its end.";
+    };
     readonly 'scene-too-long': {
         readonly severity: "warning";
         readonly wording: "The scene runs past its target length.";
@@ -496,6 +524,12 @@ interface MotionSegment {
      * transform Flair is given), so a wriggle wanders each on the channel Flair uses. Default 0.
      */
     index?: number;
+    /** Played backwards in time (a mirrored repeat): progress runs 1 → 0 through the ease. */
+    reverse?: boolean;
+    /** Stepped time: progress holds on a grid of this many frames per second from the start. */
+    steps?: number;
+    /** Numbers change by a steady factor (`from·(to/from)^u`); a camera zooms at a steady rate. */
+    geometric?: boolean;
     /** For `follow`: the path node id, and whether to turn with it. */
     path?: string;
     rotate?: boolean;
@@ -584,7 +618,7 @@ declare function motionRestValue(entry: MotionNodeEntry | undefined, property: M
 }): MotionValue;
 /** `from` → `to` at eased progress `u` (numbers extrapolate, colours mix in OKLab, others switch at the end). */
 declare function interpolateMotionValue(from: MotionValue, to: MotionValue, u: number): MotionValue;
-/** Progress (0–1, unclamped by the easing) of a segment at `time`. */
+/** Progress (0–1, unclamped by the easing) of a segment at `time`: stepped, reversed and eased as the segment says. */
 declare function segmentProgress(segment: MotionSegment, time: number): {
     u: number;
     eased: number;
@@ -605,8 +639,12 @@ declare function fitMotionRect(rect: MotionRect, aspect: number): MotionRect;
 declare function resolveMotionCamera(camera: MotionCamera, scene: MotionScene): MotionRect | null;
 /** Length of a node's outline (its longest path for a group), in document units. */
 declare function motionPathLength(node: VectorNode, parentWorld?: AffineMatrix): number;
-/** How long one target of a command takes (ms). */
+/** How many times a command plays (1 for `enter`, `exit` and `wait`, which do not repeat). */
+declare function motionCommandRepeat(command: MotionCommand): number;
+/** How long one target of a command takes (ms), every repeat included. */
 declare function motionCommandDuration(command: MotionCommand, scene: MotionScene, target?: string): number;
+/** How long one cycle of a command takes for one target (ms): its `duration`, a spring's settle time, the line's length for a draw, or the type's default. */
+declare function motionCycleDuration(command: MotionCommand, scene: MotionScene, target?: string): number;
 /** Cubic ease-out, `1 − (1 − t)³` exactly (Flair's `out`): the default for things arriving. */
 declare const MOTION_EASE_OUT: AnimationEasing;
 /** Cubic ease-in-out (close to Flair's `in-out`): the default for moves. */
@@ -721,6 +759,7 @@ type MotionEdit = {
     description?: string | null;
     loop?: MotionScene['loop'];
     fps?: number;
+    steps?: number | null;
     target?: [number, number] | null;
 } | {
     op: 'insert_shots';
@@ -805,8 +844,17 @@ declare function createMotionScene(artwork: VectorDocument, init?: Partial<Omit<
  */
 /** Flair's easing names. */
 type FlairEaseName = 'linear' | 'in-out' | 'out';
-/** A Flair easing: a name, or (Flair 0.36 and later) a CSS cubic-bezier `[x1, y1, x2, y2]`. */
-type FlairEase = FlairEaseName | readonly [number, number, number, number];
+/** Flair's spring ease (Flair 0.39 and later): the editor's spring, number for number. */
+interface FlairSpringEase {
+    spring: {
+        mass?: number;
+        stiffness?: number;
+        damping?: number;
+        velocity?: number;
+    };
+}
+/** A Flair easing: a name, (Flair 0.36 and later) a CSS cubic-bezier `[x1, y1, x2, y2]`, or (0.39) a spring. */
+type FlairEase = FlairEaseName | readonly [number, number, number, number] | FlairSpringEase;
 /** Flair's curves, for matching. */
 declare const FLAIR_EASES: Readonly<Record<FlairEaseName, (t: number) => number>>;
 /** One change of a Flair `SvgMotion` (mirrors `SvgAnimation` in `@pixerate/flair/vector`). */
@@ -825,6 +873,16 @@ interface FlairSvgAnimation {
     orient?: boolean;
     /** Flair 0.38 and later: how the change swings from → to (see `MotionBehavior`). */
     behavior?: MotionBehavior;
+    /** Flair 0.39 and later: stepped time, held on a grid of this many frames per second. */
+    strobe?: number;
+    /** Flair 0.39 and later: whole cycles to play (default 1); with `alternate`, every other one backwards. */
+    repeat?: number;
+    alternate?: boolean;
+    /** Flair features scenes do not have (imports skip them with a note). */
+    count?: readonly [number, number];
+    write?: string;
+    scramble?: string;
+    solo?: number;
     view?: readonly [number, number, number, number] | string;
 }
 /** Mirrors `SvgMotion` in `@pixerate/flair/vector`. */
@@ -896,7 +954,17 @@ interface FlairExportOptions {
      * older Flair, and they are sampled into linear steps.
      */
     behaviors?: boolean;
+    /**
+     * The Flair version the export is for (default `0.39`): it decides what is written exactly
+     * and what is sampled. 0.36 adds cubic-bezier curves, 0.38 behaviours, 0.39 springs and
+     * stepped time (`strobe`). `curves` and `behaviors` override it.
+     */
+    flair?: string;
 }
+/** The Flair version exports target by default. */
+declare const FLAIR_EXPORT_VERSION = "0.39";
+/** Whether Flair `version` is at least `min` (dotted numbers). */
+declare function flairAtLeast(version: string, min: string): boolean;
 /** The Flair easing that matches `ease` (within 1% everywhere), if any. */
 declare function flairEaseFor(ease: AnimationEasing): FlairEaseName | undefined;
 /**
@@ -922,6 +990,36 @@ declare function toFlairVectorEffect(scene: MotionScene, options?: FlairEffectOp
 /** A scene as a document for Flair's `EffectEditor` (`replaceDocument`). */
 declare function toFlairEffectDocument(scene: MotionScene, options?: FlairExportOptions): FlairEffectDocument;
 
+/**
+ * Import from Flair: a Flair `SvgMotion` (or a catalog `VectorEffect`) becomes a scene, so an
+ * effect made in Flair, or taken from its catalog, can be opened and edited here. The reverse
+ * of `toFlairSvgMotion`, as far as the scene model goes:
+ *
+ * - The SVG becomes the artwork (`parseVectorSvg`); `{{name: color …}}` placeholders become
+ *   colour controls (other placeholders take their defaults).
+ * - Each Flair step becomes a shot, its changes commands timed by their `delay`, all together.
+ * - Opacity, paint, stroke width, transforms (as move, rotate and scale), drawing on, following
+ *   a path, camera views and behaviours (pulse, shake, teeter, wave, wiggle, colour pulse) carry
+ *   over. Counting, writing text, solo containers and anything else are listed in `notes`.
+ */
+interface FlairImportResult {
+    scene: MotionScene;
+    /** What could not be carried over exactly, in sentences. */
+    notes: string[];
+    /** `checkMotionScene` of the result. */
+    issues: MotionIssue[];
+}
+interface FlairImportOptions {
+    /** The scene's name (default: the effect's, else `from-flair`). */
+    name?: string;
+    /** Hold after the last shot, ms (default: the effect's `hold`, else 600). */
+    hold?: number;
+}
+/** A Flair `SvgMotion` as a scene (see the module notes for what carries over). */
+declare function fromFlairSvgMotion(input: FlairSvgMotion, options?: FlairImportOptions): FlairImportResult;
+/** A Flair catalog `VectorEffect` as a scene: its motion, name, description, colour controls and presets. */
+declare function fromFlairVectorEffect(effect: FlairVectorEffect, options?: FlairImportOptions): FlairImportResult;
+
 interface AnimationEditorOptions {
     /** The scene to open (default: an empty one over a blank 800 × 450 artwork). */
     scene?: MotionScene;
@@ -1105,6 +1203,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1121,6 +1222,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1136,6 +1240,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1157,6 +1264,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1172,6 +1282,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1182,6 +1295,7 @@ declare function describeMotionShots(scene: MotionScene): {
             x: number;
             y: number;
         };
+        geometric?: boolean;
         targets: string[];
         duration?: number;
         delay?: number;
@@ -1189,6 +1303,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1203,6 +1320,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1219,6 +1339,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1233,6 +1356,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1250,6 +1376,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1265,6 +1394,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1281,6 +1413,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1296,6 +1431,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1311,6 +1449,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1329,6 +1470,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1345,6 +1489,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1361,6 +1508,9 @@ declare function describeMotionShots(scene: MotionScene): {
         with?: "after" | "previous";
         ease?: AnimationEasing;
         note?: string;
+        repeat?: number;
+        repeatMode?: "loop" | "mirror" | "offset";
+        steps?: number;
         index: number;
     } | {
         flairPrimitive?: string | undefined;
@@ -1392,6 +1542,6 @@ declare function createAnimationEditorToolProvider(controller: AnimationEditorCo
  * A short authoring guide for a model writing vector animations with the animation editor's
  * tools. Static, so it caches well as part of a system prompt.
  */
-declare const ANIMATION_EDITOR_AGENT_INSTRUCTIONS = "You animate vector artwork. A scene is artwork (vector paths and groups, each with an id) plus shots.\n\nHow it plays\n- Shots play in order. A shot optionally moves the camera, plays its commands, then holds (default 600 ms).\n- Commands in a shot play one after another; give \"with\": \"previous\" to start one together with the command before, \"delay\" to wait, \"stagger\" to offset several targets.\n- Timing comes from the content: each command has a default length (enter 600 ms, move 700 ms, draw follows the path length). Only set \"duration\" to change the pace.\n- Anything that enters later is hidden until it enters. Things that never enter are visible from the start.\n- Every frame is a pure function of time: the same scene always plays the same frames.\n\nCommands\n- enter (fade, pop, grow, slide, draw) and exit (fade, shrink, slide, undraw) bring things in and out.\n- enter also reveals through a clip over the target's box: wipe (behind an edge travelling \"direction\", default right), iris (from the centre; \"shape\": circle or box) and split (from a line through the middle; \"orientation\": horizontal or vertical). exit wipe hides the same way. Reveals need a width and a height: use draw / undraw for a straight line.\n- draw draws strokes on to a fraction; move, rotate, scale and fade change the pose (about the centre); style blends solid colours and stroke width.\n- enter also has zoom (settles from larger) and rise (rises a short way, overshooting a touch); pop and zoom take a starting \"scale\".\n- morph turns a shape into another node's shape (keep the target hidden); follow moves along a path node (with \"rotate\", moves made meanwhile turn with the path).\n- Emphasis draws the eye and returns to rest: pulse (swell), shake (side to side, or \"axis\": \"vertical\"), teeter (rock), wave (bob, no settling), wiggle (seeded wander; the same seed wanders the same way) and color-pulse (tint and back).\n- Commands share their names and defaults with Flair's motion primitives (get_animation shows each one's \"flairPrimitive\"), and emphasis, reveals and follows export to Flair exactly.\n- effect tweens a numeric parameter of a live path effect already on the node (twist angle, wiggle time, zig zag size).\n\nWorking method\n1. get_animation to learn the element ids (set_animation_artwork_svg first if there is no artwork: give every element you will animate an id).\n2. Plan a few shots, each one idea. Add them with insert_shots, or edit_animation to make several edits as one step (dry_run first when unsure).\n3. check_animation and fix every error and warning; render_animation_frame (shot + \"end\") to look at the result.\n4. To make a reusable Flair effect, set_animation_controls (colour controls stand for every use of their default colour) and export_flair_effect.\n\nKeep motion purposeful: one thing moving at a time reads best, ease-out for arrivals, ease-in for exits, and hold long enough to see each result.";
+declare const ANIMATION_EDITOR_AGENT_INSTRUCTIONS = "You animate vector artwork. A scene is artwork (vector paths and groups, each with an id) plus shots.\n\nHow it plays\n- Shots play in order. A shot optionally moves the camera, plays its commands, then holds (default 600 ms).\n- Commands in a shot play one after another; give \"with\": \"previous\" to start one together with the command before, \"delay\" to wait, \"stagger\" to offset several targets.\n- Timing comes from the content: each command has a default length (enter 600 ms, move 700 ms, draw follows the path length). Only set \"duration\" to change the pace.\n- Anything that enters later is hidden until it enters. Things that never enter are visible from the start.\n- Every frame is a pure function of time: the same scene always plays the same frames.\n\nCommands\n- enter (fade, pop, grow, slide, draw) and exit (fade, shrink, slide, undraw) bring things in and out.\n- enter also reveals through a clip over the target's box: wipe (behind an edge travelling \"direction\", default right), iris (from the centre; \"shape\": circle or box) and split (from a line through the middle; \"orientation\": horizontal or vertical). exit wipe hides the same way. Reveals need a width and a height: use draw / undraw for a straight line.\n- draw draws strokes on to a fraction; move, rotate, scale and fade change the pose (about the centre); style blends solid colours and stroke width.\n- enter also has zoom (settles from larger) and rise (rises a short way, overshooting a touch); pop and zoom take a starting \"scale\".\n- morph turns a shape into another node's shape (keep the target hidden); follow moves along a path node (with \"rotate\", moves made meanwhile turn with the path).\n- Emphasis draws the eye and returns to rest: pulse (swell), shake (side to side, or \"axis\": \"vertical\"), teeter (rock), wave (bob, no settling), wiggle (seeded wander; the same seed wanders the same way) and color-pulse (tint and back).\n- Any command but enter and exit can \"repeat\" (loop, mirror back and forth, or offset to carry on: rotate by 90, repeat 4 is a full turn); \"duration\" is one cycle.\n- Springs (\"spring-gentle\", \"spring-quick\", \"spring-bouncy\", \"spring-slow\" or { \"type\": \"spring\", \u2026 }) feel physical; leave \"duration\" out and the spring sets it.\n- \"steps\": 12 (on a command, or for the whole scene with set_animation_settings) holds poses \"on twos\" for a hand-drawn look. \"geometric\": true on scale or a camera zooms at an even rate.\n- Commands share their names and defaults with Flair's motion primitives (get_animation shows each one's \"flairPrimitive\"), and emphasis, reveals and follows export to Flair exactly.\n- effect tweens a numeric parameter of a live path effect already on the node (twist angle, wiggle time, zig zag size).\n\nWorking method\n1. get_animation to learn the element ids (set_animation_artwork_svg first if there is no artwork: give every element you will animate an id; or import_flair_effect to start from a Flair effect and edit it).\n2. Plan a few shots, each one idea. Add them with insert_shots, or edit_animation to make several edits as one step (dry_run first when unsure).\n3. check_animation and fix every error and warning; render_animation_frame (shot + \"end\") to look at the result.\n4. To make a reusable Flair effect, set_animation_controls (colour controls stand for every use of their default colour) and export_flair_effect.\n\nKeep motion purposeful: one thing moving at a time reads best, ease-out for arrivals, ease-in for exits, and hold long enough to see each result.";
 
-export { ANIMATION_EDITOR_AGENT_INSTRUCTIONS, AnimationEditorController, type AnimationEditorOptions, type AnimationEditorSelection, type AnimationEditorState, type AnimationEditorToolProviderOptions, FLAIR_EASES, type FlairEase, type FlairEaseName, type FlairEffectDocument, type FlairEffectOptions, type FlairExportOptions, type FlairMotionExport, type FlairSvgAnimation, type FlairSvgMotion, type FlairVectorEffect, MOTION_CAMERA_MS, MOTION_COMMAND_SCHEMA, MOTION_COMMAND_TYPES, MOTION_DEFAULT_DURATIONS, MOTION_DEFAULT_HOLD, MOTION_DIRECTIONS, MOTION_DRAW_EFFECT_ID, MOTION_DRAW_MS_PER_UNIT, MOTION_DRAW_RANGE, MOTION_EASE_IN_OUT, MOTION_EASE_OUT, MOTION_EDIT_OPS, MOTION_ENTER_STYLES, MOTION_EXIT_STYLES, MOTION_IRIS_SHAPES, MOTION_ISSUE_CODES, MOTION_MIN_CHANGE_MS, MOTION_SPLIT_ORIENTATIONS, type MotionCamera, type MotionClipShape, type MotionColorPulseCommand, type MotionCommand, type MotionCommandBase, type MotionCommandTiming, type MotionCommandType, type MotionControl, type MotionDirection, type MotionDrawCommand, type MotionEdit, type MotionEditOp, type MotionEditResult, type MotionEffectCommand, type MotionEnterCommand, type MotionEnterStyle, type MotionExitCommand, type MotionExitStyle, type MotionFadeCommand, type MotionFollowCommand, type MotionFrame, type MotionFrameOptions, type MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMorphCommand, type MotionMoveCommand, type MotionNodeEntry, type MotionPreset, type MotionProperty, type MotionPulseCommand, type MotionRect, type MotionReveal, type MotionRotateCommand, type MotionScaleCommand, type MotionScene, MotionSceneFormatError, type MotionSegment, type MotionShakeCommand, type MotionShot, type MotionShotTiming, type MotionSplitOrientation, type MotionStyleCommand, type MotionSvgOptions, type MotionTeeterCommand, type MotionTimeline, type MotionValue, type MotionWaitCommand, type MotionWaveCommand, type MotionWiggleCommand, activeSegment, applyMotionControlValues, applyMotionEdits, checkMotionScene, commandShapeProblems, compileMotionScene, createAnimationEditorToolProvider, createMotionScene, describeMotionElements, describeMotionShots, fitMotionRect, flairCurveFor, flairEaseFor, freshShotId, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, motionClipAttrs, motionCommandDuration, motionFlairPrimitive, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionIssue, motionIssueKey, motionIssueLine, motionNodeClips, motionNodeOffset, motionPathLength, motionRestValue, motionRevealClip, motionRevealPadding, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionTrackKey, namedWithSuggestion, parseMotionScene, resolveMotionCamera, segmentProgress, segmentValue, shotShapeProblems, suggestName, toFlairEffectDocument, toFlairSvgMotion, toFlairVectorEffect, trackValue, withViewBox };
+export { ANIMATION_EDITOR_AGENT_INSTRUCTIONS, AnimationEditorController, type AnimationEditorOptions, type AnimationEditorSelection, type AnimationEditorState, type AnimationEditorToolProviderOptions, FLAIR_EASES, FLAIR_EXPORT_VERSION, type FlairEase, type FlairEaseName, type FlairEffectDocument, type FlairEffectOptions, type FlairExportOptions, type FlairImportOptions, type FlairImportResult, type FlairMotionExport, type FlairSpringEase, type FlairSvgAnimation, type FlairSvgMotion, type FlairVectorEffect, MOTION_CAMERA_MS, MOTION_COMMAND_SCHEMA, MOTION_COMMAND_TYPES, MOTION_DEFAULT_DURATIONS, MOTION_DEFAULT_HOLD, MOTION_DIRECTIONS, MOTION_DRAW_EFFECT_ID, MOTION_DRAW_MS_PER_UNIT, MOTION_DRAW_RANGE, MOTION_EASE_IN_OUT, MOTION_EASE_OUT, MOTION_EDIT_OPS, MOTION_ENTER_STYLES, MOTION_EXIT_STYLES, MOTION_IRIS_SHAPES, MOTION_ISSUE_CODES, MOTION_MIN_CHANGE_MS, MOTION_REPEAT_MODES, MOTION_SPLIT_ORIENTATIONS, type MotionCamera, type MotionClipShape, type MotionColorPulseCommand, type MotionCommand, type MotionCommandBase, type MotionCommandTiming, type MotionCommandType, type MotionControl, type MotionDirection, type MotionDrawCommand, type MotionEdit, type MotionEditOp, type MotionEditResult, type MotionEffectCommand, type MotionEnterCommand, type MotionEnterStyle, type MotionExitCommand, type MotionExitStyle, type MotionFadeCommand, type MotionFollowCommand, type MotionFrame, type MotionFrameOptions, type MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMorphCommand, type MotionMoveCommand, type MotionNodeEntry, type MotionPreset, type MotionProperty, type MotionPulseCommand, type MotionRect, type MotionReveal, type MotionRotateCommand, type MotionScaleCommand, type MotionScene, MotionSceneFormatError, type MotionSegment, type MotionShakeCommand, type MotionShot, type MotionShotTiming, type MotionSplitOrientation, type MotionStyleCommand, type MotionSvgOptions, type MotionTeeterCommand, type MotionTimeline, type MotionValue, type MotionWaitCommand, type MotionWaveCommand, type MotionWiggleCommand, activeSegment, applyMotionControlValues, applyMotionEdits, checkMotionScene, commandShapeProblems, compileMotionScene, createAnimationEditorToolProvider, createMotionScene, describeMotionElements, describeMotionShots, fitMotionRect, flairAtLeast, flairCurveFor, flairEaseFor, freshShotId, fromFlairSvgMotion, fromFlairVectorEffect, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, motionClipAttrs, motionCommandDuration, motionCommandRepeat, motionCycleDuration, motionFlairPrimitive, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionIssue, motionIssueKey, motionIssueLine, motionNodeClips, motionNodeOffset, motionPathLength, motionRestValue, motionRevealClip, motionRevealPadding, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionTrackKey, namedWithSuggestion, parseMotionScene, resolveMotionCamera, segmentProgress, segmentValue, shotShapeProblems, suggestName, toFlairEffectDocument, toFlairSvgMotion, toFlairVectorEffect, trackValue, withViewBox };