@pixerate/editor 0.73.0 → 0.75.0

package/dist/animation-editor/index.js

@@ -4,6 +4,7 @@ import {
   collectPathNodes,
   createVectorEffect,
   createVectorMorph,
+  ellipseSubpath,
   expandVectorAppearance,
   expandVectorAppearances,
   invertMatrix,
@@ -12,20 +13,24 @@ import {
   nodeMatrix,
   parseSvgTransform,
   parseVectorSvg,
+  rectSubpath,
   rotateMatrix,
   scaleMatrix,
   translateMatrix,
   vectorDocumentToSvg,
   vectorNodeBounds,
   vectorPathWorldBezier
-} from "../chunk-3TLL5OID.js";
+} from "../chunk-4JLB2USO.js";
 import {
   bezierPathLength,
   bezierPathPointAtLength,
   bezierPathToSvg,
   toBezierPath,
   transformBezierPath
-} from "../chunk-GTMJ4Y3S.js";
+} from "../chunk-YCSFS3GK.js";
+import {
+  readZip
+} from "../chunk-33AHNSEB.js";
 import {
   HistoryManager
 } from "../chunk-QVZZGT4X.js";
@@ -56,6 +61,8 @@ import {
 
 // src/animation-editor/types.ts
 var MOTION_TRIGGERS = ["click", "hover", "press", "scroll"];
+var MOTION_TEXT_UNITS = ["letter", "word", "line"];
+var MOTION_CASCADES = ["forward", "backward", "center", "edges", "random"];
 var MOTION_DRIVEN_PROPERTIES = ["x", "y", "rotation", "scaleX", "scaleY", "opacity"];
 var MOTION_CLIP_TARGET = "$";
 var MOTION_COMMAND_TYPES = [
@@ -112,21 +119,21 @@ var MOTION_DEFAULT_HOLD = 600;
 var MOTION_CAMERA_MS = 1e3;
 var MOTION_DRAW_MS_PER_UNIT = 1.5;
 var MOTION_DRAW_RANGE = [500, 2500];
-function motionFlairPrimitive(command2) {
-  switch (command2.type) {
+function motionFlairPrimitive(command3) {
+  switch (command3.type) {
     case "enter":
-      return `entrance.${command2.style ?? "fade"}`;
+      return `entrance.${command3.style ?? "fade"}`;
     case "exit":
-      return `exit.${command2.style ?? "fade"}`;
+      return `exit.${command3.style ?? "fade"}`;
     case "pulse":
     case "shake":
     case "teeter":
     case "wave":
     case "wiggle":
     case "color-pulse":
-      return `emphasis.${command2.type}`;
+      return `emphasis.${command3.type}`;
     case "rotate":
-      return command2.by !== void 0 ? "emphasis.spin" : void 0;
+      return command3.by !== void 0 ? "emphasis.spin" : void 0;
     case "follow":
       return "path.follow";
     default:
@@ -143,6 +150,7 @@ 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." },
   "driver-cycle": { severity: "error", wording: "Drivers follow each other in a loop, so none of them has a value." },
+  "split-not-text": { severity: "warning", wording: "A command splits a target into letters, but it is not a group of letter paths, so it animates as a whole." },
   "unknown-clip": { severity: "error", wording: "A play command names a clip the scene does not have." },
   "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)." },
@@ -224,7 +232,7 @@ ${problems.map((p) => `- ${p}`).join("\n")}`);
 var SCENE_KEYS = ["version", "name", "description", "artwork", "shots", "clips", "drivers", "motionBlur", "loop", "trigger", "fps", "steps", "beat", "narration", "target", "controls", "presets"];
 var SHOT_KEYS = ["id", "label", "camera", "at", "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 BASE_KEYS = ["type", "targets", "duration", "delay", "stagger", "with", "ease", "note", "repeat", "repeatMode", "steps", "split", "cascade"];
 var DRAW_ORDER_KEYS = ["order", "pace", "align", "sortBy", "origin"];
 var COMMAND_KEYS = {
   enter: [...BASE_KEYS, ...DRAW_ORDER_KEYS, "style", "direction", "distance", "scale", "shape", "orientation"],
@@ -254,108 +262,111 @@ var isPoint = (v) => isObject(v) && isNum(v.x) && isNum(v.y);
 function unknownKeys(value, known, where, problems) {
   for (const key of Object.keys(value)) if (!known.includes(key)) problems.push(`${where}: unknown field ${namedWithSuggestion(key, known)}.`);
 }
-function commandShapeProblems(command2, where) {
+function commandShapeProblems(command3, where) {
   const problems = [];
-  if (!isObject(command2)) return [`${where} must be an object.`];
-  const type = command2.type;
+  if (!isObject(command3)) return [`${where} must be an object.`];
+  const type = command3.type;
   if (typeof type !== "string" || !MOTION_COMMAND_TYPES.includes(type)) {
     return [`${where}: unknown type ${typeof type === "string" ? namedWithSuggestion(type, MOTION_COMMAND_TYPES) : String(type)}; use one of ${MOTION_COMMAND_TYPES.join(", ")}.`];
   }
-  unknownKeys(command2, COMMAND_KEYS[type], `${where} (${type})`, problems);
+  unknownKeys(command3, COMMAND_KEYS[type], `${where} (${type})`, problems);
   const p = (msg) => problems.push(`${where} (${type}): ${msg}`);
   const nonNegative = (key) => {
-    if (command2[key] !== void 0 && !(isNum(command2[key]) && command2[key] >= 0)) p(`"${key}" must be a number of milliseconds \u2265 0.`);
+    if (command3[key] !== void 0 && !(isNum(command3[key]) && command3[key] >= 0)) p(`"${key}" must be a number of milliseconds \u2265 0.`);
   };
   const fraction = (key) => {
-    if (command2[key] !== void 0 && !(isNum(command2[key]) && command2[key] >= 0 && command2[key] <= 1)) p(`"${key}" must be a fraction from 0 to 1.`);
+    if (command3[key] !== void 0 && !(isNum(command3[key]) && command3[key] >= 0 && command3[key] <= 1)) p(`"${key}" must be a fraction from 0 to 1.`);
   };
   const optionalNumber = (key) => {
-    if (command2[key] !== void 0 && !isNum(command2[key])) p(`"${key}" must be a number.`);
+    if (command3[key] !== void 0 && !isNum(command3[key])) p(`"${key}" must be a number.`);
   };
-  if (command2.with !== void 0 && command2.with !== "after" && command2.with !== "previous") p(`"with" must be "after" or "previous".`);
-  if (DRAW_ORDER_KEYS.some((k) => command2[k] !== void 0)) {
-    if (type === "enter" && command2.style !== "draw" || type === "exit" && command2.style !== "undraw") p(`"order", "pace", "align", "sortBy" and "origin" go with drawing: style "${type === "enter" ? "draw" : "undraw"}".`);
-    if (command2.order !== void 0 && command2.order !== "together" && command2.order !== "sequence") p(`"order" must be "together" or "sequence" (one stroke after another).`);
-    if (command2.pace !== void 0 && command2.pace !== "time" && command2.pace !== "speed") p(`"pace" must be "time" (each stroke takes the whole time) or "speed" (all at one speed).`);
-    if (command2.align !== void 0 && command2.align !== "start" && command2.align !== "end") p(`"align" must be "start" or "end".`);
-    if (command2.sortBy !== void 0 && command2.sortBy !== "document" && command2.sortBy !== "distance") p(`"sortBy" must be "document" or "distance".`);
-    if (command2.origin !== void 0 && !isPoint(command2.origin)) p(`"origin" must be { "x": number, "y": number } (document units).`);
+  if (command3.with !== void 0 && command3.with !== "after" && command3.with !== "previous") p(`"with" must be "after" or "previous".`);
+  if (DRAW_ORDER_KEYS.some((k) => command3[k] !== void 0)) {
+    if (type === "enter" && command3.style !== "draw" || type === "exit" && command3.style !== "undraw") p(`"order", "pace", "align", "sortBy" and "origin" go with drawing: style "${type === "enter" ? "draw" : "undraw"}".`);
+    if (command3.order !== void 0 && command3.order !== "together" && command3.order !== "sequence") p(`"order" must be "together" or "sequence" (one stroke after another).`);
+    if (command3.pace !== void 0 && command3.pace !== "time" && command3.pace !== "speed") p(`"pace" must be "time" (each stroke takes the whole time) or "speed" (all at one speed).`);
+    if (command3.align !== void 0 && command3.align !== "start" && command3.align !== "end") p(`"align" must be "start" or "end".`);
+    if (command3.sortBy !== void 0 && command3.sortBy !== "document" && command3.sortBy !== "distance") p(`"sortBy" must be "document" or "distance".`);
+    if (command3.origin !== void 0 && !isPoint(command3.origin)) p(`"origin" must be { "x": number, "y": number } (document units).`);
   }
-  if (command2.note !== void 0 && typeof command2.note !== "string") p(`"note" must be a string.`);
+  if (command3.note !== void 0 && typeof command3.note !== "string") p(`"note" must be a string.`);
   if (type === "wait") {
-    if (!isNum(command2.duration) || command2.duration < 0) p(`"duration" must be a number of milliseconds \u2265 0.`);
+    if (!isNum(command3.duration) || command3.duration < 0) p(`"duration" must be a number of milliseconds \u2265 0.`);
     return problems;
   }
-  if (!Array.isArray(command2.targets) || command2.targets.length === 0 || !command2.targets.every((t) => typeof t === "string" && t.length > 0)) p(`"targets" must be a non-empty list of node ids.`);
+  if (!Array.isArray(command3.targets) || command3.targets.length === 0 || !command3.targets.every((t) => typeof t === "string" && t.length > 0)) p(`"targets" must be a non-empty list of node ids.`);
   nonNegative("duration");
   nonNegative("delay");
   nonNegative("stagger");
-  if (command2.ease !== void 0 && !isAnimationEasing(command2.ease)) p(`"ease" is not an easing; use a preset such as "ease-in-out" or "spring-bouncy", or { "type": "cubic-bezier", \u2026 } or { "type": "spring", \u2026 }.`);
-  if (command2.repeat !== void 0) {
+  if (command3.ease !== void 0 && !isAnimationEasing(command3.ease)) p(`"ease" is not an easing; use a preset such as "ease-in-out" or "spring-bouncy", or { "type": "cubic-bezier", \u2026 } or { "type": "spring", \u2026 }.`);
+  if (command3.repeat !== void 0) {
     if (type === "enter" || type === "exit") p(`"repeat" is not for ${type} (it brings things in or out once); repeat an emphasis or a move instead.`);
-    else if (!(Number.isInteger(command2.repeat) && command2.repeat >= 1 && command2.repeat <= 1e3)) p(`"repeat" must be a whole number from 1 to 1000.`);
+    else if (!(Number.isInteger(command3.repeat) && command3.repeat >= 1 && command3.repeat <= 1e3)) p(`"repeat" must be a whole number from 1 to 1000.`);
   }
-  if (command2.blend !== void 0 && !MOTION_BLENDS.includes(command2.blend)) p(`"blend" must be "replace" (the change takes over) or "add" (a layer on top).`);
-  if (command2.repeatMode !== void 0 && !MOTION_REPEAT_MODES.includes(command2.repeatMode)) p(`"repeatMode" must be one of ${MOTION_REPEAT_MODES.join(", ")}.`);
-  if (command2.steps !== void 0 && !(isNum(command2.steps) && command2.steps > 0 && command2.steps <= 120)) p(`"steps" must be frames per second from above 0 to 120 (12 holds each pose for two frames at 24 fps).`);
+  if (command3.blend !== void 0 && !MOTION_BLENDS.includes(command3.blend)) p(`"blend" must be "replace" (the change takes over) or "add" (a layer on top).`);
+  if (command3.split !== void 0 && !MOTION_TEXT_UNITS.includes(command3.split)) p(`"split" must be letter, word or line (for outlined text: a group of letter paths).`);
+  if (command3.cascade !== void 0 && !MOTION_CASCADES.includes(command3.cascade)) p(`"cascade" must be one of ${MOTION_CASCADES.join(", ")}.`);
+  if (command3.cascade !== void 0 && command3.split === void 0) p(`"cascade" goes with "split".`);
+  if (command3.repeatMode !== void 0 && !MOTION_REPEAT_MODES.includes(command3.repeatMode)) p(`"repeatMode" must be one of ${MOTION_REPEAT_MODES.join(", ")}.`);
+  if (command3.steps !== void 0 && !(isNum(command3.steps) && command3.steps > 0 && command3.steps <= 120)) p(`"steps" must be frames per second from above 0 to 120 (12 holds each pose for two frames at 24 fps).`);
   switch (type) {
     case "enter":
     case "exit": {
       const styles = type === "enter" ? MOTION_ENTER_STYLES : MOTION_EXIT_STYLES;
-      if (command2.style !== void 0 && !(typeof command2.style === "string" && styles.includes(command2.style)))
-        p(`"style" must be one of ${styles.join(", ")}${typeof command2.style === "string" ? ` (got ${namedWithSuggestion(command2.style, styles)})` : ""}.`);
-      if (command2.direction !== void 0 && !MOTION_DIRECTIONS.includes(command2.direction)) p(`"direction" must be one of ${MOTION_DIRECTIONS.join(", ")}.`);
+      if (command3.style !== void 0 && !(typeof command3.style === "string" && styles.includes(command3.style)))
+        p(`"style" must be one of ${styles.join(", ")}${typeof command3.style === "string" ? ` (got ${namedWithSuggestion(command3.style, styles)})` : ""}.`);
+      if (command3.direction !== void 0 && !MOTION_DIRECTIONS.includes(command3.direction)) p(`"direction" must be one of ${MOTION_DIRECTIONS.join(", ")}.`);
       optionalNumber("distance");
-      if (command2.scale !== void 0 && !(isNum(command2.scale) && command2.scale >= 0)) p(`"scale" must be a number \u2265 0 (the starting scale for pop and zoom).`);
-      if (command2.shape !== void 0 && !MOTION_IRIS_SHAPES.includes(command2.shape)) p(`"shape" must be one of ${MOTION_IRIS_SHAPES.join(", ")} (the opening of an iris).`);
-      if (command2.orientation !== void 0 && !MOTION_SPLIT_ORIENTATIONS.includes(command2.orientation)) p(`"orientation" must be one of ${MOTION_SPLIT_ORIENTATIONS.join(", ")} (the line a split opens from).`);
+      if (command3.scale !== void 0 && !(isNum(command3.scale) && command3.scale >= 0)) p(`"scale" must be a number \u2265 0 (the starting scale for pop and zoom).`);
+      if (command3.shape !== void 0 && !MOTION_IRIS_SHAPES.includes(command3.shape)) p(`"shape" must be one of ${MOTION_IRIS_SHAPES.join(", ")} (the opening of an iris).`);
+      if (command3.orientation !== void 0 && !MOTION_SPLIT_ORIENTATIONS.includes(command3.orientation)) p(`"orientation" must be one of ${MOTION_SPLIT_ORIENTATIONS.join(", ")} (the line a split opens from).`);
       break;
     }
     case "draw":
       fraction("from");
       fraction("to");
       fraction("comet");
-      if (command2.comet !== void 0 && (command2.from !== void 0 || command2.to !== void 0)) p(`"comet" runs the whole path; leave out "from" and "to".`);
+      if (command3.comet !== void 0 && (command3.from !== void 0 || command3.to !== void 0)) p(`"comet" runs the whole path; leave out "from" and "to".`);
       break;
     case "move":
-      if (command2.by === void 0 && command2.to === void 0) p(`give "by" (an offset) or "to" (a point).`);
-      if (command2.by !== void 0 && command2.to !== void 0) p(`give "by" or "to", not both.`);
-      if (command2.by !== void 0 && !isPoint(command2.by)) p(`"by" must be { "x": number, "y": number }.`);
-      if (command2.to !== void 0 && !isPoint(command2.to)) p(`"to" must be { "x": number, "y": number }.`);
-      if (command2.via !== void 0 && !(Array.isArray(command2.via) && command2.via.length > 0 && command2.via.length <= 64 && command2.via.every(isPoint))) p(`"via" must be a list of 1 to 64 points { "x": number, "y": number } (document units).`);
-      if (command2.pacing !== void 0 && command2.pacing !== "even" && command2.pacing !== "equal") p(`"pacing" must be "even" (steady speed) or "equal" (each leg the same time).`);
-      if (command2.pacing !== void 0 && command2.via === void 0) p(`"pacing" goes with "via".`);
+      if (command3.by === void 0 && command3.to === void 0) p(`give "by" (an offset) or "to" (a point).`);
+      if (command3.by !== void 0 && command3.to !== void 0) p(`give "by" or "to", not both.`);
+      if (command3.by !== void 0 && !isPoint(command3.by)) p(`"by" must be { "x": number, "y": number }.`);
+      if (command3.to !== void 0 && !isPoint(command3.to)) p(`"to" must be { "x": number, "y": number }.`);
+      if (command3.via !== void 0 && !(Array.isArray(command3.via) && command3.via.length > 0 && command3.via.length <= 64 && command3.via.every(isPoint))) p(`"via" must be a list of 1 to 64 points { "x": number, "y": number } (document units).`);
+      if (command3.pacing !== void 0 && command3.pacing !== "even" && command3.pacing !== "equal") p(`"pacing" must be "even" (steady speed) or "equal" (each leg the same time).`);
+      if (command3.pacing !== void 0 && command3.via === void 0) p(`"pacing" goes with "via".`);
       break;
     case "rotate":
-      if (command2.by === void 0 && command2.to === void 0) p(`give "by" or "to" (degrees).`);
-      if (command2.by !== void 0 && command2.to !== void 0) p(`give "by" or "to", not both.`);
+      if (command3.by === void 0 && command3.to === void 0) p(`give "by" or "to" (degrees).`);
+      if (command3.by !== void 0 && command3.to !== void 0) p(`give "by" or "to", not both.`);
       optionalNumber("by");
       optionalNumber("to");
       break;
     case "scale":
-      if (!(isNum(command2.to) || isPoint(command2.to))) p(`"to" must be a number or { "x": number, "y": number }.`);
-      if (command2.geometric !== void 0 && typeof command2.geometric !== "boolean") p(`"geometric" must be true or false.`);
+      if (!(isNum(command3.to) || isPoint(command3.to))) p(`"to" must be a number or { "x": number, "y": number }.`);
+      if (command3.geometric !== void 0 && typeof command3.geometric !== "boolean") p(`"geometric" must be true or false.`);
       break;
     case "fade":
-      if (!(isNum(command2.to) && command2.to >= 0 && command2.to <= 1)) p(`"to" must be an opacity from 0 to 1.`);
+      if (!(isNum(command3.to) && command3.to >= 0 && command3.to <= 1)) p(`"to" must be an opacity from 0 to 1.`);
       break;
     case "style":
-      if (command2.fill === void 0 && command2.stroke === void 0 && command2.strokeWidth === void 0) p(`give at least one of "fill", "stroke" or "strokeWidth".`);
-      if (command2.fill !== void 0 && typeof command2.fill !== "string") p(`"fill" must be a CSS colour.`);
-      if (command2.stroke !== void 0 && typeof command2.stroke !== "string") p(`"stroke" must be a CSS colour.`);
-      if (command2.strokeWidth !== void 0 && !(isNum(command2.strokeWidth) && command2.strokeWidth >= 0)) p(`"strokeWidth" must be a number \u2265 0.`);
+      if (command3.fill === void 0 && command3.stroke === void 0 && command3.strokeWidth === void 0) p(`give at least one of "fill", "stroke" or "strokeWidth".`);
+      if (command3.fill !== void 0 && typeof command3.fill !== "string") p(`"fill" must be a CSS colour.`);
+      if (command3.stroke !== void 0 && typeof command3.stroke !== "string") p(`"stroke" must be a CSS colour.`);
+      if (command3.strokeWidth !== void 0 && !(isNum(command3.strokeWidth) && command3.strokeWidth >= 0)) p(`"strokeWidth" must be a number \u2265 0.`);
       break;
     case "play":
-      if (typeof command2.clip !== "string" || !command2.clip) p(`"clip" must be the name of one of the scene's clips.`);
-      if (command2.speed !== void 0 && !(isNum(command2.speed) && command2.speed >= 0.05 && command2.speed <= 20)) p(`"speed" must be a number from 0.05 to 20 (2 plays the clip twice as fast).`);
+      if (typeof command3.clip !== "string" || !command3.clip) p(`"clip" must be the name of one of the scene's clips.`);
+      if (command3.speed !== void 0 && !(isNum(command3.speed) && command3.speed >= 0.05 && command3.speed <= 20)) p(`"speed" must be a number from 0.05 to 20 (2 plays the clip twice as fast).`);
       break;
     case "morph":
     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"}.`);
+      if (typeof command3.into !== "string" || !command3.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.`);
-      if (command2.rotate !== void 0 && typeof command2.rotate !== "boolean") p(`"rotate" must be true or false.`);
+      if (typeof command3.path !== "string" || !command3.path) p(`"path" must be the id of a path node.`);
+      if (command3.rotate !== void 0 && typeof command3.rotate !== "boolean") p(`"rotate" must be true or false.`);
       fraction("from");
       fraction("to");
       break;
@@ -366,22 +377,22 @@ function commandShapeProblems(command2, where) {
     case "color-pulse":
       optionalNumber("amount");
       optionalNumber("angle");
-      if (command2.count !== void 0 && !(Number.isInteger(command2.count) && command2.count >= 1)) p(`"count" must be a whole number \u2265 1.`);
-      if (command2.axis !== void 0 && command2.axis !== "horizontal" && command2.axis !== "vertical") p(`"axis" must be "horizontal" or "vertical".`);
-      if (command2.color !== void 0 && typeof command2.color !== "string") p(`"color" must be a CSS colour.`);
-      if (command2.paint !== void 0 && command2.paint !== "fill" && command2.paint !== "stroke") p(`"paint" must be "fill" or "stroke".`);
+      if (command3.count !== void 0 && !(Number.isInteger(command3.count) && command3.count >= 1)) p(`"count" must be a whole number \u2265 1.`);
+      if (command3.axis !== void 0 && command3.axis !== "horizontal" && command3.axis !== "vertical") p(`"axis" must be "horizontal" or "vertical".`);
+      if (command3.color !== void 0 && typeof command3.color !== "string") p(`"color" must be a CSS colour.`);
+      if (command3.paint !== void 0 && command3.paint !== "fill" && command3.paint !== "stroke") p(`"paint" must be "fill" or "stroke".`);
       break;
     case "wiggle":
       optionalNumber("amount");
       optionalNumber("rotate");
-      if (command2.frequency !== void 0 && !(isNum(command2.frequency) && command2.frequency > 0)) p(`"frequency" must be a number of Hz > 0.`);
-      if (command2.octaves !== void 0 && !(Number.isInteger(command2.octaves) && command2.octaves >= 1 && command2.octaves <= 8)) p(`"octaves" must be a whole number from 1 to 8.`);
-      if (command2.seed !== void 0 && !(Number.isInteger(command2.seed) && command2.seed >= 0)) p(`"seed" must be a whole number \u2265 0.`);
+      if (command3.frequency !== void 0 && !(isNum(command3.frequency) && command3.frequency > 0)) p(`"frequency" must be a number of Hz > 0.`);
+      if (command3.octaves !== void 0 && !(Number.isInteger(command3.octaves) && command3.octaves >= 1 && command3.octaves <= 8)) p(`"octaves" must be a whole number from 1 to 8.`);
+      if (command3.seed !== void 0 && !(Number.isInteger(command3.seed) && command3.seed >= 0)) p(`"seed" must be a whole number \u2265 0.`);
       break;
     case "effect":
-      if (typeof command2.effect !== "string" || !command2.effect) p(`"effect" must be the id of one of the node's effects.`);
-      if (typeof command2.param !== "string" || !command2.param) p(`"param" must name a numeric parameter of the effect.`);
-      if (!isNum(command2.to)) p(`"to" must be a number.`);
+      if (typeof command3.effect !== "string" || !command3.effect) p(`"effect" must be the id of one of the node's effects.`);
+      if (typeof command3.param !== "string" || !command3.param) p(`"param" must name a numeric parameter of the effect.`);
+      if (!isNum(command3.to)) p(`"to" must be a number.`);
       break;
   }
   return problems;
@@ -398,9 +409,9 @@ function clipsShapeProblems(clips) {
     }
     unknownKeys(clip, ["description", "run"], where, problems);
     if (clip.description !== void 0 && typeof clip.description !== "string") problems.push(`${where}: "description" must be a string.`);
-    clip.run.forEach((command2, i) => {
-      if (isObject(command2) && command2.type === "play") problems.push(`${where}, command ${i + 1}: a clip cannot play another clip; copy its commands in instead.`);
-      else problems.push(...commandShapeProblems(command2, `${where}, command ${i + 1}`));
+    clip.run.forEach((command3, i) => {
+      if (isObject(command3) && command3.type === "play") problems.push(`${where}, command ${i + 1}: a clip cannot play another clip; copy its commands in instead.`);
+      else problems.push(...commandShapeProblems(command3, `${where}, command ${i + 1}`));
     });
   }
   return problems;
@@ -456,7 +467,7 @@ function shotShapeProblems(shot, where) {
     }
   }
   if (!Array.isArray(shot.run)) problems.push(`${name}: "run" must be a list of commands (it may be empty).`);
-  else shot.run.forEach((command2, i) => problems.push(...commandShapeProblems(command2, `${name}, command ${i + 1}`)));
+  else shot.run.forEach((command3, i) => problems.push(...commandShapeProblems(command3, `${name}, command ${i + 1}`)));
   return problems;
 }
 function motionSceneShapeProblems(input) {
@@ -523,7 +534,7 @@ function motionSceneToJson(scene, space = 2) {
   return JSON.stringify(scene, null, space);
 }
 var isMotionShot = (shot) => shotShapeProblems(shot, "Shot").length === 0;
-var isMotionCommand = (command2) => commandShapeProblems(command2, "Command").length === 0;
+var isMotionCommand = (command3) => commandShapeProblems(command3, "Command").length === 0;
 
 // src/animation-editor/match.ts
 var SEPARATOR = /[-_/.:]/;
@@ -611,6 +622,87 @@ function smoothMotionTimes(points, start, duration, pacing = "even") {
   return times;
 }
 
+// src/animation-editor/text.ts
+function motionTextLayout(nodes, id) {
+  const group = nodes.get(id)?.node;
+  if (!group || group.type !== "group") return null;
+  const letters = collectPathNodes(group).map((p) => ({ id: p.id, b: nodes.get(p.id)?.bounds })).filter((l) => !!l.b && l.b.width + l.b.height > 0);
+  if (!letters.length) return null;
+  const lines = [];
+  for (const l of [...letters].sort((a, c) => a.b.y + a.b.height / 2 - (c.b.y + c.b.height / 2))) {
+    const cy = l.b.y + l.b.height / 2;
+    const line = lines.find((x) => cy >= x.top && cy <= x.bottom);
+    if (line) {
+      line.letters.push(l);
+      line.top = Math.min(line.top, l.b.y);
+      line.bottom = Math.max(line.bottom, l.b.y + l.b.height);
+    } else lines.push({ top: l.b.y, bottom: l.b.y + l.b.height, letters: [l] });
+  }
+  lines.sort((a, c) => a.top - c.top);
+  return {
+    lines: lines.map((line) => {
+      const row = [...line.letters].sort((a, c) => a.b.x - c.b.x);
+      const heights = row.map((l) => l.b.height).sort((a, c) => a - c);
+      const gap = heights[Math.floor(heights.length / 2)] * 0.35;
+      const words = [];
+      row.forEach((l, i) => {
+        const prev = row[i - 1];
+        if (!prev || l.b.x - (prev.b.x + prev.b.width) > gap) words.push({ letters: [] });
+        words[words.length - 1].letters.push(l.id);
+      });
+      return { words };
+    })
+  };
+}
+function motionTextUnits(layout, by) {
+  if (by === "line") return layout.lines.map((l) => l.words.flatMap((w) => w.letters));
+  if (by === "word") return layout.lines.flatMap((l) => l.words.map((w) => w.letters));
+  return layout.lines.flatMap((l) => l.words.flatMap((w) => w.letters.map((id) => [id])));
+}
+function motionCascade(units, cascade = "forward", seed = 1) {
+  const n = units.length;
+  const mid = (n - 1) / 2;
+  const indexed = units.map((u, i) => ({ u, i }));
+  if (cascade === "backward") return [...units].reverse();
+  if (cascade === "center") return indexed.sort((a, b) => Math.abs(a.i - mid) - Math.abs(b.i - mid) || a.i - b.i).map((x) => x.u);
+  if (cascade === "edges") return indexed.sort((a, b) => Math.abs(b.i - mid) - Math.abs(a.i - mid) || a.i - b.i).map((x) => x.u);
+  if (cascade === "random") {
+    let s = seed >>> 0 || 1;
+    const rand = () => {
+      s = s + 1831565813 >>> 0;
+      let t = s;
+      t = Math.imul(t ^ t >>> 15, t | 1);
+      t ^= t + Math.imul(t ^ t >>> 7, t | 61);
+      return ((t ^ t >>> 14) >>> 0) / 4294967296;
+    };
+    const out = [...units];
+    for (let i = n - 1; i > 0; i--) {
+      const j = Math.floor(rand() * (i + 1));
+      [out[i], out[j]] = [out[j], out[i]];
+    }
+    return out;
+  }
+  return [...units];
+}
+var MOTION_TEXT_STAGGER = { letter: 40, word: 120, line: 300 };
+function motionCommandSlots(nodes, command3) {
+  if (!command3.split) return { slots: command3.targets.map((id, k) => ({ id, slot: k })), stagger: command3.stagger ?? 0 };
+  const slots = [];
+  let slot = 0;
+  for (const target of command3.targets) {
+    const layout = motionTextLayout(nodes, target);
+    if (!layout) {
+      slots.push({ id: target, slot: slot++ });
+      continue;
+    }
+    for (const unit of motionCascade(motionTextUnits(layout, command3.split), command3.cascade, motionSeedFromId(target))) {
+      for (const id of unit) slots.push({ id, slot });
+      slot++;
+    }
+  }
+  return { slots, stagger: command3.stagger ?? MOTION_TEXT_STAGGER[command3.split] };
+}
+
 // src/animation-editor/compile.ts
 var indexCache = /* @__PURE__ */ new WeakMap();
 function indexMotionNodes(nodes) {
@@ -886,13 +978,13 @@ function motionDriverSources(timeline, node, properties, seen = /* @__PURE__ */
   }
   return out;
 }
-function motionCommandRepeat(command2) {
-  if (command2.type === "wait" || command2.type === "enter" || command2.type === "exit") return 1;
-  const n = command2.repeat ?? 1;
+function motionCommandRepeat(command3) {
+  if (command3.type === "wait" || command3.type === "enter" || command3.type === "exit") return 1;
+  const n = command3.repeat ?? 1;
   return Number.isInteger(n) && n >= 1 ? n : 1;
 }
-function motionCommandDuration(command2, scene, target) {
-  return motionCycleDuration(command2, scene, target) * motionCommandRepeat(command2);
+function motionCommandDuration(command3, scene, target) {
+  return motionCycleDuration(command3, scene, target) * motionCommandRepeat(command3);
 }
 function motionClipLayout(scene, clip, target, speed = 1) {
   const run = scene.clips?.[clip]?.run;
@@ -909,36 +1001,36 @@ function motionClipLayout(scene, clip, target, speed = 1) {
       return;
     }
     if (raw.type === "play") return;
-    const command2 = { ...raw, targets: raw.targets.map((t) => t === MOTION_CLIP_TARGET ? target : t) };
-    const begin = base + (command2.delay ?? 0) * f;
+    const command3 = { ...raw, targets: raw.targets.map((t) => t === MOTION_CLIP_TARGET ? target : t) };
+    const begin = base + (command3.delay ?? 0) * f;
     let end = begin;
-    command2.targets.forEach((t, k) => {
-      const cycle = motionCycleDuration(command2, scene, t) * f;
-      const s = begin + k * (command2.stagger ?? 0) * f;
-      items.push({ command: command2, target: t, start: s, cycle });
-      end = Math.max(end, s + cycle * motionCommandRepeat(command2));
+    command3.targets.forEach((t, k) => {
+      const cycle = motionCycleDuration(command3, scene, t) * f;
+      const s = begin + k * (command3.stagger ?? 0) * f;
+      items.push({ command: command3, target: t, start: s, cycle });
+      end = Math.max(end, s + cycle * motionCommandRepeat(command3));
     });
     prevStart = begin;
     runEnd = Math.max(runEnd, end);
   });
   return { items, length: runEnd };
 }
-function motionCycleDuration(command2, scene, target) {
-  if (command2.type === "wait") return command2.duration;
-  if (command2.type === "play") return motionClipLayout(scene, command2.clip, target ?? MOTION_CLIP_TARGET, command2.speed).length;
-  if (command2.duration !== void 0) return command2.duration;
-  if (command2.ease !== void 0) {
-    const ease = resolveEasing(command2.ease);
+function motionCycleDuration(command3, scene, target) {
+  if (command3.type === "wait") return command3.duration;
+  if (command3.type === "play") return motionClipLayout(scene, command3.clip, target ?? MOTION_CLIP_TARGET, command3.speed).length;
+  if (command3.duration !== void 0) return command3.duration;
+  if (command3.ease !== void 0) {
+    const ease = resolveEasing(command3.ease);
     if (ease !== "hold" && ease.type === "spring") return springSettleMs(ease);
   }
-  if (command2.type === "draw" || command2.type === "enter" && command2.style === "draw" || command2.type === "exit" && command2.style === "undraw") {
+  if (command3.type === "draw" || command3.type === "enter" && command3.style === "draw" || command3.type === "exit" && command3.style === "undraw") {
     const entry = target ? indexMotionNodes(scene.artwork.nodes).get(target) : void 0;
     const length = entry ? motionPathLength(entry.node) : 0;
     const ms = length * MOTION_DRAW_MS_PER_UNIT;
     return Math.round(Math.min(MOTION_DRAW_RANGE[1], Math.max(MOTION_DRAW_RANGE[0], ms)));
   }
-  if (command2.type === "move" && command2.via?.length) return MOTION_DEFAULT_DURATIONS.move + 400 * command2.via.length;
-  return MOTION_DEFAULT_DURATIONS[command2.type];
+  if (command3.type === "move" && command3.via?.length) return MOTION_DEFAULT_DURATIONS.move + 400 * command3.via.length;
+  return MOTION_DEFAULT_DURATIONS[command3.type];
 }
 var MOTION_EASE_OUT = { type: "cubic-bezier", x1: 1 / 3, y1: 1, x2: 2 / 3, y2: 1 };
 var MOTION_EASE_IN_OUT = { type: "cubic-bezier", x1: 0.65, y1: 0, x2: 0.35, y2: 1 };
@@ -974,14 +1066,15 @@ function compileMotionScene(scene) {
     const commandsStart = cursor;
     let runEnd = cursor;
     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) * f);
-      const targets = command2.type === "wait" ? [] : command2.targets;
-      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 });
+    shot.run.forEach((command3, i) => {
+      const base = command3.with === "previous" && i > 0 ? prevStart : runEnd;
+      const begin = base + (command3.type === "wait" ? 0 : (command3.delay ?? 0) * f);
+      const split = command3.type === "wait" ? null : motionCommandSlots(nodes, command3);
+      const slots = split?.slots ?? [];
+      const durations = command3.type === "wait" ? [command3.duration * f] : slots.map((s) => motionCommandDuration(command3, scene, s.id) * f);
+      const stagger = (split?.stagger ?? 0) * f;
+      const end2 = durations.reduce((m, d, k) => Math.max(m, begin + (slots[k]?.slot ?? k) * stagger + d), begin);
+      commands.push({ shot: shot.id, shotIndex: index, command: i, type: command3.type, start: begin, end: end2, duration: durations[0] ?? 0 });
       prevStart = begin;
       runEnd = Math.max(runEnd, end2);
     });
@@ -1013,14 +1106,14 @@ function compileMotionScene(scene) {
   }
   for (const timing of commands) {
     const shot = scene.shots[timing.shotIndex];
-    const command2 = shot.run[timing.command];
-    if (command2.type === "wait") continue;
-    if (command2.type === "play") {
+    const command3 = shot.run[timing.command];
+    if (command3.type === "wait") continue;
+    if (command3.type === "play") {
       const f = motionShotTimeScale(shot);
-      command2.targets.forEach((target, k) => {
+      command3.targets.forEach((target, k) => {
         if (!nodes.has(target)) return;
-        const at = timing.start + k * (command2.stagger ?? 0) * f;
-        for (const item of motionClipLayout(scene, command2.clip, target, (command2.speed ?? 1) / f).items) {
+        const at = timing.start + k * (command3.stagger ?? 0) * f;
+        for (const item of motionClipLayout(scene, command3.clip, target, (command3.speed ?? 1) / f).items) {
           const entry = nodes.get(item.target);
           if (!entry) continue;
           jobs.push({ start: at + item.start, order: order++, run: () => compileRepeated(item.command, item.target, entry, at + item.start, item.cycle, timing) });
@@ -1028,24 +1121,25 @@ function compileMotionScene(scene) {
       });
       continue;
     }
-    command2.targets.forEach((target, k) => {
+    const split = motionCommandSlots(nodes, command3);
+    for (const { id: target, slot } of split.slots) {
       const entry = nodes.get(target);
-      if (!entry) return;
+      if (!entry) continue;
       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) });
-    });
+      const start = timing.start + slot * split.stagger * f;
+      const cycle = motionCycleDuration(command3, scene, target) * f;
+      jobs.push({ start, order: order++, run: () => compileRepeated(command3, target, entry, start, cycle, timing) });
+    }
   }
   jobs.sort((a, b) => a.start - b.start || a.order - b.order).forEach((job) => job.run());
-  function compileRepeated(command2, node, entry, start, cycle, timing) {
+  function compileRepeated(command3, node, entry, start, cycle, timing) {
     const first = segments.length;
-    compileCommand(command2, node, entry, start, cycle, timing);
+    compileCommand(command3, node, entry, start, cycle, timing);
     const made = segments.slice(first);
-    const steps = command2.steps ?? scene.steps;
+    const steps = command3.steps ?? scene.steps;
     if (steps && steps > 0) for (const s of made) s.steps = steps;
-    const n = motionCommandRepeat(command2);
-    const mode = command2.repeatMode ?? "loop";
+    const n = motionCommandRepeat(command3);
+    const mode = command3.repeatMode ?? "loop";
     const shift = (v, by, k) => {
       if (typeof v === "number" && typeof by === "number") return v + by * k;
       if (Array.isArray(v) && Array.isArray(by) && v.length === by.length) return v.map((x, i) => x + by[i] * k);
@@ -1064,16 +1158,16 @@ function compileMotionScene(scene) {
       }
     }
   }
-  function compileCommand(command2, node, entry, start, duration2, timing) {
+  function compileCommand(command3, node, entry, start, duration2, timing) {
     const end = start + duration2;
     const where = { shot: timing.shot, command: timing.command };
     const seg = (property, to, ease2, s = start, e = end, extra = {}) => push({ node, property, start: s, end: e, from: extra.from ?? valueAt(node, property, s), to, ease: ease2, ...where, ...extra });
     const rest = (p) => motionRestValue(entry, p, artwork);
-    const num = (p, time = start) => {
+    const num2 = (p, time = start) => {
       const v = valueAt(node, p, time);
       return typeof v === "number" ? v : 0;
     };
-    const ease = command2.ease;
+    const ease = command3.ease;
     const drawWindows = (s, e, o) => {
       const order2 = o.order ?? "together";
       const pace = o.pace ?? "time";
@@ -1111,11 +1205,11 @@ function compileMotionScene(scene) {
         return o.align === "end" ? { id: p.id, start: e - d, end: e } : { id: p.id, start: s, end: s + d };
       });
     };
-    switch (command2.type) {
+    switch (command3.type) {
       case "enter": {
-        const style = command2.style ?? "fade";
+        const style = command3.style ?? "fade";
         const opacity = rest("opacity");
-        const reveal = style === "wipe" ? motionRevealClip(entry, { style, direction: command2.direction }) : style === "iris" ? motionRevealClip(entry, { style, shape: command2.shape }) : style === "split" ? motionRevealClip(entry, { style, orientation: command2.orientation }) : null;
+        const reveal = style === "wipe" ? motionRevealClip(entry, { style, direction: command3.direction }) : style === "iris" ? motionRevealClip(entry, { style, shape: command3.shape }) : style === "split" ? motionRevealClip(entry, { style, orientation: command3.orientation }) : null;
         for (const p of ["clipRect", "clipCircle"]) if (p !== reveal?.property && tracks.has(motionTrackKey(node, p))) seg(p, rest(p), "linear", start, start);
         if (reveal) {
           seg("opacity", opacity, "linear", start, start);
@@ -1123,30 +1217,30 @@ function compileMotionScene(scene) {
           break;
         }
         if (style === "draw") {
-          const windows = drawWindows(start, start + duration2 * 0.75, command2);
+          const windows = drawWindows(start, start + duration2 * 0.75, command3);
           if (windows) for (const w of windows) push({ node: w.id, property: "drawEnd", start: w.start, end: w.end, from: 0, to: 1, ease: ease ?? MOTION_EASE_IN_OUT, ...where });
           else seg("drawEnd", 1, ease ?? MOTION_EASE_IN_OUT, start, start + duration2 * 0.75, { from: 0 });
           seg("fillOpacity", 1, MOTION_EASE_OUT, start + duration2 * 0.6, end, { from: 0 });
           break;
         }
         if (style === "pop" || style === "zoom") {
-          const from = command2.scale ?? (style === "pop" ? 0.5 : 1.6);
+          const from = command3.scale ?? (style === "pop" ? 0.5 : 1.6);
           seg("opacity", opacity, MOTION_EASE_OUT, start, start + duration2 * (style === "pop" ? 0.4 : 0.5), { from: 0 });
           seg("scaleX", 1, ease ?? (style === "pop" ? "ease-out-back" : MOTION_EASE_OUT), start, end, { from });
           seg("scaleY", 1, ease ?? (style === "pop" ? "ease-out-back" : MOTION_EASE_OUT), start, end, { from });
         } else if (style === "rise") {
-          const y = num("y");
+          const y = num2("y");
           seg("opacity", opacity, MOTION_EASE_OUT, start, start + duration2 * 0.5, { from: 0 });
-          seg("y", y, ease ?? "ease-out-back", start, end, { from: y + (command2.distance ?? 20) });
+          seg("y", y, ease ?? "ease-out-back", start, end, { from: y + (command3.distance ?? 20) });
         } else if (style === "grow") {
           seg("opacity", opacity, MOTION_EASE_OUT, start, start + duration2 * 0.3, { from: 0 });
           seg("scaleX", 1, ease ?? MOTION_EASE_OUT, start, end, { from: 0 });
           seg("scaleY", 1, ease ?? MOTION_EASE_OUT, start, end, { from: 0 });
         } else if (style === "slide") {
-          const dir = DIRECTION[command2.direction ?? "up"];
-          const distance = command2.distance ?? 40;
-          const x = num("x");
-          const y = num("y");
+          const dir = DIRECTION[command3.direction ?? "up"];
+          const distance = command3.distance ?? 40;
+          const x = num2("x");
+          const y = num2("y");
           seg("opacity", opacity, MOTION_EASE_OUT, start, end, { from: 0 });
           seg("x", x, ease ?? MOTION_EASE_OUT, start, end, { from: x - dir.x * distance });
           seg("y", y, ease ?? MOTION_EASE_OUT, start, end, { from: y - dir.y * distance });
@@ -1154,12 +1248,12 @@ function compileMotionScene(scene) {
         break;
       }
       case "exit": {
-        const style = command2.style ?? "fade";
-        const wipe = style === "wipe" ? motionRevealClip(entry, { style, direction: command2.direction, hide: true }) : null;
+        const style = command3.style ?? "fade";
+        const wipe = style === "wipe" ? motionRevealClip(entry, { style, direction: command3.direction, hide: true }) : null;
         if (wipe) seg(wipe.property, wipe.to, ease ?? "ease-in", start, end, { from: wipe.from });
         else if (style === "undraw") {
           seg("fillOpacity", 0, "ease-in", start, start + duration2 * 0.4);
-          const windows = drawWindows(start, end, command2);
+          const windows = drawWindows(start, end, command3);
           if (windows) for (const w of windows) push({ node: w.id, property: "drawEnd", start: w.start, end: w.end, from: valueAt(w.id, "drawEnd", w.start), to: 0, ease: ease ?? MOTION_EASE_IN_OUT, ...where });
           else seg("drawEnd", 0, ease ?? MOTION_EASE_IN_OUT);
         } else if (style === "shrink") {
@@ -1167,18 +1261,18 @@ function compileMotionScene(scene) {
           seg("scaleY", 0, ease ?? "ease-in");
           seg("opacity", 0, "ease-in", start + duration2 * 0.6, end);
         } else if (style === "slide") {
-          const dir = DIRECTION[command2.direction ?? "down"];
-          const distance = command2.distance ?? 40;
-          seg("x", num("x") + dir.x * distance, ease ?? "ease-in");
-          seg("y", num("y") + dir.y * distance, ease ?? "ease-in");
+          const dir = DIRECTION[command3.direction ?? "down"];
+          const distance = command3.distance ?? 40;
+          seg("x", num2("x") + dir.x * distance, ease ?? "ease-in");
+          seg("y", num2("y") + dir.y * distance, ease ?? "ease-in");
           seg("opacity", 0, ease ?? "ease-in");
         } else seg("opacity", 0, ease ?? "ease-in");
         break;
       }
       case "draw": {
         const e = ease ?? MOTION_EASE_IN_OUT;
-        const comet = command2.comet !== void 0 ? Math.min(1, Math.max(0, command2.comet)) : void 0;
-        const windows = drawWindows(start, end, command2) ?? [{ id: node, start, end }];
+        const comet = command3.comet !== void 0 ? Math.min(1, Math.max(0, command3.comet)) : void 0;
+        const windows = drawWindows(start, end, command3) ?? [{ id: node, start, end }];
         for (const w of windows) {
           if (comet !== void 0) {
             push({ node: w.id, property: "drawEnd", start: w.start, end: w.end, from: 0, to: 1 + comet, ease: e, ...where });
@@ -1186,27 +1280,27 @@ function compileMotionScene(scene) {
             continue;
           }
           const drawn = tracks.has(motionTrackKey(w.id, "drawEnd"));
-          push({ node: w.id, property: "drawEnd", start: w.start, end: w.end, from: command2.from ?? (drawn ? valueAt(w.id, "drawEnd", w.start) : 0), to: command2.to ?? 1, ease: e, ...where });
+          push({ node: w.id, property: "drawEnd", start: w.start, end: w.end, from: command3.from ?? (drawn ? valueAt(w.id, "drawEnd", w.start) : 0), to: command3.to ?? 1, ease: e, ...where });
         }
         break;
       }
       case "move": {
         const e = ease ?? MOTION_EASE_IN_OUT;
-        let dx = command2.by?.x ?? 0;
-        let dy = command2.by?.y ?? 0;
-        if (command2.to) {
+        let dx = command3.by?.x ?? 0;
+        let dy = command3.by?.y ?? 0;
+        if (command3.to) {
           const inv = invertMatrix(entry.parentWorld);
-          const target = applyMatrix(inv, command2.to);
-          dx = target.x - (entry.center.x + num("x"));
-          dy = target.y - (entry.center.y + num("y"));
+          const target = applyMatrix(inv, command3.to);
+          dx = target.x - (entry.center.x + num2("x"));
+          dy = target.y - (entry.center.y + num2("y"));
         }
-        if (command2.via?.length) {
+        if (command3.via?.length) {
           const inv = invertMatrix(entry.parentWorld);
-          const x0 = num("x");
-          const y0 = num("y");
-          const add = command2.blend === "add";
-          const offsets = [{ x: 0, y: 0 }, ...command2.via.map((p) => applyMatrix(inv, p)).map((p) => ({ x: p.x - entry.center.x - x0, y: p.y - entry.center.y - y0 })), { x: dx, y: dy }];
-          const times = smoothMotionTimes(offsets, start, end - start, command2.pacing ?? "even");
+          const x0 = num2("x");
+          const y0 = num2("y");
+          const add = command3.blend === "add";
+          const offsets = [{ x: 0, y: 0 }, ...command3.via.map((p) => applyMatrix(inv, p)).map((p) => ({ x: p.x - entry.center.x - x0, y: p.y - entry.center.y - y0 })), { x: dx, y: dy }];
+          const times = smoothMotionTimes(offsets, start, end - start, command3.pacing ?? "even");
           for (const axis of ["x", "y"]) {
             const base = add ? 0 : axis === "x" ? x0 : y0;
             for (const leg of smoothMotionLegs(times, offsets.map((o) => o[axis])))
@@ -1214,42 +1308,42 @@ function compileMotionScene(scene) {
           }
           break;
         }
-        if (command2.blend === "add") {
+        if (command3.blend === "add") {
           seg("x", dx, e, start, end, { from: 0, blend: "add" });
           seg("y", dy, e, start, end, { from: 0, blend: "add" });
         } else {
-          seg("x", num("x") + dx, e);
-          seg("y", num("y") + dy, e);
+          seg("x", num2("x") + dx, e);
+          seg("y", num2("y") + dy, e);
         }
         break;
       }
       case "rotate": {
         const e = ease ?? MOTION_EASE_IN_OUT;
-        if (command2.blend === "add") seg("rotation", command2.to !== void 0 ? command2.to - num("rotation") : command2.by ?? 0, e, start, end, { from: 0, blend: "add" });
-        else seg("rotation", command2.to ?? num("rotation") + (command2.by ?? 0), e);
+        if (command3.blend === "add") seg("rotation", command3.to !== void 0 ? command3.to - num2("rotation") : command3.by ?? 0, e, start, end, { from: 0, blend: "add" });
+        else seg("rotation", command3.to ?? num2("rotation") + (command3.by ?? 0), e);
         break;
       }
       case "scale": {
-        const to = typeof command2.to === "number" ? { x: command2.to, y: command2.to } : command2.to;
-        const extra = { ...command2.geometric ? { geometric: true } : {}, ...command2.blend === "add" ? { from: 1, blend: "add" } : {} };
+        const to = typeof command3.to === "number" ? { x: command3.to, y: command3.to } : command3.to;
+        const extra = { ...command3.geometric ? { geometric: true } : {}, ...command3.blend === "add" ? { from: 1, blend: "add" } : {} };
         seg("scaleX", to.x, ease ?? MOTION_EASE_IN_OUT, start, end, extra);
         seg("scaleY", to.y, ease ?? MOTION_EASE_IN_OUT, start, end, extra);
         break;
       }
       case "fade":
-        seg("opacity", command2.to, ease ?? MOTION_EASE_IN_OUT);
+        seg("opacity", command3.to, ease ?? MOTION_EASE_IN_OUT);
         break;
       case "style":
-        if (command2.fill !== void 0) seg("fill", command2.fill, ease ?? MOTION_EASE_IN_OUT);
-        if (command2.stroke !== void 0) seg("stroke", command2.stroke, ease ?? MOTION_EASE_IN_OUT);
-        if (command2.strokeWidth !== void 0) seg("strokeWidth", command2.strokeWidth, ease ?? MOTION_EASE_IN_OUT);
+        if (command3.fill !== void 0) seg("fill", command3.fill, ease ?? MOTION_EASE_IN_OUT);
+        if (command3.stroke !== void 0) seg("stroke", command3.stroke, ease ?? MOTION_EASE_IN_OUT);
+        if (command3.strokeWidth !== void 0) seg("strokeWidth", command3.strokeWidth, ease ?? MOTION_EASE_IN_OUT);
         break;
       case "morph":
-        seg("shape", command2.into, ease ?? MOTION_EASE_IN_OUT);
+        seg("shape", command3.into, ease ?? MOTION_EASE_IN_OUT);
         break;
       case "match": {
-        const into = nodes.get(command2.into);
-        if (!into || command2.into === node) break;
+        const into = nodes.get(command3.into);
+        if (!into || command3.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 });
@@ -1257,7 +1351,7 @@ function compileMotionScene(scene) {
         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 });
+        seg("follow", command3.to ?? 1, ease ?? MOTION_EASE_IN_OUT, start, end, { from: command3.from ?? 0, path: command3.path, rotate: command3.rotate ?? false });
         break;
       // Emphasis: a change toward a peak that a behaviour swings round (as Flair's primitives do).
       case "pulse":
@@ -1265,33 +1359,33 @@ function compileMotionScene(scene) {
       case "teeter":
       case "wave":
       case "wiggle": {
-        const add = (command2.blend ?? "add") === "add";
+        const add = (command3.blend ?? "add") === "add";
         const swing = (p, by, extra) => {
           const scale = p === "scaleX" || p === "scaleY";
           if (add) seg(p, by, ease ?? "linear", start, end, { from: scale ? 1 : 0, blend: "add", ...extra });
-          else seg(p, scale ? num(p) * by : num(p) + by, ease ?? "linear", start, end, extra);
+          else seg(p, scale ? num2(p) * by : num2(p) + by, ease ?? "linear", start, end, extra);
         };
-        if (command2.type === "pulse") {
-          const behavior = { type: "pulse", count: command2.count ?? 1 };
-          swing("scaleX", 1 + (command2.amount ?? 0.15), { behavior });
-          swing("scaleY", 1 + (command2.amount ?? 0.15), { behavior });
-        } else if (command2.type === "shake") swing(command2.axis === "vertical" ? "y" : "x", command2.amount ?? 8, { behavior: { type: "oscillate", count: command2.count ?? 3, decay: 1 } });
-        else if (command2.type === "teeter") swing("rotation", command2.angle ?? 8, { behavior: { type: "oscillate", count: command2.count ?? 3, decay: 1 } });
-        else if (command2.type === "wave") swing("y", -(command2.amount ?? 6), { behavior: { type: "oscillate", count: command2.count ?? 2 } });
+        if (command3.type === "pulse") {
+          const behavior = { type: "pulse", count: command3.count ?? 1 };
+          swing("scaleX", 1 + (command3.amount ?? 0.15), { behavior });
+          swing("scaleY", 1 + (command3.amount ?? 0.15), { behavior });
+        } else if (command3.type === "shake") swing(command3.axis === "vertical" ? "y" : "x", command3.amount ?? 8, { behavior: { type: "oscillate", count: command3.count ?? 3, decay: 1 } });
+        else if (command3.type === "teeter") swing("rotation", command3.angle ?? 8, { behavior: { type: "oscillate", count: command3.count ?? 3, decay: 1 } });
+        else if (command3.type === "wave") swing("y", -(command3.amount ?? 6), { behavior: { type: "oscillate", count: command3.count ?? 2 } });
         else {
-          const behavior = { type: "wriggle", frequency: command2.frequency ?? 3, octaves: command2.octaves ?? 2, seed: command2.seed || motionSeedFromId(node) };
-          const amount = command2.amount ?? 6;
+          const behavior = { type: "wriggle", frequency: command3.frequency ?? 3, octaves: command3.octaves ?? 2, seed: command3.seed || motionSeedFromId(node) };
+          const amount = command3.amount ?? 6;
           swing("x", amount, { behavior, index: 0 });
           swing("y", amount, { behavior, index: 1 });
-          if (command2.rotate) swing("rotation", command2.rotate, { behavior, index: 2 });
+          if (command3.rotate) swing("rotation", command3.rotate, { behavior, index: 2 });
         }
         break;
       }
       case "color-pulse":
-        seg(command2.paint ?? "fill", command2.color ?? "#f59e0b", ease ?? "linear", start, end, { behavior: { type: "pulse", count: command2.count ?? 1 } });
+        seg(command3.paint ?? "fill", command3.color ?? "#f59e0b", ease ?? "linear", start, end, { behavior: { type: "pulse", count: command3.count ?? 1 } });
         break;
       case "effect":
-        seg(`effect:${command2.effect}:${command2.param}`, command2.to, ease ?? MOTION_EASE_IN_OUT);
+        seg(`effect:${command3.effect}:${command3.param}`, command3.to, ease ?? MOTION_EASE_IN_OUT);
         break;
     }
   }
@@ -1682,24 +1776,24 @@ function usesColor(scene, color) {
   return found;
 }
 function visibleAt(timeline, id, time, node) {
-  const num = (p, rest) => {
+  const num2 = (p, rest) => {
     const v = trackValue(timeline.tracks.get(motionTrackKey(id, p)), time);
     return typeof v === "number" ? v : rest;
   };
   if (node.visible === false) return false;
-  if (num("opacity", node.opacity ?? 1) <= 0.01) return false;
-  if (Math.abs(num("scaleX", 1) * num("scaleY", 1)) <= 1e-4) return false;
+  if (num2("opacity", node.opacity ?? 1) <= 0.01) return false;
+  if (Math.abs(num2("scaleX", 1) * num2("scaleY", 1)) <= 1e-4) return false;
   const clip = (p) => trackValue(timeline.tracks.get(motionTrackKey(id, p)), time);
   const rect = clip("clipRect");
   if (Array.isArray(rect) && (rect[2] <= 1e-4 || rect[3] <= 1e-4)) return false;
   const circle = clip("clipCircle");
   if (Array.isArray(circle) && circle[2] <= 1e-4) return false;
   const hasFill = node.type === "path" ? !!node.fill && node.fill !== "none" : collectPathNodes(node).some((p) => p.fill && p.fill !== "none");
-  const drawn = num("drawEnd", 1) > 0.01 && (node.type === "path" || collectPathNodes(node).length === 0 || collectPathNodes(node).some((p) => {
+  const drawn = num2("drawEnd", 1) > 0.01 && (node.type === "path" || collectPathNodes(node).length === 0 || collectPathNodes(node).some((p) => {
     const v = trackValue(timeline.tracks.get(motionTrackKey(p.id, "drawEnd")), time);
     return typeof v !== "number" || v > 0.01;
   }));
-  return drawn || hasFill && num("fillOpacity", 1) > 0.01;
+  return drawn || hasFill && num2("fillOpacity", 1) > 0.01;
 }
 function checkMotionScene(scene) {
   const issues = [];
@@ -1727,48 +1821,53 @@ function checkMotionScene(scene) {
         issues.push(motionIssue("camera-aspect", `The camera is ${c.width} \xD7 ${c.height}, a different shape from the ${scene.artwork.width} \xD7 ${scene.artwork.height} artwork, so it shows bands at the sides; frame a node instead to match.`, { shot: shot.id }));
     }
     if (!shot.run.length && !shot.camera && shotIndex2 > 0) issues.push(motionIssue("empty-shot", "This shot only holds; add commands or a camera move, or remove it.", { shot: shot.id }));
-    shot.run.forEach((command2, i) => {
+    shot.run.forEach((command3, i) => {
       const where = { shot: shot.id, command: i };
-      if (command2.type === "wait") return;
-      const targets = command2.targets.filter((id) => known(id, "unknown-target", "node", where));
+      if (command3.type === "wait") return;
+      const targets = command3.targets.filter((id) => known(id, "unknown-target", "node", where));
       const timing = timeline.commands.find((c) => c.shot === shot.id && c.command === i);
       if (timing && timing.duration > 0 && timing.duration < MOTION_MIN_CHANGE_MS)
-        issues.push(motionIssue("too-fast", `This ${command2.type} lasts ${timing.duration} ms, too quick to follow; make it at least ${MOTION_MIN_CHANGE_MS} ms.`, { ...where, measured: timing.duration, needed: MOTION_MIN_CHANGE_MS, unit: "ms", ids: targets }));
-      if (command2.duration !== void 0 && command2.ease !== void 0) {
-        const ease = resolveEasing(command2.ease);
+        issues.push(motionIssue("too-fast", `This ${command3.type} lasts ${timing.duration} ms, too quick to follow; make it at least ${MOTION_MIN_CHANGE_MS} ms.`, { ...where, measured: timing.duration, needed: MOTION_MIN_CHANGE_MS, unit: "ms", ids: targets }));
+      if (command3.duration !== void 0 && command3.ease !== void 0) {
+        const ease = resolveEasing(command3.ease);
         if (ease !== "hold" && ease.type === "spring") {
           const settle = springSettleMs(ease);
-          if (command2.duration < settle * 0.9)
-            issues.push(motionIssue("spring-cut-short", `This ${command2.type}'s spring takes ${settle} ms to settle but lasts ${command2.duration} ms, so it jumps to its end; leave "duration" out (the spring sets it) or make it at least ${settle} ms.`, { ...where, measured: command2.duration, needed: settle, unit: "ms", ids: targets }));
+          if (command3.duration < settle * 0.9)
+            issues.push(motionIssue("spring-cut-short", `This ${command3.type}'s spring takes ${settle} ms to settle but lasts ${command3.duration} ms, so it jumps to its end; leave "duration" out (the spring sets it) or make it at least ${settle} ms.`, { ...where, measured: command3.duration, needed: settle, unit: "ms", ids: targets }));
         }
       }
-      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 === "play" && !scene.clips?.[command2.clip])
-        issues.push(motionIssue("unknown-clip", `There is no clip ${namedWithSuggestion(command2.clip, Object.keys(scene.clips ?? {}))}; define it with set_animation_clip.`, where));
-      if (command2.type === "match" && known(command2.into, "unknown-shape", "group", where)) {
-        const into = nodes.get(command2.into);
+      if (command3.type === "follow" && known(command3.path, "unknown-path", "path", where) && nodes.get(command3.path).node.type !== "path")
+        issues.push(motionIssue("not-a-path", `"${command3.path}" is a group; follow a single path node.`, { ...where, ids: [command3.path] }));
+      if (command3.type === "morph") known(command3.into, "unknown-shape", "shape", where);
+      if (command3.type !== "play" && command3.split) {
+        for (const id of targets)
+          if (!motionTextLayout(nodes, id))
+            issues.push(motionIssue("split-not-text", `"${id}" is not a group of letter paths, so "split": "${command3.split}" animates it as a whole; convert the text to outlines and group the letters (get_text_layout shows how they read).`, { ...where, ids: [id] }));
+      }
+      if (command3.type === "play" && !scene.clips?.[command3.clip])
+        issues.push(motionIssue("unknown-clip", `There is no clip ${namedWithSuggestion(command3.clip, Object.keys(scene.clips ?? {}))}; define it with set_animation_clip.`, where));
+      if (command3.type === "match" && known(command3.into, "unknown-shape", "group", where)) {
+        const into = nodes.get(command3.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] }));
+          if (id === command3.into || into.ancestors.includes(id) || entry.ancestors.includes(command3.into)) {
+            issues.push(motionIssue("match-self", `"${id}" cannot match "${command3.into}": one is the other or holds it. Match two separate groups (the second usually hidden).`, { ...where, ids: [id, command3.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 }));
+            issues.push(motionIssue("match-unpaired", `${m.unpairedInto.map((x) => `"${x}"`).join(", ")} in "${command3.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;
+      const style = command3.type === "enter" || command3.type === "exit" ? command3.style : void 0;
       if (style === "wipe" || style === "iris" || style === "split") {
         for (const id of targets)
           if (!motionRevealPadding(nodes.get(id)))
-            issues.push(motionIssue("reveal-no-box", `"${id}" has no width or height (a straight line), so a ${style} cannot clip it and it fades instead; use style "${command2.type === "enter" ? "draw" : "undraw"}" for a line.`, { ...where, ids: [id] }));
+            issues.push(motionIssue("reveal-no-box", `"${id}" has no width or height (a straight line), so a ${style} cannot clip it and it fades instead; use style "${command3.type === "enter" ? "draw" : "undraw"}" for a line.`, { ...where, ids: [id] }));
       }
-      if (command2.type === "style") {
+      if (command3.type === "style") {
         for (const key of ["fill", "stroke"]) {
-          const color = command2[key];
+          const color = command3[key];
           if (color === void 0) continue;
           if (normalizeTokenColor(color) === null) {
             issues.push(motionIssue("invalid-color", `${key} "${color}" is not a colour this editor reads; use hex ("#0ea5e9"), rgb() or rgba().`, where));
@@ -1782,9 +1881,9 @@ function checkMotionScene(scene) {
           }
         }
       }
-      if (command2.type === "color-pulse") {
-        const key = command2.paint ?? "fill";
-        const color = command2.color ?? "#f59e0b";
+      if (command3.type === "color-pulse") {
+        const key = command3.paint ?? "fill";
+        const color = command3.color ?? "#f59e0b";
         if (normalizeTokenColor(color) === null) issues.push(motionIssue("invalid-color", `color "${color}" is not a colour this editor reads; use hex ("#0ea5e9"), rgb() or rgba().`, where));
         else
           for (const id of targets) {
@@ -1794,15 +1893,15 @@ function checkMotionScene(scene) {
               issues.push(motionIssue("paint-not-color", `"${id}" has a gradient or no ${key}, so a colour pulse cannot tint it; give it a solid ${key} or pulse the ${key === "fill" ? "stroke" : "fill"}.`, { ...where, ids: [id] }));
           }
       }
-      if (command2.type === "effect") {
+      if (command3.type === "effect") {
         for (const id of targets) {
           const node = nodes.get(id).node;
-          const params = NUMERIC_PARAMS(node, command2.effect);
+          const params = NUMERIC_PARAMS(node, command3.effect);
           const effects = (node.effects ?? []).map((e) => e.id);
           if (!params)
-            issues.push(motionIssue("unknown-effect", `"${id}" has no effect ${namedWithSuggestion(command2.effect, effects)}${effects.length ? `; its effects are ${effects.map((e) => `"${e}"`).join(", ")}` : "; it has no live effects"}.`, { ...where, ids: [id] }));
-          else if (!params.includes(command2.param))
-            issues.push(motionIssue("unknown-effect-param", `Effect "${command2.effect}" has no numeric parameter ${namedWithSuggestion(command2.param, params)}; use one of ${params.join(", ")}.`, { ...where, ids: [id] }));
+            issues.push(motionIssue("unknown-effect", `"${id}" has no effect ${namedWithSuggestion(command3.effect, effects)}${effects.length ? `; its effects are ${effects.map((e) => `"${e}"`).join(", ")}` : "; it has no live effects"}.`, { ...where, ids: [id] }));
+          else if (!params.includes(command3.param))
+            issues.push(motionIssue("unknown-effect-param", `Effect "${command3.effect}" has no numeric parameter ${namedWithSuggestion(command3.param, params)}; use one of ${params.join(", ")}.`, { ...where, ids: [id] }));
         }
       }
       if (timing) {
@@ -1810,11 +1909,11 @@ function checkMotionScene(scene) {
           const node = nodes.get(id).node;
           const before = Math.max(0, timing.start - 0.5);
           const visible = timing.start > 0 ? visibleAt(timeline, id, before, node) : node.visible !== false;
-          if (command2.type === "enter" && visible && timing.start > 0)
+          if (command3.type === "enter" && visible && timing.start > 0)
             issues.push(motionIssue("enter-visible", `"${id}" is already showing when it enters, so it blinks out first; remove the enter or exit it earlier.`, { ...where, ids: [id] }));
-          const probe = command2.type === "exit" ? timing.start + 0.5 : (timing.start + timing.end) / 2;
-          if (command2.type !== "enter" && command2.type !== "draw" && !visibleAt(timeline, id, probe, node))
-            issues.push(motionIssue("exit-hidden", `"${id}" is hidden when this ${command2.type} starts, so it is not seen; enter it first.`, { ...where, ids: [id] }));
+          const probe = command3.type === "exit" ? timing.start + 0.5 : (timing.start + timing.end) / 2;
+          if (command3.type !== "enter" && command3.type !== "draw" && !visibleAt(timeline, id, probe, node))
+            issues.push(motionIssue("exit-hidden", `"${id}" is hidden when this ${command3.type} starts, so it is not seen; enter it first.`, { ...where, ids: [id] }));
         }
       }
     });
@@ -1842,9 +1941,9 @@ function checkMotionScene(scene) {
     if (loop.length) issues.push(motionIssue("driver-cycle", `Drivers follow each other round in a loop (${loop.join(" \u2190 ")}); remove one of them.`, { ids: [...new Set(loop.map((k) => k.split(".")[0]))] }));
   }
   for (const [name, clip] of Object.entries(scene.clips ?? {}))
-    for (const command2 of clip.run)
-      if (command2.type !== "wait") {
-        for (const id of command2.targets)
+    for (const command3 of clip.run)
+      if (command3.type !== "wait") {
+        for (const id of command3.targets)
           if (id !== MOTION_CLIP_TARGET && !nodes.has(id)) issues.push(motionIssue("unknown-target", `Clip "${name}" names ${namedWithSuggestion(id, [...nodes.keys()])}, which the artwork does not have; use "$" for the node the clip is played on.`, { ids: [id] }));
       }
   if (scene.trigger) {
@@ -1887,18 +1986,18 @@ function checkMotionScene(scene) {
   }
   const reported = /* @__PURE__ */ new Set();
   for (const timing of timeline.commands) {
-    const command2 = scene.shots[timing.shotIndex].run[timing.command];
-    if (command2.type === "wait" || command2.type === "exit") continue;
+    const command3 = scene.shots[timing.shotIndex].run[timing.command];
+    if (command3.type === "wait" || command3.type === "exit") continue;
     const frame = motionFrameAt(scene, timing.end);
     const cam = frame.camera;
     const docIndex = indexMotionNodes(frame.document.nodes);
-    for (const id of command2.targets) {
+    for (const id of command3.targets) {
       const b = docIndex.get(id)?.bounds;
       if (!b || reported.has(id) || !visibleAt(timeline, id, timing.end, nodes.get(id).node)) continue;
       const outside = b.x + b.width < cam.x || b.y + b.height < cam.y || b.x > cam.x + cam.width || b.y > cam.y + cam.height;
       if (outside) {
         reported.add(id);
-        issues.push(motionIssue("out-of-frame", `"${id}" is outside the camera when this ${command2.type} ends, so it is not seen; move it into frame or move the camera.`, { shot: timing.shot, command: timing.command, ids: [id] }));
+        issues.push(motionIssue("out-of-frame", `"${id}" is outside the camera when this ${command3.type} ends, so it is not seen; move it into frame or move the camera.`, { shot: timing.shot, command: timing.command, ids: [id] }));
       }
     }
   }
@@ -2052,8 +2151,8 @@ function applyOne(scene, edit) {
     case "add_commands": {
       const i = shotIndex(scene, edit.shot);
       if (!edit.commands.length) fail("Give at least one command.");
-      edit.commands.forEach((command2, k) => {
-        const problems = commandShapeProblems(command2, `Command ${k + 1}`);
+      edit.commands.forEach((command3, k) => {
+        const problems = commandShapeProblems(command3, `Command ${k + 1}`);
         if (problems.length) fail(problems.join(" "));
       });
       const run = scene.shots[i].run;
@@ -2065,14 +2164,14 @@ function applyOne(scene, edit) {
       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 command2 = { ...run[edit.command], ...edit.set ?? {} };
+      const command3 = { ...run[edit.command], ...edit.set ?? {} };
       for (const key of edit.remove ?? []) {
         if (key === "type") fail('"type" cannot be removed; replace the command instead.');
-        delete command2[key];
+        delete command3[key];
       }
-      const problems = commandShapeProblems(command2, `Command ${edit.command}`);
+      const problems = commandShapeProblems(command3, `Command ${edit.command}`);
       if (problems.length) fail(problems.join(" "));
-      return replaceShot(scene, i, { ...scene.shots[i], run: run.map((c, k) => k === edit.command ? command2 : c) });
+      return replaceShot(scene, i, { ...scene.shots[i], run: run.map((c, k) => k === edit.command ? command3 : c) });
     }
     case "delete_commands": {
       const i = shotIndex(scene, edit.shot);
@@ -2103,9 +2202,9 @@ function applyOne(scene, edit) {
         else delete next.presets;
       }
       const names = new Set(edit.controls.map((c) => c.name));
-      for (const preset of next.presets ?? [])
-        for (const key of Object.keys(preset.values))
-          if (!names.has(key)) fail(`Preset "${preset.name}" sets ${namedWithSuggestion(key, names)}, which is not a control.`);
+      for (const preset2 of next.presets ?? [])
+        for (const key of Object.keys(preset2.values))
+          if (!names.has(key)) fail(`Preset "${preset2.name}" sets ${namedWithSuggestion(key, names)}, which is not a control.`);
       return next;
     }
     case "replace_scene":
@@ -2272,7 +2371,7 @@ function toFlairSvgMotion(scene, options = {}) {
   const springs = flairAtLeast(flair, "0.39");
   const strobes = flairAtLeast(flair, "0.39");
   const writeEase = (ease) => typeof ease === "string" || "spring" in ease ? ease : ease.map(round2);
-  const easeOf = (segment) => {
+  const easeOf2 = (segment) => {
     const resolved = resolveEasing(segment.ease);
     if (resolved !== "hold" && resolved.type === "spring") {
       if (!springs || segment.reverse) return void 0;
@@ -2451,7 +2550,7 @@ function toFlairSvgMotion(scene, options = {}) {
       const first = active[0];
       const key = (x) => JSON.stringify([x.ease, x.behavior, x.reverse ?? false, x.steps ?? 0]);
       const together = active.every((x) => x.start === a && x.end === b && channel.exact(x) && key(x) === key(first));
-      const curve = together ? easeOf(first) : void 0;
+      const curve = together ? easeOf2(first) : void 0;
       const ease = curve && (!overshoots(curve) || channel.overshoot) ? curve : void 0;
       if (ease) {
         const from = channel.value(a);
@@ -2478,7 +2577,7 @@ function toFlairSvgMotion(scene, options = {}) {
     for (const seg of follow.segments) {
       const along = { id: follow.wrapper, along: follow.routes.get(seg.path), ...seg.rotate ? { orient: true } : {} };
       const progress = (t) => round2(Math.min(1, Math.max(0, Number(segmentValue(seg, t)))));
-      const curve = seg.end > seg.start ? plays(seg) ? easeOf(seg) : void 0 : "linear";
+      const curve = seg.end > seg.start ? plays(seg) ? easeOf2(seg) : void 0 : "linear";
       if (curve && !(overshoots(curve) && seg.rotate)) {
         const ends = seg.reverse ? [Number(seg.to), Number(seg.from)] : [Number(seg.from), Number(seg.to)];
         animate.push({ ...along, ...seg.start > 0 ? { delay: round2(seg.start) } : {}, ms: round2(seg.end - seg.start), ease: writeEase(curve), ...seg.steps ? { strobe: seg.steps } : {}, at: [round2(ends[0]), round2(ends[1])] });
@@ -2722,9 +2821,9 @@ function fromFlairSvgMotion(input, options = {}) {
       if (!anim.id) continue;
       const at = Math.max(0, (anim.delay ?? 0) - cameraMs);
       if (cameraMs && (anim.delay ?? 0) < cameraMs) notes.push(`Step ${step}: a change to "${anim.id}" during the camera move now starts after it.`);
-      for (const command2 of commandsFor(anim, nodes, entered, notes)) {
+      for (const command3 of commandsFor(anim, nodes, entered, notes)) {
         const first = run.length === 0;
-        run.push({ ...command2, ...first ? {} : { with: "previous" }, ...at - last > 0 || first ? { delay: first ? at : at - last } : {} });
+        run.push({ ...command3, ...first ? {} : { with: "previous" }, ...at - last > 0 || first ? { delay: first ? at : at - last } : {} });
         if (first && at === 0) delete run[run.length - 1].delay;
         last = at;
       }
@@ -2974,11 +3073,11 @@ function toLottie(scene, options = {}) {
     }
     const stroke = paintOf(path.stroke, "stroke", path.id);
     if (stroke || strokeFrom) {
-      const colour = strokeFrom ? track(strokeFrom, "stroke") : [];
+      const colour2 = 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) },
+        c: colour2.length ? animate(colour2, (t) => rgba(trackValue(colour2, 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,
@@ -2990,12 +3089,12 @@ function toLottie(scene, options = {}) {
     }
     const fill = paintOf(path.fill, "fill", path.id);
     if (fill || fillFrom) {
-      const colour = fillFrom ? track(fillFrom, "fill") : [];
+      const colour2 = 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) },
+        c: colour2.length ? animate(colour2, (t) => rgba(trackValue(colour2, 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
       });
@@ -3069,6 +3168,383 @@ function toLottie(scene, options = {}) {
   return { lottie, sampled, notes: [...new Set(notes)] };
 }
 
+// src/animation-editor/pptx.ts
+var EMU = 9525;
+var kids = (el, name) => el ? Array.from(el.children).filter((c) => c.localName === name) : [];
+var kid = (el, name) => kids(el, name)[0] ?? null;
+var deep = (el, name) => el ? Array.from(el.getElementsByTagNameNS("*", name)) : [];
+var num = (el, attr, fallback = 0) => {
+  const v = el?.getAttribute(attr);
+  const n = v === null || v === void 0 ? NaN : Number(v);
+  return Number.isFinite(n) ? n : fallback;
+};
+var dirname = (p) => p.slice(0, p.lastIndexOf("/") + 1);
+function resolve(base, target) {
+  const out = [];
+  for (const seg of (target.startsWith("/") ? target.slice(1) : base + target).split("/")) {
+    if (seg === "..") out.pop();
+    else if (seg && seg !== ".") out.push(seg);
+  }
+  return out.join("/");
+}
+async function xml(ctx, path) {
+  if (!ctx.zip.has(path)) return null;
+  const text = new TextDecoder().decode(await ctx.zip.read(path));
+  const doc = new ctx.Parser().parseFromString(text, "application/xml");
+  return doc.getElementsByTagName("parsererror").length ? null : doc;
+}
+async function rels(ctx, part) {
+  const doc = await xml(ctx, `${dirname(part)}_rels/${part.slice(part.lastIndexOf("/") + 1)}.rels`);
+  const out = /* @__PURE__ */ new Map();
+  for (const r of deep(doc, "Relationship")) if (r.getAttribute("TargetMode") !== "External") out.set(r.getAttribute("Id") ?? "", resolve(dirname(part), r.getAttribute("Target") ?? ""));
+  return out;
+}
+function colour(ctx, holder) {
+  if (!holder) return null;
+  const c = holder.firstElementChild;
+  if (!c) return null;
+  let hex = null;
+  if (c.localName === "srgbClr") hex = `#${(c.getAttribute("val") ?? "000000").toLowerCase()}`;
+  else if (c.localName === "sysClr") hex = `#${(c.getAttribute("lastClr") ?? "000000").toLowerCase()}`;
+  else if (c.localName === "schemeClr") {
+    const name = c.getAttribute("val") ?? "";
+    const alias = { tx1: "dk1", bg1: "lt1", tx2: "dk2", bg2: "lt2" };
+    hex = ctx.theme.get(alias[name] ?? name) ?? null;
+  } else if (c.localName === "prstClr") hex = { black: "#000000", white: "#ffffff", red: "#ff0000", green: "#008000", blue: "#0000ff" }[c.getAttribute("val") ?? ""] ?? null;
+  if (!hex || !/^#[0-9a-f]{6}$/.test(hex)) return null;
+  const lum = kid(c, "lumMod");
+  if (lum) {
+    const k = num(lum, "val", 1e5) / 1e5;
+    const off = num(kid(c, "lumOff"), "val", 0) / 1e5;
+    hex = `#${[1, 3, 5].map((i) => Math.round(Math.min(255, Math.max(0, parseInt(hex.slice(i, i + 2), 16) * k + 255 * off))).toString(16).padStart(2, "0")).join("")}`;
+  }
+  return hex;
+}
+function preset(prst, w, h) {
+  const poly = (pts) => [{ closed: true, anchors: pts.map(([x, y]) => ({ x, y })) }];
+  switch (prst) {
+    case "rect":
+      return [rectSubpath({ x: 0, y: 0, width: w, height: h })];
+    case "roundRect":
+      return [rectSubpath({ x: 0, y: 0, width: w, height: h }, Math.min(w, h) * 0.16667)];
+    case "ellipse":
+      return [ellipseSubpath({ x: 0, y: 0, width: w, height: h })];
+    case "triangle":
+      return poly([[w / 2, 0], [w, h], [0, h]]);
+    case "rtTriangle":
+      return poly([[0, 0], [w, h], [0, h]]);
+    case "diamond":
+      return poly([[w / 2, 0], [w, h / 2], [w / 2, h], [0, h / 2]]);
+    case "parallelogram":
+      return poly([[w * 0.25, 0], [w, 0], [w * 0.75, h], [0, h]]);
+    case "hexagon":
+      return poly([[w * 0.25, 0], [w * 0.75, 0], [w, h / 2], [w * 0.75, h], [w * 0.25, h], [0, h / 2]]);
+    case "line":
+    case "straightConnector1":
+      return [{ closed: false, anchors: [{ x: 0, y: 0 }, { x: w, y: h }] }];
+    default:
+      return null;
+  }
+}
+function custom(geom, w, h) {
+  const out = [];
+  for (const path of deep(geom, "path")) {
+    const sx = w / (num(path, "w") || w || 1);
+    const sy = h / (num(path, "h") || h || 1);
+    const pt = (el) => ({ x: num(el, "x") * sx, y: num(el, "y") * sy });
+    let cur = null;
+    for (const cmd of Array.from(path.children)) {
+      const pts = kids(cmd, "pt").map(pt);
+      if (cmd.localName === "moveTo" && pts[0]) {
+        if (cur) out.push(cur);
+        cur = { closed: false, anchors: [{ x: pts[0].x, y: pts[0].y }] };
+      } else if (!cur) continue;
+      else if (cmd.localName === "lnTo" && pts[0]) cur.anchors.push({ x: pts[0].x, y: pts[0].y });
+      else if (cmd.localName === "cubicBezTo" && pts.length === 3) {
+        cur.anchors[cur.anchors.length - 1].out = pts[0];
+        cur.anchors.push({ x: pts[2].x, y: pts[2].y, in: pts[1] });
+      } else if (cmd.localName === "quadBezTo" && pts.length === 2) {
+        const p0 = cur.anchors[cur.anchors.length - 1];
+        cur.anchors[cur.anchors.length - 1].out = { x: p0.x + 2 / 3 * (pts[0].x - p0.x), y: p0.y + 2 / 3 * (pts[0].y - p0.y) };
+        cur.anchors.push({ x: pts[1].x, y: pts[1].y, in: { x: pts[1].x + 2 / 3 * (pts[0].x - pts[1].x), y: pts[1].y + 2 / 3 * (pts[0].y - pts[1].y) } });
+      } else if (cmd.localName === "close") {
+        cur.closed = true;
+        out.push(cur);
+        cur = null;
+      }
+    }
+    if (cur) out.push(cur);
+  }
+  return out;
+}
+function placement(xfrm, map) {
+  const off = kid(xfrm, "off");
+  const ext = kid(xfrm, "ext");
+  const [x, y, w, h] = map(num(off, "x"), num(off, "y"), num(ext, "cx"), num(ext, "cy"));
+  const rot = num(xfrm, "rot") / 6e4 * (Math.PI / 180);
+  const fx = xfrm?.getAttribute("flipH") === "1" ? -1 : 1;
+  const fy = xfrm?.getAttribute("flipV") === "1" ? -1 : 1;
+  const cx = x + w / 2;
+  const cy = y + h / 2;
+  const cos = Math.cos(rot);
+  const sin = Math.sin(rot);
+  const a = cos * fx;
+  const b = sin * fx;
+  const c = -sin * fy;
+  const d = cos * fy;
+  const e = cx - a * (w / 2) - c * (h / 2);
+  const f = cy - b * (w / 2) - d * (h / 2);
+  return { x, y, w, h, transform: [a, b, c, d, e, f].map((v) => v + 0) };
+}
+var idFor = (ctx, spid, name) => {
+  const base = `${name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "shape"}-${spid}`;
+  let id = base;
+  for (let k = 2; ctx.used.has(id); k++) id = `${base}-${k}`;
+  ctx.used.add(id);
+  ctx.nodes.set(spid, id);
+  return id;
+};
+function shapes(ctx, tree, map) {
+  const out = [];
+  for (const el of Array.from(tree.children)) {
+    const nv = el.firstElementChild;
+    const cNvPr = kid(nv, "cNvPr");
+    const spid = num(cNvPr, "id", -1);
+    const name = cNvPr?.getAttribute("name") ?? "";
+    if (el.localName === "grpSp") {
+      const xfrm = kid(kid(el, "grpSpPr"), "xfrm");
+      const off = kid(xfrm, "off");
+      const ext = kid(xfrm, "ext");
+      const chOff = kid(xfrm, "chOff");
+      const chExt = kid(xfrm, "chExt");
+      const sx = num(ext, "cx") / (num(chExt, "cx") || num(ext, "cx") || 1);
+      const sy = num(ext, "cy") / (num(chExt, "cy") || num(ext, "cy") || 1);
+      const inner = (x, y, w2, h2) => map(num(off, "x") + (x - num(chOff, "x")) * sx, num(off, "y") + (y - num(chOff, "y")) * sy, w2 * sx, h2 * sy);
+      const id = idFor(ctx, spid, name || "group");
+      out.push({ id, type: "group", ...name ? { name } : {}, children: shapes(ctx, el, inner) });
+      continue;
+    }
+    if (el.localName === "pic" || el.localName === "graphicFrame") {
+      ctx.notes.push(`"${name || `shape ${spid}`}" is a ${el.localName === "pic" ? "picture" : "chart, table or diagram"}, which the artwork cannot hold; it was left out.`);
+      continue;
+    }
+    if (el.localName !== "sp" && el.localName !== "cxnSp") continue;
+    const spPr = kid(el, "spPr");
+    const { w, h, transform } = placement(kid(spPr, "xfrm"), map);
+    const prst = kid(spPr, "prstGeom")?.getAttribute("prst");
+    const cust = kid(spPr, "custGeom");
+    let subpaths = cust ? custom(cust, w, h) : prst ? preset(prst, w, h) : null;
+    if (!subpaths) {
+      if (prst) ctx.notes.push(`"${name}" is a ${prst}, drawn as its bounding rectangle.`);
+      subpaths = [rectSubpath({ x: 0, y: 0, width: w, height: h })];
+    }
+    const style = kid(el, "style");
+    const fill = kid(spPr, "noFill") ? null : colour(ctx, kid(spPr, "solidFill")) ?? (el.localName === "cxnSp" ? null : colour(ctx, kid(style, "fillRef")));
+    const ln = kid(spPr, "ln");
+    const stroke = kid(ln, "noFill") ? null : colour(ctx, kid(ln, "solidFill")) ?? colour(ctx, kid(style, "lnRef"));
+    if (kid(spPr, "gradFill")) ctx.notes.push(`"${name}" has a gradient fill, imported as its first colour or none.`);
+    const text = deep(kid(el, "txBody"), "t").map((t) => t.textContent ?? "").join("").trim();
+    if (text) ctx.notes.push(`"${name}" has text ("${text.slice(0, 40)}${text.length > 40 ? "\u2026" : ""}"), which the artwork cannot hold; only its shape was imported.`);
+    const node = {
+      id: idFor(ctx, spid, name),
+      type: "path",
+      ...name ? { name } : {},
+      transform,
+      fill: fill ?? (kid(spPr, "gradFill") ? colour(ctx, kid(deep(spPr, "gs")[0], "srgbClr") ? deep(spPr, "gs")[0] : null) : null),
+      stroke,
+      strokeWidth: Math.max(0.5, (num(ln, "w", 12700) || 12700) / EMU),
+      subpaths
+    };
+    out.push(node);
+  }
+  return out;
+}
+var DIRECTION_FROM = { 1: "down", 2: "left", 4: "up", 8: "right" };
+var DIRECTION_TO = { 1: "up", 2: "right", 4: "down", 8: "left" };
+function easeOf(ctn) {
+  const accel = num(ctn, "accel") / 1e5;
+  const decel = num(ctn, "decel") / 1e5;
+  if (!accel && !decel) return void 0;
+  return { type: "cubic-bezier", x1: Math.min(1, accel), y1: 0, x2: Math.max(0, 1 - decel), y2: 1 };
+}
+function command(ctx, ctn, scene, artwork, target, hidden) {
+  const cls = ctn.getAttribute("presetClass");
+  const id = num(ctn, "presetID");
+  const sub = num(ctn, "presetSubtype");
+  const durs = [ctn, ...deep(ctn, "cTn")].map((c) => num(c, "dur", NaN)).filter(Number.isFinite);
+  const duration = durs.length ? Math.max(...durs) : void 0;
+  const ease = easeOf(ctn);
+  const base = { targets: [target], ...duration !== void 0 ? { duration } : {}, ...ease ? { ease } : {} };
+  const repeat = num(ctn, "repeatCount", 1e3) / 1e3;
+  const auto = ctn.getAttribute("autoRev") === "1";
+  const timing = auto || repeat > 1 ? { repeat: Math.max(1, Math.round(repeat)) * (auto ? 2 : 1), ...auto ? { repeatMode: "mirror" } : {} } : {};
+  const label = `${cls} effect ${id} on "${target}"`;
+  if (cls === "entr") {
+    const by = {
+      1: { type: "enter", ...base, duration: 0 },
+      2: { type: "enter", style: "slide", ...base, direction: DIRECTION_FROM[sub] ?? "up", distance: Math.round(Math.max(scene.width, scene.height) / 3) },
+      10: { type: "enter", style: "fade", ...base },
+      9: { type: "enter", style: "fade", ...base },
+      22: { type: "enter", style: "wipe", ...base, direction: DIRECTION_FROM[sub] ?? "right" },
+      16: { type: "enter", style: "split", ...base, orientation: sub === 26 || sub === 42 ? "vertical" : "horizontal" },
+      6: { type: "enter", style: "iris", ...base, shape: "circle" },
+      4: { type: "enter", style: "iris", ...base, shape: "box" },
+      53: { type: "enter", style: "zoom", ...base },
+      23: { type: "enter", style: "zoom", ...base },
+      31: { type: "enter", style: "pop", ...base },
+      26: { type: "enter", style: "pop", ...base },
+      55: { type: "enter", style: "grow", ...base },
+      37: { type: "enter", style: "rise", ...base },
+      42: { type: "enter", style: "rise", ...base }
+    };
+    if (by[id]) return by[id];
+    ctx.notes.push(`${label} has no match here; it fades in instead.`);
+    return { type: "enter", style: "fade", ...base };
+  }
+  if (cls === "exit") {
+    const by = {
+      1: { type: "exit", ...base, duration: 0 },
+      10: { type: "exit", style: "fade", ...base },
+      9: { type: "exit", style: "fade", ...base },
+      2: { type: "exit", style: "slide", ...base, direction: DIRECTION_TO[sub] ?? "down", distance: Math.round(Math.max(scene.width, scene.height) / 3) },
+      22: { type: "exit", style: "wipe", ...base, direction: DIRECTION_TO[sub] ?? "right" },
+      53: { type: "exit", style: "shrink", ...base },
+      31: { type: "exit", style: "shrink", ...base }
+    };
+    if (by[id]) return by[id];
+    ctx.notes.push(`${label} has no match here; it fades out instead.`);
+    return { type: "exit", style: "fade", ...base };
+  }
+  if (cls === "emph") {
+    const rot = deep(ctn, "animRot")[0];
+    const scale = kid(deep(ctn, "animScale")[0], "by");
+    const clr = colour(ctx, kid(deep(ctn, "animClr")[0], "to"));
+    switch (id) {
+      case 26:
+        return { type: "pulse", ...base, ...timing };
+      case 27:
+        return { type: "color-pulse", ...base, ...clr ? { color: clr } : {}, ...timing };
+      case 32:
+        return { type: "teeter", ...base, ...timing };
+      case 34:
+        return { type: "wave", ...base, ...timing };
+      case 8:
+        return { type: "rotate", ...base, by: rot ? num(rot, "by") / 6e4 : 360, ...timing };
+      case 6:
+        return { type: "scale", ...base, to: scale ? { x: num(scale, "x", 1e5) / 1e5, y: num(scale, "y", 1e5) / 1e5 } : 1.5, ...timing };
+      case 9:
+        return { type: "fade", ...base, to: 0.5, ...timing };
+      case 1:
+      case 19:
+        return clr ? { type: "style", ...base, fill: clr, ...timing } : null;
+      case 7:
+        return clr ? { type: "style", ...base, stroke: clr, ...timing } : null;
+    }
+    ctx.notes.push(`${label} has no match here and was skipped.`);
+    return null;
+  }
+  if (cls === "path") {
+    const motion = deep(ctn, "animMotion")[0];
+    const d = motion?.getAttribute("path");
+    if (!d) return null;
+    const entry = artwork.flatMap(function all(n) {
+      return n.type === "group" ? [n, ...n.children.flatMap(all)] : [n];
+    }).find((n) => n.id === target);
+    const t = entry?.transform ?? [1, 0, 0, 1, 0, 0];
+    const p = entry?.type === "path" ? entry.subpaths[0]?.anchors : void 0;
+    const xs = (p ?? []).map((a) => a.x);
+    const ys = (p ?? []).map((a) => a.y);
+    const lx = xs.length ? (Math.min(...xs) + Math.max(...xs)) / 2 : 0;
+    const ly = ys.length ? (Math.min(...ys) + Math.max(...ys)) / 2 : 0;
+    const cx = t[0] * lx + t[2] * ly + t[4];
+    const cy = t[1] * lx + t[3] * ly + t[5];
+    const nums = d.match(/[MLCZE]|-?[\d.]+(?:e-?\d+)?/gi) ?? [];
+    const sp = { closed: false, anchors: [] };
+    let i = 0;
+    const read = () => ({ x: cx + Number(nums[i++]) * scene.width, y: cy + Number(nums[i++]) * scene.height });
+    while (i < nums.length) {
+      const c = nums[i++].toUpperCase();
+      if (c === "M" || c === "L") sp.anchors.push(read());
+      else if (c === "C") {
+        const c1 = read();
+        const c2 = read();
+        const e = read();
+        if (sp.anchors.length) sp.anchors[sp.anchors.length - 1].out = c1;
+        sp.anchors.push({ ...e, in: c2 });
+      } else if (c === "Z") sp.closed = true;
+    }
+    if (sp.anchors.length < 2) return null;
+    const pathId = `${target}-path-${hidden.length + 1}`;
+    hidden.push({ id: pathId, type: "path", name: "Motion path", visible: false, fill: null, stroke: "#94a3b8", subpaths: [sp] });
+    return { type: "follow", ...base, path: pathId, ...timing };
+  }
+  return null;
+}
+async function fromPptxAnimation(data, options = {}) {
+  const Parser = options.DOMParser ?? globalThis.DOMParser;
+  if (!Parser) throw new Error("No DOMParser: pass one in options (jsdom's or xmldom's in Node).");
+  let zip;
+  try {
+    zip = await readZip(data, options);
+  } catch (error) {
+    throw new Error(`This is not a PowerPoint file (.pptx): ${error.message}`);
+  }
+  const ctx = { zip, Parser, notes: [], theme: /* @__PURE__ */ new Map(), nodes: /* @__PURE__ */ new Map(), used: /* @__PURE__ */ new Set() };
+  const pres = await xml(ctx, "ppt/presentation.xml");
+  if (!pres) throw new Error("This is not a PowerPoint file (.pptx): it has no ppt/presentation.xml.");
+  const presRels = await rels(ctx, "ppt/presentation.xml");
+  const slidePaths = deep(pres, "sldId").map((s) => presRels.get(s.getAttributeNS("http://schemas.openxmlformats.org/officeDocument/2006/relationships", "id") ?? s.getAttribute("r:id") ?? "") ?? "").filter(Boolean);
+  const n = options.slide ?? 1;
+  if (!(Number.isInteger(n) && n >= 1 && n <= slidePaths.length)) throw new Error(`There is no slide ${n}; the file has ${slidePaths.length} slide${slidePaths.length === 1 ? "" : "s"}.`);
+  const size = deep(pres, "sldSz")[0];
+  const width = Math.round(num(size, "cx", 12192e3) / EMU);
+  const height = Math.round(num(size, "cy", 6858e3) / EMU);
+  for (const [, path] of presRels) {
+    if (!path.includes("theme/")) continue;
+    const theme = await xml(ctx, path);
+    const scheme = deep(theme, "clrScheme")[0];
+    for (const c of Array.from(scheme?.children ?? [])) {
+      const v = c.firstElementChild;
+      const hex = v?.localName === "srgbClr" ? v.getAttribute("val") : v?.getAttribute("lastClr");
+      if (hex) ctx.theme.set(c.localName, `#${hex.toLowerCase()}`);
+    }
+    break;
+  }
+  const slide = await xml(ctx, slidePaths[n - 1]);
+  if (!slide) throw new Error(`Slide ${n} cannot be read.`);
+  const tree = deep(slide, "spTree")[0];
+  const toPx = (x, y, w, h) => [x / EMU, y / EMU, w / EMU, h / EMU];
+  const nodes = tree ? shapes(ctx, tree, toPx) : [];
+  const bg = colour(ctx, deep(deep(slide, "bg")[0], "solidFill")[0] ?? null) ?? "#ffffff";
+  const hidden = [];
+  const shots = [];
+  const effects = deep(deep(slide, "timing")[0], "cTn").filter((c) => c.hasAttribute("presetClass"));
+  for (const ctn of effects) {
+    const spid = num(deep(ctn, "spTgt")[0], "spid", -1);
+    const target = ctx.nodes.get(spid);
+    if (!target) {
+      ctx.notes.push(`An effect targets shape ${spid}, which was not imported; it was skipped.`);
+      continue;
+    }
+    if (deep(ctn, "txEl").length) ctx.notes.push(`An effect on "${target}" animates part of its text, which was not imported; it animates the whole shape.`);
+    const cmd = command(ctx, ctn, { width, height }, nodes, target, hidden);
+    if (!cmd) continue;
+    const kind = ctn.getAttribute("nodeType");
+    const delay = num(kid(kid(ctn, "stCondLst"), "cond"), "delay", 0);
+    if (kind === "clickEffect" || !shots.length) shots.push({ id: `click-${shots.length + 1}`, run: [] });
+    const run = shots[shots.length - 1].run;
+    const placed = { ...cmd, ...delay > 0 ? { delay } : {}, ...kind === "withEffect" && run.length ? { with: "previous" } : {} };
+    run.push(placed);
+  }
+  if (effects.length && !shots.length) ctx.notes.push("The slide's effects could not be read.");
+  const artwork = { width, height, background: bg, nodes: [...nodes, ...hidden] };
+  const scene = { version: 1, name: `slide-${n}`, artwork, shots, ...shots.length > 1 ? { trigger: "click" } : {} };
+  const problems = motionSceneShapeProblems(scene);
+  if (problems.length) throw new Error(`The imported scene is not well formed:
+${problems.join("\n")}`);
+  return { scene, notes: [...new Set(ctx.notes)], issues: checkMotionScene(scene), slides: slidePaths.length };
+}
+
 // src/animation-editor/controller.ts
 var BLANK = { width: 800, height: 450, background: "#ffffff", nodes: [] };
 var AnimationEditorController = class {
@@ -3184,14 +3660,14 @@ var AnimationEditorController = class {
       this.notify();
       return;
     }
-    const command2 = {
+    const command3 = {
       name: label,
       tag: "animation-editor",
       execute: () => this.setScene(next),
       undo: () => this.setScene(before),
       redo: () => this.setScene(next)
     };
-    this.history.execute(command2);
+    this.history.execute(command3);
   }
   refuse(message) {
     this.error = message;
@@ -3348,6 +3824,8 @@ var BASE = {
   with: { type: "string", enum: ["after", "previous"], description: '"after" (default) starts when the commands before it finish; "previous" starts together with the command before.' },
   ease: EASE,
   note: { type: "string", description: "Why this command is here, in a few words." },
+  split: { type: "string", enum: ["letter", "word", "line"], description: "For outlined text (a group of letter paths): animate it a letter, word or line at a time in reading order, staggered (default 40 ms a letter, 120 a word, 300 a line). get_text_layout shows the units." },
+  cascade: { type: "string", enum: ["forward", "backward", "center", "edges", "random"], description: "With split: the order units go in (default forward; random is the same every time)." },
   repeat: { type: "integer", minimum: 1, maximum: 1e3, description: 'Play it this many times (default 1); "duration" is one cycle. Not for enter or exit.' },
   repeatMode: { type: "string", enum: [...MOTION_REPEAT_MODES], description: "loop (default) restarts each cycle, mirror plays every other one backwards, offset carries on from where the last ended (rotate by 90 with repeat 4 makes a full turn)." },
   steps: { type: "number", exclusiveMinimum: 0, maximum: 120, description: `Stepped time: hold on a grid of this many frames per second (12 = "on twos"). Default: the scene's steps, else smooth.` }
@@ -3364,11 +3842,11 @@ var DRAW_ORDER = {
   sortBy: { type: "string", enum: ["document", "distance"], description: "With sequence: stacking order (default) or distance from origin (a radial reveal)." },
   origin: object({ x: { type: "number", description: "Document units." }, y: { type: "number", description: "Document units." } }, ["x", "y"], "With sortBy distance: where strokes are drawn out from (default the target's centre).")
 };
-var command = (type, description, extra = {}, required = []) => object({ type: { const: type, description }, ...BASE, ...extra }, ["type", "targets", ...required], description);
+var command2 = (type, description, extra = {}, required = []) => object({ type: { const: type, description }, ...BASE, ...extra }, ["type", "targets", ...required], description);
 var MOTION_COMMAND_SCHEMA = {
   description: `A command (one of ${MOTION_COMMAND_TYPES.join(", ")}). Commands in a shot play one after another unless "with": "previous".`,
   oneOf: [
-    command("enter", "Brings hidden targets in; they are hidden before this shot.", {
+    command2("enter", "Brings hidden targets in; they are hidden before this shot.", {
       ...DRAW_ORDER,
       style: {
         type: "string",
@@ -3381,18 +3859,18 @@ var MOTION_COMMAND_SCHEMA = {
       shape: { type: "string", enum: [...MOTION_IRIS_SHAPES], description: "For iris: open through a circle (default; an ellipse on a box that is not square) or a box." },
       orientation: { type: "string", enum: [...MOTION_SPLIT_ORIENTATIONS], description: "For split: horizontal (default) opens up and down from a horizontal line through the middle; vertical opens left and right." }
     }),
-    command("exit", "Takes targets out.", {
+    command2("exit", "Takes targets out.", {
       ...DRAW_ORDER,
       style: { type: "string", enum: [...MOTION_EXIT_STYLES], description: "fade (default), shrink, slide, undraw, or wipe (hides behind a travelling edge through a clip over the target's box: a wipe in, reversed)." },
       direction: { type: "string", enum: [...MOTION_DIRECTIONS], description: "For slide: direction of travel (default down). For wipe: the way the edge travels (default right, hiding from the left)." },
       distance: { type: "number", description: "For slide: document units (default 40)." }
     }),
-    command("draw", "Draws strokes on (or off) to a fraction of their length.", { ...DRAW_ORDER, comet: FRACTION("A travelling stroke this fraction of the length long: it runs along the path and off the end (leave out from and to)."), to: FRACTION("Fraction drawn at the end (default 1)."), from: FRACTION("Fraction drawn at the start (default: what is drawn now).") }),
-    command("move", "Moves targets by an offset or so their centre lands on a point.", { via: { type: "array", items: POINT("A point the centre passes through."), minItems: 1, maxItems: 64, description: 'Waypoints (document units) the centre passes through on the way to "to" or "by", smoothly (velocity carries through each) and without overshooting any. Default length 700 ms + 400 per waypoint.' }, pacing: { type: "string", enum: ["even", "equal"], description: "With via: even (default) keeps the speed steady along the path; equal gives each stretch the same time." }, blend: BLEND("replace"), by: POINT("Offset in document units."), to: POINT("Point (document coordinates) for the centre.") }),
-    command("rotate", "Turns targets about their centre (degrees, clockwise).", { blend: BLEND("replace"), by: { type: "number", description: "Degrees to turn by." }, to: { type: "number", description: "Angle to turn to, in degrees from rest." } }),
-    command("scale", "Scales targets about their centre (1 = rest size).", { blend: BLEND("replace"), to: { description: "A factor, or { x, y } factors.", anyOf: [{ type: "number" }, POINT("Factors per axis.")] }, geometric: { type: "boolean", description: "Grow by a steady factor, which reads as an even zoom (default false)." } }, ["to"]),
-    command("fade", "Changes opacity.", { to: FRACTION("Opacity at the end (0\u20131).") }, ["to"]),
-    command("style", "Blends solid fill / stroke colours (in OKLab) and stroke width. On a group it changes every path in it.", {
+    command2("draw", "Draws strokes on (or off) to a fraction of their length.", { ...DRAW_ORDER, comet: FRACTION("A travelling stroke this fraction of the length long: it runs along the path and off the end (leave out from and to)."), to: FRACTION("Fraction drawn at the end (default 1)."), from: FRACTION("Fraction drawn at the start (default: what is drawn now).") }),
+    command2("move", "Moves targets by an offset or so their centre lands on a point.", { via: { type: "array", items: POINT("A point the centre passes through."), minItems: 1, maxItems: 64, description: 'Waypoints (document units) the centre passes through on the way to "to" or "by", smoothly (velocity carries through each) and without overshooting any. Default length 700 ms + 400 per waypoint.' }, pacing: { type: "string", enum: ["even", "equal"], description: "With via: even (default) keeps the speed steady along the path; equal gives each stretch the same time." }, blend: BLEND("replace"), by: POINT("Offset in document units."), to: POINT("Point (document coordinates) for the centre.") }),
+    command2("rotate", "Turns targets about their centre (degrees, clockwise).", { blend: BLEND("replace"), by: { type: "number", description: "Degrees to turn by." }, to: { type: "number", description: "Angle to turn to, in degrees from rest." } }),
+    command2("scale", "Scales targets about their centre (1 = rest size).", { blend: BLEND("replace"), to: { description: "A factor, or { x, y } factors.", anyOf: [{ type: "number" }, POINT("Factors per axis.")] }, geometric: { type: "boolean", description: "Grow by a steady factor, which reads as an even zoom (default false)." } }, ["to"]),
+    command2("fade", "Changes opacity.", { to: FRACTION("Opacity at the end (0\u20131).") }, ["to"]),
+    command2("style", "Blends solid fill / stroke colours (in OKLab) and stroke width. On a group it changes every path in it.", {
       fill: { type: "string", description: "CSS colour (hex, rgb(), rgba())." },
       stroke: { type: "string", description: "CSS colour (hex, rgb(), rgba())." },
       strokeWidth: { type: "number", minimum: 0, description: "Document units." }
@@ -3411,24 +3889,24 @@ var MOTION_COMMAND_SCHEMA = {
       ["type", "targets", "clip"],
       "Plays a clip on the targets."
     ),
-    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.", {
+    command2("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"]),
+    command2("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"]),
+    command2("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)." },
       rotate: { type: "boolean", description: "Turn with the path (default false); moves and shakes made meanwhile turn with it too." },
       from: FRACTION("Where to start along the path (default 0)."),
       to: FRACTION("Where to end along the path (default 1).")
     }, ["path"]),
-    command("pulse", "Scales up and back to draw the eye.", { blend: BLEND("add"), amount: { type: "number", description: "Extra scale at the peak (default 0.15)." }, count: { type: "integer", minimum: 1, description: "Pulses (default 1)." } }),
-    command("shake", "Shakes side to side (or up and down), settling.", {
+    command2("pulse", "Scales up and back to draw the eye.", { blend: BLEND("add"), amount: { type: "number", description: "Extra scale at the peak (default 0.15)." }, count: { type: "integer", minimum: 1, description: "Pulses (default 1)." } }),
+    command2("shake", "Shakes side to side (or up and down), settling.", {
       blend: BLEND("add"),
       amount: { type: "number", description: "Document units (default 8)." },
       count: { type: "integer", minimum: 1, description: "Shakes (default 3)." },
       axis: { type: "string", enum: ["horizontal", "vertical"], description: "Default horizontal." }
     }),
-    command("teeter", "Rocks about the centre either way, settling.", { blend: BLEND("add"), angle: { type: "number", description: "Degrees either way (default 8)." }, count: { type: "integer", minimum: 1, description: "Rocks (default 3)." } }),
-    command("wave", "Bobs up and down without settling, like something floating (default 1000 ms).", { blend: BLEND("add"), amount: { type: "number", description: "Height in document units (default 6)." }, count: { type: "integer", minimum: 1, description: "Bobs (default 2)." } }),
-    command("wiggle", "Wanders about its place as smooth seeded noise, easing out of and back to rest (default 1500 ms). The same seed always wanders the same way.", {
+    command2("teeter", "Rocks about the centre either way, settling.", { blend: BLEND("add"), angle: { type: "number", description: "Degrees either way (default 8)." }, count: { type: "integer", minimum: 1, description: "Rocks (default 3)." } }),
+    command2("wave", "Bobs up and down without settling, like something floating (default 1000 ms).", { blend: BLEND("add"), amount: { type: "number", description: "Height in document units (default 6)." }, count: { type: "integer", minimum: 1, description: "Bobs (default 2)." } }),
+    command2("wiggle", "Wanders about its place as smooth seeded noise, easing out of and back to rest (default 1500 ms). The same seed always wanders the same way.", {
       blend: BLEND("add"),
       amount: { type: "number", description: "Up to about this far, in document units (default 6)." },
       frequency: { type: "number", exclusiveMinimum: 0, description: "Wanders per second, in Hz (default 3)." },
@@ -3436,12 +3914,12 @@ var MOTION_COMMAND_SCHEMA = {
       rotate: { type: "number", description: "Also turns about the centre by up to about this many degrees (default 0)." },
       seed: { type: "integer", minimum: 0, description: "Default: one picked from the target id, so each target wanders its own way." }
     }),
-    command("color-pulse", "Tints solid paint toward a colour and back (mixed in OKLab). On a group it tints every path in it.", {
+    command2("color-pulse", "Tints solid paint toward a colour and back (mixed in OKLab). On a group it tints every path in it.", {
       color: { type: "string", description: 'The tint, a CSS colour (default "#f59e0b").' },
       paint: { type: "string", enum: ["fill", "stroke"], description: "Which paint (default fill)." },
       count: { type: "integer", minimum: 1, description: "Pulses (default 1)." }
     }),
-    command("effect", "Tweens a numeric parameter of a live path effect on the targets (twist angle, wiggle time, zig zag size, trim offset\u2026).", {
+    command2("effect", "Tweens a numeric parameter of a live path effect on the targets (twist angle, wiggle time, zig zag size, trim offset\u2026).", {
       effect: { type: "string", minLength: 1, description: `Effect id from get_animation's element "effects".` },
       param: { type: "string", minLength: 1, description: "A numeric parameter of that effect (listed with it)." },
       to: { type: "number", description: "Value at the end." }
@@ -3763,6 +4241,21 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       };
     }
   };
+  const getTextLayout = {
+    name: "get_text_layout",
+    title: "Read outlined text as letters, words and lines",
+    description: 'Returns how a group of letter paths (text converted to outlines) reads: its lines, each a list of words, each a list of letter ids, in reading order \u2014 the units a command with "split": "letter" | "word" | "line" animates. Errors if the element is not a group with paths.',
+    inputSchema: object({ group: { type: "string", minLength: 1, description: "Element id of the group of letters." } }, ["group"]),
+    annotations: { title: "Read outlined text as letters, words and lines", ...READ },
+    handler: ({ group }) => {
+      const s = scene();
+      const nodes = indexMotionNodes(s.artwork.nodes);
+      if (!nodes.has(group)) throw new Error(`There is no element ${namedWithSuggestion(group, [...nodes.keys()])}.`);
+      const layout = motionTextLayout(nodes, group);
+      if (!layout) throw new Error(`"${group}" is not a group of paths; convert the text to outlines (one path a letter) and group it.`);
+      return { group, letters: layout.lines.reduce((n, l) => n + l.words.reduce((m, w) => m + w.letters.length, 0), 0), ...layout };
+    }
+  };
   const getMotionPath = {
     name: "get_motion_path",
     title: "Read where a node travels",
@@ -3835,6 +4328,33 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       return apply({ op: "set_artwork", artwork }, "Replace artwork", (s) => ({ elements: describeMotionElements(s) }));
     }
   };
+  const importPptx = {
+    name: "import_pptx_animation",
+    title: "Import a PowerPoint slide's animation",
+    description: "Replaces the whole animation with a PowerPoint slide (one undo step): its shapes become the artwork and its animation pane becomes shots, a shot per click (with previous / after previous, delays, repeats and acceleration kept; the scene plays on click). Text, pictures and charts are left out and effects with no match fade, with notes. Returns the shots, notes and issues. With dry_run it only reports them.",
+    inputSchema: object(
+      {
+        data: { type: "string", minLength: 1, description: "The .pptx file, base64-encoded." },
+        slide: { type: "integer", minimum: 1, description: "Which slide (1 = first, default 1)." },
+        dry_run: { type: "boolean", description: "Report without replacing anything (default false)." }
+      },
+      ["data"]
+    ),
+    annotations: { title: "Import a PowerPoint slide's animation", ...DESTRUCTIVE },
+    handler: async ({ data, slide, dry_run = false }) => {
+      let result;
+      try {
+        const bytes = Uint8Array.from(atob(data.replace(/\s+/g, "")), (c) => c.charCodeAt(0));
+        result = await fromPptxAnimation(bytes, slide ? { slide } : {});
+      } catch (error) {
+        throw new Error(`The slide could not be imported: ${error.message} Nothing was changed.`);
+      }
+      const report = { slides: result.slides, notes: result.notes, issues: issueSummary(result.issues), shots: describeMotionShots(result.scene).map(({ id, start, end, commands }) => ({ id, start, end, commands: commands.length })) };
+      if (dry_run) return { dry_run: true, ...report, hint: "Nothing was replaced; call again without dry_run to import." };
+      const applied = controller.apply({ op: "replace_scene", scene: result.scene }, "Import PowerPoint slide");
+      return outcome(applied, applied.ok ? { ...report, elements: describeMotionElements(result.scene) } : {});
+    }
+  };
   const importFlairEffect = {
     name: "import_flair_effect",
     title: "Import a Flair effect",
@@ -4045,7 +4565,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       ["shot", "command"]
     ),
     annotations: { title: "Change a command", ...WRITE_IDEMPOTENT },
-    handler: ({ shot, command: command2, set, remove }) => apply({ op: "update_command", shot, command: command2, set, remove }, "Change command", (s) => ({ command: describeMotionShots(s).find((x) => x.id === shot).commands[command2] }))
+    handler: ({ shot, command: command3, set, remove }) => apply({ op: "update_command", shot, command: command3, set, remove }, "Change command", (s) => ({ command: describeMotionShots(s).find((x) => x.id === shot).commands[command3] }))
   };
   const deleteCommands = {
     name: "delete_commands",
@@ -4068,7 +4588,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       ["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 })) }))
+    handler: ({ shot, command: command3, to }) => apply({ op: "move_command", shot, command: command3, to }, "Move command", (s) => ({ shot, command: to, from: command3, 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",
@@ -4153,8 +4673,8 @@ function createAnimationEditorToolProvider(controller, options = {}) {
       return { redone, ...redone ? { label } : {} };
     }
   };
-  const reads = [getAnimation, getShot, findElements, getMotionPath, getTimingGrid, checkAnimation, renderFrame, exportFlairMotion, exportFlairEffect, exportLottie, seekAnimation];
-  const writes = [setArtworkSvg, setDrivers, setClip, copyAnimation, fitAnimation, importFlairEffect, insertShots, updateShot, deleteShots, moveShot, addCommands, updateCommand, deleteCommands, moveCommand, setSettings, setControls, editAnimation, writeAnimation, undo, redo];
+  const reads = [getAnimation, getShot, findElements, getTextLayout, getMotionPath, getTimingGrid, checkAnimation, renderFrame, exportFlairMotion, exportFlairEffect, exportLottie, seekAnimation];
+  const writes = [setArtworkSvg, importPptx, setDrivers, setClip, copyAnimation, fitAnimation, importFlairEffect, insertShots, updateShot, deleteShots, moveShot, addCommands, updateCommand, deleteCommands, moveCommand, setSettings, setControls, editAnimation, writeAnimation, undo, redo];
   return {
     id: options.id ?? "animation",
     namespace: options.namespace,
@@ -4186,6 +4706,7 @@ Commands
 - enter (fade, pop, grow, slide, draw) and exit (fade, shrink, slide, undraw) bring things in and out.
 - 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.
+- Text: convert it to outlines (a group with a path per letter) and give a command "split": "letter", "word" or "line" (and "cascade") to animate it a unit at a time; get_text_layout shows the units.
 - Drawing a group of strokes: "order": "sequence" draws them one after another (a signature, a diagram), "sortBy": "distance" from "origin" reveals outward, "pace": "speed" keeps one speed; draw with "comet": 0.2 sends a short stroke along a path and off the end.
 - Fast motion reads better with blur: set_animation_settings { "motionBlur": { "shutter": 180 } } (stage and rendered frames only).
 - Tie properties together with set_animation_drivers: parallax layers, a wheel that turns as it rolls, a shadow that fades as something rises. Drivers add to the target's own commands.
@@ -4203,7 +4724,7 @@ Commands
 - effect tweens a numeric parameter of a live path effect already on the node (twist angle, wiggle time, zig zag size).
 
 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).
+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 / import_pptx_animation to start from a Flair effect or a PowerPoint slide).
 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).
 - In edit_animation, a later op can use what an earlier one made: "$0.indexes[0]" (the first command op 1 added), "$last.shot".
 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, or with "times" for a contact sheet of several moments; add onion_skin or motion_paths to see the motion in one picture, or get_motion_path for the numbers.
@@ -4299,11 +4820,11 @@ function parseMotionFieldInput(field, raw) {
   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) {
+function motionFieldEdit(shot, command3, 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 } };
+  if ("remove" in input) return { op: "update_command", shot, command: command3, remove: [field.name] };
+  return { op: "update_command", shot, command: command3, set: { [field.name]: input.set } };
 }
 function defaultMotionCommand(type, targets, scene) {
   if (type === "wait") return { type: "wait", duration: 500 };
@@ -4352,26 +4873,26 @@ function defaultMotionCommand(type, targets, scene) {
       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`;
+function motionCommandSummary(command3) {
+  const c = command3;
+  const what = [command3.type, typeof c.style === "string" ? c.style : ""].filter(Boolean).join(" ");
+  if (command3.type === "wait") return `wait ${command3.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}`;
+  return `${what} \xB7 ${(command3.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) => {
+  return scene.shots[index].run.map((command3, 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 } : {} };
+    const primitive = motionFlairPrimitive(command3);
+    return { index: i, command: command3, summary: motionCommandSummary(command3), start: t?.start ?? 0, end: t?.end ?? 0, ...primitive ? { flairPrimitive: primitive } : {} };
   });
 }
-function duplicateMotionCommandEdit(scene, shot, command2) {
+function duplicateMotionCommandEdit(scene, shot, command3) {
   const run = scene.shots.find((s) => s.id === shot)?.run ?? [];
-  return { op: "add_commands", shot, commands: run[command2] ? [structuredClone(run[command2])] : [], at: command2 + 1 };
+  return { op: "add_commands", shot, commands: run[command3] ? [structuredClone(run[command3])] : [], at: command3 + 1 };
 }
 var MOTION_EASE_CHOICES = [
   { value: "", label: "Default" },
@@ -4518,6 +5039,7 @@ export {
   MOTION_ADDITIVE_PROPERTIES,
   MOTION_BLENDS,
   MOTION_CAMERA_MS,
+  MOTION_CASCADES,
   MOTION_CLIP_TARGET,
   MOTION_COMMAND_SCHEMA,
   MOTION_COMMAND_TYPES,
@@ -4540,6 +5062,8 @@ export {
   MOTION_REPEAT_MODES,
   MOTION_SPEED_RANGE,
   MOTION_SPLIT_ORIENTATIONS,
+  MOTION_TEXT_STAGGER,
+  MOTION_TEXT_UNITS,
   MOTION_TRIGGERS,
   MotionSceneFormatError,
   activeSegment,
@@ -4568,6 +5092,7 @@ export {
   freshShotId,
   fromFlairSvgMotion,
   fromFlairVectorEffect,
+  fromPptxAnimation,
   highlightMotionSvg,
   indexMotionNodes,
   interpolateMotionValue,
@@ -4578,12 +5103,14 @@ export {
   motionBeatAt,
   motionBeatTime,
   motionBlurTimes,
+  motionCascade,
   motionClipAttrs,
   motionClipLayout,
   motionCommandDuration,
   motionCommandFields,
   motionCommandRepeat,
   motionCommandRows,
+  motionCommandSlots,
   motionCommandSummary,
   motionContactSheetSvg,
   motionCueChoices,
@@ -4625,6 +5152,8 @@ export {
   motionShotCueTime,
   motionShotTimeScale,
   motionStageSvg,
+  motionTextLayout,
+  motionTextUnits,
   motionTrackKey,
   namedWithSuggestion,
   parseMotionDrivers,