@pixerate/editor 0.231.1 → 0.233.0

package/dist/animation-editor/types.d.ts

@@ -1,4 +1,4 @@
-import type { CameraMoveSpec, EffectValue } from '../effects/types.js';
+import type { CameraMoveSpec, EffectLayer, EffectShotTransition, EffectValue } from '../effects/types.js';
 import type { AnimationEasing } from '../animation/easing.js';
 import type { AnimationLoopMode } from '../animation/evaluate.js';
 import type { VectorDocument } from '../vector/types.js';
@@ -153,6 +153,49 @@ export interface MotionShot {
      * durations, staggers and hold all scale by 1 / speed. `fit_animation` sets it to fit a length.
      */
     speed?: number;
+    /**
+     * Provider effects and pictures shown with the shot, bottom to top (see `MotionShotLayer`):
+     * `background` layers under the artwork, `subject` and `overlay` layers over it.
+     */
+    layers?: MotionShotLayer[];
+    /**
+     * How the shot before gives way to this one: a provider transition effect blends the last
+     * frame of the shot before into this shot over `ms`. With no camera `in`, the camera cuts.
+     */
+    transition?: MotionShotTransition;
+}
+/** What a shot layer shows or feeds its effect: a picture or SVG (URL, `data:` URL or markup), words, or a `slot` the host fills. */
+export type MotionLayerSubject = {
+    image: string;
+} | {
+    svg: string;
+} | {
+    text: string;
+    font?: string;
+    weight?: number | string;
+} | {
+    slot: string;
+};
+/**
+ * A layer of a shot (the shape of Flair's `SceneLayer` and the effects contract's
+ * `EffectLayer`): a provider effect (a generator, filter, overlay or title), optionally applied
+ * to a `subject`, or a bare subject. It lasts from `from` to `until` (default: from the shot's
+ * start until the next shot starts), placed at `rect` in artwork units (moving with the camera)
+ * or filling the screen.
+ */
+export interface MotionShotLayer extends Omit<EffectLayer, 'id' | 'subject'> {
+    /** Unique in the scene (e.g. `layer1`). */
+    id: string;
+    subject?: MotionLayerSubject;
+    /** The provider it was added with (its `id`). */
+    provider?: string;
+    /** The effect's name when it was added, shown where no provider can draw it. */
+    name?: string;
+}
+/** A provider transition into a shot (the effects contract's `EffectShotTransition`). */
+export interface MotionShotTransition extends EffectShotTransition {
+    provider?: string;
+    name?: string;
 }
 /** How `split` splits outlined text. */
 export type MotionTextUnit = 'letter' | 'word' | 'line';

package/dist/canvas/index.cjs

@@ -117,9 +117,6 @@ var _chunkT7QSEKDYcjs = require('../chunk-T7QSEKDY.cjs');
 var _chunkSVFEVKLFcjs = require('../chunk-SVFEVKLF.cjs');
 
 
-var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
-
-
 
 var _chunkN2FGYZ4Qcjs = require('../chunk-N2FGYZ4Q.cjs');
 
@@ -217,10 +214,13 @@ var _chunkGF2RBSDMcjs = require('../chunk-GF2RBSDM.cjs');
 var _chunkNM3G4VQTcjs = require('../chunk-NM3G4VQT.cjs');
 
 
+var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
+
+
 
 
 
-var _chunkOPSK22DLcjs = require('../chunk-OPSK22DL.cjs');
+var _chunkJAOSL334cjs = require('../chunk-JAOSL334.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -11425,14 +11425,14 @@ function canvasEffectErrorReason(effect, error) {
 }
 var CANVAS_EFFECT_MISSING_PATTERN = "repeating-linear-gradient(45deg, rgba(128,128,128,0.28) 0 2px, transparent 2px 8px)";
 function createCanvasEffectsController(options) {
-  const slot = new (0, _chunkOPSK22DLcjs.EffectsSlot)();
+  const slot = new (0, _chunkJAOSL334cjs.EffectsSlot)();
   if (options.effects) slot.set(options.effects);
   const describe = async (effect, place2) => {
     const d = await slot.require().describe(effect);
     const allowed = CANVAS_EFFECT_PLACES[place2];
     if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
       const where = place2 === "transition" ? "a scene transition" : place2 === "fill" ? "a fill" : "an overlay";
-      throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
+      throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
     }
     return d;
   };
