@pixerate/editor 0.241.0 → 0.242.0

package/dist/animation-editor/index.js

@@ -16,7 +16,7 @@ import {
   effectSubjectKind,
   effectTemplateTools,
   fillEffectTemplate
-} from "../chunk-G3RUKJ5C.js";
+} from "../chunk-RXZL4NG5.js";
 import {
   IDENTITY_MATRIX,
   applyMatrix,
@@ -66,9 +66,10 @@ import {
   cameraViewOfBox,
   createEffectToolProvider,
   isEffectError,
+  pathControlsOf,
   resolveCameraMoveSpec,
   resolveEffectValues
-} from "../chunk-SIK3LT6M.js";
+} from "../chunk-OFH6Q67U.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-2PBZBRP5.js";
 import "../chunk-ODBT55Q7.js";
@@ -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 = /viewBox\s*=\s*["']([^"']+)["']/.exec(motion.svg)?.[1].trim().split(/[\s,]+/).map(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: 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 };
@@ -4891,11 +4902,34 @@ var AnimationEditorController = class {
   addVectorEffect(effect, options = {}) {
     return this.effectEdit(async () => {
       const d = await this.describeFor(effect, ["vector"]);
-      const values = resolveEffectValues(d, options.values);
+      let given = options.values;
+      let place = options.box;
+      if (options.path) {
+        const controls = pathControlsOf(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 = 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 = bezierPathToSvg(vectorPathWorldBezier(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 = { ...given ?? {}, [control]: value };
+      }
+      const values = resolveEffectValues(d, given);
       const instance = 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 };
     });
   }
@@ -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 } : {} };
         }

package/dist/canvas/index.cjs

@@ -220,7 +220,7 @@ var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkJAOSL334cjs = require('../chunk-JAOSL334.cjs');
+var _chunkGHCSC2WPcjs = require('../chunk-GHCSC2WP.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -11426,14 +11426,14 @@ function canvasEffectErrorReason(effect, error) {
 }
 var CANVAS_EFFECT_MISSING_PATTERN = "repeating-linear-gradient(45deg, rgba(128,128,128,0.28) 0 2px, transparent 2px 8px)";
 function createCanvasEffectsController(options) {
-  const slot = new (0, _chunkJAOSL334cjs.EffectsSlot)();
+  const slot = new (0, _chunkGHCSC2WPcjs.EffectsSlot)();
   if (options.effects) slot.set(options.effects);
   const describe = async (effect, place2) => {
     const d = await slot.require().describe(effect);
     const allowed = CANVAS_EFFECT_PLACES[place2];
     if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
       const where = place2 === "transition" ? "a scene transition" : place2 === "fill" ? "a fill" : "an overlay";
-      throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
+      throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
     }
     return d;
   };
