@pixerate/editor 0.241.0 → 0.242.0

package/dist/animation-editor/index.cjs

@@ -16,7 +16,7 @@ var _chunkDGWOGQJ5cjs = require('../chunk-DGWOGQJ5.cjs');
 
 
 
-var _chunkJWCKJNDRcjs = require('../chunk-JWCKJNDR.cjs');
+var _chunkK5DS2JTAcjs = require('../chunk-K5DS2JTA.cjs');
 
 
 
@@ -68,7 +68,8 @@ var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkJAOSL334cjs = require('../chunk-JAOSL334.cjs');
+
+var _chunkGHCSC2WPcjs = require('../chunk-GHCSC2WP.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 require('../chunk-PQ3H2AAN.cjs');
 require('../chunk-YQGCPL5X.cjs');
@@ -501,11 +502,11 @@ function shotLayersShapeProblems(shot, name) {
         if (layer.effect === void 0 && layer.subject === void 0) problems.push(`${where} needs an "effect", a "subject" or both.`);
         if (layer.effect !== void 0 && (typeof layer.effect !== "string" || !layer.effect)) problems.push(`${where}: "effect" must be an effect id.`);
         if (layer.subject !== void 0) {
-          const kind = _chunkJWCKJNDRcjs.effectSubjectKind.call(void 0, layer.subject);
+          const kind = _chunkK5DS2JTAcjs.effectSubjectKind.call(void 0, layer.subject);
           if (kind === "video") problems.push(`${where}: an animation layer cannot play a video; use { "image" }, { "svg" }, { "text" } or { "slot" } (the video editor plays video).`);
           else if (!kind || !String(layer.subject[kind]).trim()) problems.push(`${where}: "subject" must be { "image": url }, { "svg": markup }, { "text": words } or { "slot": name }.`);
         }
-        if (layer.role !== void 0 && !_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: "role" must be one of ${_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.join(", ")}.`);
+        if (layer.role !== void 0 && !_chunkGHCSC2WPcjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: "role" must be one of ${_chunkGHCSC2WPcjs.EFFECT_LAYER_ROLES.join(", ")}.`);
         if (layer.rect !== void 0) {
           const r = layer.rect;
           if (!isObject(r) || !["x", "y", "width", "height"].every((k) => isNum(r[k])) || !(r.width > 0 && r.height > 0)) problems.push(`${where}: "rect" must be { x, y, width, height } in artwork units, width and height > 0.`);
@@ -1126,9 +1127,9 @@ function compileMotionScene(scene) {
     const start = t;
     let cursor = start;
     const f = motionShotTimeScale(shot);
-    const moveIn = shot.camera ? _chunkJAOSL334cjs.cameraMoveParts.call(void 0, shot.camera.in) : void 0;
-    const transitionMs = index > 0 && shot.transition ? (_nullishCoalesce(shot.transition.ms, () => ( _chunkJAOSL334cjs.EFFECT_TRANSITION_MS))) * f : 0;
-    const moveDuring = shot.camera ? _chunkJAOSL334cjs.cameraMoveParts.call(void 0, shot.camera.during) : void 0;
+    const moveIn = shot.camera ? _chunkGHCSC2WPcjs.cameraMoveParts.call(void 0, shot.camera.in) : void 0;
+    const transitionMs = index > 0 && shot.transition ? (_nullishCoalesce(shot.transition.ms, () => ( _chunkGHCSC2WPcjs.EFFECT_TRANSITION_MS))) * f : 0;
+    const moveDuring = shot.camera ? _chunkGHCSC2WPcjs.cameraMoveParts.call(void 0, shot.camera.during) : void 0;
     let playsIn = false;
     if (shot.camera) {
       const framed = motionCameraFramed(shot.camera);
@@ -1497,7 +1498,7 @@ function motionShotAt(timeline, time) {
 // src/animation-editor/camera.ts
 var windowCache = /* @__PURE__ */ new WeakMap();
 function motionShotCameraMove(shot, role) {
-  return _chunkJAOSL334cjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'optionalAccess', _55 => _55.camera, 'optionalAccess', _56 => _56[role === "transition" ? "in" : "during"]]));
+  return _chunkGHCSC2WPcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'optionalAccess', _55 => _55.camera, 'optionalAccess', _56 => _56[role === "transition" ? "in" : "during"]]));
 }
 var motionCameraStage = (scene) => ({ width: scene.artwork.width, height: scene.artwork.height });
 var effectsPlayCamera = (provider) => !!provider && provider.capabilities.supportsCamera === true && typeof provider.cameraView === "function";
@@ -1519,7 +1520,7 @@ function motionCameraWindows(scene, provider) {
   const track = timeline.tracks.get(motionTrackKey("", "camera"));
   const boxView = (t) => {
     const b = trackValue(track, t);
-    return _chunkJAOSL334cjs.cameraViewOfBox.call(void 0, Array.isArray(b) ? { x: b[0], y: b[1], width: b[2], height: b[3] } : full, stage);
+    return _chunkGHCSC2WPcjs.cameraViewOfBox.call(void 0, Array.isArray(b) ? { x: b[0], y: b[1], width: b[2], height: b[3] } : full, stage);
   };
   const view = (move, values, from, to, u, ms2) => {
     try {
@@ -1535,7 +1536,7 @@ function motionCameraWindows(scene, provider) {
     const eases = timing.commandsStart > timing.start && !!_optionalChain([track, 'optionalAccess', _57 => _57.some, 'call', _58 => _58((seg) => seg.shot === timing.id)]);
     const framed = !!_optionalChain([track, 'optionalAccess', _59 => _59.some, 'call', _60 => _60((seg) => seg.shot === timing.id)]);
     if (timing.cameraIn && timing.commandsStart > timing.start) {
-      const spec = _chunkJAOSL334cjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'access', _61 => _61.camera, 'optionalAccess', _62 => _62.in]));
+      const spec = _chunkGHCSC2WPcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'access', _61 => _61.camera, 'optionalAccess', _62 => _62.in]));
       const from = _nullishCoalesce(carry, () => ( boxView(timing.start)));
       const to = boxView(timing.commandsStart);
       if (view(spec.move, spec.values, from, to, 0, timing.commandsStart - timing.start)) {
@@ -1547,7 +1548,7 @@ function motionCameraWindows(scene, provider) {
       carry = null;
     } else if (framed) carry = null;
     if (timing.cameraDuring && timing.end > timing.commandsEnd) {
-      const spec = _chunkJAOSL334cjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'access', _63 => _63.camera, 'optionalAccess', _64 => _64.during]));
+      const spec = _chunkGHCSC2WPcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'access', _63 => _63.camera, 'optionalAccess', _64 => _64.during]));
       const from = _nullishCoalesce(carry, () => ( boxView(timing.commandsEnd)));
       const ms2 = timing.end - timing.commandsEnd;
       const last = view(spec.move, spec.values, from, from, 1, ms2);
