@pixerate/editor 0.229.0 → 0.230.0

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

@@ -209,6 +209,69 @@ async function sampleEffectCameraMove(provider, id, request) {
   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 });
 }
+var cameraMoveField = (role) => role === "transition" ? "in" : "during";
+function cameraMovesFor(catalog, role) {
+  return catalog.filter((e) => e.kind === "camera" && e.camera?.role === role);
+}
+function cameraMoveIdList(catalog, role) {
+  const ids = cameraMovesFor(catalog, role).map((e) => JSON.stringify(e.id));
+  return ids.length ? ids.join(", ") : "none (the provider has no camera moves of that role)";
+}
+function cameraMoveParts(spec) {
+  if (typeof spec === "string") return spec ? { move: spec } : void 0;
+  if (spec && typeof spec === "object" && !Array.isArray(spec) && typeof spec.move === "string") return spec;
+  return void 0;
+}
+var CAMERA_MOVE_MAX_MS = 6e4;
+async function resolveCameraMoveSpec(provider, spec, role) {
+  const field = cameraMoveField(role);
+  if (!provider.capabilities.supportsCamera || !provider.cameraView) throw new EffectUnsupportedError(`${provider.name} has no camera moves (capabilities.supportsCamera is not set), so camera "${field}" cannot be set.`);
+  const parts = cameraMoveParts(spec);
+  const catalog = await provider.list({ kind: "camera" });
+  if (!parts) throw new EffectUnsupportedError(`Camera "${field}" is a camera move's id, or { move, ms?, preset?, values? }; it takes one of ${cameraMoveIdList(catalog, role)}.`);
+  let description;
+  try {
+    description = await provider.describe(parts.move);
+  } catch (error) {
+    if (error instanceof UnknownEffectError || error.code === "unknown_effect")
+      throw new EffectError("unknown_effect", `There is no camera move "${parts.move}"; camera "${field}" takes one of ${cameraMoveIdList(catalog, role)}.`, parts.move);
+    throw error;
+  }
+  if (description.kind !== "camera" || !description.camera) throw new EffectUnsupportedError(`"${parts.move}" is a ${description.kind} effect, not a camera move; camera "${field}" takes one of ${cameraMoveIdList(catalog, role)}.`, parts.move);
+  if (description.camera.role !== role) {
+    const other = cameraMoveField(description.camera.role);
+    throw new EffectUnsupportedError(
+      `"${parts.move}" moves the camera ${description.camera.role === "hold" ? "while a shot holds" : "into a shot"}, so it goes in camera "${other}", not "${field}"; camera "${field}" takes one of ${cameraMoveIdList(catalog, role)}.`,
+      parts.move
+    );
+  }
+  if (parts.ms !== void 0) {
+    if (role === "hold") throw new EffectUnsupportedError(`A move while the shot holds plays across the shot's hold; set the hold's length instead of "ms".`, parts.move);
+    if (!(typeof parts.ms === "number" && Number.isFinite(parts.ms) && parts.ms >= 0 && parts.ms <= CAMERA_MOVE_MAX_MS))
+      throw new EffectUnsupportedError(`Camera "in" ms is how long the move takes, 0 to ${CAMERA_MOVE_MAX_MS} (default ${description.camera.durationMs} for "${parts.move}").`, parts.move);
+  }
+  let presetValues = {};
+  if (parts.preset !== void 0) {
+    const preset = description.presets.find((p) => p.name === parts.preset);
+    if (!preset) throw new EffectUnsupportedError(`"${parts.move}" has no preset ${JSON.stringify(parts.preset)}; its presets are ${description.presets.length ? description.presets.map((p) => JSON.stringify(p.name)).join(", ") : "none"}.`, parts.move);
+    presetValues = preset.values;
+  }
+  const values = { ...presetValues, ...parts.values ?? {} };
+  resolveEffectValues(description, values);
+  return {
+    spec: { move: description.id, ...parts.ms !== void 0 ? { ms: parts.ms } : {}, ...parts.preset !== void 0 ? { preset: parts.preset } : {}, ...Object.keys(values).length ? { values } : {} },
+    description
+  };
+}
+function cameraViewOfBox(box, stage) {
+  const zoom = Math.min(stage.width / box.width, stage.height / box.height);
+  return { zoom, scrollX: stage.width / (2 * zoom) - (box.x + box.width / 2), scrollY: stage.height / (2 * zoom) - (box.y + box.height / 2) };
+}
+function cameraBoxOfView(view, stage) {
+  const width = stage.width / view.zoom;
+  const height = stage.height / view.zoom;
+  return { x: -view.scrollX, y: -view.scrollY, width, height };
+}
 
 // src/effects/types.ts
 var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
