@pixerate/editor 0.63.0 → 0.64.0

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

@@ -1215,6 +1215,90 @@ declare function fromFlairSvgMotion(input: FlairSvgMotion, options?: FlairImport
 /** A Flair catalog `VectorEffect` as a scene: its motion, name, description, colour controls and presets. */
 declare function fromFlairVectorEffect(effect: FlairVectorEffect, options?: FlairImportOptions): FlairImportResult;
 
+/**
+ * Export to Lottie (Bodymovin JSON, v5): the scene as one shape layer whose groups mirror the
+ * artwork. Lottie players (lottie-web, rlottie, the iOS and Android libraries) then play it.
+ *
+ * - Each node is an outer group carrying its animated pose (anchor at its centre, position,
+ *   scale, rotation, opacity) around an inner group carrying its own transform. Paths keep their
+ *   own transform in their points.
+ * - Paths become `sh` shapes with solid fills (`fl`) and strokes (`st`). Drawing on becomes trim
+ *   paths (`tm`), and colours, stroke width and fill opacity animate on the fill and stroke.
+ * - The camera becomes the transform of a root group.
+ * - A change is written as keyframes with Lottie's bezier easing when a cubic-bezier ease (run
+ *   backwards for a mirrored repeat) is all that drives that property over that stretch.
+ *   Everything else is sampled at `fps` into linear keyframes: springs, elastic, behaviours,
+ *   stepped time, geometric zooms, additive layers, follows and camera moves.
+ *
+ * Gradients, dashes, reveal clips and skews of groups are not carried over; `notes` says so.
+ */
+/** A Lottie property: static (`a: 0`) or keyframed (`a: 1`). */
+type LottieValue = {
+    a: 0;
+    k: number | number[];
+} | {
+    a: 1;
+    k: LottieKeyframe[];
+};
+interface LottieKeyframe {
+    /** Frame. */
+    t: number;
+    /** Value from this key on. */
+    s: number[];
+    /** Out tangent of the ease to the next key (`x1`, `y1`). */
+    o?: {
+        x: number[];
+        y: number[];
+    };
+    /** In tangent of the ease to the next key (`x2`, `y2`). */
+    i?: {
+        x: number[];
+        y: number[];
+    };
+    /** Hold until the next key. */
+    h?: 1;
+}
+/** A Lottie shape item (group, path, fill, stroke, trim, transform): plain JSON. */
+type LottieShape = {
+    ty: string;
+    nm?: string;
+    [key: string]: unknown;
+};
+/** A Lottie animation: plain Bodymovin JSON. */
+interface LottieAnimation {
+    v: string;
+    fr: number;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+    nm: string;
+    ddd: 0;
+    assets: [];
+    layers: Record<string, unknown>[];
+    /** One marker per shot (`cm` its label, else its id). */
+    markers: {
+        tm: number;
+        cm: string;
+        dr: number;
+    }[];
+}
+interface LottieExportOptions {
+    /** Frame rate and sampling rate (default: the scene's `fps`, else 30). */
+    fps?: number;
+    /** Decimal places (default 3). */
+    precision?: number;
+}
+interface LottieExport {
+    lottie: LottieAnimation;
+    /** Keyframes that sample changes Lottie cannot ease the same way. */
+    sampled: number;
+    /** What could not be carried over, in sentences. */
+    notes: string[];
+}
+/** A scene as a Lottie animation. */
+declare function toLottie(scene: MotionScene, options?: LottieExportOptions): LottieExport;
+
 interface AnimationEditorOptions {
     /** The scene to open (default: an empty one over a blank 800 × 450 artwork). */
     scene?: MotionScene;
@@ -1766,4 +1850,4 @@ declare function createAnimationEditorToolProvider(controller: AnimationEditorCo
  */
 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.";
 
-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_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, 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_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 };

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

@@ -1215,6 +1215,90 @@ declare function fromFlairSvgMotion(input: FlairSvgMotion, options?: FlairImport
 /** A Flair catalog `VectorEffect` as a scene: its motion, name, description, colour controls and presets. */
 declare function fromFlairVectorEffect(effect: FlairVectorEffect, options?: FlairImportOptions): FlairImportResult;
 
+/**
+ * Export to Lottie (Bodymovin JSON, v5): the scene as one shape layer whose groups mirror the
+ * artwork. Lottie players (lottie-web, rlottie, the iOS and Android libraries) then play it.
+ *
+ * - Each node is an outer group carrying its animated pose (anchor at its centre, position,
+ *   scale, rotation, opacity) around an inner group carrying its own transform. Paths keep their
+ *   own transform in their points.
+ * - Paths become `sh` shapes with solid fills (`fl`) and strokes (`st`). Drawing on becomes trim
+ *   paths (`tm`), and colours, stroke width and fill opacity animate on the fill and stroke.
+ * - The camera becomes the transform of a root group.
+ * - A change is written as keyframes with Lottie's bezier easing when a cubic-bezier ease (run
+ *   backwards for a mirrored repeat) is all that drives that property over that stretch.
+ *   Everything else is sampled at `fps` into linear keyframes: springs, elastic, behaviours,
+ *   stepped time, geometric zooms, additive layers, follows and camera moves.
+ *
+ * Gradients, dashes, reveal clips and skews of groups are not carried over; `notes` says so.
+ */
+/** A Lottie property: static (`a: 0`) or keyframed (`a: 1`). */
+type LottieValue = {
+    a: 0;
+    k: number | number[];
+} | {
+    a: 1;
+    k: LottieKeyframe[];
+};
+interface LottieKeyframe {
+    /** Frame. */
+    t: number;
+    /** Value from this key on. */
+    s: number[];
+    /** Out tangent of the ease to the next key (`x1`, `y1`). */
+    o?: {
+        x: number[];
+        y: number[];
+    };
+    /** In tangent of the ease to the next key (`x2`, `y2`). */
+    i?: {
+        x: number[];
+        y: number[];
+    };
+    /** Hold until the next key. */
+    h?: 1;
+}
+/** A Lottie shape item (group, path, fill, stroke, trim, transform): plain JSON. */
+type LottieShape = {
+    ty: string;
+    nm?: string;
+    [key: string]: unknown;
+};
+/** A Lottie animation: plain Bodymovin JSON. */
+interface LottieAnimation {
+    v: string;
+    fr: number;
+    ip: number;
+    op: number;
+    w: number;
+    h: number;
+    nm: string;
+    ddd: 0;
+    assets: [];
+    layers: Record<string, unknown>[];
+    /** One marker per shot (`cm` its label, else its id). */
+    markers: {
+        tm: number;
+        cm: string;
+        dr: number;
+    }[];
+}
+interface LottieExportOptions {
+    /** Frame rate and sampling rate (default: the scene's `fps`, else 30). */
+    fps?: number;
+    /** Decimal places (default 3). */
+    precision?: number;
+}
+interface LottieExport {
+    lottie: LottieAnimation;
+    /** Keyframes that sample changes Lottie cannot ease the same way. */
+    sampled: number;
+    /** What could not be carried over, in sentences. */
+    notes: string[];
+}
+/** A scene as a Lottie animation. */
+declare function toLottie(scene: MotionScene, options?: LottieExportOptions): LottieExport;
+
 interface AnimationEditorOptions {
     /** The scene to open (default: an empty one over a blank 800 × 450 artwork). */
     scene?: MotionScene;
@@ -1766,4 +1850,4 @@ declare function createAnimationEditorToolProvider(controller: AnimationEditorCo
  */
 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.";
 
-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_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, 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_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 };

package/dist/animation-editor/index.js

@@ -23,6 +23,7 @@ import {
   bezierPathLength,
   bezierPathPointAtLength,
   bezierPathToSvg,
+  toBezierPath,
   transformBezierPath
 } from "../chunk-GTMJ4Y3S.js";
 import {
@@ -2183,6 +2184,311 @@ function fromFlairVectorEffect(effect, options = {}) {
   return { scene, notes, issues: checkMotionScene(scene) };
 }
 
+// src/animation-editor/lottie.ts
+var STATIC_TR = () => ({
+  ty: "tr",
+  p: { a: 0, k: [0, 0] },
+  a: { a: 0, k: [0, 0] },
+  s: { a: 0, k: [100, 100] },
+  r: { a: 0, k: 0 },
+  o: { a: 0, k: 100 },
+  sk: { a: 0, k: 0 },
+  sa: { a: 0, k: 0 }
+});
+function rgba(color) {
+  const hex = typeof color === "string" ? normalizeTokenColor(color) : null;
+  if (!hex) return null;
+  const n = (i) => parseInt(hex.slice(i, i + 2), 16) / 255;
+  return [n(1), n(3), n(5), hex.length >= 9 ? parseInt(hex.slice(7, 9), 16) / 255 : 1];
+}
+function lottieContours(path, round2) {
+  const out = [];
+  let cur = null;
+  let px = 0;
+  let py = 0;
+  const add = (x, y, inX, inY) => {
+    cur.v.push([x, y]);
+    cur.i.push([inX - x, inY - y]);
+    cur.o.push([0, 0]);
+    px = x;
+    py = y;
+  };
+  for (const cmd of path) {
+    if (cmd.type === "M") {
+      if (cur) out.push(cur);
+      cur = { c: false, v: [], i: [], o: [] };
+      add(cmd.x, cmd.y, cmd.x, cmd.y);
+    } else if (!cur) continue;
+    else if (cmd.type === "L") add(cmd.x, cmd.y, cmd.x, cmd.y);
+    else if (cmd.type === "Q") {
+      const c1 = [px + 2 / 3 * (cmd.x1 - px), py + 2 / 3 * (cmd.y1 - py)];
+      const c2 = [cmd.x + 2 / 3 * (cmd.x1 - cmd.x), cmd.y + 2 / 3 * (cmd.y1 - cmd.y)];
+      cur.o[cur.o.length - 1] = [c1[0] - px, c1[1] - py];
+      add(cmd.x, cmd.y, c2[0], c2[1]);
+    } else if (cmd.type === "C") {
+      cur.o[cur.o.length - 1] = [cmd.x1 - px, cmd.y1 - py];
+      add(cmd.x, cmd.y, cmd.x2, cmd.y2);
+    } else if (cmd.type === "Z") {
+      cur.c = true;
+      const n = cur.v.length;
+      if (n > 1 && Math.abs(cur.v[n - 1][0] - cur.v[0][0]) < 1e-9 && Math.abs(cur.v[n - 1][1] - cur.v[0][1]) < 1e-9) {
+        cur.i[0] = cur.i[n - 1];
+        cur.v.pop();
+        cur.i.pop();
+        cur.o.pop();
+      }
+      out.push(cur);
+      cur = null;
+    }
+  }
+  if (cur) out.push(cur);
+  return out.map((c) => ({ c: c.c, v: c.v.map((p) => p.map(round2)), i: c.i.map((p) => p.map(round2)), o: c.o.map((p) => p.map(round2)) }));
+}
+function staticParts(m) {
+  const sx = Math.hypot(m[0], m[1]);
+  if (!(sx > 1e-12)) return null;
+  const sy = (m[0] * m[3] - m[1] * m[2]) / sx;
+  if (Math.abs(m[2] + m[1] / sx * sy) > 1e-6 || Math.abs(m[3] - m[0] / sx * sy) > 1e-6) return null;
+  return { p: [m[4], m[5]], s: [sx * 100, sy * 100], r: Math.atan2(m[1], m[0]) * 180 / Math.PI };
+}
+function toLottie(scene, options = {}) {
+  const fps = options.fps ?? scene.fps ?? 30;
+  const precision = options.precision ?? 3;
+  const round2 = (n) => Math.round(n * 10 ** precision) / 10 ** precision;
+  const frame = (ms) => round2(ms * fps / 1e3);
+  const timeline = compileMotionScene(scene);
+  const nodes = indexMotionNodes(scene.artwork.nodes);
+  const notes = [];
+  let sampled = 0;
+  const track = (id, p) => timeline.tracks.get(motionTrackKey(id, p)) ?? [];
+  const layers = (id, p) => timeline.tracks.get(`${motionTrackKey(id, p)}\0add`) ?? [];
+  const end = timeline.duration;
+  const curveOf = (s) => {
+    if (s.behavior || s.steps || s.geometric) return void 0;
+    const e = s.reverse ? reverseCubicBezier(s.ease) : resolveEasing(s.ease);
+    if (!e || e === "hold" || e.type !== "cubic-bezier") return void 0;
+    return [e.x1, e.y1, e.x2, e.y2];
+  };
+  const animate = (segments, value, exact = true) => {
+    const rest = value(0).map(round2);
+    if (!segments.length) return { a: 0, k: rest.length === 1 ? rest[0] : rest };
+    const keys = [];
+    const key = (t, v, ease) => {
+      const k = { t: frame(t), s: v.map(round2) };
+      if (ease === "hold") k.h = 1;
+      else {
+        const [x1, y1, x2, y2] = ease === "linear" || !ease ? [0, 0, 1, 1] : ease;
+        k.o = { x: [round2(x1)], y: [round2(y1)] };
+        k.i = { x: [round2(x2)], y: [round2(y2)] };
+      }
+      if (keys.length && keys[keys.length - 1].t === k.t) keys[keys.length - 1] = k;
+      else keys.push(k);
+    };
+    const times = [.../* @__PURE__ */ new Set([0, ...segments.flatMap((s) => [s.start, s.end]), end])].filter((t) => t >= 0 && t <= end).sort((a, b) => a - b);
+    for (let n = 0; n + 1 < times.length; n++) {
+      const a = times[n];
+      const b = times[n + 1];
+      const active = segments.filter((s) => s.start < b && s.end > a);
+      if (!active.length) {
+        key(a, value(a), "hold");
+        continue;
+      }
+      const first = active[0];
+      const curve = exact && active.every((s) => s.start === a && s.end === b && JSON.stringify(curveOf(s)) === JSON.stringify(curveOf(first))) ? curveOf(first) : void 0;
+      if (curve) {
+        key(a, value(a), curve);
+        continue;
+      }
+      const count = Math.max(1, Math.ceil((b - a) * fps / 1e3));
+      for (let k = 0; k < count; k++) {
+        const t = a + (b - a) * k / count;
+        key(t, value(t), "linear");
+        sampled++;
+      }
+    }
+    for (const s of segments) if (s.end <= s.start) key(s.start, value(s.start), "hold");
+    keys.sort((x, y) => x.t - y.t);
+    key(end, value(end), "hold");
+    const last = keys[keys.length - 1];
+    delete last.o;
+    delete last.i;
+    delete last.h;
+    return { a: 1, k: keys };
+  };
+  const poseAt = (entry, t) => {
+    const o = motionNodeOffset(entry, timeline, t, nodes);
+    if (!o) return { p: [entry.center.x, entry.center.y], s: [100, 100], r: 0 };
+    const m = o.matrix;
+    const sx = Math.hypot(m[0], m[1]);
+    const sy = sx > 1e-12 ? (m[0] * m[3] - m[1] * m[2]) / sx : 0;
+    const c = entry.center;
+    return { p: [m[0] * c.x + m[2] * c.y + m[4], m[1] * c.x + m[3] * c.y + m[5]], s: [sx * 100, sy * 100], r: Math.atan2(m[1], m[0]) * 180 / Math.PI };
+  };
+  const poseTransform = (entry) => {
+    const id = entry.node.id;
+    const tr = STATIC_TR();
+    const c = [entry.center.x, entry.center.y].map(round2);
+    const own = (p) => track(id, p);
+    const layered = ["x", "y", "rotation", "scaleX", "scaleY"].some((p) => layers(id, p).length);
+    const moving = ["x", "y", "rotation", "scaleX", "scaleY", "follow"].some((p) => own(p).length) || layered;
+    if (moving) {
+      const mixed = own("follow").length > 0 || layered;
+      tr.a = { a: 0, k: c };
+      tr.p = animate(mixed ? [...own("x"), ...own("y"), ...own("follow"), ...layers(id, "x"), ...layers(id, "y")] : [...own("x"), ...own("y")], (t) => poseAt(entry, t).p, !mixed);
+      tr.r = animate(mixed ? [...own("rotation"), ...own("follow"), ...layers(id, "rotation")] : own("rotation"), (t) => [poseAt(entry, t).r], !mixed);
+      tr.s = animate(mixed ? [...own("scaleX"), ...own("scaleY"), ...layers(id, "scaleX"), ...layers(id, "scaleY")] : [...own("scaleX"), ...own("scaleY")], (t) => poseAt(entry, t).s, !mixed);
+      if (tr.p.a === 0) tr.p = { a: 0, k: poseAt(entry, 0).p.map(round2) };
+    }
+    const opacity = own("opacity");
+    const rest = entry.node.opacity ?? 1;
+    tr.o = opacity.length ? animate(opacity, (t) => [Math.min(1, Math.max(0, Number(trackValue(opacity, t) ?? rest))) * 100]) : { a: 0, k: round2(rest * 100) };
+    return tr;
+  };
+  const owner = (path, p) => {
+    const entry = nodes.get(path.id);
+    if (!entry) return void 0;
+    return [...entry.ancestors, path.id].find((id) => timeline.tracks.has(motionTrackKey(id, p)));
+  };
+  const paintOf = (paint, what, id) => {
+    if (paint === void 0 || paint === null || paint === "none") return null;
+    const c = rgba(paint);
+    if (!c) notes.push(`"${id}": its ${what} is a gradient, which is not exported; it is left unpainted.`);
+    return c;
+  };
+  const pathShapes = (path) => {
+    const items = [];
+    const shapeSegments = [...timeline.tracks.entries()].filter(([k]) => k.startsWith(`${path.id}\0`) && (k.endsWith("\0shape") || k.includes("\0effect:"))).flatMap(([, v]) => v);
+    const geometryAt = (t) => {
+      if (!shapeSegments.length) return vectorPathWorldBezier(path);
+      const now = indexMotionNodes(motionFrameAt(scene, t, { draw: false, offsets: false }).document.nodes).get(path.id)?.node;
+      return now && now.type === "path" ? vectorPathWorldBezier(expandVectorAppearances([now])[0]) : vectorPathWorldBezier(path);
+    };
+    const rest = lottieContours(toBezierPath(geometryAt(0)), round2);
+    rest.forEach((contour, n) => {
+      let ks = { a: 0, k: contour };
+      if (shapeSegments.length) {
+        const keys = [];
+        let fits = true;
+        const count = Math.max(1, Math.ceil(end * fps / 1e3));
+        for (let k = 0; k <= count && fits; k++) {
+          const t = end * k / count;
+          const c = lottieContours(toBezierPath(geometryAt(t)), round2)[n];
+          if (!c || c.v.length !== contour.v.length || c.c !== contour.c) fits = false;
+          else keys.push({ t: frame(t), s: [c], ...k < count ? { o: { x: [0], y: [0] }, i: { x: [1], y: [1] } } : {} });
+        }
+        if (fits) {
+          ks = { a: 1, k: keys };
+          sampled += keys.length;
+        } else notes.push(`"${path.id}": its morph changes how many points the outline has, which Lottie cannot tween; it shows its starting shape.`);
+      }
+      items.push({ ty: "sh", nm: `${path.id} ${n + 1}`, ks });
+    });
+    const fillFrom = owner(path, "fill");
+    const strokeFrom = owner(path, "stroke");
+    const widthFrom = owner(path, "strokeWidth");
+    const fadeFrom = owner(path, "fillOpacity");
+    const drawFrom = owner(path, "drawEnd");
+    if (drawFrom) {
+      const draw = track(drawFrom, "drawEnd");
+      items.push({ ty: "tm", nm: "Draw on", s: { a: 0, k: 0 }, e: animate(draw, (t) => [Math.min(1, Math.max(0, Number(trackValue(draw, t) ?? 1))) * 100]), o: { a: 0, k: 0 }, m: 1 });
+    }
+    if (owner(path, "drawStart")) notes.push(`"${path.id}": drawing from a start other than 0 is not exported.`);
+    const stroke = paintOf(path.stroke, "stroke", path.id);
+    if (stroke || strokeFrom) {
+      const colour = strokeFrom ? track(strokeFrom, "stroke") : [];
+      items.push({
+        ty: "st",
+        nm: "Stroke",
+        c: colour.length ? animate(colour, (t) => rgba(trackValue(colour, t)) ?? stroke ?? [0, 0, 0, 1]) : { a: 0, k: (stroke ?? [0, 0, 0, 1]).map(round2) },
+        o: { a: 0, k: 100 },
+        w: widthFrom ? animate(track(widthFrom, "strokeWidth"), (t) => [Math.max(0, Number(trackValue(track(widthFrom, "strokeWidth"), t) ?? path.strokeWidth ?? 1))]) : { a: 0, k: round2(path.strokeWidth ?? 1) },
+        lc: path.strokeLinecap === "round" ? 2 : path.strokeLinecap === "square" ? 3 : 1,
+        lj: path.strokeLinejoin === "round" ? 2 : path.strokeLinejoin === "bevel" ? 3 : 1,
+        ml: 4
+      });
+      if (path.strokeDasharray?.length) notes.push(`"${path.id}": its dashes are not exported; the stroke is solid.`);
+      if (path.strokeAlign && path.strokeAlign !== "center") notes.push(`"${path.id}": its stroke is drawn centred (Lottie has no inside or outside strokes).`);
+    }
+    const fill = paintOf(path.fill, "fill", path.id);
+    if (fill || fillFrom) {
+      const colour = fillFrom ? track(fillFrom, "fill") : [];
+      const fade = fadeFrom ? track(fadeFrom, "fillOpacity") : [];
+      items.push({
+        ty: "fl",
+        nm: "Fill",
+        c: colour.length ? animate(colour, (t) => rgba(trackValue(colour, t)) ?? fill ?? [0, 0, 0, 1]) : { a: 0, k: (fill ?? [0, 0, 0, 1]).map(round2) },
+        o: fade.length ? animate(fade, (t) => [Math.min(1, Math.max(0, Number(trackValue(fade, t) ?? 1))) * 100]) : { a: 0, k: 100 },
+        r: path.fillRule === "evenodd" ? 2 : 1
+      });
+    }
+    return items;
+  };
+  const nodeGroup = (node) => {
+    const entry = nodes.get(node.id);
+    if (timeline.tracks.has(motionTrackKey(node.id, "clipRect")) || timeline.tracks.has(motionTrackKey(node.id, "clipCircle")))
+      notes.push(`"${node.id}": its wipe, iris or split reveal is not exported (Lottie masks belong to layers); it fades with its opacity only.`);
+    let inner;
+    const innerTr = STATIC_TR();
+    if (node.type === "path") inner = [...pathShapes(node)];
+    else {
+      inner = [...node.children].reverse().map(nodeGroup);
+      const m = nodeMatrix(node);
+      if (m !== IDENTITY_MATRIX) {
+        const parts = staticParts(m);
+        if (!parts) notes.push(`"${node.id}": its transform skews, which is not exported; it is drawn without the skew.`);
+        else {
+          innerTr.p = { a: 0, k: parts.p.map(round2) };
+          innerTr.s = { a: 0, k: parts.s.map(round2) };
+          innerTr.r = { a: 0, k: round2(parts.r) };
+        }
+      }
+    }
+    const body = { ty: "gr", nm: `${node.id} (own)`, it: [...inner, innerTr] };
+    return { ty: "gr", nm: node.name ?? node.id, ...node.visible === false ? { hd: true } : {}, it: [body, poseTransform(entry)] };
+  };
+  const artwork = { ...scene.artwork, nodes: expandVectorAppearances(scene.artwork.nodes) };
+  const content = [...artwork.nodes].reverse().map(nodeGroup);
+  if (artwork.background && rgba(artwork.background))
+    content.push({ ty: "gr", nm: "Background", it: [{ ty: "rc", nm: "Background", p: { a: 0, k: [artwork.width / 2, artwork.height / 2] }, s: { a: 0, k: [artwork.width, artwork.height] }, r: { a: 0, k: 0 } }, { ty: "fl", c: { a: 0, k: rgba(artwork.background).map(round2) }, o: { a: 0, k: 100 }, r: 1 }, STATIC_TR()] });
+  const camera = track("", "camera");
+  const root = STATIC_TR();
+  if (camera.length) {
+    const box = (t) => trackValue(camera, t) ?? [0, 0, artwork.width, artwork.height];
+    root.a = animate(camera, (t) => box(t).slice(0, 2), false);
+    root.s = animate(camera, (t) => [artwork.width / box(t)[2] * 100, artwork.height / box(t)[3] * 100], false);
+  }
+  const op = Math.max(1, Math.ceil(end * fps / 1e3));
+  const lottie = {
+    v: "5.7.4",
+    fr: fps,
+    ip: 0,
+    op,
+    w: artwork.width,
+    h: artwork.height,
+    nm: scene.name,
+    ddd: 0,
+    assets: [],
+    layers: [
+      {
+        ddd: 0,
+        ind: 1,
+        ty: 4,
+        nm: scene.name,
+        sr: 1,
+        ks: { o: { a: 0, k: 100 }, r: { a: 0, k: 0 }, p: { a: 0, k: [0, 0, 0] }, a: { a: 0, k: [0, 0, 0] }, s: { a: 0, k: [100, 100, 100] } },
+        ao: 0,
+        shapes: [{ ty: "gr", nm: "Camera", it: [...content, root] }],
+        ip: 0,
+        op,
+        st: 0,
+        bm: 0
+      }
+    ],
+    markers: timeline.shots.map((s) => ({ tm: frame(s.start), cm: s.label ?? s.id, dr: frame(s.end - s.start) }))
+  };
+  return { lottie, sampled, notes: [...new Set(notes)] };
+}
+
 // src/animation-editor/controller.ts
 var BLANK = { width: 800, height: 450, background: "#ffffff", nodes: [] };
 var AnimationEditorController = class {
@@ -2827,6 +3133,14 @@ function createAnimationEditorToolProvider(controller, options = {}) {
     annotations: { title: "Export as Flair vector motion", ...READ },
     handler: ({ fps, curves, behaviors, flair }) => controller.toFlairMotion({ ...fps ? { fps } : {}, ...curves === void 0 ? {} : { curves }, ...behaviors === void 0 ? {} : { behaviors }, ...flair ? { flair } : {} })
   };
+  const exportLottie = {
+    name: "export_lottie",
+    title: "Export as Lottie",
+    description: "Returns the animation as Lottie (Bodymovin JSON, v5) for lottie-web and the mobile Lottie players: one shape layer whose groups mirror the artwork, a marker per shot, eased changes as keyframes with bezier easing and the rest sampled. Also returns how many keyframes were sampled and notes on anything not carried over (gradients, dashes, reveal clips, morphs that change point counts).",
+    inputSchema: object({ fps: { type: "number", minimum: 1, maximum: 120, description: "Frame rate (default: the scene's fps, else 30)." } }),
+    annotations: { title: "Export as Lottie", ...READ },
+    handler: ({ fps }) => toLottie(scene(), fps ? { fps } : {})
+  };
   const exportFlairEffect = {
     name: "export_flair_effect",
     title: "Export as a Flair effect",
@@ -3069,7 +3383,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       return { redone, ...redone ? { label } : {} };
     }
   };
-  const reads = [getAnimation, getShot, findElements, getTimingGrid, checkAnimation, renderFrame, exportFlairMotion, exportFlairEffect, seekAnimation];
+  const reads = [getAnimation, getShot, findElements, getTimingGrid, checkAnimation, renderFrame, exportFlairMotion, exportFlairEffect, exportLottie, seekAnimation];
   const writes = [setArtworkSvg, fitAnimation, importFlairEffect, insertShots, updateShot, deleteShots, moveShot, addCommands, updateCommand, deleteCommands, setSettings, setControls, editAnimation, writeAnimation, undo, redo];
   return {
     id: options.id ?? "animation",
@@ -3207,6 +3521,7 @@ export {
   toFlairEffectDocument,
   toFlairSvgMotion,
   toFlairVectorEffect,
+  toLottie,
   trackValue,
   withMotionLayers,
   withViewBox