@@ -1564,8 +1565,8 @@ var lerp = (a, b, t) => a + (b - a) * t;
 var smooth = (t) => t * t * (3 - 2 * t);
 function easeViews(from, to, u, stage) {
   const k = smooth(Math.min(1, Math.max(0, u)));
-  const a = _chunkJAOSL334cjs.cameraBoxOfView.call(void 0, from, stage);
-  const b = _chunkJAOSL334cjs.cameraBoxOfView.call(void 0, to, stage);
+  const a = _chunkGHCSC2WPcjs.cameraBoxOfView.call(void 0, from, stage);
+  const b = _chunkGHCSC2WPcjs.cameraBoxOfView.call(void 0, to, stage);
   const zoom = from.zoom * Math.pow(to.zoom / from.zoom, k);
   const cx = lerp(a.x + a.width / 2, b.x + b.width / 2, k);
   const cy = lerp(a.y + a.height / 2, b.y + b.height / 2, k);
@@ -1597,7 +1598,7 @@ function motionCameraViewAt(scene, time, provider) {
   return retaken ? null : before.after;
 }
 function motionCameraBox(view, scene) {
-  return _chunkJAOSL334cjs.cameraBoxOfView.call(void 0, view, motionCameraStage(scene));
+  return _chunkGHCSC2WPcjs.cameraBoxOfView.call(void 0, view, motionCameraStage(scene));
 }
 function motionCameraTransform(view, width) {
   if (!view || !view.tilt && !view.turn) return "";
@@ -1638,7 +1639,7 @@ async function checkMotionCameraMoves(scene, provider) {
       const spec = shot.camera[field];
       if (spec === void 0) continue;
       try {
-        await _chunkJAOSL334cjs.resolveCameraMoveSpec.call(void 0, provider, spec, role);
+        await _chunkGHCSC2WPcjs.resolveCameraMoveSpec.call(void 0, provider, spec, role);
       } catch (error) {
         const code = error.code === "invalid_values" || /preset/.test(error.message) ? "camera-move-values" : "camera-move-unknown";
         issues.push(_chunkDGWOGQJ5cjs.motionIssue.call(void 0, code, error.message, { shot: shot.id }));
@@ -1666,7 +1667,7 @@ function motionLayerSpans(scene) {
     (_nullishCoalesce(shot.layers, () => ( []))).forEach((layer, index) => {
       const start = at(shotIndex2, layer.from, shots[shotIndex2].start);
       const end = Math.max(start, at(shotIndex2, _nullishCoalesce(layer.until, () => ( { shots: 1 })), total));
-      out.push({ layer, shot: shot.id, shotIndex: shotIndex2, index, role: _chunkJWCKJNDRcjs.effectLayerRole.call(void 0, layer), start, end });
+      out.push({ layer, shot: shot.id, shotIndex: shotIndex2, index, role: _chunkK5DS2JTAcjs.effectLayerRole.call(void 0, layer), start, end });
     });
   });
   spanCache.set(scene, out);
@@ -1761,7 +1762,7 @@ var MotionLayersEngine = (_class = class {
   __init6() {this.generation = 0}
   
   constructor(options = {}) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);_class.prototype.__init5.call(this);_class.prototype.__init6.call(this);_class.prototype.__init7.call(this);_class.prototype.__init8.call(this);
-    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkJAOSL334cjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkGHCSC2WPcjs.EffectsSlot)()));
     this.host = _nullishCoalesce(options.host, () => ( null));
     this.frameSvg = options.frameSvg;
     this.options = { scale: _nullishCoalesce(options.scale, () => ( 1)), maxSize: _nullishCoalesce(options.maxSize, () => ( 1280)), fps: _nullishCoalesce(options.fps, () => ( 30)), maxEntries: _nullishCoalesce(options.maxEntries, () => ( 160)) };
@@ -1881,8 +1882,8 @@ var MotionLayersEngine = (_class = class {
     const effect = layer.effect;
     this.request(key, { layer: layer.id }, async () => {
       const d = await this.describe(effect);
-      const values = _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, layer.values);
-      const input = _chunkJWCKJNDRcjs.effectLayerInput.call(void 0, d);
+      const values = _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, layer.values);
+      const input = _chunkK5DS2JTAcjs.effectLayerInput.call(void 0, d);
       const inputs = layer.subject && input ? { [input]: await this.subjectPixels(layer.subject, size) } : void 0;
       const pixels = await this.pool.render(provider, effect, size, { time, values, ...inputs ? { inputs } : {} });
       return host.encode(pixels);
@@ -1903,7 +1904,7 @@ var MotionLayersEngine = (_class = class {
     const fromKey = `from:${sceneId(scene)}:${active.shot}:${size.width}x${size.height}`;
     this.request(key, { transition: active.shot }, async () => {
       const d = await this.describe(t.effect);
-      const values = _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, t.values);
+      const values = _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, t.values);
       frameSvg(scene, Math.max(0, active.start - 1e-3));
       frameSvg(scene, at);
       await this.idleExcept(key);
@@ -3320,7 +3321,7 @@ function toFlairSvgMotion(scene, options = {}) {
     if (w) return `${w.move}@${w.shot}`;
     const seg = camera.find((x) => t >= x.start - 1e-6 && t < Math.max(x.end, x.start + 1e-3));
     const shot = seg ? scene.shots.find((x) => x.id === seg.shot) : void 0;
-    const move = _optionalChain([_chunkJAOSL334cjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'optionalAccess', _155 => _155.camera, 'optionalAccess', _156 => _156.in])), 'optionalAccess', _157 => _157.move]);
+    const move = _optionalChain([_chunkGHCSC2WPcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'optionalAccess', _155 => _155.camera, 'optionalAccess', _156 => _156.in])), 'optionalAccess', _157 => _157.move]);
     return move && shot ? `${move}@${shot.id}` : void 0;
   };
   const unplayed = scene.shots.filter((x) => x.camera && (x.camera.in !== void 0 || x.camera.during !== void 0) && !windows.some((w) => w.shot === x.id));
@@ -4424,7 +4425,7 @@ var kindHint = (d) => {
 function withPreset(d, preset2, values) {
   if (preset2 === void 0) return values;
   const p = d.presets.find((x) => x.name === preset2);
-  if (!p) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" has no preset "${preset2}"; ${d.presets.length ? `its presets are ${d.presets.map((x) => `"${x.name}"`).join(", ")}` : "it has no presets"}.`, d.id);
+  if (!p) throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`"${d.id}" has no preset "${preset2}"; ${d.presets.length ? `its presets are ${d.presets.map((x) => `"${x.name}"`).join(", ")}` : "it has no presets"}.`, d.id);
   return { ...p.values, ..._nullishCoalesce(values, () => ( {})) };
 }
 async function resolveMotionShotLayer(provider, layer) {
@@ -4434,27 +4435,27 @@ async function resolveMotionShotLayer(provider, layer) {
     const { provider: _p, name: _n, ...rest } = layer;
     return rest;
   }
-  if (!provider) throw new (0, _chunkJAOSL334cjs.NoEffectsProviderError)();
+  if (!provider) throw new (0, _chunkGHCSC2WPcjs.NoEffectsProviderError)();
   const d = await provider.describe(layer.effect);
-  if (!_chunkJWCKJNDRcjs.effectLayerOffered.call(void 0, d)) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) cannot be a layer; ${kindHint(d)}. A layer's effect is a generator, filter, overlay or title (search_effects with use "generator", "filter", "overlay" or "title").`, d.id);
-  const input = _chunkJWCKJNDRcjs.effectLayerInput.call(void 0, d);
-  if (layer.subject && !input) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) draws its own picture and takes no subject; leave "subject" out, or pick a filter to change the subject.`, d.id);
-  if (!layer.subject && input && _optionalChain([d, 'access', _198 => _198.inputs, 'access', _199 => _199.find, 'call', _200 => _200((i) => i.name === input), 'optionalAccess', _201 => _201.required])) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) changes a picture; give a "subject": { "image": url }, { "svg": markup }, { "text": words } or { "slot": name }.`, d.id);
+  if (!_chunkK5DS2JTAcjs.effectLayerOffered.call(void 0, d)) throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) cannot be a layer; ${kindHint(d)}. A layer's effect is a generator, filter, overlay or title (search_effects with use "generator", "filter", "overlay" or "title").`, d.id);
+  const input = _chunkK5DS2JTAcjs.effectLayerInput.call(void 0, d);
+  if (layer.subject && !input) throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) draws its own picture and takes no subject; leave "subject" out, or pick a filter to change the subject.`, d.id);
+  if (!layer.subject && input && _optionalChain([d, 'access', _198 => _198.inputs, 'access', _199 => _199.find, 'call', _200 => _200((i) => i.name === input), 'optionalAccess', _201 => _201.required])) throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) changes a picture; give a "subject": { "image": url }, { "svg": markup }, { "text": words } or { "slot": name }.`, d.id);
   const values = withPreset(d, layer.preset, layer.values);
