@pixerate/editor 0.232.0 → 0.234.0

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-PQYDJ2AV.js";
+} from "../chunk-SIK3LT6M.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket
@@ -11786,17 +11786,26 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
 
 // src/canvas/editorDocument.ts
 var RUNTIME_NODE_KEYS = ["selected", "dragging", "measured", "resizing"];
-var stripNode = (node) => {
-  const copy = { ...node };
-  for (const key of RUNTIME_NODE_KEYS) delete copy[key];
+var RUNTIME_EDGE_KEYS = ["selected"];
+var omit = (value, keys) => {
+  const copy = { ...value };
+  for (const key of keys) delete copy[key];
   return copy;
 };
-var stripEdge = (edge) => {
-  const { selected: _selected, ...rest } = edge;
-  return rest;
+var omitKeys = (options = {}) => ({
+  node: [...RUNTIME_NODE_KEYS, ...options.omitNodeKeys ?? []],
+  edge: [...RUNTIME_EDGE_KEYS, ...options.omitEdgeKeys ?? []]
+});
+function canvasDocumentContentKey(nodes, edges, options) {
+  const keys = omitKeys(options);
+  return JSON.stringify([nodes.map((n3) => omit(n3, keys.node)), edges.map((e) => omit(e, keys.edge))]);
+}
+var isViewport = (value) => {
+  const v = value;
+  return !!v && typeof v === "object" && [v.x, v.y, v.zoom].every((n3) => typeof n3 === "number" && Number.isFinite(n3)) && v.zoom > 0;
 };
 function checkCanvasDocument(document2) {
-  const hint = "A canvas document is { nodes: [{ id, position: { x, y }, data }], edges: [{ id, source, target }], scenes? } as get_canvas_document returns it.";
+  const hint = "A canvas document is { nodes: [{ id, position: { x, y }, data }], edges: [{ id, source, target }], scenes?, viewport? } as get_canvas_document returns it.";
   const value = document2;
   if (!value || typeof value !== "object" || !Array.isArray(value.nodes)) throw new Error(`nodes must be an array. ${hint}`);
   if (!Array.isArray(value.edges)) throw new Error(`edges must be an array. ${hint}`);
@@ -11819,25 +11828,42 @@ function checkCanvasDocument(document2) {
     }
   });
   if (value.scenes !== void 0 && !Array.isArray(value.scenes)) throw new Error(`scenes must be an array. ${hint}`);
+  if (value.viewport !== void 0 && !isViewport(value.viewport)) throw new Error(`viewport must be { x, y, zoom } with finite numbers and a zoom above 0. ${hint}`);
 }
 function createCanvasEditorDocument(options) {
   const { history, scenes: scenes2 } = options;
+  const keys = omitKeys(options);
   const snapshot = () => ({
-    nodes: options.getNodes().map(stripNode),
-    edges: options.getEdges().map(stripEdge),
-    ...scenes2 ? { scenes: scenes2.toJSON().scenes } : {}
+    nodes: options.getNodes().map((n3) => omit(n3, keys.node)),
+    edges: options.getEdges().map((e) => omit(e, keys.edge)),
+    ...scenes2 ? { scenes: scenes2.toJSON().scenes } : {},
+    ...options.getViewport ? { viewport: { ...options.getViewport() } } : {}
   });
   const apply = (doc) => {
     options.setNodes(doc.nodes.map((n3) => ({ ...n3 })));
     options.setEdges(doc.edges.map((e) => ({ ...e })));
     if (scenes2) scenes2.load(doc.scenes ?? []);
+    if (doc.viewport) options.setViewport?.({ ...doc.viewport });
+  };
+  const check = (document2) => {
+    checkCanvasDocument(document2);
+    const next = document2;
+    if (options.validateNode) {
+      next.nodes.forEach((node, i) => {
+        const problem = options.validateNode(node, i);
+        if (problem) throw new Error(`Node "${node.id}" (nodes[${i}]): ${problem}`);
+      });
+    }
+    return next;
   };
   return defineEditorDocument({
     kind: "canvas",
+    formatVersion: options.formatVersion,
+    migrations: options.migrations,
+    assets: options.assets,
     get: snapshot,
     load: (document2, { history: mode }) => {
-      checkCanvasDocument(document2);
-      const next = document2;
+      const next = check(options.normalize ? options.normalize(document2) : document2);
       if (mode === "record") {
         const before = snapshot();
         history.execute({ name: "Load canvas", execute: () => apply(next), undo: () => apply(before) });
@@ -11863,7 +11889,7 @@ function createCanvasEditorDocument(options) {
 function createCanvasGestureRecorder(options) {
   let before = null;
   const take = () => ({ nodes: options.getNodes(), edges: options.getEdges?.() });
-  const key = (s) => JSON.stringify([s.nodes.map(stripNode), s.edges?.map(stripEdge)]);
+  const key = (s) => canvasDocumentContentKey(s.nodes, s.edges ?? []);
   const restore = (s) => {
     options.setNodes(s.nodes);
     if (s.edges && options.setEdges) options.setEdges(s.edges);
@@ -12273,6 +12299,7 @@ export {
   canCombineShapeNodes,
   canOffsetShapeNodes,
   canOutlineShapeNodeStrokes,
+  canvasDocumentContentKey,
   canvasEffectErrorReason,
   canvasEffectStatus,
   canvasEffectsPool,

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-RG4O6K2A.cjs → chunk-A7PQNIBX.cjs}

@@ -3,7 +3,7 @@
 
 
 
-var _chunk2K5TELHVcjs = require('./chunk-2K5TELHV.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(..._chunk2K5TELHVcjs.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(..._chunk2K5TELHVcjs.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(..._chunk2K5TELHVcjs.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, _chunk2K5TELHVcjs.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, _chunk2K5TELHVcjs.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, _chunk2K5TELHVcjs.EffectControlError)(effectId, problems);
+    if (problems.length) throw new (0, _chunkJAOSL334cjs.EffectControlError)(effectId, problems);
   }
   if (description.kind === "motion") {
-    throw new (0, _chunk2K5TELHVcjs.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, _chunk2K5TELHVcjs.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 = _chunk2K5TELHVcjs.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 = _chunk2K5TELHVcjs.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 = _chunk2K5TELHVcjs.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, _chunk2K5TELHVcjs.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, _chunk2K5TELHVcjs.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 };