@pixerate/editor 0.223.9 → 0.224.0

package/dist/animation-editor/index.cjs

@@ -48,7 +48,7 @@ require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkA3A5TI6Rcjs = require('../chunk-A3A5TI6R.cjs');
+var _chunkNTWR5TQBcjs = require('../chunk-NTWR5TQB.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 require('../chunk-PQ3H2AAN.cjs');
 require('../chunk-YQGCPL5X.cjs');
@@ -3828,7 +3828,7 @@ var AnimationEditorController = (_class = class {
   
   
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init() {this.effects = new (0, _chunkA3A5TI6Rcjs.EffectsSlot)()}
+  __init() {this.effects = new (0, _chunkNTWR5TQBcjs.EffectsSlot)()}
   
   
   __init2() {this.selection = null}
@@ -4013,7 +4013,7 @@ var AnimationEditorController = (_class = class {
     try {
       plan = await work();
     } catch (error) {
-      if (_chunkA3A5TI6Rcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunkNTWR5TQBcjs.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 });
@@ -4024,11 +4024,11 @@ var AnimationEditorController = (_class = class {
   }
   async describeFor(effect, kinds) {
     const provider = this.effects.require();
-    if (!provider.applyVectorEffect) throw new (0, _chunkA3A5TI6Rcjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
+    if (!provider.applyVectorEffect) throw new (0, _chunkNTWR5TQBcjs.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, _chunkA3A5TI6Rcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
+      throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
     }
     return d;
   }
@@ -4049,7 +4049,7 @@ var AnimationEditorController = (_class = class {
     return this.effectEdit(async () => {
       this.knownNodes(targets);
       const d = await this.describeFor(effect, ["motion"]);
-      const values = _chunkA3A5TI6Rcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunkNTWR5TQBcjs.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 };
@@ -4071,7 +4071,7 @@ var AnimationEditorController = (_class = class {
   addVectorEffect(effect, options = {}) {
     return this.effectEdit(async () => {
       const d = await this.describeFor(effect, ["vector"]);
-      const values = _chunkA3A5TI6Rcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunkNTWR5TQBcjs.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 };
@@ -4095,7 +4095,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, ..._chunkA3A5TI6Rcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+      const merged = { ...base, ..._chunkNTWR5TQBcjs.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 };
@@ -5868,7 +5868,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(_chunkA3A5TI6Rcjs.createEffectToolProvider.call(void 0, {
+  return withAnimationPlayback(_chunkNTWR5TQBcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "animation-effects")),
     namespace: options.namespace,
     title: "Animation effects",

package/dist/animation-editor/index.js

@@ -48,7 +48,7 @@ import {
   createEffectToolProvider,
   isEffectError,
   resolveEffectValues
-} from "../chunk-6G2NLMVK.js";
+} from "../chunk-HKPLKISO.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-2PBZBRP5.js";
 import "../chunk-ODBT55Q7.js";

package/dist/canvas/index.cjs

@@ -209,7 +209,7 @@ var _chunkNM3G4VQTcjs = require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkA3A5TI6Rcjs = require('../chunk-A3A5TI6R.cjs');
+var _chunkNTWR5TQBcjs = require('../chunk-NTWR5TQB.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -11396,14 +11396,14 @@ function canvasNodeEffect(node) {
   return _chunkNM3G4VQTcjs.isShapeDescription.call(void 0, shape) ? shape.effect : void 0;
 }
 function createCanvasEffectsController(options) {
-  const slot = new (0, _chunkA3A5TI6Rcjs.EffectsSlot)();
+  const slot = new (0, _chunkNTWR5TQBcjs.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, _chunkA3A5TI6Rcjs.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, _chunkNTWR5TQBcjs.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;
   };
@@ -11434,7 +11434,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, ..._chunkA3A5TI6Rcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+    return { ...base, ..._chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
   };
   return {
     /** The provider slot. */
@@ -11464,7 +11464,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: _chunkA3A5TI6Rcjs.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: _chunkNTWR5TQBcjs.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;
     },
@@ -11521,7 +11521,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: _chunkA3A5TI6Rcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
+      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
       scenes2.update(sceneId, { transition });
       return transition;
     }
@@ -11665,7 +11665,7 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
   const once = (instance) => {
     if (instance !== "effect") throw new Error('A shape node has one effect, "effect".');
   };
-  return _chunkA3A5TI6Rcjs.createEffectToolProvider.call(void 0, {
+  return _chunkNTWR5TQBcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "canvas-effects")),
     namespace: options.namespace,
     title: "Canvas effects",

package/dist/canvas/index.js

@@ -209,7 +209,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-6G2NLMVK.js";
+} from "../chunk-HKPLKISO.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket

package/dist/{chunk-6DUEV36F.cjs → chunk-7AAS3JO6.cjs}

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

package/dist/{chunk-6G2NLMVK.js → chunk-HKPLKISO.js}

@@ -68,6 +68,12 @@ function resolveEffectValues(description, values) {
   if (errors.length) throw new EffectControlError(description.id, errors);
   return { ...description.defaults, ...values ?? {} };
 }
+function effectOffered(e, uses) {
+  if (!uses) return e.kind !== "motion" && e.kind !== "camera";
+  if (e.kind === "motion" && !uses.includes("motion")) return false;
+  if (e.kind === "camera" && !uses.includes("camera")) return false;
+  return e.uses.some((u) => uses.includes(u));
+}
 function normaliseEffectTag(tag) {
   return tag.trim().toLowerCase().replace(/[\s_-]+/g, "-");
 }
@@ -167,10 +173,47 @@ var EffectsSlot = class {
     return () => this.listeners.delete(listener);
   }
 };
+var BEFORE_CUT = 1e-6;
+function isCameraView(view) {
+  if (!view || typeof view !== "object") return false;
+  const v = view;
+  if (!(typeof v.zoom === "number" && v.zoom > 0 && Number.isFinite(v.zoom))) return false;
+  if (!Number.isFinite(v.scrollX) || !Number.isFinite(v.scrollY)) return false;
+  return ["tilt", "turn", "roll", "perspective", "blur", "blurAngle"].every((k) => v[k] === void 0 || Number.isFinite(v[k]));
+}
+function sampleCameraViews(view, options) {
+  const { ms, fps, cut } = options;
+  if (!(Number.isFinite(ms) && ms >= 0)) throw new EffectUnsupportedError(`ms must be a finite number of ms \u2265 0, got ${ms}.`);
+  if (!(Number.isFinite(fps) && fps > 0)) throw new EffectUnsupportedError(`fps must be a number > 0, got ${fps}.`);
+  if (cut !== void 0 && !(cut >= 0 && cut <= 1)) throw new EffectUnsupportedError(`cut must be 0\u20131, got ${cut}.`);
+  if (ms === 0) return { keys: [{ t: 0, view: view(0) }, { t: 0, view: view(1) }], ...cut !== void 0 ? { cut: 0 } : {} };
+  const step = 1e3 / fps;
+  const cutMs = cut === void 0 ? void 0 : cut * ms;
+  const keys = [];
+  const frames = Math.ceil(ms / step - 1e-9);
+  for (let i = 0; i <= frames; i++) {
+    const t = Math.min(ms, i * step);
+    if (cutMs !== void 0 && (keys.length ? keys[keys.length - 1].t : -1) < cutMs && t >= cutMs) {
+      keys.push({ t: cutMs, view: view(Math.max(0, cut - BEFORE_CUT)) }, { t: cutMs, view: view(cut) });
+      if (t === cutMs) continue;
+    }
+    keys.push({ t, view: view(t / ms) });
+  }
+  return { keys, ...cutMs !== void 0 ? { cut: cutMs } : {} };
+}
+async function sampleEffectCameraMove(provider, id, request) {
+  if (!provider.capabilities.supportsCamera || !provider.cameraView) throw new EffectUnsupportedError(`${provider.name} has no camera moves (capabilities.supportsCamera is not set).`, id);
+  if (provider.sampleCameraMove) return provider.sampleCameraMove(id, request);
+  const d = await provider.describe(id);
+  if (d.kind !== "camera" || !d.camera) throw new EffectUnsupportedError(`"${id}" is a ${d.kind} effect, not a camera move.`, id);
+  const { from, to, ms, stage, values } = request;
+  return sampleCameraViews((u) => provider.cameraView(id, { from, to, u, ms, stage }, values), { ms, fps: request.fps, cut: d.camera.cut });
+}
 
 // src/effects/types.ts
-var EFFECT_KINDS = ["shader", "vector", "motion"];
-var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive"];
+var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
+var CAMERA_MOVE_ROLES = ["transition", "hold"];
 
 // src/effects/tools.ts
 var ANNOTATIONS = {
@@ -203,7 +246,8 @@ var summaryOut = (e) => ({
   ...e.tags?.length ? { tags: e.tags } : {},
   transparent: e.transparent,
   loop: e.loop,
-  ...e.duration !== void 0 ? { duration: e.duration } : {}
+  ...e.duration !== void 0 ? { duration: e.duration } : {},
+  ...e.camera ? { camera: e.camera } : {}
 });
 function createEffectToolProvider(host) {
   let catalog = null;
@@ -247,7 +291,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 = catalogFor(host.provider())?.filter((e) => (e.kind !== "motion" || uses.includes("motion")) && e.uses.some((u) => uses.includes(u)));
+    const effects = catalogFor(host.provider())?.filter((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 };
   };
@@ -261,12 +305,12 @@ 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), 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) }], 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). 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.`,
       inputSchema: object({
         query: { type: "string", description: "Words to match (default: every effect)." },
-        kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG) or motion (animates vector art)." },
+        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." },
+        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)." }
       }),
@@ -290,14 +334,14 @@ function createEffectToolProvider(host) {
     {
       name: "describe_effect",
       title: "Describe an effect",
-      description: "Returns one effect's controls as a strict JSON Schema (each control described, with its type, range and units), its defaults, presets (named sets of values) and inputs, plus its summary. Use the control names and ranges for apply_effect and update_effect values. With no provider registered it returns available: false and the reason.",
+      description: "Returns one effect's controls as a strict JSON Schema (each control described, with its type, range and units), its defaults, presets (named sets of values) and inputs, plus its summary (for a camera move, camera: { role transition or hold, durationMs, cut 0\u20131 where the view jumps }). Use the control names and ranges for apply_effect and update_effect values. With no provider registered it returns available: false and the reason.",
       inputSchema: object({ effect: { type: "string", minLength: 1, description: "An effect id from search_effects or list_applied_effects." } }, ["effect"]),
       annotations: { title: "Describe an effect", ...ANNOTATIONS.read },
       handler: async (args) => {
         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: (d.kind !== "motion" || host.applyUses.includes("motion")) && d.uses.some((u) => host.applyUses.includes(u)) };
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses) };
       }
     },
     {
@@ -403,6 +447,7 @@ export {
   isEffectError,
   effectValueErrors,
   resolveEffectValues,
+  effectOffered,
   normaliseEffectTag,
   hasEffectTags,
   countEffectTags,
@@ -414,7 +459,11 @@ export {
   encodeEffectFloat,
   applyEffectMask,
   EffectsSlot,
+  isCameraView,
+  sampleCameraViews,
+  sampleEffectCameraMove,
   EFFECT_KINDS,
   EFFECT_USES,
+  CAMERA_MOVE_ROLES,
   createEffectToolProvider
 };

package/dist/{chunk-Z64NRDEH.cjs → chunk-MDNYYOBZ.cjs}

@@ -7,7 +7,7 @@ var _chunkPY4GWSE2cjs = require('./chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkA3A5TI6Rcjs = require('./chunk-A3A5TI6R.cjs');
+var _chunkNTWR5TQBcjs = require('./chunk-NTWR5TQB.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
@@ -1307,12 +1307,12 @@ function videoEffectLayerKey(layer, width, height) {
 }
 function mixEffectPixels(a, b, k) {
   if (k >= 1) return b;
-  const out = _chunkA3A5TI6Rcjs.createEffectPixels.call(void 0, a.width, a.height);
+  const out = _chunkNTWR5TQBcjs.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 = _chunkA3A5TI6Rcjs.createEffectPixels.call(void 0, base.width, base.height);
+  const out = _chunkNTWR5TQBcjs.createEffectPixels.call(void 0, base.width, base.height);
   const o = out.data;
   const b = base.data;
   const t = top.data;
@@ -1357,7 +1357,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, _chunkA3A5TI6Rcjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkNTWR5TQBcjs.EffectsSlot)()));
     this.maxEntries = _nullishCoalesce(options.maxEntries, () => ( 120));
     this.toImage = _nullishCoalesce(options.toImage, () => ( defaultToImage));
     this.pool = new (0, _chunkPY4GWSE2cjs.EffectRendererPool)({ maxRenderers: options.maxRenderers });
@@ -1499,7 +1499,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, _chunkA3A5TI6Rcjs.EffectUnsupportedError)(
+    throw new (0, _chunkNTWR5TQBcjs.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
     );
@@ -1520,12 +1520,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 _chunkA3A5TI6Rcjs.effectValueErrors.call(void 0, d, plain)) {
+  for (const e of _chunkNTWR5TQBcjs.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, _chunkA3A5TI6Rcjs.EffectControlError)(d.id, errors);
+  if (errors.length) throw new (0, _chunkNTWR5TQBcjs.EffectControlError)(d.id, errors);
   return { ..._nullishCoalesce(options.base, () => ( d.defaults)), ..._nullishCoalesce(values, () => ( {})) };
 }
 

package/dist/{chunk-A3A5TI6R.cjs → chunk-NTWR5TQB.cjs}

@@ -68,6 +68,12 @@ function resolveEffectValues(description, values) {
   if (errors.length) throw new EffectControlError(description.id, errors);
   return { ...description.defaults, ..._nullishCoalesce(values, () => ( {})) };
 }
+function effectOffered(e, uses) {
+  if (!uses) return e.kind !== "motion" && e.kind !== "camera";
+  if (e.kind === "motion" && !uses.includes("motion")) return false;
+  if (e.kind === "camera" && !uses.includes("camera")) return false;
+  return e.uses.some((u) => uses.includes(u));
+}
 function normaliseEffectTag(tag) {
   return tag.trim().toLowerCase().replace(/[\s_-]+/g, "-");
 }
@@ -167,10 +173,47 @@ var EffectsSlot = (_class = class {constructor() { _class.prototype.__init.call(
     return () => this.listeners.delete(listener);
   }
 }, _class);
+var BEFORE_CUT = 1e-6;
+function isCameraView(view) {
+  if (!view || typeof view !== "object") return false;
+  const v = view;
+  if (!(typeof v.zoom === "number" && v.zoom > 0 && Number.isFinite(v.zoom))) return false;
+  if (!Number.isFinite(v.scrollX) || !Number.isFinite(v.scrollY)) return false;
+  return ["tilt", "turn", "roll", "perspective", "blur", "blurAngle"].every((k) => v[k] === void 0 || Number.isFinite(v[k]));
+}
+function sampleCameraViews(view, options) {
+  const { ms, fps, cut } = options;
+  if (!(Number.isFinite(ms) && ms >= 0)) throw new EffectUnsupportedError(`ms must be a finite number of ms \u2265 0, got ${ms}.`);
+  if (!(Number.isFinite(fps) && fps > 0)) throw new EffectUnsupportedError(`fps must be a number > 0, got ${fps}.`);
+  if (cut !== void 0 && !(cut >= 0 && cut <= 1)) throw new EffectUnsupportedError(`cut must be 0\u20131, got ${cut}.`);
+  if (ms === 0) return { keys: [{ t: 0, view: view(0) }, { t: 0, view: view(1) }], ...cut !== void 0 ? { cut: 0 } : {} };
+  const step = 1e3 / fps;
+  const cutMs = cut === void 0 ? void 0 : cut * ms;
+  const keys = [];
+  const frames = Math.ceil(ms / step - 1e-9);
+  for (let i = 0; i <= frames; i++) {
+    const t = Math.min(ms, i * step);
+    if (cutMs !== void 0 && (keys.length ? keys[keys.length - 1].t : -1) < cutMs && t >= cutMs) {
+      keys.push({ t: cutMs, view: view(Math.max(0, cut - BEFORE_CUT)) }, { t: cutMs, view: view(cut) });
+      if (t === cutMs) continue;
+    }
+    keys.push({ t, view: view(t / ms) });
+  }
+  return { keys, ...cutMs !== void 0 ? { cut: cutMs } : {} };
+}
+async function sampleEffectCameraMove(provider, id, request) {
+  if (!provider.capabilities.supportsCamera || !provider.cameraView) throw new EffectUnsupportedError(`${provider.name} has no camera moves (capabilities.supportsCamera is not set).`, id);
+  if (provider.sampleCameraMove) return provider.sampleCameraMove(id, request);
+  const d = await provider.describe(id);
+  if (d.kind !== "camera" || !d.camera) throw new EffectUnsupportedError(`"${id}" is a ${d.kind} effect, not a camera move.`, id);
+  const { from, to, ms, stage, values } = request;
+  return sampleCameraViews((u) => provider.cameraView(id, { from, to, u, ms, stage }, values), { ms, fps: request.fps, cut: d.camera.cut });
+}
 
 // src/effects/types.ts
-var EFFECT_KINDS = ["shader", "vector", "motion"];
-var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive"];
+var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
+var CAMERA_MOVE_ROLES = ["transition", "hold"];
 
 // src/effects/tools.ts
 var ANNOTATIONS = {
@@ -203,7 +246,8 @@ var summaryOut = (e) => ({
   ..._optionalChain([e, 'access', _2 => _2.tags, 'optionalAccess', _3 => _3.length]) ? { tags: e.tags } : {},
   transparent: e.transparent,
   loop: e.loop,
-  ...e.duration !== void 0 ? { duration: e.duration } : {}
+  ...e.duration !== void 0 ? { duration: e.duration } : {},
+  ...e.camera ? { camera: e.camera } : {}
 });
 function createEffectToolProvider(host) {
   let catalog = null;
@@ -247,7 +291,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', _5 => _5(host.provider()), 'optionalAccess', _6 => _6.filter, 'call', _7 => _7((e) => (e.kind !== "motion" || uses.includes("motion")) && e.uses.some((u) => uses.includes(u)))]);
+    const effects = _optionalChain([catalogFor, 'call', _5 => _5(host.provider()), 'optionalAccess', _6 => _6.filter, 'call', _7 => _7((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 };
   };
@@ -261,12 +305,12 @@ 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), 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) }], 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). 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.`,
       inputSchema: object({
         query: { type: "string", description: "Words to match (default: every effect)." },
-        kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG) or motion (animates vector art)." },
+        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." },
+        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)." }
       }),
@@ -290,14 +334,14 @@ function createEffectToolProvider(host) {
     {
       name: "describe_effect",
       title: "Describe an effect",
-      description: "Returns one effect's controls as a strict JSON Schema (each control described, with its type, range and units), its defaults, presets (named sets of values) and inputs, plus its summary. Use the control names and ranges for apply_effect and update_effect values. With no provider registered it returns available: false and the reason.",
+      description: "Returns one effect's controls as a strict JSON Schema (each control described, with its type, range and units), its defaults, presets (named sets of values) and inputs, plus its summary (for a camera move, camera: { role transition or hold, durationMs, cut 0\u20131 where the view jumps }). Use the control names and ranges for apply_effect and update_effect values. With no provider registered it returns available: false and the reason.",
       inputSchema: object({ effect: { type: "string", minLength: 1, description: "An effect id from search_effects or list_applied_effects." } }, ["effect"]),
       annotations: { title: "Describe an effect", ...ANNOTATIONS.read },
       handler: async (args) => {
         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: (d.kind !== "motion" || host.applyUses.includes("motion")) && d.uses.some((u) => host.applyUses.includes(u)) };
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses) };
       }
     },
     {
@@ -417,4 +461,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.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.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.createEffectToolProvider = createEffectToolProvider;
+
+
+
+
+
+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.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.createEffectToolProvider = createEffectToolProvider;

package/dist/{chunk-OZSA5YEJ.js → chunk-RDTCG5MS.js}

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

package/dist/{chunk-WMVEYSOA.js → chunk-WA4IS2EY.js}

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