@pixerate/editor 0.64.0 → 0.66.0

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

@@ -910,6 +910,77 @@ declare function motionFrameToSvg(scene: MotionScene, time: number, options?: Mo
 /** Replaces the root `viewBox` of an SVG string. */
 declare function withViewBox(svg: string, box: MotionRect): string;
 
+/**
+ * Seeing motion on a still: onion skin (faded frames either side of the playhead) and motion
+ * paths (where each node's centre travels). Frames are pure functions of time, so both are just
+ * more frames: no state, and the same picture every time.
+ */
+interface MotionOnionSkin {
+    /** Ghost frames before the playhead (default 2). */
+    before?: number;
+    /** Ghost frames after the playhead (default 0). */
+    after?: number;
+    /**
+     * Time between ghosts: ms (default 1000 / 12, every other frame at 24 fps), or `commands` to
+     * ghost the moments commands start and end around the playhead.
+     */
+    spacing?: number | 'commands';
+    /** Opacity of the nearest ghost (default 0.35); further ones fade as 1 / distance. */
+    opacity?: number;
+}
+interface MotionGhost {
+    time: number;
+    /** Negative before the playhead, positive after: 1 is the nearest. */
+    offset: number;
+    opacity: number;
+}
+/** The ghost frames for a playhead at `time`, nearest first on each side. */
+declare function motionGhosts(scene: MotionScene, time: number, onion?: MotionOnionSkin): MotionGhost[];
+interface MotionPathOptions {
+    /** From this time, ms (default 0). */
+    from?: number;
+    /** To this time, ms (default the end). */
+    to?: number;
+    /** Time between samples, ms (default 1000 / 30; at most 400 samples). */
+    step?: number;
+}
+interface MotionPath {
+    id: string;
+    /** Where the node's centre is, in document units, sample by sample. */
+    points: {
+        t: number;
+        x: number;
+        y: number;
+    }[];
+    /** Where it is when a change that moves it (or a group it is in) starts or ends. */
+    keys: {
+        t: number;
+        x: number;
+        y: number;
+    }[];
+}
+/** Ids of the nodes whose place changes (they or a group they are in move, turn, scale, follow or morph). */
+declare function motionMovingIds(scene: MotionScene): string[];
+/** Where a node's centre travels over time (its bounds as drawn, in document units). */
+declare function motionPath(scene: MotionScene, id: string, options?: MotionPathOptions): MotionPath;
+/** Motion paths as an SVG overlay: a line per node and a dot where each change starts or ends. Stroke widths follow the camera so they read the same at any zoom. */
+declare function motionPathsSvg(paths: readonly MotionPath[], camera: MotionRect, color?: string): string;
+/** What the stage can draw over a frame. */
+interface MotionOverlayOptions {
+    /** Faded frames either side of the playhead. */
+    onionSkin?: MotionOnionSkin;
+    /** Draw where nodes travel: true for every node whose place changes, or a list of ids. */
+    motionPaths?: boolean | readonly string[];
+    /** Colour of motion paths (default `#f43f5e`). */
+    motionPathColor?: string;
+}
+/**
+ * The frame at `time` as SVG with overlays: ghost frames under it (each with its own id prefix,
+ * element ids dropped so they never clash) and motion paths over it. Without overlays it is
+ * `motionFrameToSvg`.
+ */
+declare function motionStageSvg(scene: MotionScene, time: number, options?: MotionSvgOptions & MotionOverlayOptions): string;
+
 /** Changes shorter than this (ms) are too quick to follow. */
 declare const MOTION_MIN_CHANGE_MS = 120;
 /**
@@ -966,6 +1037,11 @@ type MotionEdit = {
     op: 'delete_commands';
     shot: string;
     commands: number[];
+} | {
+    op: 'move_command';
+    shot: string;
+    command: number;
+    to: number;
 } | {
     op: 'set_artwork';
     artwork: VectorDocument;
@@ -1094,9 +1170,10 @@ interface FlairVectorEffect {
     category: string;
     tags: string[];
     motion: FlairSvgMotion;
+    /** Values are `#rrggbb` strings, or `[r, g, b]` channels from 0 to 1 (Flair's catalog writes both); imports turn them into hex. */
     presets?: {
         name: string;
-        values: Record<string, string>;
+        values: Record<string, string | readonly number[]>;
     }[];
     /** Ms on the last frame before looping. */
     hold?: number;
@@ -1408,7 +1485,7 @@ declare class AnimationEditorController {
     /** The scene at `time` (default: the playhead). */
     frame(time?: number, options?: MotionFrameOptions): MotionFrame;
     /** The scene at `time` (default: the playhead) as SVG. */
-    toSvg(time?: number, options?: MotionSvgOptions): string;
+    toSvg(time?: number, options?: MotionSvgOptions & MotionOverlayOptions): string;
     /** The scene as a Flair `SvgMotion`. */
     toFlairMotion(options?: FlairExportOptions): FlairMotionExport;
     /** The scene as a Flair catalog vector effect. */
@@ -1848,6 +1925,151 @@ 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); match does the same for a whole group, part by part (Smart Animate: draw the end state as a second, hidden group whose parts share names with the first); 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- Emphasis stacks on other motion: a shake during a slide shakes as it slides. Give move, rotate or scale \"blend\": \"add\" to stack them too (what they add stays); \"blend\": \"replace\" makes a change take over instead.\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- To time shots to music or a voiceover: set a \"beat\" grid or \"narration\" word timings with set_animation_settings, read them with get_timing_grid, and give a shot \"at\": { \"beat\": n } or { \"word\": i }. The shot before holds until the cue; check_animation warns when a cue is missed.\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. To hit a length, fit_animation (keep the shots whose pace matters). 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); match does the same for a whole group, part by part (Smart Animate: draw the end state as a second, hidden group whose parts share names with the first); 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- Emphasis stacks on other motion: a shake during a slide shakes as it slides. Give move, rotate or scale \"blend\": \"add\" to stack them too (what they add stays); \"blend\": \"replace\" makes a change take over instead.\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- To time shots to music or a voiceover: set a \"beat\" grid or \"narration\" word timings with set_animation_settings, read them with get_timing_grid, and give a shot \"at\": { \"beat\": n } or { \"word\": i }. The shot before holds until the cue; check_animation warns when a cue is missed.\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 (add_commands, update_command, move_command and delete_commands refine a shot), or edit_animation to make several edits as one step (dry_run first when unsure).\n3. To hit a length, fit_animation (keep the shots whose pace matters). check_animation and fix every error and warning; render_animation_frame (shot + \"end\") to look at the result; add onion_skin or motion_paths to see the motion in one picture, or get_motion_path for the numbers.\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.";
+
+/**
+ * Helpers for hand-editing UIs (React's and Svelte's command inspector, ease picker, cue picker,
+ * scrubber and stage picking). They hold the logic both bindings share, so the components stay
+ * thin and alike. The command form is generated from `MOTION_COMMAND_SCHEMA`, the same schema
+ * the agent tools take, so people and agents see the same fields, limits and descriptions.
+ */
+/** How a command field is edited. */
+type MotionFieldKind = 'targets' | 'node' | 'enum' | 'number' | 'integer' | 'boolean' | 'text' | 'color' | 'point' | 'scale' | 'ease';
+interface MotionFieldSpec {
+    name: string;
+    kind: MotionFieldKind;
+    label: string;
+    description: string;
+    required: boolean;
+    /** For `enum`. */
+    options?: readonly string[];
+    min?: number;
+    max?: number;
+    /** Unit shown next to a number: `ms`, `units`, `°`, `Hz`, `fps`, `×` or `0–1`. */
+    unit?: string;
+    /** `main` (what it does) or `timing` (when and how fast). */
+    group: 'main' | 'timing';
+}
+/** `repeatMode` → `Repeat mode`. */
+declare function motionFieldLabel(name: string): string;
+/**
+ * The fields a command type takes, in schema order (main fields first, then timing), each with
+ * how to edit it, its limits and unit. Generated from `MOTION_COMMAND_SCHEMA`.
+ */
+declare function motionCommandFields(type: MotionCommandType): MotionFieldSpec[];
+type MotionFieldInput = {
+    set: unknown;
+} | {
+    remove: true;
+} | {
+    error: string;
+};
+/**
+ * Turns what a person typed into a field into a value to `set`, a field to `remove` (an empty
+ * optional field) or an `error` to show. Numbers are checked against the field's limits.
+ */
+declare function parseMotionFieldInput(field: MotionFieldSpec, raw: string | boolean | readonly string[] | {
+    x: string;
+    y: string;
+}): MotionFieldInput;
+/** The `update_command` edit for one field input, or the error to show. */
+declare function motionFieldEdit(shot: string, command: number, field: MotionFieldSpec, raw: Parameters<typeof parseMotionFieldInput>[1]): MotionEdit | {
+    error: string;
+};
+/**
+ * A new command of `type` on `targets`, with its required fields filled from the artwork (the
+ * first hidden shape to morph into, the first path to follow, the first effect parameter to
+ * tween). Returns an error when the artwork has nothing to fill one with.
+ */
+declare function defaultMotionCommand(type: MotionCommandType, targets: readonly string[], scene: MotionScene): MotionCommand | {
+    error: string;
+};
+/** A short line for a command in a list: `enter pop · ring, badge`. */
+declare function motionCommandSummary(command: MotionCommand): string;
+/** The commands of a shot as a list UI shows them. */
+declare function motionCommandRows(scene: MotionScene, shotId: string): {
+    flairPrimitive?: string | undefined;
+    index: number;
+    command: MotionCommand;
+    summary: string;
+    start: number;
+    end: number;
+}[];
+/** Edits that put a copy of a command right after it. */
+declare function duplicateMotionCommandEdit(scene: MotionScene, shot: string, command: number): MotionEdit;
+/** The ease picker's choices: `default` (the command type's own), every preset, then `custom`. */
+declare const MOTION_EASE_CHOICES: readonly {
+    value: string;
+    label: string;
+}[];
+/** The picker value for an easing: `''` for none, the preset name, else `custom`. */
+declare function motionEaseKey(ease: AnimationEasing | undefined | null): string;
+interface MotionEasingCurve {
+    /** Samples of the eased value from u = 0 to 1. */
+    points: {
+        u: number;
+        v: number;
+    }[];
+    /** The lowest and highest eased value (below 0 or above 1 when the curve overshoots). */
+    min: number;
+    max: number;
+    /** The length the curve was sampled over: a spring's settle time, else `durationMs`. */
+    durationMs: number;
+}
+/** Samples an easing (`evaluateEasing`) for a preview; springs are sampled until they settle. */
+declare function motionEasingCurve(ease: AnimationEasing | string | undefined | null, samples?: number, durationMs?: number): MotionEasingCurve;
+/** An SVG path (`d`) of an easing curve in a `width` × `height` box, overshoot included. */
+declare function motionEasingPath(curve: MotionEasingCurve, width: number, height: number, pad?: number): string;
+/** Where 0 and 1 fall on a curve preview's y axis (for guide lines). */
+declare function motionEasingGuides(curve: MotionEasingCurve, height: number, pad?: number): {
+    zero: number;
+    one: number;
+};
+interface ElementLike {
+    getAttribute(name: string): string | null;
+    parentElement: ElementLike | null;
+}
+/**
+ * The artwork node a click landed on: the nearest element (from `target` up to `root`) whose
+ * id is a node of the scene. Onion-skin ghosts and motion-path overlays carry no node ids, so
+ * clicks on them pick nothing.
+ */
+declare function motionNodeAtElement(scene: MotionScene, target: ElementLike | null, root?: ElementLike | null): string | null;
+/** Marks the nodes `ids` in stage SVG with `data-picked` and outlines them. */
+declare function highlightMotionSvg(svg: string, ids: readonly string[], color?: string): string;
+/** Ticks for a time ruler `width` px wide: a step that leaves at least `minGap` px between labels. */
+declare function motionRulerTicks(duration: number, width: number, minGap?: number): {
+    time: number;
+    label: string;
+    major: boolean;
+}[];
+/**
+ * The edits that fit a scene to `ms` (`fitMotionScene`): one `update_shot` per shot whose speed
+ * changes, so applied together they are one undo step. Throws with the reason when it can't fit.
+ */
+declare function fitMotionSceneEdits(scene: MotionScene, ms: number, options?: MotionFitOptions): MotionEdit[];
+/** A cue picker's value for a cue: `beat:4`, `word:2`, `ms:1200` or `''` for none. */
+declare function motionCueKey(cue: MotionCue | undefined): string;
+/** The cue a picker value names, or undefined for none. */
+declare function motionCueFromKey(key: string): MotionCue | undefined;
+/**
+ * The cues a shot can start on: every beat of the scene's grid up to a little past the end, and
+ * every narration word, each labelled with its time.
+ */
+declare function motionCueChoices(scene: MotionScene, limit?: number): {
+    value: string;
+    label: string;
+    time: number;
+}[];
+/** When a shot's cue falls (ms), or undefined. */
+declare function motionShotCueTime(scene: MotionScene, cue: MotionCue | undefined): number | undefined;
+/** Narration as text, a word a line: `<start ms> <word>`. */
+declare function formatMotionNarration(narration: MotionNarration | undefined): string;
+/** Reads narration typed a word a line (`<start ms> <word>`); empty text clears it. */
+declare function parseMotionNarration(text: string): {
+    narration: MotionNarration | null;
+} | {
+    error: string;
+};
 
-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, type LottieAnimation, type LottieExport, type LottieExportOptions, type LottieKeyframe, type LottieShape, type LottieValue, MOTION_ADDITIVE_PROPERTIES, MOTION_BLENDS, 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_SPEED_RANGE, MOTION_SPLIT_ORIENTATIONS, type MotionBeatGrid, type MotionCamera, type MotionClipShape, type MotionColorPulseCommand, type MotionCommand, type MotionCommandBase, type MotionCommandTiming, type MotionCommandType, type MotionControl, type MotionCue, type MotionDirection, type MotionDrawCommand, type MotionEdit, type MotionEditOp, type MotionEditResult, type MotionEffectCommand, type MotionEnterCommand, type MotionEnterStyle, type MotionExitCommand, type MotionExitStyle, type MotionFadeCommand, type MotionFit, type MotionFitOptions, type MotionFollowCommand, type MotionFrame, type MotionFrameOptions, type MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMatch, type MotionMatchCommand, type MotionMorphCommand, type MotionMoveCommand, type MotionNarration, 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, fitMotionScene, flairAtLeast, flairCurveFor, flairEaseFor, freshShotId, fromFlairSvgMotion, fromFlairVectorEffect, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, matchMotionNodes, motionAddTrackKey, motionBeatAt, motionBeatTime, motionClipAttrs, motionCommandDuration, motionCommandRepeat, motionCueTime, motionCycleDuration, motionFlairPrimitive, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionIssue, motionIssueKey, motionIssueLine, motionNodeClips, motionNodeOffset, motionPathLength, motionRestValue, motionRevealClip, motionRevealPadding, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionShotTimeScale, motionTrackKey, namedWithSuggestion, parseMotionScene, resolveMotionCamera, segmentProgress, segmentValue, shotShapeProblems, suggestName, toFlairEffectDocument, toFlairSvgMotion, toFlairVectorEffect, toLottie, trackValue, withMotionLayers, 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, type LottieAnimation, type LottieExport, type LottieExportOptions, type LottieKeyframe, type LottieShape, type LottieValue, MOTION_ADDITIVE_PROPERTIES, MOTION_BLENDS, 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_CHOICES, 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_SPEED_RANGE, MOTION_SPLIT_ORIENTATIONS, type MotionBeatGrid, type MotionCamera, type MotionClipShape, type MotionColorPulseCommand, type MotionCommand, type MotionCommandBase, type MotionCommandTiming, type MotionCommandType, type MotionControl, type MotionCue, type MotionDirection, type MotionDrawCommand, type MotionEasingCurve, type MotionEdit, type MotionEditOp, type MotionEditResult, type MotionEffectCommand, type MotionEnterCommand, type MotionEnterStyle, type MotionExitCommand, type MotionExitStyle, type MotionFadeCommand, type MotionFieldInput, type MotionFieldKind, type MotionFieldSpec, type MotionFit, type MotionFitOptions, type MotionFollowCommand, type MotionFrame, type MotionFrameOptions, type MotionGhost, type MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMatch, type MotionMatchCommand, type MotionMorphCommand, type MotionMoveCommand, type MotionNarration, type MotionNodeEntry, type MotionOnionSkin, type MotionOverlayOptions, type MotionPath, type MotionPathOptions, 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, defaultMotionCommand, describeMotionElements, describeMotionShots, duplicateMotionCommandEdit, fitMotionRect, fitMotionScene, fitMotionSceneEdits, flairAtLeast, flairCurveFor, flairEaseFor, formatMotionNarration, freshShotId, fromFlairSvgMotion, fromFlairVectorEffect, highlightMotionSvg, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, matchMotionNodes, motionAddTrackKey, motionBeatAt, motionBeatTime, motionClipAttrs, motionCommandDuration, motionCommandFields, motionCommandRepeat, motionCommandRows, motionCommandSummary, motionCueChoices, motionCueFromKey, motionCueKey, motionCueTime, motionCycleDuration, motionEaseKey, motionEasingCurve, motionEasingGuides, motionEasingPath, motionFieldEdit, motionFieldLabel, motionFlairPrimitive, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionGhosts, motionIssue, motionIssueKey, motionIssueLine, motionMovingIds, motionNodeAtElement, motionNodeClips, motionNodeOffset, motionPath, motionPathLength, motionPathsSvg, motionRestValue, motionRevealClip, motionRevealPadding, motionRulerTicks, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionShotCueTime, motionShotTimeScale, motionStageSvg, motionTrackKey, namedWithSuggestion, parseMotionFieldInput, parseMotionNarration, parseMotionScene, resolveMotionCamera, segmentProgress, segmentValue, shotShapeProblems, suggestName, toFlairEffectDocument, toFlairSvgMotion, toFlairVectorEffect, toLottie, trackValue, withMotionLayers, withViewBox };

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

