@pixerate/editor 0.231.1 → 0.232.0

package/dist/animation-editor/index.cjs

@@ -54,7 +54,7 @@ require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkOPSK22DLcjs = require('../chunk-OPSK22DL.cjs');
+var _chunk2K5TELHVcjs = require('../chunk-2K5TELHV.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 require('../chunk-PQ3H2AAN.cjs');
 require('../chunk-YQGCPL5X.cjs');
@@ -1053,8 +1053,8 @@ function compileMotionScene(scene) {
     const start = t;
     let cursor = start;
     const f = motionShotTimeScale(shot);
-    const moveIn = shot.camera ? _chunkOPSK22DLcjs.cameraMoveParts.call(void 0, shot.camera.in) : void 0;
-    const moveDuring = shot.camera ? _chunkOPSK22DLcjs.cameraMoveParts.call(void 0, shot.camera.during) : void 0;
+    const moveIn = shot.camera ? _chunk2K5TELHVcjs.cameraMoveParts.call(void 0, shot.camera.in) : void 0;
+    const moveDuring = shot.camera ? _chunk2K5TELHVcjs.cameraMoveParts.call(void 0, shot.camera.during) : void 0;
     let playsIn = false;
     if (shot.camera) {
       const framed = motionCameraFramed(shot.camera);
@@ -1422,7 +1422,7 @@ function motionShotAt(timeline, time) {
 // src/animation-editor/camera.ts
 var windowCache = /* @__PURE__ */ new WeakMap();
 function motionShotCameraMove(shot, role) {
-  return _chunkOPSK22DLcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'optionalAccess', _55 => _55.camera, 'optionalAccess', _56 => _56[role === "transition" ? "in" : "during"]]));
+  return _chunk2K5TELHVcjs.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";
@@ -1444,7 +1444,7 @@ function motionCameraWindows(scene, provider) {
   const track = timeline.tracks.get(motionTrackKey("", "camera"));
   const boxView = (t) => {
     const b = trackValue(track, t);
-    return _chunkOPSK22DLcjs.cameraViewOfBox.call(void 0, Array.isArray(b) ? { x: b[0], y: b[1], width: b[2], height: b[3] } : full, stage);
+    return _chunk2K5TELHVcjs.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 {
@@ -1460,7 +1460,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 = _chunkOPSK22DLcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'access', _61 => _61.camera, 'optionalAccess', _62 => _62.in]));
+      const spec = _chunk2K5TELHVcjs.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)) {
@@ -1472,7 +1472,7 @@ function motionCameraWindows(scene, provider) {
       carry = null;
     } else if (framed) carry = null;
     if (timing.cameraDuring && timing.end > timing.commandsEnd) {
-      const spec = _chunkOPSK22DLcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'access', _63 => _63.camera, 'optionalAccess', _64 => _64.during]));
+      const spec = _chunk2K5TELHVcjs.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);
@@ -1489,8 +1489,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 = _chunkOPSK22DLcjs.cameraBoxOfView.call(void 0, from, stage);
-  const b = _chunkOPSK22DLcjs.cameraBoxOfView.call(void 0, to, stage);
+  const a = _chunk2K5TELHVcjs.cameraBoxOfView.call(void 0, from, stage);
+  const b = _chunk2K5TELHVcjs.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);
@@ -1522,7 +1522,7 @@ function motionCameraViewAt(scene, time, provider) {
   return retaken ? null : before.after;
 }
 function motionCameraBox(view, scene) {
-  return _chunkOPSK22DLcjs.cameraBoxOfView.call(void 0, view, motionCameraStage(scene));
+  return _chunk2K5TELHVcjs.cameraBoxOfView.call(void 0, view, motionCameraStage(scene));
 }
 function motionCameraTransform(view, width) {
   if (!view || !view.tilt && !view.turn) return "";
@@ -1563,7 +1563,7 @@ async function checkMotionCameraMoves(scene, provider) {
       const spec = shot.camera[field];
       if (spec === void 0) continue;
       try {
-        await _chunkOPSK22DLcjs.resolveCameraMoveSpec.call(void 0, provider, spec, role);
+        await _chunk2K5TELHVcjs.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(_chunkERJA5CGTcjs.motionIssue.call(void 0, code, error.message, { shot: shot.id }));
@@ -2910,7 +2910,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([_chunkOPSK22DLcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'optionalAccess', _134 => _134.camera, 'optionalAccess', _135 => _135.in])), 'optionalAccess', _136 => _136.move]);
+    const move = _optionalChain([_chunk2K5TELHVcjs.cameraMoveParts.call(void 0, _optionalChain([shot, 'optionalAccess', _134 => _134.camera, 'optionalAccess', _135 => _135.in])), 'optionalAccess', _136 => _136.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));
@@ -4078,7 +4078,7 @@ var AnimationEditorController = (_class = class {
   
   
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init() {this.effects = new (0, _chunkOPSK22DLcjs.EffectsSlot)()}
+  __init() {this.effects = new (0, _chunk2K5TELHVcjs.EffectsSlot)()}
   
   
   __init2() {this.selection = null}
@@ -4263,7 +4263,7 @@ var AnimationEditorController = (_class = class {
     try {
       plan = await work();
     } catch (error) {
-      if (_chunkOPSK22DLcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunk2K5TELHVcjs.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 });
@@ -4274,11 +4274,11 @@ var AnimationEditorController = (_class = class {
   }
   async describeFor(effect, kinds) {
     const provider = this.effects.require();
-    if (!provider.applyVectorEffect) throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
+    if (!provider.applyVectorEffect) throw new (0, _chunk2K5TELHVcjs.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, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
+      throw new (0, _chunk2K5TELHVcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
     }
     return d;
   }
@@ -4299,7 +4299,7 @@ var AnimationEditorController = (_class = class {
     return this.effectEdit(async () => {
       this.knownNodes(targets);
       const d = await this.describeFor(effect, ["motion"]);
-      const values = _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunk2K5TELHVcjs.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 };
@@ -4321,7 +4321,7 @@ var AnimationEditorController = (_class = class {
   addVectorEffect(effect, options = {}) {
     return this.effectEdit(async () => {
       const d = await this.describeFor(effect, ["vector"]);
-      const values = _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunk2K5TELHVcjs.resolveEffectValues.call(void 0, d, options.values);
       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 };
@@ -4345,7 +4345,7 @@ var AnimationEditorController = (_class = 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, ..._chunkOPSK22DLcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+      const merged = { ...base, ..._chunk2K5TELHVcjs.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 };
@@ -4400,12 +4400,12 @@ var AnimationEditorController = (_class = 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 _chunkOPSK22DLcjs.resolveCameraMoveSpec.call(void 0, this.effects.require(), spec, role);
+      resolved = await _chunk2K5TELHVcjs.resolveCameraMoveSpec.call(void 0, this.effects.require(), spec, role);
     } catch (error) {
-      if (_chunkOPSK22DLcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunk2K5TELHVcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
-    const field = _chunkOPSK22DLcjs.cameraMoveField.call(void 0, role);
+    const field = _chunk2K5TELHVcjs.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;
@@ -4419,7 +4419,7 @@ var AnimationEditorController = (_class = 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 = _chunkOPSK22DLcjs.cameraMoveField.call(void 0, role);
+    const field = _chunk2K5TELHVcjs.cameraMoveField.call(void 0, role);
     if (_optionalChain([found, 'access', _185 => _185.camera, 'optionalAccess', _186 => _186[field]]) === void 0) return this.refuse(`Shot "${shot}" has no camera "${field}" move to clear${_optionalChain([found, 'access', _187 => _187.camera, 'optionalAccess', _188 => _188[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];
@@ -6199,7 +6199,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: _chunkOPSK22DLcjs.CAMERA_MOVE_MAX_MS, description: `How long a transition takes, ms (0\u2013${_chunkOPSK22DLcjs.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: _chunk2K5TELHVcjs.CAMERA_MOVE_MAX_MS, description: `How long a transition takes, ms (0\u2013${_chunk2K5TELHVcjs.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")
         },
@@ -6241,7 +6241,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(_chunkOPSK22DLcjs.createEffectToolProvider.call(void 0, {
+  return withAnimationPlayback(_chunk2K5TELHVcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "animation-effects")),
     namespace: options.namespace,
     title: "Animation effects",

package/dist/animation-editor/index.js

@@ -54,7 +54,7 @@ import {
   isEffectError,
   resolveCameraMoveSpec,
   resolveEffectValues
-} from "../chunk-TCZ2J7PR.js";
+} from "../chunk-PQYDJ2AV.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-2PBZBRP5.js";
 import "../chunk-ODBT55Q7.js";

package/dist/canvas/index.cjs

@@ -220,7 +220,7 @@ var _chunkNM3G4VQTcjs = require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkOPSK22DLcjs = require('../chunk-OPSK22DL.cjs');
+var _chunk2K5TELHVcjs = require('../chunk-2K5TELHV.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -11425,14 +11425,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, _chunkOPSK22DLcjs.EffectsSlot)();
+  const slot = new (0, _chunk2K5TELHVcjs.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, _chunkOPSK22DLcjs.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, _chunk2K5TELHVcjs.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;
   };
@@ -11463,7 +11463,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, ..._chunkOPSK22DLcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+    return { ...base, ..._chunk2K5TELHVcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
   };
   return {
     /** The provider slot. */
@@ -11497,7 +11497,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: _chunkOPSK22DLcjs.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: _chunk2K5TELHVcjs.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;
     },
@@ -11554,7 +11554,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: _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
+      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunk2K5TELHVcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
       scenes2.update(sceneId, { transition });
       return transition;
     }
@@ -11698,7 +11698,7 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
   const once = (instance) => {
     if (instance !== "effect") throw new Error('A shape node has one effect, "effect".');
   };
-  return _chunkOPSK22DLcjs.createEffectToolProvider.call(void 0, {
+  return _chunk2K5TELHVcjs.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-TCZ2J7PR.js";
+} from "../chunk-PQYDJ2AV.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket

package/dist/{chunk-OPSK22DL.cjs → chunk-2K5TELHV.cjs}

@@ -3,7 +3,7 @@
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
 
 // src/effects/errors.ts
-var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider"];
+var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider", "unknown_template"];
 var EffectError = class extends Error {
   
   
@@ -24,6 +24,14 @@ var UnknownEffectError = class extends EffectError {
     this.name = "UnknownEffectError";
   }
 };
+var UnknownTemplateError = class extends EffectError {
+  
+  constructor(templateId, providerName) {
+    super("unknown_template", `Unknown template "${templateId}"${providerName ? ` in ${providerName}` : ""}. Call list_templates or listTemplates() for valid ids.`);
+    this.name = "UnknownTemplateError";
+    this.templateId = templateId;
+  }
+};
 var EffectControlError = class extends EffectError {
   
   constructor(effectId, details) {
@@ -277,6 +285,10 @@ function cameraBoxOfView(view, stage) {
 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_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
+var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
+var EFFECT_TRANSITION_MS = 800;
+var EFFECT_TEMPLATE_SLOT_TYPES = ["image", "video", "svg", "text", "color", "number"];
 
 // src/effects/tools.ts
 var ANNOTATIONS = {
@@ -553,4 +565,9 @@ function createEffectToolProvider(host) {
 
 
 
-exports.EFFECT_ERROR_CODES = EFFECT_ERROR_CODES; exports.EffectError = EffectError; exports.UnknownEffectError = UnknownEffectError; 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.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.createEffectToolProvider = createEffectToolProvider;
+
+
+
+
+
+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.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.createEffectToolProvider = createEffectToolProvider;

package/dist/{chunk-CSM5T6SE.js → chunk-6QLTUGMO.js}

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

package/dist/{chunk-5T3H7CGG.cjs → chunk-A653N65Q.cjs}

@@ -7,7 +7,7 @@ var _chunkPY4GWSE2cjs = require('./chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkOPSK22DLcjs = require('./chunk-OPSK22DL.cjs');
+var _chunk2K5TELHVcjs = require('./chunk-2K5TELHV.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
@@ -1316,12 +1316,12 @@ function videoEffectLayerKey(layer, width, height) {
 }
 function mixEffectPixels(a, b, k) {
   if (k >= 1) return b;
-  const out = _chunkOPSK22DLcjs.createEffectPixels.call(void 0, a.width, a.height);
+  const out = _chunk2K5TELHVcjs.createEffectPixels.call(void 0, a.width, a.height);
   for (let i = 0; i < out.data.length; i++) out.data[i] = a.data[i] + (b.data[i] - a.data[i]) * k;
   return out;
 }
 function overEffectPixels(base, top, opacity = 1) {
-  const out = _chunkOPSK22DLcjs.createEffectPixels.call(void 0, base.width, base.height);
+  const out = _chunk2K5TELHVcjs.createEffectPixels.call(void 0, base.width, base.height);
   const o = out.data;
   const b = base.data;
   const t = top.data;
@@ -1366,7 +1366,7 @@ var VideoEffectsEngine = (_class2 = class {
   __init10() {this.generation = 0}
   
   constructor(options = {}) {;_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);
-    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkOPSK22DLcjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunk2K5TELHVcjs.EffectsSlot)()));
     this.maxEntries = _nullishCoalesce(options.maxEntries, () => ( 120));
     this.toImage = _nullishCoalesce(options.toImage, () => ( defaultToImage));
     this.pool = new (0, _chunkPY4GWSE2cjs.EffectRendererPool)({ maxRenderers: options.maxRenderers });
@@ -1508,7 +1508,7 @@ function checkVideoEffectPlace(d, place) {
   if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
     const where = place === "clip" ? "on a clip" : place === "transition" ? "as a transition" : "as an effect clip";
     const instead = d.uses.includes("transition") ? "set_video_effect_transition" : d.uses.some((u) => VIDEO_EFFECT_PLACES.generator.includes(u)) ? "add_video_effect_clip" : d.uses.some((u) => u === "filter") ? "apply_effect" : null;
-    throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(
+    throw new (0, _chunk2K5TELHVcjs.EffectUnsupportedError)(
       `"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be used ${where}, which takes ${allowed.join(" or ")} effects${instead ? `; use ${instead} instead` : ""}. search_effects with use "${allowed[0]}" lists ones that fit.`,
       d.id
     );
@@ -1529,12 +1529,12 @@ function checkVideoEffectValues(d, values, options = {}) {
     else if (type !== "number" && type !== "integer") errors.push({ path: `/${k}`, message: "only number controls can be keyframed." });
     else for (const [i, key] of v.keys.entries()) for (const e of _chunkWOFXZ3XUcjs.validateJsonSchema.call(void 0, key.v, schema)) errors.push({ path: `/${k}/keys/${i}/v`, message: e.message });
   }
-  for (const e of _chunkOPSK22DLcjs.effectValueErrors.call(void 0, d, plain)) {
+  for (const e of _chunk2K5TELHVcjs.effectValueErrors.call(void 0, d, plain)) {
     const name = e.path.split("/")[1];
     const about = name && _optionalChain([d, 'access', _46 => _46.controls, 'access', _47 => _47.properties, 'access', _48 => _48[name], 'optionalAccess', _49 => _49.description]);
     errors.push(about ? { path: e.path, message: `${e.message} (${about})` } : e);
   }
-  if (errors.length) throw new (0, _chunkOPSK22DLcjs.EffectControlError)(d.id, errors);
+  if (errors.length) throw new (0, _chunk2K5TELHVcjs.EffectControlError)(d.id, errors);
   return { ..._nullishCoalesce(options.base, () => ( d.defaults)), ..._nullishCoalesce(values, () => ( {})) };
 }
 

package/dist/{chunk-SBPGIZQN.js → chunk-MUSZYMBX.js}

@@ -3,7 +3,7 @@ import {
   EffectDisposedError,
   EffectUnsupportedError,
   effectValueErrors
-} from "./chunk-TCZ2J7PR.js";
+} from "./chunk-PQYDJ2AV.js";
 import {
   HistoryManager
 } from "./chunk-RNSANXPT.js";

package/dist/{chunk-TCZ2J7PR.js → chunk-PQYDJ2AV.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-V2ZCJRDM.js";
 
 // src/effects/errors.ts
-var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider"];
+var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider", "unknown_template"];
 var EffectError = class extends Error {
   code;
   effectId;
@@ -24,6 +24,14 @@ var UnknownEffectError = class extends EffectError {
     this.name = "UnknownEffectError";
   }
 };
+var UnknownTemplateError = class extends EffectError {
+  templateId;
+  constructor(templateId, providerName) {
+    super("unknown_template", `Unknown template "${templateId}"${providerName ? ` in ${providerName}` : ""}. Call list_templates or listTemplates() for valid ids.`);
+    this.name = "UnknownTemplateError";
+    this.templateId = templateId;
+  }
+};
 var EffectControlError = class extends EffectError {
   details;
   constructor(effectId, details) {
@@ -277,6 +285,10 @@ function cameraBoxOfView(view, stage) {
 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_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
+var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
+var EFFECT_TRANSITION_MS = 800;
+var EFFECT_TEMPLATE_SLOT_TYPES = ["image", "video", "svg", "text", "color", "number"];
 
 // src/effects/tools.ts
 var ANNOTATIONS = {
@@ -519,6 +531,7 @@ export {
   EFFECT_ERROR_CODES,
   EffectError,
   UnknownEffectError,
+  UnknownTemplateError,
   EffectControlError,
   EffectUnsupportedError,
   EffectDisposedError,
@@ -552,5 +565,9 @@ export {
   EFFECT_KINDS,
   EFFECT_USES,
   CAMERA_MOVE_ROLES,
+  EFFECT_SUBJECT_KINDS,
+  EFFECT_LAYER_ROLES,
+  EFFECT_TRANSITION_MS,
+  EFFECT_TEMPLATE_SLOT_TYPES,
   createEffectToolProvider
 };

package/dist/{chunk-C73U5UI3.cjs → chunk-RG4O6K2A.cjs}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkOPSK22DLcjs = require('./chunk-OPSK22DL.cjs');
+var _chunk2K5TELHVcjs = require('./chunk-2K5TELHV.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(..._chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
+    else errors.push(..._chunk2K5TELHVcjs.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(..._chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
+            errors.push(..._chunk2K5TELHVcjs.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(..._chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
+        errors.push(..._chunk2K5TELHVcjs.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, _chunkOPSK22DLcjs.EffectUnsupportedError)("Invalid effect authoring document: version 1 required");
+      throw new (0, _chunk2K5TELHVcjs.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, _chunkOPSK22DLcjs.EffectUnsupportedError)("Invalid effect authoring source");
+    throw new (0, _chunk2K5TELHVcjs.EffectUnsupportedError)("Invalid effect authoring source");
   }
   const description = await provider.describe(effectId);
   if (initialDoc) {
     const problems = documentErrors(initialDoc, description);
-    if (problems.length) throw new (0, _chunkOPSK22DLcjs.EffectControlError)(effectId, problems);
+    if (problems.length) throw new (0, _chunk2K5TELHVcjs.EffectControlError)(effectId, problems);
   }
   if (description.kind === "motion") {
-    throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)("Motion effects cannot be authored as pixel effects", effectId);
+    throw new (0, _chunk2K5TELHVcjs.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, _chunkOPSK22DLcjs.EffectUnsupportedError)(
+      throw new (0, _chunk2K5TELHVcjs.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 = _chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [name]: value });
+      const errors = _chunk2K5TELHVcjs.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 = _chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [k]: v });
+        const errors = _chunk2K5TELHVcjs.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 = _chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [name]: targetValue });
+      const errors = _chunk2K5TELHVcjs.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, _chunkOPSK22DLcjs.EffectDisposedError)(effectId);
+        throw new (0, _chunk2K5TELHVcjs.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, _chunkOPSK22DLcjs.EffectDisposedError)(effectId);
+          if (disposed) throw new (0, _chunk2K5TELHVcjs.EffectDisposedError)(effectId);
           const effectiveValues = _nullishCoalesce(req.values, () => ( valuesAtTime(req.time, baseValues, tracks)));
           const pixels = await renderer.render({
             ...req,

package/dist/effects/conformance.d.cts

@@ -6,6 +6,8 @@
 import { type EffectProvider } from './types.cjs';
 export interface EffectConformanceIssue {
     effectId?: string;
+    /** Set for an issue with a sequence template. */
+    templateId?: string;
     message: string;
 }
 export interface EffectConformanceOptions {
@@ -17,6 +19,7 @@ export interface EffectConformanceOptions {
     size?: number;
     /** Also check authoring when supportsAuthoring is true (default true). */
     authoring?: boolean;
+    /** Also check sequence templates when supportsTemplates is true (default true). */
+    templates?: boolean;
 }
-/** Runs the contract checks against `provider` and returns every issue found (empty when it conforms). */
 export declare function checkEffectProvider(provider: EffectProvider, options?: EffectConformanceOptions): Promise<EffectConformanceIssue[]>;

package/dist/effects/conformance.d.ts

@@ -6,6 +6,8 @@
 import { type EffectProvider } from './types.js';
 export interface EffectConformanceIssue {
     effectId?: string;
+    /** Set for an issue with a sequence template. */
+    templateId?: string;
     message: string;
 }
 export interface EffectConformanceOptions {
@@ -17,6 +19,7 @@ export interface EffectConformanceOptions {
     size?: number;
     /** Also check authoring when supportsAuthoring is true (default true). */
     authoring?: boolean;
+    /** Also check sequence templates when supportsTemplates is true (default true). */
+    templates?: boolean;
 }
-/** Runs the contract checks against `provider` and returns every issue found (empty when it conforms). */
 export declare function checkEffectProvider(provider: EffectProvider, options?: EffectConformanceOptions): Promise<EffectConformanceIssue[]>;

package/dist/effects/errors.d.cts

@@ -1,5 +1,5 @@
 import type { SchemaValidationError } from '../tools/schema.cjs';
-export type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider';
+export type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider' | 'unknown_template';
 export declare const EFFECT_ERROR_CODES: readonly EffectErrorCode[];
 /**
  * Base of every effects error. Check `code` (or use `isEffectError`) rather than `instanceof`
@@ -14,6 +14,11 @@ export declare class EffectError extends Error {
 export declare class UnknownEffectError extends EffectError {
     constructor(effectId: string, providerName?: string);
 }
+/** No sequence template has this id. */
+export declare class UnknownTemplateError extends EffectError {
+    readonly templateId: string;
+    constructor(templateId: string, providerName?: string);
+}
 /** Control values do not match the effect's control schema (unknown control, wrong type, out of range). */
 export declare class EffectControlError extends EffectError {
     readonly details: readonly SchemaValidationError[];