hyperframes 0.7.21 → 0.7.22

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.7.21" : "0.0.0-dev";
+    VERSION = true ? "0.7.22" : "0.0.0-dev";
   }
 });
 
@@ -813,11 +813,11 @@ function __metadata(metadataKey, metadataValue) {
 }
 function __awaiter(thisArg, _arguments, P2, generator) {
   function adopt(value) {
-    return value instanceof P2 ? value : new P2(function(resolve60) {
-      resolve60(value);
+    return value instanceof P2 ? value : new P2(function(resolve61) {
+      resolve61(value);
     });
   }
-  return new (P2 || (P2 = Promise))(function(resolve60, reject) {
+  return new (P2 || (P2 = Promise))(function(resolve61, reject) {
     function fulfilled(value) {
       try {
         step(generator.next(value));
@@ -833,7 +833,7 @@ function __awaiter(thisArg, _arguments, P2, generator) {
       }
     }
     function step(result) {
-      result.done ? resolve60(result.value) : adopt(result.value).then(fulfilled, rejected);
+      result.done ? resolve61(result.value) : adopt(result.value).then(fulfilled, rejected);
     }
     step((generator = generator.apply(thisArg, _arguments || [])).next());
   });
@@ -1024,14 +1024,14 @@ function __asyncValues(o) {
   }, i2);
   function verb(n2) {
     i2[n2] = o[n2] && function(v2) {
-      return new Promise(function(resolve60, reject) {
-        v2 = o[n2](v2), settle(resolve60, reject, v2.done, v2.value);
+      return new Promise(function(resolve61, reject) {
+        v2 = o[n2](v2), settle(resolve61, reject, v2.done, v2.value);
       });
     };
   }
-  function settle(resolve60, reject, d2, v2) {
+  function settle(resolve61, reject, d2, v2) {
     Promise.resolve(v2).then(function(v3) {
-      resolve60({ value: v3, done: d2 });
+      resolve61({ value: v3, done: d2 });
     }, reject);
   }
 }
@@ -41859,8 +41859,8 @@ var init_custom_element_registry = __esm({
         } : (element) => element.localName === localName;
         registry.set(localName, { Class, check });
         if (waiting.has(localName)) {
-          for (const resolve60 of waiting.get(localName))
-            resolve60(Class);
+          for (const resolve61 of waiting.get(localName))
+            resolve61(Class);
           waiting.delete(localName);
         }
         ownerDocument.querySelectorAll(
@@ -41900,13 +41900,13 @@ var init_custom_element_registry = __esm({
        */
       whenDefined(localName) {
         const { registry, waiting } = this;
-        return new Promise((resolve60) => {
+        return new Promise((resolve61) => {
           if (registry.has(localName))
-            resolve60(registry.get(localName).Class);
+            resolve61(registry.get(localName).Class);
           else {
             if (!waiting.has(localName))
               waiting.set(localName, []);
-            waiting.get(localName).push(resolve60);
+            waiting.get(localName).push(resolve61);
           }
         });
       }
@@ -52142,14 +52142,14 @@ function inlineHelper(call, ctx) {
   };
   return expandBody(fn.body.body, bindings, prov, ctx);
 }
-function assignStep(update2, resolve60) {
-  if (update2.operator === "+=") return asNum(resolve60(update2.right));
+function assignStep(update2, resolve61) {
+  if (update2.operator === "+=") return asNum(resolve61(update2.right));
   if (update2.operator === "-=") {
-    const s2 = asNum(resolve60(update2.right));
+    const s2 = asNum(resolve61(update2.right));
     return s2 === void 0 ? void 0 : -s2;
   }
   if (update2.operator === "=" && update2.right?.type === "BinaryExpression") {
-    return asNum(resolve60(update2.right.right));
+    return asNum(resolve61(update2.right.right));
   }
   return void 0;
 }
@@ -52158,10 +52158,10 @@ function updatedVarName(update2) {
   if (update2?.type === "AssignmentExpression") return update2.left?.name ?? null;
   return null;
 }
-function loopStep(update2, varName, resolve60) {
+function loopStep(update2, varName, resolve61) {
   if (updatedVarName(update2) !== varName) return void 0;
   if (update2.type === "UpdateExpression") return update2.operator === "++" ? 1 : -1;
-  return assignStep(update2, resolve60);
+  return assignStep(update2, resolve61);
 }
 function asNum(v2) {
   return typeof v2 === "number" && Number.isFinite(v2) ? v2 : void 0;
@@ -52178,13 +52178,13 @@ function forInitVar(init) {
   const d2 = init.declarations[0];
   return d2.id?.type === "Identifier" ? { name: d2.id.name, initExpr: d2.init } : null;
 }
-function parseForHeader(stmt, resolve60) {
+function parseForHeader(stmt, resolve61) {
   const iv = forInitVar(stmt.init);
   const test = stmt.test;
   if (!iv || test?.type !== "BinaryExpression" || test.left?.name !== iv.name) return null;
-  const start = asNum(resolve60(iv.initExpr));
-  const end = asNum(resolve60(test.right));
-  const step = loopStep(stmt.update, iv.name, resolve60);
+  const start = asNum(resolve61(iv.initExpr));
+  const end = asNum(resolve61(test.right));
+  const step = loopStep(stmt.update, iv.name, resolve61);
   if (start === void 0 || end === void 0 || !step) return null;
   return { v: iv.name, start, end, op: test.operator, step };
 }
@@ -52296,12 +52296,12 @@ function expandStatements(stmts, ctx) {
   }
   return out;
 }
-function inlineComputedTimelines(ast, timelineVar, resolve60) {
+function inlineComputedTimelines(ast, timelineVar, resolve61) {
   const helpers = collectInlinableHelpers(ast, timelineVar);
   const ctx = {
     helpers,
     timelineVar,
-    resolve: resolve60,
+    resolve: resolve61,
     depth: 0,
     site: { n: 0 },
     order: { n: 0 }
@@ -59172,9 +59172,9 @@ var require_picocolors = __commonJS({
     var argv2 = p2.argv || [];
     var env = p2.env || {};
     var isColorSupported2 = !(!!env.NO_COLOR || argv2.includes("--no-color")) && (!!env.FORCE_COLOR || argv2.includes("--color") || p2.platform === "win32" || (p2.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
-    var formatter = (open2, close, replace4 = open2) => (input2) => {
-      let string = "" + input2, index = string.indexOf(close, open2.length);
-      return ~index ? open2 + replaceClose(string, close, replace4, index) + close : open2 + string + close;
+    var formatter = (open3, close, replace4 = open3) => (input2) => {
+      let string = "" + input2, index = string.indexOf(close, open3.length);
+      return ~index ? open3 + replaceClose(string, close, replace4, index) + close : open3 + string + close;
     };
     var replaceClose = (string, close, replace4, index) => {
       let result = "", cursor = 0;
@@ -60515,10 +60515,10 @@ async function waitForCloseWithTimeout(promise) {
       () => void 0,
       () => void 0
     ),
-    new Promise((resolve60) => {
+    new Promise((resolve61) => {
       timer = setTimeout(() => {
         timedOut = true;
-        resolve60();
+        resolve61();
       }, CAPTURE_SESSION_CLOSE_TIMEOUT_MS);
     })
   ]);
@@ -60630,7 +60630,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((resolve60) => setTimeout(resolve60, intervalMs));
+    await new Promise((resolve61) => setTimeout(resolve61, intervalMs));
   }
   return Boolean(await page.evaluate(expression));
 }
@@ -60679,7 +60679,7 @@ async function pollHfReady(page, timeoutMs, intervalMs = 100) {
         }
       }
     }
-    await new Promise((resolve60) => setTimeout(resolve60, intervalMs));
+    await new Promise((resolve61) => setTimeout(resolve61, intervalMs));
   }
   const diag = await evaluateHfDiagnostic(page);
   if (diag.hasSeek && diag.duration === 0) {
@@ -60745,7 +60745,7 @@ async function pollVideosReady(page, skipIds, timeoutMs, intervalMs = 100) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await check()) return true;
-    await new Promise((resolve60) => setTimeout(resolve60, intervalMs));
+    await new Promise((resolve61) => setTimeout(resolve61, intervalMs));
   }
   return check();
 }
@@ -60768,7 +60768,7 @@ async function pollImagesReady(page, timeoutMs, intervalMs = 100) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await check()) return true;
-    await new Promise((resolve60) => setTimeout(resolve60, intervalMs));
+    await new Promise((resolve61) => setTimeout(resolve61, intervalMs));
   }
   return check();
 }
@@ -60815,7 +60815,7 @@ async function waitForOptionalTailwindReady(page, timeoutMs) {
     page.evaluate(
       `Promise.resolve(window.__tailwindReady).then(() => true, () => false)`
     ),
-    new Promise((resolve60) => setTimeout(() => resolve60(false), timeoutMs))
+    new Promise((resolve61) => setTimeout(() => resolve61(false), timeoutMs))
   ]);
   if (!ready) {
     throw new Error(
@@ -61497,7 +61497,7 @@ var init_frameCapture = __esm({
     BROWSER_CONSOLE_BUFFER_SIZE = 200;
     CAPTURE_SESSION_CLOSE_TIMEOUT_MS = 5e3;
     LOCKED_WARMUP_TICKS = 60;
-    realSleep = (ms) => new Promise((resolve60) => setTimeout(resolve60, ms));
+    realSleep = (ms) => new Promise((resolve61) => setTimeout(resolve61, ms));
     HF_READY_DIAGNOSTIC_EXPR = `(function() {
   var hf = window.__hf;
   var player = window.__player;
@@ -61651,7 +61651,7 @@ async function selectUsableGpuEncoder(candidates, isUsable) {
   return null;
 }
 async function detectGpuEncoder() {
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const ffmpeg = spawn(getFfmpegBinary(), ["-encoders"], {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -61661,9 +61661,9 @@ async function detectGpuEncoder() {
     });
     ffmpeg.on("close", () => {
       const candidates = getCompiledGpuEncoders(stdout2);
-      void selectUsableGpuEncoder(candidates, canUseGpuEncoder).then(resolve60).catch(() => resolve60(null));
+      void selectUsableGpuEncoder(candidates, canUseGpuEncoder).then(resolve61).catch(() => resolve61(null));
     });
-    ffmpeg.on("error", () => resolve60(null));
+    ffmpeg.on("error", () => resolve61(null));
   });
 }
 async function getCachedGpuEncoder() {
@@ -61713,7 +61713,7 @@ function getProbeArgs(encoder) {
   return args;
 }
 async function canUseGpuEncoder(encoder) {
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     let settled = false;
     let timedOut = false;
     let killTimer;
@@ -61723,7 +61723,7 @@ async function canUseGpuEncoder(encoder) {
       settled = true;
       clearTimeout(timer);
       if (killTimer) clearTimeout(killTimer);
-      resolve60(usable);
+      resolve61(usable);
     };
     const ffmpeg = spawn(getFfmpegBinary(), getProbeArgs(encoder), {
       stdio: ["ignore", "ignore", "pipe"]
@@ -61862,6 +61862,22 @@ var init_hdr = __esm({
   }
 });
 
+// ../engine/src/utils/evenDimensions.ts
+function requiresEvenDimensions(pixelFormat) {
+  return pixelFormat.startsWith("yuv420") || pixelFormat.startsWith("yuvj420");
+}
+function withEvenDimensionPad(vfChain, pixelFormat) {
+  if (!requiresEvenDimensions(pixelFormat)) return vfChain;
+  return vfChain ? `${vfChain},${EVEN_DIMENSION_PAD}` : EVEN_DIMENSION_PAD;
+}
+var EVEN_DIMENSION_PAD;
+var init_evenDimensions = __esm({
+  "../engine/src/utils/evenDimensions.ts"() {
+    "use strict";
+    EVEN_DIMENSION_PAD = "pad=ceil(iw/2)*2:ceil(ih/2)*2";
+  }
+});
+
 // ../engine/src/utils/runFfmpeg.ts
 import { spawn as spawn2 } from "child_process";
 function formatWindowsFfmpegExit(exitCode) {
@@ -61894,7 +61910,7 @@ async function runFfmpeg(args, opts) {
   const signal = opts?.signal;
   const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
   const onStderr = opts?.onStderr;
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const ffmpeg = spawn2(getFfmpegBinary(), args);
     trackChildProcess(ffmpeg);
     let stderr = "";
@@ -61921,7 +61937,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("close", (code) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve60({
+      resolve61({
         success: !signal?.aborted && code === 0,
         exitCode: code,
         stderr,
@@ -61931,7 +61947,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve60({
+      resolve61({
         success: false,
         exitCode: null,
         stderr: err.message,
@@ -61956,7 +61972,7 @@ import { spawn as spawn3 } from "child_process";
 import { readFileSync as readFileSync3 } from "fs";
 import { extname } from "path";
 function runFfprobe(args) {
-  return new Promise((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     const command2 = getFfprobeBinary();
     const proc = spawn3(command2, args);
     let stdout2 = "";
@@ -61971,7 +61987,7 @@ function runFfprobe(args) {
       if (code !== 0) {
         reject(new Error(`[FFmpeg] ffprobe exited with code ${code}: ${stderr}`));
       } else {
-        resolve60(stdout2);
+        resolve61(stdout2);
       }
     });
     proc.on("error", (err) => {
@@ -62461,8 +62477,11 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
       if (vfIdx !== -1) {
         args[vfIdx + 1] = `scale=in_range=pc:out_range=tv,${args[vfIdx + 1]}`;
       }
-    } else if (!shouldUseGpu) {
-      args.push("-vf", "scale=in_range=pc:out_range=tv");
+    } else if (shouldUseGpu) {
+      const vf = withEvenDimensionPad("", pixelFormat);
+      if (vf) args.push("-vf", vf);
+    } else {
+      args.push("-vf", withEvenDimensionPad("scale=in_range=pc:out_range=tv", pixelFormat));
     }
     args.push("-video_track_timescale", "90000");
   }
@@ -62496,7 +62515,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
   const inputPath = join6(framesDir, framePattern);
   const inputArgs = ["-framerate", fpsToFfmpegArg(options.fps), "-i", inputPath];
   const args = buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder);
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const ffmpeg = spawn4(getFfmpegBinary(), args);
     trackChildProcess(ffmpeg);
     let stderr = "";
@@ -62524,7 +62543,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
       if (signal) signal.removeEventListener("abort", onAbort);
       const durationMs = Date.now() - startTime;
       if (signal?.aborted && !timedOut) {
-        resolve60({
+        resolve61({
           success: false,
           outputPath,
           durationMs,
@@ -62535,7 +62554,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       if (code !== 0 || timedOut) {
-        resolve60({
+        resolve61({
           success: false,
           outputPath,
           durationMs,
@@ -62550,12 +62569,12 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       const fileSize = existsSync6(outputPath) ? statSync(outputPath).size : 0;
-      resolve60({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
+      resolve61({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
     });
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve60({
+      resolve61({
         success: false,
         outputPath,
         durationMs: Date.now() - startTime,
@@ -62613,7 +62632,7 @@ 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((resolve60) => {
+    const chunkResult = await new Promise((resolve61) => {
       const ffmpeg = spawn4(getFfmpegBinary(), args);
       trackChildProcess(ffmpeg);
       let stderr = "";
@@ -62628,9 +62647,9 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
       });
       ffmpeg.on("close", (code) => {
         clearTimeout(timer);
-        if (code === 0 && !timedOut) resolve60({ success: true });
+        if (code === 0 && !timedOut) resolve61({ success: true });
         else {
-          resolve60({
+          resolve61({
             success: false,
             error: appendEncodeTimeoutMessage(
               `Chunk ${i2} encode failed: ${stderr.slice(-400)}`,
@@ -62642,7 +62661,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
       });
       ffmpeg.on("error", (err) => {
         clearTimeout(timer);
-        resolve60({
+        resolve61({
           success: false,
           error: appendEncodeTimeoutMessage(
             `Chunk ${i2} encode error: ${err.message}`,
@@ -62679,7 +62698,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     "-y",
     outputPath
   ];
-  const concatResult = await new Promise((resolve60) => {
+  const concatResult = await new Promise((resolve61) => {
     const ffmpeg = spawn4(getFfmpegBinary(), concatArgs);
     trackChildProcess(ffmpeg);
     let stderr = "";
@@ -62694,9 +62713,9 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     });
     ffmpeg.on("close", (code) => {
       clearTimeout(timer);
-      if (code === 0 && !timedOut) resolve60({ success: true });
+      if (code === 0 && !timedOut) resolve61({ success: true });
       else {
-        resolve60({
+        resolve61({
           success: false,
           error: appendEncodeTimeoutMessage(
             `Chunk concat failed: ${stderr.slice(-400)}`,
@@ -62708,7 +62727,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     });
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
-      resolve60({
+      resolve61({
         success: false,
         error: appendEncodeTimeoutMessage(
           `Chunk concat error: ${err.message}`,
@@ -62816,6 +62835,7 @@ var init_chunkEncoder = __esm({
     init_config2();
     init_gpuEncoder();
     init_hdr();
+    init_evenDimensions();
     init_runFfmpeg();
     init_ffmpegBinaries();
     init_ffprobe();
@@ -62847,37 +62867,37 @@ import { dirname as dirname5 } from "path";
 function createFrameReorderBuffer(startFrame, endFrame) {
   let cursor = startFrame;
   const pending = /* @__PURE__ */ new Map();
-  const enqueueAt = (frame, resolve60) => {
+  const enqueueAt = (frame, resolve61) => {
     const list = pending.get(frame);
     if (list === void 0) {
-      pending.set(frame, [resolve60]);
+      pending.set(frame, [resolve61]);
     } else {
-      list.push(resolve60);
+      list.push(resolve61);
     }
   };
   const flushAt = (frame) => {
     const list = pending.get(frame);
     if (list === void 0) return;
     pending.delete(frame);
-    for (const resolve60 of list) resolve60();
+    for (const resolve61 of list) resolve61();
   };
-  const waitForFrame = (frame) => new Promise((resolve60) => {
+  const waitForFrame = (frame) => new Promise((resolve61) => {
     if (frame === cursor) {
-      resolve60();
+      resolve61();
       return;
     }
-    enqueueAt(frame, resolve60);
+    enqueueAt(frame, resolve61);
   });
   const advanceTo = (frame) => {
     cursor = frame;
     flushAt(frame);
   };
-  const waitForAllDone = () => new Promise((resolve60) => {
+  const waitForAllDone = () => new Promise((resolve61) => {
     if (cursor >= endFrame) {
-      resolve60();
+      resolve61();
       return;
     }
-    enqueueAt(endFrame, resolve60);
+    enqueueAt(endFrame, resolve61);
   });
   return { waitForFrame, advanceTo, waitForAllDone };
 }
@@ -63036,8 +63056,11 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
       if (vfIdx !== -1) {
         args[vfIdx + 1] = `scale=in_range=pc:out_range=tv,${args[vfIdx + 1]}`;
       }
-    } else if (!shouldUseGpu) {
-      args.push("-vf", "scale=in_range=pc:out_range=tv");
+    } else if (shouldUseGpu) {
+      const vf = withEvenDimensionPad("", pixelFormat);
+      if (vf) args.push("-vf", vf);
+    } else {
+      args.push("-vf", withEvenDimensionPad("scale=in_range=pc:out_range=tv", pixelFormat));
     }
     args.push("-video_track_timescale", "90000");
   }
@@ -63065,7 +63088,7 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   let stderr = "";
   let exitCode = null;
   let exitPromiseResolve = null;
-  const exitPromise = new Promise((resolve60) => exitPromiseResolve = resolve60);
+  const exitPromise = new Promise((resolve61) => exitPromiseResolve = resolve61);
   ffmpeg.stderr?.on("data", (data2) => {
     stderr += data2.toString();
   });
@@ -63157,8 +63180,8 @@ Process error: ${err.message}`;
       if (signal) signal.removeEventListener("abort", onAbort);
       const stdin = ffmpeg.stdin;
       if (stdin && !stdin.destroyed) {
-        await new Promise((resolve60) => {
-          stdin.end(() => resolve60());
+        await new Promise((resolve61) => {
+          stdin.end(() => resolve61());
         });
       }
       await exitPromise;
@@ -63194,6 +63217,7 @@ var init_streamingEncoder = __esm({
     init_runFfmpeg();
     init_ffmpegBinaries();
     init_hdr();
+    init_evenDimensions();
     init_config2();
     init_dist3();
     init_vp9Options();
@@ -64423,14 +64447,14 @@ function inlineHelper2(call, ctx) {
   };
   return expandBody2(fn.body.body, bindings, prov, ctx);
 }
-function assignStep2(update2, resolve60) {
-  if (update2.operator === "+=") return asNum2(resolve60(update2.right));
+function assignStep2(update2, resolve61) {
+  if (update2.operator === "+=") return asNum2(resolve61(update2.right));
   if (update2.operator === "-=") {
-    const s2 = asNum2(resolve60(update2.right));
+    const s2 = asNum2(resolve61(update2.right));
     return s2 === void 0 ? void 0 : -s2;
   }
   if (update2.operator === "=" && update2.right?.type === "BinaryExpression") {
-    return asNum2(resolve60(update2.right.right));
+    return asNum2(resolve61(update2.right.right));
   }
   return void 0;
 }
@@ -64439,10 +64463,10 @@ function updatedVarName2(update2) {
   if (update2?.type === "AssignmentExpression") return update2.left?.name ?? null;
   return null;
 }
-function loopStep2(update2, varName, resolve60) {
+function loopStep2(update2, varName, resolve61) {
   if (updatedVarName2(update2) !== varName) return void 0;
   if (update2.type === "UpdateExpression") return update2.operator === "++" ? 1 : -1;
-  return assignStep2(update2, resolve60);
+  return assignStep2(update2, resolve61);
 }
 function asNum2(v2) {
   return typeof v2 === "number" && Number.isFinite(v2) ? v2 : void 0;
@@ -64459,13 +64483,13 @@ function forInitVar2(init) {
   const d2 = init.declarations[0];
   return d2.id?.type === "Identifier" ? { name: d2.id.name, initExpr: d2.init } : null;
 }
-function parseForHeader2(stmt, resolve60) {
+function parseForHeader2(stmt, resolve61) {
   const iv = forInitVar2(stmt.init);
   const test = stmt.test;
   if (!iv || test?.type !== "BinaryExpression" || test.left?.name !== iv.name) return null;
-  const start = asNum2(resolve60(iv.initExpr));
-  const end = asNum2(resolve60(test.right));
-  const step = loopStep2(stmt.update, iv.name, resolve60);
+  const start = asNum2(resolve61(iv.initExpr));
+  const end = asNum2(resolve61(test.right));
+  const step = loopStep2(stmt.update, iv.name, resolve61);
   if (start === void 0 || end === void 0 || !step) return null;
   return { v: iv.name, start, end, op: test.operator, step };
 }
@@ -64577,12 +64601,12 @@ function expandStatements2(stmts, ctx) {
   }
   return out;
 }
-function inlineComputedTimelines2(ast, timelineVar, resolve60) {
+function inlineComputedTimelines2(ast, timelineVar, resolve61) {
   const helpers = collectInlinableHelpers2(ast, timelineVar);
   const ctx = {
     helpers,
     timelineVar,
-    resolve: resolve60,
+    resolve: resolve61,
     depth: 0,
     site: { n: 0 },
     order: { n: 0 }
@@ -66495,6 +66519,11 @@ function extractFontFaceFamilies(styles) {
   }
   return families;
 }
+function normalizeUsedFontName(part) {
+  const name = part.trim().replace(/^['"]|['"]$/g, "").trim().toLowerCase();
+  if (!name || name.includes("(") || name.includes(")")) return null;
+  return name;
+}
 function extractUsedFontFamilies(styles) {
   const used = [];
   const seen = /* @__PURE__ */ new Set();
@@ -66503,9 +66532,8 @@ function extractUsedFontFamilies(styles) {
     const withoutFontFace = stripCssComments(style.content).replace(/@font-face\s*\{[^}]*\}/gi, "");
     let match;
     while ((match = propRe.exec(withoutFontFace)) !== null) {
-      const stack = match[1];
-      for (const part of stack.split(",")) {
-        const name = part.trim().replace(/^['"]|['"]$/g, "").trim().toLowerCase();
+      for (const part of match[1].split(",")) {
+        const name = normalizeUsedFontName(part);
         if (name && !GENERIC_FAMILIES.has(name) && !seen.has(name)) {
           seen.add(name);
           used.push(name);
@@ -67078,7 +67106,7 @@ function lintDuplicateAudioTracks(htmlSources) {
   }
   return findings;
 }
-var TAG_PATTERN, STYLE_BLOCK_PATTERN, SCRIPT_BLOCK_PATTERN, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, HEAD_BLOCKS_TO_IGNORE_PATTERN, HTML_TAG_PATTERN, HEAD_CONTENT_PATTERN, AFTER_HEAD_BEFORE_BODY_PATTERN, STRAY_HEAD_CLOSE_PATTERN, MARKDOWN_CODE_FENCE_PATTERN, ORPHAN_CSS_AT_RULE_PATTERN, ORPHAN_CSS_RULE_PATTERN, coreRules, mediaRules, SCENE_BOUNDARY_EPSILON_SECONDS, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, gsapRules, captionRules, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, compositionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, ALL_RULES, AUDIO_EXTENSIONS, STYLE_BLOCK_RE, OPEN_TAG_RE, MASK_IMAGE_URL_RE;
+var TAG_PATTERN, STYLE_BLOCK_PATTERN, SCRIPT_BLOCK_PATTERN, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, HEAD_BLOCKS_TO_IGNORE_PATTERN, HTML_TAG_PATTERN, HEAD_CONTENT_PATTERN, AFTER_HEAD_BEFORE_BODY_PATTERN, STRAY_HEAD_CLOSE_PATTERN, MARKDOWN_CODE_FENCE_PATTERN, ORPHAN_CSS_AT_RULE_PATTERN, ORPHAN_CSS_RULE_PATTERN, coreRules, mediaRules, SCENE_BOUNDARY_EPSILON_SECONDS, UNRESOLVED_TARGET, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, gsapRules, captionRules, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, compositionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, ALL_RULES, AUDIO_EXTENSIONS, STYLE_BLOCK_RE, OPEN_TAG_RE, MASK_IMAGE_URL_RE;
 var init_dist4 = __esm({
   "../lint/dist/index.js"() {
     "use strict";
@@ -67737,6 +67765,7 @@ var init_dist4 = __esm({
       findImperativeMediaControlFindings
     ];
     SCENE_BOUNDARY_EPSILON_SECONDS = 0.05;
+    UNRESOLVED_TARGET = "__unresolved__";
     gsapWindowsCache = /* @__PURE__ */ new Map();
     CONFLICTING_TRANSLATE_PROPS = ["x", "y", "xPercent", "yPercent"];
     CONFLICTING_SCALE_PROPS = ["scale", "scaleX", "scaleY"];
@@ -67774,6 +67803,7 @@ var init_dist4 = __esm({
             const left = gsapWindows[i2];
             if (!left) continue;
             if (left.end <= left.position) continue;
+            if (left.targetSelector === UNRESOLVED_TARGET) continue;
             for (let j3 = i2 + 1; j3 < gsapWindows.length; j3++) {
               const right = gsapWindows[j3];
               if (!right) continue;
@@ -67800,6 +67830,7 @@ ${right.raw}`)
           }
           if (clipStartBoundaries.length > 0) {
             for (const win of gsapWindows) {
+              if (win.targetSelector === UNRESOLVED_TARGET) continue;
               if (!isSceneBoundaryExit(win)) continue;
               const boundary = findMatchingSceneBoundary(win.end, clipStartBoundaries);
               if (boundary == null) continue;
@@ -68942,7 +68973,7 @@ ${right.raw}`)
           (t2) => /["']three["']/.test(t2) && /importmap/.test(scripts.find((s2) => s2.content === t2)?.attrs || "")
         );
         const hasThreeModuleImport = texts.some(
-          (t2) => /\bimport\b.*['"]three['"]/.test(t2) || /\bfrom\s+['"]three['"]/.test(t2)
+          (t2) => /\b(?:import|from)\s*[^;\n]*['"][^'"]*three[^'"]*['"]/i.test(t2)
         );
         if (!usesThree || hasThreeScript || hasThreeImportMap || hasThreeModuleImport) return [];
         return [
@@ -69051,6 +69082,12 @@ ${right.raw}`)
       "math",
       "emoji",
       "fangsong",
+      // Vendor-prefixed system-font keywords. Like `system-ui`, the engine resolves
+      // these to the OS UI font — they are never installable files and must not be
+      // flagged as a missing @font-face, even when a generic fallback follows them
+      // (e.g. `-apple-system, system-ui, sans-serif`).
+      "-apple-system",
+      "blinkmacsystemfont",
       "inherit",
       "initial",
       "unset",
@@ -69717,11 +69754,11 @@ function enforceCompositionPixelSizing(document2) {
     for (const [compId, { w: w3, h: h3 }] of sizeMap) {
       const escaped = compId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       const blockRe = new RegExp(`(\\[data-composition-id=["']${escaped}["']\\]\\s*\\{)([^}]*)(})`, "g");
-      css = css.replace(blockRe, (_, open2, body, close) => {
+      css = css.replace(blockRe, (_, open3, body, close) => {
         const newBody = body.replace(/(\bwidth\s*:\s*)100%/g, `$1${w3}px`).replace(/(\bheight\s*:\s*)100%/g, `$1${h3}px`);
         if (newBody !== body)
           modified = true;
-        return open2 + newBody + close;
+        return open3 + newBody + close;
       });
     }
     if (modified)
@@ -70414,7 +70451,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((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     const ffmpeg = spawn6(getFfmpegBinary(), args);
     trackChildProcess(ffmpeg);
     let stderr = "";
@@ -70450,7 +70487,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
       files.forEach((file, index) => {
         framePaths.set(index, join11(videoOutputDir, file));
       });
-      resolve60({
+      resolve61({
         videoId,
         srcPath: videoPath,
         outputDir: videoOutputDir,
@@ -72341,11 +72378,11 @@ function createFileServer(options) {
       headers: { "Content-Type": contentType }
     });
   });
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const server = serve({ fetch: app.fetch, port }, (info) => {
       const actualPort = info.port;
       const url = `http://localhost:${actualPort}`;
-      resolve60({
+      resolve61({
         url,
         port: actualPort,
         close: () => server.close()
@@ -74497,6 +74534,7 @@ __export(events_exports, {
   trackRenderError: () => trackRenderError,
   trackRenderFeedback: () => trackRenderFeedback,
   trackRenderObservation: () => trackRenderObservation,
+  trackSkillsInstallSkipped: () => trackSkillsInstallSkipped,
   trackTranscribeUnavailable: () => trackTranscribeUnavailable
 });
 function renderObservabilityEventProperties(props) {
@@ -74677,12 +74715,15 @@ function trackCommandFailure(command2, err) {
 function trackTranscribeUnavailable(props) {
   trackEvent("transcribe_unavailable", { optional: props.optional });
 }
+function trackSkillsInstallSkipped(props) {
+  trackEvent("cli skill install skipped", { reason: props.reason });
+}
 function trackRenderFeedback(props) {
   trackEvent("survey sent", {
     $survey_id: "render_satisfaction",
     $survey_response: props.rating,
     ...props.comment ? { $survey_response_2: props.comment } : {},
-    render_duration_ms: props.renderDurationMs,
+    ...props.renderDurationMs !== void 0 ? { render_duration_ms: props.renderDurationMs } : {},
     ...props.doctorSummary ? { doctor_summary: props.doctorSummary } : {}
   });
 }
@@ -77304,7 +77345,7 @@ import { get as httpsGet } from "https";
 import { pipeline } from "stream/promises";
 function downloadFile(url, dest) {
   const tmp = `${dest}.tmp`;
-  return new Promise((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     const follow = (u) => {
       httpsGet(u, (res) => {
         if (res.statusCode === 301 || res.statusCode === 302) {
@@ -77321,7 +77362,7 @@ function downloadFile(url, dest) {
         const file = createWriteStream2(tmp);
         pipeline(res, file).then(() => {
           renameSync2(tmp, dest);
-          resolve60();
+          resolve61();
         }).catch((err) => {
           try {
             unlinkSync(tmp);
@@ -78495,9 +78536,17 @@ function hasNpx() {
     return false;
   }
 }
+function hasGit2() {
+  try {
+    execFileSync3("git", ["--version"], { stdio: "ignore", timeout: 5e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function spawnNpx(args, opts = {}) {
   const npx = buildNpxCommand(args);
-  return new Promise((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     const child = spawn7(npx.command, npx.args, {
       stdio: "inherit",
       // We install with --full-depth (a full `git clone` of the repo, the only
@@ -78521,7 +78570,7 @@ function spawnNpx(args, opts = {}) {
       }
     });
     child.on("close", (code, signal) => {
-      if (code === 0) resolve60();
+      if (code === 0) resolve61();
       else if (signal === "SIGINT" || code === 130) process.exit(0);
       else reject(new Error(`npx ${args.join(" ")} exited with code ${code}`));
     });
@@ -78554,13 +78603,18 @@ function mirrorToInstalledAgents() {
   } catch {
   }
 }
-async function installAllSkills(opts = {}) {
-  if (!hasNpx()) {
-    const msg = "npx not found. Install Node.js and retry.";
-    if (opts.strict) throw new Error(msg);
-    R2.error(c.error(msg));
-    return;
+function skillsToolingReady(strict) {
+  for (const tool of SKILLS_TOOLING) {
+    if (tool.has()) continue;
+    if (strict) throw new Error(tool.error);
+    tool.report();
+    trackSkillsInstallSkipped({ reason: tool.reason });
+    return false;
   }
+  return true;
+}
+async function installAllSkills(opts = {}) {
+  if (!skillsToolingReady(opts.strict ?? false)) return;
   for (const source of SOURCES) {
     console.log();
     console.log(c.bold(`Installing ${source.name} skills...`));
@@ -78625,7 +78679,7 @@ function renderCheck(result) {
   }
   console.log();
 }
-var examples, GLOBAL_INSTALL_ARGS, PLAIN_SKILL_NAME, SOURCES, checkCommand, updateCommand, skills_default;
+var examples, GLOBAL_INSTALL_ARGS, PLAIN_SKILL_NAME, SOURCES, SKILLS_TOOLING, checkCommand, updateCommand, skills_default;
 var init_skills = __esm({
   "src/commands/skills.ts"() {
     "use strict";
@@ -78636,6 +78690,7 @@ var init_skills = __esm({
     init_updateCheck();
     init_skillsManifest();
     init_skillsMirror();
+    init_events();
     examples = [
       ["Install all HyperFrames skills", "hyperframes skills"],
       ["Check whether installed skills are up to date", "hyperframes skills check"],
@@ -78655,6 +78710,22 @@ var init_skills = __esm({
     ];
     PLAIN_SKILL_NAME = /^[a-z0-9][a-z0-9._-]*$/i;
     SOURCES = [{ name: "HyperFrames", url: "https://github.com/heygen-com/hyperframes" }];
+    SKILLS_TOOLING = [
+      {
+        has: hasNpx,
+        error: "npx not found. Install Node.js and retry.",
+        reason: "npx_missing",
+        report: () => R2.error(c.error("npx not found. Install Node.js and retry."))
+      },
+      {
+        has: hasGit2,
+        error: "git not found. Install git and retry to add AI coding skills.",
+        reason: "git_missing",
+        // Skip cleanly rather than letting the upstream clone dump a noisy
+        // multi-line `spawn git ENOENT` / "Installation failed" abort.
+        report: () => console.log(c.dim("Skipping AI coding skills: git not available."))
+      }
+    ];
     checkCommand = defineCommand({
       meta: { name: "check", description: "Check whether installed skills are the latest version" },
       args: {
@@ -78973,6 +79044,30 @@ var init_transcribe = __esm({
   }
 });
 
+// src/utils/errorMessage.ts
+function normalizeErrorMessage(error) {
+  if (error instanceof Error) return error.message;
+  if (typeof error === "string") return error;
+  if (typeof error === "object" && error !== null) {
+    const msg = error.message;
+    if (typeof msg === "string") return msg;
+    try {
+      return JSON.stringify(error);
+    } catch {
+      try {
+        return `{${Object.keys(error).join(", ")}}`;
+      } catch {
+      }
+    }
+  }
+  return String(error ?? "unknown error");
+}
+var init_errorMessage = __esm({
+  "src/utils/errorMessage.ts"() {
+    "use strict";
+  }
+});
+
 // src/utils/openBrowser.ts
 import { spawn as spawn8 } from "child_process";
 function parseRemoteDebuggingPort(value) {
@@ -79434,6 +79529,11 @@ function formatDuration(ms) {
   const remaining = seconds - minutes * 60;
   return `${minutes}m ${remaining.toFixed(1)}s`;
 }
+function formatRenderSummaryDetail(input2) {
+  const middle = input2.isDirectory ? input2.frameCount != null ? `${input2.frameCount} frames` : void 0 : input2.outputDurationSeconds != null && input2.outputDurationSeconds > 0 ? `${formatDuration(input2.outputDurationSeconds * 1e3)} video` : void 0;
+  const renderTime = `rendered in ${formatDuration(input2.elapsedMs)}`;
+  return [middle, renderTime].filter(Boolean).join(" \xB7 ");
+}
 function label(name, value) {
   const pad = 14 - name.length;
   return `   ${c.dim(name)}${" ".repeat(Math.max(1, pad))}${c.bold(value)}`;
@@ -85962,7 +86062,7 @@ var require_processor = __commonJS({
           if (options === void 0) {
             options = {};
           }
-          return new Promise(function(resolve60, reject) {
+          return new Promise(function(resolve61, reject) {
             try {
               var root_1 = _this._root(rule, options);
               Promise.resolve(_this.func(root_1)).then(function(transform) {
@@ -85972,7 +86072,7 @@ var require_processor = __commonJS({
                   rule.selector = string;
                 }
                 return { transform, root: root_1, string };
-              }).then(resolve60, reject);
+              }).then(resolve61, reject);
             } catch (e3) {
               reject(e3);
               return;
@@ -93578,7 +93678,7 @@ async function loadPuppeteerBrowsers() {
   try {
     return await import("@puppeteer/browsers");
   } catch (err) {
-    const cause = err instanceof Error ? err.message : String(err);
+    const cause = normalizeErrorMessage(err);
     throw new Error(
       `Failed to load @puppeteer/browsers: ${cause}
 Fix: run \`npm install\` or \`bun install\` to restore missing packages, then retry.`
@@ -93727,7 +93827,7 @@ async function findBrowser() {
     try {
       return await downloadBrowser();
     } catch (err) {
-      const cause = err instanceof Error ? err.message : String(err);
+      const cause = normalizeErrorMessage(err);
       throw new Error(
         `Cached Chrome binary was missing at ${fromCache.staleHyperframesCachePath}, and re-download failed: ${cause}
 Run \`hyperframes browser ensure --force\` to re-download.`
@@ -93829,6 +93929,7 @@ var CHROME_VERSION, CACHE_DIR2, PUPPETEER_CACHE_DIR, SYSTEM_CHROME_PATHS, _warne
 var init_manager2 = __esm({
   "src/browser/manager.ts"() {
     "use strict";
+    init_errorMessage();
     CHROME_VERSION = "131.0.6778.85";
     CACHE_DIR2 = join27(homedir9(), ".cache", "hyperframes", "chrome");
     PUPPETEER_CACHE_DIR = join27(homedir9(), ".cache", "puppeteer", "chrome-headless-shell");
@@ -94463,9 +94564,9 @@ var require_compress_binding = __commonJS({
           });
         } else {
           if (readAsync) {
-            return new Promise(function(resolve60, reject) {
+            return new Promise(function(resolve61, reject) {
               readAsync(wasmBinaryFile, function(response) {
-                resolve60(new Uint8Array(response));
+                resolve61(new Uint8Array(response));
               }, reject);
             });
           }
@@ -95499,8 +95600,8 @@ var require_compress = __commonJS({
   "../../node_modules/.bun/wawoff2@2.0.1/node_modules/wawoff2/compress.js"(exports, module) {
     "use strict";
     var em_module = require_compress_binding();
-    var runtimeInit = new Promise((resolve60) => {
-      em_module.onRuntimeInitialized = resolve60;
+    var runtimeInit = new Promise((resolve61) => {
+      em_module.onRuntimeInitialized = resolve61;
     });
     module.exports = async function compress2(buffer) {
       await runtimeInit;
@@ -96019,9 +96120,9 @@ var require_decompress_binding = __commonJS({
           });
         } else {
           if (readAsync) {
-            return new Promise(function(resolve60, reject) {
+            return new Promise(function(resolve61, reject) {
               readAsync(wasmBinaryFile, function(response) {
-                resolve60(new Uint8Array(response));
+                resolve61(new Uint8Array(response));
               }, reject);
             });
           }
@@ -97036,8 +97137,8 @@ var require_decompress = __commonJS({
   "../../node_modules/.bun/wawoff2@2.0.1/node_modules/wawoff2/decompress.js"(exports, module) {
     "use strict";
     var em_module = require_decompress_binding();
-    var runtimeInit = new Promise((resolve60) => {
-      em_module.onRuntimeInitialized = resolve60;
+    var runtimeInit = new Promise((resolve61) => {
+      em_module.onRuntimeInitialized = resolve61;
     });
     module.exports = async function decompress(buffer) {
       await runtimeInit;
@@ -98396,10 +98497,10 @@ function createFileServer2(options) {
       }
     });
   });
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const connections = /* @__PURE__ */ new Set();
     const server = serve2({ fetch: app.fetch, port, hostname: "127.0.0.1" }, (info) => {
-      resolve60({
+      resolve61({
         url: `http://localhost:${info.port}`,
         port: info.port,
         addPreHeadScript: (script) => {
@@ -98802,7 +98903,7 @@ var init_shared = __esm({
 });
 
 // ../producer/src/utils/errorMessage.ts
-function normalizeErrorMessage(error) {
+function normalizeErrorMessage2(error) {
   if (error instanceof Error) return error.message;
   if (typeof error === "string") return error;
   if (typeof error === "object" && error !== null) {
@@ -98819,7 +98920,7 @@ function normalizeErrorMessage(error) {
   }
   return String(error ?? "unknown error");
 }
-var init_errorMessage = __esm({
+var init_errorMessage2 = __esm({
   "../producer/src/utils/errorMessage.ts"() {
     "use strict";
   }
@@ -98862,10 +98963,10 @@ async function cleanupRenderResources(input2) {
   }
 }
 function buildRenderErrorDetails(input2) {
-  const errorMessage3 = normalizeErrorMessage(input2.error);
+  const errorMessage = normalizeErrorMessage2(input2.error);
   const errorStack = input2.error instanceof Error ? input2.error.stack : void 0;
   return {
-    message: errorMessage3,
+    message: errorMessage,
     stack: errorStack,
     elapsedMs: Date.now() - input2.pipelineStartMs,
     freeMemoryMB: Math.round(freemem4() / (1024 * 1024)),
@@ -98880,7 +98981,7 @@ var init_cleanup = __esm({
     "use strict";
     init_src();
     init_logger();
-    init_errorMessage();
+    init_errorMessage2();
   }
 });
 
@@ -99131,12 +99232,12 @@ var CaptureStageError;
 var init_captureStageError = __esm({
   "../producer/src/services/render/captureStageError.ts"() {
     "use strict";
-    init_errorMessage();
+    init_errorMessage2();
     CaptureStageError = class extends Error {
       browserConsole;
       cause;
       constructor(input2) {
-        super(normalizeErrorMessage(input2.cause));
+        super(normalizeErrorMessage2(input2.cause));
         this.name = "CaptureStageError";
         this.cause = input2.cause;
         this.browserConsole = input2.browserConsole.slice();
@@ -99444,7 +99545,7 @@ async function runCaptureCalibration(input2) {
   return { calibration, forceScreenshot, probeSession, lastBrowserConsole };
 }
 function shouldFallbackToScreenshotAfterCalibrationError(error) {
-  const message = normalizeErrorMessage(error);
+  const message = normalizeErrorMessage2(error);
   return /HeadlessExperimental\.beginFrame timed out|beginFrame probe timeout|Another frame is pending|Frame still pending|Protocol error.*HeadlessExperimental\.beginFrame|Runtime\.callFunctionOn timed out|Runtime\.evaluate timed out/i.test(
     message
   );
@@ -99456,7 +99557,7 @@ var init_captureCost = __esm({
     init_dist3();
     init_src();
     init_logger();
-    init_errorMessage();
+    init_errorMessage2();
     CAPTURE_CALIBRATION_TARGET_MS = 600;
     MAX_MEASURED_CAPTURE_COST_MULTIPLIER = 8;
     CAPTURE_CALIBRATION_PROTOCOL_TIMEOUT_MS = 3e4;
@@ -99573,7 +99674,7 @@ var init_observability = __esm({
   "../producer/src/services/render/observability.ts"() {
     "use strict";
     init_dist3();
-    init_errorMessage();
+    init_errorMessage2();
     MAX_EVENTS = 160;
     ALLOWED_STRING_DATA_KEYS = /* @__PURE__ */ new Set([
       "browserGpuMode",
@@ -99637,7 +99738,7 @@ var init_observability = __esm({
           status: "error",
           elapsedMs: Date.now() - this.input.pipelineStartMs,
           durationMs: Date.now() - startedAtMs,
-          message: sanitizeObservationMessage(normalizeErrorMessage(error)),
+          message: sanitizeObservationMessage(normalizeErrorMessage2(error)),
           data: sanitizeObservationData(data2)
         });
       }
@@ -103404,8 +103505,8 @@ async function createShaderTransitionWorkerPool(opts) {
       if (terminated) {
         throw new Error("shader-blend pool already terminated");
       }
-      return new Promise((resolve60, reject) => {
-        const task = traceEnabled ? { req, resolve: resolve60, reject, enqueuedAtMs: Date.now(), traceId: ++nextTaskId } : { req, resolve: resolve60, reject };
+      return new Promise((resolve61, reject) => {
+        const task = traceEnabled ? { req, resolve: resolve61, reject, enqueuedAtMs: Date.now(), traceId: ++nextTaskId } : { req, resolve: resolve61, reject };
         const idle = slots.find((s2) => !s2.busy && !s2.dead);
         if (idle) {
           queue.unshift(task);
@@ -104438,7 +104539,7 @@ function captureAttemptMadeProgress(attemptTargetFrameCount, remainingFrameCount
   return remainingFrameCount < attemptTargetFrameCount;
 }
 function isRecoverableParallelCaptureError(error) {
-  const message = normalizeErrorMessage(error);
+  const message = normalizeErrorMessage2(error);
   return message.includes("[Parallel] Capture failed") && /Runtime\.callFunctionOn timed out|HeadlessExperimental\.beginFrame timed out|Waiting failed|timeout exceeded|timed out|Navigation timeout|Protocol error|Target closed/i.test(
     message
   );
@@ -105392,7 +105493,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       if (restoreLogger) restoreLogger();
       throw error instanceof RenderCancelledError ? error : new RenderCancelledError("render_cancelled");
     }
-    const errorMessage3 = normalizeErrorMessage(error);
+    const errorMessage = normalizeErrorMessage2(error);
     const carriedBrowserConsole = getCaptureStageBrowserConsole(error);
     if (carriedBrowserConsole.length > 0) {
       lastBrowserConsole = [...lastBrowserConsole, ...carriedBrowserConsole].slice(-200);
@@ -105401,15 +105502,15 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       const failureStart = Date.now();
       observability.stageError(job.currentStage || "pipeline", failureStart, error);
     }
-    const isTimeoutError = errorMessage3.includes("Waiting failed") || errorMessage3.includes("timeout exceeded") || errorMessage3.includes("Navigation timeout");
+    const isTimeoutError = errorMessage.includes("Waiting failed") || errorMessage.includes("timeout exceeded") || errorMessage.includes("Navigation timeout");
     const wasParallel = job.config.workers !== 1;
     if (isTimeoutError && wasParallel) {
       log2.warn(
         `Parallel capture timed out with ${job.config.workers ?? "auto"} workers. Video-heavy compositions often need sequential capture. Retry with --workers 1`
       );
     }
-    job.error = errorMessage3;
-    updateJobStatus(job, "failed", `Failed: ${errorMessage3}`, job.progress, onProgress);
+    job.error = errorMessage;
+    updateJobStatus(job, "failed", `Failed: ${errorMessage}`, job.progress, onProgress);
     job.failedStage = job.currentStage;
     const observabilitySummary = observability.summary({
       lastBrowserConsole,
@@ -105427,7 +105528,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     });
     log2.info("[Render] Failure summary", {
       failedStage: job.currentStage,
-      error: errorMessage3,
+      error: errorMessage,
       elapsedMs: Date.now() - pipelineStart,
       stageTimings: perfStages,
       isTimeout: isTimeoutError,
@@ -105467,7 +105568,7 @@ var init_renderOrchestrator = __esm({
     init_logger();
     init_shared();
     init_cleanup();
-    init_errorMessage();
+    init_errorMessage2();
     init_paths();
     init_hdrMode();
     init_perfSummary();
@@ -105629,12 +105730,12 @@ async function startHealthWorker(options = {}) {
     stdout: false,
     stderr: false
   });
-  await new Promise((resolve60, reject) => {
+  await new Promise((resolve61, reject) => {
     const onMessage = (msg) => {
       if (msg?.type === "listening") {
         worker.off("error", onError);
         worker.off("message", onMessage);
-        resolve60();
+        resolve61();
       } else if (msg?.type === "listen-error") {
         worker.off("error", onError);
         worker.off("message", onMessage);
@@ -105717,10 +105818,10 @@ var init_semaphore = __esm({
           this.active++;
           return () => this.release();
         }
-        return new Promise((resolve60) => {
+        return new Promise((resolve61) => {
           this.queue.push(() => {
             this.active++;
-            resolve60(() => this.release());
+            resolve61(() => this.release());
           });
         });
       }
@@ -107767,24 +107868,24 @@ async function defaultRunFfmpeg(args, options) {
   };
 }
 async function runFfmpegWithStdin(args, stdin) {
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const proc = spawn11(getFfmpegBinary(), args);
     let stderr = "";
     proc.stderr.on("data", (data2) => {
       stderr += data2.toString();
     });
     proc.on("error", (err) => {
-      resolve60({
+      resolve61({
         success: false,
         error: `[audioPadTrim] ${err instanceof Error ? err.message : String(err)}`
       });
     });
     proc.on("close", (code) => {
       if (code === 0) {
-        resolve60({ success: true });
+        resolve61({ success: true });
         return;
       }
-      resolve60({
+      resolve61({
         success: false,
         error: `[audioPadTrim] ${formatFfmpegError(code, stderr)}`
       });
@@ -107793,7 +107894,7 @@ async function runFfmpegWithStdin(args, stdin) {
   });
 }
 function runFfprobeJson(args) {
-  return new Promise((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     const proc = spawn11(getFfprobeBinary(), args);
     let stdout2 = "";
     let stderr = "";
@@ -107816,7 +107917,7 @@ function runFfprobeJson(args) {
         return;
       }
       try {
-        resolve60(JSON.parse(stdout2));
+        resolve61(JSON.parse(stdout2));
       } catch (err) {
         reject(new Error(`Failed to parse ffprobe output: ${err.message}`));
       }
@@ -108137,7 +108238,7 @@ __export(src_exports2, {
   getCapturePerfSummary: () => getCapturePerfSummary,
   getCompositionDuration: () => getCompositionDuration,
   initializeSession: () => initializeSession,
-  normalizeErrorMessage: () => normalizeErrorMessage,
+  normalizeErrorMessage: () => normalizeErrorMessage2,
   plan: () => plan,
   prepareCaptureSessionForReuse: () => prepareCaptureSessionForReuse,
   prepareHyperframeLintBody: () => prepareHyperframeLintBody,
@@ -108158,7 +108259,7 @@ var init_src2 = __esm({
     init_config3();
     init_logger();
     init_server();
-    init_errorMessage();
+    init_errorMessage2();
     init_parityContract2();
     init_paths();
     init_hyperframeLint();
@@ -108761,9 +108862,6 @@ function printSelectionFailure(code, message, json) {
   }
   process.exitCode = 1;
 }
-function errorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
-}
 function previewServerPayload(server) {
   return {
     port: server.port,
@@ -108833,7 +108931,7 @@ async function printCurrentSelection(projectDir, startPort, json, preferredPort)
   try {
     response = await fetchStudioSelection2(server);
   } catch (err) {
-    printSelectionFailure("selection-unavailable", errorMessage(err), json);
+    printSelectionFailure("selection-unavailable", normalizeErrorMessage(err), json);
     return;
   }
   if (!response.selection) {
@@ -108884,11 +108982,7 @@ async function printCurrentContext(projectDir, startPort, options) {
   try {
     fields = parseContextFields(options.fields);
   } catch (err) {
-    printSelectionFailure(
-      "invalid-context-fields",
-      err instanceof Error ? err.message : String(err),
-      options.json
-    );
+    printSelectionFailure("invalid-context-fields", normalizeErrorMessage(err), options.json);
     return;
   }
   const fullDetail = options.detail === "full";
@@ -108959,7 +109053,7 @@ async function printCurrentContext(projectDir, startPort, options) {
     updatedAt: selectionResult.value.updatedAt
   } : {
     ok: false,
-    error: selectionResult.status === "rejected" ? { code: "selection-unavailable", message: errorMessage(selectionResult.reason) } : {
+    error: selectionResult.status === "rejected" ? { code: "selection-unavailable", message: normalizeErrorMessage(selectionResult.reason) } : {
       code: "no-selection",
       message: "Studio is running, but no element is selected."
     }
@@ -108970,7 +109064,7 @@ async function printCurrentContext(projectDir, startPort, options) {
     findings: lintResult.value.findings
   } : {
     ok: false,
-    error: lintResult.status === "rejected" ? { code: "lint-unavailable", message: errorMessage(lintResult.reason) } : { code: "lint-not-requested", message: "Lint was not requested." }
+    error: lintResult.status === "rejected" ? { code: "lint-unavailable", message: normalizeErrorMessage(lintResult.reason) } : { code: "lint-not-requested", message: "Lint was not requested." }
   };
   const payload = { ok: true };
   if (contextIncludes(fields, "server")) payload.server = previewServerPayload(server);
@@ -109274,6 +109368,7 @@ var init_preview = __esm({
     init_dist8();
     init_colors();
     init_env();
+    init_errorMessage();
     init_npxCommand();
     init_openBrowser();
     init_lintProject();
@@ -111628,9 +111723,10 @@ function archiveArrayBuffer(archive) {
   new Uint8Array(arrayBuffer).set(archive.buffer);
   return arrayBuffer;
 }
-async function publishProjectArchiveDirect(apiBaseUrl2, title, archive) {
+async function publishProjectArchiveDirect(apiBaseUrl2, title, archive, isPublic) {
   const body = new FormData();
   body.set("title", title);
+  if (isPublic) body.set("is_public", "true");
   body.set(
     "file",
     new File([archiveArrayBuffer(archive)], `${title}.zip`, { type: PUBLISH_CONTENT_TYPE })
@@ -111651,7 +111747,7 @@ async function publishProjectArchiveDirect(apiBaseUrl2, title, archive) {
   }
   return publishedProject;
 }
-async function publishProjectArchiveStaged(apiBaseUrl2, title, archive) {
+async function publishProjectArchiveStaged(apiBaseUrl2, title, archive, isPublic) {
   const fileName = `${title}.zip`;
   const uploadResponse = await fetch(`${apiBaseUrl2}/v1/hyperframes/projects/publish/upload`, {
     method: "POST",
@@ -111691,7 +111787,8 @@ async function publishProjectArchiveStaged(apiBaseUrl2, title, archive) {
     body: JSON.stringify({
       upload_key: stagedUpload.uploadKey,
       file_name: fileName,
-      title
+      title,
+      ...isPublic ? { is_public: true } : {}
     }),
     headers: {
       "content-type": "application/json",
@@ -111706,13 +111803,14 @@ async function publishProjectArchiveStaged(apiBaseUrl2, title, archive) {
   }
   return publishedProject;
 }
-async function publishProjectArchive(projectDir) {
+async function publishProjectArchive(projectDir, opts = {}) {
+  const isPublic = opts.public === true;
   const title = basename11(projectDir);
   const archive = createPublishArchive(projectDir);
   const apiBaseUrl2 = getPublishApiBaseUrl();
-  const stagedResult = await publishProjectArchiveStaged(apiBaseUrl2, title, archive);
+  const stagedResult = await publishProjectArchiveStaged(apiBaseUrl2, title, archive, isPublic);
   if (stagedResult) return stagedResult;
-  return publishProjectArchiveDirect(apiBaseUrl2, title, archive);
+  return publishProjectArchiveDirect(apiBaseUrl2, title, archive, isPublic);
 }
 var IGNORED_DIRS, IGNORED_FILES, PUBLISH_CONTENT_TYPE, PUBLISH_METADATA_TIMEOUT_MS, PUBLISH_UPLOAD_MIN_TIMEOUT_MS, PUBLISH_UPLOAD_BYTES_PER_SECOND, EXT_ASSETS_PREFIX;
 var init_publishProject = __esm({
@@ -111752,6 +111850,7 @@ var init_publish = __esm({
     examples8 = [
       ["Publish the current project with a public URL", "hyperframes publish"],
       ["Publish a specific directory", "hyperframes publish ./my-video"],
+      ["Make the claimed project public to anyone", "hyperframes publish --public"],
       ["Skip the consent prompt (scripts)", "hyperframes publish --yes"]
     ];
     publish_default = defineCommand({
@@ -111766,6 +111865,11 @@ var init_publish = __esm({
           alias: "y",
           description: "Skip the publish confirmation prompt",
           default: false
+        },
+        public: {
+          type: "boolean",
+          description: "Make the claimed project public to anyone, not just the claimer",
+          default: false
         }
       },
       async run({ args }) {
@@ -111801,7 +111905,7 @@ var init_publish = __esm({
         const publishSpinner = ft();
         publishSpinner.start("Uploading project...");
         try {
-          const published = await publishProjectArchive(dir);
+          const published = await publishProjectArchive(dir, { public: args.public === true });
           const claimUrl = new URL(published.url);
           claimUrl.searchParams.set("claim_token", published.claimToken);
           publishSpinner.stop(c.success("Project published"));
@@ -112209,18 +112313,18 @@ async function getDoctorSummary() {
   }
 }
 function askQuestion(prompt) {
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const rl = readline.createInterface({
       input: process.stdin,
       output: process.stdout
     });
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve60(answer);
+      resolve61(answer);
     });
     const timeout = setTimeout(() => {
       rl.close();
-      resolve60("");
+      resolve61("");
     }, 1e4);
     if (typeof timeout === "object" && timeout !== null && "unref" in timeout) {
       timeout.unref();
@@ -112316,30 +112420,6 @@ var init_dockerRunArgs = __esm({
   }
 });
 
-// src/utils/errorMessage.ts
-function normalizeErrorMessage2(error) {
-  if (error instanceof Error) return error.message;
-  if (typeof error === "string") return error;
-  if (typeof error === "object" && error !== null) {
-    const msg = error.message;
-    if (typeof msg === "string") return msg;
-    try {
-      return JSON.stringify(error);
-    } catch {
-      try {
-        return `{${Object.keys(error).join(", ")}}`;
-      } catch {
-      }
-    }
-  }
-  return String(error ?? "unknown error");
-}
-var init_errorMessage2 = __esm({
-  "src/utils/errorMessage.ts"() {
-    "use strict";
-  }
-});
-
 // src/browser/preflight.ts
 import { execFileSync as execFileSync7 } from "child_process";
 import { existsSync as existsSync63 } from "fs";
@@ -112540,10 +112620,7 @@ function parseJson(raw, source) {
   try {
     return JSON.parse(raw);
   } catch (error) {
-    throw new BatchRenderInputError(
-      "Invalid JSON in --batch",
-      `${source}: ${error instanceof Error ? error.message : String(error)}`
-    );
+    throw new BatchRenderInputError("Invalid JSON in --batch", `${source}: ${normalizeErrorMessage(error)}`);
   }
 }
 function parseBatchRows(raw, source) {
@@ -112662,7 +112739,7 @@ function prepareBatchRender(options) {
   } catch (error) {
     throw new BatchRenderInputError(
       "Could not read --batch",
-      `${batchPath}: ${error instanceof Error ? error.message : String(error)}`
+      `${batchPath}: ${normalizeErrorMessage(error)}`
     );
   }
   const variableRows = parseBatchRows(raw, batchPath);
@@ -112725,9 +112802,6 @@ function writeManifest(manifest) {
 function emitJsonEvent(event, json) {
   if (json) console.log(JSON.stringify(event));
 }
-function errorMessage2(error) {
-  return error instanceof Error ? error.message : String(error);
-}
 async function renderBatchRow(row, manifest, options) {
   const manifestRow = manifest.rows[row.index];
   if (!manifestRow) {
@@ -112764,7 +112838,7 @@ async function renderBatchRow(row, manifest, options) {
     return true;
   } catch (error) {
     manifestRow.status = "failed";
-    manifestRow.error = errorMessage2(error);
+    manifestRow.error = normalizeErrorMessage(error);
     manifestRow.completedAt = (/* @__PURE__ */ new Date()).toISOString();
     writeManifest(manifest);
     emitJsonEvent(
@@ -112860,6 +112934,7 @@ var init_batchRender = __esm({
     "use strict";
     init_colors();
     init_format();
+    init_errorMessage();
     init_variables();
     BatchRenderInputError = class extends Error {
       title;
@@ -112972,7 +113047,7 @@ function ensureDockerImage(version2, platform10, quiet) {
       { stdio: quiet ? "pipe" : "inherit", timeout: 6e5 }
     );
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
+    const message = normalizeErrorMessage(error);
     throw new Error(`Failed to build Docker image: ${message}`);
   } finally {
     rmSync17(tmpDir, { recursive: true, force: true });
@@ -113010,7 +113085,7 @@ async function renderDocker(projectDir, outputPath, options) {
   try {
     imageTag = ensureDockerImage(dockerVersion, platform10, options.quiet);
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
+    const message = normalizeErrorMessage(error);
     const isDockerMissing = /connect|not found|ENOENT/i.test(message);
     errorBox(
       isDockerMissing ? "Docker not available" : "Docker image build failed",
@@ -113158,7 +113233,13 @@ async function renderLocal(projectDir, outputPath, options) {
   }
   const elapsed = Date.now() - startTime;
   trackRenderMetrics(job, elapsed, options, false);
-  printRenderComplete(outputPath, elapsed, options.quiet);
+  printRenderComplete(
+    outputPath,
+    elapsed,
+    options.quiet,
+    job.perfSummary?.compositionDurationSeconds,
+    job.perfSummary?.totalFrames
+  );
   if (!options.skipFeedback) {
     await maybePromptRenderFeedback({
       renderDurationMs: elapsed,
@@ -113264,7 +113345,7 @@ function createNoopProducerLogger() {
   };
 }
 function handleRenderError(error, options, startTime, docker, hint2, failedStage, job) {
-  const message = normalizeErrorMessage2(error);
+  const message = normalizeErrorMessage(error);
   trackRenderError({
     fps: fpsToNumber(options.fps),
     quality: options.quality,
@@ -113333,11 +113414,13 @@ function trackRenderMetrics(job, elapsedMs, options, docker) {
     ...getMemorySnapshot()
   });
 }
-function printRenderComplete(outputPath, elapsedMs, quiet) {
+function printRenderComplete(outputPath, elapsedMs, quiet, outputDurationSeconds, frameCount) {
   if (quiet) return;
   let fileSize = "unknown";
+  let isDirectory = false;
   try {
     const stat3 = statSync19(outputPath);
+    isDirectory = stat3.isDirectory();
     if (stat3.isDirectory()) {
       let total = 0;
       for (const entry of readdirSync24(outputPath, { withFileTypes: true })) {
@@ -113353,10 +113436,15 @@ function printRenderComplete(outputPath, elapsedMs, quiet) {
     }
   } catch {
   }
-  const duration = formatDuration(elapsedMs);
+  const detail = formatRenderSummaryDetail({
+    elapsedMs,
+    outputDurationSeconds,
+    isDirectory,
+    frameCount
+  });
   console.log("");
   console.log(c.success("\u25C7") + "  " + c.accent(outputPath));
-  console.log("   " + c.bold(fileSize) + c.dim(" \xB7 " + duration + " \xB7 completed"));
+  console.log("   " + c.bold(fileSize) + c.dim(" \xB7 " + detail));
 }
 var examples9, VALID_QUALITY, RENDER_FORMATS, VALID_FORMAT, RENDER_FORMAT_LABEL, FORMAT_EXT, CPU_CORE_COUNT, render_default, DOCKER_IMAGE_PREFIX;
 var init_render = __esm({
@@ -113380,7 +113468,7 @@ var init_render = __esm({
     init_version();
     init_env();
     init_dockerRunArgs();
-    init_errorMessage2();
+    init_errorMessage();
     init_preflight();
     init_src();
     init_dist3();
@@ -113833,6 +113921,19 @@ var init_render = __esm({
             batchModule.exitBatchRenderInputError(error);
           }
         }
+        if (!quiet) {
+          try {
+            const renderTarget = entryFile ? resolve44(project.dir, entryFile) : project.indexPath;
+            const { slideshowIslandRegex: slideshowIslandRegex2 } = await Promise.resolve().then(() => (init_slideshow2(), slideshow_exports));
+            if (slideshowIslandRegex2("i").test(readFileSync40(renderTarget, "utf8"))) {
+              console.log(
+                c.warn("\u26A0") + "  This composition carries a slideshow island \u2014 `render` captures only the first scene, so the MP4 will be truncated to slide 1. Use " + c.accent("hyperframes present") + " for the deck; a linear main-line MP4 export is not yet available."
+              );
+              console.log("");
+            }
+          } catch {
+          }
+        }
         if (!quiet && !batchPath) {
           const workerLabel = workers != null ? `${workers} workers` : `auto workers (${CPU_CORE_COUNT} cores detected)`;
           console.log("");
@@ -113883,7 +113984,7 @@ var init_render = __esm({
             browserSpinner?.stop(c.error("Browser not available"));
             errorBox(
               "Chrome not found",
-              err instanceof Error ? err.message : String(err),
+              normalizeErrorMessage(err),
               "Run: npx hyperframes browser ensure"
             );
             process.exit(1);
@@ -114421,8 +114522,43 @@ __export(staticProjectServer_exports, {
   serveStaticProjectHtml: () => serveStaticProjectHtml
 });
 import { createServer } from "http";
-import { existsSync as existsSync66, readFileSync as readFileSync44 } from "fs";
+import { createReadStream as createReadStream3, existsSync as existsSync66, statSync as statSync20 } from "fs";
 import { isAbsolute as isAbsolute13, relative as relative14, resolve as resolve46 } from "path";
+function serveFileWithRange(filePath, rangeHeader, res) {
+  const size = statSync20(filePath).size;
+  const headers = {
+    "Content-Type": getMimeType(filePath),
+    "Accept-Ranges": "bytes"
+  };
+  const last = size - 1;
+  let start = 0;
+  let end = last;
+  let status = 200;
+  const match = rangeHeader ? /^bytes=(\d*)-(\d*)$/.exec(rangeHeader.trim()) : null;
+  if (match) {
+    const hasStart = match[1] !== "";
+    start = hasStart ? Number(match[1]) : Math.max(0, size - Number(match[2]));
+    end = !hasStart ? last : match[2] !== "" ? Math.min(Number(match[2]), last) : last;
+    if (start > end || start > last) {
+      res.writeHead(416, { ...headers, "Content-Range": `bytes */${size}` });
+      res.end();
+      return;
+    }
+    status = 206;
+    headers["Content-Range"] = `bytes ${start}-${end}/${size}`;
+  }
+  headers["Content-Length"] = String(end - start + 1);
+  const stream = createReadStream3(filePath, { start, end });
+  stream.on("open", () => {
+    res.writeHead(status, headers);
+    stream.pipe(res);
+  });
+  stream.on("error", () => {
+    if (!res.headersSent) res.writeHead(500);
+    res.end();
+    stream.destroy();
+  });
+}
 async function serveStaticProjectHtml(projectDir, html, bindErrorMessage = "Failed to bind local HTTP server") {
   const server = createServer((req, res) => {
     const url = req.url ?? "/";
@@ -114439,8 +114575,7 @@ async function serveStaticProjectHtml(projectDir, html, bindErrorMessage = "Fail
       return;
     }
     if (existsSync66(filePath)) {
-      res.writeHead(200, { "Content-Type": getMimeType(filePath) });
-      res.end(readFileSync44(filePath));
+      serveFileWithRange(filePath, req.headers.range, res);
       return;
     }
     res.writeHead(404);
@@ -114832,7 +114967,7 @@ var init_motionAudit = __esm({
 });
 
 // src/utils/motionSpec.ts
-import { existsSync as existsSync67, readFileSync as readFileSync45, readdirSync as readdirSync25 } from "fs";
+import { existsSync as existsSync67, readFileSync as readFileSync44, readdirSync as readdirSync25 } from "fs";
 import { basename as basename13, join as join70 } from "path";
 function isObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -114894,7 +115029,7 @@ function findMotionSpec(projectDir) {
 function readMotionSpec(path2) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync45(path2, "utf-8"));
+    raw = JSON.parse(readFileSync44(path2, "utf-8"));
   } catch (err) {
     return { ok: false, errors: [`could not read ${basename13(path2)}: ${err.message}`] };
   }
@@ -114945,7 +115080,7 @@ __export(layout_exports, {
   default: () => layout_default,
   examples: () => examples12
 });
-import { existsSync as existsSync68, readFileSync as readFileSync46 } from "fs";
+import { existsSync as existsSync68, readFileSync as readFileSync45 } from "fs";
 import { dirname as dirname32, join as join71 } from "path";
 import { fileURLToPath as fileURLToPath12 } from "url";
 function buildMotionSampleTimes(duration) {
@@ -114981,7 +115116,7 @@ async function waitForFonts(page, timeoutMs) {
     if (!fonts?.ready) return Promise.resolve();
     return Promise.race([
       fonts.ready.then(() => void 0),
-      new Promise((resolve60) => setTimeout(resolve60, ms))
+      new Promise((resolve61) => setTimeout(resolve61, ms))
     ]);
   }, timeoutMs).catch(() => {
   });
@@ -115133,7 +115268,7 @@ async function runLayoutAudit(projectDir, opts) {
 function loadBrowserScript(name) {
   const candidates = [join71(__dirname2, name), join71(__dirname2, "commands", name)];
   for (const candidate of candidates) {
-    if (existsSync68(candidate)) return readFileSync46(candidate, "utf-8");
+    if (existsSync68(candidate)) return readFileSync45(candidate, "utf-8");
   }
   throw new Error(`Missing browser script ${name}`);
 }
@@ -115380,7 +115515,7 @@ function createInspectCommand(commandName) {
         console.log(`${ok ? c.success("\u25C7") : c.error("\u25C7")}  ${parts.join(", ")}${suffix}`);
         process.exit(ok ? 0 : 1);
       } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
+        const message = normalizeErrorMessage(err);
         if (args.json) {
           console.log(
             JSON.stringify(
@@ -115413,6 +115548,7 @@ var init_layout2 = __esm({
     init_dist();
     init_colors();
     init_project();
+    init_errorMessage();
     init_staticProjectServer();
     init_updateCheck();
     init_layoutAudit();
@@ -115478,7 +115614,7 @@ __export(info_exports, {
   default: () => info_default,
   examples: () => examples14
 });
-import { readFileSync as readFileSync47, readdirSync as readdirSync26, statSync as statSync20 } from "fs";
+import { readFileSync as readFileSync46, readdirSync as readdirSync26, statSync as statSync21 } from "fs";
 import { join as join73 } from "path";
 function totalSize(dir) {
   let total = 0;
@@ -115487,7 +115623,7 @@ function totalSize(dir) {
     if (entry.isDirectory()) {
       total += totalSize(path2);
     } else {
-      total += statSync20(path2).size;
+      total += statSync21(path2).size;
     }
   }
   return total;
@@ -115515,7 +115651,7 @@ var init_info = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync47(project.indexPath, "utf-8");
+        const html = readFileSync46(project.indexPath, "utf-8");
         ensureDOMParser();
         const parsed = parseHtml(html);
         const tracks = new Set(parsed.elements.map((el) => el.zIndex));
@@ -115573,7 +115709,7 @@ __export(compositions_exports, {
   examples: () => examples15,
   parseSubComposition: () => parseSubComposition
 });
-import { existsSync as existsSync69, readFileSync as readFileSync48 } from "fs";
+import { existsSync as existsSync69, readFileSync as readFileSync47 } from "fs";
 import { resolve as resolve47, dirname as dirname33 } from "path";
 function countRenderableDescendants(root) {
   return Array.from(root.querySelectorAll("*")).filter(
@@ -115608,7 +115744,7 @@ function parseCompositions(html, baseDir) {
     if (compositionSrc) {
       const subPath = resolve47(baseDir, compositionSrc);
       if (existsSync69(subPath)) {
-        const subHtml = readFileSync48(subPath, "utf-8");
+        const subHtml = readFileSync47(subPath, "utf-8");
         const subInfo = parseSubComposition(subHtml, id, width, height);
         compositions.push({ ...subInfo, source: compositionSrc });
         return;
@@ -115711,7 +115847,7 @@ var init_compositions = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync48(project.indexPath, "utf-8");
+        const html = readFileSync47(project.indexPath, "utf-8");
         ensureDOMParser();
         const compositions = parseCompositions(html, dirname33(project.indexPath));
         if (compositions.length === 0) {
@@ -115749,7 +115885,7 @@ __export(benchmark_exports, {
   default: () => benchmark_default,
   examples: () => examples16
 });
-import { existsSync as existsSync70, statSync as statSync21 } from "fs";
+import { existsSync as existsSync70, statSync as statSync23 } from "fs";
 import { resolve as resolve48, join as join74 } from "path";
 var examples16, FPS_30, FPS_60, DEFAULT_CONFIGS, benchmark_default;
 var init_benchmark = __esm({
@@ -115843,7 +115979,7 @@ var init_benchmark = __esm({
               const elapsedMs = Date.now() - startTime;
               let fileSize = null;
               if (existsSync70(outputPath)) {
-                const stat3 = statSync21(outputPath);
+                const stat3 = statSync23(outputPath);
                 fileSize = stat3.size;
               }
               runs.push({ elapsedMs, fileSize });
@@ -116578,12 +116714,12 @@ async function runPipeline(options, session, media, format, bgFormat, ffmpegPath
         const drains = [];
         if (!fgWroteFully) {
           drains.push(
-            new Promise((resolve60) => fg.proc.stdin.once("drain", () => resolve60()))
+            new Promise((resolve61) => fg.proc.stdin.once("drain", () => resolve61()))
           );
         }
         if (!bgWroteFully && bg) {
           drains.push(
-            new Promise((resolve60) => bg.proc.stdin.once("drain", () => resolve60()))
+            new Promise((resolve61) => bg.proc.stdin.once("drain", () => resolve61()))
           );
         }
         await Promise.all(drains);
@@ -116616,11 +116752,11 @@ ${decoder.getStderr().slice(-400)}`
   return processed;
 }
 function waitForExit(proc, label2, getStderr) {
-  return new Promise((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     proc.on("error", reject);
     proc.on("exit", (code, signal) => {
       if (code === 0 && !signal) {
-        resolve60();
+        resolve61();
         return;
       }
       const cause = signal ? `killed by ${signal}` : `exited with code ${code}`;
@@ -117395,7 +117531,7 @@ __export(tts_exports, {
   default: () => tts_default,
   examples: () => examples20
 });
-import { existsSync as existsSync77, readFileSync as readFileSync49 } from "fs";
+import { existsSync as existsSync77, readFileSync as readFileSync48 } from "fs";
 import { resolve as resolve51, extname as extname13 } from "path";
 function listVoices(json) {
   const rows = BUNDLED_VOICES.map((v2) => ({ ...v2, defaultLang: inferLangFromVoiceId(v2.id) }));
@@ -117506,7 +117642,7 @@ var init_tts = __esm({
         let text;
         const maybeFile = resolve51(args.input);
         if (existsSync77(maybeFile) && extname13(maybeFile).toLowerCase() === ".txt") {
-          text = readFileSync49(maybeFile, "utf-8").trim();
+          text = readFileSync48(maybeFile, "utf-8").trim();
           if (!text) {
             console.error(c.error("File is empty."));
             process.exit(1);
@@ -117598,7 +117734,7 @@ __export(docs_exports, {
   default: () => docs_default,
   examples: () => examples21
 });
-import { readFileSync as readFileSync50, existsSync as existsSync78 } from "fs";
+import { readFileSync as readFileSync49, existsSync as existsSync78 } from "fs";
 import { resolve as resolve52, dirname as dirname36, join as join79 } from "path";
 import { fileURLToPath as fileURLToPath13 } from "url";
 function docsDir() {
@@ -117708,7 +117844,7 @@ var init_docs = __esm({
           console.error(c.error(`Doc file not found: ${filePath}`));
           process.exit(1);
         }
-        const content = readFileSync50(filePath, "utf-8");
+        const content = readFileSync49(filePath, "utf-8");
         console.log();
         renderMarkdown(content);
       }
@@ -118124,28 +118260,161 @@ var init_upgrade = __esm({
   }
 });
 
+// src/utils/feedbackIssue.ts
+function normalizeRepoUrl(repoUrl) {
+  const trimmed = repoUrl.trim().replace(/\/$/, "").replace(/\.git$/, "");
+  return trimmed || HYPERFRAMES_REPO_URL;
+}
+function truncate(value, max) {
+  return value.length > max ? `${value.slice(0, max - 1)}\u2026` : value;
+}
+function buildIssueTitle(rating, comment) {
+  const firstLine = comment?.split("\n")[0]?.trim();
+  if (!firstLine) return `Render feedback (rating ${rating}/5)`;
+  return `[feedback] ${truncate(firstLine, TITLE_MAX)}`;
+}
+function buildIssueBody(input2) {
+  const comment = input2.comment?.trim();
+  const repro = input2.repoPublicUrl ? `Published minimal repro: ${input2.repoPublicUrl}` : "_Publishing the repro failed, no public link available._";
+  return [
+    `**Rating:** ${input2.rating}/5`,
+    "",
+    "## Comment",
+    comment ? truncate(comment, COMMENT_MAX) : "_No comment provided._",
+    "",
+    "## Minimal repro",
+    repro,
+    "",
+    "## Environment",
+    "```",
+    input2.environment || "(unavailable)",
+    `cli=${input2.cliVersion}`,
+    "```",
+    "",
+    "---",
+    "_Filed via `hyperframes feedback --file-issue`._"
+  ].join("\n");
+}
+function buildIssueUrl(input2) {
+  const repo = normalizeRepoUrl(input2.repoUrl);
+  const title = encodeURIComponent(buildIssueTitle(input2.rating, input2.comment));
+  const body = encodeURIComponent(buildIssueBody(input2));
+  return `${repo}/issues/new?title=${title}&body=${body}&labels=bug`;
+}
+var HYPERFRAMES_REPO_URL, TITLE_MAX, COMMENT_MAX;
+var init_feedbackIssue = __esm({
+  "src/utils/feedbackIssue.ts"() {
+    "use strict";
+    HYPERFRAMES_REPO_URL = "https://github.com/heygen-com/hyperframes";
+    TITLE_MAX = 80;
+    COMMENT_MAX = 4e3;
+  }
+});
+
 // src/commands/feedback.ts
 var feedback_exports = {};
 __export(feedback_exports, {
   default: () => feedback_default,
   examples: () => examples24
 });
+import { resolve as resolve53 } from "path";
+import open from "open";
 function parseRating(raw) {
   const n2 = parseInt(raw, 10);
   return n2 >= 1 && n2 <= 5 && Number.isFinite(n2) ? n2 : null;
 }
+function normalizeComment(raw) {
+  return raw || void 0;
+}
+function printIssueConsent(dir) {
+  console.log();
+  console.log(
+    `  ${c.bold("Filing an issue will publish this project publicly and open a GitHub issue draft.")}`
+  );
+  console.log(`  ${c.dim(`Project at ${dir} will be uploaded to a public URL.`)}`);
+  console.log(
+    `  ${c.dim("The issue draft will contain that public link plus your feedback; you review and submit it.")}`
+  );
+  console.log();
+}
+async function promptConfirm() {
+  const approved = await ue({ message: "Publish this project and draft the issue?" });
+  return !q(approved) && approved === true;
+}
+async function confirmFileIssue(dir, yes) {
+  printIssueConsent(dir);
+  if (yes) return true;
+  if (!process.stdout.isTTY) {
+    console.log(`  ${c.dim("Re-run with --yes to publish the repro and file the issue.")}
+`);
+    return false;
+  }
+  if (await promptConfirm()) return true;
+  console.log(`
+  ${c.dim("Aborted. Feedback was still sent.")}
+`);
+  return false;
+}
+async function publishRepro(dir) {
+  const spinner = ft();
+  spinner.start("Publishing minimal repro...");
+  try {
+    const published = await publishProjectArchive(dir);
+    spinner.stop(c.success("Repro published"));
+    return published.url;
+  } catch (err) {
+    spinner.stop(c.error("Publish failed"));
+    console.error(`  ${err.message}`);
+    console.log(`  ${c.dim("Filing the issue without a repro link.")}`);
+    return void 0;
+  }
+}
+async function openAndPrintIssue(url) {
+  if (process.stdout.isTTY) {
+    try {
+      await open(url);
+    } catch {
+    }
+  }
+  console.log();
+  console.log(`  ${c.dim("Review and submit the pre-filled issue (it is not auto-submitted):")}`);
+  console.log(`  ${c.accent(url)}`);
+  console.log();
+}
+async function fileGithubIssue(opts) {
+  const dir = resolve53(opts.rawDir ?? ".");
+  if (!await confirmFileIssue(dir, opts.yes)) return;
+  const repoPublicUrl = await publishRepro(dir);
+  const url = buildIssueUrl({
+    repoUrl: HYPERFRAMES_REPO_URL,
+    rating: opts.rating,
+    comment: opts.comment,
+    repoPublicUrl,
+    environment: opts.doctorSummary,
+    cliVersion: VERSION
+  });
+  await openAndPrintIssue(url);
+}
 var examples24, feedback_default;
 var init_feedback2 = __esm({
   "src/commands/feedback.ts"() {
     "use strict";
     init_dist();
+    init_dist8();
     init_events();
     init_client();
     init_feedback();
+    init_publishProject();
+    init_feedbackIssue();
+    init_version();
     init_colors();
     examples24 = [
       ["Submit render feedback", 'hyperframes feedback --rating 4 --comment "fast but font missing"'],
-      ["Quick rating only", "hyperframes feedback --rating 5"]
+      ["Quick rating only", "hyperframes feedback --rating 5"],
+      [
+        "Also file a GitHub issue with a published repro",
+        'hyperframes feedback --rating 2 --comment "GSAP timeline froze" --file-issue'
+      ]
     ];
     feedback_default = defineCommand({
       meta: { name: "feedback", description: "Submit anonymous feedback about your experience" },
@@ -118158,6 +118427,21 @@ var init_feedback2 = __esm({
         comment: {
           type: "string",
           description: "Optional details about your experience"
+        },
+        "file-issue": {
+          type: "boolean",
+          description: "Also open a pre-filled GitHub issue with a published minimal repro",
+          default: false
+        },
+        dir: {
+          type: "string",
+          description: "Project directory to publish as the repro (default: current directory)"
+        },
+        yes: {
+          type: "boolean",
+          alias: "y",
+          description: "Skip the publish + file-issue consent prompt",
+          default: false
         }
       },
       async run({ args }) {
@@ -118170,15 +118454,20 @@ var init_feedback2 = __esm({
           console.log(c.dim("Telemetry is disabled. Feedback not sent."));
           return;
         }
+        const comment = normalizeComment(args.comment);
         const doctorSummary = await getDoctorSummary();
-        trackRenderFeedback({
-          rating,
-          renderDurationMs: 0,
-          comment: args.comment || void 0,
-          doctorSummary
-        });
+        trackRenderFeedback({ rating, comment, doctorSummary });
         await flush();
         console.log(c.dim("Thanks for the feedback!"));
+        if (args["file-issue"] === true) {
+          await fileGithubIssue({
+            rating,
+            comment,
+            rawDir: args.dir,
+            yes: args.yes === true,
+            doctorSummary
+          });
+        }
       }
     });
   }
@@ -118375,7 +118664,7 @@ __export(validate_exports, {
   default: () => validate_default,
   shouldIgnoreRequestFailure: () => shouldIgnoreRequestFailure
 });
-import { existsSync as existsSync79, readFileSync as readFileSync51 } from "fs";
+import { existsSync as existsSync79, readFileSync as readFileSync50 } from "fs";
 import { join as join80, dirname as dirname37 } from "path";
 import { fileURLToPath as fileURLToPath14 } from "url";
 function shouldIgnoreRequestFailure(url, errorText, resourceType) {
@@ -118474,7 +118763,7 @@ function loadContrastAuditScript() {
     join80(__dirname3, "commands", "contrast-audit.browser.js")
   ];
   for (const candidate of candidates) {
-    if (existsSync79(candidate)) return readFileSync51(candidate, "utf-8");
+    if (existsSync79(candidate)) return readFileSync50(candidate, "utf-8");
   }
   throw new Error("Missing contrast audit browser script");
 }
@@ -118512,7 +118801,7 @@ async function validateInBrowser(projectDir, opts) {
       }
     });
     page.on("pageerror", (err) => {
-      const text = err instanceof Error ? err.message : String(err);
+      const text = normalizeErrorMessage(err);
       if (text.includes("Unexpected token '<'") || text.includes("Unexpected token '&lt;'")) return;
       errors.push({ level: "error", text });
     });
@@ -118623,6 +118912,7 @@ var init_validate = __esm({
     "use strict";
     init_dist();
     init_project();
+    init_errorMessage();
     init_compositionViewport();
     init_colors();
     init_updateCheck();
@@ -118669,7 +118959,7 @@ Examples:
           const exitCode = printValidationResult(result, asJson);
           process.exit(exitCode);
         } catch (err) {
-          const message = err instanceof Error ? err.message : String(err);
+          const message = normalizeErrorMessage(err);
           emitFailureReport(message, asJson);
           process.exit(1);
         }
@@ -118688,7 +118978,7 @@ __export(contactSheet_exports, {
   createSvgContactSheet: () => createSvgContactSheet
 });
 import sharp from "sharp";
-import { readdirSync as readdirSync28, readFileSync as readFileSync53, writeFileSync as writeFileSync27, unlinkSync as unlinkSync6, existsSync as existsSync80 } from "fs";
+import { readdirSync as readdirSync28, readFileSync as readFileSync51, writeFileSync as writeFileSync27, unlinkSync as unlinkSync6, existsSync as existsSync80 } from "fs";
 import { join as join81, extname as extname14, basename as basename15, dirname as dirname38 } from "path";
 async function createContactSheet(imagePaths, outputPath, opts = {}) {
   const {
@@ -118839,7 +119129,7 @@ async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir) {
     const svgPath = svgPaths[i2];
     const tmpPath = join81(tmpDir, `.thumb-${i2}.png`);
     try {
-      const svgBuf = readFileSync53(svgPath);
+      const svgBuf = readFileSync51(svgPath);
       const thumb = await sharp(svgBuf).resize(thumbSize, thumbSize, {
         fit: "contain",
         background: { r: 245, g: 245, b: 245, alpha: 1 }
@@ -119146,8 +119436,8 @@ var require_p_retry = __commonJS({
       error.retriesLeft = retriesLeft;
       return error;
     };
-    var isNetworkError = (errorMessage3) => networkErrorMsgs.includes(errorMessage3);
-    var pRetry2 = (input2, options) => new Promise((resolve60, reject) => {
+    var isNetworkError = (errorMessage) => networkErrorMsgs.includes(errorMessage);
+    var pRetry2 = (input2, options) => new Promise((resolve61, reject) => {
       options = {
         onFailedAttempt: () => {
         },
@@ -119157,7 +119447,7 @@ var require_p_retry = __commonJS({
       const operation = retry.operation(options);
       operation.attempt(async (attemptNumber) => {
         try {
-          resolve60(await input2(attemptNumber));
+          resolve61(await input2(attemptNumber));
         } catch (error) {
           if (!(error instanceof Error)) {
             reject(new TypeError(`Non-error was thrown: "${error}". You should only throw errors.`));
@@ -119693,8 +119983,8 @@ var require_retry3 = __commonJS({
       }
       const delay = getNextRetryDelay(config);
       err.config.retryConfig.currentRetryAttempt += 1;
-      const backoff = config.retryBackoff ? config.retryBackoff(err, delay) : new Promise((resolve60) => {
-        setTimeout(resolve60, delay);
+      const backoff = config.retryBackoff ? config.retryBackoff(err, delay) : new Promise((resolve61) => {
+        setTimeout(resolve61, delay);
       });
       if (config.onRetryAttempt) {
         await config.onRetryAttempt(err);
@@ -119822,8 +120112,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((resolve60, reject) => {
-        req2.once("response", resolve60).once("error", reject).end();
+      const promise = new Promise((resolve61, reject) => {
+        req2.once("response", resolve61).once("error", reject).end();
       });
       req2.then = promise.then.bind(promise);
       return req2;
@@ -120000,7 +120290,7 @@ var require_parse_proxy_response = __commonJS({
     var debug_1 = __importDefault2(__require("debug"));
     var debug = (0, debug_1.default)("https-proxy-agent:parse-proxy-response");
     function parseProxyResponse(socket) {
-      return new Promise((resolve60, reject) => {
+      return new Promise((resolve61, reject) => {
         let buffersLength = 0;
         const buffers = [];
         function read() {
@@ -120066,7 +120356,7 @@ var require_parse_proxy_response = __commonJS({
           }
           debug("got proxy server response: %o %o", firstLine, headers);
           cleanup();
-          resolve60({
+          resolve61({
             connect: {
               statusCode,
               statusText,
@@ -120310,7 +120600,7 @@ var require_ponyfill_es2018 = __commonJS({
         return new originalPromise(executor);
       }
       function promiseResolvedWith(value) {
-        return newPromise((resolve60) => resolve60(value));
+        return newPromise((resolve61) => resolve61(value));
       }
       function promiseRejectedWith(reason) {
         return originalPromiseReject(reason);
@@ -120480,8 +120770,8 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released reader");
       }
       function defaultReaderClosedPromiseInitialize(reader) {
-        reader._closedPromise = newPromise((resolve60, reject) => {
-          reader._closedPromise_resolve = resolve60;
+        reader._closedPromise = newPromise((resolve61, reject) => {
+          reader._closedPromise_resolve = resolve61;
           reader._closedPromise_reject = reject;
         });
       }
@@ -120655,8 +120945,8 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve60, reject) => {
-            resolvePromise = resolve60;
+          const promise = newPromise((resolve61, reject) => {
+            resolvePromise = resolve61;
             rejectPromise = reject;
           });
           const readRequest = {
@@ -120761,8 +121051,8 @@ var require_ponyfill_es2018 = __commonJS({
           const reader = this._reader;
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve60, reject) => {
-            resolvePromise = resolve60;
+          const promise = newPromise((resolve61, reject) => {
+            resolvePromise = resolve61;
             rejectPromise = reject;
           });
           const readRequest = {
@@ -121781,8 +122071,8 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve60, reject) => {
-            resolvePromise = resolve60;
+          const promise = newPromise((resolve61, reject) => {
+            resolvePromise = resolve61;
             rejectPromise = reject;
           });
           const readIntoRequest = {
@@ -122094,10 +122384,10 @@ var require_ponyfill_es2018 = __commonJS({
           wasAlreadyErroring = true;
           reason = void 0;
         }
-        const promise = newPromise((resolve60, reject) => {
+        const promise = newPromise((resolve61, reject) => {
           stream._pendingAbortRequest = {
             _promise: void 0,
-            _resolve: resolve60,
+            _resolve: resolve61,
             _reject: reject,
             _reason: reason,
             _wasAlreadyErroring: wasAlreadyErroring
@@ -122114,9 +122404,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((resolve60, reject) => {
+        const promise = newPromise((resolve61, reject) => {
           const closeRequest = {
-            _resolve: resolve60,
+            _resolve: resolve61,
             _reject: reject
           };
           stream._closeRequest = closeRequest;
@@ -122129,9 +122419,9 @@ var require_ponyfill_es2018 = __commonJS({
         return promise;
       }
       function WritableStreamAddWriteRequest(stream) {
-        const promise = newPromise((resolve60, reject) => {
+        const promise = newPromise((resolve61, reject) => {
           const writeRequest = {
-            _resolve: resolve60,
+            _resolve: resolve61,
             _reject: reject
           };
           stream._writeRequests.push(writeRequest);
@@ -122747,8 +123037,8 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released writer");
       }
       function defaultWriterClosedPromiseInitialize(writer) {
-        writer._closedPromise = newPromise((resolve60, reject) => {
-          writer._closedPromise_resolve = resolve60;
+        writer._closedPromise = newPromise((resolve61, reject) => {
+          writer._closedPromise_resolve = resolve61;
           writer._closedPromise_reject = reject;
           writer._closedPromiseState = "pending";
         });
@@ -122784,8 +123074,8 @@ var require_ponyfill_es2018 = __commonJS({
         writer._closedPromiseState = "resolved";
       }
       function defaultWriterReadyPromiseInitialize(writer) {
-        writer._readyPromise = newPromise((resolve60, reject) => {
-          writer._readyPromise_resolve = resolve60;
+        writer._readyPromise = newPromise((resolve61, reject) => {
+          writer._readyPromise_resolve = resolve61;
           writer._readyPromise_reject = reject;
         });
         writer._readyPromiseState = "pending";
@@ -122872,7 +123162,7 @@ var require_ponyfill_es2018 = __commonJS({
         source._disturbed = true;
         let shuttingDown = false;
         let currentWrite = promiseResolvedWith(void 0);
-        return newPromise((resolve60, reject) => {
+        return newPromise((resolve61, reject) => {
           let abortAlgorithm;
           if (signal !== void 0) {
             abortAlgorithm = () => {
@@ -123017,7 +123307,7 @@ var require_ponyfill_es2018 = __commonJS({
             if (isError) {
               reject(error);
             } else {
-              resolve60(void 0);
+              resolve61(void 0);
             }
             return null;
           }
@@ -123298,8 +123588,8 @@ var require_ponyfill_es2018 = __commonJS({
         let branch1;
         let branch2;
         let resolveCancelPromise;
-        const cancelPromise = newPromise((resolve60) => {
-          resolveCancelPromise = resolve60;
+        const cancelPromise = newPromise((resolve61) => {
+          resolveCancelPromise = resolve61;
         });
         function pullAlgorithm() {
           if (reading) {
@@ -123390,8 +123680,8 @@ var require_ponyfill_es2018 = __commonJS({
         let branch1;
         let branch2;
         let resolveCancelPromise;
-        const cancelPromise = newPromise((resolve60) => {
-          resolveCancelPromise = resolve60;
+        const cancelPromise = newPromise((resolve61) => {
+          resolveCancelPromise = resolve61;
         });
         function forwardReaderError(thisReader) {
           uponRejection(thisReader._closedPromise, (r2) => {
@@ -124171,8 +124461,8 @@ var require_ponyfill_es2018 = __commonJS({
           const writableHighWaterMark = ExtractHighWaterMark(writableStrategy, 1);
           const writableSizeAlgorithm = ExtractSizeAlgorithm(writableStrategy);
           let startPromise_resolve;
-          const startPromise = newPromise((resolve60) => {
-            startPromise_resolve = resolve60;
+          const startPromise = newPromise((resolve61) => {
+            startPromise_resolve = resolve61;
           });
           InitializeTransformStream(this, startPromise, writableHighWaterMark, writableSizeAlgorithm, readableHighWaterMark, readableSizeAlgorithm);
           SetUpTransformStreamDefaultControllerFromTransformer(this, transformer);
@@ -124265,8 +124555,8 @@ var require_ponyfill_es2018 = __commonJS({
         if (stream._backpressureChangePromise !== void 0) {
           stream._backpressureChangePromise_resolve();
         }
-        stream._backpressureChangePromise = newPromise((resolve60) => {
-          stream._backpressureChangePromise_resolve = resolve60;
+        stream._backpressureChangePromise = newPromise((resolve61) => {
+          stream._backpressureChangePromise_resolve = resolve61;
         });
         stream._backpressure = backpressure;
       }
@@ -124434,8 +124724,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve60, reject) => {
-          controller._finishPromise_resolve = resolve60;
+        controller._finishPromise = newPromise((resolve61, reject) => {
+          controller._finishPromise_resolve = resolve61;
           controller._finishPromise_reject = reject;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
@@ -124461,8 +124751,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve60, reject) => {
-          controller._finishPromise_resolve = resolve60;
+        controller._finishPromise = newPromise((resolve61, reject) => {
+          controller._finishPromise_resolve = resolve61;
           controller._finishPromise_reject = reject;
         });
         const flushPromise = controller._flushAlgorithm();
@@ -124492,8 +124782,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const writable = stream._writable;
-        controller._finishPromise = newPromise((resolve60, reject) => {
-          controller._finishPromise_resolve = resolve60;
+        controller._finishPromise = newPromise((resolve61, reject) => {
+          controller._finishPromise_resolve = resolve61;
           controller._finishPromise_reject = reject;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
@@ -125039,7 +125329,7 @@ var require_node_domexception = __commonJS({
 });
 
 // ../../node_modules/.bun/fetch-blob@3.2.0/node_modules/fetch-blob/from.js
-import { statSync as statSync23, createReadStream as createReadStream3, promises as fs2 } from "fs";
+import { statSync as statSync24, createReadStream as createReadStream4, promises as fs2 } from "fs";
 import { basename as basename16 } from "path";
 var import_node_domexception, stat, blobFromSync, blobFrom, fileFrom, fileFromSync, fromBlob, fromFile, BlobDataItem;
 var init_from = __esm({
@@ -125049,10 +125339,10 @@ var init_from = __esm({
     init_file();
     init_fetch_blob();
     ({ stat } = fs2);
-    blobFromSync = (path2, type) => fromBlob(statSync23(path2), path2, type);
+    blobFromSync = (path2, type) => fromBlob(statSync24(path2), path2, type);
     blobFrom = (path2, type) => stat(path2).then((stat3) => fromBlob(stat3, path2, type));
     fileFrom = (path2, type) => stat(path2).then((stat3) => fromFile(stat3, path2, type));
-    fileFromSync = (path2, type) => fromFile(statSync23(path2), path2, type);
+    fileFromSync = (path2, type) => fromFile(statSync24(path2), path2, type);
     fromBlob = (stat3, path2, type = "") => new fetch_blob_default([new BlobDataItem({
       path: path2,
       size: stat3.size,
@@ -125091,7 +125381,7 @@ var init_from = __esm({
         if (mtimeMs > this.lastModified) {
           throw new import_node_domexception.default("The requested file could not be read, typically due to permission problems that have occurred after a reference to a file was acquired.", "NotReadableError");
         }
-        yield* createReadStream3(this.#path, {
+        yield* createReadStream4(this.#path, {
           start: this.#start,
           end: this.#start + this.size - 1
         });
@@ -126462,7 +126752,7 @@ import zlib from "zlib";
 import Stream2, { PassThrough as PassThrough2, pipeline as pump } from "stream";
 import { Buffer as Buffer4 } from "buffer";
 async function fetch3(url, options_) {
-  return new Promise((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     const request = new Request2(url, options_);
     const { parsedURL, options } = getNodeRequestOptions(request);
     if (!supportedSchemas.has(parsedURL.protocol)) {
@@ -126471,7 +126761,7 @@ async function fetch3(url, options_) {
     if (parsedURL.protocol === "data:") {
       const data2 = dist_default3(request.url);
       const response2 = new Response2(data2, { headers: { "Content-Type": data2.typeFull } });
-      resolve60(response2);
+      resolve61(response2);
       return;
     }
     const send = (parsedURL.protocol === "https:" ? https : http3).request;
@@ -126593,7 +126883,7 @@ async function fetch3(url, options_) {
             if (responseReferrerPolicy) {
               requestOptions.referrerPolicy = responseReferrerPolicy;
             }
-            resolve60(fetch3(new Request2(locationURL, requestOptions)));
+            resolve61(fetch3(new Request2(locationURL, requestOptions)));
             finalize();
             return;
           }
@@ -126626,7 +126916,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);
-        resolve60(response);
+        resolve61(response);
         return;
       }
       const zlibOptions = {
@@ -126640,7 +126930,7 @@ async function fetch3(url, options_) {
           }
         });
         response = new Response2(body, responseOptions);
-        resolve60(response);
+        resolve61(response);
         return;
       }
       if (codings === "deflate" || codings === "x-deflate") {
@@ -126664,12 +126954,12 @@ async function fetch3(url, options_) {
             });
           }
           response = new Response2(body, responseOptions);
-          resolve60(response);
+          resolve61(response);
         });
         raw.once("end", () => {
           if (!response) {
             response = new Response2(body, responseOptions);
-            resolve60(response);
+            resolve61(response);
           }
         });
         return;
@@ -126681,11 +126971,11 @@ async function fetch3(url, options_) {
           }
         });
         response = new Response2(body, responseOptions);
-        resolve60(response);
+        resolve61(response);
         return;
       }
       response = new Response2(body, responseOptions);
-      resolve60(response);
+      resolve61(response);
     });
     writeToStream(request_, request).catch(reject);
   });
@@ -132767,7 +133057,7 @@ var require_jwtaccess = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve60, reject) => {
+        return new Promise((resolve61, reject) => {
           if (!inputStream) {
             reject(new Error("Must pass in a stream containing the service account auth settings."));
           }
@@ -132776,7 +133066,7 @@ var require_jwtaccess = __commonJS({
             try {
               const data2 = JSON.parse(s2);
               this.fromJSON(data2);
-              resolve60();
+              resolve61();
             } catch (err) {
               reject(err);
             }
@@ -133015,7 +133305,7 @@ var require_jwtclient = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve60, reject) => {
+        return new Promise((resolve61, reject) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the service account auth settings.");
           }
@@ -133024,7 +133314,7 @@ var require_jwtclient = __commonJS({
             try {
               const data2 = JSON.parse(s2);
               this.fromJSON(data2);
-              resolve60();
+              resolve61();
             } catch (e3) {
               reject(e3);
             }
@@ -133157,7 +133447,7 @@ var require_refreshclient = __commonJS({
         }
       }
       async fromStreamAsync(inputStream) {
-        return new Promise((resolve60, reject) => {
+        return new Promise((resolve61, reject) => {
           if (!inputStream) {
             return reject(new Error("Must pass in a stream containing the user refresh token."));
           }
@@ -133166,7 +133456,7 @@ var require_refreshclient = __commonJS({
             try {
               const data2 = JSON.parse(s2);
               this.fromJSON(data2);
-              return resolve60();
+              return resolve61();
             } catch (err) {
               return reject(err);
             }
@@ -134999,7 +135289,7 @@ var require_pluggable_auth_handler = __commonJS({
        * @return A promise that resolves with the executable response.
        */
       retrieveResponseFromExecutable(envMap) {
-        return new Promise((resolve60, reject) => {
+        return new Promise((resolve61, reject) => {
           const child = childProcess.spawn(this.commandComponents[0], this.commandComponents.slice(1), {
             env: { ...process.env, ...Object.fromEntries(envMap) }
           });
@@ -135021,7 +135311,7 @@ var require_pluggable_auth_handler = __commonJS({
               try {
                 const responseJson = JSON.parse(output);
                 const response = new executable_response_1.ExecutableResponse(responseJson);
-                return resolve60(response);
+                return resolve61(response);
               } catch (error) {
                 if (error instanceof executable_response_1.ExecutableResponseError) {
                   return reject(error);
@@ -135924,7 +136214,7 @@ var require_googleauth = __commonJS({
         }
       }
       fromStreamAsync(inputStream, options) {
-        return new Promise((resolve60, reject) => {
+        return new Promise((resolve61, reject) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the Google auth settings.");
           }
@@ -135934,7 +136224,7 @@ var require_googleauth = __commonJS({
               try {
                 const data2 = JSON.parse(chunks.join(""));
                 const r2 = this._cacheClientFromJSON(data2, options);
-                return resolve60(r2);
+                return resolve61(r2);
               } catch (err) {
                 if (!this.keyFilename)
                   throw err;
@@ -135944,7 +136234,7 @@ var require_googleauth = __commonJS({
                 });
                 this.cachedCredential = client;
                 this.setGapicJWTValues(client);
-                return resolve60(client);
+                return resolve61(client);
               }
             } catch (err) {
               return reject(err);
@@ -135980,17 +136270,17 @@ var require_googleauth = __commonJS({
        * Run the Google Cloud SDK command that prints the default project ID
        */
       async getDefaultServiceProjectId() {
-        return new Promise((resolve60) => {
+        return new Promise((resolve61) => {
           (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;
-                resolve60(projectId);
+                resolve61(projectId);
                 return;
               } catch (e3) {
               }
             }
-            resolve60(null);
+            resolve61(null);
           });
         });
       }
@@ -139782,7 +140072,7 @@ var require_stream = __commonJS({
       };
       duplex._final = function(callback) {
         if (ws.readyState === ws.CONNECTING) {
-          ws.once("open", function open2() {
+          ws.once("open", function open3() {
             duplex._final(callback);
           });
           return;
@@ -139803,7 +140093,7 @@ var require_stream = __commonJS({
       };
       duplex._write = function(chunk, encoding, callback) {
         if (ws.readyState === ws.CONNECTING) {
-          ws.once("open", function open2() {
+          ws.once("open", function open3() {
             duplex._write(chunk, encoding, callback);
           });
           return;
@@ -143833,14 +144123,14 @@ function __asyncValues2(o) {
   }, i2);
   function verb(n2) {
     i2[n2] = o[n2] && function(v2) {
-      return new Promise(function(resolve60, reject) {
-        v2 = o[n2](v2), settle(resolve60, reject, v2.done, v2.value);
+      return new Promise(function(resolve61, reject) {
+        v2 = o[n2](v2), settle(resolve61, reject, v2.done, v2.value);
       });
     };
   }
-  function settle(resolve60, reject, d2, v2) {
+  function settle(resolve61, reject, d2, v2) {
     Promise.resolve(v2).then(function(v3) {
-      resolve60({ value: v3, done: d2 });
+      resolve61({ value: v3, done: d2 });
     }, reject);
   }
 }
@@ -149038,15 +149328,15 @@ async function throwErrorIfNotOK(response) {
         }
       };
     }
-    const errorMessage3 = JSON.stringify(errorBody);
+    const errorMessage = JSON.stringify(errorBody);
     if (status >= 400 && status < 600) {
       const apiError = new ApiError({
-        message: errorMessage3,
+        message: errorMessage,
         status
       });
       throw apiError;
     }
-    throw new Error(errorMessage3);
+    throw new Error(errorMessage);
   }
 }
 function includeExtraBodyToRequestInit(requestInit, extraBody) {
@@ -153978,10 +154268,10 @@ var init_node4 = __esm({
                   const errorJson = JSON.parse(JSON.stringify(chunkJson["error"]));
                   const status = errorJson["status"];
                   const code = errorJson["code"];
-                  const errorMessage3 = `got status: ${status}. ${JSON.stringify(chunkJson)}`;
+                  const errorMessage = `got status: ${status}. ${JSON.stringify(chunkJson)}`;
                   if (code >= 400 && code < 600) {
                     const apiError = new ApiError({
-                      message: errorMessage3,
+                      message: errorMessage,
                       status: code
                     });
                     throw apiError;
@@ -154330,8 +154620,8 @@ var init_node4 = __esm({
         const url = `${websocketBaseUrl}/ws/google.ai.generativelanguage.${apiVersion}.GenerativeService.BidiGenerateMusic?key=${apiKey}`;
         let onopenResolve = () => {
         };
-        const onopenPromise = new Promise((resolve60) => {
-          onopenResolve = resolve60;
+        const onopenPromise = new Promise((resolve61) => {
+          onopenResolve = resolve61;
         });
         const callbacks = params.callbacks;
         const onopenAwaitedCallback = function() {
@@ -154537,8 +154827,8 @@ var init_node4 = __esm({
         }
         let onopenResolve = () => {
         };
-        const onopenPromise = new Promise((resolve60) => {
-          onopenResolve = resolve60;
+        const onopenPromise = new Promise((resolve61) => {
+          onopenResolve = resolve61;
         });
         const callbacks = params.callbacks;
         const onopenAwaitedCallback = function() {
@@ -156886,7 +157176,7 @@ var init_node4 = __esm({
         return void 0;
       }
     };
-    sleep$1 = (ms) => new Promise((resolve60) => setTimeout(resolve60, ms));
+    sleep$1 = (ms) => new Promise((resolve61) => setTimeout(resolve61, ms));
     FallbackEncoder = ({ headers, body }) => {
       return {
         bodyHeaders: {
@@ -157395,8 +157685,8 @@ ${underline2}`);
     };
     APIPromise = class _APIPromise extends Promise {
       constructor(client, responsePromise, parseResponse = defaultParseResponse) {
-        super((resolve60) => {
-          resolve60(null);
+        super((resolve61) => {
+          resolve61(null);
         });
         this.responsePromise = responsePromise;
         this.parseResponse = parseResponse;
@@ -158617,9 +158907,9 @@ __export(snapshot_exports, {
   examples: () => examples26
 });
 import { spawn as spawn16 } from "child_process";
-import { existsSync as existsSync81, mkdtempSync as mkdtempSync5, readFileSync as readFileSync54, mkdirSync as mkdirSync38, rmSync as rmSync18, writeFileSync as writeFileSync28 } from "fs";
+import { existsSync as existsSync81, mkdtempSync as mkdtempSync5, readFileSync as readFileSync53, mkdirSync as mkdirSync38, rmSync as rmSync18, writeFileSync as writeFileSync28 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
-import { resolve as resolve53, join as join83, relative as relative15, isAbsolute as isAbsolute14 } from "path";
+import { resolve as resolve54, join as join83, relative as relative15, isAbsolute as isAbsolute14, basename as basename18 } from "path";
 async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false) {
   const tmp = mkdtempSync5(join83(tmpdir6(), "hf-snapshot-frame-"));
   const outPath = join83(tmp, "frame.png");
@@ -158665,7 +158955,7 @@ async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDeco
       }
     );
     if (result.code !== 0 || result.timedOut || !existsSync81(outPath)) return null;
-    return readFileSync54(outPath);
+    return readFileSync53(outPath);
   } finally {
     try {
       rmSync18(tmp, { recursive: true, force: true });
@@ -158732,21 +159022,24 @@ async function captureSnapshots(projectDir, opts) {
       await new Promise((r2) => setTimeout(r2, 1500));
       const fontReport = await page.evaluate(() => {
         const loaded = [];
-        const failed = [];
+        const errored = [];
+        const unused = [];
         document.fonts.forEach((f3) => {
           const entry = `${f3.family} (${f3.weight} ${f3.style})`;
           if (f3.status === "loaded") loaded.push(entry);
-          else failed.push(entry + ` [${f3.status}]`);
+          else if (f3.status === "error") errored.push(entry);
+          else unused.push(entry);
         });
-        return { loaded, failed };
-      }).catch(() => ({ loaded: [], failed: [] }));
-      if (fontReport.loaded.length > 0 || fontReport.failed.length > 0) {
-        console.log(
-          `
-   ${c.dim("Fonts loaded:")} ${fontReport.loaded.length > 0 ? fontReport.loaded.join(", ") : "none"}`
-        );
-        if (fontReport.failed.length > 0) {
-          console.log(`   ${c.error("Fonts FAILED:")} ${fontReport.failed.join(", ")}`);
+        return { loaded, errored, unused };
+      }).catch(() => ({ loaded: [], errored: [], unused: [] }));
+      if (fontReport.loaded.length > 0 || fontReport.errored.length > 0 || fontReport.unused.length > 0) {
+        const parts = [`${fontReport.loaded.length} loaded`];
+        if (fontReport.errored.length > 0) parts.push(`${fontReport.errored.length} failed`);
+        if (fontReport.unused.length > 0) parts.push(`${fontReport.unused.length} unused`);
+        console.log(`
+   ${c.dim("Fonts:")} ${parts.join(", ")}`);
+        if (fontReport.errored.length > 0) {
+          console.log(`   ${c.error("Fonts FAILED:")} ${fontReport.errored.join(", ")}`);
         }
       }
       const duration = await page.evaluate(() => {
@@ -158763,7 +159056,7 @@ async function captureSnapshots(projectDir, opts) {
         return [];
       }
       const positions = opts.at?.length ? opts.at : numFrames === 1 ? [duration / 2] : Array.from({ length: numFrames }, (_, i2) => i2 / (numFrames - 1) * duration);
-      const snapshotDir = join83(projectDir, "snapshots");
+      const snapshotDir = opts.outputDir ?? join83(projectDir, "snapshots");
       mkdirSync38(snapshotDir, { recursive: true });
       try {
         const { readdirSync: readdirSync35 } = await import("fs");
@@ -158848,9 +159141,9 @@ async function captureSnapshots(projectDir, opts) {
             try {
               const url = new URL(v2.src);
               const decodedPath = decodeURIComponent(url.pathname).replace(/^\//, "");
-              const candidate = resolve53(projectDir, decodedPath);
-              const rel = relative15(projectDir, candidate);
-              if (!rel.startsWith("..") && !isAbsolute14(rel) && existsSync81(candidate)) {
+              const candidate = resolve54(projectDir, decodedPath);
+              const rel2 = relative15(projectDir, candidate);
+              if (!rel2.startsWith("..") && !isAbsolute14(rel2) && existsSync81(candidate)) {
                 filePath = candidate;
               }
             } catch {
@@ -158882,7 +159175,8 @@ async function captureSnapshots(projectDir, opts) {
         const filename = `frame-${String(i2).padStart(2, "0")}-at-${timeLabel}.png`;
         const framePath = join83(snapshotDir, filename);
         await page.screenshot({ path: framePath, type: "png" });
-        savedPaths.push(`snapshots/${filename}`);
+        const rel = relative15(projectDir, framePath);
+        savedPaths.push(rel.startsWith("..") || isAbsolute14(rel) ? framePath : rel);
       }
     } finally {
       await chromeBrowser.close();
@@ -158898,6 +159192,7 @@ var init_snapshot = __esm({
     "use strict";
     init_dist();
     init_project();
+    init_errorMessage();
     init_compositionViewport();
     init_staticProjectServer();
     init_colors();
@@ -158918,6 +159213,11 @@ var init_snapshot = __esm({
           description: "Project directory",
           required: false
         },
+        output: {
+          type: "string",
+          alias: "o",
+          description: "Directory to write snapshots into (default: <project>/snapshots)"
+        },
         frames: {
           type: "string",
           description: "Number of evenly-spaced frames to capture (default: 5)",
@@ -158946,7 +159246,13 @@ var init_snapshot = __esm({
         const label2 = atTimestamps ? `${atTimestamps.length} frames at [${atTimestamps.map((t2) => t2.toFixed(1) + "s").join(", ")}]` : `${frames} frames`;
         console.log(`${c.accent("\u25C6")}  Capturing ${label2} from ${c.accent(project.name)}`);
         try {
-          const paths = await captureSnapshots(project.dir, { frames, timeout, at: atTimestamps });
+          const snapshotDir = args.output ? resolve54(String(args.output)) : join83(project.dir, "snapshots");
+          const paths = await captureSnapshots(project.dir, {
+            frames,
+            timeout,
+            at: atTimestamps,
+            outputDir: snapshotDir
+          });
           if (paths.length === 0) {
             console.log(
               `
@@ -158954,14 +159260,15 @@ ${c.error("\u2717")} Could not determine composition duration \u2014 no frames c
             );
             process.exit(1);
           }
-          console.log(`
-${c.success("\u25C7")}  ${paths.length} snapshots saved to snapshots/`);
+          console.log(
+            `
+${c.success("\u25C7")}  ${paths.length} snapshots saved to ${args.output ? snapshotDir : "snapshots/"}`
+          );
           for (const p2 of paths) {
             console.log(`   ${p2}`);
           }
           try {
             const { createSnapshotContactSheet: createSnapshotContactSheet2 } = await Promise.resolve().then(() => (init_contactSheet(), contactSheet_exports));
-            const snapshotDir = join83(project.dir, "snapshots");
             const sheets = await createSnapshotContactSheet2(
               snapshotDir,
               join83(snapshotDir, "contact-sheet.jpg")
@@ -158982,7 +159289,6 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to snapshots/`);
                 const { GoogleGenAI: GoogleGenAI2 } = await Promise.resolve().then(() => (init_node4(), node_exports));
                 const ai = new GoogleGenAI2({ apiKey: geminiKey });
                 const model = process.env.HYPERFRAMES_GEMINI_MODEL || "gemini-3.1-flash-lite-preview";
-                const snapshotDir = join83(project.dir, "snapshots");
                 const customQuestion = describeArg === "true" ? "Describe this video composition frame in 1-2 sentences. Be specific and factual: what elements are visible, what text appears, is the frame blank/black/loading, what is the composition. Flag any obvious problems." : describeArg;
                 const descriptions = [
                   `# Snapshot Frame Descriptions`,
@@ -159000,10 +159306,10 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to snapshots/`);
                 }
                 const results = await Promise.allSettled(
                   paths.map(async (p2) => {
-                    const filename = p2.replace("snapshots/", "");
+                    const filename = basename18(p2);
                     const filePath = join83(snapshotDir, filename);
                     if (!existsSync81(filePath)) return { filename, desc: "file not found" };
-                    const raw = readFileSync54(filePath);
+                    const raw = readFileSync53(filePath);
                     let imageData;
                     let mimeType = "image/png";
                     if (sharpFn) {
@@ -159035,7 +159341,7 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to snapshots/`);
                   if (result.status === "fulfilled") {
                     descriptions.push(`## ${result.value.filename}`, `${result.value.desc}`, ``);
                   } else {
-                    const errMsg = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                    const errMsg = normalizeErrorMessage(result.reason);
                     descriptions.push(`## (error)`, `Gemini call failed: ${errMsg.slice(0, 120)}`, ``);
                   }
                 }
@@ -159044,12 +159350,12 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to snapshots/`);
                 console.log(`   ${c.dim("descriptions.md")} (Gemini frame analysis)`);
               }
             } catch (descErr) {
-              const msg = descErr instanceof Error ? descErr.message : String(descErr);
+              const msg = normalizeErrorMessage(descErr);
               console.log(`   ${c.dim(`--describe failed: ${msg.slice(0, 80)}`)}`);
             }
           }
         } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
+          const msg = normalizeErrorMessage(err);
           console.error(`
 ${c.error("\u2717")} Snapshot failed: ${msg}`);
           process.exit(1);
@@ -159396,8 +159702,8 @@ __export(video_exports, {
   runVideoMode: () => runVideoMode,
   safeFilename: () => safeFilename
 });
-import { createWriteStream as createWriteStream4, existsSync as existsSync83, mkdirSync as mkdirSync40, readFileSync as readFileSync55, unlinkSync as unlinkSync7 } from "fs";
-import { resolve as resolve54, join as join85, basename as basename18 } from "path";
+import { createWriteStream as createWriteStream4, existsSync as existsSync83, mkdirSync as mkdirSync40, readFileSync as readFileSync54, unlinkSync as unlinkSync7 } from "fs";
+import { resolve as resolve55, join as join85, basename as basename19 } from "path";
 async function streamToFile(url, destPath) {
   const r2 = await safeFetch(url, {
     signal: AbortSignal.timeout(12e4),
@@ -159475,9 +159781,9 @@ function safeFilename(name) {
   return decoded.replace(/[^A-Za-z0-9._-]+/g, "_");
 }
 function findFilenameCollision(manifest, selected) {
-  const selectedName = safeFilename(selected.filename || basename18(selected.url));
+  const selectedName = safeFilename(selected.filename || basename19(selected.url));
   return manifest.filter(
-    (e3) => e3.index !== selected.index && safeFilename(e3.filename || basename18(e3.url)) === selectedName
+    (e3) => e3.index !== selected.index && safeFilename(e3.filename || basename19(e3.url)) === selectedName
   );
 }
 function pickManifestEntry(manifest, args) {
@@ -159515,7 +159821,7 @@ function pickManifestEntry(manifest, args) {
   };
 }
 async function runVideoMode(args) {
-  const projectDir = resolve54(args.project);
+  const projectDir = resolve55(args.project);
   const directPath = join85(projectDir, "extracted", "video-manifest.json");
   const w2hPath = join85(projectDir, "capture", "extracted", "video-manifest.json");
   const manifestPath = existsSync83(directPath) ? directPath : w2hPath;
@@ -159530,7 +159836,7 @@ async function runVideoMode(args) {
   }
   let manifest;
   try {
-    manifest = JSON.parse(readFileSync55(manifestPath, "utf-8"));
+    manifest = JSON.parse(readFileSync54(manifestPath, "utf-8"));
   } catch (e3) {
     console.error(`${c.error("\u2717")} video-manifest.json is malformed: ${e3.message}`);
     process.exitCode = 1;
@@ -159546,7 +159852,7 @@ async function runVideoMode(args) {
     );
     for (const e3 of manifest) {
       console.log(
-        `  ${c.bold(`[${e3.index}]`)} ${e3.filename} \u2014 ${e3.width}\xD7${e3.height}` + (e3.heading ? `
+        `  ${c.bold(`[${e3.index}]`)} ${e3.filename} \u2014 ${e3.sourceWidth || e3.width}\xD7${e3.sourceHeight || e3.height}` + (e3.heading ? `
       heading: "${e3.heading}"` : "") + `
       url: ${e3.url}`
       );
@@ -159566,18 +159872,18 @@ async function runVideoMode(args) {
   const collisions = findFilenameCollision(manifest, entry);
   if (collisions.length > 0) {
     console.error(
-      `${c.error("\u2717")} filename "${safeFilename(entry.filename || basename18(entry.url))}" collides with manifest entr${collisions.length === 1 ? "y" : "ies"} ${collisions.map((co) => `[${co.index}]`).join(", ")}. Refusing to download \u2014 the on-disk file's bytes would not match the requested entry.`
+      `${c.error("\u2717")} filename "${safeFilename(entry.filename || basename19(entry.url))}" collides with manifest entr${collisions.length === 1 ? "y" : "ies"} ${collisions.map((co) => `[${co.index}]`).join(", ")}. Refusing to download \u2014 the on-disk file's bytes would not match the requested entry.`
     );
     process.exitCode = 1;
     return;
   }
   const outDir = isW2hLayout ? join85(projectDir, "capture", "assets", "videos") : join85(projectDir, "assets", "videos");
   mkdirSync40(outDir, { recursive: true });
-  const fname = safeFilename(entry.filename || basename18(entry.url));
+  const fname = safeFilename(entry.filename || basename19(entry.url));
   const outPath = join85(outDir, fname);
   const relPath = isW2hLayout ? `capture/assets/videos/${fname}` : `assets/videos/${fname}`;
   console.log(
-    `${c.accent("\u25B8")} downloading [${entry.index}] ${entry.filename} (${entry.width}\xD7${entry.height})`
+    `${c.accent("\u25B8")} downloading [${entry.index}] ${entry.filename} (${entry.sourceWidth || entry.width}\xD7${entry.sourceHeight || entry.height})`
   );
   console.log(`     from: ${entry.url}`);
   try {
@@ -159588,7 +159894,7 @@ async function runVideoMode(args) {
     const snippetId = `video-${entry.index}`;
     console.log(
       `     Reference it from a beat composition as:
-       <video id="${snippetId}" src="${relPath}" data-start="0" data-duration="${entry.width === entry.height ? 5 : 4}" data-track-index="0" autoplay muted loop></video>`
+       <video id="${snippetId}" src="${relPath}" data-start="0" data-duration="${(entry.sourceWidth || entry.width) === (entry.sourceHeight || entry.height) ? 5 : 4}" data-track-index="0" autoplay muted loop></video>`
     );
   } catch (e3) {
     if (e3.code === "EEXIST") {
@@ -160602,7 +160908,7 @@ var init_designStyleExtractor = __esm({
 });
 
 // src/capture/fontMetadataExtractor.ts
-import { readdirSync as readdirSync29, readFileSync as readFileSync56, writeFileSync as writeFileSync30, existsSync as existsSync84 } from "fs";
+import { readdirSync as readdirSync29, readFileSync as readFileSync55, writeFileSync as writeFileSync30, existsSync as existsSync84 } from "fs";
 import { join as join86 } from "path";
 import * as fontkit from "fontkit";
 function isFontCollection(value) {
@@ -160652,7 +160958,7 @@ function readSingleFont(fullPath, filename) {
     identified: false
   };
   try {
-    const buf = readFileSync56(fullPath);
+    const buf = readFileSync55(fullPath);
     const created = fontkit.create(buf);
     const font = isFontCollection(created) ? created.fonts[0] : created;
     if (!font) return empty2;
@@ -160908,7 +161214,7 @@ var init_animationCataloger = __esm({
 });
 
 // src/capture/mediaCapture.ts
-import { mkdirSync as mkdirSync41, writeFileSync as writeFileSync31, readdirSync as readdirSync30, readFileSync as readFileSync57, statSync as statSync24 } from "fs";
+import { mkdirSync as mkdirSync41, writeFileSync as writeFileSync31, readdirSync as readdirSync30, readFileSync as readFileSync56, statSync as statSync25 } from "fs";
 import { join as join87, extname as extname16 } from "path";
 async function saveLottieAnimations(discoveredLotties, lottieDir) {
   let savedCount = 0;
@@ -160974,17 +161280,17 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
   for (const file of readdirSync30(lottieDir)) {
     if (!file.endsWith(".json")) continue;
     try {
-      const raw = JSON.parse(readFileSync57(join87(lottieDir, file), "utf-8"));
+      const raw = JSON.parse(readFileSync56(join87(lottieDir, file), "utf-8"));
       const fr = raw.fr || 30;
       const dur = ((raw.op || 0) - (raw.ip || 0)) / fr;
       const previewName = file.replace(".json", "-preview.png");
-      const fileSize = statSync24(join87(lottieDir, file)).size;
+      const fileSize = statSync25(join87(lottieDir, file)).size;
       if (fileSize > 2e6) continue;
       let previewPage;
       try {
         previewPage = await chromeBrowser.newPage();
         await previewPage.setViewport({ width: 400, height: 400 });
-        const animData = JSON.parse(readFileSync57(join87(lottieDir, file), "utf-8"));
+        const animData = JSON.parse(readFileSync56(join87(lottieDir, file), "utf-8"));
         const midFrame = Math.floor(((raw.op || 0) - (raw.ip || 0)) * 0.3);
         await previewPage.setContent(
           `<!DOCTYPE html>
@@ -161122,6 +161428,8 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
         filename: k2,
         width: 0,
         height: 0,
+        sourceWidth: 0,
+        sourceHeight: 0,
         top: 0,
         left: 0,
         heading: "",
@@ -161179,6 +161487,8 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
       filename: v2.filename,
       width: v2.width,
       height: v2.height,
+      sourceWidth: v2.sourceWidth,
+      sourceHeight: v2.sourceHeight,
       heading: v2.heading,
       caption: v2.caption,
       ariaLabel: v2.ariaLabel,
@@ -161235,8 +161545,14 @@ var init_mediaCapture = __esm({
     if (!ariaLabel && wrapper) ariaLabel = wrapper.getAttribute('aria-label') || '';
     return {
       src: src,
+      // width/height are the DOM display box (what the page laid the element out
+      // at); sourceWidth/Height are the clip's intrinsic resolution. Size planners
+      // off the source dims, not the display box (a 1920x1080 clip can display at
+      // 904x613). 0 when metadata has not loaded yet.
       width: Math.round(rect.width),
       height: Math.round(rect.height),
+      sourceWidth: v.videoWidth || 0,
+      sourceHeight: v.videoHeight || 0,
       top: Math.round(rect.top),
       left: Math.round(rect.left),
       heading: heading,
@@ -161250,8 +161566,8 @@ var init_mediaCapture = __esm({
 });
 
 // src/capture/contentExtractor.ts
-import { existsSync as existsSync85, readdirSync as readdirSync31, statSync as statSync25, readFileSync as readFileSync58 } from "fs";
-import { basename as basename19, join as join88 } from "path";
+import { existsSync as existsSync85, readdirSync as readdirSync31, statSync as statSync26, readFileSync as readFileSync57 } from "fs";
+import { basename as basename20, join as join88 } from "path";
 async function detectLibraries(page, capturedShaders) {
   let detectedLibraries = [];
   try {
@@ -161427,9 +161743,9 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
       const results = await Promise.allSettled(
         batch.map(async (file) => {
           const filePath = join88(outputDir, "assets", file);
-          const stat3 = statSync25(filePath);
+          const stat3 = statSync26(filePath);
           if (stat3.size > 4e6) return { file, caption: "" };
-          const buffer = readFileSync58(filePath);
+          const buffer = readFileSync57(filePath);
           const base64 = buffer.toString("base64");
           const ext = file.split(".").pop()?.toLowerCase() || "png";
           const mimeType = ext === "jpg" ? "image/jpeg" : `image/${ext}`;
@@ -161491,7 +161807,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
             const filePath = join88(assetsDir, relPath);
             let pngBase64;
             try {
-              const svgSource = readFileSync58(filePath, "utf-8");
+              const svgSource = readFileSync57(filePath, "utf-8");
               const lightFillHits = (svgSource.match(/fill\s*=\s*["'](#fff(fff)?|white|#[ef][ef][ef]|#[ef]{6})["']/gi) || []).length;
               const darkFillHits = (svgSource.match(/fill\s*=\s*["'](#000(000)?|black|#[0-3]{6}|#[0-3]{3})["']/gi) || []).length;
               const bg = lightFillHits > darkFillHits ? { r: 32, g: 32, b: 32 } : { r: 255, g: 255, b: 255 };
@@ -161551,7 +161867,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
     for (const file of readdirSync31(assetsPath)) {
       if (file === "svgs" || file === "fonts" || file === "lottie" || file === "videos") continue;
       const filePath = join88(assetsPath, file);
-      const stat3 = statSync25(filePath);
+      const stat3 = statSync26(filePath);
       if (!stat3.isFile()) continue;
       const sizeKb = Math.round(stat3.size / 1024);
       const catalogMatch = catalogedAssets.find(
@@ -161607,14 +161923,16 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   const videoLines = [];
   try {
     const manifest = JSON.parse(
-      readFileSync58(join88(outputDir, "extracted", "video-manifest.json"), "utf-8")
+      readFileSync57(join88(outputDir, "extracted", "video-manifest.json"), "utf-8")
     );
     for (const v2 of manifest) {
       if (!v2.localPath) continue;
-      const base2 = basename19(v2.localPath) || v2.filename || "";
+      const base2 = basename20(v2.localPath) || v2.filename || "";
       if (!base2) continue;
       const desc = (v2.caption || v2.heading || "").trim().replace(/\s+/g, " ").slice(0, 140) || "motion clip";
-      const dims = v2.width && v2.height ? `, ~${v2.width}\xD7${v2.height}` : "";
+      const dimW = v2.sourceWidth || v2.width;
+      const dimH = v2.sourceHeight || v2.height;
+      const dims = dimW && dimH ? `, ~${dimW}\xD7${dimH}` : "";
       videoLines.push(`${base2} \u2014 [video] ${desc}${dims}`);
     }
   } catch {
@@ -161767,15 +162085,15 @@ var init_agentPromptGenerator = __esm({
 });
 
 // src/capture/scaffolding.ts
-import { existsSync as existsSync87, writeFileSync as writeFileSync34, readFileSync as readFileSync59 } from "fs";
-import { join as join90, resolve as resolve55 } from "path";
+import { existsSync as existsSync87, writeFileSync as writeFileSync34, readFileSync as readFileSync58 } from "fs";
+import { join as join90, resolve as resolve56 } from "path";
 function loadEnvFile(startDir) {
   try {
-    let dir = resolve55(startDir);
+    let dir = resolve56(startDir);
     for (let i2 = 0; i2 < 5; i2++) {
-      const envPath = resolve55(dir, ".env");
+      const envPath = resolve56(dir, ".env");
       try {
-        const envContent = readFileSync59(envPath, "utf-8");
+        const envContent = readFileSync58(envPath, "utf-8");
         for (const line of envContent.split("\n")) {
           const trimmed = line.trim();
           if (!trimmed || trimmed.startsWith("#")) continue;
@@ -161787,7 +162105,7 @@ function loadEnvFile(startDir) {
         }
         break;
       } catch {
-        dir = resolve55(dir, "..");
+        dir = resolve56(dir, "..");
       }
     }
   } catch {
@@ -162509,7 +162827,7 @@ async function captureWebsite(opts, onProgress) {
       );
     } catch (err) {
       const errMsg = err instanceof Error ? `${err.message}
-${err.stack}` : String(err);
+${err.stack}` : normalizeErrorMessage(err);
       console.error(`  \u26A0 Design style extraction failed: ${errMsg}`);
       warnings.push(`Design style extraction failed: ${errMsg}`);
     }
@@ -162591,10 +162909,7 @@ ${err.stack}` : String(err);
         }
       }
     } catch (err) {
-      console.warn(
-        "Font metadata extraction failed (non-fatal):",
-        err instanceof Error ? err.message : err
-      );
+      console.warn("Font metadata extraction failed (non-fatal):", normalizeErrorMessage(err));
     }
     if (animationCatalog) {
       const uniqueAnimNames = /* @__PURE__ */ new Set();
@@ -162755,6 +163070,7 @@ var init_capture = __esm({
     init_designStyleExtractor();
     init_assetDownloader();
     init_fontMetadataExtractor();
+    init_errorMessage();
     init_animationCataloger();
     init_mediaCapture();
     init_contentExtractor();
@@ -162768,12 +163084,13 @@ __export(capture_exports2, {
   default: () => capture_default,
   examples: () => examples27
 });
-import { resolve as resolve56 } from "path";
+import { resolve as resolve57 } from "path";
 var examples27, capture_default;
 var init_capture2 = __esm({
   "src/commands/capture.ts"() {
     "use strict";
     init_dist();
+    init_errorMessage();
     examples27 = [
       ["Capture a website into ./capture/", "hyperframes capture https://stripe.com"],
       ["Capture to a different directory", "hyperframes capture https://linear.app -o linear-video"],
@@ -162866,13 +163183,13 @@ var init_capture2 = __esm({
         }
         const isDefaultOutput = !args.output;
         let outputName = args.output ?? "capture";
-        let outputDir = resolve56(outputName);
+        let outputDir = resolve57(outputName);
         if (isDefaultOutput) {
           const { existsSync: existsSync98 } = await import("fs");
           let n2 = 2;
           while (existsSync98(outputDir) && n2 < 100) {
             outputName = `capture-${n2}`;
-            outputDir = resolve56(outputName);
+            outputDir = resolve57(outputName);
             n2++;
           }
           if (existsSync98(outputDir)) {
@@ -162958,7 +163275,7 @@ var init_capture2 = __esm({
             console.log();
           }
         } catch (err) {
-          const errMsg = err instanceof Error ? err.message : String(err);
+          const errMsg = normalizeErrorMessage(err);
           try {
             const { mkdirSync: mkdirSync49, writeFileSync: writeFileSync39 } = await import("fs");
             mkdirSync49(outputDir, { recursive: true });
@@ -163007,7 +163324,7 @@ __export(state_exports, {
   stateFilePath: () => stateFilePath,
   writeStackOutputs: () => writeStackOutputs
 });
-import { existsSync as existsSync89, mkdirSync as mkdirSync45, readdirSync as readdirSync34, readFileSync as readFileSync60, rmSync as rmSync19, writeFileSync as writeFileSync37 } from "fs";
+import { existsSync as existsSync89, mkdirSync as mkdirSync45, readdirSync as readdirSync34, readFileSync as readFileSync59, rmSync as rmSync19, writeFileSync as writeFileSync37 } from "fs";
 import { dirname as dirname39, join as join94 } from "path";
 function stateFilePath(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   return join94(cwd, STATE_DIR_NAME, `${STATE_FILE_PREFIX}${stackName}.json`);
@@ -163022,7 +163339,7 @@ function readStackOutputs(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   const path2 = stateFilePath(stackName, cwd);
   if (!existsSync89(path2)) return null;
   try {
-    return JSON.parse(readFileSync60(path2, "utf-8"));
+    return JSON.parse(readFileSync59(path2, "utf-8"));
   } catch {
     return null;
   }
@@ -163181,16 +163498,16 @@ var init_sam = __esm({
 
 // src/commands/lambda/repoRoot.ts
 import { existsSync as existsSync91 } from "fs";
-import { dirname as dirname40, resolve as resolve57 } from "path";
+import { dirname as dirname40, resolve as resolve58 } from "path";
 import { fileURLToPath as fileURLToPath15 } from "url";
 function repoRoot() {
   const override = process.env.HYPERFRAMES_REPO_ROOT;
-  if (override && existsSync91(resolve57(override, "packages", "aws-lambda", "package.json"))) {
+  if (override && existsSync91(resolve58(override, "packages", "aws-lambda", "package.json"))) {
     return override;
   }
   let dir = dirname40(fileURLToPath15(import.meta.url));
   for (let depth = 0; depth < 12; depth++) {
-    if (existsSync91(resolve57(dir, "packages", "aws-lambda", "package.json"))) {
+    if (existsSync91(resolve58(dir, "packages", "aws-lambda", "package.json"))) {
       return dir;
     }
     const parent = dirname40(dir);
@@ -163214,7 +163531,7 @@ __export(deploy_exports, {
 });
 import { spawnSync as spawnSync5 } from "child_process";
 import { existsSync as existsSync92 } from "fs";
-import { join as join96, resolve as resolve58 } from "path";
+import { join as join96, resolve as resolve59 } from "path";
 async function runDeploy(args = {}) {
   const resolved = {
     stackName: args.stackName ?? DEFAULT_STACK_NAME,
@@ -163268,7 +163585,7 @@ async function runDeploy(args = {}) {
   console.log(`  ${c.dim("Bucket:")}         ${outputs.bucketName}`);
   console.log(`  ${c.dim("State machine:")}  ${outputs.stateMachineArn}`);
   console.log(`  ${c.dim("Function:")}       ${outputs.functionName}`);
-  console.log(`  ${c.dim("State file:")}     ${resolve58(statePath2)}`);
+  console.log(`  ${c.dim("State file:")}     ${resolve59(statePath2)}`);
   console.log();
   console.log(c.dim(`Render with: hyperframes lambda render <project-dir>`));
 }
@@ -163344,14 +163661,14 @@ var init_sites = __esm({
 });
 
 // src/commands/lambda/_dimensions.ts
-import { readFileSync as readFileSync61 } from "fs";
+import { readFileSync as readFileSync60 } from "fs";
 import { join as join97 } from "path";
 function warnOnDimensionMismatch(args) {
   if (args.quiet) return;
   if (args.outputResolution) return;
   let html;
   try {
-    html = readFileSync61(join97(args.projectDir, "index.html"), "utf-8");
+    html = readFileSync60(join97(args.projectDir, "index.html"), "utf-8");
   } catch {
     return;
   }
@@ -163521,7 +163838,7 @@ __export(render_batch_exports, {
   runRenderBatch: () => runRenderBatch,
   runWithConcurrencyLimit: () => runWithConcurrencyLimit
 });
-import { existsSync as existsSync94, readFileSync as readFileSync63 } from "fs";
+import { existsSync as existsSync94, readFileSync as readFileSync61 } from "fs";
 import { join as join99, resolve as resolvePath3 } from "path";
 async function loadSDK3() {
   return import("@hyperframes/aws-lambda/sdk");
@@ -163638,7 +163955,7 @@ async function runRenderBatch(args) {
         outputKey: entry.outputKey,
         executionArn: null,
         status: "failed-to-start",
-        error: err instanceof Error ? err.message : String(err)
+        error: normalizeErrorMessage(err)
       };
     }
   };
@@ -163674,7 +163991,7 @@ function makePlaceholderSiteHandle(siteId, bucketName) {
   };
 }
 function parseBatchFile(path2) {
-  const raw = readFileSync63(path2, "utf8");
+  const raw = readFileSync61(path2, "utf8");
   const lines = raw.split(/\r?\n/);
   const out = [];
   for (let i2 = 0; i2 < lines.length; i2++) {
@@ -163684,10 +164001,7 @@ function parseBatchFile(path2) {
     try {
       parsed = JSON.parse(line);
     } catch (err) {
-      errorBox(
-        `Invalid JSON in batch file on line ${i2 + 1}`,
-        err instanceof Error ? err.message : String(err)
-      );
+      errorBox(`Invalid JSON in batch file on line ${i2 + 1}`, normalizeErrorMessage(err));
       process.exit(1);
     }
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -163755,6 +164069,7 @@ var init_render_batch = __esm({
     init_colors();
     init_format();
     init_variables();
+    init_errorMessage();
     init_dimensions();
     init_state();
     DEFAULT_MAX_CONCURRENT = 50;
@@ -163868,7 +164183,7 @@ __export(policies_exports, {
   runPolicies: () => runPolicies,
   validatePolicy: () => validatePolicy
 });
-import { readFileSync as readFileSync64 } from "fs";
+import { readFileSync as readFileSync63 } from "fs";
 function allRequiredActions() {
   const set = /* @__PURE__ */ new Set();
   for (const group of Object.values(REQUIRED_ACTIONS)) {
@@ -163938,7 +164253,7 @@ async function runPolicies(args) {
       try {
         result = validatePolicy(args.inputPath);
       } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
+        const msg = normalizeErrorMessage(err);
         if (args.json) {
           console.log(JSON.stringify({ ok: false, error: msg }, null, 2));
           process.exitCode = 1;
@@ -163974,7 +164289,7 @@ async function runPolicies(args) {
   }
 }
 function validatePolicy(policyPath) {
-  const raw = readFileSync64(policyPath, "utf-8");
+  const raw = readFileSync63(policyPath, "utf-8");
   const parsed = JSON.parse(raw);
   const statements = Array.isArray(parsed.Statement) ? parsed.Statement : parsed.Statement ? [
     parsed.Statement
@@ -164043,6 +164358,7 @@ var init_policies = __esm({
   "src/commands/lambda/policies.ts"() {
     "use strict";
     init_colors();
+    init_errorMessage();
     REQUIRED_ACTIONS = {
       cloudformation: [
         "cloudformation:CreateChangeSet",
@@ -164568,9 +164884,9 @@ __export(cloudrun_exports, {
 });
 import { spawnSync as spawnSync6 } from "child_process";
 import { createRequire as createRequire4 } from "module";
-import { existsSync as existsSync95, mkdirSync as mkdirSync46, readFileSync as readFileSync65, writeFileSync as writeFileSync38 } from "fs";
+import { existsSync as existsSync95, mkdirSync as mkdirSync46, readFileSync as readFileSync64, writeFileSync as writeFileSync38 } from "fs";
 import { homedir as homedir14 } from "os";
-import { dirname as dirname41, join as join100, resolve as resolve59 } from "path";
+import { dirname as dirname41, join as join100, resolve as resolve60 } from "path";
 function stateDir() {
   return join100(homedir14(), ".hyperframes");
 }
@@ -164589,7 +164905,7 @@ function readState(args) {
   let base2 = {};
   if (existsSync95(statePath())) {
     try {
-      base2 = JSON.parse(readFileSync65(statePath(), "utf8"));
+      base2 = JSON.parse(readFileSync64(statePath(), "utf8"));
     } catch {
     }
   }
@@ -164735,7 +165051,7 @@ function machineVars(args, project, region, image) {
   return vars;
 }
 function findRepoRoot(tfDir) {
-  const candidate = resolve59(tfDir, "..", "..", "..");
+  const candidate = resolve60(tfDir, "..", "..", "..");
   if (existsSync95(join100(candidate, "packages", "gcp-cloud-run", "Dockerfile"))) return candidate;
   return null;
 }
@@ -164770,7 +165086,7 @@ async function runSites(args) {
   const state = readState(args);
   const { deploySite } = await import("@hyperframes/gcp-cloud-run/sdk");
   const handle = await deploySite({
-    projectDir: resolve59(projectDir),
+    projectDir: resolve60(projectDir),
     bucketName: state.bucketName,
     siteId: args["site-id"]
   });
@@ -164803,11 +165119,11 @@ async function runRender2(args) {
     process.exit(1);
   }
   const state = readState(args);
-  const variables = resolveAndValidateVariables(args, resolve59(projectDir));
+  const variables = resolveAndValidateVariables(args, resolve60(projectDir));
   const config = buildRenderConfig(args, fps, width, height, variables);
   const { renderToCloudRun, getRenderProgress } = await import("@hyperframes/gcp-cloud-run/sdk");
   const handle = await renderToCloudRun({
-    projectDir: resolve59(projectDir),
+    projectDir: resolve60(projectDir),
     config,
     bucketName: state.bucketName,
     projectId: state.projectId,
@@ -164887,11 +165203,11 @@ async function runRenderBatch2(args) {
     console.error(`[cloudrun render-batch] --fps must be 24, 30, or 60; got ${fps}.`);
     process.exit(1);
   }
-  if (!existsSync95(resolve59(batchPath))) {
+  if (!existsSync95(resolve60(batchPath))) {
     console.error(`[cloudrun render-batch] batch file not found: ${batchPath}`);
     process.exit(1);
   }
-  const entries2 = parseBatchFile2(resolve59(batchPath));
+  const entries2 = parseBatchFile2(resolve60(batchPath));
   if (entries2.length === 0) {
     console.error("[cloudrun render-batch] batch file has no entries.");
     process.exit(1);
@@ -164910,7 +165226,7 @@ async function runRenderBatch2(args) {
   const maxConcurrent = parsePositiveInt2(args["max-concurrent"], "--max-concurrent") ?? DEFAULT_BATCH_MAX_CONCURRENT;
   const { deploySite, renderToCloudRun } = await import("@hyperframes/gcp-cloud-run/sdk");
   const siteHandle = await deploySite({
-    projectDir: resolve59(projectDir),
+    projectDir: resolve60(projectDir),
     bucketName: state.bucketName,
     siteId: args["site-id"]
   });
@@ -164935,7 +165251,7 @@ async function runRenderBatch2(args) {
         } catch (err) {
           return {
             outputKey: entry.outputKey,
-            error: err instanceof Error ? err.message : String(err)
+            error: normalizeErrorMessage(err)
           };
         }
       })
@@ -164954,7 +165270,7 @@ async function runRenderBatch2(args) {
   if (failed.length > 0) process.exit(1);
 }
 function parseBatchFile2(path2) {
-  const lines = readFileSync65(path2, "utf8").split(/\r?\n/);
+  const lines = readFileSync64(path2, "utf8").split(/\r?\n/);
   const entries2 = [];
   lines.forEach((line, idx) => {
     const trimmed = line.trim();
@@ -164978,7 +165294,7 @@ function parseBatchFile2(path2) {
 }
 function runDestroy2(args) {
   const tfDir = terraformDir();
-  const state = existsSync95(statePath()) ? JSON.parse(readFileSync65(statePath(), "utf8")) : {};
+  const state = existsSync95(statePath()) ? JSON.parse(readFileSync64(statePath(), "utf8")) : {};
   const project = args.project ?? state.projectId;
   const region = args.region ?? state.region ?? "us-central1";
   const image = args.image ?? "unused:latest";
@@ -165072,6 +165388,7 @@ var init_cloudrun = __esm({
     init_dist3();
     init_colors();
     init_variables();
+    init_errorMessage();
     examples29 = [
       ["Deploy the Cloud Run render stack", "hyperframes cloudrun deploy --project my-gcp-project"],
       [
@@ -165256,7 +165573,7 @@ ${HELP2}`);
 });
 
 // src/cloud/detectAspectRatio.ts
-import { readFileSync as readFileSync66 } from "fs";
+import { readFileSync as readFileSync65 } from "fs";
 function extractAttributeNumber(tag, re2) {
   const match = tag.match(re2);
   if (!match) return null;
@@ -165268,9 +165585,9 @@ function extractAttributeNumber(tag, re2) {
 function detectAspectRatioFromHtml(entryHtmlPath) {
   let html;
   try {
-    html = readFileSync66(entryHtmlPath, "utf-8");
+    html = readFileSync65(entryHtmlPath, "utf-8");
   } catch (err) {
-    return { kind: "read-error", error: err instanceof Error ? err.message : String(err) };
+    return { kind: "read-error", error: normalizeErrorMessage(err) };
   }
   return detectAspectRatioFromHtmlString(html);
 }
@@ -165294,6 +165611,7 @@ var RATIO_TOLERANCE, SUPPORTED_RATIOS, ROOT_COMPOSITION_DIV_RE, DATA_WIDTH_RE, D
 var init_detectAspectRatio = __esm({
   "src/cloud/detectAspectRatio.ts"() {
     "use strict";
+    init_errorMessage();
     RATIO_TOLERANCE = 0.05;
     SUPPORTED_RATIOS = [
       { value: "16:9", ratio: 16 / 9 },
@@ -165337,14 +165655,14 @@ function signalAbortError(signal) {
   return reason instanceof Error ? reason : new Error("Poll aborted");
 }
 function defaultAbortableSleep(signal) {
-  return (ms) => new Promise((resolve60, reject) => {
+  return (ms) => new Promise((resolve61, reject) => {
     const onAbort = () => {
       clearTimeout(timer);
       reject(signalAbortError(signal));
     };
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve60();
+      resolve61();
     }, ms);
     signal?.addEventListener("abort", onAbort, { once: true });
   });
@@ -165419,7 +165737,7 @@ async function downloadToFile(url, destPath, options = {}) {
   return { path: destPath, bytes };
 }
 function waitForDrain(file, signal) {
-  return new Promise((resolve60, reject) => {
+  return new Promise((resolve61, reject) => {
     const cleanup = () => {
       file.off("drain", onDrain);
       file.off("error", onError);
@@ -165428,7 +165746,7 @@ function waitForDrain(file, signal) {
     };
     const onDrain = () => {
       cleanup();
-      resolve60();
+      resolve61();
     };
     const onError = (err) => {
       cleanup();
@@ -165450,10 +165768,10 @@ function waitForDrain(file, signal) {
   });
 }
 function closeFile(file) {
-  return new Promise((resolve60) => {
+  return new Promise((resolve61) => {
     const done = () => {
       file.off("error", done);
-      resolve60();
+      resolve61();
     };
     file.once("error", done);
     file.end(() => done());
@@ -165863,8 +166181,8 @@ async function startLoopback(opts) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   let resolveResult;
   let rejectResult;
-  const result = new Promise((resolve60, reject) => {
-    resolveResult = resolve60;
+  const result = new Promise((resolve61, reject) => {
+    resolveResult = resolve61;
     rejectResult = reject;
   });
   let redirectUri = "";
@@ -165880,7 +166198,7 @@ async function startLoopback(opts) {
     closed = true;
     clearTimeout(timer);
     server.closeAllConnections?.();
-    await new Promise((resolve60) => server.close(() => resolve60()));
+    await new Promise((resolve61) => server.close(() => resolve61()));
   };
   const timer = setTimeout(() => {
     rejectResult(new Error(`OAuth callback timed out after ${timeoutMs}ms`));
@@ -165891,11 +166209,11 @@ async function startLoopback(opts) {
   return { result, redirectUri, close };
 }
 async function listen(server, port) {
-  await new Promise((resolve60, reject) => {
+  await new Promise((resolve61, reject) => {
     server.once("error", reject);
     server.listen(port, "127.0.0.1", () => {
       server.off("error", reject);
-      resolve60();
+      resolve61();
     });
   });
 }
@@ -165985,11 +166303,11 @@ async function openBrowser2(url) {
     return { opened: false };
   }
   try {
-    const open2 = (await import("open")).default;
-    await open2(url);
+    const open3 = (await import("open")).default;
+    await open3(url);
     return { opened: true };
   } catch (err) {
-    printManualInstructions(url, err instanceof Error ? err.message : String(err));
+    printManualInstructions(url, normalizeErrorMessage(err));
     return { opened: false };
   }
 }
@@ -166006,6 +166324,7 @@ var init_browser2 = __esm({
   "src/auth/browser.ts"() {
     "use strict";
     init_colors();
+    init_errorMessage();
   }
 });
 
@@ -166932,7 +167251,7 @@ async function maybeUploadProject(client, source, asJson, idempotencyKey) {
   try {
     archive = createPublishArchive(project.dir);
   } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
+    const msg = normalizeErrorMessage(err);
     errorBox("Zip failed", msg, "Check the project for missing files or unreadable permissions.");
     process.exit(1);
   }
@@ -167068,7 +167387,7 @@ async function streamVideo(url, destPath, asJson) {
     }
     return { bytes: result.bytes };
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+    const message = normalizeErrorMessage(err);
     errorBox(
       "Download failed",
       message,
@@ -167086,6 +167405,7 @@ var init_render3 = __esm({
     init_colors();
     init_format();
     init_project();
+    init_errorMessage();
     init_publishProject();
     init_variables();
     init_updateCheck();
@@ -167878,7 +168198,7 @@ async function collectApiKey(inline) {
   return await promptForKey();
 }
 async function readAllWithTimeout(stream, timeoutMs) {
-  return await new Promise((resolve60, reject) => {
+  return await new Promise((resolve61, reject) => {
     const chunks = [];
     const timer = setTimeout(() => {
       reject(new Error(`Timed out waiting for stdin (${timeoutMs}ms). Pipe the key explicitly.`));
@@ -167888,7 +168208,7 @@ async function readAllWithTimeout(stream, timeoutMs) {
     });
     stream.on("end", () => {
       clearTimeout(timer);
-      resolve60(Buffer.concat(chunks).toString("utf8"));
+      resolve61(Buffer.concat(chunks).toString("utf8"));
     });
     stream.on("error", (err) => {
       clearTimeout(timer);
@@ -168258,8 +168578,8 @@ async function confirmInteractive(prompt) {
   if (!process.stdin.isTTY) return false;
   const { createInterface: createInterface3 } = await import("readline");
   const rl = createInterface3({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve60) => {
-    rl.question(prompt, (line) => resolve60(line));
+  const answer = await new Promise((resolve61) => {
+    rl.question(prompt, (line) => resolve61(line));
   });
   rl.close();
   return /^y(es)?$/i.test(answer.trim());
@@ -168849,6 +169169,10 @@ var init_help = __esm({
         title: "Project",
         commands: [
           ["lint", "Validate a composition for common mistakes"],
+          [
+            "validate",
+            "Runtime-validate a composition in headless Chrome (JS errors, missing assets, contrast)"
+          ],
           ["beats", "Detect beats in the music track and write beats/<audio>.json"],
           ["inspect", "Inspect rendered visual layout across the timeline"],
           ["snapshot", "Capture key frames as PNG screenshots for visual verification"],
@@ -168978,10 +169302,10 @@ if (rootVersionRequested) {
   process.exit(0);
 }
 try {
-  const { readFileSync: readFileSync67 } = await import("fs");
-  const { resolve: resolve60 } = await import("path");
-  const envPath = resolve60(process.cwd(), ".env");
-  const envContent = readFileSync67(envPath, "utf-8");
+  const { readFileSync: readFileSync66 } = await import("fs");
+  const { resolve: resolve61 } = await import("path");
+  const envPath = resolve61(process.cwd(), ".env");
+  const envContent = readFileSync66(envPath, "utf-8");
   for (const rawLine of envContent.split("\n")) {
     let line = rawLine.trim();
     if (!line || line.startsWith("#")) continue;