@@ -11463,7 +11463,7 @@ function createCanvasEffectsController(options) {
       else if (k in d.controls.properties) base[k] = d.defaults[k];
       else throw new Error(`"${k}" is not a control of "${d.id}"; its controls are ${Object.keys(d.controls.properties).join(", ")}.`);
     }
-    return { ...base, ..._chunkOPSK22DLcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+    return { ...base, ..._chunkJAOSL334cjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
   };
   return {
     /** The provider slot. */
@@ -11497,7 +11497,7 @@ function createCanvasEffectsController(options) {
       const mode = _nullishCoalesce(opts.mode, () => ( "fill"));
       const d = await describe(effect, mode);
       if (opts.opacity !== void 0 && !(opts.opacity >= 0 && opts.opacity <= 1)) throw new Error("opacity must be from 0 to 1.");
-      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
+      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
       commit(`Add effect ${d.name}`, withEffect(nodeId, next));
       return next;
     },
@@ -11554,7 +11554,7 @@ function createCanvasEffectsController(options) {
       const d = await describe(effect, "transition");
       const duration = _nullishCoalesce(_nullishCoalesce(opts.duration, () => ( d.duration)), () => ( 600));
       if (!(duration > 0)) throw new Error("duration must be a number of ms above 0.");
-      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkOPSK22DLcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
+      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkJAOSL334cjs.resolveEffectValues.call(void 0, d, opts.values), duration };
       scenes2.update(sceneId, { transition });
       return transition;
     }
@@ -11698,7 +11698,7 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
   const once = (instance) => {
     if (instance !== "effect") throw new Error('A shape node has one effect, "effect".');
   };
-  return _chunkOPSK22DLcjs.createEffectToolProvider.call(void 0, {
+  return _chunkJAOSL334cjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "canvas-effects")),
     namespace: options.namespace,
     title: "Canvas effects",

package/dist/canvas/index.js

@@ -115,9 +115,6 @@ import {
   CAPTURE_OVERLAY_SELECTORS,
   rasterizeElement
 } from "../chunk-XCK7QK5D.js";
-import {
-  EffectRendererPool
-} from "../chunk-EHLOCVWB.js";
 import {
   createCaptureToolProvider,
   unionCaptureRects
@@ -215,12 +212,15 @@ import {
   shapeToPolygon,
   simplifyRing
 } from "../chunk-PWBZH3FK.js";
+import {
+  EffectRendererPool
+} from "../chunk-EHLOCVWB.js";
 import {
   EffectUnsupportedError,
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-TCZ2J7PR.js";
+} from "../chunk-SIK3LT6M.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket

package/dist/chunk-6RZVFYGJ.cjs

@@ -0,0 +1,255 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkJAOSL334cjs = require('./chunk-JAOSL334.cjs');
+
+// src/effects/templates.ts
+var SLOT_NAME = /^[A-Za-z][\w-]*$/;
+var COLOR = /^#[0-9a-fA-F]{6}$/;
+var EFFECT_SEQUENCE_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var isObject = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+var isSubjectTemplateSlot = (slot) => slot.type === "image" || slot.type === "video" || slot.type === "svg";
+function effectSubjectKind(subject) {
+  if (!isObject(subject)) return void 0;
+  for (const k of ["slot", "image", "video", "svg", "text"]) if (typeof subject[k] === "string") return k;
+  return void 0;
+}
+var typeName = (value) => value === null ? "null" : Array.isArray(value) ? "a list" : typeof value === "object" ? "an object" : typeof value === "string" ? `the words ${JSON.stringify(value.length > 40 ? `${value.slice(0, 40)}\u2026` : value)}` : `${typeof value === "number" ? "the number" : "the value"} ${String(value)}`;
+function range(slot) {
+  const whole = slot.integer ? "whole number" : "number";
+  if (slot.min !== void 0 && slot.max !== void 0) return `a ${whole} from ${slot.min} to ${slot.max}`;
+  if (slot.min !== void 0) return `a ${whole} of at least ${slot.min}`;
+  if (slot.max !== void 0) return `a ${whole} of at most ${slot.max}`;
+  return `a ${whole}`;
+}
+function templateSlotTakes(slot) {
+  switch (slot.type) {
+    case "text":
+      return `words${slot.maxLength !== void 0 ? ` (up to ${slot.maxLength} characters)` : ""}`;
+    case "color":
+      return `a colour written #RRGGBB, like "${slot.default}"`;
+    case "number":
+      return range(slot);
+    case "video":
+      return "a video URL";
+    case "svg":
+      return "SVG markup or an SVG URL";
+    default:
+      return "a picture: a URL, a data: URL or <svg> markup";
+  }
+}
+function templateValueProblem(slot, value) {
+  const no = (extra = "") => `Slot "${slot.name}" takes ${templateSlotTakes(slot)}${extra}, not ${typeName(value)}.`;
+  switch (slot.type) {
+    case "text":
+      if (typeof value !== "string") return no();
+      if (slot.maxLength !== void 0 && value.length > slot.maxLength) return `Slot "${slot.name}" takes up to ${slot.maxLength} characters; the value has ${value.length}. Shorten it.`;
+      return void 0;
+    case "color":
+      return typeof value === "string" && COLOR.test(value) ? void 0 : no();
+    case "number":
+      if (typeof value !== "number" || !Number.isFinite(value)) return no();
+      if (slot.integer && !Number.isInteger(value)) return `Slot "${slot.name}" takes ${range(slot)}; ${value} is not whole.`;
+      if (slot.min !== void 0 && value < slot.min || slot.max !== void 0 && value > slot.max) return `Slot "${slot.name}" takes ${range(slot)}; ${value} is out of range.`;
+      return void 0;
+    default: {
+      const host = ` (or { "slot": "${slot.name}" } to leave it for the host)`;
+      if (typeof value === "string") return value.trim() ? void 0 : no(host);
+      const kind = effectSubjectKind(value);
+      if (!kind) return no(host);
+      if (kind === "slot") return SLOT_NAME.test(value.slot) ? void 0 : `Slot "${slot.name}" left for the host is { "slot": name }, the name letters, digits, "-" and "_", starting with a letter.`;
+      const fits = kind === slot.type || slot.type === "image" && kind === "svg";
+      if (!fits) return `Slot "${slot.name}" takes { "${slot.type}": \u2026 }${slot.type === "image" ? ' or { "svg": \u2026 }' : ""}, not { "${kind}": \u2026 }.`;
+      return value[kind].trim() ? void 0 : `Slot "${slot.name}"'s "${kind}" is a non-empty string.`;
+    }
+  }
+}
+var slotList = (slots) => slots.length ? `the slots are ${slots.map((s) => `${s.name} (${s.type})`).join(", ")}` : "the template has no slots";
+function checkTemplateValues(slots, values) {
+  if (values === void 0) return [];
+  if (!isObject(values)) return [`Values are an object of slot names to values; ${slotList(slots)}.`];
+  const byName = new Map(slots.map((s) => [s.name, s]));
+  const errors = [];
+  for (const [name, value] of Object.entries(values)) {
+    const slot = byName.get(name);
+    if (!slot) errors.push(`There is no slot "${name}"; ${slotList(slots)}.`);
+    else if (value !== void 0) {
+      const problem = templateValueProblem(slot, value);
+      if (problem) errors.push(problem);
+    }
+  }
+  return errors;
+}
+function templateSlotSchema(slot) {
+  const about = `${slot.label}${slot.description ? `: ${slot.description}` : ""}.`;
+  switch (slot.type) {
+    case "text":
+      return { type: "string", ...slot.maxLength !== void 0 ? { maxLength: slot.maxLength } : {}, description: `${about} Words${slot.maxLength !== void 0 ? `, up to ${slot.maxLength} characters` : ""}. Default ${JSON.stringify(slot.default)}.` };
+    case "color":
+      return { type: "string", pattern: COLOR.source, description: `${about} A colour as #RRGGBB. Default ${slot.default}.` };
+    case "number":
+      return {
+        type: slot.integer ? "integer" : "number",
+        ...slot.min !== void 0 ? { minimum: slot.min } : {},
+        ...slot.max !== void 0 ? { maximum: slot.max } : {},
+        description: `${about} ${range(slot).replace(/^a /, "A ")}. Default ${slot.default}.`
+      };
+    default: {
+      const key = slot.type;
+      const object = (k, what) => ({ type: "object", properties: { [k]: { type: "string", description: what } }, required: [k], additionalProperties: false, description: `{ "${k}": \u2026 }` });
+      return {
+        anyOf: [
+          { type: "string", minLength: 1, description: key === "video" ? "A video URL." : key === "svg" ? "SVG markup or an SVG URL." : "A picture URL, a data: URL or <svg> markup." },
+          object(key, key === "video" ? "A video URL." : key === "svg" ? "SVG markup or an SVG URL." : "A picture URL or a data: URL."),
+          ...key === "image" ? [object("svg", "SVG markup.")] : [],
+          object("slot", "A slot name, to leave the subject for the host to fill.")
+        ],
+        description: `${about} ${templateSlotTakes(slot).replace(/^a /, "A ")}. ${slot.hasDefault ? "Default: a placeholder picture." : "No default: left out, the host fills it."}`
+      };
+    }
+  }
+}
+function templateValuesSchema(slots) {
+  return {
+    type: "object",
+    properties: Object.fromEntries(slots.map((s) => [s.name, templateSlotSchema(s)])),
+    additionalProperties: false,
+    description: `Slot values by name; slots left out take their defaults. ${slots.length ? `Slots: ${slots.map((s) => s.name).join(", ")}.` : "This template has no slots."}`
+  };
+}
+function templateDefaultValues(slots) {
+  const out = {};
+  for (const s of slots) if (!isSubjectTemplateSlot(s)) out[s.name] = s.default;
+  return out;
+}
+function templateSlotSummary(slot) {
+  const fallback = isSubjectTemplateSlot(slot) ? slot.hasDefault ? "a placeholder by default" : "the host fills it when none is given" : `default ${JSON.stringify(slot.default)}`;
+  return `${slot.name} (${slot.type}): ${slot.label}; takes ${templateSlotTakes(slot)}; ${fallback}.`;
+}
+function searchTemplateSummaries(catalog, options = {}) {
+  const words = (_nullishCoalesce(options.query, () => ( ""))).toLowerCase().split(/\s+/).filter(Boolean);
+  const scored = [];
+  for (const t of catalog) {
+    if (!_chunkJAOSL334cjs.hasEffectTags.call(void 0, t, options.tags)) continue;
+    let score = 0;
+    const name = t.name.toLowerCase();
+    const rest = [t.id, ..._nullishCoalesce(t.tags, () => ( [])), t.description].join(" ").toLowerCase();
+    if (!words.every((w) => name.includes(w) || rest.includes(w))) continue;
+    for (const w of words) score += name.includes(w) ? 2 : 1;
+    scored.push({ t, score });
+  }
+  scored.sort((a, b) => b.score - a.score);
+  const out = scored.map((s) => s.t);
+  return options.limit !== void 0 ? out.slice(0, Math.max(0, options.limit)) : out;
+}
+var effectLayerRole = (layer) => _nullishCoalesce(layer.role, () => ( (layer.rect ? "subject" : "background")));
+function effectLayerInput(description) {
+  const images = description.inputs.filter((i) => i.kind === "image");
+  return _optionalChain([(_nullishCoalesce(images.find((i) => i.name === "source"), () => ( images.find((i) => i.name !== "from" && i.name !== "to")))), 'optionalAccess', _ => _.name]);
+}
+var EFFECT_LAYER_USES = ["generator", "filter", "overlay", "title"];
+var effectLayerOffered = (e) => (e.kind === "shader" || e.kind === "vector") && e.uses.some((u) => EFFECT_LAYER_USES.includes(u));
+var isRect = (r) => isObject(r) && ["x", "y", "width", "height"].every((k) => Number.isFinite(r[k])) && r.width > 0 && r.height > 0;
+var isLayerTime = (t) => typeof t === "number" && Number.isFinite(t) && t >= 0 || isObject(t) && Number.isInteger(t.shots) && t.shots >= 1;
+function effectSubjectProblem(subject) {
+  const kind = effectSubjectKind(subject);
+  if (!kind) return `a subject is one of { image }, { video }, { svg }, { text } or { slot }, not ${typeName(subject)}`;
+  if (!subject[kind].trim()) return `a subject's "${kind}" is a non-empty string`;
+  return void 0;
+}
+function checkEffectSequence(sequence, catalog) {
+  const problems = [];
+  if (!isObject(sequence)) return ["A sequence is an object with name, stage and shots."];
+  if (typeof sequence.name !== "string" || !sequence.name) problems.push("The sequence needs a name.");
+  const stage = sequence.stage;
+  if (!isObject(stage) || !(Number(stage.width) > 0) || !(Number(stage.height) > 0)) problems.push("The sequence needs a stage { width, height } in pixels, both > 0.");
+  if (!Array.isArray(sequence.shots) || !sequence.shots.length) return [...problems, "The sequence needs at least one shot."];
+  const byId = catalog ? new Map(catalog.map((e) => [e.id, e])) : void 0;
+  const ids = /* @__PURE__ */ new Set();
+  sequence.shots.forEach((shot, i) => {
+    const at = `shot ${i + 1}`;
+    if (!isObject(shot)) return void problems.push(`${at} is not an object.`);
+    if (!(Number.isFinite(shot.hold) && shot.hold >= 0)) problems.push(`${at}: hold must be ms \u2265 0.`);
+    for (const k of ["title", "caption"]) if (shot[k] !== void 0 && typeof shot[k] !== "string") problems.push(`${at}: ${k} must be words.`);
+    if (shot.camera !== void 0) {
+      const camera = shot.camera;
+      if (!isObject(camera)) problems.push(`${at}: camera must be an object.`);
+      else if (camera.framing !== void 0 && !isRect(camera.framing)) problems.push(`${at}: camera.framing must be { x, y, width, height } with width and height > 0.`);
+    }
+    if (!Array.isArray(shot.layers)) problems.push(`${at}: layers must be a list (it may be empty).`);
+    else
+      shot.layers.forEach((layer, j) => {
+        const where = `${at}, layer ${j + 1}`;
+        if (!isObject(layer)) return void problems.push(`${where} is not an object.`);
+        if (layer.id !== void 0) {
+          if (typeof layer.id !== "string" || !layer.id) problems.push(`${where}: id must be a non-empty string.`);
+          else if (ids.has(layer.id)) problems.push(`${where}: id "${layer.id}" is used twice.`);
+          else ids.add(layer.id);
+        }
+        if (layer.effect === void 0 && layer.subject === void 0) problems.push(`${where} has neither an effect nor a subject.`);
+        if (layer.effect !== void 0 && (typeof layer.effect !== "string" || !layer.effect)) problems.push(`${where}: effect must be an effect id.`);
+        else if (typeof layer.effect === "string" && byId) {
+          const e = byId.get(layer.effect);
+          if (!e) problems.push(`${where}: the provider has no effect "${layer.effect}".`);
+          else if (!effectLayerOffered(e)) problems.push(`${where}: "${layer.effect}" (${e.kind}, ${e.uses.join("/")}) cannot be a layer; a layer's effect is a generator, filter, overlay or title.`);
+        }
+        if (layer.subject !== void 0) {
+          const p = effectSubjectProblem(layer.subject);
+          if (p) problems.push(`${where}: ${p}.`);
+        }
+        if (layer.role !== void 0 && !_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.join(", ")}.`);
+        if (layer.rect !== void 0 && !isRect(layer.rect)) problems.push(`${where}: rect must be { x, y, width, height } with width and height > 0.`);
+        for (const k of ["from", "until"]) if (layer[k] !== void 0 && !isLayerTime(layer[k])) problems.push(`${where}: ${k} is ms \u2265 0 or { shots: n } with n \u2265 1.`);
+        if (layer.opacity !== void 0 && !(typeof layer.opacity === "number" && layer.opacity >= 0 && layer.opacity <= 1)) problems.push(`${where}: opacity is 0\u20131.`);
+        if (layer.fade !== void 0 && !(typeof layer.fade === "number" && layer.fade >= 0)) problems.push(`${where}: fade is ms \u2265 0.`);
+        if (layer.values !== void 0 && !isObject(layer.values)) problems.push(`${where}: values must be an object of control values.`);
+      });
+    if (shot.transition !== void 0) {
+      const t = shot.transition;
+      if (i === 0) problems.push(`${at} has a transition, but there is no shot before it.`);
+      if (!isObject(t) || typeof t.effect !== "string" || !t.effect) problems.push(`${at}: transition needs an effect id.`);
+      else {
+        if (t.ms !== void 0 && !(typeof t.ms === "number" && t.ms > 0)) problems.push(`${at}: transition ms must be > 0.`);
+        const e = _optionalChain([byId, 'optionalAccess', _2 => _2.get, 'call', _3 => _3(t.effect)]);
+        if (byId && !e) problems.push(`${at}: the provider has no transition "${t.effect}".`);
+        else if (e && !e.uses.includes("transition")) problems.push(`${at}: "${t.effect}" is not a transition (its uses are ${e.uses.join(", ")}).`);
+      }
+    }
+  });
+  return problems;
+}
+function effectSequenceEffects(sequence) {
+  const out = /* @__PURE__ */ new Set();
+  for (const shot of sequence.shots) {
+    for (const l of shot.layers) if (l.effect) out.add(l.effect);
+    if (shot.transition) out.add(shot.transition.effect);
+  }
+  return [...out];
+}
+function effectSequenceSlots(sequence) {
+  const out = /* @__PURE__ */ new Set();
+  for (const shot of sequence.shots) for (const l of shot.layers) if (l.subject && "slot" in l.subject) out.add(l.subject.slot);
+  return [...out];
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.EFFECT_SEQUENCE_NAME = EFFECT_SEQUENCE_NAME; exports.isSubjectTemplateSlot = isSubjectTemplateSlot; exports.effectSubjectKind = effectSubjectKind; exports.templateSlotTakes = templateSlotTakes; exports.templateValueProblem = templateValueProblem; exports.checkTemplateValues = checkTemplateValues; exports.templateSlotSchema = templateSlotSchema; exports.templateValuesSchema = templateValuesSchema; exports.templateDefaultValues = templateDefaultValues; exports.templateSlotSummary = templateSlotSummary; exports.searchTemplateSummaries = searchTemplateSummaries; exports.effectLayerRole = effectLayerRole; exports.effectLayerInput = effectLayerInput; exports.EFFECT_LAYER_USES = EFFECT_LAYER_USES; exports.effectLayerOffered = effectLayerOffered; exports.effectSubjectProblem = effectSubjectProblem; exports.checkEffectSequence = checkEffectSequence; exports.effectSequenceEffects = effectSequenceEffects; exports.effectSequenceSlots = effectSequenceSlots;

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

@@ -3,7 +3,7 @@
 
 
 
-var _chunkOPSK22DLcjs = require('./chunk-OPSK22DL.cjs');
+var _chunkJAOSL334cjs = require('./chunk-JAOSL334.cjs');
 
 
 var _chunkFJ2MSI43cjs = require('./chunk-FJ2MSI43.cjs');
@@ -26,7 +26,7 @@ function documentErrors(doc, description) {
   const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
   if (doc.values !== void 0) {
     if (!isRecord(doc.values)) errors.push({ path: "/values", message: "must be an object of control values" });
-    else errors.push(..._chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
+    else errors.push(..._chunkJAOSL334cjs.effectValueErrors.call(void 0, description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
   }
   if (doc.tracks !== void 0) {
     if (!isRecord(doc.tracks)) errors.push({ path: "/tracks", message: "must be an object of keyframe lists" });
@@ -39,7 +39,7 @@ function documentErrors(doc, description) {
           kfs.forEach((kf, i) => {
             if (!isRecord(kf)) return errors.push({ path: `${at}/${i}`, message: "must be a keyframe object" });
             if (typeof kf.time !== "number" || !Number.isFinite(kf.time) || kf.time < 0) errors.push({ path: `${at}/${i}/time`, message: "must be a finite number of ms >= 0" });
-            errors.push(..._chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
+            errors.push(..._chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
             if (kf.easing !== void 0 && !_chunkDWJJI6RTcjs.isAnimationEasing.call(void 0, kf.easing)) errors.push({ path: `${at}/${i}/easing`, message: "is not a valid easing" });
           });
       }
@@ -49,7 +49,7 @@ function documentErrors(doc, description) {
     else
       doc.presets.forEach((p, i) => {
         if (!isRecord(p) || typeof p.name !== "string" || !p.name) return errors.push({ path: `/presets/${i}`, message: "must have a name" });
-        errors.push(..._chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
+        errors.push(..._chunkJAOSL334cjs.effectValueErrors.call(void 0, description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
       });
   }
   if (doc.duration !== void 0 && (typeof doc.duration !== "number" || !Number.isFinite(doc.duration) || !(doc.duration > 0))) {
@@ -170,7 +170,7 @@ async function createEffectAuthoringSession(source, options) {
   if (isDocumentSource(source)) {
     const doc = source.document;
     if (doc.version !== 1 || !doc.effectId) {
-      throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)("Invalid effect authoring document: version 1 required");
+      throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)("Invalid effect authoring document: version 1 required");
     }
     effectId = doc.effectId;
     initialDoc = doc;
@@ -178,15 +178,15 @@ async function createEffectAuthoringSession(source, options) {
     effectId = source.effectId;
     requestedPreset = source.preset;
   } else {
-    throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)("Invalid effect authoring source");
+    throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)("Invalid effect authoring source");
   }
   const description = await provider.describe(effectId);
   if (initialDoc) {
     const problems = documentErrors(initialDoc, description);
-    if (problems.length) throw new (0, _chunkOPSK22DLcjs.EffectControlError)(effectId, problems);
+    if (problems.length) throw new (0, _chunkJAOSL334cjs.EffectControlError)(effectId, problems);
   }
   if (description.kind === "motion") {
-    throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)("Motion effects cannot be authored as pixel effects", effectId);
+    throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)("Motion effects cannot be authored as pixel effects", effectId);
   }
   let disposed = false;
   let playing = false;
@@ -207,7 +207,7 @@ async function createEffectAuthoringSession(source, options) {
     const found = description.presets.find((p) => p.name === requestedPreset);
     if (!found) {
       const validNames = description.presets.map((p) => `"${p.name}"`).join(", ");
-      throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(
+      throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(
         `Unknown preset "${requestedPreset}" for effect "${effectId}". Valid presets are: ${validNames || "none"}`,
         effectId
       );
@@ -321,7 +321,7 @@ async function createEffectAuthoringSession(source, options) {
       if (!validNames.includes(name)) {
         return { ok: false, message: `there is no control "${name}"; the controls are ${validNames.join(", ")}` };
       }
-      const errors = _chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [name]: value });
+      const errors = _chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [name]: value });
       if (errors.length > 0) {
         return { ok: false, message: valueErrorMessage(errors) };
       }
@@ -391,7 +391,7 @@ async function createEffectAuthoringSession(source, options) {
         if (!validNames.includes(k)) {
           return { ok: false, message: `there is no control "${k}"; the controls are ${validNames.join(", ")}` };
         }
-        const errors = _chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [k]: v });
+        const errors = _chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [k]: v });
         if (errors.length > 0) {
           return { ok: false, message: valueErrorMessage(errors) };
         }
@@ -528,7 +528,7 @@ async function createEffectAuthoringSession(source, options) {
         return { ok: false, message: `invalid easing: ${String(easing)}` };
       }
       const targetValue = value !== void 0 ? value : valuesAtTime(time, baseValues, tracks)[name];
-      const errors = _chunkOPSK22DLcjs.effectValueErrors.call(void 0, description, { [name]: targetValue });
+      const errors = _chunkJAOSL334cjs.effectValueErrors.call(void 0, description, { [name]: targetValue });
       if (errors.length > 0) {
         return { ok: false, message: valueErrorMessage(errors) };
       }
@@ -705,7 +705,7 @@ async function createEffectAuthoringSession(source, options) {
     },
     async createPreview(opts) {
       if (disposed) {
-        throw new (0, _chunkOPSK22DLcjs.EffectDisposedError)(effectId);
+        throw new (0, _chunkJAOSL334cjs.EffectDisposedError)(effectId);
       }
       let renderer;
       try {
@@ -730,7 +730,7 @@ async function createEffectAuthoringSession(source, options) {
         height: renderer.height,
         depth: renderer.depth,
         render: async (req) => {
-          if (disposed) throw new (0, _chunkOPSK22DLcjs.EffectDisposedError)(effectId);
+          if (disposed) throw new (0, _chunkJAOSL334cjs.EffectDisposedError)(effectId);
           const effectiveValues = _nullishCoalesce(req.values, () => ( valuesAtTime(req.time, baseValues, tracks)));
           const pixels = await renderer.render({
             ...req,

package/dist/{chunk-ERJA5CGT.cjs → chunk-DGWOGQJ5.cjs}

@@ -37,7 +37,14 @@ var MOTION_ISSUE_CODES = {
   "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." }
+  "camera-move-values": { severity: "error", wording: "A camera move's preset or values do not fit its controls." },
+  "layer-effect-unknown": { severity: "error", wording: "A shot layer names an effect the provider does not have, one that cannot be a layer, or a subject its effect cannot take." },
+  "layer-effect-values": { severity: "error", wording: "A shot layer's preset or values do not fit its effect's controls." },
+  "layer-not-drawn": { severity: "note", wording: "Shot layers name provider effects, but there is no effects provider to draw them, so they are left out of frames." },
+  "layer-slot-empty": { severity: "warning", wording: "A shot layer's subject is a slot nobody has filled, so it draws nothing." },
+  "transition-unknown": { severity: "error", wording: "A shot names a transition the provider does not have, or an effect that is not a transition." },
+  "transition-first-shot": { severity: "note", wording: "The first shot has a transition, but there is no shot before it, so it does not play." },
+  "transition-not-played": { severity: "note", wording: "Shots name transitions, but there is no effects provider to play them, so they crossfade." }
 };
 function motionIssue(code, message, extra = {}) {
   return { code, severity: MOTION_ISSUE_CODES[code].severity, message, ...extra };

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

@@ -37,7 +37,14 @@ var MOTION_ISSUE_CODES = {
   "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." }
+  "camera-move-values": { severity: "error", wording: "A camera move's preset or values do not fit its controls." },
+  "layer-effect-unknown": { severity: "error", wording: "A shot layer names an effect the provider does not have, one that cannot be a layer, or a subject its effect cannot take." },
+  "layer-effect-values": { severity: "error", wording: "A shot layer's preset or values do not fit its effect's controls." },
+  "layer-not-drawn": { severity: "note", wording: "Shot layers name provider effects, but there is no effects provider to draw them, so they are left out of frames." },
+  "layer-slot-empty": { severity: "warning", wording: "A shot layer's subject is a slot nobody has filled, so it draws nothing." },
+  "transition-unknown": { severity: "error", wording: "A shot names a transition the provider does not have, or an effect that is not a transition." },
+  "transition-first-shot": { severity: "note", wording: "The first shot has a transition, but there is no shot before it, so it does not play." },
+  "transition-not-played": { severity: "note", wording: "Shots name transitions, but there is no effects provider to play them, so they crossfade." }
 };
 function motionIssue(code, message, extra = {}) {
   return { code, severity: MOTION_ISSUE_CODES[code].severity, message, ...extra };