@pixerate/editor 0.252.0 → 0.254.0

package/dist/{chunk-Z3BRH4JK.cjs → chunk-557BDWKO.cjs}

@@ -4,7 +4,7 @@
 
 
 
-var _chunkISIO63Q5cjs = require('./chunk-ISIO63Q5.cjs');
+var _chunkL2JTLW6Bcjs = require('./chunk-L2JTLW6B.cjs');
 
 // src/effects/templates.ts
 var SLOT_NAME = /^[A-Za-z][\w-]*$/;
@@ -133,7 +133,7 @@ function searchTemplateSummaries(catalog, options = {}) {
   const words = (_nullishCoalesce(options.query, () => ( ""))).toLowerCase().split(/\s+/).filter(Boolean);
   const scored = [];
   for (const t of catalog) {
-    if (!_chunkISIO63Q5cjs.hasEffectTags.call(void 0, t, options.tags)) continue;
+    if (!_chunkL2JTLW6Bcjs.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();
@@ -200,7 +200,7 @@ function checkEffectSequence(sequence, catalog) {
           const p = effectSubjectProblem(layer.subject);
           if (p) problems.push(`${where}: ${p}.`);
         }
-        if (layer.role !== void 0 && !_chunkISIO63Q5cjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${_chunkISIO63Q5cjs.EFFECT_LAYER_ROLES.join(", ")}.`);
+        if (layer.role !== void 0 && !_chunkL2JTLW6Bcjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${_chunkL2JTLW6Bcjs.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.`);
@@ -235,8 +235,8 @@ function effectSequenceSlots(sequence) {
   return [...out];
 }
 async function fillEffectTemplate(provider, id, values = {}, options = {}) {
-  if (!provider) throw new (0, _chunkISIO63Q5cjs.NoEffectsProviderError)();
-  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new (0, _chunkISIO63Q5cjs.EffectUnsupportedError)(`${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).`);
+  if (!provider) throw new (0, _chunkL2JTLW6Bcjs.NoEffectsProviderError)();
+  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new (0, _chunkL2JTLW6Bcjs.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.`);
@@ -256,7 +256,7 @@ function effectSequenceTiming(sequence) {
   const leadIns = [];
   let t = 0;
   sequence.shots.forEach((shot, i) => {
-    const transition = i > 0 && shot.transition ? _nullishCoalesce(shot.transition.ms, () => ( _chunkISIO63Q5cjs.EFFECT_TRANSITION_MS)) : 0;
+    const transition = i > 0 && shot.transition ? _nullishCoalesce(shot.transition.ms, () => ( _chunkL2JTLW6Bcjs.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);

package/dist/{chunk-ZBCT5MEA.cjs → chunk-CBVNCWJM.cjs}

@@ -7,7 +7,7 @@ var _chunkPY4GWSE2cjs = require('./chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkISIO63Q5cjs = require('./chunk-ISIO63Q5.cjs');
+var _chunkL2JTLW6Bcjs = require('./chunk-L2JTLW6B.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 = _chunkISIO63Q5cjs.createEffectPixels.call(void 0, a.width, a.height);
+  const out = _chunkL2JTLW6Bcjs.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 = _chunkISIO63Q5cjs.createEffectPixels.call(void 0, base.width, base.height);
+  const out = _chunkL2JTLW6Bcjs.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, _chunkISIO63Q5cjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkL2JTLW6Bcjs.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, _chunkISIO63Q5cjs.EffectUnsupportedError)(
+    throw new (0, _chunkL2JTLW6Bcjs.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 _chunkISIO63Q5cjs.effectValueErrors.call(void 0, d, plain)) {
+  for (const e of _chunkL2JTLW6Bcjs.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, _chunkISIO63Q5cjs.EffectControlError)(d.id, errors);
+  if (errors.length) throw new (0, _chunkL2JTLW6Bcjs.EffectControlError)(d.id, errors);
   return { ..._nullishCoalesce(options.base, () => ( d.defaults)), ..._nullishCoalesce(values, () => ( {})) };
 }
 

package/dist/{chunk-226QDRO3.js → chunk-DHQPRKXF.js}

@@ -4,7 +4,7 @@ import {
   EffectUnsupportedError,
   NoEffectsProviderError,
   hasEffectTags
-} from "./chunk-JA57JIT5.js";
+} from "./chunk-MV7CYFMJ.js";
 
 // src/effects/templates.ts
 var SLOT_NAME = /^[A-Za-z][\w-]*$/;

package/dist/{chunk-ABL7IWFZ.js → chunk-GBEF2D4P.js}

@@ -3,7 +3,7 @@ import {
   EffectDisposedError,
   EffectUnsupportedError,
   effectValueErrors
-} from "./chunk-JA57JIT5.js";
+} from "./chunk-MV7CYFMJ.js";
 import {
   HistoryManager
 } from "./chunk-NS62CQ2B.js";

package/dist/{chunk-ISIO63Q5.cjs → chunk-L2JTLW6B.cjs}

@@ -3,11 +3,15 @@
 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 EFFECT_KINDS = ["shader", "vector", "motion", "camera", "timing"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera", "timing"];
 var CAMERA_MOVE_ROLES = ["transition", "hold"];
 var EFFECT_ACCEPTS = ["path"];
 var EFFECT_PATH_FORMAT = "svg-path";
+var TIMING_DEFAULT_FPS = 30;
+var TIMING_MAX_FRAMES = 128;
+var TIMING_MAX_FPS = 240;
+var TIMING_BLENDS = ["average", "lighten"];
 var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
 var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
 var EFFECT_TRANSITION_MS = 800;
@@ -87,17 +91,18 @@ function resolveEffectValues(description, values) {
   if (errors.length) throw new EffectControlError(description.id, errors);
   return { ...description.defaults, ..._nullishCoalesce(values, () => ( {})) };
 }
+var PIXELLESS_KINDS = ["motion", "camera", "timing"];
 function effectOffered(e, uses) {
-  if (!uses) return e.kind !== "motion" && e.kind !== "camera";
-  if (e.kind === "motion" && !uses.includes("motion")) return false;
-  if (e.kind === "camera" && !uses.includes("camera")) return false;
+  const pixelless = PIXELLESS_KINDS.includes(e.kind);
+  if (!uses) return !pixelless;
+  if (pixelless && !uses.includes(e.kind)) return false;
   return e.uses.some((u) => uses.includes(u));
 }
 function normaliseEffectTag(tag) {
   return tag.trim().toLowerCase().replace(/[\s_-]+/g, "-");
 }
 function hasEffectTags(e, tags) {
-  if (!_optionalChain([tags, 'optionalAccess', _ => _.length])) return true;
+  if (!_optionalChain([tags, 'optionalAccess', _2 => _2.length])) return true;
   const own = new Set((_nullishCoalesce(e.tags, () => ( []))).map(normaliseEffectTag));
   return tags.every((t) => own.has(normaliseEffectTag(t)));
 }
@@ -106,10 +111,10 @@ function countEffectTags(effects) {
   for (const e of effects) for (const tag of new Set((_nullishCoalesce(e.tags, () => ( []))).map(normaliseEffectTag))) if (tag) counts.set(tag, (_nullishCoalesce(counts.get(tag), () => ( 0))) + 1);
   return [...counts].map(([tag, count]) => ({ tag, count })).sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
 }
-var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags) && (!_optionalChain([o, 'access', _2 => _2.accepts, 'optionalAccess', _3 => _3.length]) || o.accepts.every((a) => _optionalChain([e, 'access', _4 => _4.accepts, 'optionalAccess', _5 => _5.includes, 'call', _6 => _6(a)])));
+var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags) && (!_optionalChain([o, 'access', _3 => _3.accepts, 'optionalAccess', _4 => _4.length]) || o.accepts.every((a) => _optionalChain([e, 'access', _5 => _5.accepts, 'optionalAccess', _6 => _6.includes, 'call', _7 => _7(a)])));
 function pathControlsOf(d) {
   const isPath = (s) => !!s && (s.format === EFFECT_PATH_FORMAT || [..._nullishCoalesce(s.anyOf, () => ( [])), ..._nullishCoalesce(s.oneOf, () => ( []))].some((x) => isPath(x)));
-  return Object.entries(_nullishCoalesce(_optionalChain([d, 'access', _7 => _7.controls, 'optionalAccess', _8 => _8.properties]), () => ( {}))).filter(([, s]) => isPath(s)).map(([name]) => name);
+  return Object.entries(_nullishCoalesce(_optionalChain([d, 'access', _8 => _8.controls, 'optionalAccess', _9 => _9.properties]), () => ( {}))).filter(([, s]) => isPath(s)).map(([name]) => name);
 }
 function searchEffectSummaries(catalog, query = "", options = {}) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
@@ -170,7 +175,7 @@ function applyEffectMask(result, mask, source) {
 }
 function layerImageInput(d) {
   const images = d.inputs.filter((i) => i.kind === "image");
-  return _nullishCoalesce(_optionalChain([(_nullishCoalesce(_nullishCoalesce(images.find((i) => i.name === "source"), () => ( images.find((i) => i.required))), () => ( images[0]))), 'optionalAccess', _9 => _9.name]), () => ( null));
+  return _nullishCoalesce(_optionalChain([(_nullishCoalesce(_nullishCoalesce(images.find((i) => i.name === "source"), () => ( images.find((i) => i.required))), () => ( images[0]))), 'optionalAccess', _10 => _10.name]), () => ( null));
 }
 var EffectsSlot = (_class = class {constructor() { _class.prototype.__init.call(this);_class.prototype.__init2.call(this); }
   __init() {this.current = null}
@@ -238,7 +243,7 @@ async function sampleEffectCameraMove(provider, id, request) {
 }
 var cameraMoveField = (role) => role === "transition" ? "in" : "during";
 function cameraMovesFor(catalog, role) {
-  return catalog.filter((e) => e.kind === "camera" && _optionalChain([e, 'access', _10 => _10.camera, 'optionalAccess', _11 => _11.role]) === role);
+  return catalog.filter((e) => e.kind === "camera" && _optionalChain([e, 'access', _11 => _11.camera, 'optionalAccess', _12 => _12.role]) === role);
 }
 function cameraMoveIdList(catalog, role) {
   const ids = cameraMovesFor(catalog, role).map((e) => JSON.stringify(e.id));
@@ -299,6 +304,117 @@ function cameraBoxOfView(view, stage) {
   const height = stage.height / view.zoom;
   return { x: -view.scrollX, y: -view.scrollY, width, height };
 }
+function checkTimingFootage(footageMs, id) {
+  if (typeof footageMs !== "number" || !Number.isFinite(footageMs) || footageMs <= 0) {
+    throw new EffectUnsupportedError(`The footage's length is a number of ms above 0; it was ${String(footageMs)}.`, id);
+  }
+}
+function checkTimingRequest(request, id) {
+  if (!request || typeof request !== "object") throw new EffectUnsupportedError("A timing request is { time, footage, fps? }: ms into the retimed clip, the footage's length in ms, and its frame rate.", id);
+  checkTimingFootage(request.footage, id);
+  const fps = _nullishCoalesce(request.fps, () => ( TIMING_DEFAULT_FPS));
+  if (typeof fps !== "number" || !Number.isFinite(fps) || fps <= 0 || fps > TIMING_MAX_FPS) {
+    throw new EffectUnsupportedError(`The footage's frame rate is above 0 and at most ${TIMING_MAX_FPS} frames per second; it was ${String(fps)}.`, id);
+  }
+  if (typeof request.time !== "number" || !Number.isFinite(request.time)) throw new EffectUnsupportedError(`The time is a number of ms into the retimed clip; it was ${String(request.time)}.`, id);
+  return fps;
+}
+var lastFrameOf = (footageMs, fps) => Math.max(0, Math.ceil(footageMs * fps / 1e3 - 1e-9) - 1);
+function normaliseTimingSample(raw, request, blend = "average") {
+  const fps = _nullishCoalesce(request.fps, () => ( TIMING_DEFAULT_FPS));
+  const frameMs = 1e3 / fps;
+  const last = lastFrameOf(request.footage, fps);
+  const frameOf = (t) => Math.min(last, Math.max(0, Math.floor(t / frameMs + 1e-6)));
+  const weights = /* @__PURE__ */ new Map();
+  for (const f of raw) {
+    if (!Number.isFinite(f.time) || !Number.isFinite(f.weight) || f.weight <= 0) continue;
+    const i = frameOf(f.time);
+    weights.set(i, (_nullishCoalesce(weights.get(i), () => ( 0))) + f.weight);
+  }
+  if (!weights.size) weights.set(Number.isFinite(request.time) ? frameOf(request.time) : 0, 1);
+  let frames = [...weights.entries()].sort((a, b) => a[0] - b[0]);
+  if (frames.length > TIMING_MAX_FRAMES) {
+    const stride = frames.length / TIMING_MAX_FRAMES;
+    frames = Array.from({ length: TIMING_MAX_FRAMES }, (_, k) => frames[Math.floor(k * stride)]);
+  }
+  const total = frames.reduce((sum, [, w]) => sum + w, 0);
+  return { frames: frames.map(([i, w]) => ({ time: i * 1e3 / fps, weight: w / total })), blend };
+}
+function timingSampleProblems(sample, request) {
+  if (!sample || typeof sample !== "object") return ["the sample is not an object { frames, blend }"];
+  const { frames, blend } = sample;
+  const problems = [];
+  if (!TIMING_BLENDS.includes(blend)) problems.push(`blend "${String(blend)}" is not one of ${TIMING_BLENDS.join(", ")}`);
+  if (!Array.isArray(frames) || !frames.length) return [...problems, "frames must be a list of at least one { time, weight }"];
+  if (frames.length > TIMING_MAX_FRAMES) problems.push(`it has ${frames.length} frames; at most ${TIMING_MAX_FRAMES} are allowed`);
+  const fps = _nullishCoalesce(request.fps, () => ( TIMING_DEFAULT_FPS));
+  const last = lastFrameOf(request.footage, fps);
+  let total = 0;
+  let previous = -Infinity;
+  for (const f of frames) {
+    if (!f || !Number.isFinite(f.time) || !Number.isFinite(f.weight)) {
+      problems.push(`frame ${JSON.stringify(f)} needs a finite time and weight`);
+      continue;
+    }
+    const index = f.time * fps / 1e3;
+    if (Math.abs(index - Math.round(index)) > 1e-6) problems.push(`frame time ${f.time} is not the start of a frame at ${fps} fps (index \xD7 ${+(1e3 / fps).toFixed(6)} ms)`);
+    else if (Math.round(index) < 0 || Math.round(index) > last) problems.push(`frame time ${f.time} is outside the footage (frames 0 to ${last}, the last at ${+(last * 1e3 / fps).toFixed(6)} ms)`);
+    if (f.time <= previous) problems.push(`frame times must be distinct and earliest first; ${f.time} follows ${previous}`);
+    previous = f.time;
+    if (!(f.weight > 0)) problems.push(`frame at ${f.time} has weight ${f.weight}; weights are > 0`);
+    total += f.weight;
+  }
+  if (Math.abs(total - 1) > 1e-6) problems.push(`weights add up to ${total}, not 1`);
+  return problems;
+}
+function blendTimingFrames(frames, blend, out) {
+  if (!frames.length) throw new EffectUnsupportedError("There are no frames to blend; a timing sample has at least one.");
+  const { width, height } = frames[0].pixels;
+  for (const f of frames) {
+    if (f.pixels.width !== width || f.pixels.height !== height) throw new EffectUnsupportedError(`A ${f.pixels.width}\xD7${f.pixels.height} frame cannot be blended with ${width}\xD7${height} frames.`);
+  }
+  const target = _nullishCoalesce(out, () => ( createEffectPixels(width, height)));
+  if (target.width !== width || target.height !== height) throw new EffectUnsupportedError(`The output is ${target.width}\xD7${target.height}; the frames are ${width}\xD7${height}.`);
+  const o = target.data;
+  if (frames.length === 1) {
+    o.set(frames[0].pixels.data);
+    return target;
+  }
+  const s = new Float64Array(o.length);
+  if (blend === "lighten") {
+    const heaviest = Math.max(...frames.map((f) => f.weight));
+    for (const f of frames) {
+      const k = heaviest > 0 ? f.weight / heaviest : 1;
+      const p = f.pixels.data;
+      for (let i = 0; i < s.length; i += 4) {
+        const a = p[i + 3] / 255 * k;
+        for (let c = 0; c < 3; c++) if (p[i + c] * a > s[i + c]) s[i + c] = p[i + c] * a;
+        if (a > s[i + 3]) s[i + 3] = a;
+      }
+    }
+    for (let i = 0; i < s.length; i += 4) {
+      for (let c = 0; c < 3; c++) o[i + c] = Math.round(s[i + c]);
+      o[i + 3] = Math.round(s[i + 3] * 255);
+    }
+    return target;
+  }
+  let total = 0;
+  for (const f of frames) {
+    total += f.weight;
+    const p = f.pixels.data;
+    for (let i = 0; i < s.length; i += 4) {
+      const a = p[i + 3] * f.weight;
+      for (let c = 0; c < 3; c++) s[i + c] += p[i + c] * a;
+      s[i + 3] += a;
+    }
+  }
+  for (let i = 0; i < s.length; i += 4) {
+    const a = s[i + 3];
+    for (let c = 0; c < 3; c++) o[i + c] = a > 0 ? Math.round(s[i + c] / a) : 0;
+    o[i + 3] = total > 0 ? Math.round(a / total) : 0;
+  }
+  return target;
+}
 
 // src/effects/tools.ts
 var ANNOTATIONS = {
@@ -328,12 +444,12 @@ var summaryOut = (e) => ({
   category: e.category,
   uses: e.uses,
   ...e.description ? { description: e.description } : {},
-  ..._optionalChain([e, 'access', _12 => _12.tags, 'optionalAccess', _13 => _13.length]) ? { tags: e.tags } : {},
+  ..._optionalChain([e, 'access', _13 => _13.tags, 'optionalAccess', _14 => _14.length]) ? { tags: e.tags } : {},
   transparent: e.transparent,
   loop: e.loop,
   ...e.duration !== void 0 ? { duration: e.duration } : {},
   ...e.camera ? { camera: e.camera } : {},
-  ..._optionalChain([e, 'access', _14 => _14.accepts, 'optionalAccess', _15 => _15.length]) ? { accepts: e.accepts } : {}
+  ..._optionalChain([e, 'access', _15 => _15.accepts, 'optionalAccess', _16 => _16.length]) ? { accepts: e.accepts } : {}
 });
 function createEffectToolProvider(host) {
   let catalog = null;
@@ -341,7 +457,7 @@ function createEffectToolProvider(host) {
   const notify = () => listeners.forEach((l) => l());
   const catalogFor = (provider) => {
     if (!provider) return null;
-    if (_optionalChain([catalog, 'optionalAccess', _16 => _16.provider]) !== provider) {
+    if (_optionalChain([catalog, 'optionalAccess', _17 => _17.provider]) !== provider) {
       const entry = { provider, effects: null };
       catalog = entry;
       Promise.resolve().then(() => provider.list()).then((effects) => {
@@ -378,7 +494,7 @@ function createEffectToolProvider(host) {
   });
   const effectIdSchema = (uses) => {
     const open = host.applyImageInputs && uses === host.applyUses;
-    const effects = open ? void 0 : _optionalChain([catalogFor, 'call', _17 => _17(host.provider()), 'optionalAccess', _18 => _18.filter, 'call', _19 => _19((e) => effectOffered(e, uses))]);
+    const effects = open ? void 0 : _optionalChain([catalogFor, 'call', _18 => _18(host.provider()), 'optionalAccess', _19 => _19.filter, 'call', _20 => _20((e) => effectOffered(e, uses))]);
     const base = `An effect id from search_effects (use ${uses.map((u) => `"${u}"`).join(" or ")}${open ? `, or any effect whose describe_effect inputs take an image: the ${host.target.noun} is its picture` : ""}).`;
     return effects && effects.length && effects.length <= ENUM_LIMIT ? { type: "string", enum: effects.map((e) => e.id), description: `${base} One of: ${effects.map((e) => `${e.id} (${e.name})`).join(", ")}.` } : { type: "string", minLength: 1, description: base };
   };
@@ -392,12 +508,12 @@ function createEffectToolProvider(host) {
     {
       name: "search_effects",
       title: "Search effects",
-      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one), and accepts ["path"] for effects that draw along a path you give. For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves, accepts }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
+      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera, timing), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one), and accepts ["path"] for effects that draw along a path you give. For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves, accepts }] (timing effects, kind timing, retime video footage and have no duration: their length depends on the footage), total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
       inputSchema: object({
         query: { type: "string", description: "Words to match (default: every effect)." },
-        kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG), motion (animates vector art) or camera (moves a scene's camera; no pixels)." },
+        kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG), motion (animates vector art), camera (moves a scene's camera; no pixels) or timing (retimes video footage: slow motion, reverse, freeze, long exposure; no pixels of its own)." },
         category: { type: "string", minLength: 1, description: `The provider's category, e.g. "gradient", "light", "transition".` },
-        use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input, camera moves a scene's camera." },
+        use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input, camera moves a scene's camera, timing retimes video footage." },
         tags: { type: "array", items: { type: "string", minLength: 1 }, description: "Only effects carrying every one of these tags, as search_effects lists them (any case; spaces count as hyphens)." },
         limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." },
         accepts: { type: "array", items: { type: "string", enum: [...EFFECT_ACCEPTS], description: "path: the effect has a control that draws along a path given at run time." }, description: "Only effects that take every one of these (path: effects that draw along a path you give; describe_effect names the controls in pathControls)." }
@@ -408,8 +524,8 @@ function createEffectToolProvider(host) {
         if (!p) return { available: false, reason: NO_PROVIDER, effects: [], total: 0 };
         const tags = args.tags;
         const accepts = args.accepts;
-        let found = (await explain(async () => p.search(_nullishCoalesce(args.query, () => ( "")), { kind: args.kind, category: args.category, use: args.use, tags, ..._optionalChain([accepts, 'optionalAccess', _20 => _20.length]) ? { accepts } : {} }))).filter((e) => hasEffectTags(e, tags));
-        if (_optionalChain([accepts, 'optionalAccess', _21 => _21.includes, 'call', _22 => _22("path")])) {
+        let found = (await explain(async () => p.search(_nullishCoalesce(args.query, () => ( "")), { kind: args.kind, category: args.category, use: args.use, tags, ..._optionalChain([accepts, 'optionalAccess', _21 => _21.length]) ? { accepts } : {} }))).filter((e) => hasEffectTags(e, tags));
+        if (_optionalChain([accepts, 'optionalAccess', _22 => _22.includes, 'call', _23 => _23("path")])) {
           const kept = [];
           for (const e of found) {
             if (e.accepts) {
@@ -420,7 +536,7 @@ function createEffectToolProvider(host) {
         }
         const limit = _nullishCoalesce(args.limit, () => ( 20));
         const out = { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length, tags: countEffectTags(found).slice(0, TAG_LIMIT) };
-        if (_optionalChain([tags, 'optionalAccess', _23 => _23.length]) && !found.length) {
+        if (_optionalChain([tags, 'optionalAccess', _24 => _24.length]) && !found.length) {
           const known = countEffectTags(await explain(async () => p.list()));
           const have = new Set(known.map((k) => k.tag));
           const unknown = tags.filter((t) => !have.has(normaliseEffectTag(t)));
@@ -536,16 +652,16 @@ function createEffectToolProvider(host) {
     ...host.description ? { description: host.description } : {},
     ...host.skill ? { skill: host.skill } : {},
     tools: () => {
-      const extra = _nullishCoalesce(_optionalChain([host, 'access', _24 => _24.extraTools, 'optionalCall', _25 => _25(context)]), () => ( []));
-      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _26 => _26.annotations, 'optionalAccess', _27 => _27.readOnlyHint]))];
+      const extra = _nullishCoalesce(_optionalChain([host, 'access', _25 => _25.extraTools, 'optionalCall', _26 => _26(context)]), () => ( []));
+      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _27 => _27.annotations, 'optionalAccess', _28 => _28.readOnlyHint]))];
       return [...readTools(), ...writeTools(), ...extra];
     },
     subscribe: (l) => {
       listeners.add(l);
-      const off = _optionalChain([host, 'access', _28 => _28.subscribe, 'optionalCall', _29 => _29(l)]);
+      const off = _optionalChain([host, 'access', _29 => _29.subscribe, 'optionalCall', _30 => _30(l)]);
       return () => {
         listeners.delete(l);
-        _optionalChain([off, 'optionalCall', _30 => _30()]);
+        _optionalChain([off, 'optionalCall', _31 => _31()]);
       };
     }
   };
@@ -598,4 +714,13 @@ function createEffectToolProvider(host) {
 
 
 
-exports.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.EFFECT_ACCEPTS = EFFECT_ACCEPTS; exports.EFFECT_PATH_FORMAT = EFFECT_PATH_FORMAT; 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.pathControlsOf = pathControlsOf; exports.searchEffectSummaries = searchEffectSummaries; exports.createEffectPixels = createEffectPixels; exports.isEffectPixels = isEffectPixels; exports.srgbToLinear = srgbToLinear; exports.linearToSrgb = linearToSrgb; exports.encodeEffectFloat = encodeEffectFloat; exports.applyEffectMask = applyEffectMask; exports.layerImageInput = layerImageInput; 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;
+
+
+
+
+
+
+
+
+
+exports.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.EFFECT_ACCEPTS = EFFECT_ACCEPTS; exports.EFFECT_PATH_FORMAT = EFFECT_PATH_FORMAT; exports.TIMING_DEFAULT_FPS = TIMING_DEFAULT_FPS; exports.TIMING_MAX_FRAMES = TIMING_MAX_FRAMES; exports.TIMING_MAX_FPS = TIMING_MAX_FPS; exports.TIMING_BLENDS = TIMING_BLENDS; 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.pathControlsOf = pathControlsOf; exports.searchEffectSummaries = searchEffectSummaries; exports.createEffectPixels = createEffectPixels; exports.isEffectPixels = isEffectPixels; exports.srgbToLinear = srgbToLinear; exports.linearToSrgb = linearToSrgb; exports.encodeEffectFloat = encodeEffectFloat; exports.applyEffectMask = applyEffectMask; exports.layerImageInput = layerImageInput; 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.checkTimingFootage = checkTimingFootage; exports.checkTimingRequest = checkTimingRequest; exports.normaliseTimingSample = normaliseTimingSample; exports.timingSampleProblems = timingSampleProblems; exports.blendTimingFrames = blendTimingFrames; exports.createEffectToolProvider = createEffectToolProvider;

package/dist/{chunk-JA57JIT5.js → chunk-MV7CYFMJ.js}

@@ -3,11 +3,15 @@ import {
 } 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 EFFECT_KINDS = ["shader", "vector", "motion", "camera", "timing"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera", "timing"];
 var CAMERA_MOVE_ROLES = ["transition", "hold"];
 var EFFECT_ACCEPTS = ["path"];
 var EFFECT_PATH_FORMAT = "svg-path";
+var TIMING_DEFAULT_FPS = 30;
+var TIMING_MAX_FRAMES = 128;
+var TIMING_MAX_FPS = 240;
+var TIMING_BLENDS = ["average", "lighten"];
 var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
 var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
 var EFFECT_TRANSITION_MS = 800;
@@ -87,10 +91,11 @@ function resolveEffectValues(description, values) {
   if (errors.length) throw new EffectControlError(description.id, errors);
   return { ...description.defaults, ...values ?? {} };
 }
+var PIXELLESS_KINDS = ["motion", "camera", "timing"];
 function effectOffered(e, uses) {
-  if (!uses) return e.kind !== "motion" && e.kind !== "camera";
-  if (e.kind === "motion" && !uses.includes("motion")) return false;
-  if (e.kind === "camera" && !uses.includes("camera")) return false;
+  const pixelless = PIXELLESS_KINDS.includes(e.kind);
+  if (!uses) return !pixelless;
+  if (pixelless && !uses.includes(e.kind)) return false;
   return e.uses.some((u) => uses.includes(u));
 }
 function normaliseEffectTag(tag) {
@@ -299,6 +304,117 @@ function cameraBoxOfView(view, stage) {
   const height = stage.height / view.zoom;
   return { x: -view.scrollX, y: -view.scrollY, width, height };
 }
+function checkTimingFootage(footageMs, id) {
+  if (typeof footageMs !== "number" || !Number.isFinite(footageMs) || footageMs <= 0) {
+    throw new EffectUnsupportedError(`The footage's length is a number of ms above 0; it was ${String(footageMs)}.`, id);
+  }
+}
+function checkTimingRequest(request, id) {
+  if (!request || typeof request !== "object") throw new EffectUnsupportedError("A timing request is { time, footage, fps? }: ms into the retimed clip, the footage's length in ms, and its frame rate.", id);
+  checkTimingFootage(request.footage, id);
+  const fps = request.fps ?? TIMING_DEFAULT_FPS;
+  if (typeof fps !== "number" || !Number.isFinite(fps) || fps <= 0 || fps > TIMING_MAX_FPS) {
+    throw new EffectUnsupportedError(`The footage's frame rate is above 0 and at most ${TIMING_MAX_FPS} frames per second; it was ${String(fps)}.`, id);
+  }
+  if (typeof request.time !== "number" || !Number.isFinite(request.time)) throw new EffectUnsupportedError(`The time is a number of ms into the retimed clip; it was ${String(request.time)}.`, id);
+  return fps;
+}
+var lastFrameOf = (footageMs, fps) => Math.max(0, Math.ceil(footageMs * fps / 1e3 - 1e-9) - 1);
+function normaliseTimingSample(raw, request, blend = "average") {
+  const fps = request.fps ?? TIMING_DEFAULT_FPS;
+  const frameMs = 1e3 / fps;
+  const last = lastFrameOf(request.footage, fps);
+  const frameOf = (t) => Math.min(last, Math.max(0, Math.floor(t / frameMs + 1e-6)));
+  const weights = /* @__PURE__ */ new Map();
+  for (const f of raw) {
+    if (!Number.isFinite(f.time) || !Number.isFinite(f.weight) || f.weight <= 0) continue;
+    const i = frameOf(f.time);
+    weights.set(i, (weights.get(i) ?? 0) + f.weight);
+  }
+  if (!weights.size) weights.set(Number.isFinite(request.time) ? frameOf(request.time) : 0, 1);
+  let frames = [...weights.entries()].sort((a, b) => a[0] - b[0]);
+  if (frames.length > TIMING_MAX_FRAMES) {
+    const stride = frames.length / TIMING_MAX_FRAMES;
+    frames = Array.from({ length: TIMING_MAX_FRAMES }, (_, k) => frames[Math.floor(k * stride)]);
+  }
+  const total = frames.reduce((sum, [, w]) => sum + w, 0);
+  return { frames: frames.map(([i, w]) => ({ time: i * 1e3 / fps, weight: w / total })), blend };
+}
+function timingSampleProblems(sample, request) {
+  if (!sample || typeof sample !== "object") return ["the sample is not an object { frames, blend }"];
+  const { frames, blend } = sample;
+  const problems = [];
+  if (!TIMING_BLENDS.includes(blend)) problems.push(`blend "${String(blend)}" is not one of ${TIMING_BLENDS.join(", ")}`);
+  if (!Array.isArray(frames) || !frames.length) return [...problems, "frames must be a list of at least one { time, weight }"];
+  if (frames.length > TIMING_MAX_FRAMES) problems.push(`it has ${frames.length} frames; at most ${TIMING_MAX_FRAMES} are allowed`);
+  const fps = request.fps ?? TIMING_DEFAULT_FPS;
+  const last = lastFrameOf(request.footage, fps);
+  let total = 0;
+  let previous = -Infinity;
+  for (const f of frames) {
+    if (!f || !Number.isFinite(f.time) || !Number.isFinite(f.weight)) {
+      problems.push(`frame ${JSON.stringify(f)} needs a finite time and weight`);
+      continue;
+    }
+    const index = f.time * fps / 1e3;
+    if (Math.abs(index - Math.round(index)) > 1e-6) problems.push(`frame time ${f.time} is not the start of a frame at ${fps} fps (index \xD7 ${+(1e3 / fps).toFixed(6)} ms)`);
+    else if (Math.round(index) < 0 || Math.round(index) > last) problems.push(`frame time ${f.time} is outside the footage (frames 0 to ${last}, the last at ${+(last * 1e3 / fps).toFixed(6)} ms)`);
+    if (f.time <= previous) problems.push(`frame times must be distinct and earliest first; ${f.time} follows ${previous}`);
+    previous = f.time;
+    if (!(f.weight > 0)) problems.push(`frame at ${f.time} has weight ${f.weight}; weights are > 0`);
+    total += f.weight;
+  }
+  if (Math.abs(total - 1) > 1e-6) problems.push(`weights add up to ${total}, not 1`);
+  return problems;
+}
+function blendTimingFrames(frames, blend, out) {
+  if (!frames.length) throw new EffectUnsupportedError("There are no frames to blend; a timing sample has at least one.");
+  const { width, height } = frames[0].pixels;
+  for (const f of frames) {
+    if (f.pixels.width !== width || f.pixels.height !== height) throw new EffectUnsupportedError(`A ${f.pixels.width}\xD7${f.pixels.height} frame cannot be blended with ${width}\xD7${height} frames.`);
+  }
+  const target = out ?? createEffectPixels(width, height);
+  if (target.width !== width || target.height !== height) throw new EffectUnsupportedError(`The output is ${target.width}\xD7${target.height}; the frames are ${width}\xD7${height}.`);
+  const o = target.data;
+  if (frames.length === 1) {
+    o.set(frames[0].pixels.data);
+    return target;
+  }
+  const s = new Float64Array(o.length);
+  if (blend === "lighten") {
+    const heaviest = Math.max(...frames.map((f) => f.weight));
+    for (const f of frames) {
+      const k = heaviest > 0 ? f.weight / heaviest : 1;
+      const p = f.pixels.data;
+      for (let i = 0; i < s.length; i += 4) {
+        const a = p[i + 3] / 255 * k;
+        for (let c = 0; c < 3; c++) if (p[i + c] * a > s[i + c]) s[i + c] = p[i + c] * a;
+        if (a > s[i + 3]) s[i + 3] = a;
+      }
+    }
+    for (let i = 0; i < s.length; i += 4) {
+      for (let c = 0; c < 3; c++) o[i + c] = Math.round(s[i + c]);
+      o[i + 3] = Math.round(s[i + 3] * 255);
+    }
+    return target;
+  }
+  let total = 0;
+  for (const f of frames) {
+    total += f.weight;
+    const p = f.pixels.data;
+    for (let i = 0; i < s.length; i += 4) {
+      const a = p[i + 3] * f.weight;
+      for (let c = 0; c < 3; c++) s[i + c] += p[i + c] * a;
+      s[i + 3] += a;
+    }
+  }
+  for (let i = 0; i < s.length; i += 4) {
+    const a = s[i + 3];
+    for (let c = 0; c < 3; c++) o[i + c] = a > 0 ? Math.round(s[i + c] / a) : 0;
+    o[i + 3] = total > 0 ? Math.round(a / total) : 0;
+  }
+  return target;
+}
 
 // src/effects/tools.ts
 var ANNOTATIONS = {
@@ -392,12 +508,12 @@ function createEffectToolProvider(host) {
     {
       name: "search_effects",
       title: "Search effects",
-      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one), and accepts ["path"] for effects that draw along a path you give. For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves, accepts }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
+      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera, timing), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one), and accepts ["path"] for effects that draw along a path you give. For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves, accepts }] (timing effects, kind timing, retime video footage and have no duration: their length depends on the footage), total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
       inputSchema: object({
         query: { type: "string", description: "Words to match (default: every effect)." },
-        kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG), motion (animates vector art) or camera (moves a scene's camera; no pixels)." },
+        kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG), motion (animates vector art), camera (moves a scene's camera; no pixels) or timing (retimes video footage: slow motion, reverse, freeze, long exposure; no pixels of its own)." },
         category: { type: "string", minLength: 1, description: `The provider's category, e.g. "gradient", "light", "transition".` },
-        use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input, camera moves a scene's camera." },
+        use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input, camera moves a scene's camera, timing retimes video footage." },
         tags: { type: "array", items: { type: "string", minLength: 1 }, description: "Only effects carrying every one of these tags, as search_effects lists them (any case; spaces count as hyphens)." },
         limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." },
         accepts: { type: "array", items: { type: "string", enum: [...EFFECT_ACCEPTS], description: "path: the effect has a control that draws along a path given at run time." }, description: "Only effects that take every one of these (path: effects that draw along a path you give; describe_effect names the controls in pathControls)." }
@@ -557,6 +673,10 @@ export {
   CAMERA_MOVE_ROLES,
   EFFECT_ACCEPTS,
   EFFECT_PATH_FORMAT,
+  TIMING_DEFAULT_FPS,
+  TIMING_MAX_FRAMES,
+  TIMING_MAX_FPS,
+  TIMING_BLENDS,
   EFFECT_SUBJECT_KINDS,
   EFFECT_LAYER_ROLES,
   EFFECT_TRANSITION_MS,
@@ -597,5 +717,10 @@ export {
   resolveCameraMoveSpec,
   cameraViewOfBox,
   cameraBoxOfView,
+  checkTimingFootage,
+  checkTimingRequest,
+  normaliseTimingSample,
+  timingSampleProblems,
+  blendTimingFrames,
   createEffectToolProvider
 };

package/dist/{chunk-5E2Q7ZHI.js → chunk-MWUZCEFT.js}

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