@pixerate/editor 0.60.0 → 0.62.0

package/dist/animation-editor/index.js

@@ -63,6 +63,7 @@ var MOTION_COMMAND_TYPES = [
   "fade",
   "style",
   "morph",
+  "match",
   "follow",
   "pulse",
   "shake",
@@ -89,6 +90,7 @@ var MOTION_DEFAULT_DURATIONS = {
   fade: 400,
   style: 500,
   morph: 900,
+  match: 900,
   follow: 1400,
   pulse: 600,
   shake: 500,
@@ -133,6 +135,8 @@ var MOTION_ISSUE_CODES = {
   "not-a-path": { severity: "error", wording: "A follow path must be a path node, not a group." },
   "reveal-no-box": { severity: "warning", wording: "A wipe, iris or split cannot clip a node with no width or height (a lone straight line), so it fades instead." },
   "unknown-shape": { severity: "error", wording: "A morph names a shape the artwork does not have." },
+  "match-self": { severity: "error", wording: "A match turns a group into itself or into a group it holds (or that holds it)." },
+  "match-unpaired": { severity: "note", wording: `Parts of a match's "into" group have no partner in the target, so they do not appear.` },
   "unknown-effect": { severity: "error", wording: "An effect command names an effect the node does not have." },
   "unknown-effect-param": { severity: "error", wording: "An effect command names a parameter that is not a number of that effect." },
   "unknown-frame": { severity: "error", wording: "A camera frames a node the artwork does not have." },
@@ -203,7 +207,7 @@ ${problems.map((p) => `- ${p}`).join("\n")}`);
   }
 };
 var SCENE_KEYS = ["version", "name", "description", "artwork", "shots", "loop", "fps", "steps", "target", "controls", "presets"];
-var SHOT_KEYS = ["id", "label", "camera", "run", "hold"];
+var SHOT_KEYS = ["id", "label", "camera", "run", "hold", "speed"];
 var CAMERA_KEYS = ["x", "y", "width", "height", "frame", "padding", "ease", "ms", "geometric"];
 var BASE_KEYS = ["type", "targets", "duration", "delay", "stagger", "with", "ease", "note", "repeat", "repeatMode", "steps"];
 var COMMAND_KEYS = {
@@ -216,6 +220,7 @@ var COMMAND_KEYS = {
   fade: [...BASE_KEYS, "to"],
   style: [...BASE_KEYS, "fill", "stroke", "strokeWidth"],
   morph: [...BASE_KEYS, "into"],
+  match: [...BASE_KEYS, "into"],
   follow: [...BASE_KEYS, "path", "rotate", "from", "to"],
   pulse: [...BASE_KEYS, "amount", "count", "blend"],
   shake: [...BASE_KEYS, "amount", "count", "axis", "blend"],
@@ -311,7 +316,8 @@ function commandShapeProblems(command2, where) {
       if (command2.strokeWidth !== void 0 && !(isNum(command2.strokeWidth) && command2.strokeWidth >= 0)) p(`"strokeWidth" must be a number \u2265 0.`);
       break;
     case "morph":
-      if (typeof command2.into !== "string" || !command2.into) p(`"into" must be the id of a node whose shape to take.`);
+    case "match":
+      if (typeof command2.into !== "string" || !command2.into) p(`"into" must be the id of a ${type === "match" ? "group to become" : "node whose shape to take"}.`);
       break;
     case "follow":
       if (typeof command2.path !== "string" || !command2.path) p(`"path" must be the id of a path node.`);
@@ -354,6 +360,7 @@ function shotShapeProblems(shot, where) {
   const name = typeof shot.id === "string" ? `Shot "${shot.id}"` : where;
   if (shot.label !== void 0 && typeof shot.label !== "string") problems.push(`${name}: "label" must be a string.`);
   if (shot.hold !== void 0 && !(isNum(shot.hold) && shot.hold >= 0)) problems.push(`${name}: "hold" must be a number of milliseconds \u2265 0.`);
+  if (shot.speed !== void 0 && !(isNum(shot.speed) && shot.speed >= 0.05 && shot.speed <= 20)) problems.push(`${name}: "speed" must be a number from 0.05 to 20 (2 plays it twice as fast).`);
   if (shot.camera !== void 0) {
     const c = shot.camera;
     if (!isObject(c)) problems.push(`${name}: "camera" must be an object.`);
@@ -420,6 +427,53 @@ function motionSceneToJson(scene, space = 2) {
 var isMotionShot = (shot) => shotShapeProblems(shot, "Shot").length === 0;
 var isMotionCommand = (command2) => commandShapeProblems(command2, "Command").length === 0;
 
+// src/animation-editor/match.ts
+var SEPARATOR = /[-_/.:]/;
+function localId(id, groupId) {
+  if (groupId && id.includes(groupId)) return id.split(groupId).join("").replace(/^[-_/.:]+|[-_/.:]+$/g, "");
+  const parts = id.split(SEPARATOR);
+  return parts[parts.length - 1] ?? id;
+}
+function matchMotionNodes(from, into) {
+  const out = { pairs: [], unpairedFrom: [], unpairedInto: [] };
+  const visit = (a, b) => {
+    const aKids = a.type === "group" ? a.children : [];
+    const bKids = b.type === "group" ? b.children : [];
+    if (!aKids.length || !bKids.length) {
+      out.pairs.push([a.id, b.id]);
+      return;
+    }
+    const left = new Set(aKids);
+    const right = new Set(bKids);
+    const pair = (key) => {
+      for (const x of [...left]) {
+        const k = key(x, a);
+        if (!k) continue;
+        const y = [...right].find((n) => key(n, b) === k);
+        if (!y) continue;
+        left.delete(x);
+        right.delete(y);
+        if (x.type === "group" && y.type === "group") visit(x, y);
+        else out.pairs.push([x.id, y.id]);
+      }
+    };
+    pair((n) => n.name?.trim() || void 0);
+    pair((n, g) => localId(n.id, g.id) || void 0);
+    for (const x of [...left]) {
+      const y = [...right].find((n) => n.type === x.type);
+      if (!y) continue;
+      left.delete(x);
+      right.delete(y);
+      if (x.type === "group" && y.type === "group") visit(x, y);
+      else out.pairs.push([x.id, y.id]);
+    }
+    out.unpairedFrom.push(...[...left].map((n) => n.id));
+    out.unpairedInto.push(...[...right].map((n) => n.id));
+  };
+  visit(from, into);
+  return out;
+}
+
 // src/animation-editor/compile.ts
 var indexCache = /* @__PURE__ */ new WeakMap();
 function indexMotionNodes(nodes) {
@@ -642,6 +696,9 @@ function motionPathLength(node, parentWorld = IDENTITY_MATRIX) {
   }
   return longest;
 }
+function motionShotTimeScale(shot) {
+  return typeof shot.speed === "number" && shot.speed > 0 && Number.isFinite(shot.speed) ? 1 / shot.speed : 1;
+}
 function motionCommandRepeat(command2) {
   if (command2.type === "wait" || command2.type === "enter" || command2.type === "exit") return 1;
   const n = command2.repeat ?? 1;
@@ -681,10 +738,11 @@ function compileMotionScene(scene) {
   scene.shots.forEach((shot, index) => {
     const start = t;
     let cursor = start;
+    const f = motionShotTimeScale(shot);
     if (shot.camera) {
       const rect = resolveMotionCamera(shot.camera, scene);
       if (rect && rect.width > 0 && rect.height > 0) {
-        const ms = index === 0 ? 0 : shot.camera.ms ?? MOTION_CAMERA_MS;
+        const ms = index === 0 ? 0 : (shot.camera.ms ?? MOTION_CAMERA_MS) * f;
         cameraMoves.push({ shot: shot.id, start, end: start + ms, to: rect, ease: shot.camera.ease ?? MOTION_EASE_IN_OUT, geometric: shot.camera.geometric === true });
         cursor = start + ms;
       }
@@ -694,16 +752,16 @@ function compileMotionScene(scene) {
     let prevStart = cursor;
     shot.run.forEach((command2, i) => {
       const base = command2.with === "previous" && i > 0 ? prevStart : runEnd;
-      const begin = base + (command2.type === "wait" ? 0 : command2.delay ?? 0);
+      const begin = base + (command2.type === "wait" ? 0 : (command2.delay ?? 0) * f);
       const targets = command2.type === "wait" ? [] : command2.targets;
-      const durations = command2.type === "wait" ? [command2.duration] : targets.map((id) => motionCommandDuration(command2, scene, id));
-      const stagger = command2.type === "wait" ? 0 : command2.stagger ?? 0;
+      const durations = command2.type === "wait" ? [command2.duration * f] : targets.map((id) => motionCommandDuration(command2, scene, id) * f);
+      const stagger = command2.type === "wait" ? 0 : (command2.stagger ?? 0) * f;
       const end2 = durations.reduce((m, d, k) => Math.max(m, begin + k * stagger + d), begin);
       commands.push({ shot: shot.id, shotIndex: index, command: i, type: command2.type, start: begin, end: end2, duration: durations[0] ?? 0 });
       prevStart = begin;
       runEnd = Math.max(runEnd, end2);
     });
-    const end = runEnd + (shot.hold ?? MOTION_DEFAULT_HOLD);
+    const end = runEnd + (shot.hold ?? MOTION_DEFAULT_HOLD) * f;
     shots.push({ id: shot.id, index, ...shot.label ? { label: shot.label } : {}, start, commandsStart, commandsEnd: runEnd, end });
     t = end;
   });
@@ -736,8 +794,9 @@ function compileMotionScene(scene) {
     command2.targets.forEach((target, k) => {
       const entry = nodes.get(target);
       if (!entry) return;
-      const start = timing.start + k * (command2.stagger ?? 0);
-      const cycle = motionCycleDuration(command2, scene, target);
+      const f = motionShotTimeScale(shot);
+      const start = timing.start + k * (command2.stagger ?? 0) * f;
+      const cycle = motionCycleDuration(command2, scene, target) * f;
       jobs.push({ start, order: order++, run: () => compileRepeated(command2, target, entry, start, cycle, timing) });
     });
   }
@@ -886,6 +945,15 @@ function compileMotionScene(scene) {
       case "morph":
         seg("shape", command2.into, ease ?? MOTION_EASE_IN_OUT);
         break;
+      case "match": {
+        const into = nodes.get(command2.into);
+        if (!into || command2.into === node) break;
+        const match = matchMotionNodes(entry.node, into.node);
+        const e = ease ?? MOTION_EASE_IN_OUT;
+        for (const [a, b] of match.pairs) push({ node: a, property: "shape", start, end, from: valueAt(a, "shape", start), to: b, ease: e, ...where });
+        for (const a of match.unpairedFrom) push({ node: a, property: "opacity", start, end, from: valueAt(a, "opacity", start), to: 0, ease: e, ...where });
+        break;
+      }
       case "follow":
         seg("follow", command2.to ?? 1, ease ?? MOTION_EASE_IN_OUT, start, end, { from: command2.from ?? 0, path: command2.path, rotate: command2.rotate ?? false });
         break;
@@ -1226,6 +1294,19 @@ function checkMotionScene(scene) {
       if (command2.type === "follow" && known(command2.path, "unknown-path", "path", where) && nodes.get(command2.path).node.type !== "path")
         issues.push(motionIssue("not-a-path", `"${command2.path}" is a group; follow a single path node.`, { ...where, ids: [command2.path] }));
       if (command2.type === "morph") known(command2.into, "unknown-shape", "shape", where);
+      if (command2.type === "match" && known(command2.into, "unknown-shape", "group", where)) {
+        const into = nodes.get(command2.into);
+        for (const id of targets) {
+          const entry = nodes.get(id);
+          if (id === command2.into || into.ancestors.includes(id) || entry.ancestors.includes(command2.into)) {
+            issues.push(motionIssue("match-self", `"${id}" cannot match "${command2.into}": one is the other or holds it. Match two separate groups (the second usually hidden).`, { ...where, ids: [id, command2.into] }));
+            continue;
+          }
+          const m = matchMotionNodes(entry.node, into.node);
+          if (m.unpairedInto.length)
+            issues.push(motionIssue("match-unpaired", `${m.unpairedInto.map((x) => `"${x}"`).join(", ")} in "${command2.into}" ${m.unpairedInto.length > 1 ? "have" : "has"} no partner in "${id}", so ${m.unpairedInto.length > 1 ? "they do" : "it does"} not appear; add a part with the same name or id to "${id}" (it can start hidden or tiny).`, { ...where, ids: m.unpairedInto }));
+        }
+      }
       const style = command2.type === "enter" || command2.type === "exit" ? command2.style : void 0;
       if (style === "wipe" || style === "iris" || style === "split") {
         for (const id of targets)
@@ -1329,8 +1410,8 @@ function checkMotionScene(scene) {
   if (scene.target && scene.shots.length) {
     const seconds = Math.round(timeline.duration / 100) / 10;
     const [min, max] = scene.target;
-    if (seconds > max) issues.push(motionIssue("scene-too-long", `The scene runs ${seconds} s, past its ${max} s target; shorten holds or durations.`, { measured: seconds, needed: max, unit: "s" }));
-    if (seconds < min) issues.push(motionIssue("scene-too-short", `The scene runs ${seconds} s, under its ${min} s target; hold longer or add shots.`, { measured: seconds, needed: min, unit: "s" }));
+    if (seconds > max) issues.push(motionIssue("scene-too-long", `The scene runs ${seconds} s, past its ${max} s target; shorten holds or durations, or fit it (fit_animation).`, { measured: seconds, needed: max, unit: "s" }));
+    if (seconds < min) issues.push(motionIssue("scene-too-short", `The scene runs ${seconds} s, under its ${min} s target; hold longer, add shots, or fit it (fit_animation).`, { measured: seconds, needed: min, unit: "s" }));
   }
   return issues;
 }
@@ -1515,6 +1596,34 @@ function createMotionScene(artwork, init = {}) {
   return { version: 1, name: init.name ?? "animation", ...init, artwork, shots: init.shots ?? [] };
 }
 
+// src/animation-editor/fit.ts
+var MOTION_SPEED_RANGE = [0.05, 20];
+function fitMotionScene(scene, ms, options = {}) {
+  if (!(Number.isFinite(ms) && ms > 0)) throw new Error("Give the length to fit as a number of milliseconds above 0.");
+  const ids = scene.shots.map((s) => s.id);
+  const keep = new Set(options.keep ?? []);
+  for (const id of keep) if (!ids.includes(id)) throw new Error(`There is no shot ${namedWithSuggestion(id, ids)} to keep.`);
+  const timeline = compileMotionScene(scene);
+  let kept = 0;
+  let rest = 0;
+  timeline.shots.forEach((t) => keep.has(t.id) ? kept += t.end - t.start : rest += t.end - t.start);
+  if (rest <= 0) throw new Error(keep.size ? "Every shot is kept, so nothing can change pace; keep fewer shots." : "The scene has no length to fit; add shots first.");
+  if (ms <= kept) throw new Error(`The kept shots alone last ${Math.round(kept)} ms, so the scene cannot fit ${Math.round(ms)} ms; keep fewer shots or give at least ${Math.ceil(kept) + 1} ms.`);
+  const k = (ms - kept) / rest;
+  const speeds = {};
+  const shots = scene.shots.map((shot) => {
+    if (keep.has(shot.id)) return shot;
+    const speed = Math.round((shot.speed ?? 1) / k * 1e4) / 1e4;
+    if (speed < MOTION_SPEED_RANGE[0] || speed > MOTION_SPEED_RANGE[1])
+      throw new Error(`Fitting ${Math.round(ms)} ms would play shot "${shot.id}" at ${speed}\xD7 (speeds run ${MOTION_SPEED_RANGE[0]}\u2013${MOTION_SPEED_RANGE[1]}); aim nearer the current ${Math.round(timeline.duration)} ms.`);
+    speeds[shot.id] = speed;
+    const { speed: _old, ...rest2 } = shot;
+    return speed === 1 ? rest2 : { ...rest2, speed };
+  });
+  const fitted = { ...scene, shots };
+  return { scene: fitted, duration: compileMotionScene(fitted).duration, speeds };
+}
+
 // src/animation-editor/flair.ts
 var FLAIR_EASES = {
   linear: (t) => t,
@@ -2331,6 +2440,7 @@ var MOTION_COMMAND_SCHEMA = {
       stroke: { type: "string", description: "CSS colour (hex, rgb(), rgba())." },
       strokeWidth: { type: "number", minimum: 0, description: "Document units." }
     }),
+    command("match", `Smart Animate: tweens a group into another group (usually hidden), part by part. Parts pair by name, then by id with the group ids taken out (card-a-title \u2194 card-b-title), then by kind in order; each takes its partner's shape, paint and place. Unpaired parts fade out; parts of "into" with no partner do not appear (check_animation lists them).`, { into: { type: "string", minLength: 1, description: "Id of the group to become." } }, ["into"]),
     command("morph", "Morphs each target into the shape (and paint) of another node, which usually stays hidden.", { into: { type: "string", minLength: 1, description: "Id of the node whose shape to take." } }, ["into"]),
     command("follow", "Moves targets along a path node, centre on the path.", {
       path: { type: "string", minLength: 1, description: "Id of a path node (it can be hidden)." },
@@ -2384,7 +2494,8 @@ var SHOT_FIELDS = {
   label: { type: "string", description: "What happens, in a few words." },
   camera: CAMERA,
   run: { type: "array", items: MOTION_COMMAND_SCHEMA, description: "Commands, in order." },
-  hold: MS("Hold after the commands (default 600)")
+  hold: MS("Hold after the commands (default 600)"),
+  speed: { type: "number", minimum: 0.05, maximum: 20, description: "Play the whole shot this many times as fast (default 1; 0.5 is half speed). fit_animation sets it." }
 };
 var SHOT = object({ id: { type: "string", pattern: "^[A-Za-z0-9_][\\w.-]*$", description: 'Unique shot id, e.g. "intro".' }, ...SHOT_FIELDS }, ["id", "run"], "A shot.");
 var CONTROL = object(
@@ -2411,7 +2522,7 @@ var EDIT_OP = {
   oneOf: [
     object({ op: { const: "set_settings", description: "Like set_animation_settings." }, ...SETTINGS }, ["op"]),
     object({ op: { const: "insert_shots", description: "Like insert_shots." }, shots: { type: "array", items: SHOT, minItems: 1, description: "Shots to add." }, at: { type: "integer", minimum: 0, description: "Position (default: the end)." } }, ["op", "shots"]),
-    object({ op: { const: "update_shot", description: "Like update_shot." }, shot: SHOT_ID, set: object({ id: SHOT.properties.id, ...SHOT_FIELDS }, [], "Fields to replace."), remove: { type: "array", items: { type: "string", enum: ["label", "camera", "hold"] }, description: "Fields to clear." } }, ["op", "shot"]),
+    object({ op: { const: "update_shot", description: "Like update_shot." }, shot: SHOT_ID, set: object({ id: SHOT.properties.id, ...SHOT_FIELDS }, [], "Fields to replace."), remove: { type: "array", items: { type: "string", enum: ["label", "camera", "hold", "speed"] }, description: "Fields to clear." } }, ["op", "shot"]),
     object({ op: { const: "delete_shots", description: "Like delete_shots." }, shots: { type: "array", items: SHOT_ID, minItems: 1, description: "Shot ids." } }, ["op", "shots"]),
     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"]),
@@ -2658,6 +2769,27 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       return outcome(applied, applied.ok ? { ...report, elements: describeMotionElements(result.scene) } : {});
     }
   };
+  const fitAnimation = {
+    name: "fit_animation",
+    title: "Fit the animation to a length",
+    description: `Makes the animation last a given time by setting its shots' speed (one undo step): shots in "keep" play as they are and the others stretch or squeeze together, keeping their proportions. Returns the new length, each changed shot's speed and the timing. With dry_run it only reports them.`,
+    inputSchema: object(
+      {
+        seconds: { type: "number", exclusiveMinimum: 0, description: "The length to fit, in seconds." },
+        keep: { type: "array", items: SHOT_ID, description: "Shots that keep their pace, e.g. a logo hold (default none)." },
+        dry_run: { type: "boolean", description: "Report without changing anything (default false)." }
+      },
+      ["seconds"]
+    ),
+    annotations: { title: "Fit the animation to a length", ...WRITE_IDEMPOTENT },
+    handler: ({ seconds, keep, dry_run = false }) => {
+      const fit = fitMotionScene(controller.getState().scene, seconds * 1e3, { keep: keep ?? [] });
+      const report = { duration: fit.duration, speeds: fit.speeds };
+      if (dry_run) return { dry_run: true, ...report, hint: "Nothing was changed; call again without dry_run to fit." };
+      const edits = Object.entries(fit.speeds).map(([shot, speed]) => speed === 1 ? { op: "update_shot", shot, remove: ["speed"] } : { op: "update_shot", shot, set: { speed } });
+      return apply(edits, "Fit to length", () => report);
+    }
+  };
   const insertShots = {
     name: "insert_shots",
     title: "Add shots",
@@ -2674,7 +2806,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       {
         shot: SHOT_ID,
         set: object({ id: SHOT.properties.id, ...SHOT_FIELDS }, [], "Fields to replace."),
-        remove: { type: "array", items: { type: "string", enum: ["label", "camera", "hold"] }, description: "Fields to clear." }
+        remove: { type: "array", items: { type: "string", enum: ["label", "camera", "hold", "speed"] }, description: "Fields to clear." }
       },
       ["shot"]
     ),
@@ -2819,7 +2951,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
     }
   };
   const reads = [getAnimation, getShot, findElements, checkAnimation, renderFrame, exportFlairMotion, exportFlairEffect, seekAnimation];
-  const writes = [setArtworkSvg, 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, setSettings, setControls, editAnimation, writeAnimation, undo, redo];
   return {
     id: options.id ?? "animation",
     namespace: options.namespace,
@@ -2852,7 +2984,7 @@ Commands
 - 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.
 - 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.
 - enter also has zoom (settles from larger) and rise (rises a short way, overshooting a touch); pop and zoom take a starting "scale".
-- morph turns a shape into another node's shape (keep the target hidden); follow moves along a path node (with "rotate", moves made meanwhile turn with the path).
+- 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).
 - 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).
 - 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.
 - 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.
@@ -2864,7 +2996,7 @@ 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).
-3. check_animation and fix every error and warning; render_animation_frame (shot + "end") to look at the result.
+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.
 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.`;
@@ -2893,6 +3025,7 @@ export {
   MOTION_ISSUE_CODES,
   MOTION_MIN_CHANGE_MS,
   MOTION_REPEAT_MODES,
+  MOTION_SPEED_RANGE,
   MOTION_SPLIT_ORIENTATIONS,
   MotionSceneFormatError,
   activeSegment,
@@ -2906,6 +3039,7 @@ export {
   describeMotionElements,
   describeMotionShots,
   fitMotionRect,
+  fitMotionScene,
   flairAtLeast,
   flairCurveFor,
   flairEaseFor,
@@ -2916,6 +3050,7 @@ export {
   interpolateMotionValue,
   isMotionCommand,
   isMotionShot,
+  matchMotionNodes,
   motionAddTrackKey,
   motionClipAttrs,
   motionCommandDuration,
@@ -2937,6 +3072,7 @@ export {
   motionSceneShapeProblems,
   motionSceneToJson,
   motionShotAt,
+  motionShotTimeScale,
   motionTrackKey,
   namedWithSuggestion,
   parseMotionScene,