reframe-video 0.6.4 → 0.6.6

package/dist/bin.js

@@ -380,6 +380,7 @@ function validateScene(ir) {
       if (typeof props.blur === "number" && props.blur < 0) problems.push(`node "${node.id}": blur must be >= 0`);
       if (typeof props.shadowBlur === "number" && props.shadowBlur < 0) problems.push(`node "${node.id}": shadowBlur must be >= 0`);
       if (typeof props.blend === "string" && !BLEND_MODES.has(props.blend)) problems.push(`node "${node.id}": unknown blend "${props.blend}" \u2014 use ${[...BLEND_MODES].join(", ")}`);
+      if (typeof props.fit === "string" && !IMAGE_FITS.has(props.fit)) problems.push(`node "${node.id}": unknown fit "${props.fit}" \u2014 use ${[...IMAGE_FITS].join(", ")}`);
       if (node.type === "group") {
         const clip = node.props.clip;
         if (clip) {
@@ -594,7 +595,7 @@ function validateComposition(comp) {
   }
   if (problems.length > 0) throw new SceneValidationError(problems);
 }
-var FX_PROPS, BLEND_MODES, COMMON_PROPS, CAMERA_PROPS, PROPS_BY_TYPE, SceneValidationError, TRANSITIONS;
+var FX_PROPS, BLEND_MODES, IMAGE_FITS, COMMON_PROPS, CAMERA_PROPS, PROPS_BY_TYPE, SceneValidationError, TRANSITIONS;
 var init_validate = __esm({
   "../core/src/validate.ts"() {
     "use strict";
@@ -612,6 +613,7 @@ var init_validate = __esm({
       "hard-light",
       "difference"
     ]);
+    IMAGE_FITS = /* @__PURE__ */ new Set(["fill", "cover"]);
     COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "anchor", "fixed", ...FX_PROPS];
     CAMERA_PROPS = ["x", "y", "zoom", "rotation"];
     PROPS_BY_TYPE = {
@@ -619,7 +621,8 @@ var init_validate = __esm({
       ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
       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"],
+      image: [...COMMON_PROPS, "src", "width", "height", "fit"],
+      video: [...COMMON_PROPS, "src", "width", "height", "fit", "start", "rate", "clipStart"],
       path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
       group: COMMON_PROPS
     };
@@ -1361,13 +1364,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);
@@ -1376,14 +1379,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);
     }
@@ -1391,6 +1394,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";
@@ -1955,12 +1964,12 @@ async function encodeMp4(framesDir, fps, outFile) {
     "+faststart",
     outFile
   ];
-  await new Promise((resolve5, reject) => {
+  await new Promise((resolve6, reject) => {
     const proc = spawn2("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) resolve6();
       else reject(new Error(`ffmpeg exited with ${code}:
 ${stderr.slice(-2e3)}`));
     });
@@ -2042,6 +2051,103 @@ var init_images = __esm({
   }
 });
 
+// ../render-cli/src/videos.ts
+import { spawn as spawn3 } from "node:child_process";
+import { mkdtemp as mkdtemp2, readFile as readFile4, readdir, rm as rm2 } from "node:fs/promises";
+import { existsSync as existsSync4 } from "node:fs";
+import { tmpdir as tmpdir3 } from "node:os";
+import { extname as extname2, isAbsolute as isAbsolute3, join as join4, resolve as resolve3 } from "node:path";
+function runFfmpeg(args) {
+  return new Promise((resolve6, reject) => {
+    const proc = spawn3("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
+    let stderr = "";
+    proc.stderr.on("data", (d) => stderr += d.toString());
+    proc.on(
+      "close",
+      (code) => code === 0 ? resolve6() : 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 = [isAbsolute3(src) ? src : null, resolve3(sceneDir, src)].filter(
+      (c) => c !== null
+    );
+    const found = candidates.find((c) => existsSync4(c));
+    if (!found) throw new Error(`video "${src}" not found (tried: ${candidates.join(", ")})`);
+    const dir = await mkdtemp2(join4(tmpdir3(), "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",
+        join4(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(join4(dir, f))).toString("base64")}`)
+      );
+      if (assets[src].length === 0) throw new Error(`video "${src}": ffmpeg extracted no frames`);
+    } finally {
+      await rm2(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({
@@ -2122,7 +2228,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 join5, dirname as dirname4 } from "node:path";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
 import { build } from "esbuild";
 import { chromium } from "playwright";
@@ -2147,14 +2253,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(
+      join5(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.js"),
       "utf8"
     );
     return bundleCache;
   }
-  const entry = join4(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.ts");
+  const entry = join5(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.ts");
   const result = await build({
     entryPoints: [entry],
     bundle: true,
@@ -2167,7 +2273,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(
@@ -2175,12 +2284,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);
@@ -2195,9 +2302,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) => join5(dir, `${String(i).padStart(5, "0")}.png`);
     bundleCache = null;
   }
 });
@@ -2210,9 +2318,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 mkdtemp3, readFile as readFile5, rm as rm3, writeFile as writeFile4 } from "node:fs/promises";
+import { tmpdir as tmpdir4 } from "node:os";
+import { join as join6, dirname as dirname5 } from "node:path";
 function overlayFromFlat(row, name) {
   const doc = { reframeOverlay: 1, name };
   for (const [key2, raw] of Object.entries(row)) {
@@ -2286,7 +2394,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`);
@@ -2306,8 +2414,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 mkdtemp3(join6(tmpdir4(), `reframe-batch-${index}-`));
+        const output = join6(opts.outDir, `${name}.mp4`);
         const plan = opts.noAudio ? null : resolveAudioPlan(compileScene(ir));
         try {
           const captured = await captureIr(ir, {
@@ -2319,12 +2427,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 rm3(videoTmp, { force: true });
           } else {
             await encodeMp4(captured.framesDir, captured.fps, output);
           }
         } finally {
-          await rm2(framesDir, { recursive: true, force: true });
+          await rm3(framesDir, { recursive: true, force: true });
         }
         result = {
           name,
@@ -2348,7 +2456,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"),
+    join6(opts.outDir, "batch-report.json"),
     JSON.stringify({ rows: results }, null, 2)
   );
   return results;
@@ -2373,11 +2481,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 resolve4 } 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({
@@ -2427,26 +2535,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 ? resolve4(HERE, "index.js") : resolve4(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 spawn4, spawnSync } from "node:child_process";
+import { existsSync as existsSync5 } 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 isAbsolute4, join as join7, resolve as resolve5 } 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 ? resolve5(HERE2, "..") : resolve5(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 ? join7(ROOT2, "dist", "cli.js") : join7(ROOT2, "packages", "render-cli", "src", "cli.ts");
+var LABELS = PACKAGED ? join7(ROOT2, "dist", "labels.js") : join7(ROOT2, "packages", "render-cli", "src", "labels.ts");
+var PLAYER = PACKAGED ? join7(ROOT2, "dist", "player.js") : join7(ROOT2, "packages", "render-cli", "src", "player.ts");
+var ANALYZE = PACKAGED ? join7(ROOT2, "dist", "analyze.js") : join7(ROOT2, "benchmark", "harness", "motion", "analyze.ts");
+var TRACE = PACKAGED ? join7(ROOT2, "dist", "trace-cli.js") : join7(ROOT2, "benchmark", "harness", "motion", "trace-cli.ts");
 var CMD = PACKAGED ? "reframe" : "pnpm reframe";
 var USAGE = `reframe \u2014 declarative motion graphics
 
@@ -2466,7 +2574,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) => isAbsolute4(p) ? p : resolve5(USER_CWD, p);
 function fail(message) {
   console.error(`error: ${message}`);
   process.exit(2);
@@ -2478,7 +2586,7 @@ function preflightFfmpeg() {
 }
 function run(cmd, args, opts = {}) {
   return new Promise((res) => {
-    const proc = spawn3(cmd, args, {
+    const proc = spawn4(cmd, args, {
       cwd: opts.cwd ?? (PACKAGED ? USER_CWD : ROOT2),
       stdio: ["inherit", "inherit", "pipe"],
       ...opts.env && { env: { ...process.env, ...opts.env } }
@@ -2568,7 +2676,7 @@ async function main() {
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync4(inputPath)) fail(`no such file: ${inputPath}`);
+      if (!existsSync5(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)`);
@@ -2578,11 +2686,11 @@ ${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 ? join7(USER_CWD, "out") : join7(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", join7(outBase, `${basename(input).replace(/\.[^.]+$/, "")}.mp4`)];
       }
       outArgs = outArgs.map(
         (a, i) => outArgs[i - 1] === "--overlay" || outArgs[i - 1] === "-o" ? userPath(a) : a
@@ -2597,7 +2705,7 @@ ${USAGE}`);
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync4(inputPath)) fail(`no such file: ${inputPath}`);
+      if (!existsSync5(inputPath)) fail(`no such file: ${inputPath}`);
       process.exit(
         await (PACKAGED ? run(process.execPath, [LABELS, inputPath]) : run("npx", ["tsx", LABELS, inputPath]))
       );
@@ -2608,10 +2716,10 @@ ${USAGE}`);
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync4(inputPath)) fail(`no such file: ${inputPath}`);
+      if (!existsSync5(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 ? join7(USER_CWD, "out") : join7(ROOT2, "out");
+      const outPath = oIdx >= 0 && rest[oIdx + 1] ? userPath(rest[oIdx + 1]) : join7(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]))
@@ -2631,7 +2739,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: tmpdir5 } = 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`);
@@ -2644,10 +2752,10 @@ ${USAGE}`);
         seed: num("seed")
       });
       const sceneIR = buildLogoSting2(data);
-      const tmp = join6(tmpdir4(), `reframe-logo-${slug}-${process.pid}.json`);
+      const tmp = join7(tmpdir5(), `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 ? join7(USER_CWD, "out") : join7(ROOT2, "out");
+      const out = flags.o ? userPath(flags.o) : join7(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(
@@ -2659,9 +2767,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 (!existsSync5(p)) fail(`no such file: ${p}`);
       preflightFfmpeg();
-      let outDir = PACKAGED ? join6(USER_CWD, "out", "batch") : join6(ROOT2, "out", "batch");
+      let outDir = PACKAGED ? join7(USER_CWD, "out", "batch") : join7(ROOT2, "out", "batch");
       let concurrency = 3;
       let fps;
       const baseOverlayPaths = [];
@@ -2674,10 +2782,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`);
@@ -2700,7 +2808,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: ${join7(outDir, "batch-report.json")}`
       );
       process.exit(failed > 0 ? 1 : 0);
     }
@@ -2711,9 +2819,9 @@ ${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 = join7(dirname7(vitePkg), "bin", "vite.js");
         process.exit(
-          await run(process.execPath, [viteBin, join6(ROOT2, "preview")], {
+          await run(process.execPath, [viteBin, join7(ROOT2, "preview")], {
             env: { REFRAME_SCENE_DIR: USER_CWD }
           })
         );
@@ -2731,10 +2839,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 ? join7(ROOT2, "examples", "scenes") : USER_CWD;
+      const target = join7(targetDir, `${name}.ts`);
       const shown = inRepo ? `examples/scenes/${name}.ts` : `${name}.ts`;
-      if (existsSync4(target)) fail(`${shown} already exists`);
+      if (existsSync5(target)) fail(`${shown} already exists`);
       const id = name.split("-")[0] ?? name;
       await writeFile5(target, SCENE_TEMPLATE(name, id));
       console.log(`created ${shown}
@@ -2763,9 +2871,9 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
       );
     }
     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 ? join7(ROOT2, "guides", "regen-contract.md") : join7(ROOT2, "docs", "regen-contract.md") : PACKAGED ? join7(ROOT2, "guides", "edsl-guide.md") : join7(ROOT2, "benchmark", "guides", "edsl-guide.md");
+      const { readFile: readFile7 } = await import("node:fs/promises");
+      process.stdout.write(await readFile7(file, "utf8"));
       return;
     }
     case "demo":
@@ -2776,7 +2884,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 run("npx", ["tsx", join7(ROOT2, "examples", "scripts", "demo-edit-survival.ts")])
       );
     default:
       console.log(USAGE);