@@ -11464,7 +11464,7 @@ function createCanvasEffectsController(options) {
       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(", ")}.`);
     }
-    return { ...base, ..._chunkJAOSL334cjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+    return { ...base, ..._chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
   };
   return {
     /** The provider slot. */
@@ -11498,7 +11498,7 @@ function createCanvasEffectsController(options) {
       const mode = _nullishCoalesce(opts.mode, () => ( "fill"));
       const d = await describe(effect, mode);
       if (opts.opacity !== void 0 && !(opts.opacity >= 0 && opts.opacity <= 1)) throw new Error("opacity must be from 0 to 1.");
-      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
+      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
       commit(`Add effect ${d.name}`, withEffect(nodeId, next));
       return next;
     },
@@ -11555,7 +11555,7 @@ function createCanvasEffectsController(options) {
       const d = await describe(effect, "transition");
       const duration = _nullishCoalesce(_nullishCoalesce(opts.duration, () => ( d.duration)), () => ( 600));
       if (!(duration > 0)) throw new Error("duration must be a number of ms above 0.");
-      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, opts.values), duration };
+      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkGHCSC2WPcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
       scenes2.update(sceneId, { transition });
       return transition;
     }
@@ -11699,7 +11699,7 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
   const once = (instance) => {
     if (instance !== "effect") throw new Error('A shape node has one effect, "effect".');
   };
-  return _chunkJAOSL334cjs.createEffectToolProvider.call(void 0, {
+  return _chunkGHCSC2WPcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "canvas-effects")),
     namespace: options.namespace,
     title: "Canvas effects",

package/dist/canvas/index.js

@@ -220,7 +220,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-SIK3LT6M.js";
+} from "../chunk-OFH6Q67U.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket

package/dist/{chunk-A7PQNIBX.cjs → chunk-7V7QMFTI.cjs}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkJAOSL334cjs = require('./chunk-JAOSL334.cjs');
+var _chunkGHCSC2WPcjs = require('./chunk-GHCSC2WP.cjs');
 
 
 var _chunkFJ2MSI43cjs = require('./chunk-FJ2MSI43.cjs');
@@ -26,7 +26,7 @@ function documentErrors(doc, description) {
   const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
   if (doc.values !== void 0) {
     if (!isRecord(doc.values)) errors.push({ path: "/values", message: "must be an object of control values" });
-    else errors.push(..._chunkJAOSL334cjs.effectValueErrors.call(void 0, description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
+    else errors.push(..._chunkGHCSC2WPcjs.effectValueErrors.call(void 0, description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
   }
   if (doc.tracks !== void 0) {
     if (!isRecord(doc.tracks)) errors.push({ path: "/tracks", message: "must be an object of keyframe lists" });
@@ -39,7 +39,7 @@ function documentErrors(doc, description) {
           kfs.forEach((kf, i) => {
             if (!isRecord(kf)) return errors.push({ path: `${at}/${i}`, message: "must be a keyframe object" });
             if (typeof kf.time !== "number" || !Number.isFinite(kf.time) || kf.time < 0) errors.push({ path: `${at}/${i}/time`, message: "must be a finite number of ms >= 0" });
-            errors.push(..._chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
+            errors.push(..._chunkGHCSC2WPcjs.effectValueErrors.call(void 0, description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
             if (kf.easing !== void 0 && !_chunkDWJJI6RTcjs.isAnimationEasing.call(void 0, kf.easing)) errors.push({ path: `${at}/${i}/easing`, message: "is not a valid easing" });
           });
       }
@@ -49,7 +49,7 @@ function documentErrors(doc, description) {
     else
       doc.presets.forEach((p, i) => {
         if (!isRecord(p) || typeof p.name !== "string" || !p.name) return errors.push({ path: `/presets/${i}`, message: "must have a name" });
-        errors.push(..._chunkJAOSL334cjs.effectValueErrors.call(void 0, description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
+        errors.push(..._chunkGHCSC2WPcjs.effectValueErrors.call(void 0, description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
       });
   }
   if (doc.duration !== void 0 && (typeof doc.duration !== "number" || !Number.isFinite(doc.duration) || !(doc.duration > 0))) {
@@ -170,7 +170,7 @@ async function createEffectAuthoringSession(source, options) {
   if (isDocumentSource(source)) {
     const doc = source.document;
     if (doc.version !== 1 || !doc.effectId) {
-      throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)("Invalid effect authoring document: version 1 required");
+      throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)("Invalid effect authoring document: version 1 required");
     }
     effectId = doc.effectId;
     initialDoc = doc;
@@ -178,15 +178,15 @@ async function createEffectAuthoringSession(source, options) {
     effectId = source.effectId;
     requestedPreset = source.preset;
   } else {
-    throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)("Invalid effect authoring source");
+    throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)("Invalid effect authoring source");
   }
   const description = await provider.describe(effectId);
   if (initialDoc) {
     const problems = documentErrors(initialDoc, description);
-    if (problems.length) throw new (0, _chunkJAOSL334cjs.EffectControlError)(effectId, problems);
+    if (problems.length) throw new (0, _chunkGHCSC2WPcjs.EffectControlError)(effectId, problems);
   }
   if (description.kind === "motion") {
-    throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)("Motion effects cannot be authored as pixel effects", effectId);
+    throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)("Motion effects cannot be authored as pixel effects", effectId);
   }
   let disposed = false;
   let playing = false;
@@ -207,7 +207,7 @@ async function createEffectAuthoringSession(source, options) {
     const found = description.presets.find((p) => p.name === requestedPreset);
     if (!found) {
       const validNames = description.presets.map((p) => `"${p.name}"`).join(", ");
-      throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(
+      throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(
         `Unknown preset "${requestedPreset}" for effect "${effectId}". Valid presets are: ${validNames || "none"}`,
         effectId
       );
@@ -321,7 +321,7 @@ async function createEffectAuthoringSession(source, options) {
       if (!validNames.includes(name)) {
         return { ok: false, message: `there is no control "${name}"; the controls are ${validNames.join(", ")}` };
       }
-      const errors = _chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [name]: value });
+      const errors = _chunkGHCSC2WPcjs.effectValueErrors.call(void 0, description, { [name]: value });
       if (errors.length > 0) {
         return { ok: false, message: valueErrorMessage(errors) };
       }
@@ -391,7 +391,7 @@ async function createEffectAuthoringSession(source, options) {
         if (!validNames.includes(k)) {
           return { ok: false, message: `there is no control "${k}"; the controls are ${validNames.join(", ")}` };
         }
-        const errors = _chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [k]: v });
+        const errors = _chunkGHCSC2WPcjs.effectValueErrors.call(void 0, description, { [k]: v });
         if (errors.length > 0) {
           return { ok: false, message: valueErrorMessage(errors) };
         }
@@ -528,7 +528,7 @@ async function createEffectAuthoringSession(source, options) {
         return { ok: false, message: `invalid easing: ${String(easing)}` };
       }
       const targetValue = value !== void 0 ? value : valuesAtTime(time, baseValues, tracks)[name];
-      const errors = _chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [name]: targetValue });
+      const errors = _chunkGHCSC2WPcjs.effectValueErrors.call(void 0, description, { [name]: targetValue });
       if (errors.length > 0) {
         return { ok: false, message: valueErrorMessage(errors) };
       }
@@ -705,7 +705,7 @@ async function createEffectAuthoringSession(source, options) {
     },
     async createPreview(opts) {
       if (disposed) {
-        throw new (0, _chunkJAOSL334cjs.EffectDisposedError)(effectId);
+        throw new (0, _chunkGHCSC2WPcjs.EffectDisposedError)(effectId);
       }
       let renderer;
       try {
@@ -730,7 +730,7 @@ async function createEffectAuthoringSession(source, options) {
         height: renderer.height,
         depth: renderer.depth,
         render: async (req) => {
-          if (disposed) throw new (0, _chunkJAOSL334cjs.EffectDisposedError)(effectId);
+          if (disposed) throw new (0, _chunkGHCSC2WPcjs.EffectDisposedError)(effectId);
           const effectiveValues = _nullishCoalesce(req.values, () => ( valuesAtTime(req.time, baseValues, tracks)));
           const pixels = await renderer.render({
             ...req,

package/dist/{chunk-JAOSL334.cjs → chunk-GHCSC2WP.cjs}

@@ -6,6 +6,8 @@ var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
 var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
 var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
 var CAMERA_MOVE_ROLES = ["transition", "hold"];
+var EFFECT_ACCEPTS = ["path"];
+var EFFECT_PATH_FORMAT = "svg-path";
 var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
 var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
 var EFFECT_TRANSITION_MS = 800;
@@ -104,7 +106,11 @@ function countEffectTags(effects) {
   for (const e of effects) for (const tag of new Set((_nullishCoalesce(e.tags, () => ( []))).map(normaliseEffectTag))) if (tag) counts.set(tag, (_nullishCoalesce(counts.get(tag), () => ( 0))) + 1);
   return [...counts].map(([tag, count]) => ({ tag, count })).sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
 }
-var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags);
+var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags) && (!_optionalChain([o, 'access', _2 => _2.accepts, 'optionalAccess', _3 => _3.length]) || o.accepts.every((a) => _optionalChain([e, 'access', _4 => _4.accepts, 'optionalAccess', _5 => _5.includes, 'call', _6 => _6(a)])));
+function pathControlsOf(d) {
+  const isPath = (s) => !!s && (s.format === EFFECT_PATH_FORMAT || [..._nullishCoalesce(s.anyOf, () => ( [])), ..._nullishCoalesce(s.oneOf, () => ( []))].some((x) => isPath(x)));
+  return Object.entries(_nullishCoalesce(_optionalChain([d, 'access', _7 => _7.controls, 'optionalAccess', _8 => _8.properties]), () => ( {}))).filter(([, s]) => isPath(s)).map(([name]) => name);
+}
 function searchEffectSummaries(catalog, query = "", options = {}) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   const scored = [];
@@ -228,7 +234,7 @@ async function sampleEffectCameraMove(provider, id, request) {
 }
 var cameraMoveField = (role) => role === "transition" ? "in" : "during";
 function cameraMovesFor(catalog, role) {
-  return catalog.filter((e) => e.kind === "camera" && _optionalChain([e, 'access', _2 => _2.camera, 'optionalAccess', _3 => _3.role]) === role);
+  return catalog.filter((e) => e.kind === "camera" && _optionalChain([e, 'access', _9 => _9.camera, 'optionalAccess', _10 => _10.role]) === role);
 }
 function cameraMoveIdList(catalog, role) {
   const ids = cameraMovesFor(catalog, role).map((e) => JSON.stringify(e.id));
@@ -318,11 +324,12 @@ var summaryOut = (e) => ({
   category: e.category,
   uses: e.uses,
   ...e.description ? { description: e.description } : {},
-  ..._optionalChain([e, 'access', _4 => _4.tags, 'optionalAccess', _5 => _5.length]) ? { tags: e.tags } : {},
+  ..._optionalChain([e, 'access', _11 => _11.tags, 'optionalAccess', _12 => _12.length]) ? { tags: e.tags } : {},
   transparent: e.transparent,
   loop: e.loop,
   ...e.duration !== void 0 ? { duration: e.duration } : {},
-  ...e.camera ? { camera: e.camera } : {}
+  ...e.camera ? { camera: e.camera } : {},
+  ..._optionalChain([e, 'access', _13 => _13.accepts, 'optionalAccess', _14 => _14.length]) ? { accepts: e.accepts } : {}
 });
 function createEffectToolProvider(host) {
   let catalog = null;
@@ -330,7 +337,7 @@ function createEffectToolProvider(host) {
   const notify = () => listeners.forEach((l) => l());
   const catalogFor = (provider) => {
     if (!provider) return null;
-    if (_optionalChain([catalog, 'optionalAccess', _6 => _6.provider]) !== provider) {
+    if (_optionalChain([catalog, 'optionalAccess', _15 => _15.provider]) !== provider) {
       const entry = { provider, effects: null };
       catalog = entry;
       Promise.resolve().then(() => provider.list()).then((effects) => {
@@ -366,7 +373,7 @@ function createEffectToolProvider(host) {
     description: `${what}: control name \u2192 value, as listed by describe_effect (its "controls" schema: types, ranges, units and defaults). Only the given controls change; colours are "#rrggbb".${keyframes ? " A number control may instead be keyframes { keys: [{ t: ms from the start, v, ease }] }." : ""} Unknown controls and out-of-range values are refused with the valid ones.`
   });
   const effectIdSchema = (uses) => {
-    const effects = _optionalChain([catalogFor, 'call', _7 => _7(host.provider()), 'optionalAccess', _8 => _8.filter, 'call', _9 => _9((e) => effectOffered(e, uses))]);
+    const effects = _optionalChain([catalogFor, 'call', _16 => _16(host.provider()), 'optionalAccess', _17 => _17.filter, 'call', _18 => _18((e) => effectOffered(e, uses))]);
     const base = `An effect id from search_effects (use ${uses.map((u) => `"${u}"`).join(" or ")}).`;
     return effects && effects.length && effects.length <= ENUM_LIMIT ? { type: "string", enum: effects.map((e) => e.id), description: `${base} One of: ${effects.map((e) => `${e.id} (${e.name})`).join(", ")}.` } : { type: "string", minLength: 1, description: base };
   };
@@ -380,24 +387,35 @@ function createEffectToolProvider(host) {
     {
       name: "search_effects",
       title: "Search effects",
-      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one). For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
+      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one), and accepts ["path"] for effects that draw along a path you give. For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves, accepts }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
       inputSchema: object({
         query: { type: "string", description: "Words to match (default: every effect)." },
         kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG), motion (animates vector art) or camera (moves a scene's camera; no pixels)." },
         category: { type: "string", minLength: 1, description: `The provider's category, e.g. "gradient", "light", "transition".` },
         use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input, camera moves a scene's camera." },
         tags: { type: "array", items: { type: "string", minLength: 1 }, description: "Only effects carrying every one of these tags, as search_effects lists them (any case; spaces count as hyphens)." },