-  _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, values);
+  _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, values);
   const out = { ...layer, provider: provider.id, name: d.name };
   if (values && Object.keys(values).length) out.values = values;
   else delete out.values;
   return out;
 }
 async function resolveMotionShotTransition(provider, transition) {
-  if (!provider) throw new (0, _chunkJAOSL334cjs.NoEffectsProviderError)();
+  if (!provider) throw new (0, _chunkGHCSC2WPcjs.NoEffectsProviderError)();
   const d = await provider.describe(transition.effect);
-  if (!d.uses.includes("transition") || d.kind === "camera") throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is not a transition (${kindHint(d)}); search_effects with use "transition" lists them.`, d.id);
+  if (!d.uses.includes("transition") || d.kind === "camera") throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is not a transition (${kindHint(d)}); search_effects with use "transition" lists them.`, d.id);
   if (transition.ms !== void 0 && !(transition.ms > 0 && transition.ms <= 6e4)) throw new Error(`A transition's "ms" is from 1 to 60000; got ${transition.ms}.`);
   const values = withPreset(d, transition.preset, transition.values);
-  _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, values);
-  const out = { ...transition, ms: _nullishCoalesce(transition.ms, () => ( _chunkJAOSL334cjs.EFFECT_TRANSITION_MS)), provider: provider.id, name: d.name };
+  _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, values);
+  const out = { ...transition, ms: _nullishCoalesce(transition.ms, () => ( _chunkGHCSC2WPcjs.EFFECT_TRANSITION_MS)), provider: provider.id, name: d.name };
   if (values && Object.keys(values).length) out.values = values;
   else delete out.values;
   return out;
