@pixerate/editor 0.229.0 → 0.231.0

package/dist/{chunk-5MQOBTNP.cjs → chunk-OPSK22DL.cjs}

@@ -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" && _optionalChain([e, 'access', _2 => _2.camera, 'optionalAccess', _3 => _3.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, ..._nullishCoalesce(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"];
@@ -243,7 +306,7 @@ var summaryOut = (e) => ({
   category: e.category,
   uses: e.uses,
   ...e.description ? { description: e.description } : {},
-  ..._optionalChain([e, 'access', _2 => _2.tags, 'optionalAccess', _3 => _3.length]) ? { tags: e.tags } : {},
+  ..._optionalChain([e, 'access', _4 => _4.tags, 'optionalAccess', _5 => _5.length]) ? { tags: e.tags } : {},
   transparent: e.transparent,
   loop: e.loop,
   ...e.duration !== void 0 ? { duration: e.duration } : {},
@@ -255,7 +318,7 @@ function createEffectToolProvider(host) {
   const notify = () => listeners.forEach((l) => l());
   const catalogFor = (provider) => {
     if (!provider) return null;
-    if (_optionalChain([catalog, 'optionalAccess', _4 => _4.provider]) !== provider) {
+    if (_optionalChain([catalog, 'optionalAccess', _6 => _6.provider]) !== provider) {
       const entry = { provider, effects: null };
       catalog = entry;
       Promise.resolve().then(() => provider.list()).then((effects) => {
@@ -291,7 +354,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) => effectOffered(e, uses))]);
+    const effects = _optionalChain([catalogFor, 'call', _7 => _7(host.provider()), 'optionalAccess', _8 => _8.filter, 'call', _9 => _9((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 };
   };
@@ -322,7 +385,7 @@ function createEffectToolProvider(host) {
         const found = (await explain(async () => p.search(_nullishCoalesce(args.query, () => ( "")), { kind: args.kind, category: args.category, use: args.use, tags }))).filter((e) => hasEffectTags(e, tags));
         const limit = _nullishCoalesce(args.limit, () => ( 20));
         const out = { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length, tags: countEffectTags(found).slice(0, TAG_LIMIT) };
-        if (_optionalChain([tags, 'optionalAccess', _8 => _8.length]) && !found.length) {
+        if (_optionalChain([tags, 'optionalAccess', _10 => _10.length]) && !found.length) {
           const known = countEffectTags(await explain(async () => p.list()));
           const have = new Set(known.map((k) => k.tag));
           const unknown = tags.filter((t) => !have.has(normaliseEffectTag(t)));
@@ -437,16 +500,16 @@ function createEffectToolProvider(host) {
     ...host.description ? { description: host.description } : {},
     ...host.skill ? { skill: host.skill } : {},
     tools: () => {
-      const extra = _nullishCoalesce(_optionalChain([host, 'access', _9 => _9.extraTools, 'optionalCall', _10 => _10(context)]), () => ( []));
-      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _11 => _11.annotations, 'optionalAccess', _12 => _12.readOnlyHint]))];
+      const extra = _nullishCoalesce(_optionalChain([host, 'access', _11 => _11.extraTools, 'optionalCall', _12 => _12(context)]), () => ( []));
+      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _13 => _13.annotations, 'optionalAccess', _14 => _14.readOnlyHint]))];
       return [...readTools(), ...writeTools(), ...extra];
     },
     subscribe: (l) => {
       listeners.add(l);
-      const off = _optionalChain([host, 'access', _13 => _13.subscribe, 'optionalCall', _14 => _14(l)]);
+      const off = _optionalChain([host, 'access', _15 => _15.subscribe, 'optionalCall', _16 => _16(l)]);
       return () => {
         listeners.delete(l);
-        _optionalChain([off, 'optionalCall', _15 => _15()]);
+        _optionalChain([off, 'optionalCall', _17 => _17()]);
       };
     }
   };
@@ -482,4 +545,12 @@ 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.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.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;

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

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

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;