-        limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." }
+        limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." },
+        accepts: { type: "array", items: { type: "string", enum: [...EFFECT_ACCEPTS], description: "path: the effect has a control that draws along a path given at run time." }, description: "Only effects that take every one of these (path: effects that draw along a path you give; describe_effect names the controls in pathControls)." }
       }),
       annotations: { title: "Search effects", ...ANNOTATIONS.read },
       handler: async (args) => {
         const p = host.provider();
         if (!p) return { available: false, reason: NO_PROVIDER, effects: [], total: 0 };
         const tags = args.tags;
-        const found = (await explain(async () => p.search(_nullishCoalesce(args.query, () => ( "")), { kind: args.kind, category: args.category, use: args.use, tags }))).filter((e) => hasEffectTags(e, tags));
+        const accepts = args.accepts;
+        let found = (await explain(async () => p.search(_nullishCoalesce(args.query, () => ( "")), { kind: args.kind, category: args.category, use: args.use, tags, ..._optionalChain([accepts, 'optionalAccess', _19 => _19.length]) ? { accepts } : {} }))).filter((e) => hasEffectTags(e, tags));
+        if (_optionalChain([accepts, 'optionalAccess', _20 => _20.includes, 'call', _21 => _21("path")])) {
+          const kept = [];
+          for (const e of found) {
+            if (e.accepts) {
+              if (accepts.every((a) => e.accepts.includes(a))) kept.push(e);
+            } else if (kept.length < 200 && pathControlsOf(await explain(async () => p.describe(e.id))).length) kept.push(e);
+          }
+          found = kept;
+        }
         const limit = _nullishCoalesce(args.limit, () => ( 20));
         const out = { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length, tags: countEffectTags(found).slice(0, TAG_LIMIT) };
-        if (_optionalChain([tags, 'optionalAccess', _10 => _10.length]) && !found.length) {
+        if (_optionalChain([tags, 'optionalAccess', _22 => _22.length]) && !found.length) {
           const known = countEffectTags(await explain(async () => p.list()));
           const have = new Set(known.map((k) => k.tag));
           const unknown = tags.filter((t) => !have.has(normaliseEffectTag(t)));
@@ -416,7 +434,8 @@ function createEffectToolProvider(host) {
         const p = host.provider();
         if (!p) return { available: false, reason: NO_PROVIDER };
         const d = await explain(async () => p.describe(args.effect));
-        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses) };
+        const pathControls = pathControlsOf(d);
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses), ...pathControls.length ? { pathControls } : {} };
       }
     },
     {
@@ -512,16 +531,16 @@ function createEffectToolProvider(host) {
     ...host.description ? { description: host.description } : {},
     ...host.skill ? { skill: host.skill } : {},
     tools: () => {
-      const extra = _nullishCoalesce(_optionalChain([host, 'access', _11 => _11.extraTools, 'optionalCall', _12 => _12(context)]), () => ( []));
-      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _13 => _13.annotations, 'optionalAccess', _14 => _14.readOnlyHint]))];
+      const extra = _nullishCoalesce(_optionalChain([host, 'access', _23 => _23.extraTools, 'optionalCall', _24 => _24(context)]), () => ( []));
+      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _25 => _25.annotations, 'optionalAccess', _26 => _26.readOnlyHint]))];
       return [...readTools(), ...writeTools(), ...extra];
     },
     subscribe: (l) => {
       listeners.add(l);
-      const off = _optionalChain([host, 'access', _15 => _15.subscribe, 'optionalCall', _16 => _16(l)]);
+      const off = _optionalChain([host, 'access', _27 => _27.subscribe, 'optionalCall', _28 => _28(l)]);
       return () => {
         listeners.delete(l);
-        _optionalChain([off, 'optionalCall', _17 => _17()]);
+        _optionalChain([off, 'optionalCall', _29 => _29()]);
       };
     }
   };
