@pixerate/editor 0.253.0 → 0.254.1

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";

package/dist/effects/conformance.d.cts

@@ -22,4 +22,5 @@ export interface EffectConformanceOptions {
     /** 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

@@ -22,4 +22,5 @@ export interface EffectConformanceOptions {
     /** 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/fake.d.cts

@@ -17,6 +17,10 @@
  * 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 `timing: true` it also has timing effects (no pixels; they retime video footage): `speed`
+ * (slow or fast, blending frames), `freeze` (holds one frame, then plays on) and `echo` (fading
+ * copies of the frames before, averaged or lightened).
+ *
  * With `templates: true` it also has two sequence templates (see `fake-templates.ts`):
  * `fake.title-sequence` and `fake.picture-reveal`.
  */
@@ -30,8 +34,10 @@ export interface FakeEffectProviderOptions {
     authoring?: boolean;
     /** Adds the camera moves and `cameraView` / `sampleCameraMove` (default false). */
     camera?: boolean;
+    /** Adds the timing effects and `timingLength` / `timingSample` (default false). */
+    timing?: boolean;
     /** Adds two sequence templates and `listTemplates` / `describeTemplate` / `instantiateTemplate` (default false). */
     templates?: boolean;
 }
-/** A deterministic CPU effects provider with seven effects, and camera moves and templates on request (see the module comment). */
+/** A deterministic CPU effects provider with nine effects, and camera moves, timing effects and templates on request (see the module comment). */
 export declare function createFakeEffectProvider(options?: FakeEffectProviderOptions): EffectProvider;

package/dist/effects/fake.d.ts

@@ -17,6 +17,10 @@
  * 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 `timing: true` it also has timing effects (no pixels; they retime video footage): `speed`
+ * (slow or fast, blending frames), `freeze` (holds one frame, then plays on) and `echo` (fading
+ * copies of the frames before, averaged or lightened).
+ *
  * With `templates: true` it also has two sequence templates (see `fake-templates.ts`):
  * `fake.title-sequence` and `fake.picture-reveal`.
  */
@@ -30,8 +34,10 @@ export interface FakeEffectProviderOptions {
     authoring?: boolean;
     /** Adds the camera moves and `cameraView` / `sampleCameraMove` (default false). */
     camera?: boolean;
+    /** Adds the timing effects and `timingLength` / `timingSample` (default false). */
+    timing?: boolean;
     /** Adds two sequence templates and `listTemplates` / `describeTemplate` / `instantiateTemplate` (default false). */
     templates?: boolean;
 }
-/** A deterministic CPU effects provider with seven effects, and camera moves and templates on request (see the module comment). */
+/** A deterministic CPU effects provider with nine effects, and camera moves, timing effects and templates on request (see the module comment). */
 export declare function createFakeEffectProvider(options?: FakeEffectProviderOptions): EffectProvider;

package/dist/effects/helpers.d.cts

@@ -3,7 +3,7 @@
  * and a provider slot editors hold.
  */
 import { type SchemaValidationError } from '../tools/schema.cjs';
-import type { CameraMoveRole, CameraMoveSpec, CameraMoveSample, CameraMoveSampleRequest, CameraStage, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues } from './types.cjs';
+import type { CameraMoveRole, CameraMoveSpec, CameraMoveSample, CameraMoveSampleRequest, CameraStage, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues, TimingBlend, TimingFrame, TimingSample, TimingSampleRequest } from './types.cjs';
 /** Problems with `values` against an effect's control schema (unknown controls, types, ranges). Partial values are fine. */
 export declare function effectValueErrors(description: Pick<EffectDescription, 'controls'>, values: unknown): SchemaValidationError[];
 /**
@@ -13,9 +13,9 @@ export declare function effectValueErrors(description: Pick<EffectDescription, '
  */
 export declare function resolveEffectValues(description: Pick<EffectDescription, 'id' | 'controls' | 'defaults'>, values?: EffectValues): Record<string, EffectValues[string]>;
 /**
- * Whether an editor offering `uses` should offer `e` (in a picker or an `effect` enum). Motion
- * and camera effects draw no picture of their own, so they are offered only where `uses` names
- * them (`motion`, `camera`); with no `uses`, every other effect is.
+ * Whether an editor offering `uses` should offer `e` (in a picker or an `effect` enum). Motion,
+ * camera and timing effects draw no picture of their own, so they are offered only where `uses`
+ * names them (`motion`, `camera`, `timing`); with no `uses`, every other effect is.
  */
 export declare function effectOffered(e: Pick<EffectSummary, 'kind' | 'uses'>, uses?: readonly EffectUse[]): boolean;
 /** A tag as tags are compared: trimmed, lower case, spaces and underscores as single hyphens (`"Game Boy"` → `game-boy`). */
@@ -128,3 +128,35 @@ export interface CameraBox {
 export declare function cameraViewOfBox(box: CameraBox, stage: CameraStage): CameraView;
 /** The box of the scene a view shows on `stage` (its tilt, turn, roll and blur aside). */
 export declare function cameraBoxOfView(view: CameraView, stage: CameraStage): CameraBox;
+/** Throws `EffectUnsupportedError` unless `footageMs` is a footage length a timing effect takes (a number of ms > 0). */
+export declare function checkTimingFootage(footageMs: number, id?: string): void;
+/**
+ * Checks a timing request (footage, time and fps), throwing `EffectUnsupportedError` with a
+ * sentence naming the valid range, and gives its fps (default `TIMING_DEFAULT_FPS`).
+ */
+export declare function checkTimingRequest(request: TimingSampleRequest, id?: string): number;
+/**
+ * Raw footage frames (any times, any positive weights) as a `TimingSample`: each time held within
+ * the footage and moved to the start of its frame, frames on the same footage frame merged, at
+ * most `TIMING_MAX_FRAMES` (evenly spaced), weights scaled to add up to 1, earliest first. Frames
+ * with a time or weight that is not a finite number, or a weight ≤ 0, are dropped; with none left,
+ * the sample is the frame at `request.time`. Providers can build `timingSample` on it.
+ */
+export declare function normaliseTimingSample(raw: readonly TimingFrame[], request: TimingSampleRequest, blend?: TimingBlend): TimingSample;
+/**
+ * What is wrong with `sample` as the answer to `request` (see `TimingSample`), as sentences; empty
+ * when it keeps every rule. `checkEffectProvider` uses it; hosts can check a provider's samples
+ * with it.
+ */
+export declare function timingSampleProblems(sample: unknown, request: TimingSampleRequest): string[];
+/**
+ * Blends footage frames by weight as a timing sample says (see `TimingBlend`): the reference for
+ * hosts that blend in their own pipeline, and a ready blend for `EffectPixels`. Reads and writes
+ * 8-bit `data` (straight alpha, rounded); `float` is not used. Writes into `out` when given (the
+ * frames' size), else a new picture. Throws `EffectUnsupportedError` for no frames or frames of
+ * different sizes.
+ */
+export declare function blendTimingFrames(frames: readonly {
+    pixels: EffectPixels;
+    weight: number;
+}[], blend: TimingBlend, out?: EffectPixels): EffectPixels;

package/dist/effects/helpers.d.ts

@@ -3,7 +3,7 @@
  * and a provider slot editors hold.
  */
 import { type SchemaValidationError } from '../tools/schema.js';
-import type { CameraMoveRole, CameraMoveSpec, CameraMoveSample, CameraMoveSampleRequest, CameraStage, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues } from './types.js';
+import type { CameraMoveRole, CameraMoveSpec, CameraMoveSample, CameraMoveSampleRequest, CameraStage, CameraView, EffectDescription, EffectImageSource, EffectPixels, EffectProvider, EffectSearchOptions, EffectSummary, EffectUse, EffectValues, TimingBlend, TimingFrame, TimingSample, TimingSampleRequest } from './types.js';
 /** Problems with `values` against an effect's control schema (unknown controls, types, ranges). Partial values are fine. */
 export declare function effectValueErrors(description: Pick<EffectDescription, 'controls'>, values: unknown): SchemaValidationError[];
 /**
@@ -13,9 +13,9 @@ export declare function effectValueErrors(description: Pick<EffectDescription, '
  */
 export declare function resolveEffectValues(description: Pick<EffectDescription, 'id' | 'controls' | 'defaults'>, values?: EffectValues): Record<string, EffectValues[string]>;
 /**
- * Whether an editor offering `uses` should offer `e` (in a picker or an `effect` enum). Motion
- * and camera effects draw no picture of their own, so they are offered only where `uses` names
- * them (`motion`, `camera`); with no `uses`, every other effect is.
+ * Whether an editor offering `uses` should offer `e` (in a picker or an `effect` enum). Motion,
+ * camera and timing effects draw no picture of their own, so they are offered only where `uses`
+ * names them (`motion`, `camera`, `timing`); with no `uses`, every other effect is.
  */
 export declare function effectOffered(e: Pick<EffectSummary, 'kind' | 'uses'>, uses?: readonly EffectUse[]): boolean;
 /** A tag as tags are compared: trimmed, lower case, spaces and underscores as single hyphens (`"Game Boy"` → `game-boy`). */
@@ -128,3 +128,35 @@ export interface CameraBox {
 export declare function cameraViewOfBox(box: CameraBox, stage: CameraStage): CameraView;
 /** The box of the scene a view shows on `stage` (its tilt, turn, roll and blur aside). */
 export declare function cameraBoxOfView(view: CameraView, stage: CameraStage): CameraBox;
+/** Throws `EffectUnsupportedError` unless `footageMs` is a footage length a timing effect takes (a number of ms > 0). */
+export declare function checkTimingFootage(footageMs: number, id?: string): void;
+/**
+ * Checks a timing request (footage, time and fps), throwing `EffectUnsupportedError` with a
+ * sentence naming the valid range, and gives its fps (default `TIMING_DEFAULT_FPS`).
+ */
+export declare function checkTimingRequest(request: TimingSampleRequest, id?: string): number;
+/**
+ * Raw footage frames (any times, any positive weights) as a `TimingSample`: each time held within
+ * the footage and moved to the start of its frame, frames on the same footage frame merged, at
+ * most `TIMING_MAX_FRAMES` (evenly spaced), weights scaled to add up to 1, earliest first. Frames
+ * with a time or weight that is not a finite number, or a weight ≤ 0, are dropped; with none left,
+ * the sample is the frame at `request.time`. Providers can build `timingSample` on it.
+ */
+export declare function normaliseTimingSample(raw: readonly TimingFrame[], request: TimingSampleRequest, blend?: TimingBlend): TimingSample;
+/**
+ * What is wrong with `sample` as the answer to `request` (see `TimingSample`), as sentences; empty
+ * when it keeps every rule. `checkEffectProvider` uses it; hosts can check a provider's samples
+ * with it.
+ */
+export declare function timingSampleProblems(sample: unknown, request: TimingSampleRequest): string[];
+/**
+ * Blends footage frames by weight as a timing sample says (see `TimingBlend`): the reference for
+ * hosts that blend in their own pipeline, and a ready blend for `EffectPixels`. Reads and writes
+ * 8-bit `data` (straight alpha, rounded); `float` is not used. Writes into `out` when given (the
+ * frames' size), else a new picture. Throws `EffectUnsupportedError` for no frames or frames of
+ * different sizes.
+ */
+export declare function blendTimingFrames(frames: readonly {
+    pixels: EffectPixels;
+    weight: number;
+}[], blend: TimingBlend, out?: EffectPixels): EffectPixels;