hyperframes 0.4.23 → 0.4.25

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.4.23" : "0.0.0-dev";
+    VERSION = true ? "0.4.25" : "0.0.0-dev";
   }
 });
 
@@ -9973,7 +9973,7 @@ import { get as httpsGet } from "https";
 import { pipeline } from "stream/promises";
 function downloadFile(url, dest) {
   const tmp = `${dest}.tmp`;
-  return new Promise((resolve38, reject) => {
+  return new Promise((resolve39, reject) => {
     const follow = (u) => {
       httpsGet(u, (res) => {
         if (res.statusCode === 301 || res.statusCode === 302) {
@@ -9990,7 +9990,7 @@ function downloadFile(url, dest) {
         const file = createWriteStream(tmp);
         pipeline(res, file).then(() => {
           renameSync(tmp, dest);
-          resolve38();
+          resolve39();
         }).catch((err) => {
           try {
             unlinkSync(tmp);
@@ -10708,7 +10708,7 @@ function hasNpx() {
   }
 }
 function runSkillsAdd(repo) {
-  return new Promise((resolve38, reject) => {
+  return new Promise((resolve39, reject) => {
     const child = spawn("npx", ["skills", "add", repo, "--all"], {
       stdio: "inherit",
       timeout: 12e4,
@@ -10722,7 +10722,7 @@ function runSkillsAdd(repo) {
       env: { ...process.env, GIT_CLONE_PROTECTION_ACTIVE: "0" }
     });
     child.on("close", (code, signal) => {
-      if (code === 0) resolve38();
+      if (code === 0) resolve39();
       else if (signal === "SIGINT" || code === 130) process.exit(0);
       else reject(new Error(`npx skills add exited with code ${code}`));
     });
@@ -10790,14 +10790,14 @@ function lintProject(project) {
   totalErrors += rootResult.errorCount;
   totalWarnings += rootResult.warningCount;
   totalInfos += rootResult.infoCount;
-  const allHtmlSources = [rootHtml];
+  const allHtmlSources = [{ html: rootHtml }];
   const compositionsDir = resolve5(project.dir, "compositions");
   if (existsSync7(compositionsDir)) {
     const files = readdirSync2(compositionsDir).filter((f3) => f3.endsWith(".html"));
     for (const file of files) {
       const filePath = join9(compositionsDir, file);
       const html = readFileSync7(filePath, "utf-8");
-      allHtmlSources.push(html);
+      allHtmlSources.push({ html, compSrcPath: `compositions/${file}` });
       const result = lintHyperframeHtml(html, { filePath, isSubComposition: true });
       results.push({ file: `compositions/${file}`, result });
       totalErrors += result.errorCount;
@@ -10840,7 +10840,7 @@ function lintProjectAudioFiles(projectDir, htmlSources) {
     return findings;
   }
   if (audioFiles.length === 0) return findings;
-  const hasAudioElement = htmlSources.some((html) => /<audio\b/i.test(html));
+  const hasAudioElement = htmlSources.some(({ html }) => /<audio\b/i.test(html));
   if (!hasAudioElement) {
     findings.push({
       code: "audio_file_without_element",
@@ -10855,13 +10855,14 @@ function lintAudioSrcNotFound(projectDir, htmlSources) {
   const findings = [];
   const audioSrcRe = /<audio\b[^>]*\bsrc\s*=\s*["']([^"']+)["'][^>]*>/gi;
   const missingSrcs = [];
-  for (const html of htmlSources) {
+  for (const { html, compSrcPath } of htmlSources) {
     let match;
     while ((match = audioSrcRe.exec(html)) !== null) {
       const src = match[1];
       if (/^(https?:|data:|blob:)/i.test(src)) continue;
       if (/^__[A-Z_]+__$/.test(src)) continue;
-      const resolved = resolve5(projectDir, src);
+      const rootRelative = compSrcPath ? rewriteAssetPath(compSrcPath, src) : src;
+      const resolved = resolve5(projectDir, rootRelative);
       if (!existsSync7(resolved)) {
         missingSrcs.push(src);
       }
@@ -10910,7 +10911,7 @@ function lintDuplicateAudioTracks(htmlSources) {
   }
   const tracks = [];
   const seen = /* @__PURE__ */ new Set();
-  for (const html of htmlSources) {
+  for (const { html } of htmlSources) {
     const audioTagRe = /<audio\b[^>]*>/gi;
     let match;
     while ((match = audioTagRe.exec(html)) !== null) {
@@ -10954,6 +10955,7 @@ var init_lintProject = __esm({
   "src/utils/lintProject.ts"() {
     "use strict";
     init_lint();
+    init_src();
     AUDIO_EXTENSIONS2 = /* @__PURE__ */ new Set([".mp3", ".wav", ".aac", ".ogg", ".m4a", ".flac", ".opus"]);
   }
 });
@@ -14856,10 +14858,10 @@ function compareDocumentPosition(nodeA, nodeB) {
 function uniqueSort(nodes) {
   nodes = nodes.filter((node, i2, arr) => !arr.includes(node, i2 + 1));
   nodes.sort((a, b) => {
-    const relative6 = compareDocumentPosition(a, b);
-    if (relative6 & DocumentPosition.PRECEDING) {
+    const relative7 = compareDocumentPosition(a, b);
+    if (relative7 & DocumentPosition.PRECEDING) {
       return -1;
-    } else if (relative6 & DocumentPosition.FOLLOWING) {
+    } else if (relative7 & DocumentPosition.FOLLOWING) {
       return 1;
     }
     return 0;
@@ -15321,8 +15323,8 @@ var init_custom_element_registry = __esm({
         } : (element) => element.localName === localName;
         registry.set(localName, { Class, check });
         if (waiting.has(localName)) {
-          for (const resolve38 of waiting.get(localName))
-            resolve38(Class);
+          for (const resolve39 of waiting.get(localName))
+            resolve39(Class);
           waiting.delete(localName);
         }
         ownerDocument.querySelectorAll(
@@ -15362,13 +15364,13 @@ var init_custom_element_registry = __esm({
        */
       whenDefined(localName) {
         const { registry, waiting } = this;
-        return new Promise((resolve38) => {
+        return new Promise((resolve39) => {
           if (registry.has(localName))
-            resolve38(registry.get(localName).Class);
+            resolve39(registry.get(localName).Class);
           else {
             if (!waiting.has(localName))
               waiting.set(localName, []);
-            waiting.get(localName).push(resolve38);
+            waiting.get(localName).push(resolve39);
           }
         });
       }
@@ -25731,7 +25733,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((resolve38) => setTimeout(resolve38, intervalMs));
+    await new Promise((resolve39) => setTimeout(resolve39, intervalMs));
   }
   return Boolean(await page.evaluate(expression));
 }
@@ -25753,8 +25755,12 @@ async function initializeSession(session) {
     }
   });
   page.on("pageerror", (err) => {
-    const text = `[Browser:PAGEERROR] ${err instanceof Error ? err.message : String(err)}`;
-    console.error(text);
+    const message = err instanceof Error ? err.message : String(err);
+    const text = `[Browser:PAGEERROR] ${message}`;
+    const isPlayAbort = /^AbortError:/.test(message) && message.includes("play()") && message.includes("pause()");
+    if (!isPlayAbort) {
+      console.error(text);
+    }
     session.browserConsoleBuffer.push(text);
     if (session.browserConsoleBuffer.length > BROWSER_CONSOLE_BUFFER_SIZE) {
       session.browserConsoleBuffer.shift();
@@ -26020,7 +26026,7 @@ var init_frameCapture = __esm({
 // ../engine/src/utils/gpuEncoder.ts
 import { spawn as spawn2 } from "child_process";
 async function detectGpuEncoder() {
-  return new Promise((resolve38) => {
+  return new Promise((resolve39) => {
     const ffmpeg = spawn2("ffmpeg", ["-encoders"], {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -26029,13 +26035,13 @@ async function detectGpuEncoder() {
       stdout2 += data.toString();
     });
     ffmpeg.on("close", () => {
-      if (stdout2.includes("h264_nvenc")) resolve38("nvenc");
-      else if (stdout2.includes("h264_videotoolbox")) resolve38("videotoolbox");
-      else if (stdout2.includes("h264_vaapi")) resolve38("vaapi");
-      else if (stdout2.includes("h264_qsv")) resolve38("qsv");
-      else resolve38(null);
+      if (stdout2.includes("h264_nvenc")) resolve39("nvenc");
+      else if (stdout2.includes("h264_videotoolbox")) resolve39("videotoolbox");
+      else if (stdout2.includes("h264_vaapi")) resolve39("vaapi");
+      else if (stdout2.includes("h264_qsv")) resolve39("qsv");
+      else resolve39(null);
     });
-    ffmpeg.on("error", () => resolve38(null));
+    ffmpeg.on("error", () => resolve39(null));
   });
 }
 async function getCachedGpuEncoder() {
@@ -26156,7 +26162,7 @@ async function runFfmpeg(args, opts) {
   const signal = opts?.signal;
   const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
   const onStderr = opts?.onStderr;
-  return new Promise((resolve38) => {
+  return new Promise((resolve39) => {
     const ffmpeg = spawn3("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -26182,7 +26188,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("close", (code) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve38({
+      resolve39({
         success: !signal?.aborted && code === 0,
         exitCode: code,
         stderr,
@@ -26192,7 +26198,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve38({
+      resolve39({
         success: false,
         exitCode: null,
         stderr: err.message,
@@ -26384,7 +26390,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
   const inputPath = join20(framesDir, framePattern);
   const inputArgs = ["-framerate", String(options.fps), "-i", inputPath];
   const args = buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder);
-  return new Promise((resolve38) => {
+  return new Promise((resolve39) => {
     const ffmpeg = spawn4("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -26409,7 +26415,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
       if (signal) signal.removeEventListener("abort", onAbort);
       const durationMs = Date.now() - startTime;
       if (signal?.aborted) {
-        resolve38({
+        resolve39({
           success: false,
           outputPath,
           durationMs,
@@ -26420,7 +26426,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       if (code !== 0) {
-        resolve38({
+        resolve39({
           success: false,
           outputPath,
           durationMs,
@@ -26431,12 +26437,12 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       const fileSize = existsSync17(outputPath) ? statSync4(outputPath).size : 0;
-      resolve38({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
+      resolve39({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
     });
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve38({
+      resolve39({
         success: false,
         outputPath,
         durationMs: Date.now() - startTime,
@@ -26494,18 +26500,18 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     let gpuEncoder = null;
     if (options.useGpu) gpuEncoder = await getCachedGpuEncoder();
     const args = buildEncoderArgs(options, inputArgs, chunkPath, gpuEncoder);
-    const chunkResult = await new Promise((resolve38) => {
+    const chunkResult = await new Promise((resolve39) => {
       const ffmpeg = spawn4("ffmpeg", args);
       let stderr = "";
       ffmpeg.stderr.on("data", (d) => {
         stderr += d.toString();
       });
       ffmpeg.on("close", (code) => {
-        if (code === 0) resolve38({ success: true });
-        else resolve38({ success: false, error: `Chunk ${i2} encode failed: ${stderr.slice(-400)}` });
+        if (code === 0) resolve39({ success: true });
+        else resolve39({ success: false, error: `Chunk ${i2} encode failed: ${stderr.slice(-400)}` });
       });
       ffmpeg.on("error", (err) => {
-        resolve38({ success: false, error: `Chunk ${i2} encode error: ${err.message}` });
+        resolve39({ success: false, error: `Chunk ${i2} encode error: ${err.message}` });
       });
     });
     if (!chunkResult.success) {
@@ -26535,18 +26541,18 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     "-y",
     outputPath
   ];
-  const concatResult = await new Promise((resolve38) => {
+  const concatResult = await new Promise((resolve39) => {
     const ffmpeg = spawn4("ffmpeg", concatArgs);
     let stderr = "";
     ffmpeg.stderr.on("data", (d) => {
       stderr += d.toString();
     });
     ffmpeg.on("close", (code) => {
-      if (code === 0) resolve38({ success: true });
-      else resolve38({ success: false, error: `Chunk concat failed: ${stderr.slice(-400)}` });
+      if (code === 0) resolve39({ success: true });
+      else resolve39({ success: false, error: `Chunk concat failed: ${stderr.slice(-400)}` });
     });
     ffmpeg.on("error", (err) => {
-      resolve38({ success: false, error: `Chunk concat error: ${err.message}` });
+      resolve39({ success: false, error: `Chunk concat error: ${err.message}` });
     });
   });
   if (!concatResult.success) {
@@ -26646,37 +26652,37 @@ import { dirname as dirname7 } from "path";
 function createFrameReorderBuffer(startFrame, endFrame) {
   let cursor = startFrame;
   const pending = /* @__PURE__ */ new Map();
-  const enqueueAt = (frame, resolve38) => {
+  const enqueueAt = (frame, resolve39) => {
     const list = pending.get(frame);
     if (list === void 0) {
-      pending.set(frame, [resolve38]);
+      pending.set(frame, [resolve39]);
     } else {
-      list.push(resolve38);
+      list.push(resolve39);
     }
   };
   const flushAt = (frame) => {
     const list = pending.get(frame);
     if (list === void 0) return;
     pending.delete(frame);
-    for (const resolve38 of list) resolve38();
+    for (const resolve39 of list) resolve39();
   };
-  const waitForFrame = (frame) => new Promise((resolve38) => {
+  const waitForFrame = (frame) => new Promise((resolve39) => {
     if (frame === cursor) {
-      resolve38();
+      resolve39();
       return;
     }
-    enqueueAt(frame, resolve38);
+    enqueueAt(frame, resolve39);
   });
   const advanceTo = (frame) => {
     cursor = frame;
     flushAt(frame);
   };
-  const waitForAllDone = () => new Promise((resolve38) => {
+  const waitForAllDone = () => new Promise((resolve39) => {
     if (cursor >= endFrame) {
-      resolve38();
+      resolve39();
       return;
     }
-    enqueueAt(endFrame, resolve38);
+    enqueueAt(endFrame, resolve39);
   });
   return { waitForFrame, advanceTo, waitForAllDone };
 }
@@ -26838,7 +26844,7 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   let stderr = "";
   let exitCode = null;
   let exitPromiseResolve = null;
-  const exitPromise = new Promise((resolve38) => exitPromiseResolve = resolve38);
+  const exitPromise = new Promise((resolve39) => exitPromiseResolve = resolve39);
   ffmpeg.stderr?.on("data", (data) => {
     stderr += data.toString();
   });
@@ -26884,8 +26890,8 @@ Process error: ${err.message}`;
       if (signal) signal.removeEventListener("abort", onAbort);
       const stdin = ffmpeg.stdin;
       if (stdin && !stdin.destroyed) {
-        await new Promise((resolve38) => {
-          stdin.end(() => resolve38());
+        await new Promise((resolve39) => {
+          stdin.end(() => resolve39());
         });
       }
       await exitPromise;
@@ -26928,7 +26934,7 @@ import { spawn as spawn6 } from "child_process";
 import { readFileSync as readFileSync15 } from "fs";
 import { extname as extname4 } from "path";
 function runFfprobe(args) {
-  return new Promise((resolve38, reject) => {
+  return new Promise((resolve39, reject) => {
     const proc = spawn6("ffprobe", args);
     let stdout2 = "";
     let stderr = "";
@@ -26942,7 +26948,7 @@ function runFfprobe(args) {
       if (code !== 0) {
         reject(new Error(`[FFmpeg] ffprobe exited with code ${code}: ${stderr}`));
       } else {
-        resolve38(stdout2);
+        resolve39(stdout2);
       }
     });
     proc.on("error", (err) => {
@@ -27484,7 +27490,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((resolve38, reject) => {
+  return new Promise((resolve39, reject) => {
     const ffmpeg = spawn7("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -27519,7 +27525,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
       files.forEach((file, index) => {
         framePaths.set(index, join23(videoOutputDir, file));
       });
-      resolve38({
+      resolve39({
         videoId,
         srcPath: videoPath,
         outputDir: videoOutputDir,
@@ -28926,11 +28932,11 @@ function createFileServer(options) {
       headers: { "Content-Type": contentType }
     });
   });
-  return new Promise((resolve38) => {
+  return new Promise((resolve39) => {
     const server = serve({ fetch: app.fetch, port }, (info) => {
       const actualPort = info.port;
       const url = `http://localhost:${actualPort}`;
-      resolve38({
+      resolve39({
         url,
         port: actualPort,
         close: () => server.close()
@@ -31330,13 +31336,13 @@ function createFileServer2(options) {
     let filePath = null;
     if (compiledDir) {
       const candidate = join29(compiledDir, relativePath);
-      if (existsSync28(candidate) && isPathInside(candidate, compiledDir, { resolveSymlinks: true }) && statSync8(candidate).isFile()) {
+      if (existsSync28(candidate) && isPathInside(candidate, compiledDir) && statSync8(candidate).isFile()) {
         filePath = candidate;
       }
     }
     if (!filePath) {
       const candidate = join29(projectDir, relativePath);
-      if (existsSync28(candidate) && isPathInside(candidate, projectDir, { resolveSymlinks: true }) && statSync8(candidate).isFile()) {
+      if (existsSync28(candidate) && isPathInside(candidate, projectDir) && statSync8(candidate).isFile()) {
         filePath = candidate;
       }
     }
@@ -31364,10 +31370,10 @@ function createFileServer2(options) {
       headers: { "Content-Type": contentType }
     });
   });
-  return new Promise((resolve38) => {
+  return new Promise((resolve39) => {
     const connections = /* @__PURE__ */ new Set();
     const server = serve2({ fetch: app.fetch, port }, (info) => {
-      resolve38({
+      resolve39({
         url: `http://localhost:${info.port}`,
         port: info.port,
         close: () => {
@@ -35058,10 +35064,10 @@ var init_semaphore = __esm({
           this.active++;
           return () => this.release();
         }
-        return new Promise((resolve38) => {
+        return new Promise((resolve39) => {
           this.queue.push(() => {
             this.active++;
-            resolve38(() => this.release());
+            resolve39(() => this.release());
           });
         });
       }
@@ -36044,8 +36050,8 @@ async function runDevMode(dir, projectName) {
       }
     });
   }
-  return new Promise((resolve38) => {
-    child.on("close", () => resolve38());
+  return new Promise((resolve39) => {
+    child.on("close", () => resolve39());
   });
 }
 function hasLocalStudio(dir) {
@@ -36115,8 +36121,8 @@ async function runLocalStudioMode(dir, projectName) {
       }
     });
   }
-  return new Promise((resolve38) => {
-    child.on("close", () => resolve38());
+  return new Promise((resolve39) => {
+    child.on("close", () => resolve39());
   });
 }
 async function runEmbeddedMode(dir, startPort, projectName, forceNew = false) {
@@ -36183,7 +36189,29 @@ async function runEmbeddedMode(dir, startPort, projectName, forceNew = false) {
   console.log();
   import("open").then((mod) => mod.default(`${url}#project/${pName}`)).catch(() => {
   });
-  return new Promise(() => {
+  let rl;
+  if (process.platform === "win32") {
+    const readline = await import("readline");
+    rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.on("SIGINT", () => {
+      process.emit("SIGINT", "SIGINT");
+    });
+  }
+  return new Promise((resolveRun) => {
+    let shuttingDown = false;
+    const shutdown = () => {
+      if (shuttingDown) return;
+      shuttingDown = true;
+      process.off("SIGINT", shutdown);
+      process.off("SIGTERM", shutdown);
+      rl?.close();
+      console.log();
+      console.log(`  ${c.dim("Shutting down studio...")}`);
+      result.server.close(() => resolveRun());
+      setTimeout(() => process.exit(0), 2e3).unref();
+    };
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
   });
 }
 var examples, preview_default;
@@ -38551,6 +38579,558 @@ var init_lint3 = __esm({
   }
 });
 
+// src/utils/layoutAudit.ts
+function buildLayoutSampleTimes({ duration, samples, at: at2 }) {
+  if (at2?.length) {
+    return uniqueSortedTimes(
+      at2.filter(
+        (time) => Number.isFinite(time) && time >= 0 && (duration <= 0 || time <= duration)
+      )
+    );
+  }
+  if (!Number.isFinite(duration) || duration <= 0 || samples <= 0) return [];
+  const count = Math.max(1, Math.floor(samples));
+  return Array.from({ length: count }, (_2, index) => roundTime((index + 0.5) / count * duration));
+}
+function summarizeLayoutIssues(issues) {
+  const errorCount = issues.filter((issue) => issue.severity === "error").length;
+  const warningCount = issues.filter((issue) => issue.severity === "warning").length;
+  const infoCount = issues.filter((issue) => issue.severity === "info").length;
+  return {
+    ok: errorCount === 0,
+    errorCount,
+    warningCount,
+    infoCount,
+    issueCount: issues.length
+  };
+}
+function formatLayoutIssue(issue) {
+  const timeLabel = issue.occurrences && issue.occurrences > 1 ? `t=${formatNumber(issue.firstSeen ?? issue.time)}-${formatNumber(issue.lastSeen ?? issue.time)}s (${issue.occurrences} samples)` : `t=${formatNumber(issue.time)}s`;
+  const parts = [
+    timeLabel,
+    issue.code,
+    issue.selector,
+    issue.containerSelector ? `inside ${issue.containerSelector}` : "",
+    issue.overflow ? `overflowed ${formatOverflow(issue.overflow)}` : "",
+    issue.text ? quoteText(issue.text) : ""
+  ].filter(Boolean);
+  const line = `${parts.join(" ")} \u2014 ${issue.message}`;
+  return issue.fixHint ? `${line}
+    Fix: ${issue.fixHint}` : line;
+}
+function dedupeLayoutIssues(issues) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const issue of issues) {
+    const key2 = [
+      issue.code,
+      issue.severity,
+      issue.time.toFixed(3),
+      issue.selector,
+      issue.containerSelector ?? "",
+      issue.text ?? "",
+      issue.overflow ? formatOverflow(issue.overflow) : ""
+    ].join("|");
+    if (seen.has(key2)) continue;
+    seen.add(key2);
+    result.push(issue);
+  }
+  return result;
+}
+function collapseStaticLayoutIssues(issues) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const issue of issues) {
+    const key2 = staticIssueKey(issue);
+    const existing = groups.get(key2);
+    if (!existing) {
+      groups.set(key2, {
+        issue,
+        firstSeen: issue.time,
+        lastSeen: issue.time,
+        occurrences: 1
+      });
+      continue;
+    }
+    existing.firstSeen = Math.min(existing.firstSeen, issue.time);
+    existing.lastSeen = Math.max(existing.lastSeen, issue.time);
+    existing.occurrences += 1;
+  }
+  return [...groups.values()].map(({ issue, firstSeen, lastSeen, occurrences }) => ({
+    ...issue,
+    time: firstSeen,
+    firstSeen,
+    lastSeen,
+    occurrences
+  }));
+}
+function limitLayoutIssues(issues, maxIssues) {
+  const limit = Math.max(1, Math.floor(maxIssues));
+  const sortedIssues = [...issues].sort((a, b) => {
+    const severityDelta = severityRank(a.severity) - severityRank(b.severity);
+    if (severityDelta !== 0) return severityDelta;
+    return a.time - b.time;
+  });
+  return {
+    issues: sortedIssues.slice(0, limit),
+    totalIssueCount: issues.length,
+    truncated: issues.length > limit
+  };
+}
+function severityRank(severity) {
+  if (severity === "error") return 0;
+  if (severity === "warning") return 1;
+  return 2;
+}
+function staticIssueKey(issue) {
+  return [
+    issue.code,
+    issue.severity,
+    issue.selector,
+    issue.containerSelector ?? "",
+    issue.text ?? "",
+    issue.overflow ? formatOverflow(issue.overflow) : ""
+  ].join("|");
+}
+function uniqueSortedTimes(times) {
+  const rounded = times.map(roundTime);
+  return [...new Set(rounded)].sort((a, b) => a - b);
+}
+function formatOverflow(overflow) {
+  return ["left", "right", "top", "bottom"].flatMap((side) => {
+    const value = overflow[side];
+    return value == null ? [] : `${side} ${formatNumber(value)}px`;
+  }).join(", ");
+}
+function quoteText(text) {
+  const normalized = text.replace(/\s+/g, " ").trim();
+  const truncated = normalized.length > 80 ? `${normalized.slice(0, 77)}...` : normalized;
+  return `"${truncated}"`;
+}
+function formatNumber(value) {
+  return Number.isInteger(value) ? String(value) : value.toFixed(2).replace(/0+$/, "").replace(/\.$/, "");
+}
+function roundTime(value) {
+  return Math.round(value * 1e3) / 1e3;
+}
+var init_layoutAudit = __esm({
+  "src/utils/layoutAudit.ts"() {
+    "use strict";
+  }
+});
+
+// src/commands/layout.ts
+var layout_exports = {};
+__export(layout_exports, {
+  createInspectCommand: () => createInspectCommand,
+  default: () => layout_default,
+  examples: () => examples9
+});
+import { createServer } from "http";
+import { existsSync as existsSync41, readFileSync as readFileSync29 } from "fs";
+import { dirname as dirname17, isAbsolute as isAbsolute6, join as join42, relative as relative5, resolve as resolve29 } from "path";
+import { fileURLToPath as fileURLToPath6 } from "url";
+async function getCompositionDuration2(page) {
+  return page.evaluate(() => {
+    const win = window;
+    if (typeof win.__hf?.duration === "number" && win.__hf.duration > 0) return win.__hf.duration;
+    const playerDuration = win.__player?.duration;
+    if (typeof playerDuration === "function") return playerDuration();
+    if (typeof playerDuration === "number" && playerDuration > 0) return playerDuration;
+    const root = document.querySelector("[data-composition-id][data-duration]");
+    const attrDuration = root ? parseFloat(root.getAttribute("data-duration") ?? "0") : 0;
+    if (attrDuration > 0) return attrDuration;
+    const timelines = win.__timelines;
+    if (timelines) {
+      for (const timeline of Object.values(timelines)) {
+        const duration = timeline.duration;
+        if (typeof duration === "function") return duration();
+        if (typeof duration === "number" && duration > 0) return duration;
+      }
+    }
+    return 0;
+  });
+}
+async function seekTo(page, time) {
+  await page.evaluate((t3) => {
+    const win = window;
+    if (typeof win.__hf?.seek === "function") {
+      win.__hf.seek(t3);
+      return;
+    }
+    if (typeof win.__player?.seek === "function") {
+      win.__player.seek(t3);
+      return;
+    }
+    const timelines = win.__timelines;
+    if (timelines) {
+      for (const timeline of Object.values(timelines)) {
+        if (typeof timeline.pause === "function") timeline.pause();
+        if (typeof timeline.seek === "function") timeline.seek(t3);
+      }
+    }
+  }, time);
+  await page.evaluate(
+    () => new Promise(
+      (resolveFrame) => requestAnimationFrame(() => requestAnimationFrame(() => resolveFrame()))
+    )
+  );
+  await page.evaluate(() => {
+    const fonts = document.fonts;
+    if (!fonts?.ready) return Promise.resolve();
+    return Promise.race([
+      fonts.ready.then(() => void 0),
+      new Promise((resolve39) => setTimeout(resolve39, 500))
+    ]);
+  }).catch(() => {
+  });
+  await new Promise((resolveSettle) => setTimeout(resolveSettle, SEEK_SETTLE_MS));
+}
+async function bundleProjectHtml(projectDir) {
+  const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
+  let html = await bundleToSingleHtml2(projectDir);
+  const runtimePath = resolve29(
+    __dirname2,
+    "..",
+    "..",
+    "..",
+    "core",
+    "dist",
+    "hyperframe.runtime.iife.js"
+  );
+  if (existsSync41(runtimePath)) {
+    const runtimeSource = readFileSync29(runtimePath, "utf-8");
+    html = html.replace(
+      /<script[^>]*data-hyperframes-preview-runtime[^>]*src="[^"]*"[^>]*><\/script>/,
+      () => `<script data-hyperframes-preview-runtime="1">${runtimeSource}</script>`
+    );
+  }
+  return html;
+}
+async function serveProject(projectDir, html) {
+  const { getMimeType: getMimeType2 } = await Promise.resolve().then(() => (init_studio_api(), studio_api_exports));
+  const server = createServer((req, res) => {
+    const url = req.url ?? "/";
+    if (url === "/" || url === "/index.html") {
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end(html);
+      return;
+    }
+    const filePath = resolve29(projectDir, decodeURIComponent(url).replace(/^\//, ""));
+    const rel = relative5(projectDir, filePath);
+    if (rel.startsWith("..") || isAbsolute6(rel)) {
+      res.writeHead(403);
+      res.end();
+      return;
+    }
+    if (existsSync41(filePath)) {
+      res.writeHead(200, { "Content-Type": getMimeType2(filePath) });
+      res.end(readFileSync29(filePath));
+      return;
+    }
+    res.writeHead(404);
+    res.end();
+  });
+  const port = await new Promise((resolvePort, rejectPort) => {
+    server.on("error", rejectPort);
+    server.listen(0, () => {
+      const addr = server.address();
+      const resolvedPort = typeof addr === "object" && addr ? addr.port : 0;
+      if (!resolvedPort) rejectPort(new Error("Failed to bind local layout audit server"));
+      else resolvePort(resolvedPort);
+    });
+  });
+  return {
+    url: `http://127.0.0.1:${port}/`,
+    close: () => new Promise((resolveClose) => {
+      server.close(() => resolveClose());
+    })
+  };
+}
+async function alignViewportToComposition(page, url) {
+  const size = await page.evaluate(() => {
+    const root = document.querySelector("[data-composition-id][data-width][data-height]");
+    const width = root ? parseInt(root.getAttribute("data-width") ?? "", 10) : 0;
+    const height = root ? parseInt(root.getAttribute("data-height") ?? "", 10) : 0;
+    return {
+      width: Number.isFinite(width) && width > 0 ? Math.min(width, 4096) : 1920,
+      height: Number.isFinite(height) && height > 0 ? Math.min(height, 4096) : 1080
+    };
+  });
+  await page.setViewport(size);
+  await page.goto(url, { waitUntil: "domcontentloaded", timeout: 1e4 });
+}
+async function runLayoutAudit(projectDir, opts) {
+  const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
+  const puppeteer = await import("puppeteer-core");
+  const html = await bundleProjectHtml(projectDir);
+  const server = await serveProject(projectDir, html);
+  let chromeBrowser;
+  try {
+    const browser = await ensureBrowser2();
+    chromeBrowser = await puppeteer.default.launch({
+      headless: true,
+      executablePath: browser.executablePath,
+      args: [
+        "--no-sandbox",
+        "--disable-gpu",
+        "--disable-dev-shm-usage",
+        "--enable-webgl",
+        "--use-gl=angle",
+        "--use-angle=swiftshader"
+      ]
+    });
+    const page = await chromeBrowser.newPage();
+    await page.setViewport({ width: 1920, height: 1080 });
+    await page.goto(server.url, { waitUntil: "domcontentloaded", timeout: 1e4 });
+    await alignViewportToComposition(page, server.url);
+    await page.waitForFunction(() => !!window.__timelines, {
+      timeout: opts.timeout
+    }).catch(() => {
+    });
+    await page.evaluate(() => {
+      const fonts = document.fonts;
+      if (!fonts?.ready) return Promise.resolve();
+      return Promise.race([
+        fonts.ready.then(() => void 0),
+        new Promise((resolve39) => setTimeout(resolve39, 750))
+      ]);
+    }).catch(() => {
+    });
+    await new Promise((resolveSettle) => setTimeout(resolveSettle, 250));
+    const duration = await getCompositionDuration2(page);
+    const samples = buildLayoutSampleTimes({ duration, samples: opts.samples, at: opts.at });
+    if (samples.length === 0) return { duration, samples, rawIssues: [] };
+    await page.addScriptTag({ content: loadLayoutAuditScript() });
+    const issues = [];
+    for (const time of samples) {
+      await seekTo(page, time);
+      const sampleIssues = await page.evaluate(
+        (auditOptions) => {
+          const win = window;
+          return win.__hyperframesLayoutAudit?.(auditOptions) ?? [];
+        },
+        { time, tolerance: opts.tolerance }
+      );
+      issues.push(...sampleIssues);
+    }
+    return {
+      duration,
+      samples,
+      rawIssues: dedupeLayoutIssues(issues)
+    };
+  } finally {
+    await chromeBrowser?.close().catch(() => {
+    });
+    await server.close();
+  }
+}
+function loadLayoutAuditScript() {
+  const candidates = [
+    join42(__dirname2, "layout-audit.browser.js"),
+    join42(__dirname2, "commands", "layout-audit.browser.js")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync41(candidate)) return readFileSync29(candidate, "utf-8");
+  }
+  throw new Error("Missing layout audit browser script");
+}
+function parseAt(value) {
+  if (!value) return void 0;
+  const times = String(value).split(",").map((entry) => parseFloat(entry.trim())).filter((time) => Number.isFinite(time) && time >= 0);
+  return times.length > 0 ? times : void 0;
+}
+function createInspectCommand(commandName) {
+  return defineCommand({
+    meta: {
+      name: commandName,
+      description: "Inspect rendered composition layout for text and container overflow"
+    },
+    args: {
+      dir: { type: "positional", description: "Project directory", required: false },
+      json: { type: "boolean", description: "Output agent-readable JSON", default: false },
+      samples: {
+        type: "string",
+        description: "Number of midpoint samples across the duration (default: 9)",
+        default: "9"
+      },
+      at: {
+        type: "string",
+        description: "Comma-separated timestamps in seconds (e.g., --at 1.5,4,7.25)"
+      },
+      tolerance: {
+        type: "string",
+        description: "Allowed pixel overflow before reporting an issue (default: 2)",
+        default: "2"
+      },
+      timeout: {
+        type: "string",
+        description: "Ms to wait for runtime to initialize (default: 5000)",
+        default: "5000"
+      },
+      "max-issues": {
+        type: "string",
+        description: "Maximum issues to print or return after static collapse (default: 80)",
+        default: "80"
+      },
+      "collapse-static": {
+        type: "boolean",
+        description: "Collapse repeated static issues across samples (default: true)",
+        default: true
+      },
+      strict: {
+        type: "boolean",
+        description: "Exit non-zero on warnings too",
+        default: false
+      }
+    },
+    async run({ args }) {
+      const project = resolveProject(args.dir);
+      const samples = Math.max(1, parseInt(args.samples, 10) || 9);
+      const tolerance = Math.max(0, parseFloat(args.tolerance) || 2);
+      const timeout = Math.max(500, parseInt(args.timeout, 10) || 5e3);
+      const maxIssues = Math.max(1, parseInt(args["max-issues"], 10) || 80);
+      const at2 = parseAt(args.at);
+      const strict = !!args.strict;
+      const collapseStatic = args["collapse-static"] !== false;
+      if (!args.json) {
+        const sampleLabel = at2 ? `${at2.length} explicit timestamp(s)` : `${samples} timeline samples`;
+        console.log(
+          `${c.accent("\u25C6")}  Inspecting layout for ${c.accent(project.name)} (${sampleLabel})`
+        );
+      }
+      try {
+        const result = await runLayoutAudit(project.dir, {
+          samples,
+          at: at2,
+          timeout,
+          tolerance
+        });
+        const allIssues = collapseStatic ? collapseStaticLayoutIssues(result.rawIssues) : result.rawIssues;
+        const limited = limitLayoutIssues(allIssues, maxIssues);
+        const summary = summarizeLayoutIssues(allIssues);
+        const ok = summary.errorCount === 0 && (!strict || summary.warningCount === 0);
+        if (args.json) {
+          console.log(
+            JSON.stringify(
+              withMeta({
+                schemaVersion: INSPECT_SCHEMA_VERSION,
+                duration: result.duration,
+                samples: result.samples,
+                tolerance,
+                strict,
+                collapseStatic,
+                ...summary,
+                totalIssueCount: limited.totalIssueCount,
+                truncated: limited.truncated,
+                ok,
+                issues: limited.issues
+              }),
+              null,
+              2
+            )
+          );
+          process.exit(ok ? 0 : 1);
+        }
+        if (result.samples.length === 0) {
+          console.log();
+          console.log(
+            `${c.error("\u2717")} Could not determine composition duration \u2014 no layout samples run`
+          );
+          process.exit(1);
+        }
+        console.log();
+        if (limited.issues.length === 0) {
+          console.log(
+            `${c.success("\u25C7")}  0 layout issues across ${result.samples.length} sample(s)`
+          );
+          return;
+        }
+        for (const issue of limited.issues) {
+          const icon = issue.severity === "error" ? c.error("\u2717") : issue.severity === "warning" ? c.warn("\u26A0") : c.dim("\u2139");
+          const formatted = formatLayoutIssue(issue).replace(/\n/g, "\n    ");
+          console.log(`  ${icon} ${c.dim(formatted)}`);
+        }
+        console.log();
+        const parts = [
+          `${summary.errorCount} error(s)`,
+          `${summary.warningCount} warning(s)`,
+          `${summary.infoCount} info(s)`
+        ];
+        const suffix = limited.truncated ? c.dim(`, truncated at ${maxIssues} issue(s)`) : "";
+        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);
+        if (args.json) {
+          console.log(
+            JSON.stringify(
+              withMeta({
+                schemaVersion: INSPECT_SCHEMA_VERSION,
+                ok: false,
+                error: message,
+                issues: [],
+                errorCount: 0,
+                warningCount: 0,
+                infoCount: 0,
+                issueCount: 0
+              }),
+              null,
+              2
+            )
+          );
+          process.exit(1);
+        }
+        console.error(`${c.error("\u2717")} Inspect failed: ${message}`);
+        process.exit(1);
+      }
+    }
+  });
+}
+var __filename, __dirname2, SEEK_SETTLE_MS, INSPECT_SCHEMA_VERSION, examples9, layout_default;
+var init_layout2 = __esm({
+  "src/commands/layout.ts"() {
+    "use strict";
+    init_dist();
+    init_colors();
+    init_project();
+    init_updateCheck();
+    init_layoutAudit();
+    __filename = fileURLToPath6(import.meta.url);
+    __dirname2 = dirname17(__filename);
+    SEEK_SETTLE_MS = 120;
+    INSPECT_SCHEMA_VERSION = 1;
+    examples9 = [
+      ["Inspect visual layout across the current composition", "hyperframes layout"],
+      ["Inspect a specific project", "hyperframes layout ./my-video"],
+      ["Output agent-readable JSON", "hyperframes layout --json"],
+      ["Use explicit hero-frame timestamps", "hyperframes layout --at 1.5,4.0,7.25"]
+    ];
+    layout_default = createInspectCommand("layout");
+  }
+});
+
+// src/commands/inspect.ts
+var inspect_exports = {};
+__export(inspect_exports, {
+  default: () => inspect_default,
+  examples: () => examples10
+});
+var examples10, inspect_default;
+var init_inspect = __esm({
+  "src/commands/inspect.ts"() {
+    "use strict";
+    init_layout2();
+    examples10 = [
+      ["Inspect visual layout across the current composition", "hyperframes inspect"],
+      ["Inspect a specific project", "hyperframes inspect ./my-video"],
+      ["Output agent-readable JSON", "hyperframes inspect --json"],
+      ["Use explicit hero-frame timestamps", "hyperframes inspect --at 1.5,4.0,7.25"],
+      ["Run the compatibility alias", "hyperframes layout --json"]
+    ];
+    inspect_default = createInspectCommand("inspect");
+  }
+});
+
 // src/utils/dom.ts
 function ensureDOMParser() {
   if (typeof globalThis.DOMParser === "undefined") {
@@ -38568,14 +39148,14 @@ var init_dom = __esm({
 var info_exports = {};
 __export(info_exports, {
   default: () => info_default,
-  examples: () => examples9
+  examples: () => examples11
 });
-import { readFileSync as readFileSync29, readdirSync as readdirSync16, statSync as statSync16 } from "fs";
-import { join as join42 } from "path";
+import { readFileSync as readFileSync30, readdirSync as readdirSync16, statSync as statSync16 } from "fs";
+import { join as join43 } from "path";
 function totalSize(dir) {
   let total = 0;
   for (const entry of readdirSync16(dir, { withFileTypes: true })) {
-    const path2 = join42(dir, entry.name);
+    const path2 = join43(dir, entry.name);
     if (entry.isDirectory()) {
       total += totalSize(path2);
     } else {
@@ -38584,7 +39164,7 @@ function totalSize(dir) {
   }
   return total;
 }
-var examples9, info_default;
+var examples11, info_default;
 var init_info = __esm({
   "src/commands/info.ts"() {
     "use strict";
@@ -38595,7 +39175,7 @@ var init_info = __esm({
     init_dom();
     init_project();
     init_updateCheck();
-    examples9 = [
+    examples11 = [
       ["Show project metadata", "hyperframes info"],
       ["Output as JSON", "hyperframes info --json"]
     ];
@@ -38607,7 +39187,7 @@ var init_info = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync29(project.indexPath, "utf-8");
+        const html = readFileSync30(project.indexPath, "utf-8");
         ensureDOMParser();
         const parsed = parseHtml(html);
         const tracks = new Set(parsed.elements.map((el) => el.zIndex));
@@ -38661,10 +39241,10 @@ var init_info = __esm({
 var compositions_exports = {};
 __export(compositions_exports, {
   default: () => compositions_default,
-  examples: () => examples10
+  examples: () => examples12
 });
-import { existsSync as existsSync41, readFileSync as readFileSync30 } from "fs";
-import { resolve as resolve29, dirname as dirname17 } from "path";
+import { existsSync as existsSync42, readFileSync as readFileSync31 } from "fs";
+import { resolve as resolve30, dirname as dirname18 } from "path";
 function parseCompositions(html, baseDir) {
   const parser = new DOMParser();
   const doc = parser.parseFromString(html, "text/html");
@@ -38676,9 +39256,9 @@ function parseCompositions(html, baseDir) {
     const height = parseInt(div.getAttribute("data-height") ?? "1080", 10);
     const compositionSrc = div.getAttribute("data-composition-src");
     if (compositionSrc) {
-      const subPath = resolve29(baseDir, compositionSrc);
-      if (existsSync41(subPath)) {
-        const subHtml = readFileSync30(subPath, "utf-8");
+      const subPath = resolve30(baseDir, compositionSrc);
+      if (existsSync42(subPath)) {
+        const subHtml = readFileSync31(subPath, "utf-8");
         const subInfo = parseSubComposition(subHtml, id, width, height);
         compositions.push({ ...subInfo, source: compositionSrc });
         return;
@@ -38751,7 +39331,7 @@ function parseSubComposition(html, fallbackId, fallbackWidth, fallbackHeight) {
   }
   return { id, duration, width, height, elementCount };
 }
-var examples10, compositions_default;
+var examples12, compositions_default;
 var init_compositions = __esm({
   "src/commands/compositions.ts"() {
     "use strict";
@@ -38760,7 +39340,7 @@ var init_compositions = __esm({
     init_dom();
     init_project();
     init_updateCheck();
-    examples10 = [
+    examples12 = [
       ["List compositions in the current project", "hyperframes compositions"],
       ["Output as JSON", "hyperframes compositions --json"]
     ];
@@ -38772,9 +39352,9 @@ var init_compositions = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync30(project.indexPath, "utf-8");
+        const html = readFileSync31(project.indexPath, "utf-8");
         ensureDOMParser();
-        const compositions = parseCompositions(html, dirname17(project.indexPath));
+        const compositions = parseCompositions(html, dirname18(project.indexPath));
         if (compositions.length === 0) {
           console.log(`${c.success("\u25C7")}  ${c.accent(project.name)} \u2014 no compositions found`);
           return;
@@ -38808,11 +39388,11 @@ var init_compositions = __esm({
 var benchmark_exports = {};
 __export(benchmark_exports, {
   default: () => benchmark_default,
-  examples: () => examples11
+  examples: () => examples13
 });
-import { existsSync as existsSync42, statSync as statSync17 } from "fs";
-import { resolve as resolve30, join as join43 } from "path";
-var examples11, DEFAULT_CONFIGS, benchmark_default;
+import { existsSync as existsSync43, statSync as statSync17 } from "fs";
+import { resolve as resolve31, join as join44 } from "path";
+var examples13, DEFAULT_CONFIGS, benchmark_default;
 var init_benchmark = __esm({
   "src/commands/benchmark.ts"() {
     "use strict";
@@ -38823,7 +39403,7 @@ var init_benchmark = __esm({
     init_format();
     init_dist3();
     init_updateCheck();
-    examples11 = [
+    examples13 = [
       ["Run benchmarks with default settings (3 runs)", "hyperframes benchmark"],
       ["Run 5 iterations per config", "hyperframes benchmark --runs 5"],
       ["Output results as JSON", "hyperframes benchmark --json"]
@@ -38853,7 +39433,7 @@ var init_benchmark = __esm({
           process.exit(1);
         }
         const jsonOutput = args.json ?? false;
-        const benchDir = resolve30("renders", ".benchmark");
+        const benchDir = resolve31("renders", ".benchmark");
         let producer = null;
         try {
           producer = await loadProducer();
@@ -38886,7 +39466,7 @@ var init_benchmark = __esm({
           s2?.start(`Benchmarking ${config.label}...`);
           for (let i2 = 0; i2 < runsPerConfig; i2++) {
             s2?.message(`${config.label} \u2014 run ${i2 + 1}/${runsPerConfig}`);
-            const outputPath = join43(
+            const outputPath = join44(
               benchDir,
               `${config.label.replace(/[^a-zA-Z0-9]/g, "_")}_run${i2}.mp4`
             );
@@ -38900,7 +39480,7 @@ var init_benchmark = __esm({
               await producer.executeRenderJob(job, project.dir, outputPath);
               const elapsedMs = Date.now() - startTime;
               let fileSize = null;
-              if (existsSync42(outputPath)) {
+              if (existsSync43(outputPath)) {
                 const stat3 = statSync17(outputPath);
                 fileSize = stat3.size;
               }
@@ -38983,7 +39563,7 @@ var init_benchmark = __esm({
 var browser_exports = {};
 __export(browser_exports, {
   default: () => browser_default,
-  examples: () => examples12
+  examples: () => examples14
 });
 async function runEnsure() {
   Wt2(c.bold("hyperframes browser ensure"));
@@ -39046,7 +39626,7 @@ function runClear() {
     Gt(c.dim("No cached browser to remove."));
   }
 }
-var examples12, browser_default;
+var examples14, browser_default;
 var init_browser = __esm({
   "src/commands/browser.ts"() {
     "use strict";
@@ -39056,7 +39636,7 @@ var init_browser = __esm({
     init_format();
     init_manager2();
     init_events();
-    examples12 = [
+    examples14 = [
       ["Find or download Chrome for rendering", "hyperframes browser ensure"],
       ["Print the Chrome executable path", "hyperframes browser path"],
       ["Remove cached Chrome download", "hyperframes browser clear"]
@@ -39114,10 +39694,10 @@ Run ${c.accent("hyperframes browser --help")} for usage.`
 var transcribe_exports2 = {};
 __export(transcribe_exports2, {
   default: () => transcribe_default,
-  examples: () => examples13
+  examples: () => examples15
 });
-import { existsSync as existsSync43, writeFileSync as writeFileSync17 } from "fs";
-import { resolve as resolve31, join as join44, extname as extname8 } from "path";
+import { existsSync as existsSync44, writeFileSync as writeFileSync17 } from "fs";
+import { resolve as resolve32, join as join45, extname as extname8 } from "path";
 async function importTranscript(inputPath, dir, json) {
   const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
   const { words, format } = loadTranscript2(inputPath);
@@ -39125,7 +39705,7 @@ async function importTranscript(inputPath, dir, json) {
     console.error(c.error("No words found in transcript."));
     process.exit(1);
   }
-  const outPath = join44(dir, "transcript.json");
+  const outPath = join45(dir, "transcript.json");
   writeFileSync17(outPath, JSON.stringify(words, null, 2));
   patchCaptionHtml2(dir, words);
   if (json) {
@@ -39192,7 +39772,7 @@ async function transcribeAudio(inputPath, dir, opts) {
     process.exit(1);
   }
 }
-var examples13, transcribe_default;
+var examples15, transcribe_default;
 var init_transcribe2 = __esm({
   "src/commands/transcribe.ts"() {
     "use strict";
@@ -39200,7 +39780,7 @@ var init_transcribe2 = __esm({
     init_dist3();
     init_colors();
     init_manager();
-    examples13 = [
+    examples15 = [
       ["Transcribe an audio file", "hyperframes transcribe audio.mp3"],
       ["Transcribe a video file", "hyperframes transcribe video.mp4"],
       ["Use a larger model for better accuracy", "hyperframes transcribe audio.mp3 --model medium.en"],
@@ -39241,12 +39821,12 @@ var init_transcribe2 = __esm({
         }
       },
       async run({ args }) {
-        const inputPath = resolve31(args.input);
-        if (!existsSync43(inputPath)) {
+        const inputPath = resolve32(args.input);
+        if (!existsSync44(inputPath)) {
           console.error(c.error(`File not found: ${args.input}`));
           process.exit(1);
         }
-        const dir = resolve31(args.dir ?? ".");
+        const dir = resolve32(args.dir ?? ".");
         const ext = extname8(inputPath).toLowerCase();
         const isImport = ext === ".json" || ext === ".srt" || ext === ".vtt";
         if (isImport) {
@@ -39263,9 +39843,9 @@ var init_transcribe2 = __esm({
 });
 
 // src/tts/manager.ts
-import { existsSync as existsSync44, mkdirSync as mkdirSync23 } from "fs";
+import { existsSync as existsSync45, mkdirSync as mkdirSync23 } from "fs";
 import { homedir as homedir8 } from "os";
-import { join as join45 } from "path";
+import { join as join46 } from "path";
 function inferLangFromVoiceId(voiceId) {
   const first = voiceId.charAt(0).toLowerCase();
   return VOICE_PREFIX_LANG[first] ?? "en-us";
@@ -39274,8 +39854,8 @@ function isSupportedLang(value) {
   return SUPPORTED_LANGS.includes(value);
 }
 async function ensureModel2(model = DEFAULT_MODEL2, options) {
-  const modelPath = join45(MODELS_DIR2, `${model}.onnx`);
-  if (existsSync44(modelPath)) return modelPath;
+  const modelPath = join46(MODELS_DIR2, `${model}.onnx`);
+  if (existsSync45(modelPath)) return modelPath;
   const url = MODEL_URLS[model];
   if (!url) {
     throw new Error(
@@ -39285,18 +39865,18 @@ async function ensureModel2(model = DEFAULT_MODEL2, options) {
   mkdirSync23(MODELS_DIR2, { recursive: true });
   options?.onProgress?.(`Downloading TTS model ${model} (~311 MB)...`);
   await downloadFile(url, modelPath);
-  if (!existsSync44(modelPath)) {
+  if (!existsSync45(modelPath)) {
     throw new Error(`Model download failed: ${model}`);
   }
   return modelPath;
 }
 async function ensureVoices(options) {
-  const voicesPath = join45(VOICES_DIR, "voices-v1.0.bin");
-  if (existsSync44(voicesPath)) return voicesPath;
+  const voicesPath = join46(VOICES_DIR, "voices-v1.0.bin");
+  if (existsSync45(voicesPath)) return voicesPath;
   mkdirSync23(VOICES_DIR, { recursive: true });
   options?.onProgress?.("Downloading voice data (~27 MB)...");
   await downloadFile(VOICES_URL, voicesPath);
-  if (!existsSync44(voicesPath)) {
+  if (!existsSync45(voicesPath)) {
     throw new Error("Voice data download failed");
   }
   return voicesPath;
@@ -39306,9 +39886,9 @@ var init_manager3 = __esm({
   "src/tts/manager.ts"() {
     "use strict";
     init_download();
-    CACHE_DIR3 = join45(homedir8(), ".cache", "hyperframes", "tts");
-    MODELS_DIR2 = join45(CACHE_DIR3, "models");
-    VOICES_DIR = join45(CACHE_DIR3, "voices");
+    CACHE_DIR3 = join46(homedir8(), ".cache", "hyperframes", "tts");
+    MODELS_DIR2 = join46(CACHE_DIR3, "models");
+    VOICES_DIR = join46(CACHE_DIR3, "voices");
     DEFAULT_MODEL2 = "kokoro-v1.0";
     MODEL_URLS = {
       "kokoro-v1.0": "https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx"
@@ -39369,8 +39949,8 @@ __export(synthesize_exports, {
   synthesize: () => synthesize
 });
 import { execFileSync as execFileSync6 } from "child_process";
-import { existsSync as existsSync45, writeFileSync as writeFileSync18, mkdirSync as mkdirSync24, readdirSync as readdirSync17, unlinkSync as unlinkSync6 } from "fs";
-import { join as join46, dirname as dirname18, basename as basename10 } from "path";
+import { existsSync as existsSync46, writeFileSync as writeFileSync18, mkdirSync as mkdirSync24, readdirSync as readdirSync17, unlinkSync as unlinkSync6 } from "fs";
+import { join as join47, dirname as dirname19, basename as basename10 } from "path";
 import { homedir as homedir9 } from "os";
 function findPython() {
   for (const name of ["python3", "python"]) {
@@ -39406,7 +39986,7 @@ function hasPythonPackage(python, pkg) {
   }
 }
 function ensureSynthScript() {
-  if (!existsSync45(SCRIPT_PATH)) {
+  if (!existsSync46(SCRIPT_PATH)) {
     mkdirSync24(SCRIPT_DIR, { recursive: true });
     writeFileSync18(SCRIPT_PATH, SYNTH_SCRIPT);
     const currentName = basename10(SCRIPT_PATH);
@@ -39414,7 +39994,7 @@ function ensureSynthScript() {
       for (const entry of readdirSync17(SCRIPT_DIR)) {
         if (entry !== currentName && /^synth(-v\d+)?\.py$/.test(entry)) {
           try {
-            unlinkSync6(join46(SCRIPT_DIR, entry));
+            unlinkSync6(join47(SCRIPT_DIR, entry));
           } catch {
           }
         }
@@ -39448,7 +40028,7 @@ async function synthesize(text, outputPath, options) {
     ensureVoices({ onProgress: options?.onProgress })
   ]);
   const scriptPath = ensureSynthScript();
-  mkdirSync24(dirname18(outputPath), { recursive: true });
+  mkdirSync24(dirname19(outputPath), { recursive: true });
   options?.onProgress?.(`Generating speech with voice ${voice} (${lang})...`);
   try {
     const stdout2 = execFileSync6(
@@ -39460,7 +40040,7 @@ async function synthesize(text, outputPath, options) {
         stdio: ["pipe", "pipe", "pipe"]
       }
     );
-    if (!existsSync45(outputPath)) {
+    if (!existsSync46(outputPath)) {
       throw new Error("Synthesis completed but no output file was created");
     }
     const lines = stdout2.trim().split("\n");
@@ -39473,7 +40053,7 @@ async function synthesize(text, outputPath, options) {
       langApplied: result.langApplied
     };
   } catch (err) {
-    if (err instanceof SyntaxError && existsSync45(outputPath)) {
+    if (err instanceof SyntaxError && existsSync46(outputPath)) {
       throw new Error(
         "Speech was generated but metadata could not be read. Check the output file manually."
       );
@@ -39524,8 +40104,8 @@ print(json.dumps({
     "langApplied": bool(lang and supports_lang),
 }))
 `;
-    SCRIPT_DIR = join46(homedir9(), ".cache", "hyperframes", "tts");
-    SCRIPT_PATH = join46(SCRIPT_DIR, "synth-v2.py");
+    SCRIPT_DIR = join47(homedir9(), ".cache", "hyperframes", "tts");
+    SCRIPT_PATH = join47(SCRIPT_DIR, "synth-v2.py");
   }
 });
 
@@ -39533,10 +40113,10 @@ print(json.dumps({
 var tts_exports = {};
 __export(tts_exports, {
   default: () => tts_default,
-  examples: () => examples14
+  examples: () => examples16
 });
-import { existsSync as existsSync46, readFileSync as readFileSync31 } from "fs";
-import { resolve as resolve32, extname as extname9 } from "path";
+import { existsSync as existsSync47, readFileSync as readFileSync32 } from "fs";
+import { resolve as resolve33, extname as extname9 } from "path";
 function listVoices(json) {
   const rows = BUNDLED_VOICES.map((v) => ({ ...v, defaultLang: inferLangFromVoiceId(v.id) }));
   if (json) {
@@ -39566,7 +40146,7 @@ ${c.bold("Available voices")} (Kokoro-82M)
 `
   );
 }
-var examples14, voiceList, langList, tts_default;
+var examples16, voiceList, langList, tts_default;
 var init_tts = __esm({
   "src/commands/tts.ts"() {
     "use strict";
@@ -39575,7 +40155,7 @@ var init_tts = __esm({
     init_colors();
     init_format();
     init_manager3();
-    examples14 = [
+    examples16 = [
       ["Generate speech from text", 'hyperframes tts "Welcome to HyperFrames"'],
       ["Choose a voice", 'hyperframes tts "Hello world" --voice am_adam'],
       ["Save to a specific file", 'hyperframes tts "Intro" --voice bf_emma --output narration.wav'],
@@ -39644,9 +40224,9 @@ var init_tts = __esm({
           process.exit(1);
         }
         let text;
-        const maybeFile = resolve32(args.input);
-        if (existsSync46(maybeFile) && extname9(maybeFile).toLowerCase() === ".txt") {
-          text = readFileSync31(maybeFile, "utf-8").trim();
+        const maybeFile = resolve33(args.input);
+        if (existsSync47(maybeFile) && extname9(maybeFile).toLowerCase() === ".txt") {
+          text = readFileSync32(maybeFile, "utf-8").trim();
           if (!text) {
             console.error(c.error("File is empty."));
             process.exit(1);
@@ -39658,7 +40238,7 @@ var init_tts = __esm({
           console.error(c.error("No text provided."));
           process.exit(1);
         }
-        const output = resolve32(args.output ?? "speech.wav");
+        const output = resolve33(args.output ?? "speech.wav");
         const voice = args.voice ?? DEFAULT_VOICE;
         const speed = args.speed ? parseFloat(args.speed) : 1;
         if (isNaN(speed) || speed <= 0 || speed > 3) {
@@ -39736,17 +40316,17 @@ var init_tts = __esm({
 var docs_exports = {};
 __export(docs_exports, {
   default: () => docs_default,
-  examples: () => examples15
+  examples: () => examples17
 });
-import { readFileSync as readFileSync32, existsSync as existsSync47 } from "fs";
-import { resolve as resolve33, dirname as dirname19, join as join47 } from "path";
-import { fileURLToPath as fileURLToPath6 } from "url";
+import { readFileSync as readFileSync33, existsSync as existsSync48 } from "fs";
+import { resolve as resolve34, dirname as dirname20, join as join48 } from "path";
+import { fileURLToPath as fileURLToPath7 } from "url";
 function docsDir() {
-  const thisFile = fileURLToPath6(import.meta.url);
-  const dir = dirname19(thisFile);
-  const devPath = resolve33(dir, "..", "docs");
-  const builtPath = resolve33(dir, "docs");
-  return existsSync47(devPath) ? devPath : builtPath;
+  const thisFile = fileURLToPath7(import.meta.url);
+  const dir = dirname20(thisFile);
+  const devPath = resolve34(dir, "..", "docs");
+  const builtPath = resolve34(dir, "docs");
+  return existsSync48(devPath) ? devPath : builtPath;
 }
 function formatInlineCode(line) {
   return line.replace(/`([^`]+)`/g, (_match, code) => c.accent(code));
@@ -39773,13 +40353,13 @@ function renderMarkdown(content) {
     console.log(formatInlineCode(line));
   }
 }
-var examples15, TOPICS, TOPIC_NAMES, docs_default;
+var examples17, TOPICS, TOPIC_NAMES, docs_default;
 var init_docs = __esm({
   "src/commands/docs.ts"() {
     "use strict";
     init_dist();
     init_colors();
-    examples15 = [
+    examples17 = [
       ["List all available topics", "hyperframes docs"],
       ["Read about data attributes", "hyperframes docs data-attributes"],
       ["Read about rendering", "hyperframes docs rendering"],
@@ -39843,12 +40423,12 @@ var init_docs = __esm({
           }
           process.exit(1);
         }
-        const filePath = join47(docsDir(), entry.file);
-        if (!existsSync47(filePath)) {
+        const filePath = join48(docsDir(), entry.file);
+        if (!existsSync48(filePath)) {
           console.error(c.error(`Doc file not found: ${filePath}`));
           process.exit(1);
         }
-        const content = readFileSync32(filePath, "utf-8");
+        const content = readFileSync33(filePath, "utf-8");
         console.log();
         renderMarkdown(content);
       }
@@ -39860,7 +40440,7 @@ var init_docs = __esm({
 var doctor_exports = {};
 __export(doctor_exports, {
   default: () => doctor_default,
-  examples: () => examples16
+  examples: () => examples18
 });
 import { execSync as execSync3 } from "child_process";
 import { freemem as freemem4, platform as platform4 } from "os";
@@ -40002,7 +40582,7 @@ function checkEnvironment() {
   }
   return { ok: true, detail: parts.join(" \xB7 ") };
 }
-var examples16, doctor_default;
+var examples18, doctor_default;
 var init_doctor = __esm({
   "src/commands/doctor.ts"() {
     "use strict";
@@ -40013,7 +40593,7 @@ var init_doctor = __esm({
     init_version();
     init_updateCheck();
     init_system();
-    examples16 = [["Check system dependencies", "hyperframes doctor"]];
+    examples18 = [["Check system dependencies", "hyperframes doctor"]];
     doctor_default = defineCommand({
       meta: { name: "doctor", description: "Check system dependencies and environment" },
       args: {},
@@ -40068,10 +40648,10 @@ var init_doctor = __esm({
 var upgrade_exports = {};
 __export(upgrade_exports, {
   default: () => upgrade_default,
-  examples: () => examples17
+  examples: () => examples19
 });
 import { execSync as execSync4 } from "child_process";
-var examples17, upgrade_default;
+var examples19, upgrade_default;
 var init_upgrade = __esm({
   "src/commands/upgrade.ts"() {
     "use strict";
@@ -40080,7 +40660,7 @@ var init_upgrade = __esm({
     init_colors();
     init_version();
     init_updateCheck();
-    examples17 = [
+    examples19 = [
       ["Check for updates interactively", "hyperframes upgrade"],
       ["Check for updates without prompting", "hyperframes upgrade --check"],
       ["Upgrade non-interactively", "hyperframes upgrade --yes"]
@@ -40158,7 +40738,7 @@ var init_upgrade = __esm({
 var telemetry_exports = {};
 __export(telemetry_exports, {
   default: () => telemetry_default,
-  examples: () => examples18
+  examples: () => examples20
 });
 function runEnable() {
   const config = readConfig();
@@ -40188,14 +40768,14 @@ function runStatus() {
   console.log(`  ${c.dim("Env var:")}    ${c.accent("HYPERFRAMES_NO_TELEMETRY=1")}`);
   console.log();
 }
-var examples18, telemetry_default;
+var examples20, telemetry_default;
 var init_telemetry = __esm({
   "src/commands/telemetry.ts"() {
     "use strict";
     init_dist();
     init_colors();
     init_config();
-    examples18 = [
+    examples20 = [
       ["Check current telemetry status", "hyperframes telemetry status"],
       ["Disable telemetry", "hyperframes telemetry disable"],
       ["Enable telemetry", "hyperframes telemetry enable"]
@@ -40274,17 +40854,17 @@ var validate_exports = {};
 __export(validate_exports, {
   default: () => validate_default
 });
-import { existsSync as existsSync48, readFileSync as readFileSync33 } from "fs";
-import { resolve as resolve34, join as join48, dirname as dirname20 } from "path";
-import { fileURLToPath as fileURLToPath7 } from "url";
-async function getCompositionDuration2(page) {
+import { existsSync as existsSync49, readFileSync as readFileSync34 } from "fs";
+import { resolve as resolve35, join as join49, dirname as dirname21 } from "path";
+import { fileURLToPath as fileURLToPath8 } from "url";
+async function getCompositionDuration3(page) {
   return page.evaluate(() => {
     if (window.__hf?.duration && window.__hf.duration > 0) return window.__hf.duration;
     const root = document.querySelector("[data-composition-id][data-duration]");
     return root ? parseFloat(root.getAttribute("data-duration") ?? "0") : 0;
   });
 }
-async function seekTo(page, time) {
+async function seekTo2(page, time) {
   await page.evaluate((t3) => {
     if (window.__hf && typeof window.__hf.seek === "function") {
       window.__hf.seek(t3);
@@ -40297,16 +40877,16 @@ async function seekTo(page, time) {
       }
     }
   }, time);
-  await new Promise((r2) => setTimeout(r2, SEEK_SETTLE_MS));
+  await new Promise((r2) => setTimeout(r2, SEEK_SETTLE_MS2));
 }
 async function runContrastAudit(page) {
-  const duration = await getCompositionDuration2(page);
+  const duration = await getCompositionDuration3(page);
   if (duration <= 0) return [];
   await page.addScriptTag({ content: contrast_audit_browser_default });
   const results = [];
   for (let i2 = 0; i2 < CONTRAST_SAMPLES; i2++) {
     const t3 = +((i2 + 0.5) / CONTRAST_SAMPLES * duration).toFixed(3);
-    await seekTo(page, t3);
+    await seekTo2(page, t3);
     const screenshot = await page.screenshot({ encoding: "base64", type: "png" });
     const entries2 = await page.evaluate(
       (b64, time) => typeof window.__contrastAudit === "function" ? window.__contrastAudit(b64, time) : [],
@@ -40321,8 +40901,8 @@ async function validateInBrowser(projectDir, opts) {
   const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
   const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
   let html = await bundleToSingleHtml2(projectDir);
-  const runtimePath = resolve34(
-    __dirname2,
+  const runtimePath = resolve35(
+    __dirname3,
     "..",
     "..",
     "..",
@@ -40330,26 +40910,26 @@ async function validateInBrowser(projectDir, opts) {
     "dist",
     "hyperframe.runtime.iife.js"
   );
-  if (existsSync48(runtimePath)) {
-    const runtimeSource = readFileSync33(runtimePath, "utf-8");
+  if (existsSync49(runtimePath)) {
+    const runtimeSource = readFileSync34(runtimePath, "utf-8");
     html = html.replace(
       /<script[^>]*data-hyperframes-preview-runtime[^>]*src="[^"]*"[^>]*><\/script>/,
       () => `<script data-hyperframes-preview-runtime="1">${runtimeSource}</script>`
     );
   }
-  const { createServer } = await import("http");
+  const { createServer: createServer2 } = await import("http");
   const { getMimeType: getMimeType2 } = await Promise.resolve().then(() => (init_studio_api(), studio_api_exports));
-  const server = createServer((req, res) => {
+  const server = createServer2((req, res) => {
     const url = req.url ?? "/";
     if (url === "/" || url === "/index.html") {
       res.writeHead(200, { "Content-Type": "text/html" });
       res.end(html);
       return;
     }
-    const filePath = join48(projectDir, decodeURIComponent(url));
-    if (existsSync48(filePath)) {
+    const filePath = join49(projectDir, decodeURIComponent(url));
+    if (existsSync49(filePath)) {
       res.writeHead(200, { "Content-Type": getMimeType2(filePath) });
-      res.end(readFileSync33(filePath));
+      res.end(readFileSync34(filePath));
       return;
     }
     res.writeHead(404);
@@ -40427,7 +41007,7 @@ function printContrastFailures(failures) {
     );
   }
 }
-var __filename, __dirname2, CONTRAST_SAMPLES, SEEK_SETTLE_MS, validate_default;
+var __filename2, __dirname3, CONTRAST_SAMPLES, SEEK_SETTLE_MS2, validate_default;
 var init_validate = __esm({
   "src/commands/validate.ts"() {
     "use strict";
@@ -40436,10 +41016,10 @@ var init_validate = __esm({
     init_colors();
     init_updateCheck();
     init_contrast_audit_browser();
-    __filename = fileURLToPath7(import.meta.url);
-    __dirname2 = dirname20(__filename);
+    __filename2 = fileURLToPath8(import.meta.url);
+    __dirname3 = dirname21(__filename2);
     CONTRAST_SAMPLES = 5;
-    SEEK_SETTLE_MS = 150;
+    SEEK_SETTLE_MS2 = 150;
     validate_default = defineCommand({
       meta: {
         name: "validate",
@@ -40537,16 +41117,16 @@ Examples:
 var snapshot_exports = {};
 __export(snapshot_exports, {
   default: () => snapshot_default,
-  examples: () => examples19
+  examples: () => examples21
 });
 import { spawn as spawn11 } from "child_process";
-import { existsSync as existsSync49, mkdtempSync as mkdtempSync3, readFileSync as readFileSync34, mkdirSync as mkdirSync25, rmSync as rmSync10 } from "fs";
+import { existsSync as existsSync50, mkdtempSync as mkdtempSync3, readFileSync as readFileSync35, mkdirSync as mkdirSync25, rmSync as rmSync10 } from "fs";
 import { tmpdir as tmpdir5 } from "os";
-import { resolve as resolve35, join as join49, dirname as dirname21, relative as relative5, isAbsolute as isAbsolute6 } from "path";
-import { fileURLToPath as fileURLToPath8 } from "url";
+import { resolve as resolve36, join as join50, dirname as dirname22, relative as relative6, isAbsolute as isAbsolute7 } from "path";
+import { fileURLToPath as fileURLToPath9 } from "url";
 async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false) {
-  const tmp = mkdtempSync3(join49(tmpdir5(), "hf-snapshot-frame-"));
-  const outPath = join49(tmp, "frame.png");
+  const tmp = mkdtempSync3(join50(tmpdir5(), "hf-snapshot-frame-"));
+  const outPath = join50(tmp, "frame.png");
   try {
     const result = await new Promise(
       (resolvePromise) => {
@@ -40586,8 +41166,8 @@ async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDeco
         });
       }
     );
-    if (result.code !== 0 || result.timedOut || !existsSync49(outPath)) return null;
-    return readFileSync34(outPath);
+    if (result.code !== 0 || result.timedOut || !existsSync50(outPath)) return null;
+    return readFileSync35(outPath);
   } finally {
     try {
       rmSync10(tmp, { recursive: true, force: true });
@@ -40600,8 +41180,8 @@ async function captureSnapshots(projectDir, opts) {
   const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
   const numFrames = opts.frames ?? 5;
   let html = await bundleToSingleHtml2(projectDir);
-  const runtimePath = resolve35(
-    __dirname3,
+  const runtimePath = resolve36(
+    __dirname4,
     "..",
     "..",
     "..",
@@ -40609,32 +41189,32 @@ async function captureSnapshots(projectDir, opts) {
     "dist",
     "hyperframe.runtime.iife.js"
   );
-  if (existsSync49(runtimePath)) {
-    const runtimeSource = readFileSync34(runtimePath, "utf-8");
+  if (existsSync50(runtimePath)) {
+    const runtimeSource = readFileSync35(runtimePath, "utf-8");
     html = html.replace(
       /<script[^>]*data-hyperframes-preview-runtime[^>]*src="[^"]*"[^>]*><\/script>/,
       () => `<script data-hyperframes-preview-runtime="1">${runtimeSource}</script>`
     );
   }
-  const { createServer } = await import("http");
+  const { createServer: createServer2 } = await import("http");
   const { getMimeType: getMimeType2 } = await Promise.resolve().then(() => (init_studio_api(), studio_api_exports));
-  const server = createServer((req, res) => {
+  const server = createServer2((req, res) => {
     const url = req.url ?? "/";
     if (url === "/" || url === "/index.html") {
       res.writeHead(200, { "Content-Type": "text/html" });
       res.end(html);
       return;
     }
-    const filePath = resolve35(projectDir, decodeURIComponent(url).replace(/^\//, ""));
-    const rel = relative5(projectDir, filePath);
-    if (rel.startsWith("..") || isAbsolute6(rel)) {
+    const filePath = resolve36(projectDir, decodeURIComponent(url).replace(/^\//, ""));
+    const rel = relative6(projectDir, filePath);
+    if (rel.startsWith("..") || isAbsolute7(rel)) {
       res.writeHead(403);
       res.end();
       return;
     }
-    if (existsSync49(filePath)) {
+    if (existsSync50(filePath)) {
       res.writeHead(200, { "Content-Type": getMimeType2(filePath) });
-      res.end(readFileSync34(filePath));
+      res.end(readFileSync35(filePath));
       return;
     }
     res.writeHead(404);
@@ -40707,7 +41287,7 @@ async function captureSnapshots(projectDir, opts) {
         return [];
       }
       const positions = opts.at?.length ? opts.at : numFrames === 1 ? [duration / 2] : Array.from({ length: numFrames }, (_2, i2) => i2 / (numFrames - 1) * duration);
-      const snapshotDir = join49(projectDir, "snapshots");
+      const snapshotDir = join50(projectDir, "snapshots");
       mkdirSync25(snapshotDir, { recursive: true });
       let injectVideoFramesBatch2 = null;
       let syncVideoFrameVisibility2 = null;
@@ -40780,9 +41360,9 @@ async function captureSnapshots(projectDir, opts) {
             try {
               const url = new URL(v.src);
               const decodedPath = decodeURIComponent(url.pathname).replace(/^\//, "");
-              const candidate = resolve35(projectDir, decodedPath);
-              const rel = relative5(projectDir, candidate);
-              if (!rel.startsWith("..") && !isAbsolute6(rel) && existsSync49(candidate)) {
+              const candidate = resolve36(projectDir, decodedPath);
+              const rel = relative6(projectDir, candidate);
+              if (!rel.startsWith("..") && !isAbsolute7(rel) && existsSync50(candidate)) {
                 filePath = candidate;
               }
             } catch {
@@ -40812,7 +41392,7 @@ async function captureSnapshots(projectDir, opts) {
         }
         const timeLabel = opts.at?.length ? `${time.toFixed(1)}s` : `${Math.round(time / duration * 100)}pct`;
         const filename = `frame-${String(i2).padStart(2, "0")}-at-${timeLabel}.png`;
-        const framePath = join49(snapshotDir, filename);
+        const framePath = join50(snapshotDir, filename);
         await page.screenshot({ path: framePath, type: "png" });
         savedPaths.push(`snapshots/${filename}`);
       }
@@ -40824,17 +41404,17 @@ async function captureSnapshots(projectDir, opts) {
   }
   return savedPaths;
 }
-var __filename2, __dirname3, FFMPEG_EXTRACT_TIMEOUT_MS, examples19, snapshot_default;
+var __filename3, __dirname4, FFMPEG_EXTRACT_TIMEOUT_MS, examples21, snapshot_default;
 var init_snapshot = __esm({
   "src/commands/snapshot.ts"() {
     "use strict";
     init_dist();
     init_project();
     init_colors();
-    __filename2 = fileURLToPath8(import.meta.url);
-    __dirname3 = dirname21(__filename2);
+    __filename3 = fileURLToPath9(import.meta.url);
+    __dirname4 = dirname22(__filename3);
     FFMPEG_EXTRACT_TIMEOUT_MS = 3e4;
-    examples19 = [
+    examples21 = [
       ["Capture 5 key frames from a composition", "snapshot captures/stripe"],
       ["Capture 10 evenly-spaced frames", "snapshot captures/stripe --frames 10"]
     ];
@@ -40898,13 +41478,13 @@ ${c.error("\u2717")} Snapshot failed: ${msg}`);
 
 // src/capture/assetDownloader.ts
 import { writeFileSync as writeFileSync19, mkdirSync as mkdirSync26 } from "fs";
-import { join as join50, extname as extname10 } from "path";
+import { join as join51, extname as extname10 } from "path";
 async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks) {
-  const assetsDir = join50(outputDir, "assets");
+  const assetsDir = join51(outputDir, "assets");
   mkdirSync26(assetsDir, { recursive: true });
   const assets = [];
   const downloadedUrls = /* @__PURE__ */ new Set();
-  mkdirSync26(join50(outputDir, "assets", "svgs"), { recursive: true });
+  mkdirSync26(join51(outputDir, "assets", "svgs"), { recursive: true });
   for (let i2 = 0; i2 < tokens.svgs.length && i2 < 30; i2++) {
     const svg = tokens.svgs[i2];
     if (!svg.outerHTML || svg.outerHTML.length < 50) continue;
@@ -40912,7 +41492,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks)
     const name = label2 ? slugify(label2) + ".svg" : svg.isLogo ? `logo-${i2}.svg` : `icon-${i2}.svg`;
     const localPath = `assets/svgs/${name}`;
     try {
-      writeFileSync19(join50(outputDir, localPath), svg.outerHTML, "utf-8");
+      writeFileSync19(join51(outputDir, localPath), svg.outerHTML, "utf-8");
       assets.push({ url: "", localPath, type: "svg" });
     } catch {
     }
@@ -40925,7 +41505,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks)
       const localPath = `assets/${name}`;
       const buffer = await fetchBuffer(icon.href);
       if (buffer) {
-        writeFileSync19(join50(outputDir, localPath), buffer);
+        writeFileSync19(join51(outputDir, localPath), buffer);
         assets.push({ url: icon.href, localPath, type: "favicon" });
         break;
       }
@@ -40982,7 +41562,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks)
         const slug = isMeaningful ? slugify(rawName) : `${prefix}-${imgIdx}`;
         const name = `${slug}${ext}`;
         const localPath = `assets/${name}`;
-        writeFileSync19(join50(outputDir, localPath), buffer);
+        writeFileSync19(join51(outputDir, localPath), buffer);
         assets.push({ url, localPath, type: "image" });
         imgIdx++;
       } catch {
@@ -40995,7 +41575,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks)
       const localPath = `assets/og-image${ext}`;
       const buffer = await fetchBuffer(tokens.ogImage);
       if (buffer && buffer.length > 5e3) {
-        writeFileSync19(join50(outputDir, localPath), buffer);
+        writeFileSync19(join51(outputDir, localPath), buffer);
         assets.push({ url: tokens.ogImage, localPath, type: "image" });
       }
     } catch {
@@ -41018,7 +41598,7 @@ function normalizeUrl(u) {
   }
 }
 async function downloadAndRewriteFonts(css, outputDir) {
-  const assetsDir = join50(outputDir, "assets", "fonts");
+  const assetsDir = join51(outputDir, "assets", "fonts");
   mkdirSync26(assetsDir, { recursive: true });
   const fontUrlRegex = /url\(['"]?(https?:\/\/[^'")\s]+\.(?:woff2?|ttf|otf)[^'")\s]*?)['"]?\)/g;
   const fontUrls = /* @__PURE__ */ new Set();
@@ -41054,7 +41634,7 @@ async function downloadAndRewriteFonts(css, outputDir) {
     try {
       const urlObj = new URL(fontUrl);
       const filename = urlObj.pathname.split("/").pop() || `font-${count}.woff2`;
-      const localPath = join50(assetsDir, filename);
+      const localPath = join51(assetsDir, filename);
       const relativePath = `assets/fonts/${filename}`;
       const buffer = await fetchBuffer(fontUrl);
       if (buffer) {
@@ -41851,8 +42431,8 @@ var init_animationCataloger = __esm({
 });
 
 // src/capture/mediaCapture.ts
-import { mkdirSync as mkdirSync27, writeFileSync as writeFileSync20, readdirSync as readdirSync18, readFileSync as readFileSync35, statSync as statSync18 } from "fs";
-import { join as join51 } from "path";
+import { mkdirSync as mkdirSync27, writeFileSync as writeFileSync20, readdirSync as readdirSync18, readFileSync as readFileSync36, statSync as statSync18 } from "fs";
+import { join as join52 } from "path";
 async function saveLottieAnimations(discoveredLotties, lottieDir) {
   let savedCount = 0;
   const savedHashes = /* @__PURE__ */ new Set();
@@ -41885,7 +42465,7 @@ async function saveLottieAnimations(discoveredLotties, lottieDir) {
             const hash2 = buf.toString("base64").slice(0, 100);
             if (savedHashes.has(hash2)) continue;
             savedHashes.add(hash2);
-            writeFileSync20(join51(lottieDir, `animation-${savedCount}.lottie`), buf);
+            writeFileSync20(join52(lottieDir, `animation-${savedCount}.lottie`), buf);
             savedCount++;
             continue;
           }
@@ -41903,7 +42483,7 @@ async function saveLottieAnimations(discoveredLotties, lottieDir) {
         } catch {
           continue;
         }
-        writeFileSync20(join51(lottieDir, `animation-${savedCount}.json`), jsonData, "utf-8");
+        writeFileSync20(join52(lottieDir, `animation-${savedCount}.json`), jsonData, "utf-8");
         savedCount++;
       }
     } catch {
@@ -41913,22 +42493,22 @@ async function saveLottieAnimations(discoveredLotties, lottieDir) {
 }
 async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
   const manifest = [];
-  const previewDir = join51(lottieDir, "previews");
+  const previewDir = join52(lottieDir, "previews");
   mkdirSync27(previewDir, { recursive: true });
   for (const file of readdirSync18(lottieDir)) {
     if (!file.endsWith(".json")) continue;
     try {
-      const raw = JSON.parse(readFileSync35(join51(lottieDir, file), "utf-8"));
+      const raw = JSON.parse(readFileSync36(join52(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 = statSync18(join51(lottieDir, file)).size;
+      const fileSize = statSync18(join52(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(readFileSync35(join51(lottieDir, file), "utf-8"));
+        const animData = JSON.parse(readFileSync36(join52(lottieDir, file), "utf-8"));
         const midFrame = Math.floor(((raw.op || 0) - (raw.ip || 0)) * 0.3);
         await previewPage.setContent(
           `<!DOCTYPE html>
@@ -41958,7 +42538,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
         await previewPage.waitForFunction(() => window.__READY === true, { timeout: 5e3 }).catch(() => {
         });
         await previewPage.screenshot({
-          path: join51(previewDir, previewName),
+          path: join52(previewDir, previewName),
           type: "png",
           omitBackground: true
         });
@@ -41982,7 +42562,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
   }
   if (manifest.length > 0) {
     writeFileSync20(
-      join51(outputDir, "extracted", "lottie-manifest.json"),
+      join52(outputDir, "extracted", "lottie-manifest.json"),
       JSON.stringify(manifest, null, 2),
       "utf-8"
     );
@@ -42044,15 +42624,15 @@ async function captureVideoManifest(page, outputDir, progress) {
     return true;
   });
   if (uniqueVideos.length > 0) {
-    const videoManifestDir = join51(outputDir, "assets", "videos");
+    const videoManifestDir = join52(outputDir, "assets", "videos");
     mkdirSync27(videoManifestDir, { recursive: true });
-    const previewDir = join51(videoManifestDir, "previews");
+    const previewDir = join52(videoManifestDir, "previews");
     mkdirSync27(previewDir, { recursive: true });
     const videoManifest = [];
     for (let vi = 0; vi < uniqueVideos.length && vi < 20; vi++) {
       const v = uniqueVideos[vi];
       const previewName = `video-${vi}-preview.png`;
-      const previewPath = join51(previewDir, previewName);
+      const previewPath = join52(previewDir, previewName);
       try {
         await page.evaluate(`window.scrollTo(0, ${Math.max(0, v.top - 100)})`);
         await new Promise((r2) => setTimeout(r2, 300));
@@ -42091,7 +42671,7 @@ async function captureVideoManifest(page, outputDir, progress) {
     }
     if (videoManifest.length > 0) {
       writeFileSync20(
-        join51(outputDir, "extracted", "video-manifest.json"),
+        join52(outputDir, "extracted", "video-manifest.json"),
         JSON.stringify(videoManifest, null, 2),
         "utf-8"
       );
@@ -42373,7 +42953,7 @@ var require_p_retry = __commonJS({
       return error;
     };
     var isNetworkError = (errorMessage) => networkErrorMsgs.includes(errorMessage);
-    var pRetry2 = (input, options) => new Promise((resolve38, reject) => {
+    var pRetry2 = (input, options) => new Promise((resolve39, reject) => {
       options = {
         onFailedAttempt: () => {
         },
@@ -42383,7 +42963,7 @@ var require_p_retry = __commonJS({
       const operation = retry.operation(options);
       operation.attempt(async (attemptNumber) => {
         try {
-          resolve38(await input(attemptNumber));
+          resolve39(await input(attemptNumber));
         } catch (error) {
           if (!(error instanceof Error)) {
             reject(new TypeError(`Non-error was thrown: "${error}". You should only throw errors.`));
@@ -42919,8 +43499,8 @@ var require_retry3 = __commonJS({
       }
       const delay = getNextRetryDelay(config);
       err.config.retryConfig.currentRetryAttempt += 1;
-      const backoff = config.retryBackoff ? config.retryBackoff(err, delay) : new Promise((resolve38) => {
-        setTimeout(resolve38, delay);
+      const backoff = config.retryBackoff ? config.retryBackoff(err, delay) : new Promise((resolve39) => {
+        setTimeout(resolve39, delay);
       });
       if (config.onRetryAttempt) {
         await config.onRetryAttempt(err);
@@ -43828,8 +44408,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((resolve38, reject) => {
-        req2.once("response", resolve38).once("error", reject).end();
+      const promise = new Promise((resolve39, reject) => {
+        req2.once("response", resolve39).once("error", reject).end();
       });
       req2.then = promise.then.bind(promise);
       return req2;
@@ -44006,7 +44586,7 @@ var require_parse_proxy_response = __commonJS({
     var debug_1 = __importDefault(require_src2());
     var debug = (0, debug_1.default)("https-proxy-agent:parse-proxy-response");
     function parseProxyResponse(socket) {
-      return new Promise((resolve38, reject) => {
+      return new Promise((resolve39, reject) => {
         let buffersLength = 0;
         const buffers = [];
         function read() {
@@ -44072,7 +44652,7 @@ var require_parse_proxy_response = __commonJS({
           }
           debug("got proxy server response: %o %o", firstLine, headers);
           cleanup();
-          resolve38({
+          resolve39({
             connect: {
               statusCode,
               statusText,
@@ -44316,7 +44896,7 @@ var require_ponyfill_es2018 = __commonJS({
         return new originalPromise(executor);
       }
       function promiseResolvedWith(value) {
-        return newPromise((resolve38) => resolve38(value));
+        return newPromise((resolve39) => resolve39(value));
       }
       function promiseRejectedWith(reason) {
         return originalPromiseReject(reason);
@@ -44486,8 +45066,8 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released reader");
       }
       function defaultReaderClosedPromiseInitialize(reader) {
-        reader._closedPromise = newPromise((resolve38, reject) => {
-          reader._closedPromise_resolve = resolve38;
+        reader._closedPromise = newPromise((resolve39, reject) => {
+          reader._closedPromise_resolve = resolve39;
           reader._closedPromise_reject = reject;
         });
       }
@@ -44661,8 +45241,8 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve38, reject) => {
-            resolvePromise = resolve38;
+          const promise = newPromise((resolve39, reject) => {
+            resolvePromise = resolve39;
             rejectPromise = reject;
           });
           const readRequest = {
@@ -44767,8 +45347,8 @@ var require_ponyfill_es2018 = __commonJS({
           const reader = this._reader;
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve38, reject) => {
-            resolvePromise = resolve38;
+          const promise = newPromise((resolve39, reject) => {
+            resolvePromise = resolve39;
             rejectPromise = reject;
           });
           const readRequest = {
@@ -45787,8 +46367,8 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve38, reject) => {
-            resolvePromise = resolve38;
+          const promise = newPromise((resolve39, reject) => {
+            resolvePromise = resolve39;
             rejectPromise = reject;
           });
           const readIntoRequest = {
@@ -46100,10 +46680,10 @@ var require_ponyfill_es2018 = __commonJS({
           wasAlreadyErroring = true;
           reason = void 0;
         }
-        const promise = newPromise((resolve38, reject) => {
+        const promise = newPromise((resolve39, reject) => {
           stream._pendingAbortRequest = {
             _promise: void 0,
-            _resolve: resolve38,
+            _resolve: resolve39,
             _reject: reject,
             _reason: reason,
             _wasAlreadyErroring: wasAlreadyErroring
@@ -46120,9 +46700,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((resolve38, reject) => {
+        const promise = newPromise((resolve39, reject) => {
           const closeRequest = {
-            _resolve: resolve38,
+            _resolve: resolve39,
             _reject: reject
           };
           stream._closeRequest = closeRequest;
@@ -46135,9 +46715,9 @@ var require_ponyfill_es2018 = __commonJS({
         return promise;
       }
       function WritableStreamAddWriteRequest(stream) {
-        const promise = newPromise((resolve38, reject) => {
+        const promise = newPromise((resolve39, reject) => {
           const writeRequest = {
-            _resolve: resolve38,
+            _resolve: resolve39,
             _reject: reject
           };
           stream._writeRequests.push(writeRequest);
@@ -46753,8 +47333,8 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released writer");
       }
       function defaultWriterClosedPromiseInitialize(writer) {
-        writer._closedPromise = newPromise((resolve38, reject) => {
-          writer._closedPromise_resolve = resolve38;
+        writer._closedPromise = newPromise((resolve39, reject) => {
+          writer._closedPromise_resolve = resolve39;
           writer._closedPromise_reject = reject;
           writer._closedPromiseState = "pending";
         });
@@ -46790,8 +47370,8 @@ var require_ponyfill_es2018 = __commonJS({
         writer._closedPromiseState = "resolved";
       }
       function defaultWriterReadyPromiseInitialize(writer) {
-        writer._readyPromise = newPromise((resolve38, reject) => {
-          writer._readyPromise_resolve = resolve38;
+        writer._readyPromise = newPromise((resolve39, reject) => {
+          writer._readyPromise_resolve = resolve39;
           writer._readyPromise_reject = reject;
         });
         writer._readyPromiseState = "pending";
@@ -46878,7 +47458,7 @@ var require_ponyfill_es2018 = __commonJS({
         source._disturbed = true;
         let shuttingDown = false;
         let currentWrite = promiseResolvedWith(void 0);
-        return newPromise((resolve38, reject) => {
+        return newPromise((resolve39, reject) => {
           let abortAlgorithm;
           if (signal !== void 0) {
             abortAlgorithm = () => {
@@ -47023,7 +47603,7 @@ var require_ponyfill_es2018 = __commonJS({
             if (isError) {
               reject(error);
             } else {
-              resolve38(void 0);
+              resolve39(void 0);
             }
             return null;
           }
@@ -47304,8 +47884,8 @@ var require_ponyfill_es2018 = __commonJS({
         let branch1;
         let branch2;
         let resolveCancelPromise;
-        const cancelPromise = newPromise((resolve38) => {
-          resolveCancelPromise = resolve38;
+        const cancelPromise = newPromise((resolve39) => {
+          resolveCancelPromise = resolve39;
         });
         function pullAlgorithm() {
           if (reading) {
@@ -47396,8 +47976,8 @@ var require_ponyfill_es2018 = __commonJS({
         let branch1;
         let branch2;
         let resolveCancelPromise;
-        const cancelPromise = newPromise((resolve38) => {
-          resolveCancelPromise = resolve38;
+        const cancelPromise = newPromise((resolve39) => {
+          resolveCancelPromise = resolve39;
         });
         function forwardReaderError(thisReader) {
           uponRejection(thisReader._closedPromise, (r2) => {
@@ -48177,8 +48757,8 @@ var require_ponyfill_es2018 = __commonJS({
           const writableHighWaterMark = ExtractHighWaterMark(writableStrategy, 1);
           const writableSizeAlgorithm = ExtractSizeAlgorithm(writableStrategy);
           let startPromise_resolve;
-          const startPromise = newPromise((resolve38) => {
-            startPromise_resolve = resolve38;
+          const startPromise = newPromise((resolve39) => {
+            startPromise_resolve = resolve39;
           });
           InitializeTransformStream(this, startPromise, writableHighWaterMark, writableSizeAlgorithm, readableHighWaterMark, readableSizeAlgorithm);
           SetUpTransformStreamDefaultControllerFromTransformer(this, transformer);
@@ -48271,8 +48851,8 @@ var require_ponyfill_es2018 = __commonJS({
         if (stream._backpressureChangePromise !== void 0) {
           stream._backpressureChangePromise_resolve();
         }
-        stream._backpressureChangePromise = newPromise((resolve38) => {
-          stream._backpressureChangePromise_resolve = resolve38;
+        stream._backpressureChangePromise = newPromise((resolve39) => {
+          stream._backpressureChangePromise_resolve = resolve39;
         });
         stream._backpressure = backpressure;
       }
@@ -48440,8 +49020,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve38, reject) => {
-          controller._finishPromise_resolve = resolve38;
+        controller._finishPromise = newPromise((resolve39, reject) => {
+          controller._finishPromise_resolve = resolve39;
           controller._finishPromise_reject = reject;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
@@ -48467,8 +49047,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve38, reject) => {
-          controller._finishPromise_resolve = resolve38;
+        controller._finishPromise = newPromise((resolve39, reject) => {
+          controller._finishPromise_resolve = resolve39;
           controller._finishPromise_reject = reject;
         });
         const flushPromise = controller._flushAlgorithm();
@@ -48498,8 +49078,8 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const writable = stream._writable;
-        controller._finishPromise = newPromise((resolve38, reject) => {
-          controller._finishPromise_resolve = resolve38;
+        controller._finishPromise = newPromise((resolve39, reject) => {
+          controller._finishPromise_resolve = resolve39;
           controller._finishPromise_reject = reject;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
@@ -50468,7 +51048,7 @@ import zlib from "zlib";
 import Stream2, { PassThrough as PassThrough2, pipeline as pump } from "stream";
 import { Buffer as Buffer3 } from "buffer";
 async function fetch3(url, options_) {
-  return new Promise((resolve38, reject) => {
+  return new Promise((resolve39, reject) => {
     const request = new Request2(url, options_);
     const { parsedURL, options } = getNodeRequestOptions(request);
     if (!supportedSchemas.has(parsedURL.protocol)) {
@@ -50477,7 +51057,7 @@ async function fetch3(url, options_) {
     if (parsedURL.protocol === "data:") {
       const data = dist_default(request.url);
       const response2 = new Response2(data, { headers: { "Content-Type": data.typeFull } });
-      resolve38(response2);
+      resolve39(response2);
       return;
     }
     const send = (parsedURL.protocol === "https:" ? https : http3).request;
@@ -50599,7 +51179,7 @@ async function fetch3(url, options_) {
             if (responseReferrerPolicy) {
               requestOptions.referrerPolicy = responseReferrerPolicy;
             }
-            resolve38(fetch3(new Request2(locationURL, requestOptions)));
+            resolve39(fetch3(new Request2(locationURL, requestOptions)));
             finalize();
             return;
           }
@@ -50632,7 +51212,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);
-        resolve38(response);
+        resolve39(response);
         return;
       }
       const zlibOptions = {
@@ -50646,7 +51226,7 @@ async function fetch3(url, options_) {
           }
         });
         response = new Response2(body, responseOptions);
-        resolve38(response);
+        resolve39(response);
         return;
       }
       if (codings === "deflate" || codings === "x-deflate") {
@@ -50670,12 +51250,12 @@ async function fetch3(url, options_) {
             });
           }
           response = new Response2(body, responseOptions);
-          resolve38(response);
+          resolve39(response);
         });
         raw.once("end", () => {
           if (!response) {
             response = new Response2(body, responseOptions);
-            resolve38(response);
+            resolve39(response);
           }
         });
         return;
@@ -50687,11 +51267,11 @@ async function fetch3(url, options_) {
           }
         });
         response = new Response2(body, responseOptions);
-        resolve38(response);
+        resolve39(response);
         return;
       }
       response = new Response2(body, responseOptions);
-      resolve38(response);
+      resolve39(response);
     });
     writeToStream(request_, request).catch(reject);
   });
@@ -56773,7 +57353,7 @@ var require_jwtaccess = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve38, reject) => {
+        return new Promise((resolve39, reject) => {
           if (!inputStream) {
             reject(new Error("Must pass in a stream containing the service account auth settings."));
           }
@@ -56782,7 +57362,7 @@ var require_jwtaccess = __commonJS({
             try {
               const data = JSON.parse(s2);
               this.fromJSON(data);
-              resolve38();
+              resolve39();
             } catch (err) {
               reject(err);
             }
@@ -57021,7 +57601,7 @@ var require_jwtclient = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve38, reject) => {
+        return new Promise((resolve39, reject) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the service account auth settings.");
           }
@@ -57030,7 +57610,7 @@ var require_jwtclient = __commonJS({
             try {
               const data = JSON.parse(s2);
               this.fromJSON(data);
-              resolve38();
+              resolve39();
             } catch (e2) {
               reject(e2);
             }
@@ -57163,7 +57743,7 @@ var require_refreshclient = __commonJS({
         }
       }
       async fromStreamAsync(inputStream) {
-        return new Promise((resolve38, reject) => {
+        return new Promise((resolve39, reject) => {
           if (!inputStream) {
             return reject(new Error("Must pass in a stream containing the user refresh token."));
           }
@@ -57172,7 +57752,7 @@ var require_refreshclient = __commonJS({
             try {
               const data = JSON.parse(s2);
               this.fromJSON(data);
-              return resolve38();
+              return resolve39();
             } catch (err) {
               return reject(err);
             }
@@ -59005,7 +59585,7 @@ var require_pluggable_auth_handler = __commonJS({
        * @return A promise that resolves with the executable response.
        */
       retrieveResponseFromExecutable(envMap) {
-        return new Promise((resolve38, reject) => {
+        return new Promise((resolve39, reject) => {
           const child = childProcess.spawn(this.commandComponents[0], this.commandComponents.slice(1), {
             env: { ...process.env, ...Object.fromEntries(envMap) }
           });
@@ -59027,7 +59607,7 @@ var require_pluggable_auth_handler = __commonJS({
               try {
                 const responseJson = JSON.parse(output);
                 const response = new executable_response_1.ExecutableResponse(responseJson);
-                return resolve38(response);
+                return resolve39(response);
               } catch (error) {
                 if (error instanceof executable_response_1.ExecutableResponseError) {
                   return reject(error);
@@ -59930,7 +60510,7 @@ var require_googleauth = __commonJS({
         }
       }
       fromStreamAsync(inputStream, options) {
-        return new Promise((resolve38, reject) => {
+        return new Promise((resolve39, reject) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the Google auth settings.");
           }
@@ -59940,7 +60520,7 @@ var require_googleauth = __commonJS({
               try {
                 const data = JSON.parse(chunks.join(""));
                 const r2 = this._cacheClientFromJSON(data, options);
-                return resolve38(r2);
+                return resolve39(r2);
               } catch (err) {
                 if (!this.keyFilename)
                   throw err;
@@ -59950,7 +60530,7 @@ var require_googleauth = __commonJS({
                 });
                 this.cachedCredential = client;
                 this.setGapicJWTValues(client);
-                return resolve38(client);
+                return resolve39(client);
               }
             } catch (err) {
               return reject(err);
@@ -59986,17 +60566,17 @@ var require_googleauth = __commonJS({
        * Run the Google Cloud SDK command that prints the default project ID
        */
       async getDefaultServiceProjectId() {
-        return new Promise((resolve38) => {
+        return new Promise((resolve39) => {
           (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;
-                resolve38(projectId);
+                resolve39(projectId);
                 return;
               } catch (e2) {
               }
             }
-            resolve38(null);
+            resolve39(null);
           });
         });
       }
@@ -67768,14 +68348,14 @@ function __asyncValues(o) {
   }, i2);
   function verb(n) {
     i2[n] = o[n] && function(v) {
-      return new Promise(function(resolve38, reject) {
-        v = o[n](v), settle(resolve38, reject, v.done, v.value);
+      return new Promise(function(resolve39, reject) {
+        v = o[n](v), settle(resolve39, reject, v.done, v.value);
       });
     };
   }
-  function settle(resolve38, reject, d, v) {
+  function settle(resolve39, reject, d, v) {
     Promise.resolve(v).then(function(v2) {
-      resolve38({ value: v2, done: d });
+      resolve39({ value: v2, done: d });
     }, reject);
   }
 }
@@ -78278,8 +78858,8 @@ var init_node4 = __esm({
         const url = `${websocketBaseUrl}/ws/google.ai.generativelanguage.${apiVersion}.GenerativeService.BidiGenerateMusic?key=${apiKey}`;
         let onopenResolve = () => {
         };
-        const onopenPromise = new Promise((resolve38) => {
-          onopenResolve = resolve38;
+        const onopenPromise = new Promise((resolve39) => {
+          onopenResolve = resolve39;
         });
         const callbacks = params.callbacks;
         const onopenAwaitedCallback = function() {
@@ -78485,8 +79065,8 @@ var init_node4 = __esm({
         }
         let onopenResolve = () => {
         };
-        const onopenPromise = new Promise((resolve38) => {
-          onopenResolve = resolve38;
+        const onopenPromise = new Promise((resolve39) => {
+          onopenResolve = resolve39;
         });
         const callbacks = params.callbacks;
         const onopenAwaitedCallback = function() {
@@ -80795,7 +81375,7 @@ var init_node4 = __esm({
         return void 0;
       }
     };
-    sleep$1 = (ms) => new Promise((resolve38) => setTimeout(resolve38, ms));
+    sleep$1 = (ms) => new Promise((resolve39) => setTimeout(resolve39, ms));
     FallbackEncoder = ({ headers, body }) => {
       return {
         bodyHeaders: {
@@ -81304,8 +81884,8 @@ ${underline2}`);
     };
     APIPromise = class _APIPromise extends Promise {
       constructor(client, responsePromise, parseResponse = defaultParseResponse) {
-        super((resolve38) => {
-          resolve38(null);
+        super((resolve39) => {
+          resolve39(null);
         });
         this.responsePromise = responsePromise;
         this.parseResponse = parseResponse;
@@ -82546,8 +83126,8 @@ ${underline2}`);
 });
 
 // src/capture/contentExtractor.ts
-import { readdirSync as readdirSync19, statSync as statSync20, readFileSync as readFileSync36 } from "fs";
-import { join as join52 } from "path";
+import { readdirSync as readdirSync19, statSync as statSync20, readFileSync as readFileSync37 } from "fs";
+import { join as join53 } from "path";
 async function detectLibraries(page, capturedShaders) {
   let detectedLibraries = [];
   try {
@@ -82667,7 +83247,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
   try {
     const { GoogleGenAI: GoogleGenAI2 } = await Promise.resolve().then(() => (init_node4(), node_exports));
     const ai = new GoogleGenAI2({ apiKey: geminiKey });
-    const imageFiles = readdirSync19(join52(outputDir, "assets")).filter(
+    const imageFiles = readdirSync19(join53(outputDir, "assets")).filter(
       (f3) => /\.(png|jpg|jpeg|webp|gif)$/i.test(f3)
     );
     const model = process.env.HYPERFRAMES_GEMINI_MODEL || "gemini-3.1-flash-lite-preview";
@@ -82676,10 +83256,10 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
       const batch = imageFiles.slice(i2, i2 + BATCH_SIZE);
       const results = await Promise.allSettled(
         batch.map(async (file) => {
-          const filePath = join52(outputDir, "assets", file);
+          const filePath = join53(outputDir, "assets", file);
           const stat3 = statSync20(filePath);
           if (stat3.size > 4e6) return { file, caption: "" };
-          const buffer = readFileSync36(filePath);
+          const buffer = readFileSync37(filePath);
           const base64 = buffer.toString("base64");
           const ext = file.split(".").pop()?.toLowerCase() || "png";
           const mimeType = ext === "jpg" ? "image/jpeg" : `image/${ext}`;
@@ -82725,11 +83305,11 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   const uncaptionedLines = [];
   const svgLines = [];
   const fontLines = [];
-  const assetsPath = join52(outputDir, "assets");
+  const assetsPath = join53(outputDir, "assets");
   try {
     for (const file of readdirSync19(assetsPath)) {
       if (file === "svgs" || file === "fonts" || file === "lottie" || file === "videos") continue;
-      const filePath = join52(assetsPath, file);
+      const filePath = join53(assetsPath, file);
       const stat3 = statSync20(filePath);
       if (!stat3.isFile()) continue;
       const sizeKb = Math.round(stat3.size / 1024);
@@ -82758,7 +83338,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   } catch {
   }
   try {
-    const svgsPath = join52(assetsPath, "svgs");
+    const svgsPath = join53(assetsPath, "svgs");
     for (const file of readdirSync19(svgsPath)) {
       if (!file.endsWith(".svg")) continue;
       const svgMatch = tokens.svgs.find(
@@ -82773,7 +83353,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   } catch {
   }
   try {
-    const fontsPath = join52(assetsPath, "fonts");
+    const fontsPath = join53(assetsPath, "fonts");
     for (const file of readdirSync19(fontsPath)) {
       fontLines.push(`fonts/${file} \u2014 font file`);
     }
@@ -82793,12 +83373,12 @@ __export(agentPromptGenerator_exports, {
   generateAgentPrompt: () => generateAgentPrompt
 });
 import { writeFileSync as writeFileSync21 } from "fs";
-import { join as join53 } from "path";
+import { join as join54 } from "path";
 function generateAgentPrompt(outputDir, url, tokens, _animations, hasScreenshot, hasLottie, hasShaders, _catalogedAssets, detectedLibraries) {
   const prompt = buildPrompt(url, tokens, hasScreenshot, hasLottie, hasShaders, detectedLibraries);
-  writeFileSync21(join53(outputDir, "AGENTS.md"), prompt, "utf-8");
-  writeFileSync21(join53(outputDir, "CLAUDE.md"), prompt, "utf-8");
-  writeFileSync21(join53(outputDir, ".cursorrules"), prompt, "utf-8");
+  writeFileSync21(join54(outputDir, "AGENTS.md"), prompt, "utf-8");
+  writeFileSync21(join54(outputDir, "CLAUDE.md"), prompt, "utf-8");
+  writeFileSync21(join54(outputDir, ".cursorrules"), prompt, "utf-8");
 }
 function buildPrompt(url, tokens, hasScreenshot, hasLottie, hasShaders, detectedLibraries) {
   const title = tokens.title || new URL(url).hostname.replace(/^www\./, "");
@@ -82865,15 +83445,15 @@ var init_agentPromptGenerator = __esm({
 });
 
 // src/capture/scaffolding.ts
-import { existsSync as existsSync50, writeFileSync as writeFileSync22, readFileSync as readFileSync37 } from "fs";
-import { join as join54, resolve as resolve36 } from "path";
+import { existsSync as existsSync51, writeFileSync as writeFileSync22, readFileSync as readFileSync38 } from "fs";
+import { join as join55, resolve as resolve37 } from "path";
 function loadEnvFile(startDir) {
   try {
-    let dir = resolve36(startDir);
+    let dir = resolve37(startDir);
     for (let i2 = 0; i2 < 5; i2++) {
-      const envPath = resolve36(dir, ".env");
+      const envPath = resolve37(dir, ".env");
       try {
-        const envContent = readFileSync37(envPath, "utf-8");
+        const envContent = readFileSync38(envPath, "utf-8");
         for (const line of envContent.split("\n")) {
           const trimmed = line.trim();
           if (!trimmed || trimmed.startsWith("#")) continue;
@@ -82885,15 +83465,15 @@ function loadEnvFile(startDir) {
         }
         break;
       } catch {
-        dir = resolve36(dir, "..");
+        dir = resolve37(dir, "..");
       }
     }
   } catch {
   }
 }
 async function generateProjectScaffold(outputDir, url, tokens, animationCatalog, hasScreenshots, hasLotties, hasShaders, catalogedAssets, progress, warnings, detectedLibraries) {
-  const metaPath = join54(outputDir, "meta.json");
-  if (!existsSync50(metaPath)) {
+  const metaPath = join55(outputDir, "meta.json");
+  if (!existsSync51(metaPath)) {
     const hostname = new URL(url).hostname.replace(/^www\./, "");
     writeFileSync22(
       metaPath,
@@ -82931,9 +83511,9 @@ __export(screenshotCapture_exports, {
   captureScrollScreenshots: () => captureScrollScreenshots
 });
 import { writeFileSync as writeFileSync23, mkdirSync as mkdirSync28 } from "fs";
-import { join as join55 } from "path";
+import { join as join56 } from "path";
 async function captureScrollScreenshots(page, outputDir) {
-  const screenshotsDir = join55(outputDir, "screenshots");
+  const screenshotsDir = join56(outputDir, "screenshots");
   mkdirSync28(screenshotsDir, { recursive: true });
   const MAX_SCREENSHOTS = 20;
   const filePaths = [];
@@ -82967,7 +83547,7 @@ async function captureScrollScreenshots(page, outputDir) {
         finalPositions[i2] / Math.max(1, scrollHeight - viewportHeight) * 100
       );
       const filename = `scroll-${String(Math.min(pct, 100)).padStart(3, "0")}.png`;
-      const filePath = join55(screenshotsDir, filename);
+      const filePath = join56(screenshotsDir, filename);
       const buffer = await page.screenshot({ type: "png" });
       writeFileSync23(filePath, buffer);
       filePaths.push(`screenshots/${filename}`);
@@ -83280,8 +83860,8 @@ var capture_exports = {};
 __export(capture_exports, {
   captureWebsite: () => captureWebsite
 });
-import { mkdirSync as mkdirSync29, writeFileSync as writeFileSync24, existsSync as existsSync51 } from "fs";
-import { join as join56 } from "path";
+import { mkdirSync as mkdirSync29, writeFileSync as writeFileSync24, existsSync as existsSync52 } from "fs";
+import { join as join57 } from "path";
 async function captureWebsite(opts, onProgress) {
   const {
     url,
@@ -83298,9 +83878,9 @@ async function captureWebsite(opts, onProgress) {
     onProgress?.(stage, detail);
   };
   loadEnvFile(outputDir);
-  mkdirSync29(join56(outputDir, "extracted"), { recursive: true });
-  mkdirSync29(join56(outputDir, "screenshots"), { recursive: true });
-  mkdirSync29(join56(outputDir, "assets"), { recursive: true });
+  mkdirSync29(join57(outputDir, "extracted"), { recursive: true });
+  mkdirSync29(join57(outputDir, "screenshots"), { recursive: true });
+  mkdirSync29(join57(outputDir, "assets"), { recursive: true });
   progress("browser", "Launching headless Chrome...");
   const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
   const browser = await ensureBrowser2();
@@ -83456,7 +84036,7 @@ async function captureWebsite(opts, onProgress) {
     } catch {
     }
     if (discoveredLotties.length > 0) {
-      const lottieDir = join56(outputDir, "assets", "lottie");
+      const lottieDir = join57(outputDir, "assets", "lottie");
       mkdirSync29(lottieDir, { recursive: true });
       const savedCount = await saveLottieAnimations(discoveredLotties, lottieDir);
       if (savedCount > 0) {
@@ -83476,7 +84056,7 @@ async function captureWebsite(opts, onProgress) {
         });
         capturedShaders = unique;
         writeFileSync24(
-          join56(outputDir, "extracted", "shaders.json"),
+          join57(outputDir, "extracted", "shaders.json"),
           JSON.stringify(unique, null, 2),
           "utf-8"
         );
@@ -83487,7 +84067,7 @@ async function captureWebsite(opts, onProgress) {
     progress("tokens", "Extracting design tokens...");
     const tokens = await extractTokens(page1);
     writeFileSync24(
-      join56(outputDir, "extracted", "tokens.json"),
+      join57(outputDir, "extracted", "tokens.json"),
       JSON.stringify(tokens, null, 2),
       "utf-8"
     );
@@ -83561,7 +84141,7 @@ async function captureWebsite(opts, onProgress) {
         representativeAnimations: representativeAnims
       };
       writeFileSync24(
-        join56(outputDir, "extracted", "animations.json"),
+        join57(outputDir, "extracted", "animations.json"),
         JSON.stringify(leanCatalog, null, 2),
         "utf-8"
       );
@@ -83572,18 +84152,18 @@ async function captureWebsite(opts, onProgress) {
       assets = await downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks);
     }
     if (visibleTextContent) {
-      writeFileSync24(join56(outputDir, "extracted", "visible-text.txt"), visibleTextContent, "utf-8");
+      writeFileSync24(join57(outputDir, "extracted", "visible-text.txt"), visibleTextContent, "utf-8");
     }
     if (catalogedAssets.length > 0) {
       writeFileSync24(
-        join56(outputDir, "extracted", "assets-catalog.json"),
+        join57(outputDir, "extracted", "assets-catalog.json"),
         JSON.stringify(catalogedAssets, null, 2),
         "utf-8"
       );
     }
     if (detectedLibraries.length > 0) {
       writeFileSync24(
-        join56(outputDir, "extracted", "detected-libraries.json"),
+        join57(outputDir, "extracted", "detected-libraries.json"),
         JSON.stringify(detectedLibraries, null, 2),
         "utf-8"
       );
@@ -83594,7 +84174,7 @@ async function captureWebsite(opts, onProgress) {
       const lines = generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCaptions);
       if (lines.length > 0) {
         writeFileSync24(
-          join56(outputDir, "extracted", "asset-descriptions.md"),
+          join57(outputDir, "extracted", "asset-descriptions.md"),
           "# Asset Descriptions\n\nOne line per file. Read this instead of opening every image individually.\n\n" + lines.map((l) => "- " + l).join("\n") + "\n",
           "utf-8"
         );
@@ -83610,7 +84190,7 @@ async function captureWebsite(opts, onProgress) {
       animationCatalog,
       screenshots.length > 0,
       discoveredLotties.length > 0,
-      existsSync51(join56(outputDir, "extracted", "shaders.json")),
+      existsSync52(join57(outputDir, "extracted", "shaders.json")),
       catalogedAssets,
       progress,
       warnings,
@@ -83650,15 +84230,15 @@ var init_capture = __esm({
 var capture_exports2 = {};
 __export(capture_exports2, {
   default: () => capture_default,
-  examples: () => examples20
+  examples: () => examples22
 });
-import { resolve as resolve37 } from "path";
-var examples20, capture_default;
+import { resolve as resolve38 } from "path";
+var examples22, capture_default;
 var init_capture2 = __esm({
   "src/commands/capture.ts"() {
     "use strict";
     init_dist();
-    examples20 = [
+    examples22 = [
       ["Capture a website", "hyperframes capture https://stripe.com"],
       ["Capture to a specific directory", "hyperframes capture https://linear.app -o linear-video"],
       ["JSON output for AI agents", "hyperframes capture https://example.com --json"]
@@ -83711,7 +84291,7 @@ var init_capture2 = __esm({
           const hostname = new URL(url).hostname.replace(/^www\./, "");
           outputName = `captures/${hostname.replace(/\./g, "-")}`;
         }
-        const outputDir = resolve37(outputName);
+        const outputDir = resolve38(outputName);
         const isJson = args.json;
         if (!isJson) {
           const { c: c2 } = await Promise.resolve().then(() => (init_colors(), colors_exports));
@@ -83959,7 +84539,7 @@ __export(autoUpdate_exports, {
 import { spawn as spawn12 } from "child_process";
 import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync30, openSync } from "fs";
 import { homedir as homedir10 } from "os";
-import { join as join57 } from "path";
+import { join as join58 } from "path";
 import { compareVersions as compareVersions2 } from "compare-versions";
 function isAutoInstallDisabled() {
   if (isDevMode()) return true;
@@ -83982,7 +84562,7 @@ function log(line) {
 }
 function launchDetachedInstall(installCommand, version) {
   mkdirSync30(CONFIG_DIR2, { recursive: true, mode: 448 });
-  const configFile = join57(CONFIG_DIR2, "config.json");
+  const configFile = join58(CONFIG_DIR2, "config.json");
   const nodeScript = `
     const { exec } = require("node:child_process");
     const { readFileSync, renameSync, writeFileSync } = require("node:fs");
@@ -84101,18 +84681,31 @@ var init_autoUpdate = __esm({
     init_config();
     init_env();
     init_installerDetection();
-    CONFIG_DIR2 = join57(homedir10(), ".hyperframes");
-    LOG_FILE = join57(CONFIG_DIR2, "auto-update.log");
+    CONFIG_DIR2 = join58(homedir10(), ".hyperframes");
+    LOG_FILE = join58(CONFIG_DIR2, "auto-update.log");
     PENDING_TIMEOUT_MS = 10 * 60 * 1e3;
   }
 });
 
+// src/commands/layout-audit.browser.js
+var layout_audit_browser_exports = {};
+__export(layout_audit_browser_exports, {
+  default: () => layout_audit_browser_default
+});
+var layout_audit_browser_default;
+var init_layout_audit_browser = __esm({
+  "src/commands/layout-audit.browser.js"() {
+    layout_audit_browser_default = '(function () {\n  const IGNORE_TAGS = new Set(["SCRIPT", "STYLE", "TEMPLATE", "NOSCRIPT", "META", "LINK"]);\n\n  function toRect(rect) {\n    return {\n      left: round(rect.left),\n      top: round(rect.top),\n      right: round(rect.right),\n      bottom: round(rect.bottom),\n      width: round(rect.width),\n      height: round(rect.height),\n    };\n  }\n\n  function rectFromOrigin(left, top, width, height) {\n    return {\n      left: round(left),\n      top: round(top),\n      right: round(left + width),\n      bottom: round(top + height),\n      width: round(width),\n      height: round(height),\n    };\n  }\n\n  function round(value) {\n    return Math.round(value * 100) / 100;\n  }\n\n  function overflowFor(subject, container, tolerance) {\n    const overflow = {};\n    if (subject.left < container.left - tolerance)\n      overflow.left = round(container.left - subject.left);\n    if (subject.right > container.right + tolerance)\n      overflow.right = round(subject.right - container.right);\n    if (subject.top < container.top - tolerance) overflow.top = round(container.top - subject.top);\n    if (subject.bottom > container.bottom + tolerance)\n      overflow.bottom = round(subject.bottom - container.bottom);\n    return Object.keys(overflow).length > 0 ? overflow : null;\n  }\n\n  function escapeCss(value) {\n    if (window.CSS && typeof window.CSS.escape === "function") return window.CSS.escape(value);\n    return value.replace(/[^a-zA-Z0-9_-]/g, "\\\\$&");\n  }\n\n  function escapeAttr(value) {\n    return value.replace(/\\\\/g, "\\\\\\\\").replace(/"/g, \'\\\\"\');\n  }\n\n  function selectorFor(element) {\n    if (element.id) return `#${escapeCss(element.id)}`;\n    const dataName =\n      element.getAttribute("data-layout-name") ||\n      element.getAttribute("data-composition-id") ||\n      element.getAttribute("data-start");\n    if (dataName) {\n      const attr = element.hasAttribute("data-layout-name")\n        ? "data-layout-name"\n        : element.hasAttribute("data-composition-id")\n          ? "data-composition-id"\n          : "data-start";\n      const attrSelector = `[${attr}="${escapeAttr(dataName)}"]`;\n      if (document.querySelectorAll(attrSelector).length === 1) return attrSelector;\n      return `${element.tagName.toLowerCase()}${attrSelector}`;\n    }\n    const classes = Array.from(element.classList).slice(0, 2);\n    if (classes.length > 0) {\n      return `${element.tagName.toLowerCase()}.${classes.map(escapeCss).join(".")}`;\n    }\n    const parent = element.parentElement;\n    if (!parent) return element.tagName.toLowerCase();\n    const siblings = Array.from(parent.children).filter(\n      (child) => child.tagName === element.tagName,\n    );\n    const index = siblings.indexOf(element) + 1;\n    return `${selectorFor(parent)} > ${element.tagName.toLowerCase()}:nth-of-type(${index})`;\n  }\n\n  function hasIgnoreFlag(element) {\n    return !!element.closest("[data-layout-ignore], [data-layout-check=\'ignore\']");\n  }\n\n  function hasAllowOverflowFlag(element) {\n    return !!element.closest("[data-layout-allow-overflow]");\n  }\n\n  function opacityChain(element) {\n    let opacity = 1;\n    for (let current = element; current; current = current.parentElement) {\n      const parsed = Number.parseFloat(getComputedStyle(current).opacity || "1");\n      if (Number.isFinite(parsed)) opacity *= parsed;\n    }\n    return opacity;\n  }\n\n  function isVisibleElement(element) {\n    if (IGNORE_TAGS.has(element.tagName)) return false;\n    if (hasIgnoreFlag(element)) return false;\n    const style = getComputedStyle(element);\n    if (\n      style.display === "none" ||\n      style.visibility === "hidden" ||\n      style.visibility === "collapse"\n    ) {\n      return false;\n    }\n    if (opacityChain(element) < 0.2) return false;\n    const rect = element.getBoundingClientRect();\n    return rect.width > 0.5 && rect.height > 0.5;\n  }\n\n  function textContentFor(element) {\n    return (element.innerText || element.textContent || "").replace(/\\s+/g, " ").trim();\n  }\n\n  function hasOwnTextCandidate(element) {\n    const text = textContentFor(element);\n    if (!text) return false;\n    for (const child of Array.from(element.children)) {\n      if (isVisibleElement(child) && textContentFor(child)) return false;\n    }\n    return true;\n  }\n\n  function textRectFor(element) {\n    const range = document.createRange();\n    range.selectNodeContents(element);\n    const rects = Array.from(range.getClientRects()).filter(\n      (rect) => rect.width > 0.5 && rect.height > 0.5,\n    );\n    range.detach();\n    if (rects.length === 0) return null;\n\n    const union = rects.reduce(\n      (acc, rect) => ({\n        left: Math.min(acc.left, rect.left),\n        top: Math.min(acc.top, rect.top),\n        right: Math.max(acc.right, rect.right),\n        bottom: Math.max(acc.bottom, rect.bottom),\n      }),\n      {\n        left: Number.POSITIVE_INFINITY,\n        top: Number.POSITIVE_INFINITY,\n        right: Number.NEGATIVE_INFINITY,\n        bottom: Number.NEGATIVE_INFINITY,\n      },\n    );\n\n    return toRect({\n      ...union,\n      width: union.right - union.left,\n      height: union.bottom - union.top,\n    });\n  }\n\n  function parsePx(value) {\n    const parsed = Number.parseFloat(value);\n    return Number.isFinite(parsed) ? parsed : 0;\n  }\n\n  function hasMeaningfulBoxStyle(style) {\n    return (\n      parsePx(style.paddingTop) +\n        parsePx(style.paddingRight) +\n        parsePx(style.paddingBottom) +\n        parsePx(style.paddingLeft) +\n        parsePx(style.borderTopWidth) +\n        parsePx(style.borderRightWidth) +\n        parsePx(style.borderBottomWidth) +\n        parsePx(style.borderLeftWidth) +\n        parsePx(style.borderTopLeftRadius) +\n        parsePx(style.borderTopRightRadius) +\n        parsePx(style.borderBottomRightRadius) +\n        parsePx(style.borderBottomLeftRadius) >\n      0\n    );\n  }\n\n  function hasPaint(style) {\n    const backgroundColor = style.backgroundColor || "";\n    const hasBackground =\n      backgroundColor !== "" &&\n      backgroundColor !== "transparent" &&\n      !backgroundColor.endsWith(", 0)") &&\n      backgroundColor !== "rgba(0, 0, 0, 0)";\n    const hasImage = style.backgroundImage && style.backgroundImage !== "none";\n    const hasBorder =\n      parsePx(style.borderTopWidth) +\n        parsePx(style.borderRightWidth) +\n        parsePx(style.borderBottomWidth) +\n        parsePx(style.borderLeftWidth) >\n      0;\n    const hasRadius =\n      parsePx(style.borderTopLeftRadius) +\n        parsePx(style.borderTopRightRadius) +\n        parsePx(style.borderBottomRightRadius) +\n        parsePx(style.borderBottomLeftRadius) >\n      0;\n    return hasBackground || hasImage || hasBorder || hasRadius;\n  }\n\n  function clipsOverflow(style) {\n    return [style.overflowX, style.overflowY, style.overflow].some(\n      (value) => value && value !== "visible" && value !== "clip visible",\n    );\n  }\n\n  function rootRectFor(root) {\n    const measured = toRect(root.getBoundingClientRect());\n    const authoredWidth = Number.parseFloat(root.getAttribute("data-width") || "");\n    const authoredHeight = Number.parseFloat(root.getAttribute("data-height") || "");\n    const hasAuthoredSize =\n      Number.isFinite(authoredWidth) &&\n      authoredWidth > 0 &&\n      Number.isFinite(authoredHeight) &&\n      authoredHeight > 0;\n\n    if (!hasAuthoredSize) return measured;\n    if (measured.width > 0.5 && measured.height > 0.5) return measured;\n    return rectFromOrigin(measured.left, measured.top, authoredWidth, authoredHeight);\n  }\n\n  function isConstraintCandidate(element, root, rootRect) {\n    if (element === root) return true;\n    const style = getComputedStyle(element);\n    if (clipsOverflow(style)) return true;\n    if (element.hasAttribute("data-layout-boundary")) return true;\n    if (!hasPaint(style)) return false;\n    if (!hasMeaningfulBoxStyle(style)) return false;\n    const rect = element.getBoundingClientRect();\n    const rootArea = rootRect.width * rootRect.height;\n    const area = rect.width * rect.height;\n    return area > 0 && area < rootArea * 0.95;\n  }\n\n  function nearestConstraint(element, root, rootRect) {\n    for (\n      let current = element;\n      current && current !== document.body;\n      current = current.parentElement\n    ) {\n      if (!isVisibleElement(current)) continue;\n      if (isConstraintCandidate(current, root, rootRect)) return current;\n      if (current === root) return current;\n    }\n    return root;\n  }\n\n  function formatPx(value) {\n    return `${Math.round(value)}px`;\n  }\n\n  function maxOverflow(overflow) {\n    return Math.max(...Object.values(overflow).filter((value) => typeof value === "number"));\n  }\n\n  function textOverflowFixHint(textRect, containerRect, overflow, fontSize, targetName) {\n    const horizontalOverflow = (overflow.left || 0) + (overflow.right || 0);\n    const verticalOverflow = (overflow.top || 0) + (overflow.bottom || 0);\n    const neededWidth = containerRect.width + horizontalOverflow;\n    const neededHeight = containerRect.height + verticalOverflow;\n    const widthRatio = containerRect.width > 0 ? containerRect.width / textRect.width : 0;\n    const heightRatio = containerRect.height > 0 ? containerRect.height / textRect.height : 0;\n    const limitingRatio = Math.min(\n      widthRatio > 0 ? widthRatio : Number.POSITIVE_INFINITY,\n      heightRatio > 0 ? heightRatio : Number.POSITIVE_INFINITY,\n    );\n    const shrinkPercent =\n      Number.isFinite(limitingRatio) && limitingRatio < 1\n        ? Math.ceil((1 - limitingRatio) * 100)\n        : 0;\n    const targetFont =\n      shrinkPercent > 0 && Number.isFinite(fontSize) && fontSize > 0\n        ? ` or shrink font-size from ${formatPx(fontSize)} to ~${formatPx(fontSize * limitingRatio)}`\n        : "";\n    const sizeTarget =\n      horizontalOverflow > 0 && verticalOverflow > 0\n        ? `resize ${targetName} to at least ~${formatPx(neededWidth)} x ${formatPx(neededHeight)}`\n        : horizontalOverflow > 0\n          ? `widen ${targetName} to at least ~${formatPx(neededWidth)}`\n          : `increase ${targetName} height to at least ~${formatPx(neededHeight)}`;\n\n    return `Text is ${formatPx(textRect.width)} x ${formatPx(textRect.height)} inside ${formatPx(containerRect.width)} x ${formatPx(containerRect.height)} and overflows by up to ${formatPx(maxOverflow(overflow))}; ${sizeTarget}${targetFont}, or allow wrapping with max-width/fitTextFontSize.`;\n  }\n\n  function clippedTextIssue(element, time, tolerance) {\n    const style = getComputedStyle(element);\n    if (!clipsOverflow(style)) return null;\n    const overflowX = element.scrollWidth - element.clientWidth;\n    const overflowY = element.scrollHeight - element.clientHeight;\n    if (overflowX <= tolerance && overflowY <= tolerance) return null;\n    const overflow = {};\n    if (overflowX > tolerance) overflow.right = round(overflowX);\n    if (overflowY > tolerance) overflow.bottom = round(overflowY);\n    const selector = selectorFor(element);\n    const text = textContentFor(element);\n    const rect = toRect(element.getBoundingClientRect());\n    const fontSize = parsePx(style.fontSize);\n    return {\n      code: "clipped_text",\n      severity: "error",\n      time,\n      selector,\n      text,\n      message: "Text content is clipped by its own box.",\n      rect,\n      overflow,\n      fixHint: textOverflowFixHint(rect, rect, overflow, fontSize, "the text box"),\n    };\n  }\n\n  function textOverflowIssues(element, root, rootRect, time, tolerance) {\n    const textRect = textRectFor(element);\n    if (!textRect) return [];\n    const text = textContentFor(element);\n    const selector = selectorFor(element);\n    const issues = [];\n\n    const container = nearestConstraint(element, root, rootRect);\n    const containerRect = container === root ? rootRect : toRect(container.getBoundingClientRect());\n    const containerOverflow = overflowFor(textRect, containerRect, tolerance);\n    if (containerOverflow && !hasAllowOverflowFlag(element)) {\n      const style = getComputedStyle(element);\n      issues.push({\n        code: "text_box_overflow",\n        severity: "error",\n        time,\n        selector,\n        containerSelector: selectorFor(container),\n        text,\n        message: "Text extends outside its nearest visual/container box.",\n        rect: textRect,\n        containerRect,\n        overflow: containerOverflow,\n        fixHint: textOverflowFixHint(\n          textRect,\n          containerRect,\n          containerOverflow,\n          parsePx(style.fontSize),\n          "the container",\n        ),\n      });\n    }\n\n    const canvasOverflow = overflowFor(textRect, rootRect, tolerance);\n    if (canvasOverflow && !hasAllowOverflowFlag(element)) {\n      issues.push({\n        code: "canvas_overflow",\n        severity: "info",\n        time,\n        selector,\n        containerSelector: selectorFor(root),\n        text,\n        message: "Text extends outside the composition canvas.",\n        rect: textRect,\n        containerRect: rootRect,\n        overflow: canvasOverflow,\n        fixHint:\n          "Move the text inward, reduce its size, or mark intentional off-canvas animation with data-layout-allow-overflow.",\n      });\n    }\n\n    return issues;\n  }\n\n  function containerOverflowIssues(root, time, tolerance) {\n    const issues = [];\n    const containers = Array.from(root.querySelectorAll("*")).filter((element) => {\n      if (!isVisibleElement(element) || hasAllowOverflowFlag(element)) return false;\n      const style = getComputedStyle(element);\n      return clipsOverflow(style) || element.hasAttribute("data-layout-boundary");\n    });\n\n    for (const container of containers) {\n      const containerRect = toRect(container.getBoundingClientRect());\n      for (const child of Array.from(container.children)) {\n        if (!isVisibleElement(child) || hasAllowOverflowFlag(child)) continue;\n        const childRect = toRect(child.getBoundingClientRect());\n        const overflow = overflowFor(childRect, containerRect, tolerance);\n        if (!overflow) continue;\n        issues.push({\n          code: "container_overflow",\n          severity: "warning",\n          time,\n          selector: selectorFor(child),\n          containerSelector: selectorFor(container),\n          message: "Element extends outside a clipping layout container.",\n          rect: childRect,\n          containerRect,\n          overflow,\n          fixHint:\n            "Resize/reposition the child or container, or mark intentional overflow with data-layout-allow-overflow.",\n        });\n      }\n    }\n\n    return issues;\n  }\n\n  window.__hyperframesLayoutAudit = function auditLayout(options) {\n    const time = options && typeof options.time === "number" ? options.time : 0;\n    const tolerance =\n      options && typeof options.tolerance === "number" ? Math.max(0, options.tolerance) : 2;\n    const root =\n      document.querySelector("[data-composition-id][data-width][data-height]") ||\n      document.querySelector("[data-composition-id]") ||\n      document.body;\n    const rootRect = rootRectFor(root);\n    const elements = Array.from(root.querySelectorAll("*")).filter(isVisibleElement);\n    const issues = [];\n\n    for (const element of elements) {\n      if (!hasOwnTextCandidate(element)) continue;\n      const clipped = clippedTextIssue(element, time, tolerance);\n      if (clipped) issues.push(clipped);\n      issues.push(...textOverflowIssues(element, root, rootRect, time, tolerance));\n    }\n\n    issues.push(...containerOverflowIssues(root, time, tolerance));\n    return issues;\n  };\n})();\n';
+  }
+});
+
 // import("./commands/**/*.js") in src/help.ts
 var globImport_commands_js;
 var init_ = __esm({
   'import("./commands/**/*.js") in src/help.ts'() {
     globImport_commands_js = __glob({
-      "./commands/contrast-audit.browser.js": () => Promise.resolve().then(() => (init_contrast_audit_browser(), contrast_audit_browser_exports))
+      "./commands/contrast-audit.browser.js": () => Promise.resolve().then(() => (init_contrast_audit_browser(), contrast_audit_browser_exports)),
+      "./commands/layout-audit.browser.js": () => Promise.resolve().then(() => (init_layout_audit_browser(), layout_audit_browser_exports))
     });
   }
 });
@@ -84155,10 +84748,10 @@ function renderRootHelp() {
   lines.push(`Run ${c.cyan("hyperframes <command> --help")} for more information about a command.`);
   return lines.join("\n");
 }
-function formatExamples(examples21) {
+function formatExamples(examples23) {
   const lines = [];
   lines.push(c.bold("Examples:"));
-  for (const [comment, command2] of examples21) {
+  for (const [comment, command2] of examples23) {
     lines.push(`  ${c.gray(`# ${comment}`)}`);
     lines.push(`  ${command2}`);
     lines.push("");
@@ -84175,9 +84768,9 @@ async function showUsage2(cmd, parent) {
   console.log(usage + "\n");
   const name = meta?.name;
   if (name) {
-    const examples21 = STATIC_EXAMPLES[name] ?? await loadExamples(name);
-    if (examples21) {
-      console.log(formatExamples(examples21) + "\n");
+    const examples23 = STATIC_EXAMPLES[name] ?? await loadExamples(name);
+    if (examples23) {
+      console.log(formatExamples(examples23) + "\n");
     }
   }
 }
@@ -84206,6 +84799,7 @@ var init_help = __esm({
         title: "Project",
         commands: [
           ["lint", "Validate a composition for common mistakes"],
+          ["inspect", "Inspect rendered visual layout across the timeline"],
           ["snapshot", "Capture key frames as PNG screenshots for visual verification"],
           ["info", "Print project metadata"],
           ["compositions", "List all compositions in a project"],
@@ -84247,6 +84841,7 @@ var init_help = __esm({
       ["Render to MP4", "hyperframes render -o out.mp4"],
       ["Transparent WebM overlay", "hyperframes render --format webm -o out.webm"],
       ["Validate your composition", "hyperframes lint"],
+      ["Inspect visual layout", "hyperframes inspect"],
       ["Check system dependencies", "hyperframes doctor"]
     ];
     STATIC_EXAMPLES = {
@@ -84272,6 +84867,8 @@ var subCommands = {
   publish: () => Promise.resolve().then(() => (init_publish(), publish_exports)).then((m2) => m2.default),
   render: () => Promise.resolve().then(() => (init_render2(), render_exports)).then((m2) => m2.default),
   lint: () => Promise.resolve().then(() => (init_lint3(), lint_exports2)).then((m2) => m2.default),
+  inspect: () => Promise.resolve().then(() => (init_inspect(), inspect_exports)).then((m2) => m2.default),
+  layout: () => Promise.resolve().then(() => (init_layout2(), layout_exports)).then((m2) => m2.default),
   info: () => Promise.resolve().then(() => (init_info(), info_exports)).then((m2) => m2.default),
   compositions: () => Promise.resolve().then(() => (init_compositions(), compositions_exports)).then((m2) => m2.default),
   benchmark: () => Promise.resolve().then(() => (init_benchmark(), benchmark_exports)).then((m2) => m2.default),