@@ -570,4 +589,7 @@ function createEffectToolProvider(host) {
 
 
 
-exports.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.EFFECT_SUBJECT_KINDS = EFFECT_SUBJECT_KINDS; exports.EFFECT_LAYER_ROLES = EFFECT_LAYER_ROLES; exports.EFFECT_TRANSITION_MS = EFFECT_TRANSITION_MS; exports.EFFECT_TEMPLATE_SLOT_TYPES = EFFECT_TEMPLATE_SLOT_TYPES; exports.EFFECT_ERROR_CODES = EFFECT_ERROR_CODES; exports.EffectError = EffectError; exports.UnknownEffectError = UnknownEffectError; exports.UnknownTemplateError = UnknownTemplateError; exports.EffectControlError = EffectControlError; exports.EffectUnsupportedError = EffectUnsupportedError; exports.EffectDisposedError = EffectDisposedError; exports.NoEffectsProviderError = NoEffectsProviderError; exports.isEffectError = isEffectError; exports.effectValueErrors = effectValueErrors; exports.resolveEffectValues = resolveEffectValues; exports.effectOffered = effectOffered; exports.normaliseEffectTag = normaliseEffectTag; exports.hasEffectTags = hasEffectTags; exports.countEffectTags = countEffectTags; exports.searchEffectSummaries = searchEffectSummaries; exports.createEffectPixels = createEffectPixels; exports.isEffectPixels = isEffectPixels; exports.srgbToLinear = srgbToLinear; exports.linearToSrgb = linearToSrgb; exports.encodeEffectFloat = encodeEffectFloat; exports.applyEffectMask = applyEffectMask; exports.EffectsSlot = EffectsSlot; exports.isCameraView = isCameraView; exports.sampleCameraViews = sampleCameraViews; exports.sampleEffectCameraMove = sampleEffectCameraMove; exports.cameraMoveField = cameraMoveField; exports.cameraMovesFor = cameraMovesFor; exports.cameraMoveIdList = cameraMoveIdList; exports.cameraMoveParts = cameraMoveParts; exports.CAMERA_MOVE_MAX_MS = CAMERA_MOVE_MAX_MS; exports.resolveCameraMoveSpec = resolveCameraMoveSpec; exports.cameraViewOfBox = cameraViewOfBox; exports.cameraBoxOfView = cameraBoxOfView; exports.createEffectToolProvider = createEffectToolProvider;
+
+
+
+exports.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.EFFECT_ACCEPTS = EFFECT_ACCEPTS; exports.EFFECT_PATH_FORMAT = EFFECT_PATH_FORMAT; exports.EFFECT_SUBJECT_KINDS = EFFECT_SUBJECT_KINDS; exports.EFFECT_LAYER_ROLES = EFFECT_LAYER_ROLES; exports.EFFECT_TRANSITION_MS = EFFECT_TRANSITION_MS; exports.EFFECT_TEMPLATE_SLOT_TYPES = EFFECT_TEMPLATE_SLOT_TYPES; exports.EFFECT_ERROR_CODES = EFFECT_ERROR_CODES; exports.EffectError = EffectError; exports.UnknownEffectError = UnknownEffectError; exports.UnknownTemplateError = UnknownTemplateError; exports.EffectControlError = EffectControlError; exports.EffectUnsupportedError = EffectUnsupportedError; exports.EffectDisposedError = EffectDisposedError; exports.NoEffectsProviderError = NoEffectsProviderError; exports.isEffectError = isEffectError; exports.effectValueErrors = effectValueErrors; exports.resolveEffectValues = resolveEffectValues; exports.effectOffered = effectOffered; exports.normaliseEffectTag = normaliseEffectTag; exports.hasEffectTags = hasEffectTags; exports.countEffectTags = countEffectTags; exports.pathControlsOf = pathControlsOf; exports.searchEffectSummaries = searchEffectSummaries; exports.createEffectPixels = createEffectPixels; exports.isEffectPixels = isEffectPixels; exports.srgbToLinear = srgbToLinear; exports.linearToSrgb = linearToSrgb; exports.encodeEffectFloat = encodeEffectFloat; exports.applyEffectMask = applyEffectMask; exports.EffectsSlot = EffectsSlot; exports.isCameraView = isCameraView; exports.sampleCameraViews = sampleCameraViews; exports.sampleEffectCameraMove = sampleEffectCameraMove; exports.cameraMoveField = cameraMoveField; exports.cameraMovesFor = cameraMovesFor; exports.cameraMoveIdList = cameraMoveIdList; exports.cameraMoveParts = cameraMoveParts; exports.CAMERA_MOVE_MAX_MS = CAMERA_MOVE_MAX_MS; exports.resolveCameraMoveSpec = resolveCameraMoveSpec; exports.cameraViewOfBox = cameraViewOfBox; exports.cameraBoxOfView = cameraBoxOfView; exports.createEffectToolProvider = createEffectToolProvider;

package/dist/{chunk-JWCKJNDR.cjs → chunk-K5DS2JTA.cjs}

@@ -4,7 +4,7 @@
 
 
 
-var _chunkJAOSL334cjs = require('./chunk-JAOSL334.cjs');
+var _chunkGHCSC2WPcjs = require('./chunk-GHCSC2WP.cjs');
 
 // src/effects/templates.ts
 var SLOT_NAME = /^[A-Za-z][\w-]*$/;
@@ -133,7 +133,7 @@ function searchTemplateSummaries(catalog, options = {}) {
   const words = (_nullishCoalesce(options.query, () => ( ""))).toLowerCase().split(/\s+/).filter(Boolean);
   const scored = [];
   for (const t of catalog) {
-    if (!_chunkJAOSL334cjs.hasEffectTags.call(void 0, t, options.tags)) continue;
+    if (!_chunkGHCSC2WPcjs.hasEffectTags.call(void 0, t, options.tags)) continue;
     let score = 0;
     const name = t.name.toLowerCase();
     const rest = [t.id, ..._nullishCoalesce(t.tags, () => ( [])), t.description].join(" ").toLowerCase();
@@ -200,7 +200,7 @@ function checkEffectSequence(sequence, catalog) {
           const p = effectSubjectProblem(layer.subject);
           if (p) problems.push(`${where}: ${p}.`);
         }
-        if (layer.role !== void 0 && !_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.join(", ")}.`);
+        if (layer.role !== void 0 && !_chunkGHCSC2WPcjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${_chunkGHCSC2WPcjs.EFFECT_LAYER_ROLES.join(", ")}.`);
         if (layer.rect !== void 0 && !isRect(layer.rect)) problems.push(`${where}: rect must be { x, y, width, height } with width and height > 0.`);
         for (const k of ["from", "until"]) if (layer[k] !== void 0 && !isLayerTime(layer[k])) problems.push(`${where}: ${k} is ms \u2265 0 or { shots: n } with n \u2265 1.`);
         if (layer.opacity !== void 0 && !(typeof layer.opacity === "number" && layer.opacity >= 0 && layer.opacity <= 1)) problems.push(`${where}: opacity is 0\u20131.`);
@@ -235,8 +235,8 @@ function effectSequenceSlots(sequence) {
   return [...out];
 }
 async function fillEffectTemplate(provider, id, values = {}, options = {}) {
-  if (!provider) throw new (0, _chunkJAOSL334cjs.NoEffectsProviderError)();
-  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).`);
+  if (!provider) throw new (0, _chunkGHCSC2WPcjs.NoEffectsProviderError)();
+  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).`);
   const template = await provider.describeTemplate(id);
   const errors = checkTemplateValues(template.slots, values);
   if (errors.length) throw new Error(`${errors.join(" ")} describe_template lists what each slot takes.`);
@@ -256,7 +256,7 @@ function effectSequenceTiming(sequence) {
   const leadIns = [];
   let t = 0;
   sequence.shots.forEach((shot, i) => {
-    const transition = i > 0 && shot.transition ? _nullishCoalesce(shot.transition.ms, () => ( _chunkJAOSL334cjs.EFFECT_TRANSITION_MS)) : 0;
+    const transition = i > 0 && shot.transition ? _nullishCoalesce(shot.transition.ms, () => ( _chunkGHCSC2WPcjs.EFFECT_TRANSITION_MS)) : 0;
     const move = typeof _optionalChain([shot, 'access', _4 => _4.camera, 'optionalAccess', _5 => _5.in]) === "object" && i > 0 ? _nullishCoalesce(shot.camera.in.ms, () => ( 0)) : 0;
     const lead = Math.max(transition, move);
     starts.push(t);

package/dist/{chunk-WDDUPWVG.js → chunk-L3JFOTBQ.js}

@@ -7,7 +7,7 @@ import {
   EffectsSlot,
   createEffectPixels,
   effectValueErrors
-} from "./chunk-SIK3LT6M.js";
+} from "./chunk-OFH6Q67U.js";
 import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";

package/dist/{chunk-SIK3LT6M.js → chunk-OFH6Q67U.js}

@@ -6,6 +6,8 @@ import {
 var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
 var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
 var CAMERA_MOVE_ROLES = ["transition", "hold"];
+var EFFECT_ACCEPTS = ["path"];
+var EFFECT_PATH_FORMAT = "svg-path";
 var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
 var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
 var EFFECT_TRANSITION_MS = 800;
@@ -104,7 +106,11 @@ function countEffectTags(effects) {
   for (const e of effects) for (const tag of new Set((e.tags ?? []).map(normaliseEffectTag))) if (tag) counts.set(tag, (counts.get(tag) ?? 0) + 1);
   return [...counts].map(([tag, count]) => ({ tag, count })).sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
 }
-var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags);
+var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags) && (!o.accepts?.length || o.accepts.every((a) => e.accepts?.includes(a)));
+function pathControlsOf(d) {
+  const isPath = (s) => !!s && (s.format === EFFECT_PATH_FORMAT || [...s.anyOf ?? [], ...s.oneOf ?? []].some((x) => isPath(x)));
+  return Object.entries(d.controls?.properties ?? {}).filter(([, s]) => isPath(s)).map(([name]) => name);
+}
 function searchEffectSummaries(catalog, query = "", options = {}) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   const scored = [];
@@ -322,7 +328,8 @@ var summaryOut = (e) => ({
   transparent: e.transparent,
   loop: e.loop,
   ...e.duration !== void 0 ? { duration: e.duration } : {},
-  ...e.camera ? { camera: e.camera } : {}
+  ...e.camera ? { camera: e.camera } : {},
+  ...e.accepts?.length ? { accepts: e.accepts } : {}
 });
 function createEffectToolProvider(host) {
   let catalog = null;
@@ -380,21 +387,32 @@ function createEffectToolProvider(host) {
     {
       name: "search_effects",
       title: "Search effects",
-      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one). For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
+      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one), and accepts ["path"] for effects that draw along a path you give. For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves, accepts }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
       inputSchema: object({
         query: { type: "string", description: "Words to match (default: every effect)." },
         kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG), motion (animates vector art) or camera (moves a scene's camera; no pixels)." },
         category: { type: "string", minLength: 1, description: `The provider's category, e.g. "gradient", "light", "transition".` },
         use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input, camera moves a scene's camera." },
         tags: { type: "array", items: { type: "string", minLength: 1 }, description: "Only effects carrying every one of these tags, as search_effects lists them (any case; spaces count as hyphens)." },
-        limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." }
+        limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." },
+        accepts: { type: "array", items: { type: "string", enum: [...EFFECT_ACCEPTS], description: "path: the effect has a control that draws along a path given at run time." }, description: "Only effects that take every one of these (path: effects that draw along a path you give; describe_effect names the controls in pathControls)." }
       }),
       annotations: { title: "Search effects", ...ANNOTATIONS.read },
       handler: async (args) => {
         const p = host.provider();
         if (!p) return { available: false, reason: NO_PROVIDER, effects: [], total: 0 };
         const tags = args.tags;
-        const found = (await explain(async () => p.search(args.query ?? "", { kind: args.kind, category: args.category, use: args.use, tags }))).filter((e) => hasEffectTags(e, tags));
+        const accepts = args.accepts;
+        let found = (await explain(async () => p.search(args.query ?? "", { kind: args.kind, category: args.category, use: args.use, tags, ...accepts?.length ? { accepts } : {} }))).filter((e) => hasEffectTags(e, tags));
+        if (accepts?.includes("path")) {
+          const kept = [];
+          for (const e of found) {
+            if (e.accepts) {
+              if (accepts.every((a) => e.accepts.includes(a))) kept.push(e);
+            } else if (kept.length < 200 && pathControlsOf(await explain(async () => p.describe(e.id))).length) kept.push(e);
+          }
+          found = kept;
+        }
         const limit = args.limit ?? 20;
         const out = { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length, tags: countEffectTags(found).slice(0, TAG_LIMIT) };
         if (tags?.length && !found.length) {
@@ -416,7 +434,8 @@ function createEffectToolProvider(host) {
         const p = host.provider();
         if (!p) return { available: false, reason: NO_PROVIDER };
         const d = await explain(async () => p.describe(args.effect));
-        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses) };
+        const pathControls = pathControlsOf(d);
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses), ...pathControls.length ? { pathControls } : {} };
       }
     },
     {
@@ -531,6 +550,8 @@ export {
   EFFECT_KINDS,
   EFFECT_USES,
   CAMERA_MOVE_ROLES,
+  EFFECT_ACCEPTS,
+  EFFECT_PATH_FORMAT,
   EFFECT_SUBJECT_KINDS,
   EFFECT_LAYER_ROLES,
   EFFECT_TRANSITION_MS,
@@ -550,6 +571,7 @@ export {
   normaliseEffectTag,
   hasEffectTags,
   countEffectTags,
+  pathControlsOf,
   searchEffectSummaries,
   createEffectPixels,
   isEffectPixels,