@pixerate/editor 0.266.2 → 0.268.0

package/dist/animation-editor/index.js

@@ -1,6 +1,6 @@
 import {
   createVectorMorph
-} from "../chunk-LK4SXL3V.js";
+} from "../chunk-QNY7BDFP.js";
 import {
   MOTION_ISSUE_CODES,
   motionIssue,
@@ -39,9 +39,9 @@ import {
   vectorNodeBounds,
   vectorPathWorldBezier,
   vectorTextHasOutlines
-} from "../chunk-T2LDTEXK.js";
-import "../chunk-CIJBSUM5.js";
-import "../chunk-ACFSFUQH.js";
+} from "../chunk-UVTO3D4E.js";
+import "../chunk-KZI3YWKW.js";
+import "../chunk-JL6YH5WD.js";
 import "../chunk-M6DNZNVY.js";
 import {
   bezierPathLength,
@@ -74,12 +74,13 @@ import {
   resolveEffectValues
 } from "../chunk-MV7CYFMJ.js";
 import "../chunk-V2ZCJRDM.js";
-import "../chunk-TXFWZ5ZJ.js";
-import "../chunk-GCVFEPJG.js";
+import "../chunk-GSTSZPSR.js";
+import "../chunk-W6JDUXP3.js";
+import "../chunk-ACTHSQOI.js";
 import "../chunk-4D6KP5BV.js";
 import "../chunk-ODBT55Q7.js";
-import "../chunk-OTTT5N3K.js";
 import "../chunk-IRSTHLQQ.js";
+import "../chunk-OTTT5N3K.js";
 import "../chunk-HVVR5PZW.js";
 import "../chunk-QGHEDC7B.js";
 import "../chunk-SIFAIGB3.js";
@@ -4901,6 +4902,25 @@ var AnimationEditorController = class {
       return { scene: { ...this.scene, shots }, label: `Apply ${d.name}`, instance, notes };
     });
   }
+  async resolveVectorPath(artwork, d, path, controlName) {
+    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 = controlName ?? (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(", ")}.`);
+    if ("node" in path) {
+      const entry = indexMotionNodes(artwork.nodes).get(path.node);
+      if (!entry) throw new Error(`There is no node "${path.node}"; find_animation_elements lists the artwork's nodes.`);
+      if (entry.node.type !== "path") throw new Error(`Node "${path.node}" is a ${entry.node.type}, not a path; pass a path node (find_animation_elements shows each node's type).`);
+      const value2 = bezierPathToSvg(vectorPathWorldBezier(entry.node, entry.parentWorld, { effects: false }));
+      return { control, value: value2, place: "viewBox" };
+    }
+    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 path.text !== "string" || !path.text.trim()) throw new Error("text is empty; pass the words to write.");
+    const value = await provider.pathFromText(path.text, { ...path.font ? { font: path.font } : {}, ...path.align ? { align: path.align } : {} });
+    return { control, value };
+  }
   /**
    * Adds a provider vector effect (one with its own picture: a lower third, a loader): its SVG as
    * an artwork group (id: the instance) fitted into `box` (default the whole artwork), and its
@@ -4912,25 +4932,9 @@ var AnimationEditorController = class {
       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 resolved = await this.resolveVectorPath(this.scene.artwork, d, options.path, options.control);
+        if (resolved.place) place ??= resolved.place;
+        given = { ...given ?? {}, [resolved.control]: resolved.value };
       }
       const values = resolveEffectValues(d, given);
       const instance = options.instance ?? nextMotionEffectInstance(this.scene);
@@ -4940,6 +4944,33 @@ var AnimationEditorController = class {
       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 };
     });
   }
+  /**
+   * Sets an applied vector effect's path from a path node in the artwork (landing on the node at
+   * scale 1) or words written by the provider (keeping where the picture was placed). One undo step.
+   */
+  setVectorEffectPath(instance, path, options = {}) {
+    return this.effectEdit(async () => {
+      const was = motionSceneEffects(this.scene).find((e) => e.instance === instance);
+      if (!was) throw new Error(`There is no applied effect "${instance}"; list_applied_effects lists them.`);
+      if (was.kind !== "vector") throw new Error(`"${instance}" is a motion effect, not a vector effect.`);
+      const d = await this.describeFor(was.effect, ["vector"]);
+      const { scene: bare } = withoutMotionEffect(this.scene, instance);
+      const { control, value, place } = await this.resolveVectorPath(bare.artwork, d, path, options.control);
+      const merged = { ...was.values, [control]: value };
+      const provider = this.effects.require();
+      const source = { instance, effect: d.id, provider: provider.id, name: d.name, values: merged };
+      const motion = await provider.applyVectorEffect(d.id, motionArtworkSvg(bare.artwork), merged);
+      const { group, shots, notes } = motionPartsFromVectorEffect(bare.artwork, motion, source, place);
+      const old = this.scene.artwork.nodes.find((n2) => n2.id === instance);
+      const index = this.scene.artwork.nodes.findIndex((n2) => n2.id === instance);
+      const nodes = [...bare.artwork.nodes];
+      nodes.splice(Math.max(0, index), 0, !place && old?.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)), ...shots, ...kept.slice(Math.max(0, at))];
+      return { scene: { ...bare, artwork: { ...bare.artwork, nodes }, shots: nextShots }, label: `Set ${d.name} path`, instance, notes };
+    });
+  }
   /**
    * Makes an applied effect again with new `values` (merged over its own; `null` resets a
    * control), in the same place. One undo step.
@@ -7239,7 +7270,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. 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.',
+        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; after reshaping the node, give it the path again with set_vector_effect_path. 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: {
@@ -7283,6 +7314,42 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
           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 } : {} };
         }
+      },
+      {
+        name: "set_vector_effect_path",
+        title: "Run a vector effect along a path",
+        description: 'Gives a vector effect already added with add_vector_effect (instance: its id from add_vector_effect or list_applied_effects) a new path to draw along, in place: path: { node } runs it along a path node (its outline with every transform applied) and lands the picture on the node at scale 1; { text } writes words with the provider and keeps the picture where it was. Use it after reshaping the node the effect was run along, or to switch between a node and words. To clear the path, call update_effect with the path control set to "". Refuses a motion effect, an effect without a path control, an unknown or non-path node, and a provider that cannot write words, saying what to pass. One undo step. Returns the instance, the control set, its new path data and any notes.',
+        inputSchema: {
+          type: "object",
+          properties: {
+            instance: { type: "string", minLength: 1, description: "The applied vector effect id (add_vector_effect instance, or list_applied_effects)." },
+            path: {
+              type: "object",
+              description: "The path the effect draws along: { 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: ["instance", "path"],
+          additionalProperties: false
+        },
+        annotations: { title: "Run a vector effect along a path", ...ctx.annotations.write, idempotentHint: true },
+        handler: async (args) => {
+          ctx.requireProvider();
+          if (args.path.node !== void 0 && args.path.text !== void 0) throw new Error("Pass path as { node } or { text }, not both.");
+          const path = args.path.node !== void 0 ? { node: args.path.node } : { text: args.path.text, font: args.path.font, align: args.path.align };
+          const r = await controller.setVectorEffectPath(args.instance, path, { control: args.control });
+          if (!r.ok) throw new Error(r.error);
+          const control = args.control ?? pathControlsOf(await controller.effectsProvider.describe(r.effect.effect))[0];
+          return { instance: r.effect.instance, group: r.effect.group, control, value: r.effect.values[control], effect: info(r.effect), ...r.notes.length ? { notes: r.notes } : {} };
+        }
       }
     ]
   }), options.playbackSurface);