reframe-video 0.6.6 → 0.6.7

package/dist/bin.js

@@ -622,7 +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"],
+      video: [...COMMON_PROPS, "src", "width", "height", "fit", "start", "rate", "clipStart", "volume"],
       path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
       group: COMMON_PROPS
     };
@@ -1210,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;
@@ -1250,6 +1273,7 @@ function resolveAudioPlan(compiled) {
     bgm: resolveBgm(audio.bgm),
     cues,
     duckWindows: mergeDuckWindows(cues, duration),
+    clipAudio,
     warnings
   };
 }
@@ -1831,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]"];
@@ -1868,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",
@@ -1884,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",
@@ -1902,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) => {
@@ -1925,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();
@@ -1944,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",
@@ -1964,12 +2095,12 @@ async function encodeMp4(framesDir, fps, outFile) {
     "+faststart",
     outFile
   ];
-  await new Promise((resolve6, 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) resolve6();
+      if (code === 0) resolve7();
       else reject(new Error(`ffmpeg exited with ${code}:
 ${stderr.slice(-2e3)}`));
     });
@@ -1984,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;
@@ -2006,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;
   }
@@ -2014,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)) {
@@ -2025,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(", ")})`);
     }
@@ -2052,19 +2183,19 @@ 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";
+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((resolve6, reject) => {
-    const proc = spawn3("ffmpeg", args, { stdio: ["ignore", "ignore", "pipe"] });
+  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 ? resolve6() : reject(new Error(`ffmpeg exited ${code}:
+      (code) => code === 0 ? resolve7() : reject(new Error(`ffmpeg exited ${code}:
 ${stderr.slice(-2e3)}`))
     );
     proc.on("error", reject);
@@ -2103,12 +2234,12 @@ async function buildVideoFrameAssets(ir, sceneDir, fps, duration) {
         `video "${src}": unsupported format "${extname2(src)}" \u2014 supported: ${[...VIDEO_EXT].join(" ")}`
       );
     }
