@pixerate/editor 0.65.0 → 0.66.0

package/dist/animation-editor/index.cjs

@@ -51,6 +51,7 @@ var _chunkA6PHCAGXcjs = require('../chunk-A6PHCAGX.cjs');
 
 
 
+
 var _chunk2FHLHZALcjs = require('../chunk-2FHLHZAL.cjs');
 
 // src/animation-editor/types.ts
@@ -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: _nullishCoalesce(_nullishCoalesce(options.name, () => ( effect.id)), () => ( effect.name)), hold: _nullishCoalesce(options.hold, () => ( effect.hold)) });
   const names = new Set((_nullishCoalesce(result.scene.controls, () => ( []))).map((c) => c.name));
-  const presets = (_nullishCoalesce(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 = (_nullishCoalesce(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).`);
@@ -2996,6 +3014,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 +3435,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 +3532,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: _nullishCoalesce(options.id, () => ( "animation")),
     namespace: options.namespace,
@@ -3543,12 +3577,309 @@ 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 (_nullishCoalesce(MOTION_COMMAND_SCHEMA.oneOf, () => ( []))).find((b) => _optionalChain([b, 'access', _89 => _89.properties, 'optionalAccess', _90 => _90.type, 'optionalAccess', _91 => _91.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 (!_optionalChain([schema, 'optionalAccess', _92 => _92.properties])) return [];
+  const required = new Set(_nullishCoalesce(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: _nullishCoalesce(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) => _optionalChain([nodes, 'access', _93 => _93.find, 'call', _94 => _94((e) => !targets.includes(e.node.id) && pred(e)), 'optionalAccess', _95 => _95.node, 'access', _96 => _96.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 = _nullishCoalesce(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 = _nullishCoalesce(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 = _nullishCoalesce(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 = _optionalChain([nodes, 'access', _97 => _97.find, 'call', _98 => _98((e) => e.node.id === id), 'optionalAccess', _99 => _99.node]);
+        for (const effect of _nullishCoalesce(_optionalChain([node, 'optionalAccess', _100 => _100.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 ${(_nullishCoalesce(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: _nullishCoalesce(_optionalChain([t, 'optionalAccess', _101 => _101.start]), () => ( 0)), end: _nullishCoalesce(_optionalChain([t, 'optionalAccess', _102 => _102.end]), () => ( 0)), ...primitive ? { flairPrimitive: primitive } : {} };
+  });
+}
+function duplicateMotionCommandEdit(scene, shot, command2) {
+  const run = _nullishCoalesce(_optionalChain([scene, 'access', _103 => _103.shots, 'access', _104 => _104.find, 'call', _105 => _105((s) => s.id === shot), 'optionalAccess', _106 => _106.run]), () => ( []));
+  return { op: "add_commands", shot, commands: run[command2] ? [structuredClone(run[command2])] : [], at: command2 + 1 };
+}
+var MOTION_EASE_CHOICES = [
+  { value: "", label: "Default" },
+  ..._chunk2FHLHZALcjs.ANIMATION_EASING_PRESETS.map((p) => ({ value: p, label: _chunk2FHLHZALcjs.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 = _chunk2FHLHZALcjs.resolveEasing.call(void 0, ease);
+  const ms = resolved !== "hold" && resolved.type === "spring" ? _chunk2FHLHZALcjs.springSettleMs.call(void 0, 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 : _chunk2FHLHZALcjs.evaluateEasing.call(void 0, 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 = _nullishCoalesce(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, ..._nullishCoalesce(_optionalChain([scene, 'access', _107 => _107.narration, 'optionalAccess', _108 => _108.words, 'access', _109 => _109.map, 'call', _110 => _110((w) => _nullishCoalesce(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 });
+    }
+  }
+  _optionalChain([scene, 'access', _111 => _111.narration, 'optionalAccess', _112 => _112.words, 'access', _113 => _113.forEach, 'call', _114 => _114((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 (_nullishCoalesce(_optionalChain([narration, 'optionalAccess', _115 => _115.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 } };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 
 
@@ -3644,5 +3975,5 @@ Keep motion purposeful: one thing moving at a time reads best, ease-out for arri
 
 
 
-exports.ANIMATION_EDITOR_AGENT_INSTRUCTIONS = ANIMATION_EDITOR_AGENT_INSTRUCTIONS; exports.AnimationEditorController = AnimationEditorController; exports.FLAIR_EASES = FLAIR_EASES; exports.FLAIR_EXPORT_VERSION = FLAIR_EXPORT_VERSION; exports.MOTION_ADDITIVE_PROPERTIES = MOTION_ADDITIVE_PROPERTIES; exports.MOTION_BLENDS = MOTION_BLENDS; exports.MOTION_CAMERA_MS = MOTION_CAMERA_MS; exports.MOTION_COMMAND_SCHEMA = MOTION_COMMAND_SCHEMA; exports.MOTION_COMMAND_TYPES = MOTION_COMMAND_TYPES; exports.MOTION_DEFAULT_DURATIONS = MOTION_DEFAULT_DURATIONS; exports.MOTION_DEFAULT_HOLD = MOTION_DEFAULT_HOLD; exports.MOTION_DIRECTIONS = MOTION_DIRECTIONS; exports.MOTION_DRAW_EFFECT_ID = MOTION_DRAW_EFFECT_ID; exports.MOTION_DRAW_MS_PER_UNIT = MOTION_DRAW_MS_PER_UNIT; exports.MOTION_DRAW_RANGE = MOTION_DRAW_RANGE; exports.MOTION_EASE_IN_OUT = MOTION_EASE_IN_OUT; exports.MOTION_EASE_OUT = MOTION_EASE_OUT; exports.MOTION_EDIT_OPS = MOTION_EDIT_OPS; exports.MOTION_ENTER_STYLES = MOTION_ENTER_STYLES; exports.MOTION_EXIT_STYLES = MOTION_EXIT_STYLES; exports.MOTION_IRIS_SHAPES = MOTION_IRIS_SHAPES; exports.MOTION_ISSUE_CODES = MOTION_ISSUE_CODES; exports.MOTION_MIN_CHANGE_MS = MOTION_MIN_CHANGE_MS; exports.MOTION_REPEAT_MODES = MOTION_REPEAT_MODES; exports.MOTION_SPEED_RANGE = MOTION_SPEED_RANGE; exports.MOTION_SPLIT_ORIENTATIONS = MOTION_SPLIT_ORIENTATIONS; exports.MotionSceneFormatError = MotionSceneFormatError; exports.activeSegment = activeSegment; exports.applyMotionControlValues = applyMotionControlValues; exports.applyMotionEdits = applyMotionEdits; exports.checkMotionScene = checkMotionScene; exports.commandShapeProblems = commandShapeProblems; exports.compileMotionScene = compileMotionScene; exports.createAnimationEditorToolProvider = createAnimationEditorToolProvider; exports.createMotionScene = createMotionScene; exports.describeMotionElements = describeMotionElements; exports.describeMotionShots = describeMotionShots; exports.fitMotionRect = fitMotionRect; exports.fitMotionScene = fitMotionScene; exports.flairAtLeast = flairAtLeast; exports.flairCurveFor = flairCurveFor; exports.flairEaseFor = flairEaseFor; exports.freshShotId = freshShotId; exports.fromFlairSvgMotion = fromFlairSvgMotion; exports.fromFlairVectorEffect = fromFlairVectorEffect; exports.indexMotionNodes = indexMotionNodes; exports.interpolateMotionValue = interpolateMotionValue; exports.isMotionCommand = isMotionCommand; exports.isMotionShot = isMotionShot; exports.matchMotionNodes = matchMotionNodes; exports.motionAddTrackKey = motionAddTrackKey; exports.motionBeatAt = motionBeatAt; exports.motionBeatTime = motionBeatTime; exports.motionClipAttrs = motionClipAttrs; exports.motionCommandDuration = motionCommandDuration; exports.motionCommandRepeat = motionCommandRepeat; exports.motionCueTime = motionCueTime; exports.motionCycleDuration = motionCycleDuration; exports.motionFlairPrimitive = motionFlairPrimitive; exports.motionFollowRoute = motionFollowRoute; exports.motionFrameAt = motionFrameAt; exports.motionFrameToSvg = motionFrameToSvg; exports.motionGhosts = motionGhosts; exports.motionIssue = motionIssue; exports.motionIssueKey = motionIssueKey; exports.motionIssueLine = motionIssueLine; exports.motionMovingIds = motionMovingIds; exports.motionNodeClips = motionNodeClips; exports.motionNodeOffset = motionNodeOffset; exports.motionPath = motionPath; exports.motionPathLength = motionPathLength; exports.motionPathsSvg = motionPathsSvg; exports.motionRestValue = motionRestValue; exports.motionRevealClip = motionRevealClip; exports.motionRevealPadding = motionRevealPadding; exports.motionSceneShapeProblems = motionSceneShapeProblems; exports.motionSceneToJson = motionSceneToJson; exports.motionShotAt = motionShotAt; exports.motionShotTimeScale = motionShotTimeScale; exports.motionStageSvg = motionStageSvg; exports.motionTrackKey = motionTrackKey; exports.namedWithSuggestion = namedWithSuggestion; exports.parseMotionScene = parseMotionScene; exports.resolveMotionCamera = resolveMotionCamera; exports.segmentProgress = segmentProgress; exports.segmentValue = segmentValue; exports.shotShapeProblems = shotShapeProblems; exports.suggestName = suggestName; exports.toFlairEffectDocument = toFlairEffectDocument; exports.toFlairSvgMotion = toFlairSvgMotion; exports.toFlairVectorEffect = toFlairVectorEffect; exports.toLottie = toLottie; exports.trackValue = trackValue; exports.withMotionLayers = withMotionLayers; exports.withViewBox = withViewBox;
+exports.ANIMATION_EDITOR_AGENT_INSTRUCTIONS = ANIMATION_EDITOR_AGENT_INSTRUCTIONS; exports.AnimationEditorController = AnimationEditorController; exports.FLAIR_EASES = FLAIR_EASES; exports.FLAIR_EXPORT_VERSION = FLAIR_EXPORT_VERSION; exports.MOTION_ADDITIVE_PROPERTIES = MOTION_ADDITIVE_PROPERTIES; exports.MOTION_BLENDS = MOTION_BLENDS; exports.MOTION_CAMERA_MS = MOTION_CAMERA_MS; exports.MOTION_COMMAND_SCHEMA = MOTION_COMMAND_SCHEMA; exports.MOTION_COMMAND_TYPES = MOTION_COMMAND_TYPES; exports.MOTION_DEFAULT_DURATIONS = MOTION_DEFAULT_DURATIONS; exports.MOTION_DEFAULT_HOLD = MOTION_DEFAULT_HOLD; exports.MOTION_DIRECTIONS = MOTION_DIRECTIONS; exports.MOTION_DRAW_EFFECT_ID = MOTION_DRAW_EFFECT_ID; exports.MOTION_DRAW_MS_PER_UNIT = MOTION_DRAW_MS_PER_UNIT; exports.MOTION_DRAW_RANGE = MOTION_DRAW_RANGE; exports.MOTION_EASE_CHOICES = MOTION_EASE_CHOICES; exports.MOTION_EASE_IN_OUT = MOTION_EASE_IN_OUT; exports.MOTION_EASE_OUT = MOTION_EASE_OUT; exports.MOTION_EDIT_OPS = MOTION_EDIT_OPS; exports.MOTION_ENTER_STYLES = MOTION_ENTER_STYLES; exports.MOTION_EXIT_STYLES = MOTION_EXIT_STYLES; exports.MOTION_IRIS_SHAPES = MOTION_IRIS_SHAPES; exports.MOTION_ISSUE_CODES = MOTION_ISSUE_CODES; exports.MOTION_MIN_CHANGE_MS = MOTION_MIN_CHANGE_MS; exports.MOTION_REPEAT_MODES = MOTION_REPEAT_MODES; exports.MOTION_SPEED_RANGE = MOTION_SPEED_RANGE; exports.MOTION_SPLIT_ORIENTATIONS = MOTION_SPLIT_ORIENTATIONS; exports.MotionSceneFormatError = MotionSceneFormatError; exports.activeSegment = activeSegment; exports.applyMotionControlValues = applyMotionControlValues; exports.applyMotionEdits = applyMotionEdits; exports.checkMotionScene = checkMotionScene; exports.commandShapeProblems = commandShapeProblems; exports.compileMotionScene = compileMotionScene; exports.createAnimationEditorToolProvider = createAnimationEditorToolProvider; exports.createMotionScene = createMotionScene; exports.defaultMotionCommand = defaultMotionCommand; exports.describeMotionElements = describeMotionElements; exports.describeMotionShots = describeMotionShots; exports.duplicateMotionCommandEdit = duplicateMotionCommandEdit; exports.fitMotionRect = fitMotionRect; exports.fitMotionScene = fitMotionScene; exports.fitMotionSceneEdits = fitMotionSceneEdits; exports.flairAtLeast = flairAtLeast; exports.flairCurveFor = flairCurveFor; exports.flairEaseFor = flairEaseFor; exports.formatMotionNarration = formatMotionNarration; exports.freshShotId = freshShotId; exports.fromFlairSvgMotion = fromFlairSvgMotion; exports.fromFlairVectorEffect = fromFlairVectorEffect; exports.highlightMotionSvg = highlightMotionSvg; exports.indexMotionNodes = indexMotionNodes; exports.interpolateMotionValue = interpolateMotionValue; exports.isMotionCommand = isMotionCommand; exports.isMotionShot = isMotionShot; exports.matchMotionNodes = matchMotionNodes; exports.motionAddTrackKey = motionAddTrackKey; exports.motionBeatAt = motionBeatAt; exports.motionBeatTime = motionBeatTime; exports.motionClipAttrs = motionClipAttrs; exports.motionCommandDuration = motionCommandDuration; exports.motionCommandFields = motionCommandFields; exports.motionCommandRepeat = motionCommandRepeat; exports.motionCommandRows = motionCommandRows; exports.motionCommandSummary = motionCommandSummary; exports.motionCueChoices = motionCueChoices; exports.motionCueFromKey = motionCueFromKey; exports.motionCueKey = motionCueKey; exports.motionCueTime = motionCueTime; exports.motionCycleDuration = motionCycleDuration; exports.motionEaseKey = motionEaseKey; exports.motionEasingCurve = motionEasingCurve; exports.motionEasingGuides = motionEasingGuides; exports.motionEasingPath = motionEasingPath; exports.motionFieldEdit = motionFieldEdit; exports.motionFieldLabel = motionFieldLabel; exports.motionFlairPrimitive = motionFlairPrimitive; exports.motionFollowRoute = motionFollowRoute; exports.motionFrameAt = motionFrameAt; exports.motionFrameToSvg = motionFrameToSvg; exports.motionGhosts = motionGhosts; exports.motionIssue = motionIssue; exports.motionIssueKey = motionIssueKey; exports.motionIssueLine = motionIssueLine; exports.motionMovingIds = motionMovingIds; exports.motionNodeAtElement = motionNodeAtElement; exports.motionNodeClips = motionNodeClips; exports.motionNodeOffset = motionNodeOffset; exports.motionPath = motionPath; exports.motionPathLength = motionPathLength; exports.motionPathsSvg = motionPathsSvg; exports.motionRestValue = motionRestValue; exports.motionRevealClip = motionRevealClip; exports.motionRevealPadding = motionRevealPadding; exports.motionRulerTicks = motionRulerTicks; exports.motionSceneShapeProblems = motionSceneShapeProblems; exports.motionSceneToJson = motionSceneToJson; exports.motionShotAt = motionShotAt; exports.motionShotCueTime = motionShotCueTime; exports.motionShotTimeScale = motionShotTimeScale; exports.motionStageSvg = motionStageSvg; exports.motionTrackKey = motionTrackKey; exports.namedWithSuggestion = namedWithSuggestion; exports.parseMotionFieldInput = parseMotionFieldInput; exports.parseMotionNarration = parseMotionNarration; exports.parseMotionScene = parseMotionScene; exports.resolveMotionCamera = resolveMotionCamera; exports.segmentProgress = segmentProgress; exports.segmentValue = segmentValue; exports.shotShapeProblems = shotShapeProblems; exports.suggestName = suggestName; exports.toFlairEffectDocument = toFlairEffectDocument; exports.toFlairSvgMotion = toFlairSvgMotion; exports.toFlairVectorEffect = toFlairVectorEffect; exports.toLottie = toLottie; exports.trackValue = trackValue; exports.withMotionLayers = withMotionLayers; exports.withViewBox = withViewBox;
 //# sourceMappingURL=index.cjs.map