@pixerate/editor 0.65.0 → 0.66.1

package/dist/animation-editor/index.js

@@ -45,6 +45,7 @@ import {
   rgbaToHex
 } from "../chunk-TGD52FEZ.js";
 import {
+  ANIMATION_EASING_LABELS,
   ANIMATION_EASING_PRESETS,
   evaluateEasing,
   isAnimationEasing,
@@ -1563,6 +1564,7 @@ var MOTION_EDIT_OPS = [
   "add_commands",
   "update_command",
   "delete_commands",
+  "move_command",
   "set_artwork",
   "set_controls",
   "replace_scene"
@@ -1687,6 +1689,16 @@ function applyOne(scene, edit) {
       const drop = new Set(edit.commands);
       return replaceShot(scene, i, { ...scene.shots[i], run: run.filter((_, k) => !drop.has(k)) });
     }
+    case "move_command": {
+      const i = shotIndex(scene, edit.shot);
+      const run = [...scene.shots[i].run];
+      if (!Number.isInteger(edit.command) || edit.command < 0 || edit.command >= run.length)
+        fail(`Shot "${edit.shot}" has ${run.length} command${run.length === 1 ? "" : "s"}; "command" must be an index from 0 to ${run.length - 1} (got ${edit.command}).`);
+      const to = position(edit.to, run.length - 1, '"to"');
+      const [moved] = run.splice(edit.command, 1);
+      run.splice(to, 0, moved);
+      return replaceShot(scene, i, { ...scene.shots[i], run });
+    }
     case "set_artwork":
       return { ...scene, artwork: edit.artwork };
     case "set_controls": {
@@ -2255,11 +2267,17 @@ function fromFlairSvgMotion(input, options = {}) {
 ${problems.join("\n")}`);
   return { scene, notes: [...new Set(notes)], issues: checkMotionScene(scene) };
 }
+function presetColor(value) {
+  if (typeof value === "string") return /^#[0-9a-f]{6}$/i.test(value) ? value.toLowerCase() : value;
+  if (Array.isArray(value) && value.length >= 3 && value.slice(0, 3).every((n) => typeof n === "number" && Number.isFinite(n)))
+    return `#${value.slice(0, 3).map((n) => Math.round(Math.min(1, Math.max(0, n)) * 255).toString(16).padStart(2, "0")).join("")}`;
+  return void 0;
+}
 function fromFlairVectorEffect(effect, options = {}) {
   if (!effect || effect.kind !== "vector" || !effect.motion) throw new Error('Give a Flair vector effect: { kind: "vector", id, name, motion: { svg, animate } }.');
   const result = fromFlairSvgMotion(effect.motion, { name: options.name ?? effect.id ?? effect.name, hold: options.hold ?? effect.hold });
   const names = new Set((result.scene.controls ?? []).map((c) => c.name));
-  const presets = (effect.presets ?? []).map((p) => ({ name: p.name, values: Object.fromEntries(Object.entries(p.values).filter(([k]) => names.has(k))) })).filter((p) => Object.keys(p.values).length);
+  const presets = (effect.presets ?? []).map((p) => ({ name: p.name, values: Object.fromEntries(Object.entries(p.values).flatMap(([k, v]) => names.has(k) && presetColor(v) ? [[k, presetColor(v)]] : [])) })).filter((p) => Object.keys(p.values).length);
   const scene = { ...result.scene, ...effect.description ? { description: effect.description } : {}, ...presets.length ? { presets } : {} };
   const notes = [...result.notes];
   if (effect.trigger) notes.push(`The effect plays on ${effect.trigger}; scenes play through, so the trigger is not kept (pass it back to toFlairVectorEffect).`);
@@ -2505,6 +2523,7 @@ function toLottie(scene, options = {}) {
     }
     return items;
   };
+  const shown = (list) => list.filter((n) => n.visible !== false);
   const nodeGroup = (node) => {
     const entry = nodes.get(node.id);
     if (timeline.tracks.has(motionTrackKey(node.id, "clipRect")) || timeline.tracks.has(motionTrackKey(node.id, "clipCircle")))
@@ -2513,7 +2532,7 @@ function toLottie(scene, options = {}) {
     const innerTr = STATIC_TR();
     if (node.type === "path") inner = [...pathShapes(node)];
     else {
-      inner = [...node.children].reverse().map(nodeGroup);
+      inner = shown(node.children).reverse().map(nodeGroup);
       const m = nodeMatrix(node);
       if (m !== IDENTITY_MATRIX) {
         const parts = staticParts(m);
@@ -2526,10 +2545,10 @@ function toLottie(scene, options = {}) {
       }
     }
     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)] };
+    return { ty: "gr", nm: node.name ?? node.id, it: [body, poseTransform(entry)] };
   };
   const artwork = { ...scene.artwork, nodes: expandVectorAppearances(scene.artwork.nodes) };
-  const content = [...artwork.nodes].reverse().map(nodeGroup);
+  const content = shown(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");
@@ -2996,6 +3015,7 @@ var EDIT_OP = {
     object({ op: { const: "move_shot", description: "Like move_shot." }, shot: SHOT_ID, to: { type: "integer", minimum: 0, description: "New position (0 = first)." } }, ["op", "shot", "to"]),
     object({ op: { const: "add_commands", description: "Like add_commands." }, shot: SHOT_ID, commands: { type: "array", items: MOTION_COMMAND_SCHEMA, minItems: 1, description: "Commands to add." }, at: { type: "integer", minimum: 0, description: "Index in the shot's run (default: the end)." } }, ["op", "shot", "commands"]),
     object({ op: { const: "update_command", description: "Like update_command." }, shot: SHOT_ID, command: { type: "integer", minimum: 0, description: "Index in the shot's run." }, set: { type: "object", description: "Command fields to replace." }, remove: { type: "array", items: { type: "string" }, description: "Command fields to clear." } }, ["op", "shot", "command"]),
+    object({ op: { const: "move_command", description: "Like move_command." }, shot: SHOT_ID, command: { type: "integer", minimum: 0, description: "Index in the shot's run." }, to: { type: "integer", minimum: 0, description: "New index in the run (0 = first)." } }, ["op", "shot", "command", "to"]),
     object({ op: { const: "delete_commands", description: "Like delete_commands." }, shot: SHOT_ID, commands: { type: "array", items: { type: "integer", minimum: 0 }, minItems: 1, description: "Indexes in the shot's run." } }, ["op", "shot", "commands"]),
     object({ op: { const: "set_controls", description: "Like set_controls." }, controls: { type: "array", items: CONTROL, description: "Controls (empty clears)." }, presets: { type: "array", items: PRESET, description: "Presets (empty clears)." } }, ["op", "controls"])
   ]
@@ -3416,6 +3436,21 @@ function createAnimationEditorToolProvider(controller, options = {}) {
     annotations: { title: "Delete commands", ...DESTRUCTIVE },
     handler: ({ shot, commands }) => apply({ op: "delete_commands", shot, commands }, "Delete commands")
   };
+  const moveCommand = {
+    name: "move_command",
+    title: "Reorder a command",
+    description: `Moves one command to a new index in its shot's run (0 = first), as one undo step; the others close up around it. A command with "with": "previous" then starts with its new neighbour. Returns the command's new index, its old one and the shot's timing.`,
+    inputSchema: object(
+      {
+        shot: SHOT_ID,
+        command: { type: "integer", minimum: 0, description: "Index of the command in the shot's run (from get_animation)." },
+        to: { type: "integer", minimum: 0, description: "Its new index, 0 = first (at most the last index)." }
+      },
+      ["shot", "command", "to"]
+    ),
+    annotations: { title: "Reorder a command", ...WRITE },
+    handler: ({ shot, command: command2, to }) => apply({ op: "move_command", shot, command: command2, to }, "Move command", (s) => ({ shot, command: to, from: command2, commands: describeMotionShots(s).find((x) => x.id === shot).commands.map((c) => ({ index: c.index, type: c.type, start: c.start, end: c.end })) }))
+  };
   const setSettings = {
     name: "set_animation_settings",
     title: "Change animation settings",
@@ -3498,7 +3533,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
     }
   };
   const reads = [getAnimation, getShot, findElements, getMotionPath, 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];
+  const writes = [setArtworkSvg, fitAnimation, importFlairEffect, insertShots, updateShot, deleteShots, moveShot, addCommands, updateCommand, deleteCommands, moveCommand, setSettings, setControls, editAnimation, writeAnimation, undo, redo];
   return {
     id: options.id ?? "animation",
     namespace: options.namespace,
@@ -3543,11 +3578,285 @@ Commands
 
 Working method
 1. 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).
-2. 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).
+2. 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).
 3. 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.
 4. To make a reusable Flair effect, set_animation_controls (colour controls stand for every use of their default colour) and export_flair_effect.
 
 Keep 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.`;
+
+// src/animation-editor/form.ts
+var TIMING = /* @__PURE__ */ new Set(["duration", "delay", "stagger", "with", "ease", "repeat", "repeatMode", "steps", "note"]);
+var COLORS = /* @__PURE__ */ new Set(["fill", "stroke", "color"]);
+var NODES = /* @__PURE__ */ new Set(["into", "path"]);
+function branch(type) {
+  return (MOTION_COMMAND_SCHEMA.oneOf ?? []).find((b) => b.properties?.type?.const === type);
+}
+function unitOf(type, name) {
+  if (name === "duration" || name === "delay" || name === "stagger") return "ms";
+  if (name === "steps") return "fps";
+  if (name === "frequency") return "Hz";
+  if (name === "repeat" || name === "count") return "\xD7";
+  if (name === "distance" || name === "strokeWidth") return "units";
+  if (name === "angle") return "\xB0";
+  if (name === "amount") return type === "pulse" ? "\xD7" : "units";
+  if (name === "rotate" && type === "wiggle") return "\xB0";
+  if ((name === "by" || name === "to") && type === "rotate") return "\xB0";
+  if (name === "scale" || name === "to" && type === "scale") return "\xD7";
+  if ((name === "from" || name === "to") && (type === "draw" || type === "fade" || type === "follow")) return "0\u20131";
+  return void 0;
+}
+function motionFieldLabel(name) {
+  const words = name.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase();
+  return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function kindOf(name, schema) {
+  if (name === "targets") return "targets";
+  if (name === "ease") return "ease";
+  if (schema.enum) return "enum";
+  if (schema.anyOf) return "scale";
+  if (schema.type === "object") return "point";
+  if (schema.type === "boolean") return "boolean";
+  if (schema.type === "integer") return "integer";
+  if (schema.type === "number") return "number";
+  if (COLORS.has(name)) return "color";
+  if (NODES.has(name)) return "node";
+  return "text";
+}
+function motionCommandFields(type) {
+  const schema = branch(type);
+  if (!schema?.properties) return [];
+  const required = new Set(schema.required ?? []);
+  const fields = Object.entries(schema.properties).filter(([name]) => name !== "type").map(([name, s]) => {
+    const kind = kindOf(name, s);
+    const min = typeof s.minimum === "number" ? s.minimum : typeof s.exclusiveMinimum === "number" ? s.exclusiveMinimum : void 0;
+    return {
+      name,
+      kind,
+      label: motionFieldLabel(name),
+      description: s.description ?? "",
+      required: required.has(name),
+      ...s.enum ? { options: s.enum.map(String) } : {},
+      ...min !== void 0 ? { min } : {},
+      ...typeof s.maximum === "number" ? { max: s.maximum } : {},
+      ...unitOf(type, name) ? { unit: unitOf(type, name) } : {},
+      group: TIMING.has(name) ? "timing" : "main"
+    };
+  });
+  return [...fields.filter((f) => f.group === "main"), ...fields.filter((f) => f.group === "timing")];
+}
+function parseMotionFieldInput(field, raw) {
+  if (field.kind === "boolean") return raw === true ? { set: true } : { remove: true };
+  if (field.kind === "targets") {
+    const ids = (Array.isArray(raw) ? raw : String(raw).split(",")).map((s) => String(s).trim()).filter(Boolean);
+    return ids.length ? { set: ids } : { error: "Pick at least one target." };
+  }
+  if (field.kind === "point" || field.kind === "scale" && typeof raw === "object" && !Array.isArray(raw)) {
+    const p = raw;
+    if (p.x.trim() === "" && p.y.trim() === "") return field.required ? { error: `${field.label} is required.` } : { remove: true };
+    const x = Number(p.x);
+    const y = Number(p.y);
+    if (!Number.isFinite(x) || !Number.isFinite(y)) return { error: `${field.label} needs a number for x and for y.` };
+    return { set: { x, y } };
+  }
+  const text = String(raw).trim();
+  if (text === "") return field.required ? { error: `${field.label} is required.` } : { remove: true };
+  if (field.kind === "number" || field.kind === "integer" || field.kind === "scale") {
+    const n = Number(text);
+    if (!Number.isFinite(n)) return { error: `${field.label} must be a number${field.unit ? ` (${field.unit})` : ""}.` };
+    if (field.kind === "integer" && !Number.isInteger(n)) return { error: `${field.label} must be a whole number.` };
+    if (field.min !== void 0 && n < field.min) return { error: `${field.label} must be at least ${field.min}.` };
+    if (field.max !== void 0 && n > field.max) return { error: `${field.label} must be at most ${field.max}.` };
+    return { set: n };
+  }
+  if (field.kind === "enum" && field.options && !field.options.includes(text)) return { error: `${field.label} must be one of ${field.options.join(", ")}.` };
+  return { set: text };
+}
+function motionFieldEdit(shot, command2, field, raw) {
+  const input = parseMotionFieldInput(field, raw);
+  if ("error" in input) return input;
+  if ("remove" in input) return { op: "update_command", shot, command: command2, remove: [field.name] };
+  return { op: "update_command", shot, command: command2, set: { [field.name]: input.set } };
+}
+function defaultMotionCommand(type, targets, scene) {
+  if (type === "wait") return { type: "wait", duration: 500 };
+  if (!targets.length) return { error: "Pick a target first: click an element on the stage." };
+  const nodes = [...indexMotionNodes(scene.artwork.nodes).values()];
+  const other = (pred) => nodes.find((e) => !targets.includes(e.node.id) && pred(e))?.node.id;
+  const base = { targets: [...targets] };
+  switch (type) {
+    case "scale":
+      return { type, ...base, to: 1.2 };
+    case "fade":
+      return { type, ...base, to: 0.5 };
+    case "move":
+      return { type, ...base, by: { x: 40, y: 0 } };
+    case "rotate":
+      return { type, ...base, by: 90 };
+    case "style":
+      return { type, ...base, fill: "#f59e0b" };
+    case "morph": {
+      const into = other((e) => e.node.type === "path" && e.node.visible === false) ?? other((e) => e.node.type === "path");
+      return into ? { type, ...base, into } : { error: "Morph needs another shape to become; draw one (it can stay hidden)." };
+    }
+    case "match": {
+      const into = other((e) => e.node.type === "group" && e.node.visible === false) ?? other((e) => e.node.type === "group");
+      return into ? { type, ...base, into } : { error: "Match needs another group to become; group the end state (it can stay hidden)." };
+    }
+    case "follow": {
+      const path = other((e) => e.node.type === "path" && e.node.visible === false) ?? other((e) => e.node.type === "path");
+      return path ? { type, ...base, path } : { error: "Follow needs a path to travel along; draw one (it can stay hidden)." };
+    }
+    case "effect": {
+      for (const id of targets) {
+        const node = nodes.find((e) => e.node.id === id)?.node;
+        for (const effect of node?.effects ?? []) {
+          const param = Object.entries(effect.params).find(([, v]) => typeof v === "number");
+          if (param) return { type, ...base, effect: effect.id, param: param[0], to: param[1] + 1 };
+        }
+      }
+      return { error: "Effect needs a target with a live path effect (wiggle, twist, zig zag\u2026)." };
+    }
+    default:
+      return { type, ...base };
+  }
+}
+function motionCommandSummary(command2) {
+  const c = command2;
+  const what = [command2.type, typeof c.style === "string" ? c.style : ""].filter(Boolean).join(" ");
+  if (command2.type === "wait") return `wait ${command2.duration} ms`;
+  const extra = typeof c.into === "string" ? ` \u2192 ${c.into}` : typeof c.path === "string" ? ` along ${c.path}` : "";
+  return `${what} \xB7 ${(command2.targets ?? []).join(", ")}${extra}`;
+}
+function motionCommandRows(scene, shotId) {
+  const index = scene.shots.findIndex((s) => s.id === shotId);
+  if (index < 0) return [];
+  const timeline = compileMotionScene(scene);
+  return scene.shots[index].run.map((command2, i) => {
+    const t = timeline.commands.find((c) => c.shotIndex === index && c.command === i);
+    const primitive = motionFlairPrimitive(command2);
+    return { index: i, command: command2, summary: motionCommandSummary(command2), start: t?.start ?? 0, end: t?.end ?? 0, ...primitive ? { flairPrimitive: primitive } : {} };
+  });
+}
+function duplicateMotionCommandEdit(scene, shot, command2) {
+  const run = scene.shots.find((s) => s.id === shot)?.run ?? [];
+  return { op: "add_commands", shot, commands: run[command2] ? [structuredClone(run[command2])] : [], at: command2 + 1 };
+}
+var MOTION_EASE_CHOICES = [
+  { value: "", label: "Default" },
+  ...ANIMATION_EASING_PRESETS.map((p) => ({ value: p, label: ANIMATION_EASING_LABELS[p] }))
+];
+function motionEaseKey(ease) {
+  if (ease === void 0 || ease === null) return "";
+  return typeof ease === "string" ? ease : "custom";
+}
+function motionEasingCurve(ease, samples = 48, durationMs = 1e3) {
+  const resolved = resolveEasing(ease);
+  const ms = resolved !== "hold" && resolved.type === "spring" ? springSettleMs(resolved) : durationMs;
+  const n = Math.max(2, Math.floor(samples));
+  const points = [];
+  for (let i = 0; i <= n; i++) {
+    const u = i / n;
+    points.push({ u, v: resolved === "hold" ? i === n ? 1 : 0 : evaluateEasing(ease, u, ms) });
+  }
+  const values = points.map((p) => p.v);
+  return { points, min: Math.min(0, ...values), max: Math.max(1, ...values), durationMs: ms };
+}
+function motionEasingPath(curve, width, height, pad = 4) {
+  const span = curve.max - curve.min || 1;
+  const f = (n) => String(Math.round(n * 100) / 100);
+  return curve.points.map((p, i) => `${i ? "L" : "M"}${f(pad + p.u * (width - 2 * pad))} ${f(pad + (1 - (p.v - curve.min) / span) * (height - 2 * pad))}`).join(" ");
+}
+function motionEasingGuides(curve, height, pad = 4) {
+  const span = curve.max - curve.min || 1;
+  const y = (v) => pad + (1 - (v - curve.min) / span) * (height - 2 * pad);
+  return { zero: y(0), one: y(1) };
+}
+function motionNodeAtElement(scene, target, root) {
+  const ids = indexMotionNodes(scene.artwork.nodes);
+  for (let el = target; el && el !== root; el = el.parentElement) {
+    const id = el.getAttribute("id");
+    if (id && ids.has(id)) return id;
+  }
+  return null;
+}
+var escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function highlightMotionSvg(svg, ids, color = "#f43f5e") {
+  if (!ids.length) return svg;
+  let out = svg;
+  for (const id of ids) {
+    const escaped = id.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+    out = out.replace(new RegExp(` id="${escapeRegExp(escaped)}"`), ` id="${escaped}" data-picked=""`);
+  }
+  return out.replace(/(<svg\b[^>]*>)/, `$1<style>[data-picked]{filter:drop-shadow(0 0 1px #fff) drop-shadow(0 0 3px ${color}) drop-shadow(0 0 3px ${color})}</style>`);
+}
+function motionRulerTicks(duration, width, minGap = 56) {
+  const span = Math.max(1, duration);
+  const steps = [100, 250, 500, 1e3, 2e3, 5e3, 1e4, 3e4, 6e4];
+  const step = steps.find((s) => s / span * Math.max(1, width) >= minGap) ?? steps[steps.length - 1];
+  const ticks = [];
+  for (let t = 0; t <= span + 1e-6; t += step / 2) {
+    const major = Math.round(t / (step / 2)) % 2 === 0;
+    ticks.push({ time: t, major, label: major ? `${step < 1e3 ? (t / 1e3).toFixed(step < 500 ? 2 : 1) : String(Math.round(t / 1e3))}s` : "" });
+  }
+  return ticks;
+}
+function fitMotionSceneEdits(scene, ms, options = {}) {
+  const fit = fitMotionScene(scene, ms, options);
+  return fit.scene.shots.flatMap((shot, i) => {
+    const before = scene.shots[i].speed;
+    if (before === shot.speed) return [];
+    return shot.speed === void 0 ? [{ op: "update_shot", shot: shot.id, remove: ["speed"] }] : [{ op: "update_shot", shot: shot.id, set: { speed: shot.speed } }];
+  });
+}
+function motionCueKey(cue) {
+  if (!cue) return "";
+  if (typeof cue.beat === "number") return `beat:${cue.beat}`;
+  if (typeof cue.word === "number") return `word:${cue.word}`;
+  if (typeof cue.ms === "number") return `ms:${cue.ms}`;
+  return "";
+}
+function motionCueFromKey(key) {
+  const m = /^(beat|word|ms):(-?\d+(?:\.\d+)?)$/.exec(key);
+  if (!m) return void 0;
+  return { [m[1]]: Number(m[2]) };
+}
+function motionCueChoices(scene, limit = 256) {
+  const choices = [];
+  const s = (ms) => `${(ms / 1e3).toFixed(2)} s`;
+  const end = Math.max(compileMotionScene(scene).duration, ...scene.narration?.words.map((w) => w.end ?? w.start) ?? [0]) + 2e3;
+  if (scene.beat && scene.beat.bpm > 0) {
+    for (let beat = 0; choices.length < limit; beat++) {
+      const time = motionBeatTime(scene.beat, beat);
+      if (time > end) break;
+      if (time < 0) continue;
+      const at = motionBeatAt(scene.beat, time);
+      choices.push({ value: `beat:${beat}`, label: `Beat ${beat} (bar ${at.bar}.${at.beatInBar}) \xB7 ${s(time)}`, time });
+    }
+  }
+  scene.narration?.words.forEach((w, i) => {
+    if (choices.length < limit * 2) choices.push({ value: `word:${i}`, label: `Word ${i} \u201C${w.text}\u201D \xB7 ${s(w.start)}`, time: w.start });
+  });
+  return choices;
+}
+function motionShotCueTime(scene, cue) {
+  return cue ? motionCueTime(scene, cue) : void 0;
+}
+function formatMotionNarration(narration) {
+  return (narration?.words ?? []).map((w) => `${w.start} ${w.text}`).join("\n");
+}
+function parseMotionNarration(text) {
+  const lines = text.split("\n").map((l) => l.trim()).filter(Boolean);
+  if (!lines.length) return { narration: null };
+  const words = [];
+  for (const [i, line] of lines.entries()) {
+    const m = /^(\d+(?:\.\d+)?)\s+(.+)$/.exec(line);
+    if (!m) return { error: `Line ${i + 1} ("${line}") should be a start time in ms and a word, e.g. "1200 hello".` };
+    const start = Number(m[1]);
+    if (words.length && start < words[words.length - 1].start) return { error: `Line ${i + 1} starts before the word above it; keep the words in time order.` };
+    words.push({ text: m[2], start });
+  }
+  return { narration: { words } };
+}
 export {
   ANIMATION_EDITOR_AGENT_INSTRUCTIONS,
   AnimationEditorController,
@@ -3564,6 +3873,7 @@ export {
   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,
@@ -3584,16 +3894,21 @@ export {
   compileMotionScene,
   createAnimationEditorToolProvider,
   createMotionScene,
+  defaultMotionCommand,
   describeMotionElements,
   describeMotionShots,
+  duplicateMotionCommandEdit,
   fitMotionRect,
   fitMotionScene,
+  fitMotionSceneEdits,
   flairAtLeast,
   flairCurveFor,
   flairEaseFor,
+  formatMotionNarration,
   freshShotId,
   fromFlairSvgMotion,
   fromFlairVectorEffect,
+  highlightMotionSvg,
   indexMotionNodes,
   interpolateMotionValue,
   isMotionCommand,
@@ -3604,9 +3919,21 @@ export {
   motionBeatTime,
   motionClipAttrs,
   motionCommandDuration,
+  motionCommandFields,
   motionCommandRepeat,
+  motionCommandRows,
+  motionCommandSummary,
+  motionCueChoices,
+  motionCueFromKey,
+  motionCueKey,
   motionCueTime,
   motionCycleDuration,
+  motionEaseKey,
+  motionEasingCurve,
+  motionEasingGuides,
+  motionEasingPath,
+  motionFieldEdit,
+  motionFieldLabel,
   motionFlairPrimitive,
   motionFollowRoute,
   motionFrameAt,
@@ -3616,6 +3943,7 @@ export {
   motionIssueKey,
   motionIssueLine,
   motionMovingIds,
+  motionNodeAtElement,
   motionNodeClips,
   motionNodeOffset,
   motionPath,
@@ -3624,13 +3952,17 @@ export {
   motionRestValue,
   motionRevealClip,
   motionRevealPadding,
+  motionRulerTicks,
   motionSceneShapeProblems,
   motionSceneToJson,
   motionShotAt,
+  motionShotCueTime,
   motionShotTimeScale,
   motionStageSvg,
   motionTrackKey,
   namedWithSuggestion,
+  parseMotionFieldInput,
+  parseMotionNarration,
   parseMotionScene,
   resolveMotionCamera,
   segmentProgress,