-    const candidates = [isAbsolute3(src) ? src : null, resolve3(sceneDir, src)].filter(
+    const candidates = [isAbsolute4(src) ? src : null, resolve4(sceneDir, src)].filter(
       (c) => c !== null
     );
-    const found = candidates.find((c) => existsSync4(c));
+    const found = candidates.find((c) => existsSync5(c));
     if (!found) throw new Error(`video "${src}" not found (tried: ${candidates.join(", ")})`);
-    const dir = await mkdtemp2(join4(tmpdir3(), "reframe-vframes-"));
+    const dir = await mkdtemp3(join6(tmpdir4(), "reframe-vframes-"));
     try {
       const seconds = Math.max(1 / fps, reachBySrc.get(src) ?? duration);
       await runFfmpeg([
@@ -2121,15 +2252,15 @@ async function buildVideoFrameAssets(ir, sceneDir, fps, duration) {
         `fps=${fps},scale='min(iw,1280)':-2`,
         "-q:v",
         "4",
-        join4(dir, "%05d.jpg")
+        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(join4(dir, f))).toString("base64")}`)
+        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 rm2(dir, { recursive: true, force: true });
+      await rm3(dir, { recursive: true, force: true });
     }
   }
   return assets;
@@ -2228,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 join5, 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";
@@ -2255,12 +2386,12 @@ async function browserBundle() {
   if (true) {
     const { readFile: readFile7 } = await import("node:fs/promises");
     bundleCache = await readFile7(
-      join5(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.js"),
+      join7(dirname4(fileURLToPath3(import.meta.url)), "browserEntry.js"),
       "utf8"
     );
     return bundleCache;
   }
-  const entry = join5(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,
@@ -2305,7 +2436,7 @@ var init_frameLoop = __esm({
     init_videos();
     init_vclock();
     init_reframeGlobal();
-    framePath = (dir, i) => join5(dir, `${String(i).padStart(5, "0")}.png`);
+    framePath = (dir, i) => join7(dir, `${String(i).padStart(5, "0")}.png`);
     bundleCache = null;
   }
 });
@@ -2318,9 +2449,9 @@ __export(batch_exports, {
   parseCsv: () => parseCsv,
   runBatch: () => runBatch
 });
-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";
+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)) {
@@ -2414,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 mkdtemp3(join6(tmpdir4(), `reframe-batch-${index}-`));
-        const output = join6(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, {
@@ -2427,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 rm3(videoTmp, { force: true });
+            await rm4(videoTmp, { force: true });
           } else {
             await encodeMp4(captured.framesDir, captured.fps, output);
           }
         } finally {
-          await rm3(framesDir, { recursive: true, force: true });
+          await rm4(framesDir, { recursive: true, force: true });
         }
         result = {
           name,
@@ -2456,7 +2587,7 @@ async function runBatch(scene2, rows, opts) {
   };
   await Promise.all(Array.from({ length: Math.max(1, opts.concurrency) }, worker));
   await writeFile4(
-    join6(opts.outDir, "batch-report.json"),
+    join8(opts.outDir, "batch-report.json"),
     JSON.stringify({ rows: results }, null, 2)
   );
   return results;
@@ -2482,7 +2613,7 @@ __export(loadScene_exports, {
 });
 import { build as build2 } from "esbuild";
 import { readFile as readFile6 } from "node:fs/promises";
-import { dirname as dirname6, resolve as resolve4 } from "node:path";
+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 readFile6(path2, "utf8"));
@@ -2535,26 +2666,26 @@ var init_loadScene = __esm({
     "use strict";
     init_src();
     HERE = dirname6(fileURLToPath4(import.meta.url));
-    CORE_ENTRY = true ? resolve4(HERE, "index.js") : resolve4(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 spawn4, spawnSync } from "node:child_process";
-import { existsSync as existsSync5 } 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 isAbsolute4, join as join7, resolve as resolve5 } 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 ? resolve5(HERE2, "..") : resolve5(HERE2, "..", "..", "..");
+var ROOT2 = PACKAGED ? resolve6(HERE2, "..") : resolve6(HERE2, "..", "..", "..");
 var USER_CWD = process.env.INIT_CWD ?? process.cwd();
-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 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
 
@@ -2574,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) => isAbsolute4(p) ? p : resolve5(USER_CWD, p);
+var userPath = (p) => isAbsolute5(p) ? p : resolve6(USER_CWD, p);
 function fail(message) {
   console.error(`error: ${message}`);
   process.exit(2);
@@ -2584,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 = spawn4(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 } }
@@ -2676,7 +2807,7 @@ async function main() {
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync5(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)`);
@@ -2686,17 +2817,17 @@ ${USAGE}`);
         fail("html render requires --duration <seconds> (the page does not declare its own length)");
       }
       preflightFfmpeg();
-      const outBase = PACKAGED ? join7(USER_CWD, "out") : join7(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", join7(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": {
@@ -2705,9 +2836,9 @@ ${USAGE}`);
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync5(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": {
@@ -2716,13 +2847,13 @@ ${USAGE}`);
 
 ${USAGE}`);
       const inputPath = userPath(input);
-      if (!existsSync5(inputPath)) fail(`no such file: ${inputPath}`);
+      if (!existsSync6(inputPath)) fail(`no such file: ${inputPath}`);
       const oIdx = rest.indexOf("-o");
-      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`);
+      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": {
@@ -2739,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: tmpdir5 } = 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`);
@@ -2752,14 +2883,14 @@ ${USAGE}`);
         seed: num("seed")
       });
       const sceneIR = buildLogoSting2(data);
-      const tmp = join7(tmpdir5(), `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 ? join7(USER_CWD, "out") : join7(ROOT2, "out");
-      const out = flags.o ? userPath(flags.o) : join7(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": {
@@ -2767,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 (!existsSync5(p)) fail(`no such file: ${p}`);
+      for (const p of [scenePath, dataPath]) if (!existsSync6(p)) fail(`no such file: ${p}`);
       preflightFfmpeg();
-      let outDir = PACKAGED ? join7(USER_CWD, "out", "batch") : join7(ROOT2, "out", "batch");
+      let outDir = PACKAGED ? join9(USER_CWD, "out", "batch") : join9(ROOT2, "out", "batch");
       let concurrency = 3;
       let fps;
       const baseOverlayPaths = [];
@@ -2808,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: ${join7(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);
     }
@@ -2819,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 = join7(dirname7(vitePkg), "bin", "vite.js");
+        const viteBin = join9(dirname7(vitePkg), "bin", "vite.js");
         process.exit(
-          await run(process.execPath, [viteBin, join7(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 }
         })
       );
@@ -2839,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 ? join7(ROOT2, "examples", "scenes") : USER_CWD;
-      const target = join7(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 (existsSync5(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}
@@ -2856,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": {
@@ -2867,11 +2998,11 @@ ${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 ? 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 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;
@@ -2884,7 +3015,7 @@ ${results.length - failed} rendered (${orphaned} with orphans), ${failed} failed
       }
       preflightFfmpeg();
       process.exit(
-        await run("npx", ["tsx", join7(ROOT2, "examples", "scripts", "demo-edit-survival.ts")])
+        await run2("npx", ["tsx", join9(ROOT2, "examples", "scripts", "demo-edit-survival.ts")])
       );
     default:
       console.log(USAGE);