@@ -910,6 +910,77 @@ declare function motionFrameToSvg(scene: MotionScene, time: number, options?: Mo
 /** Replaces the root `viewBox` of an SVG string. */
 declare function withViewBox(svg: string, box: MotionRect): string;
 
+/**
+ * Seeing motion on a still: onion skin (faded frames either side of the playhead) and motion
+ * paths (where each node's centre travels). Frames are pure functions of time, so both are just
+ * more frames: no state, and the same picture every time.
+ */
+interface MotionOnionSkin {
+    /** Ghost frames before the playhead (default 2). */
+    before?: number;
+    /** Ghost frames after the playhead (default 0). */
+    after?: number;
+    /**
+     * Time between ghosts: ms (default 1000 / 12, every other frame at 24 fps), or `commands` to
+     * ghost the moments commands start and end around the playhead.
+     */
+    spacing?: number | 'commands';
+    /** Opacity of the nearest ghost (default 0.35); further ones fade as 1 / distance. */
+    opacity?: number;
+}
+interface MotionGhost {
+    time: number;
+    /** Negative before the playhead, positive after: 1 is the nearest. */
+    offset: number;
+    opacity: number;
+}
+/** The ghost frames for a playhead at `time`, nearest first on each side. */
+declare function motionGhosts(scene: MotionScene, time: number, onion?: MotionOnionSkin): MotionGhost[];
+interface MotionPathOptions {
+    /** From this time, ms (default 0). */
+    from?: number;
+    /** To this time, ms (default the end). */
+    to?: number;
+    /** Time between samples, ms (default 1000 / 30; at most 400 samples). */
+    step?: number;
+}
+interface MotionPath {
+    id: string;
+    /** Where the node's centre is, in document units, sample by sample. */
+    points: {
+        t: number;
+        x: number;
+        y: number;
+    }[];
+    /** Where it is when a change that moves it (or a group it is in) starts or ends. */
+    keys: {
+        t: number;
+        x: number;
+        y: number;
+    }[];
+}
+/** Ids of the nodes whose place changes (they or a group they are in move, turn, scale, follow or morph). */
+declare function motionMovingIds(scene: MotionScene): string[];
+/** Where a node's centre travels over time (its bounds as drawn, in document units). */
+declare function motionPath(scene: MotionScene, id: string, options?: MotionPathOptions): MotionPath;
+/** Motion paths as an SVG overlay: a line per node and a dot where each change starts or ends. Stroke widths follow the camera so they read the same at any zoom. */
+declare function motionPathsSvg(paths: readonly MotionPath[], camera: MotionRect, color?: string): string;
+/** What the stage can draw over a frame. */
+interface MotionOverlayOptions {
+    /** Faded frames either side of the playhead. */
+    onionSkin?: MotionOnionSkin;
+    /** Draw where nodes travel: true for every node whose place changes, or a list of ids. */
+    motionPaths?: boolean | readonly string[];
+    /** Colour of motion paths (default `#f43f5e`). */
+    motionPathColor?: string;
+}
+/**
+ * The frame at `time` as SVG with overlays: ghost frames under it (each with its own id prefix,
+ * element ids dropped so they never clash) and motion paths over it. Without overlays it is
+ * `motionFrameToSvg`.
+ */
+declare function motionStageSvg(scene: MotionScene, time: number, options?: MotionSvgOptions & MotionOverlayOptions): string;
+
 /** Changes shorter than this (ms) are too quick to follow. */
 declare const MOTION_MIN_CHANGE_MS = 120;
 /**
@@ -966,6 +1037,11 @@ type MotionEdit = {
     op: 'delete_commands';
     shot: string;
     commands: number[];
+} | {
+    op: 'move_command';
+    shot: string;
+    command: number;
+    to: number;
 } | {
     op: 'set_artwork';
     artwork: VectorDocument;
@@ -1094,9 +1170,10 @@ interface FlairVectorEffect {
     category: string;
     tags: string[];
     motion: FlairSvgMotion;
+    /** Values are `#rrggbb` strings, or `[r, g, b]` channels from 0 to 1 (Flair's catalog writes both); imports turn them into hex. */
     presets?: {
         name: string;
-        values: Record<string, string>;
+        values: Record<string, string | readonly number[]>;
     }[];
     /** Ms on the last frame before looping. */
     hold?: number;
@@ -1408,7 +1485,7 @@ declare class AnimationEditorController {
     /** The scene at `time` (default: the playhead). */
     frame(time?: number, options?: MotionFrameOptions): MotionFrame;
     /** The scene at `time` (default: the playhead) as SVG. */
-    toSvg(time?: number, options?: MotionSvgOptions): string;
+    toSvg(time?: number, options?: MotionSvgOptions & MotionOverlayOptions): string;
     /** The scene as a Flair `SvgMotion`. */
     toFlairMotion(options?: FlairExportOptions): FlairMotionExport;
     /** The scene as a Flair catalog vector effect. */
@@ -1848,6 +1925,151 @@ 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); match does the same for a whole group, part by part (Smart Animate: draw the end state as a second, hidden group whose parts share names with the first); 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- Emphasis stacks on other motion: a shake during a slide shakes as it slides. Give move, rotate or scale \"blend\": \"add\" to stack them too (what they add stays); \"blend\": \"replace\" makes a change take over instead.\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- To time shots to music or a voiceover: set a \"beat\" grid or \"narration\" word timings with set_animation_settings, read them with get_timing_grid, and give a shot \"at\": { \"beat\": n } or { \"word\": i }. The shot before holds until the cue; check_animation warns when a cue is missed.\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. To hit a length, fit_animation (keep the shots whose pace matters). 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); match does the same for a whole group, part by part (Smart Animate: draw the end state as a second, hidden group whose parts share names with the first); 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- Emphasis stacks on other motion: a shake during a slide shakes as it slides. Give move, rotate or scale \"blend\": \"add\" to stack them too (what they add stays); \"blend\": \"replace\" makes a change take over instead.\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- To time shots to music or a voiceover: set a \"beat\" grid or \"narration\" word timings with set_animation_settings, read them with get_timing_grid, and give a shot \"at\": { \"beat\": n } or { \"word\": i }. The shot before holds until the cue; check_animation warns when a cue is missed.\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 (add_commands, update_command, move_command and delete_commands refine a shot), or edit_animation to make several edits as one step (dry_run first when unsure).\n3. To hit a length, fit_animation (keep the shots whose pace matters). check_animation and fix every error and warning; render_animation_frame (shot + \"end\") to look at the result; add onion_skin or motion_paths to see the motion in one picture, or get_motion_path for the numbers.\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.";
+
+/**
+ * Helpers for hand-editing UIs (React's and Svelte's command inspector, ease picker, cue picker,
+ * scrubber and stage picking). They hold the logic both bindings share, so the components stay
+ * thin and alike. The command form is generated from `MOTION_COMMAND_SCHEMA`, the same schema
+ * the agent tools take, so people and agents see the same fields, limits and descriptions.
+ */
+/** How a command field is edited. */
+type MotionFieldKind = 'targets' | 'node' | 'enum' | 'number' | 'integer' | 'boolean' | 'text' | 'color' | 'point' | 'scale' | 'ease';
+interface MotionFieldSpec {
+    name: string;
+    kind: MotionFieldKind;
+    label: string;
+    description: string;
+    required: boolean;
+    /** For `enum`. */
+    options?: readonly string[];
+    min?: number;
+    max?: number;
+    /** Unit shown next to a number: `ms`, `units`, `°`, `Hz`, `fps`, `×` or `0–1`. */
+    unit?: string;
+    /** `main` (what it does) or `timing` (when and how fast). */
+    group: 'main' | 'timing';
+}
+/** `repeatMode` → `Repeat mode`. */
+declare function motionFieldLabel(name: string): string;
+/**
+ * The fields a command type takes, in schema order (main fields first, then timing), each with
+ * how to edit it, its limits and unit. Generated from `MOTION_COMMAND_SCHEMA`.
+ */
+declare function motionCommandFields(type: MotionCommandType): MotionFieldSpec[];
+type MotionFieldInput = {
+    set: unknown;
+} | {
+    remove: true;
+} | {
+    error: string;
+};
+/**
+ * Turns what a person typed into a field into a value to `set`, a field to `remove` (an empty
+ * optional field) or an `error` to show. Numbers are checked against the field's limits.
+ */
+declare function parseMotionFieldInput(field: MotionFieldSpec, raw: string | boolean | readonly string[] | {
+    x: string;
+    y: string;
+}): MotionFieldInput;
+/** The `update_command` edit for one field input, or the error to show. */
+declare function motionFieldEdit(shot: string, command: number, field: MotionFieldSpec, raw: Parameters<typeof parseMotionFieldInput>[1]): MotionEdit | {
+    error: string;
+};
+/**
+ * A new command of `type` on `targets`, with its required fields filled from the artwork (the
+ * first hidden shape to morph into, the first path to follow, the first effect parameter to
+ * tween). Returns an error when the artwork has nothing to fill one with.
+ */
+declare function defaultMotionCommand(type: MotionCommandType, targets: readonly string[], scene: MotionScene): MotionCommand | {
+    error: string;
+};
+/** A short line for a command in a list: `enter pop · ring, badge`. */
+declare function motionCommandSummary(command: MotionCommand): string;
+/** The commands of a shot as a list UI shows them. */
+declare function motionCommandRows(scene: MotionScene, shotId: string): {
+    flairPrimitive?: string | undefined;
+    index: number;
+    command: MotionCommand;
+    summary: string;
+    start: number;
+    end: number;
+}[];
+/** Edits that put a copy of a command right after it. */
+declare function duplicateMotionCommandEdit(scene: MotionScene, shot: string, command: number): MotionEdit;
+/** The ease picker's choices: `default` (the command type's own), every preset, then `custom`. */
+declare const MOTION_EASE_CHOICES: readonly {
+    value: string;
+    label: string;
+}[];
+/** The picker value for an easing: `''` for none, the preset name, else `custom`. */
+declare function motionEaseKey(ease: AnimationEasing | undefined | null): string;
+interface MotionEasingCurve {
+    /** Samples of the eased value from u = 0 to 1. */
+    points: {
+        u: number;
+        v: number;
+    }[];
+    /** The lowest and highest eased value (below 0 or above 1 when the curve overshoots). */
+    min: number;
+    max: number;
+    /** The length the curve was sampled over: a spring's settle time, else `durationMs`. */
+    durationMs: number;
+}
+/** Samples an easing (`evaluateEasing`) for a preview; springs are sampled until they settle. */
+declare function motionEasingCurve(ease: AnimationEasing | string | undefined | null, samples?: number, durationMs?: number): MotionEasingCurve;
+/** An SVG path (`d`) of an easing curve in a `width` × `height` box, overshoot included. */
+declare function motionEasingPath(curve: MotionEasingCurve, width: number, height: number, pad?: number): string;
+/** Where 0 and 1 fall on a curve preview's y axis (for guide lines). */
+declare function motionEasingGuides(curve: MotionEasingCurve, height: number, pad?: number): {
+    zero: number;
+    one: number;
+};
+interface ElementLike {
+    getAttribute(name: string): string | null;
+    parentElement: ElementLike | null;
+}
+/**
+ * The artwork node a click landed on: the nearest element (from `target` up to `root`) whose
+ * id is a node of the scene. Onion-skin ghosts and motion-path overlays carry no node ids, so
+ * clicks on them pick nothing.
+ */
+declare function motionNodeAtElement(scene: MotionScene, target: ElementLike | null, root?: ElementLike | null): string | null;
+/** Marks the nodes `ids` in stage SVG with `data-picked` and outlines them. */
+declare function highlightMotionSvg(svg: string, ids: readonly string[], color?: string): string;
+/** Ticks for a time ruler `width` px wide: a step that leaves at least `minGap` px between labels. */
+declare function motionRulerTicks(duration: number, width: number, minGap?: number): {
+    time: number;
+    label: string;
+    major: boolean;
+}[];
+/**
+ * The edits that fit a scene to `ms` (`fitMotionScene`): one `update_shot` per shot whose speed
+ * changes, so applied together they are one undo step. Throws with the reason when it can't fit.
+ */
+declare function fitMotionSceneEdits(scene: MotionScene, ms: number, options?: MotionFitOptions): MotionEdit[];
+/** A cue picker's value for a cue: `beat:4`, `word:2`, `ms:1200` or `''` for none. */
+declare function motionCueKey(cue: MotionCue | undefined): string;
+/** The cue a picker value names, or undefined for none. */
+declare function motionCueFromKey(key: string): MotionCue | undefined;
+/**
+ * The cues a shot can start on: every beat of the scene's grid up to a little past the end, and
+ * every narration word, each labelled with its time.
+ */
+declare function motionCueChoices(scene: MotionScene, limit?: number): {
+    value: string;
+    label: string;
+    time: number;
+}[];
+/** When a shot's cue falls (ms), or undefined. */
+declare function motionShotCueTime(scene: MotionScene, cue: MotionCue | undefined): number | undefined;
+/** Narration as text, a word a line: `<start ms> <word>`. */
+declare function formatMotionNarration(narration: MotionNarration | undefined): string;
+/** Reads narration typed a word a line (`<start ms> <word>`); empty text clears it. */
+declare function parseMotionNarration(text: string): {
+    narration: MotionNarration | null;
+} | {
+    error: string;
+};
 
-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, type LottieAnimation, type LottieExport, type LottieExportOptions, type LottieKeyframe, type LottieShape, type LottieValue, MOTION_ADDITIVE_PROPERTIES, MOTION_BLENDS, 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_SPEED_RANGE, MOTION_SPLIT_ORIENTATIONS, type MotionBeatGrid, type MotionCamera, type MotionClipShape, type MotionColorPulseCommand, type MotionCommand, type MotionCommandBase, type MotionCommandTiming, type MotionCommandType, type MotionControl, type MotionCue, type MotionDirection, type MotionDrawCommand, type MotionEdit, type MotionEditOp, type MotionEditResult, type MotionEffectCommand, type MotionEnterCommand, type MotionEnterStyle, type MotionExitCommand, type MotionExitStyle, type MotionFadeCommand, type MotionFit, type MotionFitOptions, type MotionFollowCommand, type MotionFrame, type MotionFrameOptions, type MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMatch, type MotionMatchCommand, type MotionMorphCommand, type MotionMoveCommand, type MotionNarration, 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, fitMotionScene, flairAtLeast, flairCurveFor, flairEaseFor, freshShotId, fromFlairSvgMotion, fromFlairVectorEffect, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, matchMotionNodes, motionAddTrackKey, motionBeatAt, motionBeatTime, motionClipAttrs, motionCommandDuration, motionCommandRepeat, motionCueTime, motionCycleDuration, motionFlairPrimitive, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionIssue, motionIssueKey, motionIssueLine, motionNodeClips, motionNodeOffset, motionPathLength, motionRestValue, motionRevealClip, motionRevealPadding, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionShotTimeScale, motionTrackKey, namedWithSuggestion, parseMotionScene, resolveMotionCamera, segmentProgress, segmentValue, shotShapeProblems, suggestName, toFlairEffectDocument, toFlairSvgMotion, toFlairVectorEffect, toLottie, trackValue, withMotionLayers, 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, type LottieAnimation, type LottieExport, type LottieExportOptions, type LottieKeyframe, type LottieShape, type LottieValue, MOTION_ADDITIVE_PROPERTIES, MOTION_BLENDS, 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_CHOICES, 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_SPEED_RANGE, MOTION_SPLIT_ORIENTATIONS, type MotionBeatGrid, type MotionCamera, type MotionClipShape, type MotionColorPulseCommand, type MotionCommand, type MotionCommandBase, type MotionCommandTiming, type MotionCommandType, type MotionControl, type MotionCue, type MotionDirection, type MotionDrawCommand, type MotionEasingCurve, type MotionEdit, type MotionEditOp, type MotionEditResult, type MotionEffectCommand, type MotionEnterCommand, type MotionEnterStyle, type MotionExitCommand, type MotionExitStyle, type MotionFadeCommand, type MotionFieldInput, type MotionFieldKind, type MotionFieldSpec, type MotionFit, type MotionFitOptions, type MotionFollowCommand, type MotionFrame, type MotionFrameOptions, type MotionGhost, type MotionIrisShape, type MotionIssue, type MotionIssueCode, type MotionIssueSeverity, type MotionMatch, type MotionMatchCommand, type MotionMorphCommand, type MotionMoveCommand, type MotionNarration, type MotionNodeEntry, type MotionOnionSkin, type MotionOverlayOptions, type MotionPath, type MotionPathOptions, 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, defaultMotionCommand, describeMotionElements, describeMotionShots, duplicateMotionCommandEdit, fitMotionRect, fitMotionScene, fitMotionSceneEdits, flairAtLeast, flairCurveFor, flairEaseFor, formatMotionNarration, freshShotId, fromFlairSvgMotion, fromFlairVectorEffect, highlightMotionSvg, indexMotionNodes, interpolateMotionValue, isMotionCommand, isMotionShot, matchMotionNodes, motionAddTrackKey, motionBeatAt, motionBeatTime, motionClipAttrs, motionCommandDuration, motionCommandFields, motionCommandRepeat, motionCommandRows, motionCommandSummary, motionCueChoices, motionCueFromKey, motionCueKey, motionCueTime, motionCycleDuration, motionEaseKey, motionEasingCurve, motionEasingGuides, motionEasingPath, motionFieldEdit, motionFieldLabel, motionFlairPrimitive, motionFollowRoute, motionFrameAt, motionFrameToSvg, motionGhosts, motionIssue, motionIssueKey, motionIssueLine, motionMovingIds, motionNodeAtElement, motionNodeClips, motionNodeOffset, motionPath, motionPathLength, motionPathsSvg, motionRestValue, motionRevealClip, motionRevealPadding, motionRulerTicks, motionSceneShapeProblems, motionSceneToJson, motionShotAt, motionShotCueTime, motionShotTimeScale, motionStageSvg, motionTrackKey, namedWithSuggestion, parseMotionFieldInput, parseMotionNarration, parseMotionScene, resolveMotionCamera, segmentProgress, segmentValue, shotShapeProblems, suggestName, toFlairEffectDocument, toFlairSvgMotion, toFlairVectorEffect, toLottie, trackValue, withMotionLayers, withViewBox };