reframe-video 0.6.5 → 0.6.7

package/dist/bin.js

@@ -622,6 +622,7 @@ var init_validate = __esm({
       line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
       text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
       image: [...COMMON_PROPS, "src", "width", "height", "fit"],
+      video: [...COMMON_PROPS, "src", "width", "height", "fit", "start", "rate", "clipStart", "volume"],
       path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
       group: COMMON_PROPS
     };
@@ -1209,11 +1210,34 @@ var init_motionOps = __esm({
 });
 
 // ../core/src/audio.ts
+function collectClipAudio(ir, duration, warnings) {
+  const out = [];
+  const walk = (nodes) => {
+    for (const node of nodes) {
+      if (node.type === "video") {
+        const gain = node.props.volume ?? 1;
+        const start = node.props.start ?? 0;
+        if (gain <= 0) continue;
+        if (start >= duration) {
+          warnings.push(`video "${node.id}": start ${start.toFixed(2)}s past the scene end \u2014 audio dropped`);
+          continue;
+        }
+        out.push({ nodeId: node.id, src: node.props.src, start, rate: node.props.rate ?? 1, clipStart: node.props.clipStart ?? 0, gain });
+      }
+      if (node.type === "group") walk(node.children);
+    }
+  };
+  walk(ir.nodes);
+  return out;
+}
 function resolveAudioPlan(compiled) {
   const audio = compiled.ir.audio;
-  if (!audio || !audio.bgm && (audio.cues ?? []).length === 0) return null;
   const warnings = [];
   const duration = compiled.duration;
+  const clipAudio = collectClipAudio(compiled.ir, duration, warnings);
+  if (!audio || !audio.bgm && (audio.cues ?? []).length === 0) {
+    return clipAudio.length === 0 ? null : { duration, bgm: null, cues: [], duckWindows: [], clipAudio, warnings };
+  }
   const cues = [];
   for (const [index, cue] of (audio.cues ?? []).entries()) {
     let anchor;
@@ -1249,6 +1273,7 @@ function resolveAudioPlan(compiled) {
     bgm: resolveBgm(audio.bgm),
     cues,
     duckWindows: mergeDuckWindows(cues, duration),
+    clipAudio,
     warnings
   };
 }
@@ -1363,13 +1388,13 @@ var init_evaluate = __esm({
 });
 
 // ../core/src/assets.ts
-function collectImageSrcs(ir) {
+function collectSrcs(ir, type) {
   const srcs = /* @__PURE__ */ new Set();
-  const imageIds = /* @__PURE__ */ new Set();
+  const ids = /* @__PURE__ */ new Set();
   const walkNodes = (nodes) => {
     for (const node of nodes) {
-      if (node.type === "image") {
-        imageIds.add(node.id);
+      if (node.type === type) {
+        ids.add(node.id);
         srcs.add(node.props.src);
       }
       if (node.type === "group") walkNodes(node.children);
@@ -1378,14 +1403,14 @@ function collectImageSrcs(ir) {
   walkNodes(ir.nodes);
   for (const overrides of Object.values(ir.states ?? {})) {
     for (const [nodeId, props] of Object.entries(overrides)) {
-      if (imageIds.has(nodeId) && typeof props.src === "string") srcs.add(props.src);
+      if (ids.has(nodeId) && typeof props.src === "string") srcs.add(props.src);
     }
   }
   const walkTimeline = (step) => {
     if (!step) return;
     if (step.kind === "seq" || step.kind === "par" || step.kind === "stagger") {
       for (const child of step.children) walkTimeline(child);
-    } else if (step.kind === "tween" && imageIds.has(step.target)) {
+    } else if (step.kind === "tween" && ids.has(step.target)) {
       const src = step.props.src;
       if (typeof src === "string") srcs.add(src);
     }
@@ -1393,6 +1418,12 @@ function collectImageSrcs(ir) {
   walkTimeline(ir.timeline);
   return [...srcs];
 }
+function collectImageSrcs(ir) {
+  return collectSrcs(ir, "image");
+}
+function collectVideoSrcs(ir) {
+  return collectSrcs(ir, "video");
+}
 var init_assets = __esm({
   "../core/src/assets.ts"() {
     "use strict";
@@ -1824,11 +1855,89 @@ var init_sfx = __esm({
   }
 });
 
-// ../render-cli/src/audio/mux.ts
+// ../render-cli/src/audio/clip.ts
 import { spawn } from "node:child_process";
+import { existsSync as existsSync3 } from "node:fs";
+import { isAbsolute as isAbsolute2, join as join2, resolve as resolve2 } from "node:path";
+function run(cmd, args) {
+  return new Promise((res, reject) => {
+    const proc = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "", stderr = "";
+    proc.stdout.on("data", (d) => stdout += d.toString());
+    proc.stderr.on("data", (d) => stderr += d.toString());
+    proc.on("close", (code) => res({ code: code ?? 1, stdout, stderr }));
+    proc.on("error", reject);
+  });
+}
+async function hasAudioStream(file) {
+  const { stdout } = await run("ffprobe", [
+    "-v",
+    "error",
+    "-select_streams",
+    "a",
+    "-show_entries",
+    "stream=index",
+    "-of",
+    "csv=p=0",
+    file
+  ]);
+  return stdout.trim().length > 0;
+}
+function resolveSrc(src, sceneDir) {
+  const candidates = [isAbsolute2(src) ? src : null, resolve2(sceneDir, src)].filter(
+    (c) => c !== null
+  );
+  const found = candidates.find((c) => existsSync3(c));
+  if (!found) throw new Error(`video "${src}" not found (tried: ${candidates.join(", ")})`);
+  return found;
+}
+async function resolveClipAudio(entry, sceneDir, workDir) {
+  const src = resolveSrc(entry.src, sceneDir);
+  if (!await hasAudioStream(src)) return null;
+  const out = join2(workDir, `clip-${entry.nodeId}.wav`);
+  const { code, stderr } = await run("ffmpeg", [
+    "-y",
+    "-i",
+    src,
+    "-vn",
+    "-ac",
+    "2",
+    "-ar",
+    "44100",
+    "-c:a",
+    "pcm_s16le",
+    out
+  ]);
+  if (code !== 0) throw new Error(`clip audio extract failed for "${entry.src}":
+${stderr.slice(-1500)}`);
+  return out;
+}
+var init_clip = __esm({
+  "../render-cli/src/audio/clip.ts"() {
+    "use strict";
+  }
+});
+
+// ../render-cli/src/audio/mux.ts
+import { spawn as spawn2 } from "node:child_process";
 import { mkdtemp, rm, writeFile as writeFile2 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
+function atempoChain(rate) {
+  if (!(rate > 0) || rate === 1) return [];
+  const out = [];
+  let r = rate;
+  while (r > 2) {
+    out.push("atempo=2.0");
+    r /= 2;
+  }
+  while (r < 0.5) {
+    out.push("atempo=0.5");
+    r /= 0.5;
+  }
+  out.push(`atempo=${r.toFixed(4)}`);
+  return out;
+}
 function buildFilterGraph(plan, inputs) {
   const lines = [];
   const mixIn = ["[anchor]"];
@@ -1861,15 +1970,25 @@ function buildFilterGraph(plan, inputs) {
     mixIn.push(`[c${i}]`);
     inputIndex++;
   });
+  (inputs.clipFiles ?? []).forEach(({ audio }, i) => {
+    const chain = [];
+    if (audio.clipStart > 0) chain.push(`atrim=start=${audio.clipStart.toFixed(3)}`, "asetpts=PTS-STARTPTS");
+    chain.push(...atempoChain(audio.rate), FORMAT, `volume=${audio.gain}`);
+    const delayMs = Math.round(audio.start * 1e3);
+    if (delayMs > 0) chain.push(`adelay=${delayMs}:all=1`);
+    lines.push(`[${inputIndex}:a]${chain.join(",")}[k${i}]`);
+    mixIn.push(`[k${i}]`);
+    inputIndex++;
+  });
   lines.push(
     `${mixIn.join("")}amix=inputs=${mixIn.length}:duration=first:normalize=0,alimiter=limit=0.891,aresample=async=1:first_pts=0[aout]`
   );
   return lines.join(";\n");
 }
 async function muxAudio(videoIn, plan, inputs, outFile) {
-  const work = await mkdtemp(join2(tmpdir2(), "reframe-mux-"));
+  const work = await mkdtemp(join3(tmpdir2(), "reframe-mux-"));
   try {
-    const graphFile = join2(work, "graph.txt");
+    const graphFile = join3(work, "graph.txt");
     await writeFile2(graphFile, buildFilterGraph(plan, inputs));
     const args = [
       "-y",
@@ -1877,6 +1996,7 @@ async function muxAudio(videoIn, plan, inputs, outFile) {
       videoIn,
       ...plan.bgm && inputs.bgmFile ? ["-i", inputs.bgmFile] : [],
       ...inputs.cueFiles.flatMap((f) => ["-i", f]),
+      ...(inputs.clipFiles ?? []).flatMap((c) => ["-i", c.file]),
       "-filter_complex_script",
       graphFile,
       "-map",
@@ -1895,7 +2015,7 @@ async function muxAudio(videoIn, plan, inputs, outFile) {
       outFile
     ];
     await new Promise((resolvePromise, reject) => {
-      const proc = spawn("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
+      const proc = spawn2("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
       let stderr = "";
       proc.stderr.on("data", (d) => stderr += d.toString());
       proc.on("close", (code) => {
@@ -1918,17 +2038,35 @@ var init_mux = __esm({
 });
 
 // ../render-cli/src/audio/index.ts
-import { dirname as dirname2 } from "node:path";
+import { copyFile, mkdtemp as mkdtemp2, rm as rm2 } from "node:fs/promises";
+import { tmpdir as tmpdir3 } from "node:os";
+import { dirname as dirname2, join as join4 } from "node:path";
 async function buildAudioTrack(plan, scenePath, videoIn, outFile) {
   const sceneDir = dirname2(scenePath);
   const cueFiles = await Promise.all(plan.cues.map((cue) => resolveCueFile(cue, sceneDir)));
   const bgmFile = plan.bgm ? await resolveBgmFile(plan.bgm.source, plan.duration, sceneDir) : null;
-  await muxAudio(videoIn, plan, { cueFiles, bgmFile }, outFile);
+  const work = await mkdtemp2(join4(tmpdir3(), "reframe-clipaudio-"));
+  try {
+    const clipFiles = [];
+    for (const entry of plan.clipAudio) {
+      const file = await resolveClipAudio(entry, sceneDir, work);
+      if (file) clipFiles.push({ audio: entry, file });
+      else console.error(`audio: video "${entry.nodeId}" has no audio track \u2014 skipped`);
+    }
+    if (!plan.bgm && plan.cues.length === 0 && clipFiles.length === 0) {
+      await copyFile(videoIn, outFile);
+      return;
+    }
+    await muxAudio(videoIn, plan, { cueFiles, bgmFile, clipFiles }, outFile);
+  } finally {
+    await rm2(work, { recursive: true, force: true });
+  }
 }
 var init_audio2 = __esm({
   "../render-cli/src/audio/index.ts"() {
     "use strict";
     init_sfx();
+    init_clip();
     init_mux();
     init_mux();
     init_synth();
@@ -1937,7 +2075,7 @@ var init_audio2 = __esm({
 });
 
 // ../render-cli/src/encode.ts
-import { spawn as spawn2 } from "node:child_process";
+import { spawn as spawn3 } from "node:child_process";
 async function encodeMp4(framesDir, fps, outFile) {
   const args = [
     "-y",
@@ -1957,12 +2095,12 @@ async function encodeMp4(framesDir, fps, outFile) {
     "+faststart",
     outFile
   ];
-  await new Promise((resolve5, reject) => {
-    const proc = spawn2("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
+  await new Promise((resolve7, reject) => {
+    const proc = spawn3("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
     let stderr = "";
     proc.stderr.on("data", (d) => stderr += d.toString());
     proc.on("close", (code) => {
-      if (code === 0) resolve5();
+      if (code === 0) resolve7();
       else reject(new Error(`ffmpeg exited with ${code}:
 ${stderr.slice(-2e3)}`));
     });
@@ -1977,13 +2115,13 @@ var init_encode = __esm({
 
 // ../render-cli/src/fonts.ts
 import { readFile as readFile2 } from "node:fs/promises";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { dirname as dirname3, join as join5 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 async function fontFaceCss() {
   if (cssCache) return cssCache;
   const rules = await Promise.all(
     WEIGHTS.map(async (weight) => {
-      const data = await readFile2(join3(FONTS_DIR, `inter-${weight}.woff2`));
+      const data = await readFile2(join5(FONTS_DIR, `inter-${weight}.woff2`));
       return `@font-face {
   font-family: "Inter";
   font-style: normal;
@@ -1999,7 +2137,7 @@ var FONTS_DIR, WEIGHTS, cssCache;
 var init_fonts = __esm({
   "../render-cli/src/fonts.ts"() {
     "use strict";
-    FONTS_DIR = true ? join3(dirname3(fileURLToPath2(import.meta.url)), "..", "assets", "fonts") : join3(dirname3(fileURLToPath2(import.meta.url)), "..", "..", "..", "assets", "fonts");
+    FONTS_DIR = true ? join5(dirname3(fileURLToPath2(import.meta.url)), "..", "assets", "fonts") : join5(dirname3(fileURLToPath2(import.meta.url)), "..", "..", "..", "assets", "fonts");
     WEIGHTS = [400, 700, 800];
     cssCache = null;
   }
@@ -2007,8 +2145,8 @@ var init_fonts = __esm({
 
 // ../render-cli/src/images.ts
 import { readFile as readFile3 } from "node:fs/promises";
-import { existsSync as existsSync3 } from "node:fs";
-import { extname, isAbsolute as isAbsolute2, resolve as resolve2 } from "node:path";
+import { existsSync as existsSync4 } from "node:fs";
+import { extname, isAbsolute as isAbsolute3, resolve as resolve3 } from "node:path";
 async function buildImageAssets(ir, sceneDir) {
   const assets = {};
   for (const src of collectImageSrcs(ir)) {
@@ -2018,10 +2156,10 @@ async function buildImageAssets(ir, sceneDir) {
         `image "${src}": unsupported format "${extname(src)}" \u2014 supported: ${Object.keys(MIME).join(" ")}`
       );
     }
-    const candidates = [isAbsolute2(src) ? src : null, resolve2(sceneDir, src)].filter(
+    const candidates = [isAbsolute3(src) ? src : null, resolve3(sceneDir, src)].filter(
       (c) => c !== null
     );
-    const found = candidates.find((c) => existsSync3(c));
+    const found = candidates.find((c) => existsSync4(c));
     if (!found) {
       throw new Error(`image "${src}" not found (tried: ${candidates.join(", ")})`);
     }
@@ -2044,6 +2182,103 @@ var init_images = __esm({
   }
 });
 
+// ../render-cli/src/videos.ts
+import { spawn as spawn4 } from "node:child_process";
+import { mkdtemp as mkdtemp3, readFile as readFile4, readdir, rm as rm3 } from "node:fs/promises";
+import { existsSync as existsSync5 } from "node:fs";
+import { tmpdir as tmpdir4 } from "node:os";
+import { extname as extname2, isAbsolute as isAbsolute4, join as join6, resolve as resolve4 } from "node:path";
+function runFfmpeg(args) {
+  return new Promise((resolve7, reject) => {
+    const proc = spawn4("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
+    let stderr = "";
+    proc.stderr.on("data", (d) => stderr += d.toString());
+    proc.on(
+      "close",
+      (code) => code === 0 ? resolve7() : reject(new Error(`ffmpeg exited ${code}:
+${stderr.slice(-2e3)}`))
+    );
+    proc.on("error", reject);
+  });
+}
+function neededSeconds(node, duration) {
+  const start = node.props.start ?? 0;
+  const rate = node.props.rate ?? 1;
+  const clipStart = node.props.clipStart ?? 0;
+  return clipStart + Math.max(0, duration - start) * Math.max(0, rate) + 1 / 30;
+}
+function videoNodes(ir) {
+  const out = [];
+  const walk = (nodes) => {
+    for (const n of nodes) {
+      if (n.type === "video") out.push(n);
+      if (n.type === "group") walk(n.children);
+    }
+  };
+  walk(ir.nodes);
+  return out;
+}
+async function buildVideoFrameAssets(ir, sceneDir, fps, duration) {
+  const srcs = collectVideoSrcs(ir);
+  if (srcs.length === 0) return {};
+  const nodes = videoNodes(ir);
+  const reachBySrc = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    const reach = neededSeconds(n, duration);
+    reachBySrc.set(n.props.src, Math.max(reachBySrc.get(n.props.src) ?? 0, reach));
+  }
+  const assets = {};
+  for (const src of srcs) {
+    if (!VIDEO_EXT.has(extname2(src).toLowerCase())) {
+      throw new Error(
+        `video "${src}": unsupported format "${extname2(src)}" \u2014 supported: ${[...VIDEO_EXT].join(" ")}`
+      );
+    }
+    const candidates = [isAbsolute4(src) ? src : null, resolve4(sceneDir, src)].filter(
+      (c) => c !== null
+    );
+    const found = candidates.find((c) => existsSync5(c));
+    if (!found) throw new Error(`video "${src}" not found (tried: ${candidates.join(", ")})`);
+    const dir = await mkdtemp3(join6(tmpdir4(), "reframe-vframes-"));
+    try {
+      const seconds = Math.max(1 / fps, reachBySrc.get(src) ?? duration);
+      await runFfmpeg([
+        "-y",
+        "-i",
+        found,
+        "-t",
+        seconds.toFixed(3),
+        "-vf",
+        `fps=${fps},scale='min(iw,1280)':-2`,
+        "-q:v",
+        "4",
+        join6(dir, "%05d.jpg")
+      ]);
+      const files = (await readdir(dir)).filter((f) => f.endsWith(".jpg")).sort();
+      assets[src] = await Promise.all(
+        files.map(async (f) => `data:image/jpeg;base64,${(await readFile4(join6(dir, f))).toString("base64")}`)
+      );
+      if (assets[src].length === 0) throw new Error(`video "${src}": ffmpeg extracted no frames`);
+    } finally {
+      await rm3(dir, { recursive: true, force: true });
+    }
+  }
+  return assets;
+}
+function resolveTiming(ir, opts) {
+  const fps = opts.fps ?? ir.fps ?? 30;
+  const duration = opts.duration ?? compileScene(ir).duration;
+  return { fps, duration };
+}
+var VIDEO_EXT;
+var init_videos = __esm({
+  "../render-cli/src/videos.ts"() {
+    "use strict";
+    init_src();
+    VIDEO_EXT = /* @__PURE__ */ new Set([".mp4", ".mov", ".webm", ".m4v", ".mkv"]);
+  }
+});
+
 // ../render-cli/src/vclock.ts
 var VCLOCK_SOURCE;
 var init_vclock = __esm({
@@ -2124,7 +2359,7 @@ var init_reframeGlobal = __esm({
 
 // ../render-cli/src/frameLoop.ts
 import { mkdir as mkdir2, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join4, dirname as dirname4 } from "node:path";
+import { join as join7, dirname as dirname4 } from "node:path";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
 import { build } from "esbuild";
 import { chromium } from "playwright";
@@ -2149,14 +2384,14 @@ async function withPage(size, fn) {
 async function browserBundle() {
   if (bundleCache) return bundleCache;
   if (true) {
-    const { readFile: readFile6 } = await import("node:fs/promises");
-    bundleCache = await readFile6(
-      join4(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.js"),
+    const { readFile: readFile7 } = await import("node:fs/promises");
+    bundleCache = await readFile7(
+      join7(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.js"),
       "utf8"
     );
     return bundleCache;
   }
-  const entry = join4(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.ts");
+  const entry = join7(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.ts");
   const result = await build({
     entryPoints: [entry],
     bundle: true,
@@ -2169,7 +2404,10 @@ async function browserBundle() {
 }
 async function captureIr(ir, opts) {
   await mkdir2(opts.framesDir, { recursive: true });
-  const assets = await buildImageAssets(ir, opts.sceneDir ?? process.cwd());
+  const sceneDir = opts.sceneDir ?? process.cwd();
+  const assets = await buildImageAssets(ir, sceneDir);
+  const { fps, duration } = resolveTiming(ir, opts);
+  const videoAssets = await buildVideoFrameAssets(ir, sceneDir, fps, duration);
   const bundle = await browserBundle();
   return withPage(ir.size, async (page) => {
     await page.setContent(
@@ -2177,12 +2415,10 @@ async function captureIr(ir, opts) {
     );
     await injectFonts(page);
     await page.addScriptTag({ content: bundle });
-    const info = await page.evaluate(
-      ([sceneIr, imageAssets]) => window.__reframe.init(sceneIr, imageAssets),
-      [ir, assets]
+    await page.evaluate(
+      ([sceneIr, imageAssets, vAssets]) => window.__reframe.init(sceneIr, imageAssets, vAssets),
+      [ir, assets, videoAssets]
     );
-    const fps = opts.fps ?? info.fps;
-    const duration = opts.duration ?? info.duration;
     const frameCount = Math.max(1, Math.round(duration * fps));
     for (let f = 0; f < frameCount; f++) {
       const dataUrl = await page.evaluate((t) => window.__reframe.renderFrame(t), f / fps);
@@ -2197,9 +2433,10 @@ var init_frameLoop = __esm({
     "use strict";
     init_fonts();
     init_images();
+    init_videos();
     init_vclock();
     init_reframeGlobal();
-    framePath = (dir, i) => join4(dir, `${String(i).padStart(5, "0")}.png`);
+    framePath = (dir, i) => join7(dir, `${String(i).padStart(5, "0")}.png`);
     bundleCache = null;
   }
 });
@@ -2212,9 +2449,9 @@ __export(batch_exports, {
   parseCsv: () => parseCsv,
   runBatch: () => runBatch
 });
-import { mkdir as mkdir3, mkdtemp as mkdtemp2, readFile as readFile4, rm as rm2, writeFile as writeFile4 } from "node:fs/promises";
-import { tmpdir as tmpdir3 } from "node:os";
-import { join as join5, dirname as dirname5 } from "node:path";
+import { mkdir as mkdir3, mkdtemp as mkdtemp4, readFile as readFile5, rm as rm4, writeFile as writeFile4 } from "node:fs/promises";
+import { tmpdir as tmpdir5 } from "node:os";
+import { join as join8, dirname as dirname5 } from "node:path";
 function overlayFromFlat(row, name) {
   const doc = { reframeOverlay: 1, name };
   for (const [key2, raw] of Object.entries(row)) {
@@ -2288,7 +2525,7 @@ function parseCsv(text2) {
   });
 }
 async function loadRows(path2) {
-  const text2 = await readFile4(path2, "utf8");
+  const text2 = await readFile5(path2, "utf8");
   if (path2.endsWith(".csv")) return parseCsv(text2);
   const parsed = JSON.parse(text2);
   if (!Array.isArray(parsed)) throw new Error(`${path2}: expected a JSON array of row objects`);
@@ -2308,8 +2545,8 @@ async function runBatch(scene2, rows, opts) {
       try {
         const rowOverlay = overlayFromFlat(row, name);
         const { ir, report } = composeScene(scene2, ...opts.baseOverlays, rowOverlay);
-        const framesDir = await mkdtemp2(join5(tmpdir3(), `reframe-batch-${index}-`));
-        const output = join5(opts.outDir, `${name}.mp4`);
+        const framesDir = await mkdtemp4(join8(tmpdir5(), `reframe-batch-${index}-`));
+        const output = join8(opts.outDir, `${name}.mp4`);
         const plan = opts.noAudio ? null : resolveAudioPlan(compileScene(ir));
         try {
           const captured = await captureIr(ir, {
@@ -2321,12 +2558,12 @@ async function runBatch(scene2, rows, opts) {
             const videoTmp = `${output}.video.mp4`;
             await encodeMp4(captured.framesDir, captured.fps, videoTmp);
             await buildAudioTrack(plan, opts.scenePath ?? output, videoTmp, output);
-            await rm2(videoTmp, { force: true });
+            await rm4(videoTmp, { force: true });
           } else {
             await encodeMp4(captured.framesDir, captured.fps, output);
           }
         } finally {
-          await rm2(framesDir, { recursive: true, force: true });
+          await rm4(framesDir, { recursive: true, force: true });
         }
         result = {
           name,
@@ -2350,7 +2587,7 @@ async function runBatch(scene2, rows, opts) {
   };
   await Promise.all(Array.from({ length: Math.max(1, opts.concurrency) }, worker));
   await writeFile4(
-    join5(opts.outDir, "batch-report.json"),
+    join8(opts.outDir, "batch-report.json"),
     JSON.stringify({ rows: results }, null, 2)
   );
   return results;
@@ -2375,11 +2612,11 @@ __export(loadScene_exports, {
   loadScene: () => loadScene
 });
 import { build as build2 } from "esbuild";
-import { readFile as readFile5 } from "node:fs/promises";
-import { dirname as dirname6, resolve as resolve3 } from "node:path";
+import { readFile as readFile6 } from "node:fs/promises";
+import { dirname as dirname6, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 async function loadDefault(path2) {
-  if (path2.endsWith(".json")) return JSON.parse(await readFile5(path2, "utf8"));
+  if (path2.endsWith(".json")) return JSON.parse(await readFile6(path2, "utf8"));
   let code;
   try {
     const out = await build2({
@@ -2429,26 +2666,26 @@ var init_loadScene = __esm({
     "use strict";
     init_src();
     HERE = dirname6(fileURLToPath4(import.meta.url));
-    CORE_ENTRY = true ? resolve3(HERE, "index.js") : resolve3(HERE, "..", "..", "core", "src", "index.ts");
+    CORE_ENTRY = true ? resolve5(HERE, "index.js") : resolve5(HERE, "..", "..", "core", "src", "index.ts");
   }
 });
 
 // ../render-cli/src/reframe.ts
-import { spawn as spawn3, spawnSync } from "node:child_process";
-import { existsSync as existsSync4 } from "node:fs";
+import { spawn as spawn5, spawnSync } from "node:child_process";
+import { existsSync as existsSync6 } from "node:fs";
 import { mkdir as mkdir4, writeFile as writeFile5 } from "node:fs/promises";
-import { basename, isAbsolute as isAbsolute3, join as join6, resolve as resolve4 } from "node:path";
+import { basename, isAbsolute as isAbsolute5, join as join9, resolve as resolve6 } from "node:path";
 import { dirname as dirname7 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 var PACKAGED = true;
 var HERE2 = dirname7(fileURLToPath5(import.meta.url));
-var ROOT2 = PACKAGED ? resolve4(HERE2, "..") : resolve4(HERE2, "..", "..", "..");
+var ROOT2 = PACKAGED ? resolve6(HERE2, "..") : resolve6(HERE2, "..", "..", "..");
 var USER_CWD = process.env.INIT_CWD ?? process.cwd();
-var RENDER_CLI = PACKAGED ? join6(ROOT2, "dist", "cli.js") : join6(ROOT2, "packages", "render-cli", "src", "cli.ts");
-var LABELS = PACKAGED ? join6(ROOT2, "dist", "labels.js") : join6(ROOT2, "packages", "render-cli", "src", "labels.ts");
-var PLAYER = PACKAGED ? join6(ROOT2, "dist", "player.js") : join6(ROOT2, "packages", "render-cli", "src", "player.ts");
-var ANALYZE = PACKAGED ? join6(ROOT2, "dist", "analyze.js") : join6(ROOT2, "benchmark", "harness", "motion", "analyze.ts");
-var TRACE = PACKAGED ? join6(ROOT2, "dist", "trace-cli.js") : join6(ROOT2, "benchmark", "harness", "motion", "trace-cli.ts");
+var RENDER_CLI = PACKAGED ? join9(ROOT2, "dist", "cli.js") : join9(ROOT2, "packages", "render-cli", "src", "cli.ts");
+var LABELS = PACKAGED ? join9(ROOT2, "dist", "labels.js") : join9(ROOT2, "packages", "render-cli", "src", "labels.ts");
+var PLAYER = PACKAGED ? join9(ROOT2, "dist", "player.js") : join9(ROOT2, "packages", "render-cli", "src", "player.ts");
+var ANALYZE = PACKAGED ? join9(ROOT2, "dist", "analyze.js") : join9(ROOT2, "benchmark", "harness", "motion", "analyze.ts");
+var TRACE = PACKAGED ? join9(ROOT2, "dist", "trace-cli.js") : join9(ROOT2, "benchmark", "harness", "motion", "trace-cli.ts");
 var CMD = PACKAGED ? "reframe" : "pnpm reframe";
 var USAGE = `reframe \u2014 declarative motion graphics
 
@@ -2468,7 +2705,7 @@ usage:
   ${CMD} guide [--regen]         print the scene-authoring guide (for you or your AI)
   ${CMD} demo                    run the edit-survival demo (3 mp4s into out/)
 `;
-var userPath = (p) => isAbsolute3(p) ? p : resolve4(USER_CWD, p);
+var userPath = (p) => isAbsolute5(p) ? p : resolve6(USER_CWD, p);
 function fail(message) {
   console.error(`error: ${message}`);
   process.exit(2);
@@ -2478,9 +2715,9 @@ function preflightFfmpeg() {
     fail("ffmpeg not found on PATH \u2014 install it first (macOS: brew install ffmpeg, debian: apt install ffmpeg)");
   }
 }
-function run(cmd, args, opts = {}) {
+function run2(cmd, args, opts = {}) {
   return new Promise((res) => {
-    const proc = spawn3(cmd, args, {
+    const proc = spawn5(cmd, args, {
       cwd: opts.cwd ?? (PACKAGED ? USER_CWD : ROOT2),
       stdio: ["inherit", "inherit", "pipe"],
       ...opts.env && { env: { ...process.env, ...opts.env } }
@@ -2570,7 +2807,7 @@ async function main() {
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync4(inputPath)) fail(`no such file: ${inputPath}`);
+      if (!existsSync6(inputPath)) fail(`no such file: ${inputPath}`);
       const mode = /\.(ts|json)$/.test(input) ? "ir" : /\.html$/.test(input) ? "html" : null;
       if (!mode) {
         fail(`cannot infer render mode from "${input}" \u2014 expected .ts/.json (reframe scene) or .html (GSAP page)`);
@@ -2580,17 +2817,17 @@ ${USAGE}`);
         fail("html render requires --duration <seconds> (the page does not declare its own length)");
       }
       preflightFfmpeg();
-      const outBase = PACKAGED ? join6(USER_CWD, "out") : join6(ROOT2, "out");
+      const outBase = PACKAGED ? join9(USER_CWD, "out") : join9(ROOT2, "out");
       let outArgs = args;
       if (!args.includes("-o")) {
         await mkdir4(outBase, { recursive: true });
-        outArgs = [...args, "-o", join6(outBase, `${basename(input).replace(/\.[^.]+$/, "")}.mp4`)];
+        outArgs = [...args, "-o", join9(outBase, `${basename(input).replace(/\.[^.]+$/, "")}.mp4`)];
       }
       outArgs = outArgs.map(
         (a, i) => outArgs[i - 1] === "--overlay" || outArgs[i - 1] === "-o" ? userPath(a) : a
       );
       process.exit(
-        await (PACKAGED ? run(process.execPath, [RENDER_CLI, mode, inputPath, ...outArgs]) : run("npx", ["tsx", RENDER_CLI, mode, inputPath, ...outArgs]))
+        await (PACKAGED ? run2(process.execPath, [RENDER_CLI, mode, inputPath, ...outArgs]) : run2("npx", ["tsx", RENDER_CLI, mode, inputPath, ...outArgs]))
       );
     }
     case "labels": {
@@ -2599,9 +2836,9 @@ ${USAGE}`);
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync4(inputPath)) fail(`no such file: ${inputPath}`);
+      if (!existsSync6(inputPath)) fail(`no such file: ${inputPath}`);
       process.exit(
-        await (PACKAGED ? run(process.execPath, [LABELS, inputPath]) : run("npx", ["tsx", LABELS, inputPath]))
+        await (PACKAGED ? run2(process.execPath, [LABELS, inputPath]) : run2("npx", ["tsx", LABELS, inputPath]))
       );
     }
     case "player": {
@@ -2610,13 +2847,13 @@ ${USAGE}`);
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync4(inputPath)) fail(`no such file: ${inputPath}`);
+      if (!existsSync6(inputPath)) fail(`no such file: ${inputPath}`);
       const oIdx = rest.indexOf("-o");
-      const outBase = PACKAGED ? join6(USER_CWD, "out") : join6(ROOT2, "out");
-      const outPath = oIdx >= 0 && rest[oIdx + 1] ? userPath(rest[oIdx + 1]) : join6(outBase, `${basename(input).replace(/\.[^.]+$/, "")}.html`);
+      const outBase = PACKAGED ? join9(USER_CWD, "out") : join9(ROOT2, "out");
+      const outPath = oIdx >= 0 && rest[oIdx + 1] ? userPath(rest[oIdx + 1]) : join9(outBase, `${basename(input).replace(/\.[^.]+$/, "")}.html`);
       await mkdir4(dirname7(outPath), { recursive: true });
       process.exit(
-        await (PACKAGED ? run(process.execPath, [PLAYER, inputPath, outPath]) : run("npx", ["tsx", PLAYER, inputPath, outPath]))
+        await (PACKAGED ? run2(process.execPath, [PLAYER, inputPath, outPath]) : run2("npx", ["tsx", PLAYER, inputPath, outPath]))
       );
     }
     case "logo": {
@@ -2633,7 +2870,7 @@ ${USAGE}`);
         fail(`usage: ${CMD} logo <logo.svg | brand-slug> ["Display Name"] [--motion <preset>] [--energy 0..1] [--speed n] [--intensity 0..1] [--from left|right|top|bottom] [--seed n] [-o out.mp4]`);
       }
       preflightFfmpeg();
-      const { tmpdir: tmpdir4 } = await import("node:os");
+      const { tmpdir: tmpdir6 } = await import("node:os");
       const { resolveLogo: resolveLogo2, buildLogoSting: buildLogoSting2 } = await Promise.resolve().then(() => (init_logoSting(), logoSting_exports));
       const num = (k) => flags[k] !== void 0 ? Number(flags[k]) : void 0;
       console.log(`loading logo: ${arg} \u2026`);
@@ -2646,14 +2883,14 @@ ${USAGE}`);
         seed: num("seed")
       });
       const sceneIR = buildLogoSting2(data);
-      const tmp = join6(tmpdir4(), `reframe-logo-${slug}-${process.pid}.json`);
+      const tmp = join9(tmpdir6(), `reframe-logo-${slug}-${process.pid}.json`);
       await writeFile5(tmp, JSON.stringify(sceneIR));
-      const outBase = PACKAGED ? join6(USER_CWD, "out") : join6(ROOT2, "out");
-      const out = flags.o ? userPath(flags.o) : join6(outBase, `logo-${slug}.mp4`);
+      const outBase = PACKAGED ? join9(USER_CWD, "out") : join9(ROOT2, "out");
+      const out = flags.o ? userPath(flags.o) : join9(outBase, `logo-${slug}.mp4`);
       await mkdir4(dirname7(out), { recursive: true });
       console.log(`rendering ${data.name} (${data.paths.length} path${data.paths.length > 1 ? "s" : ""}, motion: ${data.motion ?? "reveal-orbit"}) \u2192 ${out}`);
       process.exit(
-        await (PACKAGED ? run(process.execPath, [RENDER_CLI, "ir", tmp, "-o", out, "--no-audio"]) : run("npx", ["tsx", RENDER_CLI, "ir", tmp, "-o", out, "--no-audio"]))
+        await (PACKAGED ? run2(process.execPath, [RENDER_CLI, "ir", tmp, "-o", out, "--no-audio"]) : run2("npx", ["tsx", RENDER_CLI, "ir", tmp, "-o", out, "--no-audio"]))
       );
     }
     case "batch": {
@@ -2661,9 +2898,9 @@ ${USAGE}`);
       if (!sceneArg || !dataArg) fail(`usage: ${CMD} batch <scene.ts> <data.json|csv> [...]`);
       const scenePath = userPath(sceneArg);
       const dataPath = userPath(dataArg);
-      for (const p of [scenePath, dataPath]) if (!existsSync4(p)) fail(`no such file: ${p}`);
+      for (const p of [scenePath, dataPath]) if (!existsSync6(p)) fail(`no such file: ${p}`);
       preflightFfmpeg();
-      let outDir = PACKAGED ? join6(USER_CWD, "out", "batch") : join6(ROOT2, "out", "batch");
+      let outDir = PACKAGED ? join9(USER_CWD, "out", "batch") : join9(ROOT2, "out", "batch");
       let concurrency = 3;
       let fps;
       const baseOverlayPaths = [];
@@ -2676,10 +2913,10 @@ ${USAGE}`);
       }
       const { loadRows: loadRows2, runBatch: runBatch2 } = await Promise.resolve().then(() => (init_batch(), batch_exports));
       const { loadScene: loadScene2 } = await Promise.resolve().then(() => (init_loadScene(), loadScene_exports));
-      const { readFile: readFile6 } = await import("node:fs/promises");
+      const { readFile: readFile7 } = await import("node:fs/promises");
       const scene2 = await loadScene2(scenePath);
       const baseOverlays = await Promise.all(
-        baseOverlayPaths.map(async (p) => JSON.parse(await readFile6(p, "utf8")))
+        baseOverlayPaths.map(async (p) => JSON.parse(await readFile7(p, "utf8")))
       );
       const rows = await loadRows2(dataPath);
       if (rows.length === 0) fail(`${dataPath}: no data rows`);
@@ -2702,7 +2939,7 @@ ${USAGE}`);
       const orphaned = results.filter((r) => !r.error && r.orphans.length > 0).length;
       console.log(
         `
-${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed \u2014 report: ${join6(outDir, "batch-report.json")}`
+${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed \u2014 report: ${join9(outDir, "batch-report.json")}`
       );
       process.exit(failed > 0 ? 1 : 0);
     }
@@ -2713,15 +2950,15 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
       if (PACKAGED) {
         const { createRequire } = await import("node:module");
         const vitePkg = createRequire(import.meta.url).resolve("vite/package.json");
-        const viteBin = join6(dirname7(vitePkg), "bin", "vite.js");
+        const viteBin = join9(dirname7(vitePkg), "bin", "vite.js");
         process.exit(
-          await run(process.execPath, [viteBin, join6(ROOT2, "preview")], {
+          await run2(process.execPath, [viteBin, join9(ROOT2, "preview")], {
             env: { REFRAME_SCENE_DIR: USER_CWD }
           })
         );
       }
       process.exit(
-        await run("pnpm", ["--filter", "@reframe/preview", "dev"], {
+        await run2("pnpm", ["--filter", "@reframe/preview", "dev"], {
           env: { REFRAME_SCENE_DIR: USER_CWD }
         })
       );
@@ -2733,10 +2970,10 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
         fail(`scene name must be kebab-case (a-z, 0-9, -): got "${name}"`);
       }
       const inRepo = USER_CWD === ROOT2 || USER_CWD.startsWith(ROOT2 + "/");
-      const targetDir = inRepo ? join6(ROOT2, "examples", "scenes") : USER_CWD;
-      const target = join6(targetDir, `${name}.ts`);
+      const targetDir = inRepo ? join9(ROOT2, "examples", "scenes") : USER_CWD;
+      const target = join9(targetDir, `${name}.ts`);
       const shown = inRepo ? `examples/scenes/${name}.ts` : `${name}.ts`;
-      if (existsSync4(target)) fail(`${shown} already exists`);
+      if (existsSync6(target)) fail(`${shown} already exists`);
       const id = name.split("-")[0] ?? name;
       await writeFile5(target, SCENE_TEMPLATE(name, id));
       console.log(`created ${shown}
@@ -2750,7 +2987,7 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
       if (!input) fail(`usage: ${CMD} motion <mp4|framesDir> [...args]`);
       preflightFfmpeg();
       process.exit(
-        await (PACKAGED ? run(process.execPath, [ANALYZE, userPath(input), ...rest.slice(1)]) : run("npx", ["tsx", ANALYZE, userPath(input), ...rest.slice(1)]))
+        await (PACKAGED ? run2(process.execPath, [ANALYZE, userPath(input), ...rest.slice(1)]) : run2("npx", ["tsx", ANALYZE, userPath(input), ...rest.slice(1)]))
       );
     }
     case "trace": {
@@ -2761,13 +2998,13 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
         (a, i) => rest.slice(1)[i - 1] === "--apply" || rest.slice(1)[i - 1] === "-o" ? userPath(a) : a
       );
       process.exit(
-        await (PACKAGED ? run(process.execPath, [TRACE, userPath(input), ...args]) : run("npx", ["tsx", TRACE, userPath(input), ...args]))
+        await (PACKAGED ? run2(process.execPath, [TRACE, userPath(input), ...args]) : run2("npx", ["tsx", TRACE, userPath(input), ...args]))
       );
     }
     case "guide": {
-      const file = rest.includes("--regen") ? PACKAGED ? join6(ROOT2, "guides", "regen-contract.md") : join6(ROOT2, "docs", "regen-contract.md") : PACKAGED ? join6(ROOT2, "guides", "edsl-guide.md") : join6(ROOT2, "benchmark", "guides", "edsl-guide.md");
-      const { readFile: readFile6 } = await import("node:fs/promises");
-      process.stdout.write(await readFile6(file, "utf8"));
+      const file = rest.includes("--regen") ? PACKAGED ? join9(ROOT2, "guides", "regen-contract.md") : join9(ROOT2, "docs", "regen-contract.md") : PACKAGED ? join9(ROOT2, "guides", "edsl-guide.md") : join9(ROOT2, "benchmark", "guides", "edsl-guide.md");
+      const { readFile: readFile7 } = await import("node:fs/promises");
+      process.stdout.write(await readFile7(file, "utf8"));
       return;
     }
     case "demo":
@@ -2778,7 +3015,7 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
       }
       preflightFfmpeg();
       process.exit(
-        await run("npx", ["tsx", join6(ROOT2, "examples", "scripts", "demo-edit-survival.ts")])
+        await run2("npx", ["tsx", join9(ROOT2, "examples", "scripts", "demo-edit-survival.ts")])
       );
     default:
       console.log(USAGE);