@pixerate/editor 0.240.0 → 0.242.0

package/dist/animation-editor/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2;
 
-var _chunkZXNO3ZOXcjs = require('../chunk-ZXNO3ZOX.cjs');
+var _chunk7F4G74UQcjs = require('../chunk-7F4G74UQ.cjs');
 
 
 
@@ -16,7 +16,7 @@ var _chunkDGWOGQJ5cjs = require('../chunk-DGWOGQJ5.cjs');
 
 
 
-var _chunkJWCKJNDRcjs = require('../chunk-JWCKJNDR.cjs');
+var _chunkK5DS2JTAcjs = require('../chunk-K5DS2JTA.cjs');
 
 
 
@@ -39,8 +39,8 @@ var _chunkJWCKJNDRcjs = require('../chunk-JWCKJNDR.cjs');
 
 
 
-var _chunkTHXFU3JBcjs = require('../chunk-THXFU3JB.cjs');
-require('../chunk-NKTNLJUJ.cjs');
+var _chunkKCMV2534cjs = require('../chunk-KCMV2534.cjs');
+require('../chunk-5BR7LC24.cjs');
 require('../chunk-CVFAAZXE.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.`);
@@ -697,7 +698,7 @@ function smoothMotionTimes(points, start, duration, pacing = "even") {
 function motionTextLayout(nodes, id) {
   const group = _optionalChain([nodes, 'access', _5 => _5.get, 'call', _6 => _6(id), 'optionalAccess', _7 => _7.node]);
   if (!group || group.type !== "group") return null;
-  const letters = _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, group).map((p) => ({ id: p.id, b: _optionalChain([nodes, 'access', _8 => _8.get, 'call', _9 => _9(p.id), 'optionalAccess', _10 => _10.bounds]) })).filter((l) => !!l.b && l.b.width + l.b.height > 0);
+  const letters = _chunkKCMV2534cjs.collectPathNodes.call(void 0, group).map((p) => ({ id: p.id, b: _optionalChain([nodes, 'access', _8 => _8.get, 'call', _9 => _9(p.id), 'optionalAccess', _10 => _10.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))) {
@@ -782,21 +783,21 @@ function indexMotionNodes(nodes) {
   const out = /* @__PURE__ */ new Map();
   const walk = (list, parentWorld, ancestors) => {
     for (const node of list) {
-      const local = _chunkTHXFU3JBcjs.vectorNodeBounds.call(void 0, node);
-      const bounds = _chunkTHXFU3JBcjs.vectorNodeBounds.call(void 0, node, parentWorld);
+      const local = _chunkKCMV2534cjs.vectorNodeBounds.call(void 0, node);
+      const bounds = _chunkKCMV2534cjs.vectorNodeBounds.call(void 0, node, parentWorld);
       const center = local ? { x: local.x + local.width / 2, y: local.y + local.height / 2 } : { x: 0, y: 0 };
       if (!out.has(node.id)) out.set(node.id, { node, ancestors, parentWorld, center, bounds, box: local });
-      if (node.type === "group") walk(node.children, _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.nodeMatrix.call(void 0, node), parentWorld), [...ancestors, node.id]);
+      if (node.type === "group") walk(node.children, _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.nodeMatrix.call(void 0, node), parentWorld), [...ancestors, node.id]);
     }
   };
-  walk(nodes, _chunkTHXFU3JBcjs.IDENTITY_MATRIX, []);
+  walk(nodes, _chunkKCMV2534cjs.IDENTITY_MATRIX, []);
   indexCache.set(nodes, out);
   return out;
 }
 var solid = (paint) => typeof paint === "string" && paint !== "none" ? paint : void 0;
 function firstPaint(node, key) {
   if (node.type === "path") return solid(node[key]);
-  for (const p of _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node)) {
+  for (const p of _chunkKCMV2534cjs.collectPathNodes.call(void 0, node)) {
     const s = solid(p[key]);
     if (s) return s;
   }
@@ -804,7 +805,7 @@ function firstPaint(node, key) {
 }
 function strokeReach(node) {
   let reach = 0;
-  for (const p of node.type === "path" ? [node] : _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node)) {
+  for (const p of node.type === "path" ? [node] : _chunkKCMV2534cjs.collectPathNodes.call(void 0, node)) {
     if (p.stroke == null || p.stroke === "none") continue;
     const width = _nullishCoalesce(p.strokeWidth, () => ( 1));
     reach = Math.max(reach, p.strokeAlign === "outside" ? width : p.strokeAlign === "inside" ? 0 : width / 2);
@@ -874,7 +875,7 @@ function motionRestValue(entry, property, artwork) {
     case "stroke":
       return _nullishCoalesce((node && firstPaint(node, property)), () => ( "transparent"));
     case "strokeWidth": {
-      const path = _optionalChain([node, 'optionalAccess', _13 => _13.type]) === "path" ? node : node ? _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node)[0] : void 0;
+      const path = _optionalChain([node, 'optionalAccess', _13 => _13.type]) === "path" ? node : node ? _chunkKCMV2534cjs.collectPathNodes.call(void 0, node)[0] : void 0;
       return _nullishCoalesce(_optionalChain([path, 'optionalAccess', _14 => _14.strokeWidth]), () => ( 1));
     }
     case "shape":
@@ -985,12 +986,12 @@ function resolveMotionCamera(camera, scene) {
   const r = camera;
   return { x: r.x, y: r.y, width: r.width, height: r.height };
 }
-function motionPathLength(node, parentWorld = _chunkTHXFU3JBcjs.IDENTITY_MATRIX) {
+function motionPathLength(node, parentWorld = _chunkKCMV2534cjs.IDENTITY_MATRIX) {
   let longest = 0;
-  const paths = node.type === "path" ? [node] : _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node);
+  const paths = node.type === "path" ? [node] : _chunkKCMV2534cjs.collectPathNodes.call(void 0, node);
   for (const p of paths) {
     try {
-      longest = Math.max(longest, _chunkGF2RBSDMcjs.bezierPathLength.call(void 0, _chunkTHXFU3JBcjs.vectorPathWorldBezier.call(void 0, p, parentWorld, { effects: false })));
+      longest = Math.max(longest, _chunkGF2RBSDMcjs.bezierPathLength.call(void 0, _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, p, parentWorld, { effects: false })));
     } catch (e2) {
     }
   }
@@ -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);
@@ -1266,12 +1267,12 @@ function compileMotionScene(scene) {
       const order2 = _nullishCoalesce(o.order, () => ( "together"));
       const pace = _nullishCoalesce(o.pace, () => ( "time"));
       if (order2 === "together" && pace === "time") return null;
-      const paths = entry.node.type === "path" ? [entry.node] : _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, entry.node);
+      const paths = entry.node.type === "path" ? [entry.node] : _chunkKCMV2534cjs.collectPathNodes.call(void 0, entry.node);
       let list = paths.map((p) => {
         const at = nodes.get(p.id);
         let first = { x: 0, y: 0 };
         try {
-          const m = _chunkTHXFU3JBcjs.vectorPathWorldBezier.call(void 0, p, _nullishCoalesce(_optionalChain([at, 'optionalAccess', _42 => _42.parentWorld]), () => ( _chunkTHXFU3JBcjs.IDENTITY_MATRIX)), { effects: false })[0];
+          const m = _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, p, _nullishCoalesce(_optionalChain([at, 'optionalAccess', _42 => _42.parentWorld]), () => ( _chunkKCMV2534cjs.IDENTITY_MATRIX)), { effects: false })[0];
           if (m && m.type === "M") first = { x: m.x, y: m.y };
         } catch (e3) {
         }
@@ -1383,17 +1384,17 @@ function compileMotionScene(scene) {
         let dx = _nullishCoalesce(_optionalChain([command3, 'access', _45 => _45.by, 'optionalAccess', _46 => _46.x]), () => ( 0));
         let dy = _nullishCoalesce(_optionalChain([command3, 'access', _47 => _47.by, 'optionalAccess', _48 => _48.y]), () => ( 0));
         if (command3.to) {
-          const inv = _chunkTHXFU3JBcjs.invertMatrix.call(void 0, entry.parentWorld);
-          const target = _chunkTHXFU3JBcjs.applyMatrix.call(void 0, inv, command3.to);
+          const inv = _chunkKCMV2534cjs.invertMatrix.call(void 0, entry.parentWorld);
+          const target = _chunkKCMV2534cjs.applyMatrix.call(void 0, inv, command3.to);
           dx = target.x - (entry.center.x + num2("x"));
           dy = target.y - (entry.center.y + num2("y"));
         }
         if (_optionalChain([command3, 'access', _49 => _49.via, 'optionalAccess', _50 => _50.length])) {
-          const inv = _chunkTHXFU3JBcjs.invertMatrix.call(void 0, entry.parentWorld);
+          const inv = _chunkKCMV2534cjs.invertMatrix.call(void 0, entry.parentWorld);
           const x0 = num2("x");
           const y0 = num2("y");
           const add = command3.blend === "add";
-          const offsets = [{ x: 0, y: 0 }, ...command3.via.map((p) => _chunkTHXFU3JBcjs.applyMatrix.call(void 0, inv, p)).map((p) => ({ x: p.x - entry.center.x - x0, y: p.y - entry.center.y - y0 })), { x: dx, y: dy }];
+          const offsets = [{ x: 0, y: 0 }, ...command3.via.map((p) => _chunkKCMV2534cjs.applyMatrix.call(void 0, inv, p)).map((p) => ({ x: p.x - entry.center.x - x0, y: p.y - entry.center.y - y0 })), { x: dx, y: dy }];
           const times = _optionalChain([command3, 'access', _51 => _51.times, 'optionalAccess', _52 => _52.length]) === command3.via.length ? [start, ...command3.times.map((f) => start + f * (end - start)), end] : smoothMotionTimes(offsets, start, end - start, _nullishCoalesce(command3.pacing, () => ( "even")));
           for (const axis of ["x", "y"]) {
             const base = add ? 0 : axis === "x" ? x0 : y0;
@@ -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);
@@ -2016,13 +2017,13 @@ function morphBetween(a, b) {
   let inner = morphCache.get(a);
   if (!inner) morphCache.set(a, inner = /* @__PURE__ */ new WeakMap());
   let morph = inner.get(b);
-  if (!morph) inner.set(b, morph = _chunkZXNO3ZOXcjs.createVectorMorph.call(void 0, a, b, { id: a.id }));
+  if (!morph) inner.set(b, morph = _chunk7F4G74UQcjs.createVectorMorph.call(void 0, a, b, { id: a.id }));
   return morph;
 }
 function shapeIn(entry, shape) {
   if (shape === entry) return entry.node;
-  const m = _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.nodeMatrix.call(void 0, shape.node), shape.parentWorld), _chunkTHXFU3JBcjs.invertMatrix.call(void 0, entry.parentWorld));
-  return { ...shape.node, ..._chunkTHXFU3JBcjs.isIdentityMatrix.call(void 0, m) ? { transform: void 0 } : { transform: m } };
+  const m = _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.nodeMatrix.call(void 0, shape.node), shape.parentWorld), _chunkKCMV2534cjs.invertMatrix.call(void 0, entry.parentWorld));
+  return { ...shape.node, ..._chunkKCMV2534cjs.isIdentityMatrix.call(void 0, m) ? { transform: void 0 } : { transform: m } };
 }
 function shapeAt(entry, timeline, nodes, time) {
   const track = timeline.tracks.get(motionTrackKey(entry.node.id, "shape"));
@@ -2042,7 +2043,7 @@ function shapeAt(entry, timeline, nodes, time) {
 function motionFollowRoute(entry, path) {
   if (!path || path.node.type !== "path") return null;
   try {
-    return _chunkGF2RBSDMcjs.transformBezierPath.call(void 0, _chunkTHXFU3JBcjs.vectorPathWorldBezier.call(void 0, path.node, path.parentWorld, { effects: false }), _chunkTHXFU3JBcjs.invertMatrix.call(void 0, entry.parentWorld));
+    return _chunkGF2RBSDMcjs.transformBezierPath.call(void 0, _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, path.node, path.parentWorld, { effects: false }), _chunkKCMV2534cjs.invertMatrix.call(void 0, entry.parentWorld));
   } catch (e6) {
     return null;
   }
@@ -2076,9 +2077,9 @@ function motionNodeOffset(entry, timeline, time, nodes = indexMotionNodes([entry
   const scaleX = read("scaleX", 1);
   const scaleY = read("scaleY", 1);
   const c = entry.center;
-  let matrix = _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.scaleMatrix.call(void 0, scaleX, scaleY, c), _chunkTHXFU3JBcjs.rotateMatrix.call(void 0, rotation, c)), _chunkTHXFU3JBcjs.translateMatrix.call(void 0, dx, dy));
+  let matrix = _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.scaleMatrix.call(void 0, scaleX, scaleY, c), _chunkKCMV2534cjs.rotateMatrix.call(void 0, rotation, c)), _chunkKCMV2534cjs.translateMatrix.call(void 0, dx, dy));
   const along = follow ? followAt(entry, timeline, nodes, time) : null;
-  if (along) matrix = _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, matrix, _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.translateMatrix.call(void 0, -c.x, -c.y), _chunkTHXFU3JBcjs.rotateMatrix.call(void 0, along.angle)), _chunkTHXFU3JBcjs.translateMatrix.call(void 0, along.x, along.y)));
+  if (along) matrix = _chunkKCMV2534cjs.multiplyMatrices.call(void 0, matrix, _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.translateMatrix.call(void 0, -c.x, -c.y), _chunkKCMV2534cjs.rotateMatrix.call(void 0, along.angle)), _chunkKCMV2534cjs.translateMatrix.call(void 0, along.x, along.y)));
   return { matrix, dx, dy, rotation, scaleX, scaleY, follow: along };
 }
 function motionNodeClips(id, timeline, time) {
@@ -2145,7 +2146,7 @@ function motionFrameAt(scene, time, options = {}) {
           const start = Math.min(1, Math.max(0, typeof drawStart === "number" ? drawStart : 0));
           const end = Math.min(1, Math.max(0, typeof drawEnd === "number" ? drawEnd : 1));
           if (start > 0 || end < 1) {
-            const trim = _chunkTHXFU3JBcjs.createVectorEffect.call(void 0, "trim", MOTION_DRAW_EFFECT_ID, { start: tidy(start * 100), end: tidy(end * 100) });
+            const trim = _chunkKCMV2534cjs.createVectorEffect.call(void 0, "trim", MOTION_DRAW_EFFECT_ID, { start: tidy(start * 100), end: tidy(end * 100) });
             p = { ...p, effects: [trim, ...(_nullishCoalesce(p.effects, () => ( []))).filter((e) => e.id !== MOTION_DRAW_EFFECT_ID)] };
           }
         }
@@ -2159,8 +2160,8 @@ function motionFrameAt(scene, time, options = {}) {
       if (o >= 1) delete out.opacity;
     }
     const offset = options.offsets === false ? null : motionNodeOffset(entry, timeline, time, nodes);
-    if (offset && !_chunkTHXFU3JBcjs.isIdentityMatrix.call(void 0, offset.matrix)) {
-      const m = _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _chunkTHXFU3JBcjs.nodeMatrix.call(void 0, out), offset.matrix).map(tidy);
+    if (offset && !_chunkKCMV2534cjs.isIdentityMatrix.call(void 0, offset.matrix)) {
+      const m = _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _chunkKCMV2534cjs.nodeMatrix.call(void 0, out), offset.matrix).map(tidy);
       out = { ...out, transform: m };
     }
     return out;