@@ -4606,9 +4607,19 @@ function motionPartsFromVectorEffect(artwork, motion, source, box2 = { x: 0, y:
   const art = imported.scene.artwork;
   const prefix = `${source.instance}-`;
   const { nodes, shots } = prefixed(art.nodes, imported.scene.shots, prefix);
-  const k = Math.min(box2.width / art.width, box2.height / art.height);
-  const dx = box2.x + (box2.width - art.width * k) / 2;
-  const dy = box2.y + (box2.height - art.height * k) / 2;
+  let k;
+  let dx;
+  let dy;
+  if (box2 === "viewBox") {
+    const vb = _nullishCoalesce(_optionalChain([/viewBox\s*=\s*["']([^"']+)["']/, 'access', _215 => _215.exec, 'call', _216 => _216(motion.svg), 'optionalAccess', _217 => _217[1], 'access', _218 => _218.trim, 'call', _219 => _219(), 'access', _220 => _220.split, 'call', _221 => _221(/[\s,]+/), 'access', _222 => _222.map, 'call', _223 => _223(Number)]), () => ( []));
+    k = 1;
+    dx = vb.length === 4 && Number.isFinite(vb[0]) ? vb[0] : 0;
+    dy = vb.length === 4 && Number.isFinite(vb[1]) ? vb[1] : 0;
+  } else {
+    k = Math.min(box2.width / art.width, box2.height / art.height);
+    dx = box2.x + (box2.width - art.width * k) / 2;
+    dy = box2.y + (box2.height - art.height * k) / 2;
+  }
   const group = { type: "group", id: source.instance, name: _nullishCoalesce(source.name, () => ( source.effect)), children: nodes, transform: [k, 0, 0, k, dx, dy] };
   const tagged = shots.map((s, i) => ({ ...s, id: i === 0 ? source.instance + "-shot" : `${source.instance}-shot-${i + 1}`, run: tag(s.run, source) }));
   return { group, shots: tagged.map((s) => s.hold === 0 ? (({ hold: _h, ...rest }) => rest)(s) : s), notes: imported.notes };
@@ -4619,7 +4630,7 @@ function withoutMotionEffect(scene, instance) {
   const shots = [];
   for (const shot of scene.shots) {
     const run = shot.run.filter((c, i) => {
-      const mine = _optionalChain([sourceOf, 'call', _215 => _215(c), 'optionalAccess', _216 => _216.instance]) === instance;
+      const mine = _optionalChain([sourceOf, 'call', _224 => _224(c), 'optionalAccess', _225 => _225.instance]) === instance;
       if (mine && !place) place = { shot: shot.id, index: i };
       return !mine;
     });
@@ -4639,7 +4650,7 @@ var AnimationEditorController = (_class2 = class {
   
   
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init9() {this.effects = new (0, _chunkJAOSL334cjs.EffectsSlot)()}
+  __init9() {this.effects = new (0, _chunkGHCSC2WPcjs.EffectsSlot)()}
   /** Renders shot layer and transition pictures for frames (see `MotionLayersEngine`). */
   
   
@@ -4714,7 +4725,7 @@ var AnimationEditorController = (_class2 = class {
       time: p.time,
       playing: p.playing,
       loop: p.loop,
-      currentShot: _nullishCoalesce(_optionalChain([motionShotAt, 'call', _217 => _217(timeline, p.time), 'optionalAccess', _218 => _218.id]), () => ( null)),
+      currentShot: _nullishCoalesce(_optionalChain([motionShotAt, 'call', _226 => _226(timeline, p.time), 'optionalAccess', _227 => _227.id]), () => ( null)),
       selection: this.selection,
       readOnly: this.readOnly,
       error: this.error,
@@ -4763,7 +4774,7 @@ var AnimationEditorController = (_class2 = class {
       this.applying = false;
     }
     this.notify();
-    _optionalChain([this, 'access', _219 => _219.onChange, 'optionalCall', _220 => _220(scene)]);
+    _optionalChain([this, 'access', _228 => _228.onChange, 'optionalCall', _229 => _229(scene)]);
   }
   commit(label, next, merge) {
     const before = this.scene;
@@ -4833,7 +4844,7 @@ var AnimationEditorController = (_class2 = class {
     try {
       plan = await work();
     } catch (error) {
-      if (_chunkJAOSL334cjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunkGHCSC2WPcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
     const r = this.apply({ op: "replace_scene", scene: plan.scene }, plan.label, { merge });
@@ -4844,11 +4855,11 @@ var AnimationEditorController = (_class2 = class {
   }
   async describeFor(effect, kinds) {
     const provider = this.effects.require();
-    if (!provider.applyVectorEffect) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
+    if (!provider.applyVectorEffect) throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
     const d = await provider.describe(effect);
     if (!kinds.includes(d.kind)) {
       const hint = d.kind === "motion" ? "apply it to nodes with apply_effect" : d.kind === "vector" ? "add it with add_vector_effect" : "it draws pixels, which scenes cannot hold";
-      throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
+      throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
     }
     return d;
   }
@@ -4869,7 +4880,7 @@ var AnimationEditorController = (_class2 = class {
     return this.effectEdit(async () => {
       this.knownNodes(targets);
       const d = await this.describeFor(effect, ["motion"]);
-      const values = _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, options.values);
       const instance = _nullishCoalesce(options.instance, () => ( nextMotionEffectInstance(this.scene)));
       const motion = await this.effects.require().applyVectorEffect(d.id, { svg: motionArtworkSvg(this.scene.artwork), nodeIds: [...targets] }, values);
       const source = { instance, effect: d.id, provider: this.effects.require().id, name: d.name, values };
@@ -4891,11 +4902,34 @@ var AnimationEditorController = (_class2 = class {
   addVectorEffect(effect, options = {}) {
     return this.effectEdit(async () => {
       const d = await this.describeFor(effect, ["vector"]);
-      const values = _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, options.values);
+      let given = options.values;
+      let place = options.box;
+      if (options.path) {
+        const controls = _chunkGHCSC2WPcjs.pathControlsOf.call(void 0, d);
+        if (!controls.length) throw new Error(`"${d.id}" does not draw along a path. Find one that does with search_effects accepts ["path"] (kind vector).`);
+        const control = _nullishCoalesce(options.control, () => ( (controls.length === 1 ? controls[0] : void 0)));
+        if (!control) throw new Error(`"${d.id}" has several path controls (${controls.join(", ")}); pass control.`);
+        if (!controls.includes(control)) throw new Error(`"${control}" is not a path control of "${d.id}"; its path controls are ${controls.join(", ")}.`);
+        let value;
+        if ("node" in options.path) {
+          const entry = indexMotionNodes(this.scene.artwork.nodes).get(options.path.node);
+          if (!entry) throw new Error(`There is no node "${options.path.node}"; find_animation_elements lists the artwork's nodes.`);
+          if (entry.node.type !== "path") throw new Error(`Node "${options.path.node}" is a ${entry.node.type}, not a path; pass a path node (find_animation_elements shows each node's type).`);
+          value = _chunkGF2RBSDMcjs.bezierPathToSvg.call(void 0, _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, entry.node, entry.parentWorld, { effects: false }));
+          place ??= "viewBox";
+        } else {
+          const provider = this.effects.require();
+          if (!provider.pathFromText) throw new Error(`The effects provider "${provider.id}" cannot write words as a path; pass a path node instead.`);
+          if (typeof options.path.text !== "string" || !options.path.text.trim()) throw new Error("text is empty; pass the words to write.");
+          value = await provider.pathFromText(options.path.text, { ...options.path.font ? { font: options.path.font } : {}, ...options.path.align ? { align: options.path.align } : {} });
+        }
+        given = { ..._nullishCoalesce(given, () => ( {})), [control]: value };
+      }
+      const values = _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, given);
       const instance = _nullishCoalesce(options.instance, () => ( nextMotionEffectInstance(this.scene)));
       const motion = await this.effects.require().applyVectorEffect(d.id, motionArtworkSvg(this.scene.artwork), values);
       const source = { instance, effect: d.id, provider: this.effects.require().id, name: d.name, values };
-      const { group, shots, notes } = motionPartsFromVectorEffect(this.scene.artwork, motion, source, options.box);
+      const { group, shots, notes } = motionPartsFromVectorEffect(this.scene.artwork, motion, source, place);
       return { scene: { ...this.scene, artwork: { ...this.scene.artwork, nodes: [...this.scene.artwork.nodes, group] }, shots: [...this.scene.shots, ...shots] }, label: `Add ${d.name}`, instance, notes };
     });
   }
@@ -4915,7 +4949,7 @@ var AnimationEditorController = (_class2 = class {
         else if (k in d.controls.properties) base[k] = d.defaults[k];
         else throw new Error(`"${k}" is not a control of "${d.id}"; its controls are ${Object.keys(d.controls.properties).join(", ")}.`);
       }
-      const merged = { ...base, ..._chunkJAOSL334cjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+      const merged = { ...base, ..._chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
       const { scene: bare, place } = withoutMotionEffect(this.scene, instance);
       const provider = this.effects.require();
       const source = { instance, effect: d.id, provider: provider.id, name: d.name, values: merged };
@@ -4925,7 +4959,7 @@ var AnimationEditorController = (_class2 = class {
         const { group, shots: shots2, notes: notes2 } = motionPartsFromVectorEffect(bare.artwork, motion2, source);
         const index = this.scene.artwork.nodes.findIndex((n2) => n2.id === instance);
         const nodes = [...bare.artwork.nodes];
-        nodes.splice(Math.max(0, index), 0, _optionalChain([old, 'optionalAccess', _221 => _221.transform]) ? { ...group, transform: old.transform } : group);
+        nodes.splice(Math.max(0, index), 0, _optionalChain([old, 'optionalAccess', _230 => _230.transform]) ? { ...group, transform: old.transform } : group);
         const at = this.scene.shots.findIndex((s) => was.shots.includes(s.id));
         const kept = bare.shots;
         const nextShots = [...kept.slice(0, Math.max(0, at)), ...shots2, ...kept.slice(Math.max(0, at))];
@@ -4936,7 +4970,7 @@ var AnimationEditorController = (_class2 = class {
       let shots = bare.shots;
       if (place && shots.some((s) => s.id === place.shot)) shots = shots.map((s) => s.id === place.shot ? { ...s, run: [...s.run.slice(0, place.index), ...commands, ...s.run.slice(place.index)] } : s);
       else {
-        const at = this.scene.shots.findIndex((s) => s.id === _optionalChain([place, 'optionalAccess', _222 => _222.shot]));
+        const at = this.scene.shots.findIndex((s) => s.id === _optionalChain([place, 'optionalAccess', _231 => _231.shot]));
         shots = [...shots.slice(0, Math.max(0, at)), { id: instance, label: d.name, run: commands }, ...shots.slice(Math.max(0, at))];
       }
       return { scene: { ...bare, shots }, label: `Change ${d.name}`, instance, notes };
@@ -4970,12 +5004,12 @@ var AnimationEditorController = (_class2 = class {
     if (!found) return this.refuse(`There is no shot "${shot}"; the shots are ${this.scene.shots.map((s) => `"${s.id}"`).join(", ") || "none yet"}.`);
     let resolved;
     try {
-      resolved = await _chunkJAOSL334cjs.resolveCameraMoveSpec.call(void 0, this.effects.require(), spec, role);
+      resolved = await _chunkGHCSC2WPcjs.resolveCameraMoveSpec.call(void 0, this.effects.require(), spec, role);
     } catch (error) {
-      if (_chunkJAOSL334cjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunkGHCSC2WPcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
-    const field = _chunkJAOSL334cjs.cameraMoveField.call(void 0, role);
+    const field = _chunkGHCSC2WPcjs.cameraMoveField.call(void 0, role);
     const current = this.scene.shots.find((s) => s.id === shot);
     if (!current) return this.refuse(`Shot "${shot}" was removed while the move was checked.`);
     const parts = role === "transition" && resolved.spec.ms === void 0 ? { ...resolved.spec, ms: resolved.description.camera.durationMs } : resolved.spec;
@@ -4989,8 +5023,8 @@ var AnimationEditorController = (_class2 = class {
   clearShotCameraMove(shot, role) {
     const found = this.scene.shots.find((s) => s.id === shot);
     if (!found) return this.refuse(`There is no shot "${shot}"; the shots are ${this.scene.shots.map((s) => `"${s.id}"`).join(", ") || "none yet"}.`);
-    const field = _chunkJAOSL334cjs.cameraMoveField.call(void 0, role);
-    if (_optionalChain([found, 'access', _223 => _223.camera, 'optionalAccess', _224 => _224[field]]) === void 0) return this.refuse(`Shot "${shot}" has no camera "${field}" move to clear${_optionalChain([found, 'access', _225 => _225.camera, 'optionalAccess', _226 => _226[field === "in" ? "during" : "in"]]) !== void 0 ? `; it has a "${field === "in" ? "during" : "in"}" move (role ${role === "hold" ? "transition" : "hold"})` : ""}.`);
+    const field = _chunkGHCSC2WPcjs.cameraMoveField.call(void 0, role);
+    if (_optionalChain([found, 'access', _232 => _232.camera, 'optionalAccess', _233 => _233[field]]) === void 0) return this.refuse(`Shot "${shot}" has no camera "${field}" move to clear${_optionalChain([found, 'access', _234 => _234.camera, 'optionalAccess', _235 => _235[field === "in" ? "during" : "in"]]) !== void 0 ? `; it has a "${field === "in" ? "during" : "in"}" move (role ${role === "hold" ? "transition" : "hold"})` : ""}.`);
     const rest = { ...found.camera };
     delete rest[field];
     const keep = motionCameraFramed(rest) || rest.in !== void 0 || rest.during !== void 0;
@@ -5000,7 +5034,7 @@ var AnimationEditorController = (_class2 = class {
   }
   cameraMoveResult(shot, role, move) {
     const timing = compileMotionScene(this.scene).shots.find((s) => s.id === shot);
-    const camera = _nullishCoalesce(_optionalChain([this, 'access', _227 => _227.scene, 'access', _228 => _228.shots, 'access', _229 => _229.find, 'call', _230 => _230((s) => s.id === shot), 'optionalAccess', _231 => _231.camera]), () => ( null));
+    const camera = _nullishCoalesce(_optionalChain([this, 'access', _236 => _236.scene, 'access', _237 => _237.shots, 'access', _238 => _238.find, 'call', _239 => _239((s) => s.id === shot), 'optionalAccess', _240 => _240.camera]), () => ( null));
     const window = role === "transition" ? { start: timing.start, end: timing.commandsStart } : { start: timing.commandsEnd, end: timing.end };
     const notes = [];
     if (move && role === "transition" && timing.index === 0) notes.push('This is the first shot, which cuts to its framing, so its "in" move does not play; it plays from the second shot on.');
@@ -5071,7 +5105,7 @@ var AnimationEditorController = (_class2 = class {
   viewScene() {
     const r = this.recording;
     if (!r) return this.scene;
-    if (_optionalChain([r, 'access', _232 => _232.preview, 'optionalAccess', _233 => _233.count]) === r.samples.length) return r.preview.scene;
+    if (_optionalChain([r, 'access', _241 => _241.preview, 'optionalAccess', _242 => _242.count]) === r.samples.length) return r.preview.scene;
     let scene = this.scene;
     if (r.samples.length) {
       try {
@@ -5131,7 +5165,7 @@ var AnimationEditorController = (_class2 = class {
     try {
       plan = await work();
     } catch (error) {
-      if (_chunkJAOSL334cjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunkGHCSC2WPcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
     const id = this.scene.shots[plan.shot].id;
@@ -5213,14 +5247,14 @@ var AnimationEditorController = (_class2 = class {
       const { provider: _p, name: _n, ...given } = transition;
       resolved = await resolveMotionShotTransition(this.effects.provider, given);
     } catch (error) {
-      if (_chunkJAOSL334cjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunkGHCSC2WPcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
     if (!this.scene.shots.some((s) => s.id === shot)) return this.refuse(`Shot "${shot}" was removed while the transition was checked.`);
     const r = this.apply({ op: "update_shot", shot, set: { transition: resolved } }, `Transition ${_nullishCoalesce(resolved.name, () => ( resolved.effect))}`, { merge: options.merge });
     if (!r.ok) return r;
     const camera = this.scene.shots.find((s) => s.id === shot).camera;
-    return this.layerResult(shot, void 0, _optionalChain([camera, 'optionalAccess', _234 => _234.in]) === void 0 ? ["With no camera move in, the camera cuts to this shot's framing and the transition does the move."] : []);
+    return this.layerResult(shot, void 0, _optionalChain([camera, 'optionalAccess', _243 => _243.in]) === void 0 ? ["With no camera move in, the camera cuts to this shot's framing and the transition does the move."] : []);
   }
   /** Removes a shot's transition. One undo step. Works without a provider. */
   clearShotTransition(shot) {
@@ -5245,9 +5279,9 @@ var AnimationEditorController = (_class2 = class {
     const mode = _nullishCoalesce(options.mode, () => ( "replace"));
     let filled;
     try {
-      filled = await _chunkJWCKJNDRcjs.fillEffectTemplate.call(void 0, this.effects.provider, template, values, options.name ? { name: options.name } : {});
+      filled = await _chunkK5DS2JTAcjs.fillEffectTemplate.call(void 0, this.effects.provider, template, values, options.name ? { name: options.name } : {});
     } catch (error) {
-      if (_chunkJAOSL334cjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunkGHCSC2WPcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
     const provider = this.effects.provider.id;
@@ -5334,13 +5368,13 @@ var AnimationEditorController = (_class2 = class {
   }
   /** Records the drag's pose with the pointer at `point` (document units). */
   updateRecordGesture(point) {
-    const g = _optionalChain([this, 'access', _235 => _235.recording, 'optionalAccess', _236 => _236.gesture]);
+    const g = _optionalChain([this, 'access', _244 => _244.recording, 'optionalAccess', _245 => _245.gesture]);
     if (g) this.recordGesture(g.pose, point);
   }
   /** Ends the stage drag (the take keeps recording). */
   endRecordGesture() {
     const r = this.recording;
-    if (!_optionalChain([r, 'optionalAccess', _237 => _237.gesture])) return;
+    if (!_optionalChain([r, 'optionalAccess', _246 => _246.gesture])) return;
     r.gesture = null;
     this.notify();
   }
@@ -5354,7 +5388,7 @@ var AnimationEditorController = (_class2 = class {
       this.recordSample(g.node, { scaleX: Math.max(0.01, pose.scaleX * f), scaleY: Math.max(0.01, pose.scaleY * f) });
     } else {
       const turn = (Math.atan2(point.y - c.y, point.x - c.x) - Math.atan2(g.from.y - c.y, g.from.x - c.x)) * (180 / Math.PI);
-      const was = _nullishCoalesce(_optionalChain([this, 'access', _238 => _238.recording, 'access', _239 => _239.samples, 'access', _240 => _240.filter, 'call', _241 => _241((s) => s.node === g.node && s.rotation !== void 0), 'access', _242 => _242.at, 'call', _243 => _243(-1), 'optionalAccess', _244 => _244.rotation]), () => ( pose.rotation));
+      const was = _nullishCoalesce(_optionalChain([this, 'access', _247 => _247.recording, 'access', _248 => _248.samples, 'access', _249 => _249.filter, 'call', _250 => _250((s) => s.node === g.node && s.rotation !== void 0), 'access', _251 => _251.at, 'call', _252 => _252(-1), 'optionalAccess', _253 => _253.rotation]), () => ( pose.rotation));
       let next = pose.rotation + turn;
       next += 360 * Math.round((was - next) / 360);
       this.recordSample(g.node, { rotation: next });
@@ -5448,7 +5482,7 @@ function elementsOf(args) {
   if (Array.isArray(args.ops)) {
     for (const op of args.ops) {
       fromShot(op);
-      if (Array.isArray(_optionalChain([op, 'optionalAccess', _245 => _245.shots]))) op.shots.forEach(fromShot);
+      if (Array.isArray(_optionalChain([op, 'optionalAccess', _254 => _254.shots]))) op.shots.forEach(fromShot);
     }
   }
   return out.slice(0, 4);
@@ -5630,7 +5664,7 @@ var MOTION_COMMAND_SCHEMA = {
   oneOf: MOTION_COMMAND_TYPES.map((type) => MOTION_COMMAND_TYPE_SCHEMAS[type])
 };
 var REF2 = (name, description) => ({ $ref: `#/$defs/${name}`, ...description ? { description } : {} });
-var firstSentence = (text) => _nullishCoalesce(_optionalChain([/^.*?[.;](?=\s|$)/, 'access', _246 => _246.exec, 'call', _247 => _247(text), 'optionalAccess', _248 => _248[0]]), () => ( text));
+var firstSentence = (text) => _nullishCoalesce(_optionalChain([/^.*?[.;](?=\s|$)/, 'access', _255 => _255.exec, 'call', _256 => _256(text), 'optionalAccess', _257 => _257[0]]), () => ( text));
 var COMMAND_TYPE_LINES = MOTION_COMMAND_TYPES.map((type) => `${type}: ${firstSentence(_nullishCoalesce(MOTION_COMMAND_TYPE_SCHEMAS[type].description, () => ( "")))}`);
 var EASE_COMPACT = {
   description: `Easing: a preset, or a curve { "type": "cubic-bezier", x1, y1, x2, y2 }, { "type": "spring", stiffness, damping, mass, velocity } (spring presets are Figma's; with no "duration" it lasts until it settles) or { "type": "elastic", amplitude, period, mode }. Default: ease-out for entrances, ease-in-out for moves.`,
@@ -6039,9 +6073,9 @@ function createAnimationEditorToolProvider(controller, options = {}) {
     handler: ({ from = 0, to, limit = 200 }) => {
       const s = scene();
       const timeline = compileMotionScene(s);
-      const words = _nullishCoalesce(_optionalChain([s, 'access', _249 => _249.narration, 'optionalAccess', _250 => _250.words]), () => ( []));
+      const words = _nullishCoalesce(_optionalChain([s, 'access', _258 => _258.narration, 'optionalAccess', _259 => _259.words]), () => ( []));
       const end = _nullishCoalesce(to, () => ( Math.max(timeline.duration, words.length ? _nullishCoalesce(words[words.length - 1].end, () => ( words[words.length - 1].start)) : 0)));
-      const shotAt = (ms2) => _optionalChain([timeline, 'access', _251 => _251.shots, 'access', _252 => _252.find, 'call', _253 => _253((x) => ms2 >= x.start && ms2 < x.end), 'optionalAccess', _254 => _254.id]);
+      const shotAt = (ms2) => _optionalChain([timeline, 'access', _260 => _260.shots, 'access', _261 => _261.find, 'call', _262 => _262((x) => ms2 >= x.start && ms2 < x.end), 'optionalAccess', _263 => _263.id]);
       const beats = [];
       if (s.beat && s.beat.bpm > 0) {
         const first = Math.max(0, Math.ceil(motionBeatAt(s.beat, from).beat - 1e-9));
@@ -6417,7 +6451,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
     inputSchema: object({ shot: SHOT_ID, commands: { type: "array", items: REF2("command"), minItems: 1, description: "Commands to add." }, at: { type: "integer", minimum: 0, description: "Index in the run (default: the end)." } }, ["shot", "commands"]),
     annotations: { title: "Add commands to a shot", ...WRITE },
     handler: ({ shot, commands, at }) => {
-      const before = _nullishCoalesce(_optionalChain([scene, 'call', _255 => _255(), 'access', _256 => _256.shots, 'access', _257 => _257.find, 'call', _258 => _258((s) => s.id === shot), 'optionalAccess', _259 => _259.run, 'access', _260 => _260.length]), () => ( 0));
+      const before = _nullishCoalesce(_optionalChain([scene, 'call', _264 => _264(), 'access', _265 => _265.shots, 'access', _266 => _266.find, 'call', _267 => _267((s) => s.id === shot), 'optionalAccess', _268 => _268.run, 'access', _269 => _269.length]), () => ( 0));
       const first = _nullishCoalesce(at, () => ( before));
       return apply({ op: "add_commands", shot, commands, at }, "Add commands", (s) => {
         const shots = describeMotionShots(s);
@@ -6618,7 +6652,7 @@ var TIMING = /* @__PURE__ */ new Set(["duration", "delay", "stagger", "with", "e
 var COLORS = /* @__PURE__ */ new Set(["fill", "stroke", "color"]);
 var NODES = /* @__PURE__ */ new Set(["into", "path"]);
 function branch(type) {
-  return (_nullishCoalesce(MOTION_COMMAND_SCHEMA.oneOf, () => ( []))).find((b) => _optionalChain([b, 'access', _261 => _261.properties, 'optionalAccess', _262 => _262.type, 'optionalAccess', _263 => _263.const]) === type);
+  return (_nullishCoalesce(MOTION_COMMAND_SCHEMA.oneOf, () => ( []))).find((b) => _optionalChain([b, 'access', _270 => _270.properties, 'optionalAccess', _271 => _271.type, 'optionalAccess', _272 => _272.const]) === type);
 }
 function unitOf(type, name) {
   if (name === "duration" || name === "delay" || name === "stagger") return "ms";
@@ -6653,7 +6687,7 @@ function kindOf(name, schema) {
 }
 function motionCommandFields(type) {
   const schema = branch(type);
-  if (!_optionalChain([schema, 'optionalAccess', _264 => _264.properties])) return [];
+  if (!_optionalChain([schema, 'optionalAccess', _273 => _273.properties])) return [];
   const required = new Set(_nullishCoalesce(schema.required, () => ( [])));
   const fields2 = Object.entries(schema.properties).filter(([name]) => name !== "type").map(([name, s]) => {
     const kind = kindOf(name, s);
@@ -6710,7 +6744,7 @@ function defaultMotionCommand(type, targets, scene) {
   if (type === "wait") return { type: "wait", duration: 500 };
   if (!targets.length) return { error: "Pick a target first: click an element on the stage." };
   const nodes = [...indexMotionNodes(scene.artwork.nodes).values()];
-  const other = (pred) => _optionalChain([nodes, 'access', _265 => _265.find, 'call', _266 => _266((e) => !targets.includes(e.node.id) && pred(e)), 'optionalAccess', _267 => _267.node, 'access', _268 => _268.id]);
+  const other = (pred) => _optionalChain([nodes, 'access', _274 => _274.find, 'call', _275 => _275((e) => !targets.includes(e.node.id) && pred(e)), 'optionalAccess', _276 => _276.node, 'access', _277 => _277.id]);
   const base = { targets: [...targets] };
   switch (type) {
     case "scale":
@@ -6741,8 +6775,8 @@ function defaultMotionCommand(type, targets, scene) {
     }
     case "effect": {
       for (const id of targets) {
-        const node = _optionalChain([nodes, 'access', _269 => _269.find, 'call', _270 => _270((e) => e.node.id === id), 'optionalAccess', _271 => _271.node]);
-        for (const effect of _nullishCoalesce(_optionalChain([node, 'optionalAccess', _272 => _272.effects]), () => ( []))) {
+        const node = _optionalChain([nodes, 'access', _278 => _278.find, 'call', _279 => _279((e) => e.node.id === id), 'optionalAccess', _280 => _280.node]);
+        for (const effect of _nullishCoalesce(_optionalChain([node, 'optionalAccess', _281 => _281.effects]), () => ( []))) {
           const param = Object.entries(effect.params).find(([, v]) => typeof v === "number");
           if (param) return { type, ...base, effect: effect.id, param: param[0], to: param[1] + 1 };
         }
@@ -6767,11 +6801,11 @@ function motionCommandRows(scene, shotId) {
   return scene.shots[index].run.map((command3, i) => {
     const t = timeline.commands.find((c) => c.shotIndex === index && c.command === i);
     const primitive = motionFlairPrimitive(command3);
-    return { index: i, command: command3, summary: motionCommandSummary(command3), start: _nullishCoalesce(_optionalChain([t, 'optionalAccess', _273 => _273.start]), () => ( 0)), end: _nullishCoalesce(_optionalChain([t, 'optionalAccess', _274 => _274.end]), () => ( 0)), ...primitive ? { flairPrimitive: primitive } : {} };
+    return { index: i, command: command3, summary: motionCommandSummary(command3), start: _nullishCoalesce(_optionalChain([t, 'optionalAccess', _282 => _282.start]), () => ( 0)), end: _nullishCoalesce(_optionalChain([t, 'optionalAccess', _283 => _283.end]), () => ( 0)), ...primitive ? { flairPrimitive: primitive } : {} };
   });
 }
 function duplicateMotionCommandEdit(scene, shot, command3) {
-  const run = _nullishCoalesce(_optionalChain([scene, 'access', _275 => _275.shots, 'access', _276 => _276.find, 'call', _277 => _277((s) => s.id === shot), 'optionalAccess', _278 => _278.run]), () => ( []));
+  const run = _nullishCoalesce(_optionalChain([scene, 'access', _284 => _284.shots, 'access', _285 => _285.find, 'call', _286 => _286((s) => s.id === shot), 'optionalAccess', _287 => _287.run]), () => ( []));
   return { op: "add_commands", shot, commands: run[command3] ? [structuredClone(run[command3])] : [], at: command3 + 1 };
 }
 var MOTION_EASE_CHOICES = [
@@ -6856,7 +6890,7 @@ function motionCueFromKey(key) {
 function motionCueChoices(scene, limit = 256) {
   const choices = [];
   const s = (ms2) => `${(ms2 / 1e3).toFixed(2)} s`;
-  const end = Math.max(compileMotionScene(scene).duration, ..._nullishCoalesce(_optionalChain([scene, 'access', _279 => _279.narration, 'optionalAccess', _280 => _280.words, 'access', _281 => _281.map, 'call', _282 => _282((w) => _nullishCoalesce(w.end, () => ( w.start)))]), () => ( [0]))) + 2e3;
+  const end = Math.max(compileMotionScene(scene).duration, ..._nullishCoalesce(_optionalChain([scene, 'access', _288 => _288.narration, 'optionalAccess', _289 => _289.words, 'access', _290 => _290.map, 'call', _291 => _291((w) => _nullishCoalesce(w.end, () => ( w.start)))]), () => ( [0]))) + 2e3;
   if (scene.beat && scene.beat.bpm > 0) {
     for (let beat = 0; choices.length < limit; beat++) {
       const time = motionBeatTime(scene.beat, beat);
@@ -6866,7 +6900,7 @@ function motionCueChoices(scene, limit = 256) {
       choices.push({ value: `beat:${beat}`, label: `Beat ${beat} (bar ${at.bar}.${at.beatInBar}) \xB7 ${s(time)}`, time });
     }
   }
-  _optionalChain([scene, 'access', _283 => _283.narration, 'optionalAccess', _284 => _284.words, 'access', _285 => _285.forEach, 'call', _286 => _286((w, i) => {
+  _optionalChain([scene, 'access', _292 => _292.narration, 'optionalAccess', _293 => _293.words, 'access', _294 => _294.forEach, 'call', _295 => _295((w, i) => {
     if (choices.length < limit * 2) choices.push({ value: `word:${i}`, label: `Word ${i} \u201C${w.text}\u201D \xB7 ${s(w.start)}`, time: w.start });
   })]);
   return choices;
@@ -6875,7 +6909,7 @@ function motionShotCueTime(scene, cue) {
   return cue ? motionCueTime(scene, cue) : void 0;
 }
 function formatMotionNarration(narration) {
-  return (_nullishCoalesce(_optionalChain([narration, 'optionalAccess', _287 => _287.words]), () => ( []))).map((w) => `${w.start} ${w.text}`).join("\n");
+  return (_nullishCoalesce(_optionalChain([narration, 'optionalAccess', _296 => _296.words]), () => ( []))).map((w) => `${w.start} ${w.text}`).join("\n");
 }
 function parseMotionNarration(text) {
   const lines = text.split("\n").map((l) => l.trim()).filter(Boolean);
@@ -6918,7 +6952,7 @@ var ROLE = {
   enum: ["transition", "hold"],
   description: `transition: the move the camera gets into the shot with (its camera "in": a glide, whip pan, punch zoom, cut). hold: the move it makes while the shot holds (its camera "during": a Ken Burns drift, a crash zoom), played across the shot's hold.`
 };
-var summary = (e) => ({ id: e.id, name: e.name, role: e.camera.role, durationMs: e.camera.durationMs, ...e.camera.cut !== void 0 ? { cut: e.camera.cut } : {}, ...e.description ? { description: e.description } : {}, ..._optionalChain([e, 'access', _288 => _288.tags, 'optionalAccess', _289 => _289.length]) ? { tags: e.tags } : {} });
+var summary = (e) => ({ id: e.id, name: e.name, role: e.camera.role, durationMs: e.camera.durationMs, ...e.camera.cut !== void 0 ? { cut: e.camera.cut } : {}, ...e.description ? { description: e.description } : {}, ..._optionalChain([e, 'access', _297 => _297.tags, 'optionalAccess', _298 => _298.length]) ? { tags: e.tags } : {} });
 var done = (r) => {
   if (!r.ok) throw new Error(r.error);
   return { shot: r.shot, camera: r.camera, ...r.window ? { window: r.window } : {}, ...r.notes.length ? { notes: r.notes } : {} };
@@ -6947,7 +6981,7 @@ function animationCameraMoveTools(controller, ctx) {
           shot: { type: "string", minLength: 1, description: "A shot id from get_animation." },
           role: ROLE,
           move: { type: "string", minLength: 1, description: "A camera move id of that role from list_camera_moves." },
-          ms: { type: "number", minimum: 0, maximum: _chunkJAOSL334cjs.CAMERA_MOVE_MAX_MS, description: `How long a transition takes, ms (0\u2013${_chunkJAOSL334cjs.CAMERA_MOVE_MAX_MS}; default the move's durationMs). Not for a hold, which plays across the shot's hold.` },
+          ms: { type: "number", minimum: 0, maximum: _chunkGHCSC2WPcjs.CAMERA_MOVE_MAX_MS, description: `How long a transition takes, ms (0\u2013${_chunkGHCSC2WPcjs.CAMERA_MOVE_MAX_MS}; default the move's durationMs). Not for a hold, which plays across the shot's hold.` },
           preset: { type: "string", minLength: 1, description: "A preset of the move by name, from describe_effect; its values are written out on the shot." },
           values: ctx.valuesSchema("Control values over the move's defaults (and the preset's), from describe_effect")
         },
@@ -7020,7 +7054,7 @@ var fields = (ctx) => ({
   preset: { type: "string", minLength: 1, description: "A preset of the effect by name, from describe_effect; its values are written out on the layer." },
   values: ctx.valuesSchema("Control values over the effect's defaults (and the preset's), from describe_effect"),
   subject: SUBJECT,
-  role: { type: "string", enum: [..._chunkJAOSL334cjs.EFFECT_LAYER_ROLES], description: "background: under the artwork; subject: over the artwork; overlay: over everything. Default subject with a rect, else background." },
+  role: { type: "string", enum: [..._chunkGHCSC2WPcjs.EFFECT_LAYER_ROLES], description: "background: under the artwork; subject: over the artwork; overlay: over everything. Default subject with a rect, else background." },
   rect: RECT,
   from: TIME("starts", "0: as its shot starts"),
   until: TIME("stops", '{ "shots": 1 }: as the next shot starts'),
@@ -7110,7 +7144,7 @@ function animationShotLayerTools(controller, ctx) {
         properties: {
           shot: { ...SHOT2, description: "A shot id from get_animation (not the first shot)." },
           effect: { ...ctx.effectIdSchema(["transition"]), description: "A transition effect id from search_effects (use transition)." },
-          ms: { type: "number", exclusiveMinimum: 0, maximum: 6e4, description: `How long it takes, ms (default ${_chunkJAOSL334cjs.EFFECT_TRANSITION_MS}).` },
+          ms: { type: "number", exclusiveMinimum: 0, maximum: 6e4, description: `How long it takes, ms (default ${_chunkGHCSC2WPcjs.EFFECT_TRANSITION_MS}).` },
           preset: { type: "string", minLength: 1, description: "A preset of the transition by name, from describe_effect." },
           values: ctx.valuesSchema("Control values over the transition's defaults (and the preset's)")
         },
@@ -7146,7 +7180,7 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
     if (!r.ok) throw new Error(r.error);
     return { target, effect: info(r.effect), effects: controller.appliedEffects().filter((e) => e.targets.includes(target)).map(info), ...r.notes.length ? { notes: r.notes } : {} };
   };
-  return withAnimationPlayback(_chunkJAOSL334cjs.createEffectToolProvider.call(void 0, {
+  return withAnimationPlayback(_chunkGHCSC2WPcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "animation-effects")),
     namespace: options.namespace,
     title: "Animation effects",
@@ -7181,7 +7215,7 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
     extraTools: (ctx) => [
       ...animationCameraMoveTools(controller, ctx),
       ...animationShotLayerTools(controller, ctx),
-      ..._chunkJWCKJNDRcjs.effectTemplateTools.call(void 0, 
+      ..._chunkK5DS2JTAcjs.effectTemplateTools.call(void 0, 
         {
           provider: () => controller.effectsProvider,
           fillDetails: "mode replace (default) makes a new scene from the template's shots, the size of its stage; mode append adds its shots after the current ones, scaled to the artwork. Each shot keeps its framing and camera moves, its layers and its transition; its title and caption become overlay word layers. Returns { template, mode, shots (new shot ids), layers (new layer ids), openSlots, notes }. Check the result with render_animation_frame.",
@@ -7198,7 +7232,7 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
       {
         name: "add_vector_effect",
         title: "Add a vector effect",
-        description: "Adds a provider vector effect that brings its own picture (search_effects with kind vector: lower thirds, loaders, stickers): its SVG becomes an artwork group, fitted into box (default the whole artwork), and its motion becomes shots after the last one. Change it with update_effect (target and effect: the returned instance) or remove it with remove_effect. One undo step. Returns the instance, the group id and any notes on what could not be carried over.",
+        description: 'Adds a provider vector effect that brings its own picture (search_effects with kind vector: lower thirds, loaders, stickers): its SVG becomes an artwork group, fitted into box (default the whole artwork), and its motion becomes shots after the last one. For an effect that draws along a path (search_effects accepts ["path"]: a signature, a route), pass path: { node } to run it along a path node (its outline with every transform applied; the picture then lands on the node at scale 1 unless box is given) or { text } for words the provider writes. Use it instead of follow or draw-on when the effect itself should trace the path. The path is copied when added; add it again after reshaping the node. Change it with update_effect (target and effect: the returned instance) or remove it with remove_effect. One undo step. Returns the instance, the group id and any notes on what could not be carried over.',
         inputSchema: {
           type: "object",
           properties: {
@@ -7214,8 +7248,21 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
               },
               required: ["x", "y", "width", "height"],
               additionalProperties: false,
-              description: "Where the picture goes in the artwork, fitted keeping its proportions (default the whole artwork)."
-            }
+              description: "Where the picture goes in the artwork, fitted keeping its proportions (default the whole artwork; with path { node }, on the node at scale 1)."
+            },
+            path: {
+              type: "object",
+              description: "The path the effect draws along (only for effects with a path control): { node } or { text }.",
+              properties: {
+                node: { type: "string", minLength: 1, description: "A path node id (find_animation_elements)." },
+                text: { type: "string", minLength: 1, description: "Words the provider writes as a single-stroke path." },
+                font: { type: "string", minLength: 1, description: "With text: a single-stroke font the provider offers (default its first)." },
+                align: { type: "string", enum: ["start", "middle", "end"], description: "With text: where the line sits (default start)." }
+              },
+              oneOf: [{ required: ["node"] }, { required: ["text"] }],
+              additionalProperties: false
+            },
+            control: { type: "string", minLength: 1, description: "Which path control takes the path (default the effect's only one; describe_effect pathControls lists them)." }
           },
           required: ["effect"],
           additionalProperties: false
@@ -7223,7 +7270,9 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
         annotations: { title: "Add a vector effect", ...ctx.annotations.write },
         handler: async (args) => {
           ctx.requireProvider();
-          const r = await controller.addVectorEffect(args.effect, { values: args.values, box: args.box });
+          const path = args.path ? args.path.node !== void 0 ? { node: args.path.node } : { text: args.path.text, font: args.path.font, align: args.path.align } : void 0;
+          if (args.path && args.path.node !== void 0 && args.path.text !== void 0) throw new Error("Pass path as { node } or { text }, not both.");
+          const r = await controller.addVectorEffect(args.effect, { values: args.values, box: args.box, path, control: args.control });
           if (!r.ok) throw new Error(r.error);
           return { instance: r.effect.instance, group: r.effect.group, effect: info(r.effect), ...r.notes.length ? { notes: r.notes } : {} };
         }