hyperframes 0.4.44 → 0.4.45

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.4.44" : "0.0.0-dev";
+    VERSION = true ? "0.4.45" : "0.0.0-dev";
   }
 });
 
@@ -10549,7 +10549,7 @@ import { get as httpsGet } from "https";
 import { pipeline } from "stream/promises";
 function downloadFile(url, dest) {
   const tmp = `${dest}.tmp`;
-  return new Promise((resolve40, reject) => {
+  return new Promise((resolve41, reject) => {
     const follow = (u) => {
       httpsGet(u, (res) => {
         if (res.statusCode === 301 || res.statusCode === 302) {
@@ -10566,7 +10566,7 @@ function downloadFile(url, dest) {
         const file = createWriteStream(tmp);
         pipeline(res, file).then(() => {
           renameSync(tmp, dest);
-          resolve40();
+          resolve41();
         }).catch((err) => {
           try {
             unlinkSync(tmp);
@@ -11291,7 +11291,7 @@ function hasNpx() {
   }
 }
 function runSkillsAdd(repo) {
-  return new Promise((resolve40, reject) => {
+  return new Promise((resolve41, reject) => {
     const child = spawn("npx", ["skills", "add", repo, "--all"], {
       stdio: "inherit",
       timeout: 12e4,
@@ -11305,7 +11305,7 @@ function runSkillsAdd(repo) {
       env: { ...process.env, GIT_CLONE_PROTECTION_ACTIVE: "0" }
     });
     child.on("close", (code, signal) => {
-      if (code === 0) resolve40();
+      if (code === 0) resolve41();
       else if (signal === "SIGINT" || code === 130) process.exit(0);
       else reject(new Error(`npx skills add exited with code ${code}`));
     });
@@ -12092,7 +12092,7 @@ function computePeaks(floats, count) {
   return peaks.map((p) => p / maxPeak);
 }
 function decodeAudioPeaks(audioPath) {
-  return new Promise((resolve40, reject) => {
+  return new Promise((resolve41, reject) => {
     const proc = spawn2(
       "ffmpeg",
       [
@@ -12125,7 +12125,7 @@ function decodeAudioPeaks(audioPath) {
         return;
       }
       const ab = buf.buffer.slice(buf.byteOffset, buf.byteOffset + numSamples * 4);
-      resolve40(computePeaks(new Float32Array(ab), PEAK_COUNT));
+      resolve41(computePeaks(new Float32Array(ab), PEAK_COUNT));
     });
     proc.on("error", reject);
   });
@@ -16065,8 +16065,8 @@ var init_custom_element_registry = __esm({
         } : (element) => element.localName === localName;
         registry.set(localName, { Class, check });
         if (waiting.has(localName)) {
-          for (const resolve40 of waiting.get(localName))
-            resolve40(Class);
+          for (const resolve41 of waiting.get(localName))
+            resolve41(Class);
           waiting.delete(localName);
         }
         ownerDocument.querySelectorAll(
@@ -16106,13 +16106,13 @@ var init_custom_element_registry = __esm({
        */
       whenDefined(localName) {
         const { registry, waiting } = this;
-        return new Promise((resolve40) => {
+        return new Promise((resolve41) => {
           if (registry.has(localName))
-            resolve40(registry.get(localName).Class);
+            resolve41(registry.get(localName).Class);
           else {
             if (!waiting.has(localName))
               waiting.set(localName, []);
-            waiting.get(localName).push(resolve40);
+            waiting.get(localName).push(resolve41);
           }
         });
       }
@@ -21818,12 +21818,12 @@ var require_CSSValueExpression = __commonJS({
         return false;
       }
     };
-    CSSOM.CSSValueExpression.prototype._parseJSString = function(token, idx, sep4) {
-      var endIdx = this._findMatchedIdx(token, idx, sep4), text;
+    CSSOM.CSSValueExpression.prototype._parseJSString = function(token, idx, sep5) {
+      var endIdx = this._findMatchedIdx(token, idx, sep5), text;
       if (endIdx === -1) {
         return false;
       } else {
-        text = token.substring(idx, endIdx + sep4.length);
+        text = token.substring(idx, endIdx + sep5.length);
         return {
           idx: endIdx,
           text
@@ -21863,15 +21863,15 @@ var require_CSSValueExpression = __commonJS({
       if (!isLegal) {
         return false;
       } else {
-        var sep4 = "/";
-        return this._parseJSString(token, idx, sep4);
+        var sep5 = "/";
+        return this._parseJSString(token, idx, sep5);
       }
     };
-    CSSOM.CSSValueExpression.prototype._findMatchedIdx = function(token, idx, sep4) {
+    CSSOM.CSSValueExpression.prototype._findMatchedIdx = function(token, idx, sep5) {
       var startIdx = idx, endIdx;
       var NOT_FOUND = -1;
       while (true) {
-        endIdx = token.indexOf(sep4, startIdx + 1);
+        endIdx = token.indexOf(sep5, startIdx + 1);
         if (endIdx === -1) {
           endIdx = NOT_FOUND;
           break;
@@ -26487,10 +26487,10 @@ async function waitForCloseWithTimeout(promise) {
       () => void 0,
       () => void 0
     ),
-    new Promise((resolve40) => {
+    new Promise((resolve41) => {
       timer = setTimeout(() => {
         timedOut = true;
-        resolve40();
+        resolve41();
       }, CAPTURE_SESSION_CLOSE_TIMEOUT_MS);
     })
   ]);
@@ -26579,7 +26579,7 @@ async function pollPageExpression(page, expression, timeoutMs, intervalMs = 100)
   while (Date.now() < deadline) {
     const ready = Boolean(await page.evaluate(expression));
     if (ready) return true;
-    await new Promise((resolve40) => setTimeout(resolve40, intervalMs));
+    await new Promise((resolve41) => setTimeout(resolve41, intervalMs));
   }
   return Boolean(await page.evaluate(expression));
 }
@@ -26613,7 +26613,7 @@ async function waitForOptionalTailwindReady(page, timeoutMs) {
     page.evaluate(
       `Promise.resolve(window.__tailwindReady).then(() => true, () => false)`
     ),
-    new Promise((resolve40) => setTimeout(() => resolve40(false), timeoutMs))
+    new Promise((resolve41) => setTimeout(() => resolve41(false), timeoutMs))
   ]);
   if (!ready) {
     throw new Error(
@@ -26668,12 +26668,12 @@ async function initializeSession(session) {
     const skipIdsLiteral = JSON.stringify(session.options.skipReadinessVideoIds ?? []);
     const videosReady = await pollPageExpression(
       page,
-      `(() => { const skip = new Set(${skipIdsLiteral}); const vids = Array.from(document.querySelectorAll("video")).filter(v => !skip.has(v.id)); return vids.length === 0 || vids.every(v => v.readyState >= 1); })()`,
+      `(() => { const skip = new Set(${skipIdsLiteral}); const vids = Array.from(document.querySelectorAll("video")).filter(v => !skip.has(v.id)); return vids.length === 0 || vids.every(v => v.readyState >= 2); })()`,
       pageReadyTimeout2
     );
     if (!videosReady) {
       throw new Error(
-        `[FrameCapture] video metadata not ready after ${pageReadyTimeout2}ms. Video elements must load metadata before capture starts.`
+        `[FrameCapture] video first frame not decoded after ${pageReadyTimeout2}ms. Video elements must reach readyState >= 2 (HAVE_CURRENT_DATA) before capture starts.`
       );
     }
     await page.evaluate(`document.fonts?.ready`);
@@ -26737,7 +26737,7 @@ async function initializeSession(session) {
   const videoDeadline = Date.now() + (session.config?.playerReadyTimeout ?? DEFAULT_CONFIG2.playerReadyTimeout);
   while (Date.now() < videoDeadline) {
     const videosReady = await page.evaluate(
-      `(() => { const skip = new Set(${beginframeSkipIdsLiteral}); const vids = Array.from(document.querySelectorAll("video")).filter(v => !skip.has(v.id)); return vids.length === 0 || vids.every(v => v.readyState >= 1); })()`
+      `(() => { const skip = new Set(${beginframeSkipIdsLiteral}); const vids = Array.from(document.querySelectorAll("video")).filter(v => !skip.has(v.id)); return vids.length === 0 || vids.every(v => v.readyState >= 2); })()`
     );
     if (videosReady) break;
     await new Promise((r2) => setTimeout(r2, 100));
@@ -26931,7 +26931,7 @@ var init_frameCapture = __esm({
 // ../engine/src/utils/gpuEncoder.ts
 import { spawn as spawn3 } from "child_process";
 async function detectGpuEncoder() {
-  return new Promise((resolve40) => {
+  return new Promise((resolve41) => {
     const ffmpeg = spawn3("ffmpeg", ["-encoders"], {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -26940,13 +26940,13 @@ async function detectGpuEncoder() {
       stdout2 += data.toString();
     });
     ffmpeg.on("close", () => {
-      if (stdout2.includes("h264_nvenc")) resolve40("nvenc");
-      else if (stdout2.includes("h264_videotoolbox")) resolve40("videotoolbox");
-      else if (stdout2.includes("h264_vaapi")) resolve40("vaapi");
-      else if (stdout2.includes("h264_qsv")) resolve40("qsv");
-      else resolve40(null);
+      if (stdout2.includes("h264_nvenc")) resolve41("nvenc");
+      else if (stdout2.includes("h264_videotoolbox")) resolve41("videotoolbox");
+      else if (stdout2.includes("h264_vaapi")) resolve41("vaapi");
+      else if (stdout2.includes("h264_qsv")) resolve41("qsv");
+      else resolve41(null);
     });
-    ffmpeg.on("error", () => resolve40(null));
+    ffmpeg.on("error", () => resolve41(null));
   });
 }
 async function getCachedGpuEncoder() {
@@ -27067,7 +27067,7 @@ async function runFfmpeg(args, opts) {
   const signal = opts?.signal;
   const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
   const onStderr = opts?.onStderr;
-  return new Promise((resolve40) => {
+  return new Promise((resolve41) => {
     const ffmpeg = spawn4("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -27093,7 +27093,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("close", (code) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve40({
+      resolve41({
         success: !signal?.aborted && code === 0,
         exitCode: code,
         stderr,
@@ -27103,7 +27103,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve40({
+      resolve41({
         success: false,
         exitCode: null,
         stderr: err.message,
@@ -27202,11 +27202,20 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
           else args.push("-global_quality", String(quality));
           break;
       }
+      if (codec === "h264" && (gpuEncoder === "nvenc" || gpuEncoder === "qsv" || gpuEncoder === "vaapi")) {
+        args.push("-bf", "0");
+        if (gpuEncoder === "qsv") {
+          args.push("-b_strategy", "0");
+        }
+      }
     } else {
       const encoderName = codec === "h264" ? "libx264" : "libx265";
       args.push("-c:v", encoderName, "-preset", preset);
       if (bitrate) args.push("-b:v", bitrate);
       else args.push("-crf", String(quality));
+      if (codec === "h264") {
+        args.push("-bf", "0");
+      }
       const xParamsFlag = codec === "h264" ? "-x264-params" : "-x265-params";
       const colorParams = codec === "h265" && options.hdr ? getHdrEncoderColorParams(options.hdr.transfer).x265ColorParams : "colorprim=bt709:transfer=bt709:colormatrix=bt709";
       if (preset === "ultrafast") {
@@ -27269,6 +27278,7 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
   if (gpuEncoder !== "vaapi") {
     args.push("-pix_fmt", pixelFormat);
   }
+  args.push("-avoid_negative_ts", "make_zero");
   args.push("-y", outputPath);
   return args;
 }
@@ -27295,7 +27305,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
   const inputPath = join22(framesDir, framePattern);
   const inputArgs = ["-framerate", String(options.fps), "-i", inputPath];
   const args = buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder);
-  return new Promise((resolve40) => {
+  return new Promise((resolve41) => {
     const ffmpeg = spawn5("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -27320,7 +27330,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
       if (signal) signal.removeEventListener("abort", onAbort);
       const durationMs = Date.now() - startTime;
       if (signal?.aborted) {
-        resolve40({
+        resolve41({
           success: false,
           outputPath,
           durationMs,
@@ -27331,7 +27341,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       if (code !== 0) {
-        resolve40({
+        resolve41({
           success: false,
           outputPath,
           durationMs,
@@ -27342,12 +27352,12 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       const fileSize = existsSync19(outputPath) ? statSync4(outputPath).size : 0;
-      resolve40({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
+      resolve41({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
     });
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve40({
+      resolve41({
         success: false,
         outputPath,
         durationMs: Date.now() - startTime,
@@ -27405,18 +27415,18 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     let gpuEncoder = null;
     if (options.useGpu) gpuEncoder = await getCachedGpuEncoder();
     const args = buildEncoderArgs(options, inputArgs, chunkPath, gpuEncoder);
-    const chunkResult = await new Promise((resolve40) => {
+    const chunkResult = await new Promise((resolve41) => {
       const ffmpeg = spawn5("ffmpeg", args);
       let stderr = "";
       ffmpeg.stderr.on("data", (d) => {
         stderr += d.toString();
       });
       ffmpeg.on("close", (code) => {
-        if (code === 0) resolve40({ success: true });
-        else resolve40({ success: false, error: `Chunk ${i2} encode failed: ${stderr.slice(-400)}` });
+        if (code === 0) resolve41({ success: true });
+        else resolve41({ success: false, error: `Chunk ${i2} encode failed: ${stderr.slice(-400)}` });
       });
       ffmpeg.on("error", (err) => {
-        resolve40({ success: false, error: `Chunk ${i2} encode error: ${err.message}` });
+        resolve41({ success: false, error: `Chunk ${i2} encode error: ${err.message}` });
       });
     });
     if (!chunkResult.success) {
@@ -27446,18 +27456,18 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     "-y",
     outputPath
   ];
-  const concatResult = await new Promise((resolve40) => {
+  const concatResult = await new Promise((resolve41) => {
     const ffmpeg = spawn5("ffmpeg", concatArgs);
     let stderr = "";
     ffmpeg.stderr.on("data", (d) => {
       stderr += d.toString();
     });
     ffmpeg.on("close", (code) => {
-      if (code === 0) resolve40({ success: true });
-      else resolve40({ success: false, error: `Chunk concat failed: ${stderr.slice(-400)}` });
+      if (code === 0) resolve41({ success: true });
+      else resolve41({ success: false, error: `Chunk concat failed: ${stderr.slice(-400)}` });
     });
     ffmpeg.on("error", (err) => {
-      resolve40({ success: false, error: `Chunk concat error: ${err.message}` });
+      resolve41({ success: false, error: `Chunk concat error: ${err.message}` });
     });
   });
   if (!concatResult.success) {
@@ -27492,6 +27502,7 @@ async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, confi
   } else {
     args.push("-c:a", "aac", "-b:a", "192k", "-movflags", "+faststart");
   }
+  args.push("-avoid_negative_ts", "make_zero");
   args.push("-shortest", "-y", outputPath);
   const processTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
   const result = await runFfmpeg(args, { signal, timeout: processTimeout });
@@ -27557,37 +27568,37 @@ import { dirname as dirname8 } from "path";
 function createFrameReorderBuffer(startFrame, endFrame) {
   let cursor = startFrame;
   const pending = /* @__PURE__ */ new Map();
-  const enqueueAt = (frame, resolve40) => {
+  const enqueueAt = (frame, resolve41) => {
     const list = pending.get(frame);
     if (list === void 0) {
-      pending.set(frame, [resolve40]);
+      pending.set(frame, [resolve41]);
     } else {
-      list.push(resolve40);
+      list.push(resolve41);
     }
   };
   const flushAt = (frame) => {
     const list = pending.get(frame);
     if (list === void 0) return;
     pending.delete(frame);
-    for (const resolve40 of list) resolve40();
+    for (const resolve41 of list) resolve41();
   };
-  const waitForFrame = (frame) => new Promise((resolve40) => {
+  const waitForFrame = (frame) => new Promise((resolve41) => {
     if (frame === cursor) {
-      resolve40();
+      resolve41();
       return;
     }
-    enqueueAt(frame, resolve40);
+    enqueueAt(frame, resolve41);
   });
   const advanceTo = (frame) => {
     cursor = frame;
     flushAt(frame);
   };
-  const waitForAllDone = () => new Promise((resolve40) => {
+  const waitForAllDone = () => new Promise((resolve41) => {
     if (cursor >= endFrame) {
-      resolve40();
+      resolve41();
       return;
     }
-    enqueueAt(endFrame, resolve40);
+    enqueueAt(endFrame, resolve41);
   });
   return { waitForFrame, advanceTo, waitForAllDone };
 }
@@ -27663,11 +27674,20 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
           else args.push("-global_quality", String(quality));
           break;
       }
+      if (codec === "h264" && (gpuEncoder === "nvenc" || gpuEncoder === "qsv" || gpuEncoder === "vaapi")) {
+        args.push("-bf", "0");
+        if (gpuEncoder === "qsv") {
+          args.push("-b_strategy", "0");
+        }
+      }
     } else {
       const encoderName = codec === "h264" ? "libx264" : "libx265";
       args.push("-c:v", encoderName, "-preset", preset);
       if (bitrate) args.push("-b:v", bitrate);
       else args.push("-crf", String(quality));
+      if (codec === "h264") {
+        args.push("-bf", "0");
+      }
       const xParamsFlag = codec === "h264" ? "-x264-params" : "-x265-params";
       const colorParams = options.rawInputFormat && options.hdr ? getHdrEncoderColorParams(options.hdr.transfer).x265ColorParams : "colorprim=bt709:transfer=bt709:colormatrix=bt709";
       if (preset === "ultrafast") {
@@ -27730,6 +27750,7 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
   if (gpuEncoder !== "vaapi") {
     args.push("-pix_fmt", pixelFormat);
   }
+  args.push("-avoid_negative_ts", "make_zero");
   args.push("-y", outputPath);
   return args;
 }
@@ -27749,7 +27770,7 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   let stderr = "";
   let exitCode = null;
   let exitPromiseResolve = null;
-  const exitPromise = new Promise((resolve40) => exitPromiseResolve = resolve40);
+  const exitPromise = new Promise((resolve41) => exitPromiseResolve = resolve41);
   ffmpeg.stderr?.on("data", (data) => {
     stderr += data.toString();
   });
@@ -27795,8 +27816,8 @@ Process error: ${err.message}`;
       if (signal) signal.removeEventListener("abort", onAbort);
       const stdin = ffmpeg.stdin;
       if (stdin && !stdin.destroyed) {
-        await new Promise((resolve40) => {
-          stdin.end(() => resolve40());
+        await new Promise((resolve41) => {
+          stdin.end(() => resolve41());
         });
       }
       await exitPromise;
@@ -27839,7 +27860,7 @@ import { spawn as spawn7 } from "child_process";
 import { readFileSync as readFileSync17 } from "fs";
 import { extname as extname4 } from "path";
 function runFfprobe(args) {
-  return new Promise((resolve40, reject) => {
+  return new Promise((resolve41, reject) => {
     const proc = spawn7("ffprobe", args);
     let stdout2 = "";
     let stderr = "";
@@ -27853,7 +27874,7 @@ function runFfprobe(args) {
       if (code !== 0) {
         reject(new Error(`[FFmpeg] ffprobe exited with code ${code}: ${stderr}`));
       } else {
-        resolve40(stdout2);
+        resolve41(stdout2);
       }
     });
     proc.on("error", (err) => {
@@ -27935,6 +27956,14 @@ function extractStillImageMetadata(filePath) {
     return null;
   }
 }
+function readTagCI(tags, name) {
+  if (!tags) return "";
+  const target = name.toLowerCase();
+  for (const [key2, value] of Object.entries(tags)) {
+    if (key2.toLowerCase() === target && typeof value === "string") return value;
+  }
+  return "";
+}
 function parseFrameRate(frameRateStr) {
   if (!frameRateStr) return 0;
   const parts = frameRateStr.split("/");
@@ -27992,7 +28021,7 @@ async function extractMediaMetadata(filePath) {
     const ffprobeColorSpace = colorTransfer || colorPrimaries || colorSpaceVal ? { colorTransfer, colorPrimaries, colorSpace: colorSpaceVal } : null;
     const colorSpace = ffprobeColorSpace ?? stillImageMeta?.colorSpace ?? null;
     const pixelFormat = videoStream.pix_fmt || "";
-    const alphaMode = videoStream.tags?.alpha_mode || "";
+    const alphaMode = readTagCI(videoStream.tags, "alpha_mode");
     const hasAlpha = /(^|[^a-z])yuva|rgba|argb|bgra|gbrap|gray[a-z0-9]*a/i.test(pixelFormat) || alphaMode === "1";
     return {
       durationSeconds: output?.format.duration ? parseFloat(output.format.duration) : 0,
@@ -29392,7 +29421,7 @@ var init_extractionCache = __esm({
 // ../engine/src/services/videoFrameExtractor.ts
 import { spawn as spawn8 } from "child_process";
 import { existsSync as existsSync24, mkdirSync as mkdirSync15, readdirSync as readdirSync9, rmSync as rmSync5 } from "fs";
-import { isAbsolute as isAbsolute3, join as join26 } from "path";
+import { isAbsolute as isAbsolute3, join as join26, posix as posix2, resolve as resolve13, sep as sep3 } from "path";
 function parseVideoElements(html) {
   const videos = [];
   const { document: document2 } = parseHTML(unwrapTemplate(html));
@@ -29474,8 +29503,8 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   if (isHdr && isMacOS) {
     args.push("-hwaccel", "videotoolbox");
   }
-  if (metadata.hasAlpha && metadata.videoCodec === "vp9") {
-    args.push("-c:v", "libvpx-vp9");
+  if (codecMayHaveAlpha(metadata.videoCodec)) {
+    args.push("-c:v", decoderForCodec(metadata.videoCodec));
   }
   args.push("-ss", String(startTime), "-i", videoPath, "-t", String(duration));
   const vfFilters = [];
@@ -29487,7 +29516,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   args.push("-q:v", format === "jpg" ? String(Math.ceil((100 - quality) / 3)) : "0");
   if (format === "png") args.push("-compression_level", "6");
   args.push("-y", outputPattern);
-  return new Promise((resolve40, reject) => {
+  return new Promise((resolve41, reject) => {
     const ffmpeg = spawn8("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -29522,7 +29551,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
       files.forEach((file, index) => {
         framePaths.set(index, join26(videoOutputDir, file));
       });
-      resolve40({
+      resolve41({
         videoId,
         srcPath: videoPath,
         outputDir: videoOutputDir,
@@ -29588,9 +29617,19 @@ function resolveSegmentDuration(requested, mediaStart, metadata) {
   const sourceRemaining = metadata.durationSeconds - mediaStart;
   return sourceRemaining > 0 ? sourceRemaining : metadata.durationSeconds;
 }
+function codecMayHaveAlpha(codec) {
+  return ALPHA_CAPABLE_CODECS.has((codec ?? "").toLowerCase());
+}
+function decoderForCodec(codec) {
+  const c2 = (codec ?? "").toLowerCase();
+  if (c2 === "vp9") return "libvpx-vp9";
+  if (c2 === "vp8") return "libvpx";
+  return c2;
+}
 function resolveFrameFormat(metadata, requested) {
   if (requested) return requested;
-  return metadata.hasAlpha ? "png" : "jpg";
+  if (metadata.hasAlpha || codecMayHaveAlpha(metadata.videoCodec)) return "png";
+  return "jpg";
 }
 async function convertVfrToCfr(inputPath, outputPath, targetFps, startTime, duration, signal, config) {
   const timeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
@@ -29623,6 +29662,24 @@ async function convertVfrToCfr(inputPath, outputPath, targetFps, startTime, dura
     );
   }
 }
+function resolveProjectRelativeSrc(src, baseDir, compiledDir) {
+  const fromCompiled = compiledDir ? join26(compiledDir, src) : null;
+  const fromBase = join26(baseDir, src);
+  const candidates = [];
+  if (fromCompiled) candidates.push(fromCompiled);
+  candidates.push(fromBase);
+  const baseAbs = resolve13(baseDir);
+  const fromBaseAbs = resolve13(fromBase);
+  if (!fromBaseAbs.startsWith(baseAbs + sep3) && fromBaseAbs !== baseAbs) {
+    const normalized = posix2.normalize(src.replace(/\\/g, "/"));
+    const stripped = normalized.replace(/^(\.\.\/)+/, "");
+    if (stripped && stripped !== src && !stripped.startsWith("..")) {
+      if (compiledDir) candidates.push(join26(compiledDir, stripped));
+      candidates.push(join26(baseDir, stripped));
+    }
+  }
+  return candidates.find(existsSync24) ?? fromBase;
+}
 async function extractAllVideoFrames(videos, baseDir, options, signal, config, compiledDir) {
   const startTime = Date.now();
   const extracted = [];
@@ -29642,13 +29699,13 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
   };
   const phase1Start = Date.now();
   const resolvedVideos = [];
+  const warnedSrcs = /* @__PURE__ */ new Set();
   for (const video of videos) {
     if (signal?.aborted) break;
     try {
       let videoPath = video.src;
       if (!isAbsolute3(videoPath) && !isHttpUrl(videoPath)) {
-        const fromCompiled = compiledDir ? join26(compiledDir, videoPath) : null;
-        videoPath = fromCompiled && existsSync24(fromCompiled) ? fromCompiled : join26(baseDir, videoPath);
+        videoPath = resolveProjectRelativeSrc(video.src, baseDir, compiledDir);
       }
       if (isHttpUrl(videoPath)) {
         const downloadDir = join26(options.outputDir, "_downloads");
@@ -29656,6 +29713,13 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         videoPath = await downloadToTemp(videoPath, downloadDir);
       }
       if (!existsSync24(videoPath)) {
+        if (!warnedSrcs.has(video.src)) {
+          warnedSrcs.add(video.src);
+          process.stderr.write(
+            `[hyperframes:render] WARNING: video src="${video.src}" could not be resolved on disk (looked for ${videoPath}). The rendered output will show this video's first frame for the entire clip duration. If your <video> lives inside a sub-composition, prefer project-root-relative paths (e.g. src="assets/foo.mp4") over "../assets/foo.mp4".
+`
+          );
+        }
         errors.push({ videoId: video.id, error: `Video file not found: ${videoPath}` });
         continue;
       }
@@ -29909,7 +29973,7 @@ function createFrameLookupTable(videos, extracted) {
   }
   return table;
 }
-var FrameLookupTable;
+var ALPHA_CAPABLE_CODECS, FrameLookupTable;
 var init_videoFrameExtractor = __esm({
   "../engine/src/services/videoFrameExtractor.ts"() {
     "use strict";
@@ -29921,6 +29985,7 @@ var init_videoFrameExtractor = __esm({
     init_config2();
     init_htmlTemplate();
     init_extractionCache();
+    ALPHA_CAPABLE_CODECS = /* @__PURE__ */ new Set(["vp9", "vp8", "prores"]);
     FrameLookupTable = class {
       videos = /* @__PURE__ */ new Map();
       orderedVideos = [];
@@ -30583,8 +30648,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
       try {
         let srcPath = element.src;
         if (!isAbsolute4(srcPath) && !isHttpUrl(srcPath)) {
-          const fromCompiled = compiledDir ? join27(compiledDir, srcPath) : null;
-          srcPath = fromCompiled && existsSync25(fromCompiled) ? fromCompiled : join27(baseDir, srcPath);
+          srcPath = resolveProjectRelativeSrc(element.src, baseDir, compiledDir);
         }
         if (isHttpUrl(srcPath)) {
           try {
@@ -30673,6 +30737,7 @@ var init_audioMixer = __esm({
     init_config2();
     init_runFfmpeg();
     init_htmlTemplate();
+    init_videoFrameExtractor();
   }
 });
 
@@ -30907,11 +30972,11 @@ function createFileServer(options) {
       headers: { "Content-Type": contentType }
     });
   });
-  return new Promise((resolve40) => {
+  return new Promise((resolve41) => {
     const server = serve({ fetch: app.fetch, port }, (info) => {
       const actualPort = info.port;
       const url = `http://localhost:${actualPort}`;
-      resolve40({
+      resolve41({
         url,
         port: actualPort,
         close: () => server.close()
@@ -32495,6 +32560,7 @@ __export(src_exports2, {
   resampleRgb48leObjectFit: () => resampleRgb48leObjectFit,
   resolveConfig: () => resolveConfig,
   resolveHeadlessShellPath: () => resolveHeadlessShellPath,
+  resolveProjectRelativeSrc: () => resolveProjectRelativeSrc,
   roundedRectAlpha: () => roundedRectAlpha,
   runFfmpeg: () => runFfmpeg,
   sampleRgb48le: () => sampleRgb48le,
@@ -32534,7 +32600,7 @@ var init_src2 = __esm({
 // ../producer/src/services/hyperframeRuntimeLoader.ts
 import { createHash as createHash3 } from "crypto";
 import { existsSync as existsSync29, readFileSync as readFileSync20 } from "fs";
-import { dirname as dirname10, resolve as resolve13 } from "path";
+import { dirname as dirname10, resolve as resolve14 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveHyperframeManifestPath() {
   if (process.env.PRODUCER_HYPERFRAME_MANIFEST_PATH) {
@@ -32570,7 +32636,7 @@ function resolveVerifiedHyperframeRuntime() {
       `[HyperframeRuntimeLoader] Invalid manifest at ${manifestPath}; missing iife artifact or sha256.`
     );
   }
-  const runtimePath = resolve13(dirname10(manifestPath), runtimeFileName);
+  const runtimePath = resolve14(dirname10(manifestPath), runtimeFileName);
   if (!existsSync29(runtimePath)) {
     throw new Error(`[HyperframeRuntimeLoader] Missing runtime artifact at ${runtimePath}.`);
   }
@@ -32594,18 +32660,18 @@ var init_hyperframeRuntimeLoader = __esm({
   "../producer/src/services/hyperframeRuntimeLoader.ts"() {
     "use strict";
     PRODUCER_DIR = dirname10(fileURLToPath2(import.meta.url));
-    SIBLING_MANIFEST_PATH = resolve13(PRODUCER_DIR, "hyperframe.manifest.json");
-    MODULE_RELATIVE_MANIFEST_PATH = resolve13(
+    SIBLING_MANIFEST_PATH = resolve14(PRODUCER_DIR, "hyperframe.manifest.json");
+    MODULE_RELATIVE_MANIFEST_PATH = resolve14(
       PRODUCER_DIR,
       "../../../core/dist/hyperframe.manifest.json"
     );
     CWD_RELATIVE_MANIFEST_PATHS = [
       // When bundled to a single file (dist/public-server.js), the manifest
       // is copied as a sibling by build.mjs
-      resolve13(PRODUCER_DIR, "hyperframe.manifest.json"),
-      resolve13(process.cwd(), "packages/core/dist/hyperframe.manifest.json"),
-      resolve13(process.cwd(), "../core/dist/hyperframe.manifest.json"),
-      resolve13(process.cwd(), "core/dist/hyperframe.manifest.json")
+      resolve14(PRODUCER_DIR, "hyperframe.manifest.json"),
+      resolve14(process.cwd(), "packages/core/dist/hyperframe.manifest.json"),
+      resolve14(process.cwd(), "../core/dist/hyperframe.manifest.json"),
+      resolve14(process.cwd(), "core/dist/hyperframe.manifest.json")
     ];
   }
 });
@@ -32614,11 +32680,11 @@ var init_hyperframeRuntimeLoader = __esm({
 import { Hono as Hono3 } from "hono";
 import { serve as serve2 } from "@hono/node-server";
 import { readFileSync as readFileSync21, existsSync as existsSync30, realpathSync, statSync as statSync8 } from "fs";
-import { join as join31, extname as extname7, resolve as resolve14, sep as sep3 } from "path";
+import { join as join31, extname as extname7, resolve as resolve15, sep as sep4 } from "path";
 function isPathInside(child, parent, options = {}) {
   const { resolveSymlinks = false, pathModule } = options;
-  const resolveFn = pathModule?.resolve ?? resolve14;
-  const separator = pathModule?.sep ?? sep3;
+  const resolveFn = pathModule?.resolve ?? resolve15;
+  const separator = pathModule?.sep ?? sep4;
   const resolvedChild = resolveFn(child);
   const resolvedParent = resolveFn(parent);
   const normalizedChild = resolveSymlinks && existsSync30(resolvedChild) ? realpathSync.native(resolvedChild) : resolvedChild;
@@ -32680,10 +32746,10 @@ function createFileServer2(options) {
       headers: { "Content-Type": contentType }
     });
   });
-  return new Promise((resolve40) => {
+  return new Promise((resolve41) => {
     const connections = /* @__PURE__ */ new Set();
     const server = serve2({ fetch: app.fetch, port }, (info) => {
-      resolve40({
+      resolve41({
         url: `http://localhost:${info.port}`,
         port: info.port,
         close: () => {
@@ -33469,7 +33535,7 @@ var init_deterministicFonts = __esm({
 
 // ../producer/src/services/htmlCompiler.ts
 import { readFileSync as readFileSync23, existsSync as existsSync32, mkdirSync as mkdirSync19 } from "fs";
-import { join as join34, dirname as dirname11, resolve as resolve15 } from "path";
+import { join as join34, dirname as dirname11, resolve as resolve16 } from "path";
 function dedupeElementsById(elements) {
   const deduped = /* @__PURE__ */ new Map();
   for (const element of elements) {
@@ -33613,7 +33679,7 @@ async function parseSubCompositions(html, projectDir, downloadDir, parentOffset
     const elEnd = elEndRaw ? parseFloat(elEndRaw) : Infinity;
     const absoluteStart = parentOffset + elStart;
     const absoluteEnd = Math.min(parentEnd, isFinite(elEnd) ? parentOffset + elEnd : Infinity);
-    const filePath = resolve15(projectDir, srcPath);
+    const filePath = resolve16(projectDir, srcPath);
     if (visited.has(filePath)) {
       continue;
     }
@@ -33805,7 +33871,7 @@ function inlineSubCompositions(html, subCompositions, projectDir) {
     if (!srcPath) continue;
     let compHtml = subCompositions.get(srcPath) || null;
     if (!compHtml) {
-      const filePath = resolve15(projectDir, srcPath);
+      const filePath = resolve16(projectDir, srcPath);
       if (existsSync32(filePath)) {
         compHtml = readFileSync23(filePath, "utf-8");
       }
@@ -33996,7 +34062,7 @@ ${safeText}
   return wrappedFragment ? document2.body.innerHTML || "" : document2.toString();
 }
 function collectExternalAssets(html, projectDir) {
-  const absProjectDir = resolve15(projectDir);
+  const absProjectDir = resolve16(projectDir);
   const externalAssets = /* @__PURE__ */ new Map();
   const CSS_URL_RE2 = /\burl\(\s*(["']?)([^)"']+)\1\s*\)/g;
   function processPath(rawPath) {
@@ -34004,7 +34070,7 @@ function collectExternalAssets(html, projectDir) {
     if (!trimmed || trimmed.startsWith("/") || trimmed.startsWith("http://") || trimmed.startsWith("https://") || trimmed.startsWith("//") || trimmed.startsWith("data:") || trimmed.startsWith("#")) {
       return null;
     }
-    const absPath = resolve15(absProjectDir, trimmed);
+    const absPath = resolve16(absProjectDir, trimmed);
     if (isPathInside2(absPath, absProjectDir)) {
       return null;
     }
@@ -34086,7 +34152,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir) {
   const images = dedupeElementsById([...mainImages, ...subImages]);
   for (const video of videos) {
     if (isHttpUrl(video.src)) continue;
-    const videoPath = resolve15(projectDir, video.src);
+    const videoPath = resolve16(projectDir, video.src);
     const reencode = `ffmpeg -i "${video.src}" -c:v libx264 -r 30 -g 30 -keyint_min 30 -movflags +faststart -c:a copy output.mp4`;
     Promise.all([analyzeKeyframeIntervals(videoPath), extractMediaMetadata(videoPath)]).then(([analysis, metadata]) => {
       if (analysis.isProblematic) {
@@ -34373,7 +34439,7 @@ import {
   appendFileSync,
   symlinkSync
 } from "fs";
-import { join as join35, dirname as dirname12, resolve as resolve16, relative as relative2, isAbsolute as isAbsolute5, basename as basename3 } from "path";
+import { join as join35, dirname as dirname12, resolve as resolve17, relative as relative2, isAbsolute as isAbsolute5, basename as basename3 } from "path";
 import { randomUUID as randomUUID2 } from "crypto";
 import { freemem as freemem2 } from "os";
 import { fileURLToPath as fileURLToPath3 } from "url";
@@ -34571,7 +34637,7 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
     writeFileSync15(outPath, html, "utf-8");
   }
   for (const [relativePath, absolutePath] of compiled.externalAssets) {
-    const outPath = resolve16(join35(compileDir, relativePath));
+    const outPath = resolve17(join35(compileDir, relativePath));
     if (!isPathInside2(outPath, compileDir)) {
       console.warn(`[Render] Skipping external asset with unsafe path: ${relativePath}`);
       continue;
@@ -34606,9 +34672,9 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
   }
 }
 function createCompiledFrameSrcResolver(compiledDir) {
-  const compiledRoot = resolve16(compiledDir);
+  const compiledRoot = resolve17(compiledDir);
   return (framePath) => {
-    const resolvedFramePath = resolve16(framePath);
+    const resolvedFramePath = resolve17(framePath);
     if (!isPathInside2(resolvedFramePath, compiledRoot)) return null;
     const relativePath = relative2(compiledRoot, resolvedFramePath);
     if (!relativePath || relativePath.startsWith("..") || isAbsolute5(relativePath)) {
@@ -35382,7 +35448,7 @@ function extractStandaloneEntryFromIndex(indexHtml, entryFile) {
 }
 async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSignal) {
   const moduleDir = dirname12(fileURLToPath3(import.meta.url));
-  const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve16(process.env.PRODUCER_RENDERS_DIR, "..") : resolve16(moduleDir, "../..");
+  const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve17(process.env.PRODUCER_RENDERS_DIR, "..") : resolve17(moduleDir, "../..");
   const debugDir = join35(producerRoot, ".debug");
   const workDir = job.config.debug ? join35(debugDir, job.id) : join35(dirname12(outputPath), `work-${job.id}`);
   const pipelineStart = Date.now();
@@ -35709,11 +35775,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     if (job.config.hdrMode !== "force-sdr" && composition.videos.length > 0) {
       await Promise.all(
         composition.videos.map(async (v) => {
-          let videoPath = v.src;
-          if (!videoPath.startsWith("/")) {
-            const fromCompiled = existsSync33(join35(compiledDir, videoPath)) ? join35(compiledDir, videoPath) : join35(projectDir, videoPath);
-            videoPath = fromCompiled;
-          }
+          const videoPath = isAbsolute5(v.src) ? v.src : resolveProjectRelativeSrc(v.src, projectDir, compiledDir);
           if (!existsSync33(videoPath)) return;
           const meta = await extractMediaMetadata(videoPath);
           if (isHdrColorSpace(meta.colorSpace)) {
@@ -37021,7 +37083,7 @@ var init_renderOrchestrator = __esm({
     };
     BROWSER_MEDIA_EPSILON = 1e-4;
     materializePathModule = {
-      resolve: resolve16,
+      resolve: resolve17,
       join: join35,
       dirname: dirname12,
       basename: basename3,
@@ -37065,7 +37127,7 @@ var init_config3 = __esm({
 
 // ../producer/src/services/hyperframeLint.ts
 import { existsSync as existsSync34, readFileSync as readFileSync25, statSync as statSync10 } from "fs";
-import { resolve as resolve17, join as join36 } from "path";
+import { resolve as resolve18, join as join36 } from "path";
 function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return false;
@@ -37092,7 +37154,7 @@ function pickEntryFile(files, preferredEntryFile) {
   return null;
 }
 function readProjectEntryFile(projectDir, preferredEntryFile) {
-  const absProjectDir = resolve17(projectDir);
+  const absProjectDir = resolve18(projectDir);
   if (!existsSync34(absProjectDir) || !statSync10(absProjectDir).isDirectory()) {
     return { error: `Project directory not found: ${absProjectDir}` };
   }
@@ -37100,7 +37162,7 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
     (value) => typeof value === "string" && value.trim().length > 0
   );
   for (const entryFile of entryCandidates) {
-    const absoluteEntryPath = resolve17(absProjectDir, entryFile);
+    const absoluteEntryPath = resolve18(absProjectDir, entryFile);
     if (!absoluteEntryPath.startsWith(absProjectDir)) {
       return { error: `Entry file must stay inside project directory: ${entryFile}` };
     }
@@ -37175,10 +37237,10 @@ var init_semaphore = __esm({
           this.active++;
           return () => this.release();
         }
-        return new Promise((resolve40) => {
+        return new Promise((resolve41) => {
           this.queue.push(() => {
             this.active++;
-            resolve40(() => this.release());
+            resolve41(() => this.release());
           });
         });
       }
@@ -37209,7 +37271,7 @@ import {
   rmSync as rmSync8,
   createReadStream
 } from "fs";
-import { resolve as resolve18, dirname as dirname13, join as join37 } from "path";
+import { resolve as resolve19, dirname as dirname13, join as join37 } from "path";
 import { tmpdir as tmpdir3 } from "os";
 import { parseArgs as parseArgs2 } from "util";
 import crypto2 from "crypto";
@@ -37231,12 +37293,12 @@ async function prepareRenderBody(body) {
   const options = parseRenderOptions(body);
   const projectDir = typeof body.projectDir === "string" ? body.projectDir : void 0;
   if (projectDir) {
-    const absProjectDir = resolve18(projectDir);
+    const absProjectDir = resolve19(projectDir);
     if (!existsSync35(absProjectDir) || !statSync11(absProjectDir).isDirectory()) {
       return { error: `Project directory not found: ${absProjectDir}` };
     }
     const entry = options.entryFile || "index.html";
-    if (!existsSync35(resolve18(absProjectDir, entry))) {
+    if (!existsSync35(resolve19(absProjectDir, entry))) {
       return { error: `Entry file "${entry}" not found in project directory: ${absProjectDir}` };
     }
     return { prepared: { input: { projectDir: absProjectDir, ...options } } };
@@ -37277,7 +37339,7 @@ function resolveOutputPath(projectDir, outputCandidate, rendersDir, log2) {
   try {
     return resolveRenderPaths(projectDir, outputCandidate, rendersDir).absoluteOutputPath;
   } catch (error) {
-    const fallbackPath = resolve18(rendersDir, `producer-fallback-${Date.now()}.mp4`);
+    const fallbackPath = resolve19(rendersDir, `producer-fallback-${Date.now()}.mp4`);
     log2.warn("Failed to resolve output path, using fallback", {
       fallback: fallbackPath,
       error: error instanceof Error ? error.message : String(error)
@@ -37665,7 +37727,7 @@ var init_server = __esm({
     init_paths();
     init_logger();
     init_semaphore();
-    entryScript = process.argv[1] ? resolve18(process.argv[1]) : "";
+    entryScript = process.argv[1] ? resolve19(process.argv[1]) : "";
     isPublicServerEntry = entryScript.endsWith("/public-server.js") || entryScript.endsWith("/src/server.ts");
     if (isPublicServerEntry) {
       const { values } = parseArgs2({
@@ -37739,18 +37801,18 @@ __export(studioServer_exports, {
 import { Hono as Hono5 } from "hono";
 import { streamSSE as streamSSE3 } from "hono/streaming";
 import { existsSync as existsSync36, readFileSync as readFileSync26, writeFileSync as writeFileSync17, statSync as statSync12 } from "fs";
-import { resolve as resolve19, join as join38, basename as basename4 } from "path";
+import { resolve as resolve20, join as join38, basename as basename4 } from "path";
 function resolveDistDir() {
   return resolveStudioBundle().dir;
 }
 function resolveStudioBundle() {
-  const builtPath = resolve19(__dirname, "studio");
-  const builtIndex = resolve19(builtPath, "index.html");
+  const builtPath = resolve20(__dirname, "studio");
+  const builtIndex = resolve20(builtPath, "index.html");
   if (existsSync36(builtIndex)) {
     return { dir: builtPath, indexPath: builtIndex, available: true, checkedPaths: [builtIndex] };
   }
-  const devPath = resolve19(__dirname, "..", "..", "..", "studio", "dist");
-  const devIndex = resolve19(devPath, "index.html");
+  const devPath = resolve20(__dirname, "..", "..", "..", "studio", "dist");
+  const devIndex = resolve20(devPath, "index.html");
   if (existsSync36(devIndex)) {
     return {
       dir: devPath,
@@ -37767,11 +37829,11 @@ function resolveStudioBundle() {
   };
 }
 function resolveRuntimePath() {
-  const builtPath = resolve19(__dirname, "hyperframe-runtime.js");
+  const builtPath = resolve20(__dirname, "hyperframe-runtime.js");
   if (existsSync36(builtPath)) return builtPath;
-  const iifePath = resolve19(__dirname, "hyperframe.runtime.iife.js");
+  const iifePath = resolve20(__dirname, "hyperframe.runtime.iife.js");
   if (existsSync36(iifePath)) return iifePath;
-  const devPath = resolve19(
+  const devPath = resolve20(
     __dirname,
     "..",
     "..",
@@ -37981,7 +38043,7 @@ function createStudioServer(options) {
     return api.fetch(forwardReq);
   });
   const serveStudioStaticFile = (c2) => {
-    const filePath = resolve19(studioDir, c2.req.path.slice(1));
+    const filePath = resolve20(studioDir, c2.req.path.slice(1));
     if (!existsSync36(filePath) || !statSync12(filePath).isFile()) return c2.text("not found", 404);
     const content = readFileSync26(filePath);
     return new Response(content, {
@@ -37991,7 +38053,7 @@ function createStudioServer(options) {
   app.get("/assets/*", serveStudioStaticFile);
   app.get("/icons/*", serveStudioStaticFile);
   app.get("*", (c2) => {
-    const indexPath = resolve19(studioDir, "index.html");
+    const indexPath = resolve20(studioDir, "index.html");
     if (!existsSync36(indexPath)) {
       return c2.html(
         `<!doctype html>
@@ -38074,12 +38136,12 @@ __export(preview_exports, {
 });
 import { spawn as spawn9 } from "child_process";
 import { existsSync as existsSync37, lstatSync, symlinkSync as symlinkSync2, unlinkSync as unlinkSync5, readlinkSync, mkdirSync as mkdirSync22 } from "fs";
-import { resolve as resolve20, dirname as dirname14, basename as basename5, join as join39 } from "path";
+import { resolve as resolve21, dirname as dirname14, basename as basename5, join as join39 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { createRequire } from "module";
 async function runDevMode(dir, projectName) {
   const thisFile = fileURLToPath4(import.meta.url);
-  const repoRoot = resolve20(dirname14(thisFile), "..", "..", "..", "..");
+  const repoRoot = resolve21(dirname14(thisFile), "..", "..", "..", "..");
   const projectsDir = join39(repoRoot, "packages", "studio", "data", "projects");
   const pName = projectName ?? basename5(dir);
   const symlinkPath = join39(projectsDir, pName);
@@ -38091,7 +38153,7 @@ async function runDevMode(dir, projectName) {
         const stat3 = lstatSync(symlinkPath);
         if (stat3.isSymbolicLink()) {
           const target = readlinkSync(symlinkPath);
-          if (resolve20(target) !== resolve20(dir)) {
+          if (resolve21(target) !== resolve21(dir)) {
             unlinkSync5(symlinkPath);
           }
         }
@@ -38145,8 +38207,8 @@ async function runDevMode(dir, projectName) {
       }
     });
   }
-  return new Promise((resolve40) => {
-    child.on("close", () => resolve40());
+  return new Promise((resolve41) => {
+    child.on("close", () => resolve41());
   });
 }
 function hasLocalStudio(dir) {
@@ -38168,7 +38230,7 @@ async function runLocalStudioMode(dir, projectName) {
   let createdSymlink = false;
   if (dir !== symlinkPath) {
     if (existsSync37(symlinkPath) && lstatSync(symlinkPath).isSymbolicLink()) {
-      if (resolve20(readlinkSync(symlinkPath)) !== resolve20(dir)) {
+      if (resolve21(readlinkSync(symlinkPath)) !== resolve21(dir)) {
         unlinkSync5(symlinkPath);
       }
     }
@@ -38216,8 +38278,8 @@ async function runLocalStudioMode(dir, projectName) {
       }
     });
   }
-  return new Promise((resolve40) => {
-    child.on("close", () => resolve40());
+  return new Promise((resolve41) => {
+    child.on("close", () => resolve41());
   });
 }
 async function runEmbeddedMode(dir, startPort, projectName, forceNew = false) {
@@ -38384,7 +38446,7 @@ var init_preview2 = __esm({
           return;
         }
         const rawArg = args.dir;
-        const dir = resolve20(rawArg ?? ".");
+        const dir = resolve21(rawArg ?? ".");
         const isImplicitCwd = !rawArg || rawArg === "." || rawArg === "./";
         const projectName = isImplicitCwd ? basename5(process.env.PWD ?? dir) : basename5(dir);
         const indexPath = join39(dir, "index.html");
@@ -38426,7 +38488,7 @@ import {
   readFileSync as readFileSync27,
   readdirSync as readdirSync13
 } from "fs";
-import { resolve as resolve21, basename as basename6, join as join40, dirname as dirname15 } from "path";
+import { resolve as resolve22, basename as basename6, join as join40, dirname as dirname15 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { execFileSync as execFileSync4, spawn as spawn10 } from "child_process";
 function probeVideo(filePath) {
@@ -38496,8 +38558,8 @@ function transcodeToMp4(inputPath, outputPath) {
 }
 function resolveAssetDir(devSegments, builtSegments) {
   const base = dirname15(fileURLToPath5(import.meta.url));
-  const devPath = resolve21(base, ...devSegments);
-  const builtPath = resolve21(base, ...builtSegments);
+  const devPath = resolve22(base, ...devSegments);
+  const builtPath = resolve22(base, ...builtSegments);
   return existsSync38(devPath) ? devPath : builtPath;
 }
 function getStaticTemplateDir(templateId) {
@@ -38525,7 +38587,7 @@ function buildPackageScripts() {
   };
 }
 function writeDefaultPackageJson(destDir, projectName) {
-  const packageJsonPath = resolve21(destDir, "package.json");
+  const packageJsonPath = resolve22(destDir, "package.json");
   if (existsSync38(packageJsonPath)) return;
   writeFileSync18(
     packageJsonPath,
@@ -38668,7 +38730,7 @@ async function handleVideoFile(videoPath, destDir, interactive) {
       }
       if (shouldTranscode) {
         const mp4Name = localVideoName.replace(/\.[^.]+$/, ".mp4");
-        const mp4Path = resolve21(destDir, mp4Name);
+        const mp4Path = resolve22(destDir, mp4Name);
         const spin = be();
         spin.start("Transcoding to H.264 MP4...");
         const ok = await transcodeToMp4(videoPath, mp4Path);
@@ -38677,10 +38739,10 @@ async function handleVideoFile(videoPath, destDir, interactive) {
           localVideoName = mp4Name;
         } else {
           spin.stop(c.warn("Transcode failed \u2014 copying original file"));
-          copyFileSync3(videoPath, resolve21(destDir, localVideoName));
+          copyFileSync3(videoPath, resolve22(destDir, localVideoName));
         }
       } else {
-        copyFileSync3(videoPath, resolve21(destDir, localVideoName));
+        copyFileSync3(videoPath, resolve22(destDir, localVideoName));
       }
     } else {
       if (interactive) {
@@ -38690,10 +38752,10 @@ async function handleVideoFile(videoPath, destDir, interactive) {
         console.log(c.warn("ffmpeg not installed \u2014 cannot transcode. Copying original."));
         console.log(c.dim("Install: ") + c.accent("brew install ffmpeg"));
       }
-      copyFileSync3(videoPath, resolve21(destDir, localVideoName));
+      copyFileSync3(videoPath, resolve22(destDir, localVideoName));
     }
   } else {
-    copyFileSync3(videoPath, resolve21(destDir, localVideoName));
+    copyFileSync3(videoPath, resolve22(destDir, localVideoName));
   }
   return { meta, localVideoName };
 }
@@ -38708,7 +38770,7 @@ async function scaffoldProject(destDir, name, templateId, localVideoName, durati
   patchVideoSrc(destDir, localVideoName, durationSeconds);
   if (tailwind) writeTailwindSupport(destDir);
   writeFileSync18(
-    resolve21(destDir, "meta.json"),
+    resolve22(destDir, "meta.json"),
     JSON.stringify(
       {
         id: name,
@@ -38720,7 +38782,7 @@ async function scaffoldProject(destDir, name, templateId, localVideoName, durati
     ),
     "utf-8"
   );
-  if (!existsSync38(resolve21(destDir, "hyperframes.json"))) {
+  if (!existsSync38(resolve22(destDir, "hyperframes.json"))) {
     const { writeProjectConfig: writeProjectConfig2, DEFAULT_PROJECT_CONFIG: DEFAULT_PROJECT_CONFIG2 } = await Promise.resolve().then(() => (init_projectConfig(), projectConfig_exports));
     writeProjectConfig2(destDir, DEFAULT_PROJECT_CONFIG2);
   }
@@ -38729,7 +38791,7 @@ async function scaffoldProject(destDir, name, templateId, localVideoName, durati
   if (existsSync38(sharedDir)) {
     for (const entry of readdirSync13(sharedDir, { withFileTypes: true })) {
       const src = join40(sharedDir, entry.name);
-      const dest = resolve21(destDir, entry.name);
+      const dest = resolve22(destDir, entry.name);
       if (entry.isFile() || entry.isSymbolicLink()) {
         copyFileSync3(src, dest);
       }
@@ -38851,7 +38913,7 @@ var init_init = __esm({
         if (!interactive) {
           const templateId2 = exampleFlag ?? "blank";
           const name2 = args.name ?? "my-video";
-          const destDir2 = resolve21(name2);
+          const destDir2 = resolve22(name2);
           if (existsSync38(destDir2) && readdirSync13(destDir2).length > 0) {
             console.error(c.error(`Directory already exists and is not empty: ${name2}`));
             process.exit(1);
@@ -38865,7 +38927,7 @@ var init_init = __esm({
             process.exit(1);
           }
           if (videoFlag) {
-            const videoPath = resolve21(videoFlag);
+            const videoPath = resolve22(videoFlag);
             if (!existsSync38(videoPath)) {
               console.error(c.error(`Video file not found: ${videoFlag}`));
               process.exit(1);
@@ -38879,13 +38941,13 @@ var init_init = __esm({
             );
           }
           if (audioFlag) {
-            const audioPath = resolve21(audioFlag);
+            const audioPath = resolve22(audioFlag);
             if (!existsSync38(audioPath)) {
               console.error(c.error(`Audio file not found: ${audioFlag}`));
               process.exit(1);
             }
             sourceFilePath2 = audioPath;
-            copyFileSync3(audioPath, resolve21(destDir2, basename6(audioPath)));
+            copyFileSync3(audioPath, resolve22(destDir2, basename6(audioPath)));
             console.log(`Audio: ${basename6(audioPath)}`);
           }
           if (sourceFilePath2 && !skipTranscribe) {
@@ -38926,7 +38988,7 @@ var init_init = __esm({
             process.exit(1);
           }
           trackInitTemplate(templateId2, { tailwind });
-          const transcriptFile2 = resolve21(destDir2, "transcript.json");
+          const transcriptFile2 = resolve22(destDir2, "transcript.json");
           if (existsSync38(transcriptFile2)) {
             await patchTranscript(destDir2, transcriptFile2);
           }
@@ -38981,7 +39043,7 @@ var init_init = __esm({
           }
           name = nameResult;
         }
-        const destDir = resolve21(name);
+        const destDir = resolve22(name);
         if (existsSync38(destDir) && readdirSync13(destDir).length > 0) {
           const overwrite = await Rt({
             message: `Directory ${c.accent(name)} already exists and is not empty. Overwrite?`,
@@ -38996,7 +39058,7 @@ var init_init = __esm({
         let sourceFilePath;
         let videoDuration;
         if (videoFlag) {
-          const videoPath = resolve21(videoFlag);
+          const videoPath = resolve22(videoFlag);
           if (!existsSync38(videoPath)) {
             R2.error(`File not found: ${videoFlag}`);
             Nt("Setup cancelled.");
@@ -39008,7 +39070,7 @@ var init_init = __esm({
           localVideoName = result.localVideoName;
           videoDuration = result.meta.durationSeconds;
         } else if (audioFlag) {
-          const audioPath = resolve21(audioFlag);
+          const audioPath = resolve22(audioFlag);
           if (!existsSync38(audioPath)) {
             R2.error(`File not found: ${audioFlag}`);
             Nt("Setup cancelled.");
@@ -39016,7 +39078,7 @@ var init_init = __esm({
           }
           mkdirSync23(destDir, { recursive: true });
           sourceFilePath = audioPath;
-          copyFileSync3(audioPath, resolve21(destDir, basename6(audioPath)));
+          copyFileSync3(audioPath, resolve22(destDir, basename6(audioPath)));
           R2.info(`Audio copied to ${c.accent(basename6(audioPath))}`);
         }
         if (sourceFilePath) {
@@ -39101,7 +39163,7 @@ ${c.dim("Use --example blank for offline use.")}`
           process.exit(1);
         }
         trackInitTemplate(templateId, { tailwind });
-        const transcriptFile = resolve21(destDir, "transcript.json");
+        const transcriptFile = resolve22(destDir, "transcript.json");
         if (existsSync38(transcriptFile)) {
           await patchTranscript(destDir, transcriptFile);
         }
@@ -39189,7 +39251,7 @@ __export(add_exports, {
   runAdd: () => runAdd
 });
 import { existsSync as existsSync39 } from "fs";
-import { resolve as resolve22, relative as relative3 } from "path";
+import { resolve as resolve23, relative as relative3 } from "path";
 function remapTarget(item, originalTarget, paths) {
   if (item.type === "hyperframes:block") {
     const blocksDir = paths.blocks.replace(/\/+$/, "");
@@ -39212,10 +39274,10 @@ function buildSnippet(item, relativeTarget) {
   return "";
 }
 async function runAdd(opts) {
-  const projectDir = resolve22(opts.projectDir);
+  const projectDir = resolve23(opts.projectDir);
   let config = loadProjectConfig(projectDir);
   const hasConfig = existsSync39(projectConfigPath(projectDir));
-  if (!hasConfig && existsSync39(resolve22(projectDir, "index.html"))) {
+  if (!hasConfig && existsSync39(resolve23(projectDir, "index.html"))) {
     writeProjectConfig(projectDir, DEFAULT_PROJECT_CONFIG);
     config = DEFAULT_PROJECT_CONFIG;
   }
@@ -39311,7 +39373,7 @@ var init_add = __esm({
         }
       },
       async run({ args }) {
-        const projectDir = resolve22(args.dir ?? process.cwd());
+        const projectDir = resolve23(args.dir ?? process.cwd());
         const json = args.json === true;
         const skipClipboard = args["no-clipboard"] === true;
         const hasConfigBefore = existsSync39(projectConfigPath(projectDir));
@@ -39359,7 +39421,7 @@ __export(catalog_exports, {
   default: () => catalog_default,
   examples: () => examples4
 });
-import { resolve as resolve23 } from "path";
+import { resolve as resolve24 } from "path";
 var examples4, catalog_default;
 var init_catalog = __esm({
   "src/commands/catalog.ts"() {
@@ -39403,7 +39465,7 @@ var init_catalog = __esm({
       async run({ args }) {
         const json = args.json === true;
         const interactive = args["human-friendly"] === true;
-        const dir = resolve23(process.cwd());
+        const dir = resolve24(process.cwd());
         const config = loadProjectConfig(dir) ?? DEFAULT_PROJECT_CONFIG;
         let typeFilter;
         if (args.type === "block") typeFilter = "hyperframes:block";
@@ -39528,11 +39590,11 @@ var init_format = __esm({
 
 // src/utils/project.ts
 import { existsSync as existsSync40, statSync as statSync13 } from "fs";
-import { resolve as resolve24, basename as basename7 } from "path";
+import { resolve as resolve25, basename as basename7 } from "path";
 function resolveProject(dirArg) {
-  const dir = resolve24(dirArg ?? ".");
+  const dir = resolve25(dirArg ?? ".");
   const name = basename7(dir);
-  const indexPath = resolve24(dir, "index.html");
+  const indexPath = resolve25(dir, "index.html");
   if (!existsSync40(dir) || !statSync13(dir).isDirectory()) {
     errorBox("Not a directory: " + dir);
     process.exit(1);
@@ -39561,7 +39623,7 @@ __export(play_exports, {
   examples: () => examples5
 });
 import { existsSync as existsSync41, readFileSync as readFileSync28 } from "fs";
-import { resolve as resolve25, dirname as dirname16 } from "path";
+import { resolve as resolve26, dirname as dirname16 } from "path";
 function commandDir() {
   return dirname16(new URL(import.meta.url).pathname);
 }
@@ -39569,10 +39631,10 @@ function resolveRuntimePath2() {
   const d = commandDir();
   const candidates = [
     // Bundled with CLI dist
-    resolve25(d, "hyperframe-runtime.js"),
-    resolve25(d, "..", "hyperframe-runtime.js"),
+    resolve26(d, "hyperframe-runtime.js"),
+    resolve26(d, "..", "hyperframe-runtime.js"),
     // Monorepo dev: commands/ → src/ → cli/ → packages/ then into core/dist/
-    resolve25(d, "..", "..", "..", "core", "dist", "hyperframe.runtime.iife.js")
+    resolve26(d, "..", "..", "..", "core", "dist", "hyperframe.runtime.iife.js")
   ];
   for (const p of candidates) {
     if (existsSync41(p)) return p;
@@ -39583,10 +39645,10 @@ function resolvePlayerPath() {
   const d = commandDir();
   const candidates = [
     // Monorepo dev: commands/ → src/ → cli/ → packages/ then into player/dist/
-    resolve25(d, "..", "..", "..", "player", "dist", "hyperframes-player.global.js"),
+    resolve26(d, "..", "..", "..", "player", "dist", "hyperframes-player.global.js"),
     // Bundled with CLI dist
-    resolve25(d, "hyperframes-player.global.js"),
-    resolve25(d, "..", "hyperframes-player.global.js")
+    resolve26(d, "hyperframes-player.global.js"),
+    resolve26(d, "..", "hyperframes-player.global.js")
   ];
   for (const p of candidates) {
     if (existsSync41(p)) return p;
@@ -39689,7 +39751,7 @@ var init_play = __esm({
         });
         app.get("/composition/*", async (ctx) => {
           const reqPath = ctx.req.path.replace("/composition/", "");
-          const filePath = resolve25(project.dir, reqPath);
+          const filePath = resolve26(project.dir, reqPath);
           if (!filePath.startsWith(project.dir)) return ctx.text("Forbidden", 403);
           if (!existsSync41(filePath)) return ctx.text("Not found", 404);
           const content = readFileSync28(filePath, "utf-8");
@@ -39993,7 +40055,7 @@ __export(publish_exports, {
   default: () => publish_default,
   examples: () => examples6
 });
-import { basename as basename9, resolve as resolve26 } from "path";
+import { basename as basename9, resolve as resolve27 } from "path";
 import { existsSync as existsSync42 } from "fs";
 import { join as join42 } from "path";
 var examples6, publish_default;
@@ -40027,7 +40089,7 @@ var init_publish = __esm({
       },
       async run({ args }) {
         const rawArg = args.dir;
-        const dir = resolve26(rawArg ?? ".");
+        const dir = resolve27(rawArg ?? ".");
         const isImplicitCwd = !rawArg || rawArg === "." || rawArg === "./";
         const projectName = isImplicitCwd ? basename9(process.env["PWD"] ?? dir) : basename9(dir);
         const indexPath = join42(dir, "index.html");
@@ -40224,9 +40286,9 @@ __export(render_exports, {
 });
 import { mkdirSync as mkdirSync24, readFileSync as readFileSync30, statSync as statSync15, writeFileSync as writeFileSync19, rmSync as rmSync9 } from "fs";
 import { cpus as cpus3, freemem as freemem3, tmpdir as tmpdir4 } from "os";
-import { resolve as resolve27, dirname as dirname17, join as join43, basename as basename10 } from "path";
+import { resolve as resolve28, dirname as dirname17, join as join43, basename as basename10 } from "path";
 import { execFileSync as execFileSync5, spawn as spawn11 } from "child_process";
-function parseVariablesArg(inline, filePath, readFile = (p) => readFileSync30(resolve27(p), "utf8")) {
+function parseVariablesArg(inline, filePath, readFile = (p) => readFileSync30(resolve28(p), "utf8")) {
   if (inline != null && filePath != null) {
     return { ok: false, error: { kind: "conflict" } };
   }
@@ -40324,8 +40386,8 @@ function dockerImageTag(version) {
   return `${DOCKER_IMAGE_PREFIX}:${version}`;
 }
 function resolveDockerfilePath() {
-  const builtPath = resolve27(__dirname, "docker", "Dockerfile.render");
-  const devPath = resolve27(__dirname, "..", "src", "docker", "Dockerfile.render");
+  const builtPath = resolve28(__dirname, "docker", "Dockerfile.render");
+  const devPath = resolve28(__dirname, "..", "src", "docker", "Dockerfile.render");
   for (const p of [builtPath, devPath]) {
     try {
       statSync15(p);
@@ -40402,8 +40464,8 @@ async function renderDocker(projectDir, outputPath, options) {
   const outputFilename = basename10(outputPath);
   const dockerArgs = buildDockerRunArgs({
     imageTag,
-    projectDir: resolve27(projectDir),
-    outputDir: resolve27(outputDir),
+    projectDir: resolve28(projectDir),
+    outputDir: resolve28(outputDir),
     outputFilename,
     options: {
       fps: options.fps,
@@ -40745,12 +40807,12 @@ var init_render2 = __esm({
           }
           process.env.PRODUCER_MAX_CONCURRENT_RENDERS = String(parsed);
         }
-        const rendersDir = resolve27("renders");
+        const rendersDir = resolve28("renders");
         const ext = FORMAT_EXT[format] ?? ".mp4";
         const now = /* @__PURE__ */ new Date();
         const datePart = now.toISOString().slice(0, 10);
         const timePart = now.toTimeString().slice(0, 8).replace(/:/g, "-");
-        const outputPath = args.output ? resolve27(args.output) : join43(rendersDir, `${project.name}_${datePart}_${timePart}${ext}`);
+        const outputPath = args.output ? resolve28(args.output) : join43(rendersDir, `${project.name}_${datePart}_${timePart}${ext}`);
         mkdirSync24(dirname17(outputPath), { recursive: true });
         const useDocker = args.docker ?? false;
         const useGpu = args.gpu ?? false;
@@ -41134,7 +41196,7 @@ var init_lint3 = __esm({
 // src/utils/staticProjectServer.ts
 import { createServer } from "http";
 import { existsSync as existsSync43, readFileSync as readFileSync31 } from "fs";
-import { isAbsolute as isAbsolute6, relative as relative5, resolve as resolve28 } from "path";
+import { isAbsolute as isAbsolute6, relative as relative5, resolve as resolve29 } from "path";
 async function serveStaticProjectHtml(projectDir, html, bindErrorMessage = "Failed to bind local HTTP server") {
   const server = createServer((req, res) => {
     const url = req.url ?? "/";
@@ -41143,7 +41205,7 @@ async function serveStaticProjectHtml(projectDir, html, bindErrorMessage = "Fail
       res.end(html);
       return;
     }
-    const filePath = resolve28(projectDir, decodeURIComponent(url).replace(/^\//, ""));
+    const filePath = resolve29(projectDir, decodeURIComponent(url).replace(/^\//, ""));
     const rel = relative5(projectDir, filePath);
     if (rel.startsWith("..") || isAbsolute6(rel)) {
       res.writeHead(403);
@@ -41329,7 +41391,7 @@ __export(layout_exports, {
   examples: () => examples9
 });
 import { existsSync as existsSync44, readFileSync as readFileSync32 } from "fs";
-import { dirname as dirname18, join as join44, resolve as resolve29 } from "path";
+import { dirname as dirname18, join as join44, resolve as resolve30 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 async function getCompositionDuration2(page) {
   return page.evaluate(() => {
@@ -41381,7 +41443,7 @@ async function seekTo(page, time) {
     if (!fonts?.ready) return Promise.resolve();
     return Promise.race([
       fonts.ready.then(() => void 0),
-      new Promise((resolve40) => setTimeout(resolve40, 500))
+      new Promise((resolve41) => setTimeout(resolve41, 500))
     ]);
   }).catch(() => {
   });
@@ -41390,7 +41452,7 @@ async function seekTo(page, time) {
 async function bundleProjectHtml(projectDir) {
   const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
   let html = await bundleToSingleHtml2(projectDir);
-  const runtimePath = resolve29(
+  const runtimePath = resolve30(
     __dirname2,
     "..",
     "..",
@@ -41458,7 +41520,7 @@ async function runLayoutAudit(projectDir, opts) {
       if (!fonts?.ready) return Promise.resolve();
       return Promise.race([
         fonts.ready.then(() => void 0),
-        new Promise((resolve40) => setTimeout(resolve40, 750))
+        new Promise((resolve41) => setTimeout(resolve41, 750))
       ]);
     }).catch(() => {
     });
@@ -41800,7 +41862,7 @@ __export(compositions_exports, {
   parseSubComposition: () => parseSubComposition
 });
 import { existsSync as existsSync45, readFileSync as readFileSync34 } from "fs";
-import { resolve as resolve30, dirname as dirname19 } from "path";
+import { resolve as resolve31, dirname as dirname19 } from "path";
 function countRenderableDescendants(root) {
   return Array.from(root.querySelectorAll("*")).filter(
     (el) => !NON_RENDERED_TAGS.has(el.tagName.toLowerCase())
@@ -41832,7 +41894,7 @@ function parseCompositions(html, baseDir) {
     const height = parseInt(div.getAttribute("data-height") ?? "1080", 10);
     const compositionSrc = div.getAttribute("data-composition-src");
     if (compositionSrc) {
-      const subPath = resolve30(baseDir, compositionSrc);
+      const subPath = resolve31(baseDir, compositionSrc);
       if (existsSync45(subPath)) {
         const subHtml = readFileSync34(subPath, "utf-8");
         const subInfo = parseSubComposition(subHtml, id, width, height);
@@ -41976,7 +42038,7 @@ __export(benchmark_exports, {
   examples: () => examples13
 });
 import { existsSync as existsSync46, statSync as statSync17 } from "fs";
-import { resolve as resolve31, join as join46 } from "path";
+import { resolve as resolve32, join as join46 } from "path";
 var examples13, DEFAULT_CONFIGS, benchmark_default;
 var init_benchmark = __esm({
   "src/commands/benchmark.ts"() {
@@ -42018,7 +42080,7 @@ var init_benchmark = __esm({
           process.exit(1);
         }
         const jsonOutput = args.json ?? false;
-        const benchDir = resolve31("renders", ".benchmark");
+        const benchDir = resolve32("renders", ".benchmark");
         let producer = null;
         try {
           producer = await loadProducer();
@@ -42444,7 +42506,7 @@ async function postprocess(sharp, output, rgb2, width, height, maskBuf, rgbaBuf)
   }
   const fullMask = await sharp(maskBuf, {
     raw: { width: INPUT_SIZE, height: INPUT_SIZE, channels: 1 }
-  }).resize(width, height, { kernel: "lanczos3", fit: "fill" }).raw().toBuffer();
+  }).resize(width, height, { kernel: "lanczos3", fit: "fill" }).toColourspace("b-w").raw().toBuffer();
   for (let i2 = 0; i2 < width * height; i2++) {
     rgbaBuf[i2 * 4] = rgb2[i2 * 3];
     rgbaBuf[i2 * 4 + 1] = rgb2[i2 * 3 + 1];
@@ -42468,9 +42530,13 @@ var init_inference = __esm({
 // src/background-removal/pipeline.ts
 var pipeline_exports = {};
 __export(pipeline_exports, {
+  DEFAULT_QUALITY: () => DEFAULT_QUALITY,
+  QUALITIES: () => QUALITIES,
+  QUALITY_CRF: () => QUALITY_CRF,
   buildEncoderArgs: () => buildEncoderArgs2,
   inferInputKind: () => inferInputKind,
   inferOutputFormat: () => inferOutputFormat,
+  isQuality: () => isQuality,
   render: () => render2,
   waitForExit: () => waitForExit
 });
@@ -42504,7 +42570,7 @@ async function probeMedia(inputPath) {
   const frameCount = meta.durationSeconds ? Math.round(meta.durationSeconds * fps) : 0;
   return { width: meta.width, height: meta.height, fps, frameCount };
 }
-function buildEncoderArgs2(format, width, height, fps, outputPath) {
+function buildEncoderArgs2(format, width, height, fps, outputPath, quality = DEFAULT_QUALITY) {
   const base = [
     "-y",
     "-f",
@@ -42526,7 +42592,7 @@ function buildEncoderArgs2(format, width, height, fps, outputPath) {
       "-b:v",
       "0",
       "-crf",
-      "30",
+      String(QUALITY_CRF[quality]),
       "-deadline",
       "good",
       "-row-mt",
@@ -42535,6 +42601,19 @@ function buildEncoderArgs2(format, width, height, fps, outputPath) {
       "0",
       "-pix_fmt",
       "yuva420p",
+      // Tag the output as BT.709 limited range so browsers use the same
+      // YUV→RGB matrix the source video was encoded with. Without these tags
+      // ffmpeg's default RGB→YUV conversion is BT.601, which causes a visible
+      // color shift (red/skin tones in particular) when the matted overlay is
+      // composited over the original mp4.
+      "-colorspace",
+      "bt709",
+      "-color_primaries",
+      "bt709",
+      "-color_trc",
+      "bt709",
+      "-color_range",
+      "tv",
       "-metadata:s:v:0",
       "alpha_mode=1",
       "-an",
@@ -42628,9 +42707,20 @@ async function runPipeline(options, session, media, format) {
     decoderStderr += d.toString();
   });
   const decoderExit = waitForExit(decoder, "ffmpeg decoder", () => decoderStderr);
-  const encoder = spawn12("ffmpeg", buildEncoderArgs2(format, width, height, fps || 30, outputPath), {
-    stdio: ["pipe", "ignore", "pipe"]
-  });
+  const encoder = spawn12(
+    "ffmpeg",
+    buildEncoderArgs2(
+      format,
+      width,
+      height,
+      fps || 30,
+      outputPath,
+      options.quality ?? DEFAULT_QUALITY
+    ),
+    {
+      stdio: ["pipe", "ignore", "pipe"]
+    }
+  );
   let encoderStderr = "";
   encoder.stderr?.on("data", (d) => {
     encoderStderr += d.toString();
@@ -42652,7 +42742,7 @@ async function runPipeline(options, session, media, format) {
       recentSlot = (recentSlot + 1) % RECENT_WINDOW;
       if (recentCount < RECENT_WINDOW) recentCount++;
       if (!encoder.stdin.write(rgba)) {
-        await new Promise((resolve40) => encoder.stdin.once("drain", () => resolve40()));
+        await new Promise((resolve41) => encoder.stdin.once("drain", () => resolve41()));
       }
       processed++;
       options.onProgress?.({
@@ -42678,11 +42768,11 @@ ${decoderStderr.slice(-400)}`
   return processed;
 }
 function waitForExit(proc, label2, getStderr) {
-  return new Promise((resolve40, reject) => {
+  return new Promise((resolve41, reject) => {
     proc.on("error", reject);
     proc.on("exit", (code, signal) => {
       if (code === 0 && !signal) {
-        resolve40();
+        resolve41();
         return;
       }
       const cause = signal ? `killed by ${signal}` : `exited with code ${code}`;
@@ -42690,12 +42780,20 @@ function waitForExit(proc, label2, getStderr) {
     });
   });
 }
-var VIDEO_EXTENSIONS2, IMAGE_EXTENSIONS, RECENT_WINDOW;
+var QUALITY_CRF, QUALITIES, DEFAULT_QUALITY, isQuality, VIDEO_EXTENSIONS2, IMAGE_EXTENSIONS, RECENT_WINDOW;
 var init_pipeline = __esm({
   "src/background-removal/pipeline.ts"() {
     "use strict";
     init_manager();
     init_inference();
+    QUALITY_CRF = {
+      fast: 30,
+      balanced: 18,
+      best: 12
+    };
+    QUALITIES = Object.keys(QUALITY_CRF);
+    DEFAULT_QUALITY = "balanced";
+    isQuality = (v) => typeof v === "string" && QUALITIES.includes(v);
     VIDEO_EXTENSIONS2 = /* @__PURE__ */ new Set([".mp4", ".mov", ".webm", ".mkv", ".avi"]);
     IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([".jpg", ".jpeg", ".png", ".webp"]);
     RECENT_WINDOW = 30;
@@ -42708,7 +42806,7 @@ __export(remove_background_exports, {
   default: () => remove_background_default,
   examples: () => examples15
 });
-import { resolve as resolve32 } from "path";
+import { resolve as resolve33 } from "path";
 import { existsSync as existsSync48 } from "fs";
 async function showInfo(json) {
   const { selectProviders: selectProviders2, listAvailableProviders: listAvailableProviders2, DEFAULT_MODEL: DEFAULT_MODEL4, MODEL_MEMORY_MB: MODEL_MEMORY_MB2, modelPath: modelPath2 } = await Promise.resolve().then(() => (init_manager3(), manager_exports3));
@@ -42748,6 +42846,7 @@ var init_remove_background = __esm({
     init_dist3();
     init_colors();
     init_manager3();
+    init_pipeline();
     examples15 = [
       [
         "Remove background from a video, output transparent VP9 WebM (default)",
@@ -42765,6 +42864,14 @@ var init_remove_background = __esm({
         "Force CPU (skip CoreML/CUDA)",
         "hyperframes remove-background avatar.mp4 -o transparent.webm --device cpu"
       ],
+      [
+        "Smaller file at the cost of color match (text-behind-subject won't blend as cleanly)",
+        "hyperframes remove-background avatar.mp4 -o transparent.webm --quality fast"
+      ],
+      [
+        "Visually-lossless WebM (master / re-encode source)",
+        "hyperframes remove-background avatar.mp4 -o transparent.webm --quality best"
+      ],
       ["Show detected providers without rendering", "hyperframes remove-background --info"]
     ];
     remove_background_default = defineCommand({
@@ -42788,6 +42895,11 @@ var init_remove_background = __esm({
           description: `Execution provider: ${DEVICES.join(", ")}`,
           default: "auto"
         },
+        quality: {
+          type: "string",
+          description: `Encoder quality preset for .webm output: ${QUALITIES.join(", ")} (default: ${DEFAULT_QUALITY}). Higher quality = closer color match when overlaying on the source mp4, larger file. Ignored for .mov / .png.`,
+          default: DEFAULT_QUALITY
+        },
         info: {
           type: "boolean",
           description: "Print detected execution providers and exit (no render)",
@@ -42821,8 +42933,14 @@ var init_remove_background = __esm({
           );
           process.exit(1);
         }
-        const inputPath = resolve32(args.input);
-        const outputPath = resolve32(args.output);
+        if (!isQuality(args.quality)) {
+          console.error(
+            c.error(`Invalid --quality '${String(args.quality)}'. Use: ${QUALITIES.join(", ")}.`)
+          );
+          process.exit(1);
+        }
+        const inputPath = resolve33(args.input);
+        const outputPath = resolve33(args.output);
         const { render: render3 } = await Promise.resolve().then(() => (init_pipeline(), pipeline_exports));
         const spin = args.json ? null : be();
         spin?.start("Preparing background-removal pipeline...");
@@ -42831,6 +42949,7 @@ var init_remove_background = __esm({
             inputPath,
             outputPath,
             device: args.device,
+            quality: args.quality,
             onProgress: (event) => {
               if (event.kind === "info") {
                 spin?.message(event.message);
@@ -42887,7 +43006,7 @@ __export(transcribe_exports2, {
   examples: () => examples16
 });
 import { existsSync as existsSync49, writeFileSync as writeFileSync20 } from "fs";
-import { resolve as resolve33, join as join48, extname as extname9 } from "path";
+import { resolve as resolve34, join as join48, extname as extname9 } from "path";
 async function importTranscript(inputPath, dir, json) {
   const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
   const { words, format } = loadTranscript2(inputPath);
@@ -43011,12 +43130,12 @@ var init_transcribe2 = __esm({
         }
       },
       async run({ args }) {
-        const inputPath = resolve33(args.input);
+        const inputPath = resolve34(args.input);
         if (!existsSync49(inputPath)) {
           console.error(c.error(`File not found: ${args.input}`));
           process.exit(1);
         }
-        const dir = resolve33(args.dir ?? ".");
+        const dir = resolve34(args.dir ?? ".");
         const ext = extname9(inputPath).toLowerCase();
         const isImport = ext === ".json" || ext === ".srt" || ext === ".vtt";
         if (isImport) {
@@ -43306,7 +43425,7 @@ __export(tts_exports, {
   examples: () => examples17
 });
 import { existsSync as existsSync52, readFileSync as readFileSync35 } from "fs";
-import { resolve as resolve34, extname as extname10 } from "path";
+import { resolve as resolve35, extname as extname10 } from "path";
 function listVoices(json) {
   const rows = BUNDLED_VOICES.map((v) => ({ ...v, defaultLang: inferLangFromVoiceId(v.id) }));
   if (json) {
@@ -43414,7 +43533,7 @@ var init_tts = __esm({
           process.exit(1);
         }
         let text;
-        const maybeFile = resolve34(args.input);
+        const maybeFile = resolve35(args.input);
         if (existsSync52(maybeFile) && extname10(maybeFile).toLowerCase() === ".txt") {
           text = readFileSync35(maybeFile, "utf-8").trim();
           if (!text) {
@@ -43428,7 +43547,7 @@ var init_tts = __esm({
           console.error(c.error("No text provided."));
           process.exit(1);
         }
-        const output = resolve34(args.output ?? "speech.wav");
+        const output = resolve35(args.output ?? "speech.wav");
         const voice = args.voice ?? DEFAULT_VOICE;
         const speed = args.speed ? parseFloat(args.speed) : 1;
         if (isNaN(speed) || speed <= 0 || speed > 3) {
@@ -43509,13 +43628,13 @@ __export(docs_exports, {
   examples: () => examples18
 });
 import { readFileSync as readFileSync36, existsSync as existsSync53 } from "fs";
-import { resolve as resolve35, dirname as dirname21, join as join51 } from "path";
+import { resolve as resolve36, dirname as dirname21, join as join51 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 function docsDir() {
   const thisFile = fileURLToPath7(import.meta.url);
   const dir = dirname21(thisFile);
-  const devPath = resolve35(dir, "..", "docs");
-  const builtPath = resolve35(dir, "docs");
+  const devPath = resolve36(dir, "..", "docs");
+  const builtPath = resolve36(dir, "docs");
   return existsSync53(devPath) ? devPath : builtPath;
 }
 function formatInlineCode(line) {
@@ -44062,7 +44181,7 @@ __export(validate_exports, {
   shouldIgnoreRequestFailure: () => shouldIgnoreRequestFailure
 });
 import { existsSync as existsSync54, readFileSync as readFileSync37 } from "fs";
-import { resolve as resolve36, join as join52, dirname as dirname22 } from "path";
+import { resolve as resolve37, join as join52, dirname as dirname22 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
 function shouldIgnoreRequestFailure(url, errorText) {
   if (errorText !== "net::ERR_ABORTED") return false;
@@ -44126,7 +44245,7 @@ async function validateInBrowser(projectDir, opts) {
   const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
   const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
   let html = await bundleToSingleHtml2(projectDir);
-  const runtimePath = resolve36(
+  const runtimePath = resolve37(
     __dirname3,
     "..",
     "..",
@@ -44350,7 +44469,7 @@ __export(snapshot_exports, {
 import { spawn as spawn13 } from "child_process";
 import { existsSync as existsSync55, mkdtempSync as mkdtempSync3, readFileSync as readFileSync38, mkdirSync as mkdirSync28, rmSync as rmSync10 } from "fs";
 import { tmpdir as tmpdir5 } from "os";
-import { resolve as resolve37, join as join53, relative as relative6, isAbsolute as isAbsolute7 } from "path";
+import { resolve as resolve38, join as join53, relative as relative6, isAbsolute as isAbsolute7 } from "path";
 async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false) {
   const tmp = mkdtempSync3(join53(tmpdir5(), "hf-snapshot-frame-"));
   const outPath = join53(tmp, "frame.png");
@@ -44547,7 +44666,7 @@ async function captureSnapshots(projectDir, opts) {
             try {
               const url = new URL(v.src);
               const decodedPath = decodeURIComponent(url.pathname).replace(/^\//, "");
-              const candidate = resolve37(projectDir, decodedPath);
+              const candidate = resolve38(projectDir, decodedPath);
               const rel = relative6(projectDir, candidate);
               if (!rel.startsWith("..") && !isAbsolute7(rel) && existsSync55(candidate)) {
                 filePath = candidate;
@@ -45043,7 +45162,7 @@ async function extractHtml(page, opts = {}) {
     (_match, pre, urls, post) => {
       const fixed = urls.replace(/&amp;/g, "&").replace(
         /(^|,\s*)(\/[^\s,]+)/g,
-        (_m, sep4, path2) => sep4 + pageOrigin + path2
+        (_m, sep5, path2) => sep5 + pageOrigin + path2
       );
       return pre + fixed + post;
     }
@@ -46140,7 +46259,7 @@ var require_p_retry = __commonJS({
       return error;
     };
     var isNetworkError = (errorMessage) => networkErrorMsgs.includes(errorMessage);
-    var pRetry2 = (input, options) => new Promise((resolve40, reject) => {
+    var pRetry2 = (input, options) => new Promise((resolve41, reject) => {
       options = {
         onFailedAttempt: () => {
         },
@@ -46150,7 +46269,7 @@ var require_p_retry = __commonJS({
       const operation = retry.operation(options);
       operation.attempt(async (attemptNumber) => {
         try {
-          resolve40(await input(attemptNumber));
+          resolve41(await input(attemptNumber));
         } catch (error) {
           if (!(error instanceof Error)) {
             reject(new TypeError(`Non-error was thrown: "${error}". You should only throw errors.`));
@@ -46686,8 +46805,8 @@ var require_retry3 = __commonJS({
       }
       const delay = getNextRetryDelay(config);
       err.config.retryConfig.currentRetryAttempt += 1;
-      const backoff = config.retryBackoff ? config.retryBackoff(err, delay) : new Promise((resolve40) => {
-        setTimeout(resolve40, delay);
+      const backoff = config.retryBackoff ? config.retryBackoff(err, delay) : new Promise((resolve41) => {
+        setTimeout(resolve41, delay);
       });
       if (config.onRetryAttempt) {
         await config.onRetryAttempt(err);
@@ -47595,8 +47714,8 @@ var require_helpers = __commonJS({
     function req(url, opts = {}) {
       const href = typeof url === "string" ? url : url.href;
       const req2 = (href.startsWith("https:") ? https2 : http4).request(url, opts);
-      const promise = new Promise((resolve40, reject) => {
-        req2.once("response", resolve40).once("error", reject).end();
+      const promise = new Promise((resolve41, reject) => {
+        req2.once("response", resolve41).once("error", reject).end();
       });
       req2.then = promise.then.bind(promise);
       return req2;
@@ -47773,7 +47892,7 @@ var require_parse_proxy_response = __commonJS({
     var debug_1 = __importDefault(require_src2());
     var debug = (0, debug_1.default)("https-proxy-agent:parse-proxy-response");
     function parseProxyResponse(socket) {
-      return new Promise((resolve40, reject) => {
+      return new Promise((resolve41, reject) => {
         let buffersLength = 0;
         const buffers = [];
         function read() {
@@ -47839,7 +47958,7 @@ var require_parse_proxy_response = __commonJS({
           }
           debug("got proxy server response: %o %o", firstLine, headers);
           cleanup();
-          resolve40({
+          resolve41({
             connect: {
               statusCode,
               statusText,
@@ -48083,7 +48202,7 @@ var require_ponyfill_es2018 = __commonJS({
         return new originalPromise(executor);
       }
       function promiseResolvedWith(value) {
-        return newPromise((resolve40) => resolve40(value));
+        return newPromise((resolve41) => resolve41(value));
       }
       function promiseRejectedWith(reason) {
         return originalPromiseReject(reason);
@@ -48253,8 +48372,8 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released reader");
       }
       function defaultReaderClosedPromiseInitialize(reader) {
-        reader._closedPromise = newPromise((resolve40, reject) => {
-          reader._closedPromise_resolve = resolve40;
+        reader._closedPromise = newPromise((resolve41, reject) => {
+          reader._closedPromise_resolve = resolve41;
           reader._closedPromise_reject = reject;
         });
       }
@@ -48428,8 +48547,8 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve40, reject) => {
-            resolvePromise = resolve40;
+          const promise = newPromise((resolve41, reject) => {
+            resolvePromise = resolve41;
             rejectPromise = reject;
           });
           const readRequest = {
@@ -48534,8 +48653,8 @@ var require_ponyfill_es2018 = __commonJS({
           const reader = this._reader;
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve40, reject) => {
-            resolvePromise = resolve40;
+          const promise = newPromise((resolve41, reject) => {
+            resolvePromise = resolve41;
             rejectPromise = reject;
           });
           const readRequest = {
@@ -49554,8 +49673,8 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve40, reject) => {
-            resolvePromise = resolve40;
+          const promise = newPromise((resolve41, reject) => {
+            resolvePromise = resolve41;
             rejectPromise = reject;
           });
           const readIntoRequest = {
@@ -49867,10 +49986,10 @@ var require_ponyfill_es2018 = __commonJS({
           wasAlreadyErroring = true;
           reason = void 0;
         }
-        const promise = newPromise((resolve40, reject) => {
+        const promise = newPromise((resolve41, reject) => {
           stream._pendingAbortRequest = {
             _promise: void 0,
-            _resolve: resolve40,
+            _resolve: resolve41,
             _reject: reject,
             _reason: reason,
             _wasAlreadyErroring: wasAlreadyErroring
@@ -49887,9 +50006,9 @@ var require_ponyfill_es2018 = __commonJS({
         if (state === "closed" || state === "errored") {
           return promiseRejectedWith(new TypeError(`The stream (in ${state} state) is not in the writable state and cannot be closed`));
         }
-        const promise = newPromise((resolve40, reject) => {
+        const promise = newPromise((resolve41, reject) => {
           const closeRequest = {
-            _resolve: resolve40,
+            _resolve: resolve41,
             _reject: reject
           };
           stream._closeRequest = closeRequest;
@@ -49902,9 +50021,9 @@ var require_ponyfill_es2018 = __commonJS({
         return promise;
       }
       function WritableStreamAddWriteRequest(stream) {
-        const promise = newPromise((resolve40, reject) => {
+        const promise = newPromise((resolve41, reject) => {
           const writeRequest = {
-            _resolve: resolve40,
+            _resolve: resolve41,
             _reject: reject
           };
           stream._writeRequests.push(writeRequest);
@@ -50520,8 +50639,8 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released writer");
       }
       function defaultWriterClosedPromiseInitialize(writer) {
-        writer._closedPromise = newPromise((resolve40, reject) => {
-          writer._closedPromise_resolve = resolve40;
+        writer._closedPromise = newPromise((resolve41, reject) => {
+          writer._closedPromise_resolve = resolve41;
           writer._closedPromise_reject = reject;
           writer._closedPromiseState = "pending";
         });
@@ -50557,8 +50676,8 @@ var require_ponyfill_es2018 = __commonJS({
         writer._closedPromiseState = "resolved";
       }
       function defaultWriterReadyPromiseInitialize(writer) {
-        writer._readyPromise = newPromise((resolve40, reject) => {
-          writer._readyPromise_resolve = resolve40;
+        writer._readyPromise = newPromise((resolve41, reject) => {
+          writer._readyPromise_resolve = resolve41;
           writer._readyPromise_reject = reject;
         });
         writer._readyPromiseState = "pending";
@@ -50645,7 +50764,7 @@ var require_ponyfill_es2018 = __commonJS({
         source._disturbed = true;
         let shuttingDown = false;
         let currentWrite = promiseResolvedWith(void 0);
-        return newPromise((resolve40, reject) => {
+        return newPromise((resolve41, reject) => {
           let abortAlgorithm;
           if (signal !== void 0) {
             abortAlgorithm = () => {
@@ -50790,7 +50909,7 @@ var require_ponyfill_es2018 = __commonJS({
             if (isError) {
               reject(error);
             } else {
-              resolve40(void 0);
+              resolve41(void 0);
             }
             return null;
           }
@@ -51071,8 +51190,8 @@ var require_ponyfill_es2018 = __commonJS({
         let branch1;
         let branch2;
         let resolveCancelPromise;
-        const cancelPromise = newPromise((resolve40) => {
-          resolveCancelPromise = resolve40;
+        const cancelPromise = newPromise((resolve41) => {
+          resolveCancelPromise = resolve41;
         });
         function pullAlgorithm() {
           if (reading) {
@@ -51163,8 +51282,8 @@ var require_ponyfill_es2018 = __commonJS({
         let branch1;
         let branch2;
         let resolveCancelPromise;
-        const cancelPromise = newPromise((resolve40) => {
-          resolveCancelPromise = resolve40;
+        const cancelPromise = newPromise((resolve41) => {
+          resolveCancelPromise = resolve41;
         });
         function forwardReaderError(thisReader) {
           uponRejection(thisReader._closedPromise, (r2) => {
@@ -51944,8 +52063,8 @@ var require_ponyfill_es2018 = __commonJS({
           const writableHighWaterMark = ExtractHighWaterMark(writableStrategy, 1);
           const writableSizeAlgorithm = ExtractSizeAlgorithm(writableStrategy);
           let startPromise_resolve;
-          const startPromise = newPromise((resolve40) => {
-            startPromise_resolve = resolve40;
+          const startPromise = newPromise((resolve41) => {
+            startPromise_resolve = resolve41;
           });
           InitializeTransformStream(this, startPromise, writableHighWaterMark, writableSizeAlgorithm, readableHighWaterMark, readableSizeAlgorithm);
           SetUpTransformStreamDefaultControllerFromTransformer(this, transformer);
@@ -52038,8 +52157,8 @@ var require_ponyfill_es2018 = __commonJS({
         if (stream._backpressureChangePromise !== void 0) {
           stream._backpressureChangePromise_resolve();
         }
-        stream._backpressureChangePromise = newPromise((resolve40) => {
-          stream._backpressureChangePromise_resolve = resolve40;
+        stream._backpressureChangePromise = newPromise((resolve41) => {
+          stream._backpressureChangePromise_resolve = resolve41;
         });
         stream._backpressure = backpressure;
       }
@@ -52207,8 +52326,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve40, reject) => {
-          controller._finishPromise_resolve = resolve40;
+        controller._finishPromise = newPromise((resolve41, reject) => {
+          controller._finishPromise_resolve = resolve41;
           controller._finishPromise_reject = reject;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
@@ -52234,8 +52353,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve40, reject) => {
-          controller._finishPromise_resolve = resolve40;
+        controller._finishPromise = newPromise((resolve41, reject) => {
+          controller._finishPromise_resolve = resolve41;
           controller._finishPromise_reject = reject;
         });
         const flushPromise = controller._flushAlgorithm();
@@ -52265,8 +52384,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const writable = stream._writable;
-        controller._finishPromise = newPromise((resolve40, reject) => {
-          controller._finishPromise_resolve = resolve40;
+        controller._finishPromise = newPromise((resolve41, reject) => {
+          controller._finishPromise_resolve = resolve41;
           controller._finishPromise_reject = reject;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
@@ -54235,7 +54354,7 @@ import zlib from "zlib";
 import Stream2, { PassThrough as PassThrough2, pipeline as pump } from "stream";
 import { Buffer as Buffer3 } from "buffer";
 async function fetch3(url, options_) {
-  return new Promise((resolve40, reject) => {
+  return new Promise((resolve41, reject) => {
     const request = new Request2(url, options_);
     const { parsedURL, options } = getNodeRequestOptions(request);
     if (!supportedSchemas.has(parsedURL.protocol)) {
@@ -54244,7 +54363,7 @@ async function fetch3(url, options_) {
     if (parsedURL.protocol === "data:") {
       const data = dist_default(request.url);
       const response2 = new Response2(data, { headers: { "Content-Type": data.typeFull } });
-      resolve40(response2);
+      resolve41(response2);
       return;
     }
     const send = (parsedURL.protocol === "https:" ? https : http3).request;
@@ -54366,7 +54485,7 @@ async function fetch3(url, options_) {
             if (responseReferrerPolicy) {
               requestOptions.referrerPolicy = responseReferrerPolicy;
             }
-            resolve40(fetch3(new Request2(locationURL, requestOptions)));
+            resolve41(fetch3(new Request2(locationURL, requestOptions)));
             finalize();
             return;
           }
@@ -54399,7 +54518,7 @@ async function fetch3(url, options_) {
       const codings = headers.get("Content-Encoding");
       if (!request.compress || request.method === "HEAD" || codings === null || response_.statusCode === 204 || response_.statusCode === 304) {
         response = new Response2(body, responseOptions);
-        resolve40(response);
+        resolve41(response);
         return;
       }
       const zlibOptions = {
@@ -54413,7 +54532,7 @@ async function fetch3(url, options_) {
           }
         });
         response = new Response2(body, responseOptions);
-        resolve40(response);
+        resolve41(response);
         return;
       }
       if (codings === "deflate" || codings === "x-deflate") {
@@ -54437,12 +54556,12 @@ async function fetch3(url, options_) {
             });
           }
           response = new Response2(body, responseOptions);
-          resolve40(response);
+          resolve41(response);
         });
         raw.once("end", () => {
           if (!response) {
             response = new Response2(body, responseOptions);
-            resolve40(response);
+            resolve41(response);
           }
         });
         return;
@@ -54454,11 +54573,11 @@ async function fetch3(url, options_) {
           }
         });
         response = new Response2(body, responseOptions);
-        resolve40(response);
+        resolve41(response);
         return;
       }
       response = new Response2(body, responseOptions);
-      resolve40(response);
+      resolve41(response);
     });
     writeToStream(request_, request).catch(reject);
   });
@@ -60540,7 +60659,7 @@ var require_jwtaccess = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve40, reject) => {
+        return new Promise((resolve41, reject) => {
           if (!inputStream) {
             reject(new Error("Must pass in a stream containing the service account auth settings."));
           }
@@ -60549,7 +60668,7 @@ var require_jwtaccess = __commonJS({
             try {
               const data = JSON.parse(s2);
               this.fromJSON(data);
-              resolve40();
+              resolve41();
             } catch (err) {
               reject(err);
             }
@@ -60788,7 +60907,7 @@ var require_jwtclient = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve40, reject) => {
+        return new Promise((resolve41, reject) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the service account auth settings.");
           }
@@ -60797,7 +60916,7 @@ var require_jwtclient = __commonJS({
             try {
               const data = JSON.parse(s2);
               this.fromJSON(data);
-              resolve40();
+              resolve41();
             } catch (e2) {
               reject(e2);
             }
@@ -60930,7 +61049,7 @@ var require_refreshclient = __commonJS({
         }
       }
       async fromStreamAsync(inputStream) {
-        return new Promise((resolve40, reject) => {
+        return new Promise((resolve41, reject) => {
           if (!inputStream) {
             return reject(new Error("Must pass in a stream containing the user refresh token."));
           }
@@ -60939,7 +61058,7 @@ var require_refreshclient = __commonJS({
             try {
               const data = JSON.parse(s2);
               this.fromJSON(data);
-              return resolve40();
+              return resolve41();
             } catch (err) {
               return reject(err);
             }
@@ -62772,7 +62891,7 @@ var require_pluggable_auth_handler = __commonJS({
        * @return A promise that resolves with the executable response.
        */
       retrieveResponseFromExecutable(envMap) {
-        return new Promise((resolve40, reject) => {
+        return new Promise((resolve41, reject) => {
           const child = childProcess.spawn(this.commandComponents[0], this.commandComponents.slice(1), {
             env: { ...process.env, ...Object.fromEntries(envMap) }
           });
@@ -62794,7 +62913,7 @@ var require_pluggable_auth_handler = __commonJS({
               try {
                 const responseJson = JSON.parse(output);
                 const response = new executable_response_1.ExecutableResponse(responseJson);
-                return resolve40(response);
+                return resolve41(response);
               } catch (error) {
                 if (error instanceof executable_response_1.ExecutableResponseError) {
                   return reject(error);
@@ -63697,7 +63816,7 @@ var require_googleauth = __commonJS({
         }
       }
       fromStreamAsync(inputStream, options) {
-        return new Promise((resolve40, reject) => {
+        return new Promise((resolve41, reject) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the Google auth settings.");
           }
@@ -63707,7 +63826,7 @@ var require_googleauth = __commonJS({
               try {
                 const data = JSON.parse(chunks.join(""));
                 const r2 = this._cacheClientFromJSON(data, options);
-                return resolve40(r2);
+                return resolve41(r2);
               } catch (err) {
                 if (!this.keyFilename)
                   throw err;
@@ -63717,7 +63836,7 @@ var require_googleauth = __commonJS({
                 });
                 this.cachedCredential = client;
                 this.setGapicJWTValues(client);
-                return resolve40(client);
+                return resolve41(client);
               }
             } catch (err) {
               return reject(err);
@@ -63753,17 +63872,17 @@ var require_googleauth = __commonJS({
        * Run the Google Cloud SDK command that prints the default project ID
        */
       async getDefaultServiceProjectId() {
-        return new Promise((resolve40) => {
+        return new Promise((resolve41) => {
           (0, child_process_1.exec)("gcloud config config-helper --format json", (err, stdout2) => {
             if (!err && stdout2) {
               try {
                 const projectId = JSON.parse(stdout2).configuration.properties.core.project;
-                resolve40(projectId);
+                resolve41(projectId);
                 return;
               } catch (e2) {
               }
             }
-            resolve40(null);
+            resolve41(null);
           });
         });
       }
@@ -71535,14 +71654,14 @@ function __asyncValues(o) {
   }, i2);
   function verb(n) {
     i2[n] = o[n] && function(v) {
-      return new Promise(function(resolve40, reject) {
-        v = o[n](v), settle(resolve40, reject, v.done, v.value);
+      return new Promise(function(resolve41, reject) {
+        v = o[n](v), settle(resolve41, reject, v.done, v.value);
       });
     };
   }
-  function settle(resolve40, reject, d, v) {
+  function settle(resolve41, reject, d, v) {
     Promise.resolve(v).then(function(v2) {
-      resolve40({ value: v2, done: d });
+      resolve41({ value: v2, done: d });
     }, reject);
   }
 }
@@ -82045,8 +82164,8 @@ var init_node4 = __esm({
         const url = `${websocketBaseUrl}/ws/google.ai.generativelanguage.${apiVersion}.GenerativeService.BidiGenerateMusic?key=${apiKey}`;
         let onopenResolve = () => {
         };
-        const onopenPromise = new Promise((resolve40) => {
-          onopenResolve = resolve40;
+        const onopenPromise = new Promise((resolve41) => {
+          onopenResolve = resolve41;
         });
         const callbacks = params.callbacks;
         const onopenAwaitedCallback = function() {
@@ -82252,8 +82371,8 @@ var init_node4 = __esm({
         }
         let onopenResolve = () => {
         };
-        const onopenPromise = new Promise((resolve40) => {
-          onopenResolve = resolve40;
+        const onopenPromise = new Promise((resolve41) => {
+          onopenResolve = resolve41;
         });
         const callbacks = params.callbacks;
         const onopenAwaitedCallback = function() {
@@ -84562,7 +84681,7 @@ var init_node4 = __esm({
         return void 0;
       }
     };
-    sleep$1 = (ms) => new Promise((resolve40) => setTimeout(resolve40, ms));
+    sleep$1 = (ms) => new Promise((resolve41) => setTimeout(resolve41, ms));
     FallbackEncoder = ({ headers, body }) => {
       return {
         bodyHeaders: {
@@ -85071,8 +85190,8 @@ ${underline2}`);
     };
     APIPromise = class _APIPromise extends Promise {
       constructor(client, responsePromise, parseResponse = defaultParseResponse) {
-        super((resolve40) => {
-          resolve40(null);
+        super((resolve41) => {
+          resolve41(null);
         });
         this.responsePromise = responsePromise;
         this.parseResponse = parseResponse;
@@ -86633,12 +86752,12 @@ var init_agentPromptGenerator = __esm({
 
 // src/capture/scaffolding.ts
 import { existsSync as existsSync56, writeFileSync as writeFileSync25, readFileSync as readFileSync41 } from "fs";
-import { join as join58, resolve as resolve38 } from "path";
+import { join as join58, resolve as resolve39 } from "path";
 function loadEnvFile(startDir) {
   try {
-    let dir = resolve38(startDir);
+    let dir = resolve39(startDir);
     for (let i2 = 0; i2 < 5; i2++) {
-      const envPath = resolve38(dir, ".env");
+      const envPath = resolve39(dir, ".env");
       try {
         const envContent = readFileSync41(envPath, "utf-8");
         for (const line of envContent.split("\n")) {
@@ -86652,7 +86771,7 @@ function loadEnvFile(startDir) {
         }
         break;
       } catch {
-        dir = resolve38(dir, "..");
+        dir = resolve39(dir, "..");
       }
     }
   } catch {
@@ -87419,7 +87538,7 @@ __export(capture_exports2, {
   default: () => capture_default,
   examples: () => examples23
 });
-import { resolve as resolve39 } from "path";
+import { resolve as resolve40 } from "path";
 var examples23, capture_default;
 var init_capture2 = __esm({
   "src/commands/capture.ts"() {
@@ -87478,7 +87597,7 @@ var init_capture2 = __esm({
           const hostname = new URL(url).hostname.replace(/^www\./, "");
           outputName = `captures/${hostname.replace(/\./g, "-")}`;
         }
-        const outputDir = resolve39(outputName);
+        const outputDir = resolve40(outputName);
         const isJson = args.json;
         if (!isJson) {
           const { c: c2 } = await Promise.resolve().then(() => (init_colors(), colors_exports));
@@ -87626,7 +87745,7 @@ var init_telemetry2 = __esm({
 
 // src/utils/installerDetection.ts
 import { realpathSync as realpathSync2 } from "fs";
-import { posix as posix2 } from "path";
+import { posix as posix3 } from "path";
 function resolveEntry() {
   const entry = process.argv[1];
   if (!entry) return null;
@@ -87645,7 +87764,7 @@ function isWorkspaceLink(realEntry) {
 }
 function isEphemeralExec(realEntry) {
   const normalized = normalizePath(realEntry);
-  return normalized.includes("/_npx/") || normalized.includes("/.npm/_npx/") || posix2.basename(posix2.dirname(normalized)).startsWith("bunx-");
+  return normalized.includes("/_npx/") || normalized.includes("/.npm/_npx/") || posix3.basename(posix3.dirname(normalized)).startsWith("bunx-");
 }
 function isHomebrewInstall(realEntry) {
   return normalizePath(realEntry).includes("/Cellar/hyperframes/");