@@ -2181,8 +2182,8 @@ function motionFrameToSvg(scene, time, options = {}) {
   const wrap = { ...options.wrap };
   for (const [id, clips] of Object.entries(frame.clips))
     wrap[id] = [..._nullishCoalesce(wrap[id], () => ( [])), ...clips.map((clip, i) => ({ clip: { id: `${prefix}reveal-${id}-${i}`, shape: clip.shape, attrs: motionClipAttrs(clip) } }))];
-  if (!motionSceneHasLayers(scene)) return withCameraViewEffects(withViewBox(_chunkTHXFU3JBcjs.vectorDocumentToSvg.call(void 0, frame.document, { ...options, wrap }), frame.camera), frame.view, frame.camera, prefix);
-  const art = _chunkTHXFU3JBcjs.vectorDocumentToSvg.call(void 0, frame.document, { ...options, wrap, background: false });
+  if (!motionSceneHasLayers(scene)) return withCameraViewEffects(withViewBox(_chunkKCMV2534cjs.vectorDocumentToSvg.call(void 0, frame.document, { ...options, wrap }), frame.camera), frame.view, frame.camera, prefix);
+  const art = _chunkKCMV2534cjs.vectorDocumentToSvg.call(void 0, frame.document, { ...options, wrap, background: false });
   let svg = withViewBox(withMotionShotLayers(art, scene, time, frame.camera, options.layers, options.background !== false), frame.camera);
   const transition = options.transitions === false ? null : motionTransitionAt(scene, time);
   if (transition) {
@@ -2373,8 +2374,8 @@ function visibleAt(timeline, id, time, node) {
   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" : _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node).some((p) => p.fill && p.fill !== "none");
-  const drawn = num2("drawEnd", 1) > 0.01 && (node.type === "path" || _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node).length === 0 || _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node).some((p) => {
+  const hasFill = node.type === "path" ? !!node.fill && node.fill !== "none" : _chunkKCMV2534cjs.collectPathNodes.call(void 0, node).some((p) => p.fill && p.fill !== "none");
+  const drawn = num2("drawEnd", 1) > 0.01 && (node.type === "path" || _chunkKCMV2534cjs.collectPathNodes.call(void 0, node).length === 0 || _chunkKCMV2534cjs.collectPathNodes.call(void 0, node).some((p) => {
     const v = trackValue(timeline.tracks.get(motionTrackKey(p.id, "drawEnd")), time);
     return typeof v !== "number" || v > 0.01;
   }));
@@ -2461,7 +2462,7 @@ function checkMotionScene(scene) {
           }
           for (const id of targets) {
             const node = nodes.get(id).node;
-            const paths = node.type === "path" ? [node] : _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node);
+            const paths = node.type === "path" ? [node] : _chunkKCMV2534cjs.collectPathNodes.call(void 0, node);
             if (paths.some((p) => p[key] !== void 0 && p[key] !== null && typeof p[key] !== "string"))
               issues.push(_chunkDGWOGQJ5cjs.motionIssue.call(void 0, "paint-not-color", `"${id}" has a gradient ${key}; it switches to ${color} at the end instead of blending.`, { ...where, ids: [id] }));
           }
@@ -2474,7 +2475,7 @@ function checkMotionScene(scene) {
         else
           for (const id of targets) {
             const node = nodes.get(id).node;
-            const paths = node.type === "path" ? [node] : _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node);
+            const paths = node.type === "path" ? [node] : _chunkKCMV2534cjs.collectPathNodes.call(void 0, node);
             if (paths.some((p) => typeof p[key] !== "string"))
               issues.push(_chunkDGWOGQJ5cjs.motionIssue.call(void 0, "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] }));
           }
@@ -2919,7 +2920,7 @@ function motionNodePose(scene, id, time) {
   if (!entry) throw new Error(`There is no element ${_chunkDGWOGQJ5cjs.namedWithSuggestion.call(void 0, id, [...indexMotionNodes(scene.artwork.nodes).keys()])} in the artwork.`);
   const timeline = compileMotionScene(scene);
   const drawn = indexMotionNodes(motionFrameAt(scene, time).document.nodes).get(id);
-  const centre = _chunkTHXFU3JBcjs.applyMatrix.call(void 0, entry.parentWorld, { x: entry.center.x + motionPropertyValue(timeline, id, "x", time), y: entry.center.y + motionPropertyValue(timeline, id, "y", time) });
+  const centre = _chunkKCMV2534cjs.applyMatrix.call(void 0, entry.parentWorld, { x: entry.center.x + motionPropertyValue(timeline, id, "x", time), y: entry.center.y + motionPropertyValue(timeline, id, "y", time) });
   const paint = (property) => _nullishCoalesce(trackValue(timeline.tracks.get(motionTrackKey(id, property)), time), () => ( motionRestValue(entry, property, scene.artwork)));
   const fill = paint("fill");
   const stroke = paint("stroke");
@@ -3266,7 +3267,7 @@ function toFlairSvgMotion(scene, options = {}) {
         raw: (t) => transformAt(t, true)
       });
     }
-    const paths = node.type === "path" ? [node] : _chunkTHXFU3JBcjs.collectPathNodes.call(void 0, node);
+    const paths = node.type === "path" ? [node] : _chunkKCMV2534cjs.collectPathNodes.call(void 0, node);
     for (const path of paths) {
       if (pathsSeen.has(path.id)) continue;
       pathsSeen.add(path.id);
@@ -3288,7 +3289,7 @@ function toFlairSvgMotion(scene, options = {}) {
     if (shapeSegments.length) {
       if (node.type !== "path") notes.push(`"${id}" is a group: its morph or effect animation is not exported (Flair tweens one path's "d").`);
       else {
-        const inverse = _chunkTHXFU3JBcjs.invertMatrix.call(void 0, _chunkTHXFU3JBcjs.nodeMatrix.call(void 0, node));
+        const inverse = _chunkKCMV2534cjs.invertMatrix.call(void 0, _chunkKCMV2534cjs.nodeMatrix.call(void 0, node));
         channels.push({
           id,
           kind: "attr",
@@ -3297,9 +3298,9 @@ function toFlairSvgMotion(scene, options = {}) {
           exact: () => false,
           value: (t) => {
             const frame = motionFrameAt(scene, t, { draw: false, offsets: false });
-            const now = _chunkTHXFU3JBcjs.expandVectorAppearance.call(void 0, _optionalChain([indexMotionNodes, 'call', _151 => _151(frame.document.nodes), 'access', _152 => _152.get, 'call', _153 => _153(id), 'optionalAccess', _154 => _154.node]));
+            const now = _chunkKCMV2534cjs.expandVectorAppearance.call(void 0, _optionalChain([indexMotionNodes, 'call', _151 => _151(frame.document.nodes), 'access', _152 => _152.get, 'call', _153 => _153(id), 'optionalAccess', _154 => _154.node]));
             if (!now || now.type !== "path") return "";
-            const bezier = _chunkGF2RBSDMcjs.transformBezierPath.call(void 0, _chunkTHXFU3JBcjs.vectorPathWorldBezier.call(void 0, now, _chunkTHXFU3JBcjs.IDENTITY_MATRIX, { effects: false }), inverse);
+            const bezier = _chunkGF2RBSDMcjs.transformBezierPath.call(void 0, _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, now, _chunkKCMV2534cjs.IDENTITY_MATRIX, { effects: false }), inverse);
             return _chunkGF2RBSDMcjs.bezierPathToSvg.call(void 0, bezier, { precision: Math.min(precision, 2) });
           }
         });
@@ -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));
@@ -3439,7 +3440,7 @@ function toFlairSvgMotion(scene, options = {}) {
   }
   if (scene.motionBlur) notes.push("Motion blur is drawn on the stage only; Flair plays the scene sharp.");
   if (trigger && (_nullishCoalesce(scene.loop, () => ( "none"))) !== "none") notes.push(`The scene plays on ${trigger}, so its loop does not apply in Flair.`);
-  let svg = _chunkTHXFU3JBcjs.vectorDocumentToSvg.call(void 0, { ...scene.artwork, nodes: _chunkTHXFU3JBcjs.expandVectorAppearances.call(void 0, scene.artwork.nodes) }, { pretty: false, precision, wrap });
+  let svg = _chunkKCMV2534cjs.vectorDocumentToSvg.call(void 0, { ...scene.artwork, nodes: _chunkKCMV2534cjs.expandVectorAppearances.call(void 0, scene.artwork.nodes) }, { pretty: false, precision, wrap });
   if (routes.length) svg = svg.replace(/^(<svg[^>]*>)/, `$1<defs>${routes.join("")}</defs>`);
   let motion = { svg, animate };
   if (_optionalChain([scene, 'access', _160 => _160.controls, 'optionalAccess', _161 => _161.length])) {
@@ -3537,14 +3538,14 @@ function easingOf(ease, fallback) {
   return fallback;
 }
 function poseOf(value, entry) {
-  const t = _chunkTHXFU3JBcjs.parseSvgTransform.call(void 0, String(value));
-  const o = _chunkTHXFU3JBcjs.multiplyMatrices.call(void 0, _nullishCoalesce(_chunkTHXFU3JBcjs.invertMatrix.call(void 0, _chunkTHXFU3JBcjs.nodeMatrix.call(void 0, entry.node)), () => ( [1, 0, 0, 1, 0, 0])), t);
+  const t = _chunkKCMV2534cjs.parseSvgTransform.call(void 0, String(value));
+  const o = _chunkKCMV2534cjs.multiplyMatrices.call(void 0, _nullishCoalesce(_chunkKCMV2534cjs.invertMatrix.call(void 0, _chunkKCMV2534cjs.nodeMatrix.call(void 0, entry.node)), () => ( [1, 0, 0, 1, 0, 0])), t);
   const sx = Math.hypot(o[0], o[1]);
   if (!(sx > 1e-9)) return null;
   const sy = (o[0] * o[3] - o[1] * o[2]) / sx;
   if (Math.abs(o[2] + o[1] / sx * sy) > 1e-6 || Math.abs(o[3] - o[0] / sx * sy) > 1e-6) return null;
   const c = entry.center;
-  const moved = _chunkTHXFU3JBcjs.applyMatrix.call(void 0, o, c);
+  const moved = _chunkKCMV2534cjs.applyMatrix.call(void 0, o, c);
   return { dx: moved.x - c.x, dy: moved.y - c.y, rotation: Math.atan2(o[1], o[0]) * 180 / Math.PI, sx, sy };
 }
 var near = (a, b, eps = 1e-6) => Math.abs(a - b) < eps;
@@ -3629,7 +3630,7 @@ function fromFlairSvgMotion(input, options = {}) {
   const notes = [];
   if (!input || typeof input.svg !== "string") throw new Error('Give a Flair SvgMotion: { svg: "<svg \u2026>", animate: [ \u2026 ] }.');
   const { motion, controls } = resolvePlaceholders(input, notes);
-  const artwork = _chunkTHXFU3JBcjs.parseVectorSvg.call(void 0, motion.svg);
+  const artwork = _chunkKCMV2534cjs.parseVectorSvg.call(void 0, motion.svg);
   const nodes = indexMotionNodes(artwork.nodes);
   const byStep = /* @__PURE__ */ new Map();
   for (const anim of _nullishCoalesce(motion.animate, () => ( []))) {
@@ -3876,9 +3877,9 @@ function toLottie(scene, options = {}) {
     const items = [];
     const shapeSegments = [...timeline.tracks.entries()].filter(([k]) => k.startsWith(`${path.id}\0`) && (k.endsWith("\0shape") || k.includes("\0effect:"))).flatMap(([, v]) => v);
     const geometryAt = (t) => {
-      if (!shapeSegments.length) return _chunkTHXFU3JBcjs.vectorPathWorldBezier.call(void 0, path);
+      if (!shapeSegments.length) return _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, path);
       const now = _optionalChain([indexMotionNodes, 'call', _170 => _170(motionFrameAt(scene, t, { draw: false, offsets: false }).document.nodes), 'access', _171 => _171.get, 'call', _172 => _172(path.id), 'optionalAccess', _173 => _173.node]);
-      return now && now.type === "path" ? _chunkTHXFU3JBcjs.vectorPathWorldBezier.call(void 0, _chunkTHXFU3JBcjs.expandVectorAppearances.call(void 0, [now])[0]) : _chunkTHXFU3JBcjs.vectorPathWorldBezier.call(void 0, path);
+      return now && now.type === "path" ? _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, _chunkKCMV2534cjs.expandVectorAppearances.call(void 0, [now])[0]) : _chunkKCMV2534cjs.vectorPathWorldBezier.call(void 0, path);
     };
     const rest = lottieContours(_chunkGF2RBSDMcjs.toBezierPath.call(void 0, geometryAt(0)), round4);
     rest.forEach((contour, n2) => {
@@ -3951,13 +3952,13 @@ function toLottie(scene, options = {}) {
     const innerTr = STATIC_TR();
     if (node.type === "path") inner = [...pathShapes(node)];
     else if (node.type === "text" || node.type === "instance") {
-      const drawn = _chunkTHXFU3JBcjs.expandVectorAppearance.call(void 0, node);
+      const drawn = _chunkKCMV2534cjs.expandVectorAppearance.call(void 0, node);
       inner = drawn.type === "path" ? [...pathShapes(drawn)] : drawn.children.filter((c) => c.type === "path").reverse().flatMap((c) => [...pathShapes(c)]);
-      notes.push(`"${node.id}": text is exported as its outlines${_chunkTHXFU3JBcjs.vectorTextHasOutlines.call(void 0, ) ? "" : " (glyph boxes: set an outline text shaper for real glyphs)"}.`);
+      notes.push(`"${node.id}": text is exported as its outlines${_chunkKCMV2534cjs.vectorTextHasOutlines.call(void 0, ) ? "" : " (glyph boxes: set an outline text shaper for real glyphs)"}.`);
     } else {
       inner = shown(node.children).reverse().map(nodeGroup);
-      const m = _chunkTHXFU3JBcjs.nodeMatrix.call(void 0, node);
-      if (m !== _chunkTHXFU3JBcjs.IDENTITY_MATRIX) {
+      const m = _chunkKCMV2534cjs.nodeMatrix.call(void 0, node);
+      if (m !== _chunkKCMV2534cjs.IDENTITY_MATRIX) {
         const parts = staticParts(m);
         if (!parts) notes.push(`"${node.id}": its transform skews, which is not exported; it is drawn without the skew.`);
         else {
@@ -3970,7 +3971,7 @@ function toLottie(scene, options = {}) {
     const body = { ty: "gr", nm: `${node.id} (own)`, it: [...inner, innerTr] };
     return { ty: "gr", nm: _nullishCoalesce(node.name, () => ( node.id)), it: [body, poseTransform(entry)] };
   };
-  const artwork = { ...scene.artwork, nodes: _chunkTHXFU3JBcjs.expandVectorAppearances.call(void 0, scene.artwork.nodes) };
+  const artwork = { ...scene.artwork, nodes: _chunkKCMV2534cjs.expandVectorAppearances.call(void 0, scene.artwork.nodes) };
   const content = shown(artwork.nodes).reverse().map(nodeGroup);
   if (artwork.background && rgba(artwork.background))
     content.push({ ty: "gr", nm: "Background", it: [{ ty: "rc", nm: "Background", p: { a: 0, k: [artwork.width / 2, artwork.height / 2] }, s: { a: 0, k: [artwork.width, artwork.height] }, r: { a: 0, k: 0 } }, { ty: "fl", c: { a: 0, k: rgba(artwork.background).map(round4) }, o: { a: 0, k: 100 }, r: 1 }, STATIC_TR()] });
@@ -4069,11 +4070,11 @@ function preset(prst, w, h) {
   const poly = (pts) => [{ closed: true, anchors: pts.map(([x, y]) => ({ x, y })) }];
   switch (prst) {
     case "rect":
-      return [_chunkTHXFU3JBcjs.rectSubpath.call(void 0, { x: 0, y: 0, width: w, height: h })];
+      return [_chunkKCMV2534cjs.rectSubpath.call(void 0, { x: 0, y: 0, width: w, height: h })];
     case "roundRect":
-      return [_chunkTHXFU3JBcjs.rectSubpath.call(void 0, { x: 0, y: 0, width: w, height: h }, Math.min(w, h) * 0.16667)];
+      return [_chunkKCMV2534cjs.rectSubpath.call(void 0, { x: 0, y: 0, width: w, height: h }, Math.min(w, h) * 0.16667)];
     case "ellipse":
-      return [_chunkTHXFU3JBcjs.ellipseSubpath.call(void 0, { x: 0, y: 0, width: w, height: h })];
+      return [_chunkKCMV2534cjs.ellipseSubpath.call(void 0, { x: 0, y: 0, width: w, height: h })];
     case "triangle":
       return poly([[w / 2, 0], [w, h], [0, h]]);
     case "rtTriangle":
@@ -4181,7 +4182,7 @@ function shapes(ctx, tree, map) {
     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 = [_chunkTHXFU3JBcjs.rectSubpath.call(void 0, { x: 0, y: 0, width: w, height: h })];
+      subpaths = [_chunkKCMV2534cjs.rectSubpath.call(void 0, { x: 0, y: 0, width: w, height: h })];
     }
     const style = kid(el, "style");
     const fill = kid(spPr, "noFill") ? null : _nullishCoalesce(colour(ctx, kid(spPr, "solidFill")), () => ( (el.localName === "cxnSp" ? null : colour(ctx, kid(style, "fillRef")))));
@@ -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;
@@ -4570,7 +4571,7 @@ function nextMotionEffectInstance(scene) {
   walk(scene.artwork.nodes);
   for (let i = 1; ; i++) if (!used.has(`fx${i}`)) return `fx${i}`;
 }
-var motionArtworkSvg = (artwork) => _chunkTHXFU3JBcjs.vectorDocumentToSvg.call(void 0, artwork);
+var motionArtworkSvg = (artwork) => _chunkKCMV2534cjs.vectorDocumentToSvg.call(void 0, artwork);
 var tag = (commands, source) => commands.map((c) => c.type === "wait" ? c : { ...c, source });
 function motionCommandsFromEffect(artwork, motion, source) {
   const imported = fromFlairSvgMotion({ svg: motionArtworkSvg(artwork), animate: [..._nullishCoalesce(motion.animate, () => ( []))] });
@@ -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));
@@ -6142,7 +6176,7 @@ function createAnimationEditorToolProvider(controller, options = {}) {
     handler: ({ svg }) => {
       let artwork;
       try {
-        artwork = _chunkTHXFU3JBcjs.parseVectorSvg.call(void 0, svg);
+        artwork = _chunkKCMV2534cjs.parseVectorSvg.call(void 0, svg);
       } catch (error) {
         throw new Error(`The SVG could not be read: ${error.message}. Nothing was changed.`);
       }
@@ -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 } : {} };
         }