@@ -478,6 +541,14 @@ export {
   isCameraView,
   sampleCameraViews,
   sampleEffectCameraMove,
+  cameraMoveField,
+  cameraMovesFor,
+  cameraMoveIdList,
+  cameraMoveParts,
+  CAMERA_MOVE_MAX_MS,
+  resolveCameraMoveSpec,
+  cameraViewOfBox,
+  cameraBoxOfView,
   EFFECT_KINDS,
   EFFECT_USES,
   CAMERA_MOVE_ROLES,

package/dist/{chunk-W4KFNAWC.js → chunk-TYCJGFCF.js}

@@ -33,7 +33,11 @@ var MOTION_ISSUE_CODES = {
   "scene-too-short": { severity: "warning", wording: "The scene ends before its target length." },
   "unknown-control-color": { severity: "warning", wording: "A control stands for a colour the scene never uses." },
   "empty-shot": { severity: "note", wording: "A shot neither moves the camera nor runs a command." },
-  "camera-aspect": { severity: "note", wording: "A camera rectangle has a different shape from the artwork, so it is letterboxed." }
+  "camera-aspect": { severity: "note", wording: "A camera rectangle has a different shape from the artwork, so it is letterboxed." },
+  "camera-move-first-shot": { severity: "note", wording: "The first shot cuts to its framing, so the move its camera gets in with does not play." },
+  "camera-move-not-played": { severity: "note", wording: "A shot names a camera move, but there is no effects provider with camera moves to play it, so the camera eases instead." },
+  "camera-move-unknown": { severity: "error", wording: "A shot names a camera move the effects provider does not have, or one of the wrong role." },
+  "camera-move-values": { severity: "error", wording: "A camera move's preset or values do not fit its controls." }
 };
 function motionIssue(code, message, extra = {}) {
   return { code, severity: MOTION_ISSUE_CODES[code].severity, message, ...extra };

package/dist/effects/helpers.d.cts

@@ -3,7 +3,7 @@
  * and a provider slot editors hold.
  */
 import { type SchemaValidationError } from '../tools/schema.cjs';
-import type { CameraMoveSample, CameraMoveSampleRequest, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues } from './types.cjs';
+import type { CameraMoveRole, CameraMoveSpec, CameraMoveSample, CameraMoveSampleRequest, CameraStage, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues } from './types.cjs';
 /** Problems with `values` against an effect's control schema (unknown controls, types, ranges). Partial values are fine. */
 export declare function effectValueErrors(description: Pick<EffectDescription, 'controls'>, values: unknown): SchemaValidationError[];
 /**
@@ -82,3 +82,37 @@ export declare function sampleCameraViews(view: (u: number) => CameraView, optio
  * `EffectUnsupportedError` when the provider has no camera support.
  */
 export declare function sampleEffectCameraMove(provider: EffectProvider, id: string, request: CameraMoveSampleRequest): Promise<CameraMoveSample>;
+/** The field a shot names a move of `role` in: `in` for a transition, `during` for a hold. */
+export declare const cameraMoveField: (role: CameraMoveRole) => "in" | "during";
+/** The camera moves of `role` in a catalog, in its order. */
+export declare function cameraMovesFor<T extends Pick<EffectSummary, 'kind' | 'camera'>>(catalog: readonly T[], role: CameraMoveRole): T[];
+/** The ids of a catalog's camera moves of `role` as a sentence's list: `"a", "b"` (or `none`). */
+export declare function cameraMoveIdList(catalog: readonly Pick<EffectSummary, 'id' | 'kind' | 'camera'>[], role: CameraMoveRole): string;
+/** A camera move spec as its parts (`"id"` → `{ move: "id" }`); undefined when it is neither form. */
+export declare function cameraMoveParts(spec: unknown): Exclude<CameraMoveSpec, string> | undefined;
+/** Longest `ms` a transition move takes (ms). */
+export declare const CAMERA_MOVE_MAX_MS = 60000;
+/**
+ * A camera move spec checked against a provider for a role, with its preset's values written out
+ * into `values`, so a document plays it without asking the provider for the preset again.
+ * Throws an error that says what to do: an unknown id or a move of the other role names the
+ * moves the role takes, an unknown preset names the presets, and bad values name the controls.
+ */
+export declare function resolveCameraMoveSpec(provider: EffectProvider, spec: CameraMoveSpec, role: CameraMoveRole): Promise<{
+    spec: Exclude<CameraMoveSpec, string>;
+    description: EffectDescription;
+}>;
+/** A box of the scene, in its units. */
+export interface CameraBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The view that shows `box` on `stage`: the box's centre in the middle, at the zoom that fits it
+ * whole (as SVG's `xMidYMid meet`).
+ */
+export declare function cameraViewOfBox(box: CameraBox, stage: CameraStage): CameraView;
+/** The box of the scene a view shows on `stage` (its tilt, turn, roll and blur aside). */
+export declare function cameraBoxOfView(view: CameraView, stage: CameraStage): CameraBox;

package/dist/effects/helpers.d.ts

@@ -3,7 +3,7 @@
  * and a provider slot editors hold.
  */
 import { type SchemaValidationError } from '../tools/schema.js';
-import type { CameraMoveSample, CameraMoveSampleRequest, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues } from './types.js';
+import type { CameraMoveRole, CameraMoveSpec, CameraMoveSample, CameraMoveSampleRequest, CameraStage, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues } from './types.js';
 /** Problems with `values` against an effect's control schema (unknown controls, types, ranges). Partial values are fine. */
 export declare function effectValueErrors(description: Pick<EffectDescription, 'controls'>, values: unknown): SchemaValidationError[];
 /**
@@ -82,3 +82,37 @@ export declare function sampleCameraViews(view: (u: number) => CameraView, optio
  * `EffectUnsupportedError` when the provider has no camera support.
  */
 export declare function sampleEffectCameraMove(provider: EffectProvider, id: string, request: CameraMoveSampleRequest): Promise<CameraMoveSample>;
+/** The field a shot names a move of `role` in: `in` for a transition, `during` for a hold. */
+export declare const cameraMoveField: (role: CameraMoveRole) => "in" | "during";
+/** The camera moves of `role` in a catalog, in its order. */
+export declare function cameraMovesFor<T extends Pick<EffectSummary, 'kind' | 'camera'>>(catalog: readonly T[], role: CameraMoveRole): T[];
+/** The ids of a catalog's camera moves of `role` as a sentence's list: `"a", "b"` (or `none`). */
+export declare function cameraMoveIdList(catalog: readonly Pick<EffectSummary, 'id' | 'kind' | 'camera'>[], role: CameraMoveRole): string;
+/** A camera move spec as its parts (`"id"` → `{ move: "id" }`); undefined when it is neither form. */
+export declare function cameraMoveParts(spec: unknown): Exclude<CameraMoveSpec, string> | undefined;
+/** Longest `ms` a transition move takes (ms). */
+export declare const CAMERA_MOVE_MAX_MS = 60000;
+/**
+ * A camera move spec checked against a provider for a role, with its preset's values written out
+ * into `values`, so a document plays it without asking the provider for the preset again.
+ * Throws an error that says what to do: an unknown id or a move of the other role names the
+ * moves the role takes, an unknown preset names the presets, and bad values name the controls.
+ */
+export declare function resolveCameraMoveSpec(provider: EffectProvider, spec: CameraMoveSpec, role: CameraMoveRole): Promise<{
+    spec: Exclude<CameraMoveSpec, string>;
+    description: EffectDescription;
+}>;
+/** A box of the scene, in its units. */
+export interface CameraBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The view that shows `box` on `stage`: the box's centre in the middle, at the zoom that fits it
+ * whole (as SVG's `xMidYMid meet`).
+ */
+export declare function cameraViewOfBox(box: CameraBox, stage: CameraStage): CameraView;
+/** The box of the scene a view shows on `stage` (its tilt, turn, roll and blur aside). */
+export declare function cameraBoxOfView(view: CameraView, stage: CameraStage): CameraBox;

package/dist/effects/index.cjs

@@ -3,7 +3,7 @@
 var _chunk4XSBOGMKcjs = require('../chunk-4XSBOGMK.cjs');
 
 
-var _chunkK5GXW5TRcjs = require('../chunk-K5GXW5TR.cjs');
+var _chunkC73U5UI3cjs = require('../chunk-C73U5UI3.cjs');
 
 
 var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
@@ -37,7 +37,15 @@ var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
 
 
 
-var _chunk5MQOBTNPcjs = require('../chunk-5MQOBTNP.cjs');
+
+
+
+
+
+
+
+
+var _chunkOPSK22DLcjs = require('../chunk-OPSK22DL.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 require('../chunk-FJ2MSI43.cjs');
 
@@ -45,7 +53,7 @@ require('../chunk-FJ2MSI43.cjs');
 var _chunkDWJJI6RTcjs = require('../chunk-DWJJI6RT.cjs');
 
 // src/effects/conformance.ts
-var codeOf = (e) => _chunk5MQOBTNPcjs.isEffectError.call(void 0, e) ? e.code : e instanceof Error ? `untyped ${e.name}: ${e.message}` : String(e);
+var codeOf = (e) => _chunkOPSK22DLcjs.isEffectError.call(void 0, e) ? e.code : e instanceof Error ? `untyped ${e.name}: ${e.message}` : String(e);
 async function rejectsWith(code, run) {
   try {
     await run();
@@ -59,10 +67,10 @@ function checkSummary(e, issues) {
   const at = (message) => issues.push({ effectId: e.id, message });
   if (!e.id || typeof e.id !== "string") at("summary has no id");
   if (!e.name) at("summary has no name");
-  if (!_chunk5MQOBTNPcjs.EFFECT_KINDS.includes(e.kind)) at(`kind "${e.kind}" is not one of ${_chunk5MQOBTNPcjs.EFFECT_KINDS.join(", ")}`);
+  if (!_chunkOPSK22DLcjs.EFFECT_KINDS.includes(e.kind)) at(`kind "${e.kind}" is not one of ${_chunkOPSK22DLcjs.EFFECT_KINDS.join(", ")}`);
   if (!e.category) at("summary has no category");
   if (!Array.isArray(e.uses) || !e.uses.length) at("summary has no uses");
-  for (const u of _nullishCoalesce(e.uses, () => ( []))) if (!_chunk5MQOBTNPcjs.EFFECT_USES.includes(u)) at(`use "${u}" is not one of ${_chunk5MQOBTNPcjs.EFFECT_USES.join(", ")}`);
+  for (const u of _nullishCoalesce(e.uses, () => ( []))) if (!_chunkOPSK22DLcjs.EFFECT_USES.includes(u)) at(`use "${u}" is not one of ${_chunkOPSK22DLcjs.EFFECT_USES.join(", ")}`);
   if (typeof e.transparent !== "boolean") at("transparent is not a boolean");
   if (typeof e.loop !== "boolean") at("loop is not a boolean");
   if (e.duration !== void 0 && !(e.duration > 0)) at("duration must be a positive number of ms when present");
@@ -72,7 +80,7 @@ function checkSummary(e, issues) {
     const m = e.camera;
     if (!m) at("a camera effect needs camera: { role, durationMs }");
     else {
-      if (!_chunk5MQOBTNPcjs.CAMERA_MOVE_ROLES.includes(m.role)) at(`camera.role "${m.role}" is not one of ${_chunk5MQOBTNPcjs.CAMERA_MOVE_ROLES.join(", ")}`);
+      if (!_chunkOPSK22DLcjs.CAMERA_MOVE_ROLES.includes(m.role)) at(`camera.role "${m.role}" is not one of ${_chunkOPSK22DLcjs.CAMERA_MOVE_ROLES.join(", ")}`);
       if (!(Number.isFinite(m.durationMs) && m.durationMs >= 0)) at("camera.durationMs must be a number of ms \u2265 0");
       if (m.cut !== void 0 && !(m.cut >= 0 && m.cut <= 1)) at("camera.cut must be 0\u20131 when present");
       if (e.duration !== void 0 && e.duration !== m.durationMs) at(`duration ${e.duration} differs from camera.durationMs ${m.durationMs}`);
@@ -98,8 +106,8 @@ function checkDescription(id, d, issues) {
     if (!control) at(`backgroundOpacity "${d.backgroundOpacity}" is not a control`);
     else if (control.type !== "number" || control.minimum !== 0 || control.maximum !== 1) at(`backgroundOpacity "${d.backgroundOpacity}" must be a number control from 0 to 1`);
   }
-  for (const e of _chunk5MQOBTNPcjs.effectValueErrors.call(void 0, d, d.defaults)) at(`default ${e.path}: ${e.message}`);
-  for (const p of _nullishCoalesce(d.presets, () => ( []))) for (const e of _chunk5MQOBTNPcjs.effectValueErrors.call(void 0, d, p.values)) at(`preset "${p.name}" ${e.path}: ${e.message}`);
+  for (const e of _chunkOPSK22DLcjs.effectValueErrors.call(void 0, d, d.defaults)) at(`default ${e.path}: ${e.message}`);
+  for (const p of _nullishCoalesce(d.presets, () => ( []))) for (const e of _chunkOPSK22DLcjs.effectValueErrors.call(void 0, d, p.values)) at(`preset "${p.name}" ${e.path}: ${e.message}`);
   for (const input2 of _nullishCoalesce(d.inputs, () => ( []))) {
     if (!input2.name || !input2.description) at("every input needs a name and a description");
     if (input2.kind !== "image" && input2.kind !== "audio") at(`input "${input2.name}" has kind "${input2.kind}"`);
@@ -110,7 +118,7 @@ function checkDescription(id, d, issues) {
   }
 }
 function grey(size) {
-  const p = _chunk5MQOBTNPcjs.createEffectPixels.call(void 0, size, size);
+  const p = _chunkOPSK22DLcjs.createEffectPixels.call(void 0, size, size);
   p.data.fill(128);
   return p;
 }
@@ -127,7 +135,7 @@ async function checkRender(provider, d, size, issues) {
   }
   try {
     const out = await renderer.render({ time: 0, inputs });
-    if (!_chunk5MQOBTNPcjs.isEffectPixels.call(void 0, out)) at("render did not return EffectPixels");
+    if (!_chunkOPSK22DLcjs.isEffectPixels.call(void 0, out)) at("render did not return EffectPixels");
     else if (out.width !== size || out.height !== size || out.data.length !== size * size * 4) at(`render returned ${out.width}\xD7${out.height}, not ${size}\xD7${size}`);
   } catch (e) {
     at(`render failed: ${codeOf(e)}`);
@@ -157,10 +165,10 @@ async function checkCamera(provider, d, issues) {
         at("cameraView must be synchronous; it returned a Promise");
         return;
       }
-      if (!_chunk5MQOBTNPcjs.isCameraView.call(void 0, view)) at(`cameraView at u ${u} is not a CameraView (zoom > 0, finite scrollX and scrollY): ${JSON.stringify(view)}`);
+      if (!_chunkOPSK22DLcjs.isCameraView.call(void 0, view)) at(`cameraView at u ${u} is not a CameraView (zoom > 0, finite scrollX and scrollY): ${JSON.stringify(view)}`);
       else views.push(view);
       const again = provider.cameraView(d.id, ctx(u));
-      if (_chunk5MQOBTNPcjs.isCameraView.call(void 0, view) && !sameView(view, again)) at(`cameraView is not pure: two calls at u ${u} gave different views`);
+      if (_chunkOPSK22DLcjs.isCameraView.call(void 0, view) && !sameView(view, again)) at(`cameraView is not pure: two calls at u ${u} gave different views`);
     } catch (e) {
       at(`cameraView at u ${u} failed: ${codeOf(e)}`);
     }
@@ -173,7 +181,7 @@ async function checkCamera(provider, d, issues) {
       const keys = _optionalChain([sample, 'optionalAccess', _11 => _11.keys]);
       if (!Array.isArray(keys) || keys.length < 2) at("sampleCameraMove returned fewer than two keys");
       else {
-        if (keys.some((k, i) => !_chunk5MQOBTNPcjs.isCameraView.call(void 0, k.view) || !Number.isFinite(k.t) || i > 0 && k.t < keys[i - 1].t)) at("sampleCameraMove keys must be CameraViews in time order");
+        if (keys.some((k, i) => !_chunkOPSK22DLcjs.isCameraView.call(void 0, k.view) || !Number.isFinite(k.t) || i > 0 && k.t < keys[i - 1].t)) at("sampleCameraMove keys must be CameraViews in time order");
         if (keys[0].t !== 0 || keys[keys.length - 1].t !== ms) at(`sampleCameraMove keys must run from 0 to ${ms} ms, got ${keys[0].t} to ${keys[keys.length - 1].t}`);
         else if (!near(keys[0].view, views[0]) || !near(keys[keys.length - 1].view, views[4])) at("sampleCameraMove disagrees with cameraView at the start or end of the move");
         if (camera.cut !== void 0 && sample.cut === void 0) at("sampleCameraMove gave no cut for a move that cuts");
@@ -543,15 +551,15 @@ var smooth = (t) => t * t * (3 - 2 * t);
 var clamp01 = (v) => v < 0 ? 0 : v > 1 ? 1 : v;
 function input(request, name, id, width, height) {
   const src = _optionalChain([request, 'access', _24 => _24.inputs, 'optionalAccess', _25 => _25[name]]);
-  if (!src) throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`Effect "${id}" needs an input named "${name}".`, id);
-  if (!_chunk5MQOBTNPcjs.isEffectPixels.call(void 0, src)) throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`The fake provider only takes EffectPixels inputs ("${name}").`, id);
+  if (!src) throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`Effect "${id}" needs an input named "${name}".`, id);
+  if (!_chunkOPSK22DLcjs.isEffectPixels.call(void 0, src)) throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`The fake provider only takes EffectPixels inputs ("${name}").`, id);
   if (src.width !== width || src.height !== height) {
-    throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`Input "${name}" is ${src.width}\xD7${src.height}; the renderer is ${width}\xD7${height}.`, id);
+    throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`Input "${name}" is ${src.width}\xD7${src.height}; the renderer is ${width}\xD7${height}.`, id);
   }
   return src;
 }
 function renderPixels(d, v, request, width, height) {
-  const out = _chunk5MQOBTNPcjs.createEffectPixels.call(void 0, width, height);
+  const out = _chunkOPSK22DLcjs.createEffectPixels.call(void 0, width, height);
   const o = out.data;
   switch (d.id) {
     case "fake.invert": {
@@ -617,7 +625,7 @@ function renderPixels(d, v, request, width, height) {
       break;
     }
     default:
-      throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect; use applyVectorEffect.`, d.id);
+      throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect; use applyVectorEffect.`, d.id);
   }
   return out;
 }
@@ -647,22 +655,22 @@ function cameraViewOf(d, ctx, v) {
     case "fake.drift":
       return viewAt(x0, y0, from.zoom * lerp(1, v.scale, smooth(u)), ctx);
     default:
-      throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect, not a camera move.`, d.id);
+      throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect, not a camera move.`, d.id);
   }
 }
 function toFloat(p) {
   const f = new Float32Array(p.data.length);
   for (let i = 0; i < f.length; i += 4) {
-    f[i] = _chunk5MQOBTNPcjs.srgbToLinear.call(void 0, p.data[i] / 255);
-    f[i + 1] = _chunk5MQOBTNPcjs.srgbToLinear.call(void 0, p.data[i + 1] / 255);
-    f[i + 2] = _chunk5MQOBTNPcjs.srgbToLinear.call(void 0, p.data[i + 2] / 255);
+    f[i] = _chunkOPSK22DLcjs.srgbToLinear.call(void 0, p.data[i] / 255);
+    f[i + 1] = _chunkOPSK22DLcjs.srgbToLinear.call(void 0, p.data[i + 1] / 255);
+    f[i + 2] = _chunkOPSK22DLcjs.srgbToLinear.call(void 0, p.data[i + 2] / 255);
     f[i + 3] = p.data[i + 3] / 255;
   }
-  return _chunk5MQOBTNPcjs.encodeEffectFloat.call(void 0, { ...p, float: f });
+  return _chunkOPSK22DLcjs.encodeEffectFloat.call(void 0, { ...p, float: f });
 }
 function maskResult(out, mask, source, id) {
-  if (!_chunk5MQOBTNPcjs.isEffectPixels.call(void 0, mask) || mask.width !== out.width || mask.height !== out.height) {
-    throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)("The mask must be EffectPixels the size of the renderer.", id);
+  if (!_chunkOPSK22DLcjs.isEffectPixels.call(void 0, mask) || mask.width !== out.width || mask.height !== out.height) {
+    throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)("The mask must be EffectPixels the size of the renderer.", id);
   }
   const o = out.data;
   for (let i = 0; i < o.length; i += 4) {
@@ -688,32 +696,32 @@ function createFakeEffectProvider(options = {}) {
   const byId = new Map(all.map((d) => [d.id, d]));
   const get = (id) => {
     const d = byId.get(id);
-    if (!d) throw new (0, _chunk5MQOBTNPcjs.UnknownEffectError)(id, "the fake provider");
+    if (!d) throw new (0, _chunkOPSK22DLcjs.UnknownEffectError)(id, "the fake provider");
     return d;
   };
   const summaries = all.map(summaryOf);
   const camera = (id, ctx, values) => {
     const d = get(id);
-    if (d.kind !== "camera") throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a camera move.`, id);
-    if (!(ctx.u >= 0 && ctx.u <= 1)) throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`u must be 0\u20131 through the move, got ${ctx.u}.`, id);
-    return cameraViewOf(d, ctx, _chunk5MQOBTNPcjs.resolveEffectValues.call(void 0, d, values));
+    if (d.kind !== "camera") throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a camera move.`, id);
+    if (!(ctx.u >= 0 && ctx.u <= 1)) throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`u must be 0\u20131 through the move, got ${ctx.u}.`, id);
+    return cameraViewOf(d, ctx, _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, values));
   };
   const provider = {
     id: "fake",
     name: "Fake effects",
     version: "1",
     capabilities,
-    list: (o) => _chunk5MQOBTNPcjs.searchEffectSummaries.call(void 0, summaries, "", o),
-    search: (q, o) => _chunk5MQOBTNPcjs.searchEffectSummaries.call(void 0, summaries, q, o),
+    list: (o) => _chunkOPSK22DLcjs.searchEffectSummaries.call(void 0, summaries, "", o),
+    search: (q, o) => _chunkOPSK22DLcjs.searchEffectSummaries.call(void 0, summaries, q, o),
     describe: (id) => structuredClone(get(id)),
     createRenderer(id, ro) {
       const d = get(id);
-      if (d.kind === "camera") throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`"${id}" is a camera move: it moves a scene's camera and draws no pixels. Use cameraView.`, id);
-      if (d.kind !== "shader") throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect; use applyVectorEffect.`, id);
+      if (d.kind === "camera") throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${id}" is a camera move: it moves a scene's camera and draws no pixels. Use cameraView.`, id);
+      if (d.kind !== "shader") throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect; use applyVectorEffect.`, id);
       const { width, height } = ro;
       const depth = _nullishCoalesce(ro.depth, () => ( 8));
       if (!(width > 0 && height > 0) || width > capabilities.maxSize || height > capabilities.maxSize) {
-        throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`Renderer size ${width}\xD7${height} is outside 1\u2013${capabilities.maxSize}.`, id);
+        throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`Renderer size ${width}\xD7${height} is outside 1\u2013${capabilities.maxSize}.`, id);
       }
       let disposed = false;
       return {
@@ -722,15 +730,15 @@ function createFakeEffectProvider(options = {}) {
         height,
         depth,
         async render(request) {
-          if (disposed) throw new (0, _chunk5MQOBTNPcjs.EffectDisposedError)(id);
+          if (disposed) throw new (0, _chunkOPSK22DLcjs.EffectDisposedError)(id);
           if (!Number.isFinite(request.time) || request.time < 0) {
-            throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`time must be a finite number of ms \u2265 0, got ${request.time}.`, id);
+            throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`time must be a finite number of ms \u2265 0, got ${request.time}.`, id);
           }
-          const values = _chunk5MQOBTNPcjs.resolveEffectValues.call(void 0, d, request.values);
+          const values = _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, request.values);
           _optionalChain([options, 'access', _26 => _26.onRender, 'optionalCall', _27 => _27(id, request)]);
           const out = renderPixels(d, values, request, width, height);
           if (request.mask) {
-            if (!capabilities.supportsMask) throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)("This provider does not take masks.", id);
+            if (!capabilities.supportsMask) throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)("This provider does not take masks.", id);
             const source = d.uses.includes("filter") ? _optionalChain([request, 'access', _28 => _28.inputs, 'optionalAccess', _29 => _29.source]) : void 0;
             maskResult(out, request.mask, source, id);
           }
@@ -743,8 +751,8 @@ function createFakeEffectProvider(options = {}) {
     },
     applyVectorEffect(id, target, values) {
       const d = get(id);
-      if (d.kind !== "motion" && d.kind !== "vector") throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a vector one.`, id);
-      const v = _chunk5MQOBTNPcjs.resolveEffectValues.call(void 0, d, values);
+      if (d.kind !== "motion" && d.kind !== "vector") throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a vector one.`, id);
+      const v = _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, values);
       if (d.kind === "vector") {
         return { svg: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100"><circle id="badge" cx="50" cy="50" r="40" fill="${v.color}"/></svg>`, animate: [{ id: "badge", ms: v.ms, attrs: { opacity: [0, 1] } }], duration: v.ms, loop: false };
       }
