Skip to content

AI media harness for planning, generating, and editing locally

TypeScript
2.7 KB
Raw Blame
import { applyMotionOverrides, motionNodeSchema, type Motion, type MotionNode } from "./motion";

export interface MotionMusicContext { songId: string; assetId: string; time: number; bpm: number; beatsPerBar: number; beat: number; beatIndex: number; phase: number; bar: number; beatInBar: number }
export interface MotionContext { time: number; duration: number; width: number; height: number; parameters: Record<string, string | number | boolean>; nodes: MotionNode[]; random: () => number; music?: MotionMusicContext }
export type MotionDraw = Record<MotionNode["kind"], (node: Partial<MotionNode>) => void>;
export type MotionUpdate = (context: MotionContext, draw: MotionDraw) => void;

/** Pure evaluation contract shared by the worker and tests. A fresh scene and
 * seeded RNG on every request make seeking independent of playback order. */
export function evaluateMotion(motion: Motion, seconds: number, update: MotionUpdate): MotionNode[] {
  const nodes = structuredClone(motion.nodes);
  let state = motion.seed >>> 0;
  const draw = Object.fromEntries((["rect", "ellipse", "text", "path"] as const).map((kind) => [kind, (node: Partial<MotionNode>) => {
    if (nodes.length >= 1024) throw new Error("Motion exceeds 1024 drawing elements.");
    nodes.push(motionNodeSchema.parse({ id: `draw-${nodes.length}`, name: kind, ...node, kind }));
  }])) as MotionDraw;
  const time = Math.max(0, Math.min(motion.duration, seconds));
  const binding = motion.music;
  const beat = binding ? (time + binding.sourceAt - binding.beatOffsetSeconds) * binding.bpm / 60 : 0;
  const beatIndex = Math.floor(beat);
  const result = update({ time, duration: motion.duration,
    ...(binding ? { music: { songId: binding.songId, assetId: binding.assetId, time: time + binding.sourceAt,
      bpm: binding.bpm, beatsPerBar: binding.beatsPerBar, beat, beatIndex, phase: beat - beatIndex,
      bar: Math.floor(beat / binding.beatsPerBar), beatInBar: ((beatIndex % binding.beatsPerBar) + binding.beatsPerBar) % binding.beatsPerBar } } : {}),
    width: motion.width, height: motion.height, nodes,
    parameters: Object.fromEntries(motion.parameters.map((p) => [p.id, p.value])),
    random: () => { state = (Math.imul(1664525, state) + 1013904223) >>> 0; return state / 4294967296; },
  }, draw);
  if (result !== undefined) throw new Error("Motion update must be synchronous and return nothing.");
  if (nodes.length > 1024) throw new Error("Motion exceeds 1024 drawing elements.");
  const checked = nodes.map((node) => motionNodeSchema.parse(node));
  if (new Set(checked.map((node) => node.id)).size !== checked.length) throw new Error("Motion drawing IDs must be unique.");
  return applyMotionOverrides(checked, motion);
}