@pixerate/editor 0.234.0 → 0.236.0

package/dist/{chunk-I277KJLQ.js → chunk-G3RUKJ5C.js}

@@ -1,5 +1,8 @@
 import {
   EFFECT_LAYER_ROLES,
+  EFFECT_TRANSITION_MS,
+  EffectUnsupportedError,
+  NoEffectsProviderError,
   hasEffectTags
 } from "./chunk-SIK3LT6M.js";
 
@@ -231,6 +234,103 @@ function effectSequenceSlots(sequence) {
   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];
 }
+async function fillEffectTemplate(provider, id, values = {}, options = {}) {
+  if (!provider) throw new NoEffectsProviderError();
+  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new EffectUnsupportedError(`${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).`);
+  const template = await provider.describeTemplate(id);
+  const errors = checkTemplateValues(template.slots, values);
+  if (errors.length) throw new Error(`${errors.join(" ")} describe_template lists what each slot takes.`);
+  const result = await provider.instantiateTemplate(id, values, options);
+  if (!result.ok) throw new Error(`${result.errors.join(" ")} describe_template lists what each slot takes.`);
+  const problems = checkEffectSequence(result.sequence, await provider.list());
+  if (problems.length) throw new Error(`${provider.name} filled "${id}" with a sequence this editor cannot load: ${problems.join(" ")}`);
+  return { template, sequence: result.sequence, openSlots: [...result.openSlots], notes: [...result.notes] };
+}
+function effectLayerSpan(layer, shotIndex, shotStarts, total) {
+  const at = (t, fallback) => t === void 0 ? fallback : typeof t === "number" ? shotStarts[shotIndex] + t : shotStarts[shotIndex + t.shots] ?? total;
+  const start = at(layer.from, shotStarts[shotIndex]);
+  return { start, end: Math.max(start, at(layer.until ?? { shots: 1 }, total)) };
+}
+function effectSequenceTiming(sequence) {
+  const starts = [];
+  const leadIns = [];
+  let t = 0;
+  sequence.shots.forEach((shot, i) => {
+    const transition = i > 0 && shot.transition ? shot.transition.ms ?? EFFECT_TRANSITION_MS : 0;
+    const move = typeof shot.camera?.in === "object" && i > 0 ? shot.camera.in.ms ?? 0 : 0;
+    const lead = Math.max(transition, move);
+    starts.push(t);
+    leadIns.push(lead);
+    t += lead + shot.hold;
+  });
+  return { starts, leadIns, total: t };
+}
+
+// src/effects/template-tools.ts
+var unavailable = (provider) => !provider ? "No effects provider is registered, so there are no sequence templates." : !provider.capabilities.supportsTemplates || !provider.listTemplates ? `${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).` : null;
+function effectTemplateTools(host, ctx) {
+  const require2 = () => {
+    const provider = host.provider();
+    const reason = unavailable(provider);
+    if (reason) throw new Error(reason);
+    return provider;
+  };
+  return [
+    {
+      name: "list_templates",
+      title: "List sequence templates",
+      description: "Lists the effects provider's sequence templates (ready-made scenes of several shots with slots to fill: a product reveal, before and after, a stat countdown\u2026), best match first: { available, templates: [{ id, name, description, tags, shots, durationMs }] }. Then describe_template for a template's slots and fill_template to use it. Without a provider that has templates it returns available: false and the reason.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Words to match in the name, id, tags or description (default: every template)." },
+          tags: { type: "array", items: { type: "string", minLength: 1 }, description: "Only templates carrying every one of these tags." },
+          limit: { type: "integer", minimum: 1, maximum: 100, description: "Most templates to return (default all)." }
+        },
+        additionalProperties: false
+      },
+      annotations: { title: "List sequence templates", ...ctx.annotations.read },
+      handler: async ({ query, tags, limit }) => {
+        const provider = host.provider();
+        const reason = unavailable(provider);
+        if (reason) return { available: false, reason, templates: [] };
+        return { available: true, provider: provider.name, templates: await provider.listTemplates({ ...query ? { query } : {}, ...tags ? { tags } : {}, ...limit ? { limit } : {} }) };
+      }
+    },
+    {
+      name: "describe_template",
+      title: "Describe a sequence template",
+      description: `Describes a template's slots in the order a form shows them: { id, name, description, shots, slots: [{ name, type (image, video, svg, text, color, number), label, description, default or hasDefault, maxLength, min, max, integer }], slotSummaries (one line each), valuesSchema (the JSON Schema fill_template's values follow), exampleValues (the text, colour and number defaults, to change) }. Subject slots (image, video, svg) take a URL, markup, or { "slot": name } to leave them for the host.`,
+      inputSchema: { type: "object", properties: { template: { type: "string", minLength: 1, description: "A template id from list_templates." } }, required: ["template"], additionalProperties: false },
+      annotations: { title: "Describe a sequence template", ...ctx.annotations.read },
+      handler: async ({ template }) => {
+        const d = await require2().describeTemplate(template);
+        return { ...d, slotSummaries: d.slots.map(templateSlotSummary), valuesSchema: templateValuesSchema(d.slots), exampleValues: templateDefaultValues(d.slots) };
+      }
+    },
+    {
+      name: "fill_template",
+      title: "Fill a sequence template",
+      description: `Fills a template's slots and loads the result. ${host.fillDetails} Slots left out take their defaults. Values are checked first: every value that does not fit (an unknown slot, a wrong type, a number out of range, text too long) is refused at once, naming what the slot takes, and nothing changes. One undo step. Subject slots left open draw nothing until filled; the result's openSlots says which.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          template: { type: "string", minLength: 1, description: "A template id from list_templates." },
+          values: { type: "object", description: "Slot values by name, following describe_template's valuesSchema (default: every slot's default)." },
+          name: { type: "string", pattern: "^[a-z0-9]+(?:-[a-z0-9]+)*$", description: "A name for the result: lowercase words and dashes (default the template's)." },
+          ...host.fillOptions ?? {}
+        },
+        required: ["template"],
+        additionalProperties: false
+      },
+      annotations: { title: "Fill a sequence template", ...ctx.annotations.write },
+      handler: async ({ template, values, ...options }) => {
+        require2();
+        return host.fill(template, values ?? {}, options);
+      }
+    }
+  ];
+}
 
 export {
   EFFECT_SEQUENCE_NAME,
@@ -251,5 +351,9 @@ export {
   effectSubjectProblem,
   checkEffectSequence,
   effectSequenceEffects,
-  effectSequenceSlots
+  effectSequenceSlots,
+  fillEffectTemplate,
+  effectLayerSpan,
+  effectSequenceTiming,
+  effectTemplateTools
 };

package/dist/{chunk-6RZVFYGJ.cjs → chunk-JWCKJNDR.cjs}

@@ -1,6 +1,9 @@
 "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
@@ -231,6 +234,107 @@ function effectSequenceSlots(sequence) {
   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];
 }
+async function fillEffectTemplate(provider, id, values = {}, options = {}) {
+  if (!provider) throw new (0, _chunkJAOSL334cjs.NoEffectsProviderError)();
+  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).`);
+  const template = await provider.describeTemplate(id);
+  const errors = checkTemplateValues(template.slots, values);
+  if (errors.length) throw new Error(`${errors.join(" ")} describe_template lists what each slot takes.`);
+  const result = await provider.instantiateTemplate(id, values, options);
+  if (!result.ok) throw new Error(`${result.errors.join(" ")} describe_template lists what each slot takes.`);
+  const problems = checkEffectSequence(result.sequence, await provider.list());
+  if (problems.length) throw new Error(`${provider.name} filled "${id}" with a sequence this editor cannot load: ${problems.join(" ")}`);
+  return { template, sequence: result.sequence, openSlots: [...result.openSlots], notes: [...result.notes] };
+}
+function effectLayerSpan(layer, shotIndex, shotStarts, total) {
+  const at = (t, fallback) => t === void 0 ? fallback : typeof t === "number" ? shotStarts[shotIndex] + t : _nullishCoalesce(shotStarts[shotIndex + t.shots], () => ( total));
+  const start = at(layer.from, shotStarts[shotIndex]);
+  return { start, end: Math.max(start, at(_nullishCoalesce(layer.until, () => ( { shots: 1 })), total)) };
+}
+function effectSequenceTiming(sequence) {
+  const starts = [];
+  const leadIns = [];
+  let t = 0;
+  sequence.shots.forEach((shot, i) => {
+    const transition = i > 0 && shot.transition ? _nullishCoalesce(shot.transition.ms, () => ( _chunkJAOSL334cjs.EFFECT_TRANSITION_MS)) : 0;
+    const move = typeof _optionalChain([shot, 'access', _4 => _4.camera, 'optionalAccess', _5 => _5.in]) === "object" && i > 0 ? _nullishCoalesce(shot.camera.in.ms, () => ( 0)) : 0;
+    const lead = Math.max(transition, move);
+    starts.push(t);
+    leadIns.push(lead);
+    t += lead + shot.hold;
+  });
+  return { starts, leadIns, total: t };
+}
+
+// src/effects/template-tools.ts
+var unavailable = (provider) => !provider ? "No effects provider is registered, so there are no sequence templates." : !provider.capabilities.supportsTemplates || !provider.listTemplates ? `${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).` : null;
+function effectTemplateTools(host, ctx) {
+  const require2 = () => {
+    const provider = host.provider();
+    const reason = unavailable(provider);
+    if (reason) throw new Error(reason);
+    return provider;
+  };
+  return [
+    {
+      name: "list_templates",
+      title: "List sequence templates",
+      description: "Lists the effects provider's sequence templates (ready-made scenes of several shots with slots to fill: a product reveal, before and after, a stat countdown\u2026), best match first: { available, templates: [{ id, name, description, tags, shots, durationMs }] }. Then describe_template for a template's slots and fill_template to use it. Without a provider that has templates it returns available: false and the reason.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Words to match in the name, id, tags or description (default: every template)." },
+          tags: { type: "array", items: { type: "string", minLength: 1 }, description: "Only templates carrying every one of these tags." },
+          limit: { type: "integer", minimum: 1, maximum: 100, description: "Most templates to return (default all)." }
+        },
+        additionalProperties: false
+      },
+      annotations: { title: "List sequence templates", ...ctx.annotations.read },
+      handler: async ({ query, tags, limit }) => {
+        const provider = host.provider();
+        const reason = unavailable(provider);
+        if (reason) return { available: false, reason, templates: [] };
+        return { available: true, provider: provider.name, templates: await provider.listTemplates({ ...query ? { query } : {}, ...tags ? { tags } : {}, ...limit ? { limit } : {} }) };
+      }
+    },
+    {
+      name: "describe_template",
+      title: "Describe a sequence template",
+      description: `Describes a template's slots in the order a form shows them: { id, name, description, shots, slots: [{ name, type (image, video, svg, text, color, number), label, description, default or hasDefault, maxLength, min, max, integer }], slotSummaries (one line each), valuesSchema (the JSON Schema fill_template's values follow), exampleValues (the text, colour and number defaults, to change) }. Subject slots (image, video, svg) take a URL, markup, or { "slot": name } to leave them for the host.`,
+      inputSchema: { type: "object", properties: { template: { type: "string", minLength: 1, description: "A template id from list_templates." } }, required: ["template"], additionalProperties: false },
+      annotations: { title: "Describe a sequence template", ...ctx.annotations.read },
+      handler: async ({ template }) => {
+        const d = await require2().describeTemplate(template);
+        return { ...d, slotSummaries: d.slots.map(templateSlotSummary), valuesSchema: templateValuesSchema(d.slots), exampleValues: templateDefaultValues(d.slots) };
+      }
+    },
+    {
+      name: "fill_template",
+      title: "Fill a sequence template",
+      description: `Fills a template's slots and loads the result. ${host.fillDetails} Slots left out take their defaults. Values are checked first: every value that does not fit (an unknown slot, a wrong type, a number out of range, text too long) is refused at once, naming what the slot takes, and nothing changes. One undo step. Subject slots left open draw nothing until filled; the result's openSlots says which.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          template: { type: "string", minLength: 1, description: "A template id from list_templates." },
+          values: { type: "object", description: "Slot values by name, following describe_template's valuesSchema (default: every slot's default)." },
+          name: { type: "string", pattern: "^[a-z0-9]+(?:-[a-z0-9]+)*$", description: "A name for the result: lowercase words and dashes (default the template's)." },
+          ..._nullishCoalesce(host.fillOptions, () => ( {}))
+        },
+        required: ["template"],
+        additionalProperties: false
+      },
+      annotations: { title: "Fill a sequence template", ...ctx.annotations.write },
+      handler: async ({ template, values, ...options }) => {
+        require2();
+        return host.fill(template, _nullishCoalesce(values, () => ( {})), options);
+      }
+    }
+  ];
+}
+
+
+
+
 
 
 
@@ -252,4 +356,4 @@ function effectSequenceSlots(sequence) {
 
 
 
-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;
+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; exports.fillEffectTemplate = fillEffectTemplate; exports.effectLayerSpan = effectLayerSpan; exports.effectSequenceTiming = effectSequenceTiming; exports.effectTemplateTools = effectTemplateTools;