@pixerate/editor 0.231.1 → 0.233.0

package/dist/chunk-I277KJLQ.js

@@ -0,0 +1,255 @@
+import {
+  EFFECT_LAYER_ROLES,
+  hasEffectTags
+} from "./chunk-SIK3LT6M.js";
+
+// 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 = (options.query ?? "").toLowerCase().split(/\s+/).filter(Boolean);
+  const scored = [];
+  for (const t of catalog) {
+    if (!hasEffectTags(t, options.tags)) continue;
+    let score = 0;
+    const name = t.name.toLowerCase();
+    const rest = [t.id, ...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) => layer.role ?? (layer.rect ? "subject" : "background");
+function effectLayerInput(description) {
+  const images = description.inputs.filter((i) => i.kind === "image");
+  return (images.find((i) => i.name === "source") ?? images.find((i) => i.name !== "from" && i.name !== "to"))?.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 && !EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${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 = byId?.get(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];
+}
+
+export {
+  EFFECT_SEQUENCE_NAME,
+  isSubjectTemplateSlot,
+  effectSubjectKind,
+  templateSlotTakes,
+  templateValueProblem,
+  checkTemplateValues,
+  templateSlotSchema,
+  templateValuesSchema,
+  templateDefaultValues,
+  templateSlotSummary,
+  searchTemplateSummaries,
+  effectLayerRole,
+  effectLayerInput,
+  EFFECT_LAYER_USES,
+  effectLayerOffered,
+  effectSubjectProblem,
+  checkEffectSequence,
+  effectSequenceEffects,
+  effectSequenceSlots
+};

package/dist/{chunk-OPSK22DL.cjs → chunk-JAOSL334.cjs}

@@ -2,8 +2,17 @@
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
 
+// src/effects/types.ts
+var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
+var CAMERA_MOVE_ROLES = ["transition", "hold"];
+var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
+var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
+var EFFECT_TRANSITION_MS = 800;
+var EFFECT_TEMPLATE_SLOT_TYPES = ["image", "video", "svg", "text", "color", "number"];
+
 // src/effects/errors.ts
-var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider"];
+var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider", "unknown_template"];
 var EffectError = class extends Error {
   
   
@@ -24,6 +33,14 @@ var UnknownEffectError = class extends EffectError {
     this.name = "UnknownEffectError";
   }
 };
+var UnknownTemplateError = class extends EffectError {
+  
+  constructor(templateId, providerName) {
+    super("unknown_template", `Unknown template "${templateId}"${providerName ? ` in ${providerName}` : ""}. Call list_templates or listTemplates() for valid ids.`);
+    this.name = "UnknownTemplateError";
+    this.templateId = templateId;
+  }
+};
 var EffectControlError = class extends EffectError {
   
   constructor(effectId, details) {
@@ -273,11 +290,6 @@ function cameraBoxOfView(view, stage) {
   return { x: -view.scrollX, y: -view.scrollY, width, height };
 }
 
-// src/effects/types.ts
-var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
-var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
-var CAMERA_MOVE_ROLES = ["transition", "hold"];
-
 // src/effects/tools.ts
 var ANNOTATIONS = {
   read: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
@@ -553,4 +565,9 @@ function createEffectToolProvider(host) {
 
 
 
-exports.EFFECT_ERROR_CODES = EFFECT_ERROR_CODES; exports.EffectError = EffectError; exports.UnknownEffectError = UnknownEffectError; exports.EffectControlError = EffectControlError; exports.EffectUnsupportedError = EffectUnsupportedError; exports.EffectDisposedError = EffectDisposedError; exports.NoEffectsProviderError = NoEffectsProviderError; exports.isEffectError = isEffectError; exports.effectValueErrors = effectValueErrors; exports.resolveEffectValues = resolveEffectValues; exports.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;
+
+
+
+
+
+exports.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.EFFECT_SUBJECT_KINDS = EFFECT_SUBJECT_KINDS; exports.EFFECT_LAYER_ROLES = EFFECT_LAYER_ROLES; exports.EFFECT_TRANSITION_MS = EFFECT_TRANSITION_MS; exports.EFFECT_TEMPLATE_SLOT_TYPES = EFFECT_TEMPLATE_SLOT_TYPES; exports.EFFECT_ERROR_CODES = EFFECT_ERROR_CODES; exports.EffectError = EffectError; exports.UnknownEffectError = UnknownEffectError; exports.UnknownTemplateError = UnknownTemplateError; 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.createEffectToolProvider = createEffectToolProvider;

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

@@ -2,8 +2,17 @@ import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";
 
+// src/effects/types.ts
+var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
+var CAMERA_MOVE_ROLES = ["transition", "hold"];
+var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
+var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
+var EFFECT_TRANSITION_MS = 800;
+var EFFECT_TEMPLATE_SLOT_TYPES = ["image", "video", "svg", "text", "color", "number"];
+
 // src/effects/errors.ts
-var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider"];
+var EFFECT_ERROR_CODES = ["unknown_effect", "invalid_values", "unsupported", "disposed", "no_provider", "unknown_template"];
 var EffectError = class extends Error {
   code;
   effectId;
@@ -24,6 +33,14 @@ var UnknownEffectError = class extends EffectError {
     this.name = "UnknownEffectError";
   }
 };
+var UnknownTemplateError = class extends EffectError {
+  templateId;
+  constructor(templateId, providerName) {
+    super("unknown_template", `Unknown template "${templateId}"${providerName ? ` in ${providerName}` : ""}. Call list_templates or listTemplates() for valid ids.`);
+    this.name = "UnknownTemplateError";
+    this.templateId = templateId;
+  }
+};
 var EffectControlError = class extends EffectError {
   details;
   constructor(effectId, details) {
@@ -273,11 +290,6 @@ function cameraBoxOfView(view, stage) {
   return { x: -view.scrollX, y: -view.scrollY, width, height };
 }
 
-// src/effects/types.ts
-var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
-var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
-var CAMERA_MOVE_ROLES = ["transition", "hold"];
-
 // src/effects/tools.ts
 var ANNOTATIONS = {
   read: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
@@ -516,9 +528,17 @@ function createEffectToolProvider(host) {
 }
 
 export {
+  EFFECT_KINDS,
+  EFFECT_USES,
+  CAMERA_MOVE_ROLES,
+  EFFECT_SUBJECT_KINDS,
+  EFFECT_LAYER_ROLES,
+  EFFECT_TRANSITION_MS,
+  EFFECT_TEMPLATE_SLOT_TYPES,
   EFFECT_ERROR_CODES,
   EffectError,
   UnknownEffectError,
+  UnknownTemplateError,
   EffectControlError,
   EffectUnsupportedError,
   EffectDisposedError,
@@ -549,8 +569,5 @@ export {
   resolveCameraMoveSpec,
   cameraViewOfBox,
   cameraBoxOfView,
-  EFFECT_KINDS,
-  EFFECT_USES,
-  CAMERA_MOVE_ROLES,
   createEffectToolProvider
 };

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

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

package/dist/{chunk-CSM5T6SE.js → chunk-WDDUPWVG.js}

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

package/dist/{chunk-5T3H7CGG.cjs → chunk-ZQIWBJGH.cjs}

@@ -7,7 +7,7 @@ var _chunkPY4GWSE2cjs = require('./chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkOPSK22DLcjs = require('./chunk-OPSK22DL.cjs');
+var _chunkJAOSL334cjs = require('./chunk-JAOSL334.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
@@ -1316,12 +1316,12 @@ function videoEffectLayerKey(layer, width, height) {
 }
 function mixEffectPixels(a, b, k) {
   if (k >= 1) return b;
-  const out = _chunkOPSK22DLcjs.createEffectPixels.call(void 0, a.width, a.height);
+  const out = _chunkJAOSL334cjs.createEffectPixels.call(void 0, a.width, a.height);
   for (let i = 0; i < out.data.length; i++) out.data[i] = a.data[i] + (b.data[i] - a.data[i]) * k;
   return out;
 }
 function overEffectPixels(base, top, opacity = 1) {
-  const out = _chunkOPSK22DLcjs.createEffectPixels.call(void 0, base.width, base.height);
+  const out = _chunkJAOSL334cjs.createEffectPixels.call(void 0, base.width, base.height);
   const o = out.data;
   const b = base.data;
   const t = top.data;
@@ -1366,7 +1366,7 @@ var VideoEffectsEngine = (_class2 = class {
   __init10() {this.generation = 0}
   
   constructor(options = {}) {;_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);
-    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkOPSK22DLcjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkJAOSL334cjs.EffectsSlot)()));
     this.maxEntries = _nullishCoalesce(options.maxEntries, () => ( 120));
     this.toImage = _nullishCoalesce(options.toImage, () => ( defaultToImage));
     this.pool = new (0, _chunkPY4GWSE2cjs.EffectRendererPool)({ maxRenderers: options.maxRenderers });
@@ -1508,7 +1508,7 @@ function checkVideoEffectPlace(d, place) {
   if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
     const where = place === "clip" ? "on a clip" : place === "transition" ? "as a transition" : "as an effect clip";
     const instead = d.uses.includes("transition") ? "set_video_effect_transition" : d.uses.some((u) => VIDEO_EFFECT_PLACES.generator.includes(u)) ? "add_video_effect_clip" : d.uses.some((u) => u === "filter") ? "apply_effect" : null;
-    throw new (0, _chunkOPSK22DLcjs.EffectUnsupportedError)(
+    throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(
       `"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be used ${where}, which takes ${allowed.join(" or ")} effects${instead ? `; use ${instead} instead` : ""}. search_effects with use "${allowed[0]}" lists ones that fit.`,
       d.id
     );
@@ -1529,12 +1529,12 @@ function checkVideoEffectValues(d, values, options = {}) {
     else if (type !== "number" && type !== "integer") errors.push({ path: `/${k}`, message: "only number controls can be keyframed." });
     else for (const [i, key] of v.keys.entries()) for (const e of _chunkWOFXZ3XUcjs.validateJsonSchema.call(void 0, key.v, schema)) errors.push({ path: `/${k}/keys/${i}/v`, message: e.message });
   }
-  for (const e of _chunkOPSK22DLcjs.effectValueErrors.call(void 0, d, plain)) {
+  for (const e of _chunkJAOSL334cjs.effectValueErrors.call(void 0, d, plain)) {
     const name = e.path.split("/")[1];
     const about = name && _optionalChain([d, 'access', _46 => _46.controls, 'access', _47 => _47.properties, 'access', _48 => _48[name], 'optionalAccess', _49 => _49.description]);
     errors.push(about ? { path: e.path, message: `${e.message} (${about})` } : e);
   }
-  if (errors.length) throw new (0, _chunkOPSK22DLcjs.EffectControlError)(d.id, errors);
+  if (errors.length) throw new (0, _chunkJAOSL334cjs.EffectControlError)(d.id, errors);
   return { ..._nullishCoalesce(options.base, () => ( d.defaults)), ..._nullishCoalesce(values, () => ( {})) };
 }
 

package/dist/effects/conformance.d.cts

@@ -6,6 +6,8 @@
 import { type EffectProvider } from './types.cjs';
 export interface EffectConformanceIssue {
     effectId?: string;
+    /** Set for an issue with a sequence template. */
+    templateId?: string;
     message: string;
 }
 export interface EffectConformanceOptions {
@@ -17,6 +19,7 @@ export interface EffectConformanceOptions {
     size?: number;
     /** Also check authoring when supportsAuthoring is true (default true). */
     authoring?: boolean;
+    /** Also check sequence templates when supportsTemplates is true (default true). */
+    templates?: boolean;
 }
-/** Runs the contract checks against `provider` and returns every issue found (empty when it conforms). */
 export declare function checkEffectProvider(provider: EffectProvider, options?: EffectConformanceOptions): Promise<EffectConformanceIssue[]>;

package/dist/effects/conformance.d.ts

@@ -6,6 +6,8 @@
 import { type EffectProvider } from './types.js';
 export interface EffectConformanceIssue {
     effectId?: string;
+    /** Set for an issue with a sequence template. */
+    templateId?: string;
     message: string;
 }
 export interface EffectConformanceOptions {
@@ -17,6 +19,7 @@ export interface EffectConformanceOptions {
     size?: number;
     /** Also check authoring when supportsAuthoring is true (default true). */
     authoring?: boolean;
+    /** Also check sequence templates when supportsTemplates is true (default true). */
+    templates?: boolean;
 }
-/** Runs the contract checks against `provider` and returns every issue found (empty when it conforms). */
 export declare function checkEffectProvider(provider: EffectProvider, options?: EffectConformanceOptions): Promise<EffectConformanceIssue[]>;

package/dist/effects/errors.d.cts

@@ -1,5 +1,5 @@
 import type { SchemaValidationError } from '../tools/schema.cjs';
-export type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider';
+export type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider' | 'unknown_template';
 export declare const EFFECT_ERROR_CODES: readonly EffectErrorCode[];
 /**
  * Base of every effects error. Check `code` (or use `isEffectError`) rather than `instanceof`
@@ -14,6 +14,11 @@ export declare class EffectError extends Error {
 export declare class UnknownEffectError extends EffectError {
     constructor(effectId: string, providerName?: string);
 }
+/** No sequence template has this id. */
+export declare class UnknownTemplateError extends EffectError {
+    readonly templateId: string;
+    constructor(templateId: string, providerName?: string);
+}
 /** Control values do not match the effect's control schema (unknown control, wrong type, out of range). */
 export declare class EffectControlError extends EffectError {
     readonly details: readonly SchemaValidationError[];

package/dist/effects/errors.d.ts

@@ -1,5 +1,5 @@
 import type { SchemaValidationError } from '../tools/schema.js';
-export type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider';
+export type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider' | 'unknown_template';
 export declare const EFFECT_ERROR_CODES: readonly EffectErrorCode[];
 /**
  * Base of every effects error. Check `code` (or use `isEffectError`) rather than `instanceof`
@@ -14,6 +14,11 @@ export declare class EffectError extends Error {
 export declare class UnknownEffectError extends EffectError {
     constructor(effectId: string, providerName?: string);
 }
+/** No sequence template has this id. */
+export declare class UnknownTemplateError extends EffectError {
+    readonly templateId: string;
+    constructor(templateId: string, providerName?: string);
+}
 /** Control values do not match the effect's control schema (unknown control, wrong type, out of range). */
 export declare class EffectControlError extends EffectError {
     readonly details: readonly SchemaValidationError[];

package/dist/effects/fake-templates.d.cts

@@ -0,0 +1,17 @@
+/**
+ * The fake provider's sequence templates (`createFakeEffectProvider({ templates: true })`), built
+ * only from its own effects, and a small reference of how a provider fills one: `{{slot}}` in any
+ * string (a whole-string placeholder takes the typed value), and `{ slot }` subjects.
+ *
+ * - `fake.title-sequence`: a gradient behind a title with a lower-third bar, then a crossfade to
+ *   a second shot with a caption. Text, colour and number slots.
+ * - `fake.picture-reveal`: a tinted picture, then a crossfade to the picture with a logo over it.
+ *   An image slot with a default and one without (left for the host when not given).
+ */
+import type { EffectTemplateDescription, EffectTemplateOptions, EffectTemplateResult, EffectTemplateSearchOptions, EffectTemplateSummary, EffectTemplateValues } from './types.cjs';
+/** The template methods of the fake provider. */
+export declare function fakeTemplateMethods(): {
+    listTemplates: (options?: EffectTemplateSearchOptions) => EffectTemplateSummary[];
+    describeTemplate: (id: string) => EffectTemplateDescription;
+    instantiateTemplate(id: string, values?: EffectTemplateValues, options?: EffectTemplateOptions): EffectTemplateResult;
+};

package/dist/effects/fake-templates.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The fake provider's sequence templates (`createFakeEffectProvider({ templates: true })`), built
+ * only from its own effects, and a small reference of how a provider fills one: `{{slot}}` in any
+ * string (a whole-string placeholder takes the typed value), and `{ slot }` subjects.
+ *
+ * - `fake.title-sequence`: a gradient behind a title with a lower-third bar, then a crossfade to
+ *   a second shot with a caption. Text, colour and number slots.
+ * - `fake.picture-reveal`: a tinted picture, then a crossfade to the picture with a logo over it.
+ *   An image slot with a default and one without (left for the host when not given).
+ */
+import type { EffectTemplateDescription, EffectTemplateOptions, EffectTemplateResult, EffectTemplateSearchOptions, EffectTemplateSummary, EffectTemplateValues } from './types.js';
+/** The template methods of the fake provider. */
+export declare function fakeTemplateMethods(): {
+    listTemplates: (options?: EffectTemplateSearchOptions) => EffectTemplateSummary[];
+    describeTemplate: (id: string) => EffectTemplateDescription;
+    instantiateTemplate(id: string, values?: EffectTemplateValues, options?: EffectTemplateOptions): EffectTemplateResult;
+};

package/dist/effects/fake.d.cts

@@ -12,6 +12,9 @@
  *
  * With `camera: true` it also has camera moves (no pixels): `glide` and `whip` (transitions; the
  * whip cuts halfway) and `drift` (a hold that zooms in slowly).
+ *
+ * With `templates: true` it also has two sequence templates (see `fake-templates.ts`):
+ * `fake.title-sequence` and `fake.picture-reveal`.
  */
 import type { EffectProvider, EffectProviderCapabilities, EffectRenderRequest } from './types.cjs';
 export interface FakeEffectProviderOptions {
@@ -23,6 +26,8 @@ export interface FakeEffectProviderOptions {
     authoring?: boolean;
     /** Adds the camera moves and `cameraView` / `sampleCameraMove` (default false). */
     camera?: boolean;
+    /** Adds two sequence templates and `listTemplates` / `describeTemplate` / `instantiateTemplate` (default false). */
+    templates?: boolean;
 }
-/** A deterministic CPU effects provider with seven effects, and three camera moves on request (see the module comment). */
+/** A deterministic CPU effects provider with seven effects, and camera moves and templates on request (see the module comment). */
 export declare function createFakeEffectProvider(options?: FakeEffectProviderOptions): EffectProvider;

package/dist/effects/fake.d.ts

@@ -12,6 +12,9 @@
  *
  * With `camera: true` it also has camera moves (no pixels): `glide` and `whip` (transitions; the
  * whip cuts halfway) and `drift` (a hold that zooms in slowly).
+ *
+ * With `templates: true` it also has two sequence templates (see `fake-templates.ts`):
+ * `fake.title-sequence` and `fake.picture-reveal`.
  */
 import type { EffectProvider, EffectProviderCapabilities, EffectRenderRequest } from './types.js';
 export interface FakeEffectProviderOptions {
@@ -23,6 +26,8 @@ export interface FakeEffectProviderOptions {
     authoring?: boolean;
     /** Adds the camera moves and `cameraView` / `sampleCameraMove` (default false). */
     camera?: boolean;
+    /** Adds two sequence templates and `listTemplates` / `describeTemplate` / `instantiateTemplate` (default false). */
+    templates?: boolean;
 }
-/** A deterministic CPU effects provider with seven effects, and three camera moves on request (see the module comment). */
+/** A deterministic CPU effects provider with seven effects, and camera moves and templates on request (see the module comment). */
 export declare function createFakeEffectProvider(options?: FakeEffectProviderOptions): EffectProvider;