@@ -764,11 +772,11 @@ function createFakeEffectProvider(options = {}) {
       sampleCameraMove: (id, request) => {
         const d = get(id);
         const { from, to, ms, stage, fps, values } = request;
-        return _chunk5MQOBTNPcjs.sampleCameraViews.call(void 0, (u) => camera(id, { from, to, u, ms, stage }, values), { ms, fps, cut: _optionalChain([d, 'access', _30 => _30.camera, 'optionalAccess', _31 => _31.cut]) });
+        return _chunkOPSK22DLcjs.sampleCameraViews.call(void 0, (u) => camera(id, { from, to, u, ms, stage }, values), { ms, fps, cut: _optionalChain([d, 'access', _30 => _30.camera, 'optionalAccess', _31 => _31.cut]) });
       }
     } : {},
     ...supportsAuthoring ? {
-      openAuthoring: (from) => _chunkK5GXW5TRcjs.createEffectAuthoringSession.call(void 0, from, { provider })
+      openAuthoring: (from) => _chunkC73U5UI3cjs.createEffectAuthoringSession.call(void 0, from, { provider })
     } : {}
   };
   return provider;
@@ -849,7 +857,7 @@ var effectFieldValue = (field, value) => {
   return value === void 0 || value === null || typeof value === "object" && !Array.isArray(value) ? field.default : value;
 };
 function effectSamplePicture(width, height, variant = 0) {
-  const p = _chunk5MQOBTNPcjs.createEffectPixels.call(void 0, width, height);
+  const p = _chunkOPSK22DLcjs.createEffectPixels.call(void 0, width, height);
   for (let y = 0, i = 0; y < height; y++) {
     for (let x = 0; x < width; x++, i += 4) {
       const u = x / Math.max(1, width - 1);
@@ -1336,4 +1344,12 @@ function createEffectAuthoringToolProvider(host, options) {
 
 
 
-exports.CAMERA_MOVE_ROLES = _chunk5MQOBTNPcjs.CAMERA_MOVE_ROLES; exports.EFFECT_ERROR_CODES = _chunk5MQOBTNPcjs.EFFECT_ERROR_CODES; exports.EFFECT_KINDS = _chunk5MQOBTNPcjs.EFFECT_KINDS; exports.EFFECT_USES = _chunk5MQOBTNPcjs.EFFECT_USES; exports.EFFECT_USE_LABELS = EFFECT_USE_LABELS; exports.EffectControlError = _chunk5MQOBTNPcjs.EffectControlError; exports.EffectDisposedError = _chunk5MQOBTNPcjs.EffectDisposedError; exports.EffectError = _chunk5MQOBTNPcjs.EffectError; exports.EffectRendererPool = _chunkPY4GWSE2cjs.EffectRendererPool; exports.EffectUnsupportedError = _chunk5MQOBTNPcjs.EffectUnsupportedError; exports.EffectsSlot = _chunk5MQOBTNPcjs.EffectsSlot; exports.NoEffectsProviderError = _chunk5MQOBTNPcjs.NoEffectsProviderError; exports.UnknownEffectError = _chunk5MQOBTNPcjs.UnknownEffectError; exports.applyEffectMask = _chunk5MQOBTNPcjs.applyEffectMask; exports.checkEffectProvider = checkEffectProvider; exports.countEffectTags = _chunk5MQOBTNPcjs.countEffectTags; exports.createEffectAuthoringSession = _chunkK5GXW5TRcjs.createEffectAuthoringSession; exports.createEffectAuthoringToolProvider = createEffectAuthoringToolProvider; exports.createEffectPixels = _chunk5MQOBTNPcjs.createEffectPixels; exports.createEffectToolProvider = _chunk5MQOBTNPcjs.createEffectToolProvider; exports.createFakeEffectProvider = createFakeEffectProvider; exports.effectControlField = effectControlField; exports.effectFieldValue = effectFieldValue; exports.effectFontFamilies = effectFontFamilies; exports.effectOffered = _chunk5MQOBTNPcjs.effectOffered; exports.effectParameterFields = effectParameterFields; exports.effectSampleInputs = effectSampleInputs; exports.effectSamplePicture = effectSamplePicture; exports.effectValueErrors = _chunk5MQOBTNPcjs.effectValueErrors; exports.encodeEffectFloat = _chunk5MQOBTNPcjs.encodeEffectFloat; exports.groupEffectsByCategory = groupEffectsByCategory; exports.hasEffectTags = _chunk5MQOBTNPcjs.hasEffectTags; exports.isCameraView = _chunk5MQOBTNPcjs.isCameraView; exports.isEffectError = _chunk5MQOBTNPcjs.isEffectError; exports.isEffectFontControl = isEffectFontControl; exports.isEffectPixels = _chunk5MQOBTNPcjs.isEffectPixels; exports.linearToSrgb = _chunk5MQOBTNPcjs.linearToSrgb; exports.normaliseEffectTag = _chunk5MQOBTNPcjs.normaliseEffectTag; exports.renderEffectThumbnail = renderEffectThumbnail; exports.resolveEffectValues = _chunk5MQOBTNPcjs.resolveEffectValues; exports.sampleCameraViews = _chunk5MQOBTNPcjs.sampleCameraViews; exports.sampleEffectCameraMove = _chunk5MQOBTNPcjs.sampleEffectCameraMove; exports.searchEffectSummaries = _chunk5MQOBTNPcjs.searchEffectSummaries; exports.srgbToLinear = _chunk5MQOBTNPcjs.srgbToLinear;
+
+
+
+
+
+
+
+
+exports.CAMERA_MOVE_MAX_MS = _chunkOPSK22DLcjs.CAMERA_MOVE_MAX_MS; exports.CAMERA_MOVE_ROLES = _chunkOPSK22DLcjs.CAMERA_MOVE_ROLES; exports.EFFECT_ERROR_CODES = _chunkOPSK22DLcjs.EFFECT_ERROR_CODES; exports.EFFECT_KINDS = _chunkOPSK22DLcjs.EFFECT_KINDS; exports.EFFECT_USES = _chunkOPSK22DLcjs.EFFECT_USES; exports.EFFECT_USE_LABELS = EFFECT_USE_LABELS; exports.EffectControlError = _chunkOPSK22DLcjs.EffectControlError; exports.EffectDisposedError = _chunkOPSK22DLcjs.EffectDisposedError; exports.EffectError = _chunkOPSK22DLcjs.EffectError; exports.EffectRendererPool = _chunkPY4GWSE2cjs.EffectRendererPool; exports.EffectUnsupportedError = _chunkOPSK22DLcjs.EffectUnsupportedError; exports.EffectsSlot = _chunkOPSK22DLcjs.EffectsSlot; exports.NoEffectsProviderError = _chunkOPSK22DLcjs.NoEffectsProviderError; exports.UnknownEffectError = _chunkOPSK22DLcjs.UnknownEffectError; exports.applyEffectMask = _chunkOPSK22DLcjs.applyEffectMask; exports.cameraBoxOfView = _chunkOPSK22DLcjs.cameraBoxOfView; exports.cameraMoveField = _chunkOPSK22DLcjs.cameraMoveField; exports.cameraMoveIdList = _chunkOPSK22DLcjs.cameraMoveIdList; exports.cameraMoveParts = _chunkOPSK22DLcjs.cameraMoveParts; exports.cameraMovesFor = _chunkOPSK22DLcjs.cameraMovesFor; exports.cameraViewOfBox = _chunkOPSK22DLcjs.cameraViewOfBox; exports.checkEffectProvider = checkEffectProvider; exports.countEffectTags = _chunkOPSK22DLcjs.countEffectTags; exports.createEffectAuthoringSession = _chunkC73U5UI3cjs.createEffectAuthoringSession; exports.createEffectAuthoringToolProvider = createEffectAuthoringToolProvider; exports.createEffectPixels = _chunkOPSK22DLcjs.createEffectPixels; exports.createEffectToolProvider = _chunkOPSK22DLcjs.createEffectToolProvider; exports.createFakeEffectProvider = createFakeEffectProvider; exports.effectControlField = effectControlField; exports.effectFieldValue = effectFieldValue; exports.effectFontFamilies = effectFontFamilies; exports.effectOffered = _chunkOPSK22DLcjs.effectOffered; exports.effectParameterFields = effectParameterFields; exports.effectSampleInputs = effectSampleInputs; exports.effectSamplePicture = effectSamplePicture; exports.effectValueErrors = _chunkOPSK22DLcjs.effectValueErrors; exports.encodeEffectFloat = _chunkOPSK22DLcjs.encodeEffectFloat; exports.groupEffectsByCategory = groupEffectsByCategory; exports.hasEffectTags = _chunkOPSK22DLcjs.hasEffectTags; exports.isCameraView = _chunkOPSK22DLcjs.isCameraView; exports.isEffectError = _chunkOPSK22DLcjs.isEffectError; exports.isEffectFontControl = isEffectFontControl; exports.isEffectPixels = _chunkOPSK22DLcjs.isEffectPixels; exports.linearToSrgb = _chunkOPSK22DLcjs.linearToSrgb; exports.normaliseEffectTag = _chunkOPSK22DLcjs.normaliseEffectTag; exports.renderEffectThumbnail = renderEffectThumbnail; exports.resolveCameraMoveSpec = _chunkOPSK22DLcjs.resolveCameraMoveSpec; exports.resolveEffectValues = _chunkOPSK22DLcjs.resolveEffectValues; exports.sampleCameraViews = _chunkOPSK22DLcjs.sampleCameraViews; exports.sampleEffectCameraMove = _chunkOPSK22DLcjs.sampleEffectCameraMove; exports.searchEffectSummaries = _chunkOPSK22DLcjs.searchEffectSummaries; exports.srgbToLinear = _chunkOPSK22DLcjs.srgbToLinear;

package/dist/effects/index.js

@@ -3,11 +3,12 @@ import {
 } from "../chunk-N4ZXW3WB.js";
 import {
   createEffectAuthoringSession
-} from "../chunk-PB6JV62G.js";
+} from "../chunk-SBPGIZQN.js";
 import {
   EffectRendererPool
 } from "../chunk-EHLOCVWB.js";
 import {
+  CAMERA_MOVE_MAX_MS,
   CAMERA_MOVE_ROLES,
   EFFECT_ERROR_CODES,
   EFFECT_KINDS,
@@ -20,6 +21,12 @@ import {
   NoEffectsProviderError,
   UnknownEffectError,
   applyEffectMask,
+  cameraBoxOfView,
+  cameraMoveField,
+  cameraMoveIdList,
+  cameraMoveParts,
+  cameraMovesFor,
+  cameraViewOfBox,
   countEffectTags,
   createEffectPixels,
   createEffectToolProvider,
@@ -32,12 +39,13 @@ import {
   isEffectPixels,
   linearToSrgb,
   normaliseEffectTag,
+  resolveCameraMoveSpec,
   resolveEffectValues,
   sampleCameraViews,
   sampleEffectCameraMove,
   searchEffectSummaries,
   srgbToLinear
-} from "../chunk-UGYUGZE2.js";
+} from "../chunk-TCZ2J7PR.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-RNSANXPT.js";
 import {
@@ -1292,6 +1300,7 @@ function createEffectAuthoringToolProvider(host, options) {
   };
 }
 export {
+  CAMERA_MOVE_MAX_MS,
   CAMERA_MOVE_ROLES,
   EFFECT_ERROR_CODES,
   EFFECT_KINDS,
@@ -1306,6 +1315,12 @@ export {
   NoEffectsProviderError,
   UnknownEffectError,
   applyEffectMask,
+  cameraBoxOfView,
+  cameraMoveField,
+  cameraMoveIdList,
+  cameraMoveParts,
+  cameraMovesFor,
+  cameraViewOfBox,
   checkEffectProvider,
   countEffectTags,
   createEffectAuthoringSession,
@@ -1331,6 +1346,7 @@ export {
   linearToSrgb,
   normaliseEffectTag,
   renderEffectThumbnail,
+  resolveCameraMoveSpec,
   resolveEffectValues,
   sampleCameraViews,
   sampleEffectCameraMove,

package/dist/effects/types.d.cts

@@ -214,6 +214,21 @@ export interface CameraView {
     /** Direction the blur streaks, degrees on screen (0 horizontal, 90 vertical); absent when it blurs every way (a zoom or a turn). */
     blurAngle?: number;
 }
+/**
+ * A camera move as a document names it (the shape of Flair's `CameraMoveSpec`): the move's id, or
+ * the id with a preset, values and a length. Editors save it on a shot (`in` for a `transition`
+ * move, `during` for a `hold`).
+ */
+export type CameraMoveSpec = string | {
+    /** The camera effect's id. */
+    move: string;
+    /** Length of a `transition` move (ms); default its `durationMs`. A `hold` plays across the shot's hold and takes none. */
+    ms?: number;
+    /** The preset its values came from, by name. */
+    preset?: string;
+    /** Control values over the move's defaults (a preset's values are written out here too). */
+    values?: Record<string, EffectValue>;
+};
 /** The stage a camera looks at, in pixels. */
 export interface CameraStage {
     width: number;

package/dist/effects/types.d.ts

@@ -214,6 +214,21 @@ export interface CameraView {
     /** Direction the blur streaks, degrees on screen (0 horizontal, 90 vertical); absent when it blurs every way (a zoom or a turn). */
     blurAngle?: number;
 }
+/**
+ * A camera move as a document names it (the shape of Flair's `CameraMoveSpec`): the move's id, or
+ * the id with a preset, values and a length. Editors save it on a shot (`in` for a `transition`
+ * move, `during` for a `hold`).
+ */
+export type CameraMoveSpec = string | {
+    /** The camera effect's id. */
+    move: string;
+    /** Length of a `transition` move (ms); default its `durationMs`. A `hold` plays across the shot's hold and takes none. */
+    ms?: number;
+    /** The preset its values came from, by name. */
+    preset?: string;
+    /** Control values over the move's defaults (a preset's values are written out here too). */
+    values?: Record<string, EffectValue>;
+};
 /** The stage a camera looks at, in pixels. */
 export interface CameraStage {
     width: number;