hyperframes 0.7.26 → 0.7.27

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.7.26" : "0.0.0-dev";
+    VERSION = true ? "0.7.27" : "0.0.0-dev";
   }
 });
 
@@ -60925,7 +60925,7 @@ function formatHttpErrorDiagnostic(input2) {
   return `[Browser:HTTP${input2.status}] ${input2.method} ${sanitizeDiagnosticUrl(input2.url)} resource=${input2.resourceType}${statusText}`;
 }
 async function driveWarmupTicks(options, state) {
-  const sleep3 = options.sleep ?? realSleep;
+  const sleep5 = options.sleep ?? realSleep;
   while (true) {
     if (options.lockWarmupTicks) {
       if (state.ticks >= LOCKED_WARMUP_TICKS) return;
@@ -60937,7 +60937,7 @@ async function driveWarmupTicks(options, state) {
       state.ticks += 1;
     } catch {
     }
-    await sleep3(options.intervalMs);
+    await sleep5(options.intervalMs);
   }
 }
 function resolveCaptureSessionOptions(options, browserVersion, platform10 = process.platform) {
@@ -62729,7 +62729,7 @@ import { join as join6, dirname as dirname4, extname as extname2 } from "path";
 function appendEncodeTimeoutMessage(error, timedOut, timeoutMs) {
   if (!timedOut) return error;
   return `${error}
-FFmpeg killed after exceeding ffmpegEncodeTimeout (${timeoutMs} ms)`;
+FFmpeg killed after exceeding ffmpegEncodeTimeout (${timeoutMs} ms). Long or high-frame-count renders may need more time: set FFMPEG_ENCODE_TIMEOUT_MS to a higher value (ms), or set PRODUCER_ENABLE_CHUNKED_ENCODE=true to encode in smaller chunks instead of one long-running ffmpeg process.`;
 }
 function isAacSidecar(audioPath) {
   return extname2(audioPath).toLowerCase() === ".aac";
@@ -66304,8 +66304,15 @@ function findRootTag(source) {
   const bodyEnd = bodyOpenMatch && bodyCloseMatch && bodyCloseMatch.index > bodyStart ? bodyCloseMatch.index : source.length;
   const bodyContent = bodyOpenMatch ? source.slice(bodyStart, bodyEnd) : source;
   const bodyTags = extractOpenTags(bodyContent);
+  let skipBefore = -1;
   for (const tag of bodyTags) {
+    if (tag.index < skipBefore) continue;
     if (["script", "style", "meta", "link", "title"].includes(tag.name)) continue;
+    if (tag.name === "svg" && !readAttr(tag.raw, "data-composition-id") && !readAttr(tag.raw, "data-width") && !readAttr(tag.raw, "data-height")) {
+      const closeMatch = /<\/svg\s*>/i.exec(bodyContent.slice(tag.index));
+      skipBefore = closeMatch ? tag.index + closeMatch.index + closeMatch[0].length : Infinity;
+      continue;
+    }
     return { ...tag, index: tag.index + bodyStart };
   }
   return null;
@@ -67974,7 +67981,7 @@ var init_dist4 = __esm({
     TIMELINE_REGISTRY_INIT_PATTERN = /window\.__timelines\s*=\s*window\.__timelines\s*\|\|\s*\{\}|window\.__timelines\s*=\s*\{\}|window\.__timelines\s*\?\?=\s*\{\}/i;
     TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN = /window\.__timelines\s*=\s*\{\s*(?:["'][^"']+["']|[A-Za-z_$][\w$]*)\s*:/i;
     TIMELINE_REGISTRY_ASSIGN_PATTERN = /window\.__timelines(?:\[[^\]]+\]|\.[A-Za-z_$][\w$]*)\s*=/i;
-    WINDOW_TIMELINE_ASSIGN_PATTERN = /window\.__timelines(?:\[\s*["']([^"']+)["']\s*\]|\.\s*([A-Za-z_$][\w$]*))\s*=\s*([A-Za-z_$][\w$]*)/i;
+    WINDOW_TIMELINE_ASSIGN_PATTERN = /window\.__timelines(?:\[\s*(?:["']([^"']+)["']|[A-Za-z_$][\w$.]*)\s*\]|\.\s*([A-Za-z_$][\w$]*))\s*=\s*([A-Za-z_$][\w$]*)/i;
     INVALID_SCRIPT_CLOSE_PATTERN = /<script[^>]*>[\s\S]*?<\s*\/\s*script(?!>)/i;
     TIMELINE_REGISTRY_KEY_PATTERN = /window\.__timelines(?:\[\s*["']([^"']+)["']\s*\]|\.\s*([A-Za-z_$][\w$]*))\s*=/g;
     TIMELINE_REGISTRY_OBJECT_BODY_PATTERN = /window\.__timelines\s*=\s*\{([\s\S]*?)\}/i;
@@ -68708,12 +68715,14 @@ ${right.raw}`)
                 (candidate) => isHardKillSet(candidate, win.targetSelector, boundary)
               );
               if (hasHardKill) continue;
+              const exitClipInfo = clipIds.get(win.targetSelector) || clipClasses.get(win.targetSelector);
+              const fixHint = exitClipInfo ? `"${win.targetSelector}" is a clip element \u2014 the framework already manages its visibility. Wrap the scene's content in an inner non-clip <div>, move the exit tween and the hard kill (\`tl.set("<inner-selector>", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\`) onto that wrapper instead.` : `Add \`tl.set("${win.targetSelector}", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\` after the exit tween.`;
               findings.push({
                 code: "gsap_exit_missing_hard_kill",
                 severity: "error",
                 message: `GSAP exit on "${win.targetSelector}" ends at the ${boundary.toFixed(2)}s clip start boundary without a matching tl.set hard kill. Non-linear seeking can land after the fade and leave stale visibility state.`,
                 selector: win.targetSelector,
-                fixHint: `Add \`tl.set("${win.targetSelector}", ${hiddenStateLiteral(win.propertyValues)}, ${boundary.toFixed(2)})\` after the exit tween.`,
+                fixHint,
                 snippet: truncateSnippet(win.raw)
               });
             }
@@ -68983,12 +68992,15 @@ ${right.raw}`)
             const killPattern = new RegExp(`["']#${id}["'][^)]*visibility\\s*:\\s*["']hidden["']`);
             const hasKill = killPattern.test(content);
             if (!hasKill) {
+              const classes = (readAttr(tag.raw, "class") || "").split(/\s+/).filter(Boolean);
+              const isClip = classes.includes("clip");
+              const fixHint = isClip ? `"#${id}" is a clip element \u2014 the framework already manages its visibility. Wrap the scene's content in an inner non-clip <div>, move the exit tween and the hard kill (\`tl.set("<inner-selector>", { visibility: "hidden" }, <exit-end-time>)\`) onto that wrapper instead.` : `Add \`tl.set("#${id}", { visibility: "hidden" }, <exit-end-time>)\` after the scene's exit tweens.`;
               findings.push({
                 code: "scene_layer_missing_visibility_kill",
                 severity: "error",
                 elementId: id,
                 message: `Scene layer "#${id}" exits via opacity tween but has no visibility: hidden hard kill. When scrubbing or when tweens conflict, the scene may remain partially visible and overlap the next scene.`,
-                fixHint: `Add \`tl.set("#${id}", { visibility: "hidden" }, <exit-end-time>)\` after the scene's exit tweens.`
+                fixHint
               });
             }
           }
@@ -70089,7 +70101,7 @@ ${allInlineStyles}`.replace(/\/\*[\s\S]*?\*\//g, "");
           code: "font_family_without_font_face",
           severity: "error",
           message: `Font ${undeclared.length === 1 ? "family" : "families"} used without @font-face declaration: ${undeclared.join(", ")}. These are not in the auto-resolved font list, so the renderer cannot supply them automatically. Text will fall back to a generic font, producing incorrect typography in the video.`,
-          fixHint: "Add @font-face { font-family: '...'; src: url('capture/assets/fonts/...woff2'); } for each font family, pointing to the captured .woff2 files."
+          fixHint: "Add @font-face { font-family: '...'; src: url('capture/assets/fonts/...woff2'); } for each font family, pointing to the captured .woff2 files. For an OS-bundled system font (e.g. Hiragino Sans, Microsoft YaHei) that has no downloadable file, use src: local('Exact Font Name') instead \u2014 the declaration alone satisfies this check without needing a font file."
         });
         return findings;
       }
@@ -95031,10 +95043,11 @@ __export(manager_exports2, {
   clearBrowser: () => clearBrowser,
   ensureBrowser: () => ensureBrowser,
   findBrowser: () => findBrowser,
-  isLinuxArm: () => isLinuxArm
+  isLinuxArm: () => isLinuxArm,
+  withInstallLock: () => withInstallLock
 });
 import { execSync as execSync5, spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync31, readdirSync as readdirSync13, rmSync as rmSync6 } from "fs";
+import { existsSync as existsSync31, mkdirSync as mkdirSync15, readdirSync as readdirSync13, rmSync as rmSync6, statSync as statSync9 } from "fs";
 import { basename as basename4 } from "path";
 import { homedir as homedir9 } from "os";
 import { join as join27 } from "path";
@@ -95049,6 +95062,59 @@ Fix: run \`npm install\` or \`bun install\` to restore missing packages, then re
     );
   }
 }
+function isErrno(err, code) {
+  return err.code === code;
+}
+function sleep(ms) {
+  return new Promise((resolve62) => setTimeout(resolve62, ms));
+}
+function tryAcquireDirLock(lockDir) {
+  try {
+    mkdirSync15(lockDir, { recursive: false });
+    return true;
+  } catch (err) {
+    if (!isErrno(err, "EEXIST")) throw err;
+    return false;
+  }
+}
+function reclaimStaleInstallLock(timeoutMs) {
+  if (!tryAcquireDirLock(INSTALL_RECLAIM_LOCK_DIR)) return;
+  try {
+    const mtimeMs = statSync9(INSTALL_LOCK_DIR).mtimeMs;
+    if (Date.now() - mtimeMs > timeoutMs) {
+      rmSync6(INSTALL_LOCK_DIR, { recursive: true, force: true });
+    }
+  } catch (err) {
+    if (!isErrno(err, "ENOENT")) throw err;
+  } finally {
+    rmSync6(INSTALL_RECLAIM_LOCK_DIR, { recursive: true, force: true });
+  }
+}
+async function withInstallLock(fn, timeoutMs = INSTALL_LOCK_TIMEOUT_MS, pollMs = INSTALL_LOCK_POLL_MS) {
+  if (!existsSync31(CACHE_DIR2)) mkdirSync15(CACHE_DIR2, { recursive: true });
+  let deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    if (existsSync31(INSTALL_RECLAIM_LOCK_DIR)) {
+      await sleep(pollMs);
+      continue;
+    }
+    if (tryAcquireDirLock(INSTALL_LOCK_DIR)) {
+      rmSync6(INSTALL_RECLAIM_LOCK_DIR, { recursive: true, force: true });
+      break;
+    }
+    if (Date.now() > deadline) {
+      reclaimStaleInstallLock(timeoutMs);
+      deadline = Date.now() + timeoutMs;
+      continue;
+    }
+    await sleep(pollMs);
+  }
+  try {
+    return await fn();
+  } finally {
+    rmSync6(INSTALL_LOCK_DIR, { recursive: true, force: true });
+  }
+}
 function whichBinary2(name) {
   try {
     const cmd = process.platform === "win32" ? `where ${name}` : `which ${name}`;
@@ -95199,7 +95265,7 @@ async function findBrowser() {
       `[browser] Cached binary missing at ${fromCache.staleHyperframesCachePath} \u2014 re-downloading...`
     );
     try {
-      return await downloadBrowser();
+      return await withInstallLock(() => downloadBrowser());
     } catch (err) {
       const cause = normalizeErrorMessage(err);
       throw new Error(
@@ -95262,14 +95328,18 @@ async function ensureBrowser(options) {
     console.warn(
       `[browser] Cached binary missing at ${fromCache.staleHyperframesCachePath} \u2014 re-downloading...`
     );
-    return downloadBrowser(options);
+    return withInstallLock(() => downloadBrowser(options));
   }
   const fromSystem = findFromSystem2();
   if (fromSystem) {
     warnSystemFallbackOnce(fromSystem.executablePath);
     return fromSystem;
   }
-  return downloadBrowser(options);
+  return withInstallLock(async () => {
+    const afterLock = await findFromCache();
+    if (afterLock.result) return afterLock.result;
+    return downloadBrowser(options);
+  });
 }
 async function downloadBrowser(options) {
   if (isLinuxArm()) {
@@ -95299,7 +95369,7 @@ function clearBrowser() {
 function isLinuxArm() {
   return process.platform === "linux" && process.arch === "arm64";
 }
-var CHROME_VERSION, CACHE_DIR2, PUPPETEER_CACHE_DIR, SYSTEM_CHROME_PATHS, _warnedSystemFallback;
+var CHROME_VERSION, CACHE_DIR2, PUPPETEER_CACHE_DIR, INSTALL_LOCK_DIR, INSTALL_RECLAIM_LOCK_DIR, INSTALL_LOCK_TIMEOUT_MS, INSTALL_LOCK_POLL_MS, SYSTEM_CHROME_PATHS, _warnedSystemFallback;
 var init_manager2 = __esm({
   "src/browser/manager.ts"() {
     "use strict";
@@ -95307,6 +95377,10 @@ var init_manager2 = __esm({
     CHROME_VERSION = "131.0.6778.85";
     CACHE_DIR2 = join27(homedir9(), ".cache", "hyperframes", "chrome");
     PUPPETEER_CACHE_DIR = join27(homedir9(), ".cache", "puppeteer", "chrome-headless-shell");
+    INSTALL_LOCK_DIR = join27(CACHE_DIR2, ".install.lock");
+    INSTALL_RECLAIM_LOCK_DIR = join27(CACHE_DIR2, ".install.reclaim.lock");
+    INSTALL_LOCK_TIMEOUT_MS = 12e4;
+    INSTALL_LOCK_POLL_MS = 200;
     SYSTEM_CHROME_PATHS = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : [
       "/usr/bin/google-chrome",
       "/usr/bin/google-chrome-stable",
@@ -98587,7 +98661,7 @@ __export(deterministicFonts_exports, {
   resolveFontFamilyDeclarationFamilies: () => resolveFontFamilyDeclarationFamilies
 });
 import { createHash as createHash6 } from "crypto";
-import { existsSync as existsSync33, mkdirSync as mkdirSync15, readFileSync as readFileSync20, writeFileSync as writeFileSync11 } from "fs";
+import { existsSync as existsSync33, mkdirSync as mkdirSync16, readFileSync as readFileSync20, writeFileSync as writeFileSync11 } from "fs";
 import { homedir as homedir10, tmpdir as tmpdir3 } from "os";
 import { join as join28 } from "path";
 import postcss4 from "postcss";
@@ -98914,7 +98988,7 @@ function fontSlug(familyName) {
 function fontCacheDir(slug) {
   const dir = join28(GOOGLE_FONTS_CACHE_DIR, slug);
   if (!existsSync33(dir)) {
-    mkdirSync15(dir, { recursive: true });
+    mkdirSync16(dir, { recursive: true });
   }
   return dir;
 }
@@ -99201,11 +99275,11 @@ import { spawn as spawn10 } from "child_process";
 import {
   copyFileSync as copyFileSync2,
   existsSync as existsSync34,
-  mkdirSync as mkdirSync16,
+  mkdirSync as mkdirSync17,
   readFileSync as readFileSync21,
   renameSync as renameSync4,
   rmSync as rmSync7,
-  statSync as statSync9
+  statSync as statSync10
 } from "fs";
 import { dirname as dirname13, isAbsolute as isAbsolute10, join as join29, resolve as resolve20 } from "path";
 function splitUrlSuffix2(src) {
@@ -99251,7 +99325,7 @@ function resolveGifSourcePath(src, options) {
 }
 function isUsableFile(path2) {
   try {
-    const stat3 = statSync9(path2);
+    const stat3 = statSync10(path2);
     return stat3.isFile() && stat3.size > 0;
   } catch {
     return false;
@@ -99368,10 +99442,10 @@ async function runAnimatedGifTranscode(request) {
 }
 async function ensurePreparedWebm(input2) {
   if (!existsSync34(dirname13(input2.cachePath))) {
-    mkdirSync16(dirname13(input2.cachePath), { recursive: true });
+    mkdirSync17(dirname13(input2.cachePath), { recursive: true });
   }
   if (!existsSync34(dirname13(input2.outputPath))) {
-    mkdirSync16(dirname13(input2.outputPath), { recursive: true });
+    mkdirSync17(dirname13(input2.outputPath), { recursive: true });
   }
   if (!isUsableFile(input2.cachePath)) {
     const tmpPath = `${input2.cachePath}.tmp-${process.pid}-${Date.now()}`;
@@ -99617,7 +99691,7 @@ var init_hf_early_stub_inline = __esm({
 // ../producer/src/services/fileServer.ts
 import { Hono as Hono3 } from "hono";
 import { serve as serve2 } from "@hono/node-server";
-import { existsSync as existsSync36, realpathSync as realpathSync4, statSync as statSync10, createReadStream } from "fs";
+import { existsSync as existsSync36, realpathSync as realpathSync4, statSync as statSync11, createReadStream } from "fs";
 import { readFile as readFile2 } from "fs/promises";
 import { Readable as Readable2 } from "stream";
 import { join as join30, extname as extname9, resolve as resolve23, sep as sep5 } from "path";
@@ -99965,13 +100039,13 @@ function createFileServer2(options) {
     let filePath = null;
     if (compiledDir) {
       const candidate = join30(compiledDir, relativePath);
-      if (existsSync36(candidate) && isPathInside2(candidate, compiledDir) && statSync10(candidate).isFile()) {
+      if (existsSync36(candidate) && isPathInside2(candidate, compiledDir) && statSync11(candidate).isFile()) {
         filePath = candidate;
       }
     }
     if (!filePath) {
       const candidate = join30(projectDir, relativePath);
-      if (existsSync36(candidate) && isPathInside2(candidate, projectDir) && statSync10(candidate).isFile()) {
+      if (existsSync36(candidate) && isPathInside2(candidate, projectDir) && statSync11(candidate).isFile()) {
         filePath = candidate;
       }
     }
@@ -99993,7 +100067,7 @@ function createFileServer2(options) {
       html = isIndex ? injectScriptsIntoHtml(html, headScripts, bodyScripts, stripEmbeddedRuntime) : html;
       return c3.text(html, 200, { "Content-Type": contentType });
     }
-    const stat3 = statSync10(filePath);
+    const stat3 = statSync11(filePath);
     const totalSize2 = stat3.size;
     const rangeHeader = c3.req.header("range");
     const rangeRequest = parseRangeHeader(rangeHeader, totalSize2);
@@ -100245,7 +100319,7 @@ var init_paths = __esm({
 });
 
 // ../producer/src/services/render/shared.ts
-import { copyFileSync as copyFileSync3, cpSync as cpSync2, existsSync as existsSync37, mkdirSync as mkdirSync17, symlinkSync as symlinkSync2, writeFileSync as writeFileSync12 } from "fs";
+import { copyFileSync as copyFileSync3, cpSync as cpSync2, existsSync as existsSync37, mkdirSync as mkdirSync18, symlinkSync as symlinkSync2, writeFileSync as writeFileSync12 } from "fs";
 import { basename as basename6, dirname as dirname15, isAbsolute as isAbsolute11, join as join33, relative as relative8, resolve as resolve24 } from "path";
 function writeFileExclusiveSync(path2, data2) {
   try {
@@ -100275,11 +100349,11 @@ function resolveDeviceScaleFactor(input2) {
 }
 function writeCompiledArtifacts(compiled, workDir, includeSummary) {
   const compileDir = join33(workDir, "compiled");
-  mkdirSync17(compileDir, { recursive: true });
+  mkdirSync18(compileDir, { recursive: true });
   writeFileSync12(join33(compileDir, "index.html"), compiled.html, "utf-8");
   for (const [srcPath, html] of compiled.subCompositions) {
     const outPath = join33(compileDir, srcPath);
-    mkdirSync17(dirname15(outPath), { recursive: true });
+    mkdirSync18(dirname15(outPath), { recursive: true });
     writeFileSync12(outPath, html, "utf-8");
   }
   for (const [relativePath, absolutePath] of compiled.externalAssets) {
@@ -100288,7 +100362,7 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
       console.warn(`[Render] Skipping external asset with unsafe path: ${relativePath}`);
       continue;
     }
-    mkdirSync17(dirname15(outPath), { recursive: true });
+    mkdirSync18(dirname15(outPath), { recursive: true });
     copyFileSync3(absolutePath, outPath);
   }
   if (includeSummary) {
@@ -100413,7 +100487,7 @@ var init_shared = __esm({
     };
     materializeFileSystem = {
       existsSync: existsSync37,
-      mkdirSync: mkdirSync17,
+      mkdirSync: mkdirSync18,
       symlinkSync: symlinkSync2,
       cpSync: cpSync2
     };
@@ -101605,7 +101679,7 @@ var init_manualEditsRenderScript = __esm({
 });
 
 // ../producer/src/services/htmlCompiler.ts
-import { readFileSync as readFileSync24, existsSync as existsSync38, mkdirSync as mkdirSync18 } from "fs";
+import { readFileSync as readFileSync24, existsSync as existsSync38, mkdirSync as mkdirSync19 } from "fs";
 import { join as join35, dirname as dirname16, resolve as resolve25, basename as basename7 } from "path";
 function parseSubCompHtmlForValidity(html) {
   return parseHTML(html).document;
@@ -101715,7 +101789,7 @@ function detectShaderTransitionUsage(html) {
 async function resolveMediaDuration(src, mediaStart, baseDir, downloadDir, tagName19) {
   let filePath = src;
   if (isHttpUrl(src)) {
-    if (!existsSync38(downloadDir)) mkdirSync18(downloadDir, { recursive: true });
+    if (!existsSync38(downloadDir)) mkdirSync19(downloadDir, { recursive: true });
     try {
       filePath = await downloadToTemp(src, downloadDir);
     } catch {
@@ -102202,7 +102276,7 @@ function collectExternalAssets(html, projectDir) {
 }
 async function downloadAndRewriteUrls(urlSet, html, remoteDir, warnLabel, logLabel, extraRewrite) {
   if (urlSet.size === 0) return { html, remoteMediaAssets: /* @__PURE__ */ new Map() };
-  if (!existsSync38(remoteDir)) mkdirSync18(remoteDir, { recursive: true });
+  if (!existsSync38(remoteDir)) mkdirSync19(remoteDir, { recursive: true });
   const urlToLocal = /* @__PURE__ */ new Map();
   await Promise.all(
     [...urlSet].map(async (url) => {
@@ -103465,6 +103539,7 @@ async function runAudioStage(input2) {
   const stage3Start = Date.now();
   const audioOutputPath = join39(workDir, "audio.aac");
   let hasAudio = false;
+  let audioError;
   if (audios.length > 0) {
     const audioResult = await processCompositionAudio(
       audios,
@@ -103478,9 +103553,10 @@ async function runAudioStage(input2) {
     );
     assertNotAborted();
     hasAudio = audioResult.success;
+    if (!hasAudio) audioError = audioResult.error ?? "audio mix failed for an unknown reason";
   }
   const audioProcessMs = Date.now() - stage3Start;
-  return { audioOutputPath, hasAudio, audioProcessMs };
+  return { audioOutputPath, hasAudio, audioProcessMs, audioError };
 }
 var init_audioStage = __esm({
   "../producer/src/services/render/stages/audioStage.ts"() {
@@ -104551,7 +104627,7 @@ import {
   closeSync as closeSync3,
   constants as constants2,
   fstatSync as fstatSync2,
-  mkdirSync as mkdirSync19,
+  mkdirSync as mkdirSync20,
   mkdtempSync as mkdtempSync2,
   openSync as openSync2,
   readFileSync as readFileSync25
@@ -104643,7 +104719,7 @@ async function extractHdrVideoFrames(args) {
   for (const [videoId, srcPath] of prep.hdrVideoSrcPaths) {
     const video = composition.videos.find((v2) => v2.id === videoId);
     if (!video) continue;
-    mkdirSync19(framesDir, { recursive: true });
+    mkdirSync20(framesDir, { recursive: true });
     const frameDir = mkdtempSync2(join41(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
     const duration = video.end - video.start;
     const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
@@ -105362,7 +105438,7 @@ var init_captureHdrHybridLoop = __esm({
 });
 
 // ../producer/src/services/render/stages/captureHdrStage.ts
-import { existsSync as existsSync41, mkdirSync as mkdirSync20 } from "fs";
+import { existsSync as existsSync41, mkdirSync as mkdirSync21 } from "fs";
 import { join as join46 } from "path";
 async function runCaptureHdrStage(input2) {
   const {
@@ -105524,7 +105600,7 @@ async function runCaptureHdrStage(input2) {
       const debugDumpEnabled = process.env.KEEP_TEMP === "1";
       const debugDumpDir = debugDumpEnabled ? join46(framesDir, "debug-composite") : null;
       if (debugDumpDir && !existsSync41(debugDumpDir)) {
-        mkdirSync20(debugDumpDir, { recursive: true });
+        mkdirSync21(debugDumpDir, { recursive: true });
       }
       const compositeTransfer = resolveCompositeTransfer(hasHdrContent, effectiveHdr);
       const hdrTargetTransfer = compositeTransfer === "srgb" ? void 0 : compositeTransfer;
@@ -105725,7 +105801,7 @@ var init_gifEncodeArgs = __esm({
 });
 
 // ../producer/src/services/render/stages/encodeStage.ts
-import { copyFileSync as copyFileSync4, existsSync as existsSync43, mkdirSync as mkdirSync21, readdirSync as readdirSync14, rmSync as rmSync10, statSync as statSync11 } from "fs";
+import { copyFileSync as copyFileSync4, existsSync as existsSync43, mkdirSync as mkdirSync23, readdirSync as readdirSync14, rmSync as rmSync10, statSync as statSync12 } from "fs";
 import { dirname as dirname18, join as join48 } from "path";
 function resolveGifLoop(loop) {
   const resolved = loop ?? 0;
@@ -105785,7 +105861,7 @@ async function encodeGifFromDir(framesDir, framePattern, outputPath, input2) {
         error: formatFfmpegError(gifResult.exitCode, gifResult.stderr)
       };
     }
-    const fileSize = existsSync43(outputPath) ? statSync11(outputPath).size : 0;
+    const fileSize = existsSync43(outputPath) ? statSync12(outputPath).size : 0;
     return {
       success: true,
       outputPath,
@@ -105823,7 +105899,7 @@ async function runEncodeStage(input2) {
   const stage5Start = Date.now();
   if (isPngSequence) {
     updateJobStatus(job, "encoding", "Writing PNG sequence", 75, onProgress);
-    if (!existsSync43(outputPath)) mkdirSync21(outputPath, { recursive: true });
+    if (!existsSync43(outputPath)) mkdirSync23(outputPath, { recursive: true });
     const captured = readdirSync14(framesDir).filter((name) => name.endsWith(".png")).sort();
     if (captured.length === 0) {
       throw new Error(
@@ -105967,12 +106043,12 @@ var init_assembleStage = __esm({
 // ../producer/src/services/renderOrchestrator.ts
 import {
   existsSync as existsSync44,
-  mkdirSync as mkdirSync23,
+  mkdirSync as mkdirSync24,
   mkdtempSync as mkdtempSync3,
   readFileSync as readFileSync26,
   readdirSync as readdirSync15,
   rmSync as rmSync11,
-  statSync as statSync12,
+  statSync as statSync13,
   writeFileSync as writeFileSync13,
   copyFileSync as copyFileSync5,
   appendFileSync
@@ -105995,7 +106071,7 @@ function sampleDirectoryBytes(dir) {
     for (const name of entries2) {
       const full2 = join49(current2, name);
       try {
-        const st3 = statSync12(full2);
+        const st3 = statSync13(full2);
         if (st3.isDirectory()) {
           stack.push(full2);
         } else if (st3.isFile()) {
@@ -106350,7 +106426,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
   const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve26(process.env.PRODUCER_RENDERS_DIR, "..") : resolve26(moduleDir, "../..");
   const debugDir = join49(producerRoot, ".debug");
   const outputDir = dirname19(outputPath);
-  if (!existsSync44(outputDir)) mkdirSync23(outputDir, { recursive: true });
+  if (!existsSync44(outputDir)) mkdirSync24(outputDir, { recursive: true });
   const workDir = job.config.debug ? join49(debugDir, job.id) : mkdtempSync3(join49(outputDir, `work-${job.id}-`));
   const pipelineStart = Date.now();
   const log2 = job.config.logger ?? defaultLogger;
@@ -106412,7 +106488,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     job.startedAt = /* @__PURE__ */ new Date();
     assertNotAborted();
     assertConfiguredFfmpegBinariesExist();
-    if (!existsSync44(workDir)) mkdirSync23(workDir, { recursive: true });
+    if (!existsSync44(workDir)) mkdirSync24(workDir, { recursive: true });
     if (job.config.debug) {
       const logPath = join49(workDir, "render.log");
       restoreLogger = installDebugLogger(logPath, log2);
@@ -106648,6 +106724,9 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     );
     const { audioOutputPath, hasAudio } = audioResult;
     perfStages.audioProcessMs = audioResult.audioProcessMs;
+    if (audioResult.audioError) {
+      log2.warn(`[Render] Audio mix failed \u2014 output will be video-only: ${audioResult.audioError}`);
+    }
     const stage4Start = Date.now();
     updateJobStatus(job, "rendering", "Starting frame capture", 25, onProgress);
     if (!fileServer) {
@@ -106674,7 +106753,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       throw new Error("File server failed to initialize before frame capture");
     }
     const framesDir = join49(workDir, "captured-frames");
-    if (!existsSync44(framesDir)) mkdirSync23(framesDir, { recursive: true });
+    if (!existsSync44(framesDir)) mkdirSync24(framesDir, { recursive: true });
     const resolvedBrowserGpuMode = await resolveBrowserGpuMode(cfg.browserGpuMode, {
       chromePath: resolveHeadlessShellPath(cfg),
       browserTimeout: cfg.browserTimeout
@@ -107264,7 +107343,7 @@ var init_config3 = __esm({
 });
 
 // ../producer/src/services/hyperframeLint.ts
-import { existsSync as existsSync45, readFileSync as readFileSync27, statSync as statSync13 } from "fs";
+import { existsSync as existsSync45, readFileSync as readFileSync27, statSync as statSync14 } from "fs";
 import { resolve as resolve27, join as join50 } from "path";
 function isStringRecord2(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -107293,7 +107372,7 @@ function pickEntryFile(files, preferredEntryFile) {
 }
 function readProjectEntryFile(projectDir, preferredEntryFile) {
   const absProjectDir = resolve27(projectDir);
-  if (!existsSync45(absProjectDir) || !statSync13(absProjectDir).isDirectory()) {
+  if (!existsSync45(absProjectDir) || !statSync14(absProjectDir).isDirectory()) {
     return { error: `Project directory not found: ${absProjectDir}` };
   }
   const entryCandidates = [preferredEntryFile, "index.html", "src/index.html"].filter(
@@ -107304,7 +107383,7 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
     if (!absoluteEntryPath.startsWith(absProjectDir)) {
       return { error: `Entry file must stay inside project directory: ${entryFile}` };
     }
-    if (existsSync45(absoluteEntryPath) && statSync13(absoluteEntryPath).isFile()) {
+    if (existsSync45(absoluteEntryPath) && statSync14(absoluteEntryPath).isFile()) {
       return {
         entryFile,
         html: readFileSync27(absoluteEntryPath, "utf-8"),
@@ -107495,8 +107574,8 @@ var init_semaphore = __esm({
 // ../producer/src/server.ts
 import {
   existsSync as existsSync47,
-  mkdirSync as mkdirSync24,
-  statSync as statSync14,
+  mkdirSync as mkdirSync25,
+  statSync as statSync15,
   mkdtempSync as mkdtempSync4,
   writeFileSync as writeFileSync14,
   rmSync as rmSync12,
@@ -107563,7 +107642,7 @@ function resolvePreparedRenderOutput(prepared, rendersDir, log2) {
   const { input: input2, cleanupProjectDir } = prepared;
   const absoluteOutputPath = resolveOutputPath(input2.projectDir, input2.outputPath, rendersDir, log2);
   const outputDir = dirname21(absoluteOutputPath);
-  if (!existsSync47(outputDir)) mkdirSync24(outputDir, { recursive: true });
+  if (!existsSync47(outputDir)) mkdirSync25(outputDir, { recursive: true });
   return { input: input2, cleanupProjectDir, absoluteOutputPath };
 }
 function validateRenderOverrides(body) {
@@ -107593,7 +107672,7 @@ async function prepareRenderBody(body) {
   const projectDir = typeof body.projectDir === "string" ? body.projectDir : void 0;
   if (projectDir) {
     const absProjectDir = resolve28(projectDir);
-    if (!existsSync47(absProjectDir) || !statSync14(absProjectDir).isDirectory()) {
+    if (!existsSync47(absProjectDir) || !statSync15(absProjectDir).isDirectory()) {
       return { error: `Project directory not found: ${absProjectDir}` };
     }
     const entry = options.entryFile || "index.html";
@@ -107760,7 +107839,7 @@ function createRenderHandlers(options = {}) {
           log2.info(`render progress ${pct}%`, { requestId, stage: j3.currentStage, message });
         }
       });
-      const fileSize = existsSync47(absoluteOutputPath) ? statSync14(absoluteOutputPath).size : 0;
+      const fileSize = existsSync47(absoluteOutputPath) ? statSync15(absoluteOutputPath).size : 0;
       const durationMs = Date.now() - t0;
       const outputToken = store.register(absoluteOutputPath);
       const outputUrl = `${outputUrlPrefix}/${outputToken}`;
@@ -107876,7 +107955,7 @@ function createRenderHandlers(options = {}) {
           },
           abortController.signal
         );
-        const fileSize = existsSync47(absoluteOutputPath) ? statSync14(absoluteOutputPath).size : 0;
+        const fileSize = existsSync47(absoluteOutputPath) ? statSync15(absoluteOutputPath).size : 0;
         const outputToken = store.register(absoluteOutputPath);
         const outputUrl = `${outputUrlPrefix}/${outputToken}`;
         log2.info("render-stream completed", { requestId, fileSize, perf: job.perfSummary ?? null });
@@ -107939,7 +108018,7 @@ function createRenderHandlers(options = {}) {
       store.delete(token);
       return c3.json({ success: false, error: "Output artifact file missing" }, 404);
     }
-    const stats = statSync14(artifact.path);
+    const stats = statSync15(artifact.path);
     return new Response(createReadStream2(artifact.path), {
       headers: {
         "content-type": "video/mp4",
@@ -108103,7 +108182,7 @@ var init_planHash = __esm({
 });
 
 // ../producer/src/services/render/stages/freezePlan.ts
-import { existsSync as existsSync48, mkdirSync as mkdirSync25, readFileSync as readFileSync28, readdirSync as readdirSync16, writeFileSync as writeFileSync15 } from "fs";
+import { existsSync as existsSync48, mkdirSync as mkdirSync26, readFileSync as readFileSync28, readdirSync as readdirSync16, writeFileSync as writeFileSync15 } from "fs";
 import { join as join54, relative as relative9, resolve as resolve29 } from "path";
 function stripUndefined(value) {
   if (Array.isArray(value)) return value.map(stripUndefined);
@@ -108199,7 +108278,7 @@ async function freezePlan(input2) {
     throw new Error(`[freezePlan] planDir does not exist: ${planDir}`);
   }
   const metaDir = join54(planDir, "meta");
-  if (!existsSync48(metaDir)) mkdirSync25(metaDir, { recursive: true });
+  if (!existsSync48(metaDir)) mkdirSync26(metaDir, { recursive: true });
   writeFileSync15(
     join54(metaDir, "composition.json"),
     `${JSON.stringify(composition, null, 2)}
@@ -108429,11 +108508,11 @@ var init_shared2 = __esm({
 import {
   cpSync as cpSync3,
   existsSync as existsSync50,
-  mkdirSync as mkdirSync26,
+  mkdirSync as mkdirSync27,
   readdirSync as readdirSync17,
   renameSync as renameSync5,
   rmSync as rmSync13,
-  statSync as statSync15,
+  statSync as statSync16,
   writeFileSync as writeFileSync16
 } from "fs";
 import { join as join56, relative as relative10, sep as sep6 } from "path";
@@ -108466,7 +108545,7 @@ function measurePlanDirBytes(planDir) {
         walk(full2);
       } else if (entry.isFile()) {
         try {
-          total += statSync15(full2).size;
+          total += statSync16(full2).size;
         } catch {
         }
       }
@@ -108600,7 +108679,7 @@ async function plan(projectDir, config, planDir) {
     useGpu: false,
     browserGpuMode: "software"
   });
-  if (!existsSync50(planDir)) mkdirSync26(planDir, { recursive: true });
+  if (!existsSync50(planDir)) mkdirSync27(planDir, { recursive: true });
   const log2 = config.logger ?? defaultLogger;
   const abortSignal = config.abortSignal;
   const assertNotAborted = () => {
@@ -108634,9 +108713,9 @@ async function plan(projectDir, config, planDir) {
     throw new Error(`[plan] entry file not found: ${htmlPath}`);
   }
   const workDir = join56(planDir, ".plan-work");
-  if (!existsSync50(workDir)) mkdirSync26(workDir, { recursive: true });
+  if (!existsSync50(workDir)) mkdirSync27(workDir, { recursive: true });
   const compiledDir = join56(workDir, "compiled");
-  mkdirSync26(compiledDir, { recursive: true });
+  mkdirSync27(compiledDir, { recursive: true });
   cpSync3(projectDir, compiledDir, {
     recursive: true,
     dereference: true,
@@ -108729,13 +108808,16 @@ async function plan(projectDir, config, planDir) {
     abortSignal,
     assertNotAborted
   });
+  if (audioResult.audioError) {
+    log2.warn(`[Render] Audio mix failed \u2014 output will be video-only: ${audioResult.audioError}`);
+  }
   const stagedVideoFrames = join56(compiledDir, "__hyperframes_video_frames");
   const videoFramesDst = join56(planDir, "video-frames");
   if (existsSync50(videoFramesDst)) rmSync13(videoFramesDst, { recursive: true, force: true });
   if (existsSync50(stagedVideoFrames)) {
     renameSync5(stagedVideoFrames, videoFramesDst);
   } else {
-    mkdirSync26(videoFramesDst, { recursive: true });
+    mkdirSync27(videoFramesDst, { recursive: true });
   }
   if (existsSync50(finalCompiledDir)) rmSync13(finalCompiledDir, { recursive: true, force: true });
   renameSync5(compiledDir, finalCompiledDir);
@@ -108750,7 +108832,7 @@ async function plan(projectDir, config, planDir) {
       metadata: ext.metadata
     }))
   };
-  mkdirSync26(join56(planDir, "meta"), { recursive: true });
+  mkdirSync27(join56(planDir, "meta"), { recursive: true });
   writeFileSync16(
     join56(planDir, PLAN_VIDEOS_META_RELATIVE_PATH),
     JSON.stringify(planVideosJson, null, 2),
@@ -108900,7 +108982,7 @@ var init_plan = __esm({
 
 // ../producer/src/services/distributed/renderChunk.ts
 import { randomBytes as randomBytes2 } from "crypto";
-import { existsSync as existsSync51, mkdirSync as mkdirSync27, readFileSync as readFileSync30, readdirSync as readdirSync18, rmSync as rmSync14, writeFileSync as writeFileSync17 } from "fs";
+import { existsSync as existsSync51, mkdirSync as mkdirSync28, readFileSync as readFileSync30, readdirSync as readdirSync18, rmSync as rmSync14, writeFileSync as writeFileSync17 } from "fs";
 import { extname as extname10, join as join57 } from "path";
 function rebuildExtractedFramesFromPlanDir(planDir, videos) {
   const result = [];
@@ -109066,9 +109148,9 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath) {
       "software"
     );
     const workDir = `${outputChunkPath}.work.${process.pid}.${randomBytes2(4).toString("hex")}`;
-    mkdirSync27(workDir, { recursive: true });
+    mkdirSync28(workDir, { recursive: true });
     const framesDir = join57(workDir, "captured-frames");
-    mkdirSync27(framesDir, { recursive: true });
+    mkdirSync28(framesDir, { recursive: true });
     const fileServer = await createFileServer2({
       projectDir: compiledDir,
       compiledDir,
@@ -109147,10 +109229,10 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath) {
       const effectiveBitrate = encoder.crf != null ? void 0 : encoder.bitrate;
       const videoOnlyPath = outputChunkPath;
       if (isPngSequence) {
-        if (!existsSync51(outputChunkPath)) mkdirSync27(outputChunkPath, { recursive: true });
+        if (!existsSync51(outputChunkPath)) mkdirSync28(outputChunkPath, { recursive: true });
       } else {
         const outDir = join57(outputChunkPath, "..");
-        if (!existsSync51(outDir)) mkdirSync27(outDir, { recursive: true });
+        if (!existsSync51(outDir)) mkdirSync28(outDir, { recursive: true });
       }
       const encodeStarted = Date.now();
       await runEncodeStage({
@@ -109589,11 +109671,11 @@ var init_audioPadTrim = __esm({
 import {
   cpSync as cpSync4,
   existsSync as existsSync53,
-  mkdirSync as mkdirSync28,
+  mkdirSync as mkdirSync29,
   readFileSync as readFileSync31,
   readdirSync as readdirSync19,
   rmSync as rmSync16,
-  statSync as statSync16,
+  statSync as statSync17,
   writeFileSync as writeFileSync18
 } from "fs";
 import { dirname as dirname23, join as join58 } from "path";
@@ -109626,11 +109708,11 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
     return mergePngFrameDirs(chunkPaths, outputPath, plan2.totalFrames, audioPath, start);
   }
   if (!existsSync53(dirname23(outputPath))) {
-    mkdirSync28(dirname23(outputPath), { recursive: true });
+    mkdirSync29(dirname23(outputPath), { recursive: true });
   }
   const workDir = `${outputPath}.assemble-work`;
   if (existsSync53(workDir)) rmSync16(workDir, { recursive: true, force: true });
-  mkdirSync28(workDir, { recursive: true });
+  mkdirSync29(workDir, { recursive: true });
   try {
     const concatOutputPath = join58(workDir, `concat.${plan2.dimensions.format}`);
     const fpsArg = fpsToFfmpegArg({
@@ -109775,7 +109857,7 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       });
     }
   }
-  const fileSize = existsSync53(outputPath) ? statSync16(outputPath).size : 0;
+  const fileSize = existsSync53(outputPath) ? statSync17(outputPath).size : 0;
   return {
     outputPath,
     durationMs: Date.now() - start,
@@ -109785,10 +109867,10 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
 }
 function mergePngFrameDirs(chunkPaths, outputPath, totalFrames, audioPath, startTimeMs) {
   if (existsSync53(outputPath)) rmSync16(outputPath, { recursive: true, force: true });
-  mkdirSync28(outputPath, { recursive: true });
+  mkdirSync29(outputPath, { recursive: true });
   let globalIdx = 0;
   for (const chunkDir of chunkPaths) {
-    if (!statSync16(chunkDir).isDirectory()) {
+    if (!statSync17(chunkDir).isDirectory()) {
       throw new Error(
         `[assemble] png-sequence chunk must be a directory: ${chunkDir} (got a file)`
       );
@@ -109815,7 +109897,7 @@ function mergePngFrameDirs(chunkPaths, outputPath, totalFrames, audioPath, start
   let fileSize = 0;
   for (const name of readdirSync19(outputPath)) {
     try {
-      fileSize += statSync16(join58(outputPath, name)).size;
+      fileSize += statSync17(join58(outputPath, name)).size;
     } catch {
     }
   }
@@ -109929,7 +110011,7 @@ __export(studioServer_exports, {
 });
 import { Hono as Hono5 } from "hono";
 import { streamSSE as streamSSE3 } from "hono/streaming";
-import { existsSync as existsSync54, readFileSync as readFileSync34, writeFileSync as writeFileSync19, statSync as statSync17 } from "fs";
+import { existsSync as existsSync54, readFileSync as readFileSync34, writeFileSync as writeFileSync19, statSync as statSync18 } from "fs";
 import { resolve as resolve30, join as join60, basename as basename8 } from "path";
 function resolveDistDir() {
   return resolveStudioBundle().dir;
@@ -110385,7 +110467,7 @@ function createStudioServer(options) {
   });
   const serveStudioStaticFile = (c3) => {
     const filePath = resolve30(studioDir, c3.req.path.slice(1));
-    if (!existsSync54(filePath) || !statSync17(filePath).isFile()) return c3.text("not found", 404);
+    if (!existsSync54(filePath) || !statSync18(filePath).isFile()) return c3.text("not found", 404);
     const content = readFileSync34(filePath);
     return new Response(content, {
       headers: { "Content-Type": getMimeType(filePath), "Cache-Control": "no-store" }
@@ -110496,7 +110578,7 @@ __export(preview_exports, {
   examples: () => examples2
 });
 import { spawn as spawn12 } from "child_process";
-import { existsSync as existsSync55, lstatSync as lstatSync3, symlinkSync as symlinkSync3, unlinkSync as unlinkSync4, readlinkSync, mkdirSync as mkdirSync29 } from "fs";
+import { existsSync as existsSync55, lstatSync as lstatSync3, symlinkSync as symlinkSync3, unlinkSync as unlinkSync4, readlinkSync, mkdirSync as mkdirSync30 } from "fs";
 import { resolve as resolve31, dirname as dirname24, basename as basename9, join as join61 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
 import { createRequire as createRequire2 } from "module";
@@ -110804,7 +110886,7 @@ function printStudioSummary(projectName, url, opts = {}) {
 }
 function linkProjectIntoStudioData(dir, projectsDir, projectName) {
   const symlinkPath = join61(projectsDir, projectName);
-  mkdirSync29(projectsDir, { recursive: true });
+  mkdirSync30(projectsDir, { recursive: true });
   let createdSymlink = false;
   if (dir !== symlinkPath) {
     if (existsSync55(symlinkPath)) {
@@ -111251,7 +111333,7 @@ __export(init_exports, {
 });
 import {
   existsSync as existsSync56,
-  mkdirSync as mkdirSync30,
+  mkdirSync as mkdirSync31,
   copyFileSync as copyFileSync6,
   cpSync as cpSync5,
   writeFileSync as writeFileSync20,
@@ -111590,7 +111672,7 @@ function applyResolutionPreset(destDir, resolution) {
   }
 }
 async function scaffoldProject(destDir, name, templateId, localVideoName, durationSeconds, tailwind = false, resolution) {
-  mkdirSync30(destDir, { recursive: true });
+  mkdirSync31(destDir, { recursive: true });
   const templateDir = getStaticTemplateDir(templateId);
   if (existsSync56(join63(templateDir, "index.html"))) {
     cpSync5(templateDir, destDir, { recursive: true });
@@ -111832,7 +111914,7 @@ var init_init = __esm({
             console.error(c.error(`Audio file not found: ${audioFlag}`));
             process.exit(1);
           }
-          mkdirSync30(destDir2, { recursive: true });
+          mkdirSync31(destDir2, { recursive: true });
           let localVideoName2;
           let videoDuration2;
           let sourceFilePath2;
@@ -111974,7 +112056,7 @@ var init_init = __esm({
             me("Setup cancelled.");
             process.exit(1);
           }
-          mkdirSync30(destDir, { recursive: true });
+          mkdirSync31(destDir, { recursive: true });
           sourceFilePath = videoPath;
           const result = await handleVideoFile(videoPath, destDir, true);
           localVideoName = result.localVideoName;
@@ -111986,7 +112068,7 @@ var init_init = __esm({
             me("Setup cancelled.");
             process.exit(1);
           }
-          mkdirSync30(destDir, { recursive: true });
+          mkdirSync31(destDir, { recursive: true });
           sourceFilePath = audioPath;
           copyFileSync6(audioPath, resolve33(destDir, basename10(audioPath)));
           R2.info(`Audio copied to ${c.accent(basename10(audioPath))}`);
@@ -112856,18 +112938,18 @@ function buildPresentPage(projectName, islandJson) {
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>${escHtml(projectName)} \u2014 Presenter</title>
+    <script>
+      // Retitle the audience tab so the two tabs are distinguishable in the
+      // browser tab strip and in Meet's "Share a tab" picker.
+      if (new URLSearchParams(location.search).get("mode") === "audience") {
+        document.title = ${JSON.stringify(projectName).replace(/</g, "\\u003c")} + " \u2014 Audience";
+      }
+    </script>
     <style>
       * { margin: 0; padding: 0; box-sizing: border-box; }
       html, body { height: 100%; background: #0a0a0a; overflow: hidden; }
       hyperframes-slideshow { display: block; position: relative; width: 100vw; height: 100vh; }
       hyperframes-player { position: absolute; inset: 0; }
-      #present-btn {
-        position: fixed; top: 18px; right: 18px; z-index: 99999;
-        font: 600 14px/1 system-ui, sans-serif; color: #0d1321;
-        background: #f4b740; border: none; border-radius: 999px;
-        padding: 11px 18px; cursor: pointer; box-shadow: 0 6px 20px rgba(0,0,0,.45);
-      }
-      #present-btn:hover { background: #ffcb5c; }
     </style>
     <script src="/player.js"></script>
     <script src="/slideshow.js"></script>
@@ -112879,28 +112961,8 @@ function buildPresentPage(projectName, islandJson) {
 ${islandJson}
       </script>
     </hyperframes-slideshow>
-    <button id="present-btn" type="button">\u25B6&nbsp; Present</button>
-    <script>
-      (function () {
-        // The audience window loads this same page with ?mode=audience; it must not
-        // show the Present button or it would recurse opening windows.
-        var isAudience = new URLSearchParams(location.search).get("mode") === "audience";
-        var btn = document.getElementById("present-btn");
-        if (isAudience) { if (btn) btn.remove(); return; }
-        function present() {
-          var ss = document.querySelector("hyperframes-slideshow");
-          if (ss && typeof ss.present === "function") {
-            ss.present();
-            if (btn) btn.style.display = "none";
-          }
-        }
-        if (btn) btn.addEventListener("click", present);
-        // 'P' opens presenter mode (window.open needs a user gesture, so a key/click).
-        window.addEventListener("keydown", function (e) {
-          if ((e.key === "p" || e.key === "P") && !e.metaKey && !e.ctrlKey) present();
-        });
-      })();
-    </script>
+    <!-- Present CTA lives in the component's nav cluster (data-hf-present, plus
+         the P key) \u2014 no page-level button, or we'd render two Present CTAs. -->
     <script>
       // Sound effects play HERE, in the parent document. The composition runs in the
       // player's iframe, which is autoplay-blocked without its own user gesture; the
@@ -113069,6 +113131,15 @@ var init_present = __esm({
           return;
         }
         const islandJson = islandMatch[1].trim();
+        try {
+          JSON.parse(islandJson);
+        } catch (err) {
+          R2.error(
+            `Slideshow island in ${project.indexPath} is not valid JSON: ${err.message}`
+          );
+          process.exitCode = 1;
+          return;
+        }
         const { Hono: Hono6 } = await import("hono");
         const { createAdaptorServer } = await import("@hono/node-server");
         const { isSafePath: isSafePath2 } = await Promise.resolve().then(() => (init_studio_api(), studio_api_exports));
@@ -113110,7 +113181,15 @@ var init_present = __esm({
         console.log(`  ${c.dim("Deck")}      ${c.accent(project.name)}`);
         console.log(`  ${c.dim("Present")}   ${c.accent(url)}`);
         console.log();
-        console.log(`  ${c.dim("Click \u25B6 Present (or press P) to open the audience display.")}`);
+        console.log(
+          `  ${c.dim("Click the Present control (or press P) to open the audience display.")}`
+        );
+        console.log(
+          `  ${c.dim('Google Meet: share the AUDIENCE tab ("Share screen \u2192 A tab"), not a window or your whole screen.')}`
+        );
+        console.log(
+          `  ${c.dim("Zoom desktop: drag the audience tab into its own window and share that window (keep it at least partly visible).")}`
+        );
         console.log(`  ${c.dim("Press Ctrl+C to stop")}`);
         console.log();
         if (args.open) {
@@ -113129,7 +113208,7 @@ var init_present = __esm({
 
 // src/utils/publishProject.ts
 import { basename as basename11, dirname as dirname27, join as join64, posix as posix4, relative as relative13, resolve as resolve39 } from "path";
-import { existsSync as existsSync61, readdirSync as readdirSync23, readFileSync as readFileSync38, statSync as statSync18 } from "fs";
+import { existsSync as existsSync61, readdirSync as readdirSync23, readFileSync as readFileSync38, statSync as statSync19 } from "fs";
 import AdmZip from "adm-zip";
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -113236,7 +113315,7 @@ function collectProjectFiles(rootDir, currentDir, paths) {
       collectProjectFiles(rootDir, absolutePath, paths);
       continue;
     }
-    if (!statSync18(absolutePath).isFile()) continue;
+    if (!statSync19(absolutePath).isFile()) continue;
     paths.push(relativePath);
   }
 }
@@ -113263,7 +113342,7 @@ function tryResolveExternal(ctx, rawPath, referrerAbsDir) {
   const absPath = resolve39(referrerAbsDir, rawPath);
   if (isPathInside(absPath, ctx.absProjectDir)) return null;
   try {
-    if (!existsSync61(absPath) || !statSync18(absPath).isFile()) return null;
+    if (!existsSync61(absPath) || !statSync19(absPath).isFile()) return null;
   } catch {
     return null;
   }
@@ -114292,7 +114371,7 @@ __export(batchRender_exports, {
   resolveOutputTemplate: () => resolveOutputTemplate,
   runBatchRender: () => runBatchRender
 });
-import { mkdirSync as mkdirSync31, readFileSync as readFileSync40, writeFileSync as writeFileSync21 } from "fs";
+import { mkdirSync as mkdirSync33, readFileSync as readFileSync40, writeFileSync as writeFileSync21 } from "fs";
 import { dirname as dirname28, join as join66, resolve as resolve43, sep as sep8 } from "path";
 function isRecord4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -114477,7 +114556,7 @@ function summarizeManifest(manifest) {
 }
 function writeManifest(manifest) {
   summarizeManifest(manifest);
-  mkdirSync31(dirname28(manifest.manifestPath), { recursive: true });
+  mkdirSync33(dirname28(manifest.manifestPath), { recursive: true });
   writeFileSync21(manifest.manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf8");
 }
 function emitJsonEvent(event, json) {
@@ -114499,7 +114578,7 @@ async function renderBatchRow(row, manifest, options) {
     console.log(c.dim(`Batch row ${row.index}: ${row.outputPath}`));
   }
   try {
-    mkdirSync31(dirname28(row.outputPath), { recursive: true });
+    mkdirSync33(dirname28(row.outputPath), { recursive: true });
     const result = await options.renderOne(row);
     manifestRow.status = "completed";
     manifestRow.durationMs = result.durationMs ?? null;
@@ -114640,7 +114719,7 @@ __export(render_exports, {
   renderLocal: () => renderLocal,
   resolveBrowserGpuForCli: () => resolveBrowserGpuForCli
 });
-import { mkdirSync as mkdirSync33, readdirSync as readdirSync24, readFileSync as readFileSync41, statSync as statSync19, writeFileSync as writeFileSync23, rmSync as rmSync17 } from "fs";
+import { mkdirSync as mkdirSync34, readdirSync as readdirSync24, readFileSync as readFileSync41, statSync as statSync20, writeFileSync as writeFileSync23, rmSync as rmSync17 } from "fs";
 import { cpus as cpus4, freemem as freemem5, tmpdir as tmpdir5 } from "os";
 import { resolve as resolve44, dirname as dirname29, join as join67, basename as basename12 } from "path";
 import { execFileSync as execFileSync9, spawn as spawn14 } from "child_process";
@@ -114706,7 +114785,7 @@ function resolveDockerfilePath() {
   const devPath = resolve44(__dirname, "..", "src", "docker", "Dockerfile.render");
   for (const p2 of [builtPath, devPath]) {
     try {
-      statSync19(p2);
+      statSync20(p2);
       return p2;
     } catch {
       continue;
@@ -114735,7 +114814,7 @@ function ensureDockerImage(version2, platform10, quiet) {
   if (!quiet) console.log(c.dim(`  Building Docker image: ${tag} (${platform10})...`));
   const dockerfilePath = resolveDockerfilePath();
   const tmpDir = join67(tmpdir5(), `hyperframes-docker-${Date.now()}`);
-  mkdirSync33(tmpDir, { recursive: true });
+  mkdirSync34(tmpDir, { recursive: true });
   writeFileSync23(join67(tmpDir, "Dockerfile"), readFileSync41(dockerfilePath));
   const targetArch = platform10 === "linux/arm64" ? "arm64" : "amd64";
   try {
@@ -115133,14 +115212,14 @@ function printRenderComplete(outputPath, elapsedMs, quiet, outputDurationSeconds
   let fileSize = "unknown";
   let isDirectory = false;
   try {
-    const stat3 = statSync19(outputPath);
+    const stat3 = statSync20(outputPath);
     isDirectory = stat3.isDirectory();
     if (stat3.isDirectory()) {
       let total = 0;
       for (const entry of readdirSync24(outputPath, { withFileTypes: true })) {
         if (!entry.isFile()) continue;
         try {
-          total += statSync19(join67(outputPath, entry.name)).size;
+          total += statSync20(join67(outputPath, entry.name)).size;
         } catch {
         }
       }
@@ -115560,7 +115639,7 @@ var init_render = __esm({
         const timePart = now.toTimeString().slice(0, 8).replace(/:/g, "-");
         const batchOutputTemplate = args.output ? args.output : join67(rendersDir, `${project.name}_${datePart}_${timePart}_{index}${ext}`);
         const outputPath = args.output ? resolve44(args.output) : join67(rendersDir, `${project.name}_${datePart}_${timePart}${ext}`);
-        if (!batchPath) mkdirSync33(dirname29(outputPath), { recursive: true });
+        if (!batchPath) mkdirSync34(dirname29(outputPath), { recursive: true });
         const useDocker = args.docker ?? false;
         const useGpu = args.gpu ?? false;
         const browserGpuArg = args["browser-gpu"];
@@ -115618,7 +115697,7 @@ var init_render = __esm({
           console.log(c.warn("  GIF output is capped at 30fps. Use --fps 15 for smaller files."));
         }
         const pageNavigationTimeoutMs = resolveBrowserTimeoutMsArg(args["browser-timeout"]);
-        const entryFile = resolveCompositionEntryArg(args.composition, project.dir, statSync19);
+        const entryFile = resolveCompositionEntryArg(args.composition, project.dir, statSync20);
         let batchModule;
         let preparedBatch;
         if (batchPath) {
@@ -116171,7 +116250,7 @@ __export(beats_exports, {
   default: () => beats_default,
   examples: () => examples11
 });
-import { existsSync as existsSync66, readFileSync as readFileSync44, mkdirSync as mkdirSync34, writeFileSync as writeFileSync24 } from "fs";
+import { existsSync as existsSync66, readFileSync as readFileSync44, mkdirSync as mkdirSync35, writeFileSync as writeFileSync24 } from "fs";
 import { resolve as resolve45, join as join69, dirname as dirname31 } from "path";
 function fail(message) {
   console.error(c.error(message));
@@ -116243,7 +116322,7 @@ var init_beats2 = __esm({
           fail(`No beats detected in ${rel} \u2014 nothing written. (Track may be silent/ambient.)`);
         }
         const outPath = join69(project.dir, "beats", `${rel}.json`);
-        mkdirSync34(dirname31(outPath), { recursive: true });
+        mkdirSync35(dirname31(outPath), { recursive: true });
         writeFileSync24(outPath, serializeBeats(result.beatTimes, result.beatStrengths, rel));
         report(`beats/${rel}.json`, result, Boolean(args.json));
       }
@@ -116257,10 +116336,10 @@ __export(staticProjectServer_exports, {
   serveStaticProjectHtml: () => serveStaticProjectHtml
 });
 import { createServer } from "http";
-import { createReadStream as createReadStream3, existsSync as existsSync67, statSync as statSync20 } from "fs";
+import { createReadStream as createReadStream3, existsSync as existsSync67, statSync as statSync21 } from "fs";
 import { isAbsolute as isAbsolute13, relative as relative14, resolve as resolve46 } from "path";
 function serveFileWithRange(filePath, rangeHeader, res) {
-  const size = statSync20(filePath).size;
+  const size = statSync21(filePath).size;
   const headers = {
     "Content-Type": getMimeType(filePath),
     "Accept-Ranges": "bytes"
@@ -119459,7 +119538,7 @@ __export(keyframes_exports, {
   examples: () => examples14,
   surfaceComposition: () => surfaceComposition
 });
-import { existsSync as existsSync70, readFileSync as readFileSync47, statSync as statSync21 } from "fs";
+import { existsSync as existsSync70, readFileSync as readFileSync47, statSync as statSync23 } from "fs";
 import { resolve as resolve47, dirname as dirname33, basename as basename14 } from "path";
 function inlineScriptText(html) {
   const doc = new DOMParser().parseFromString(html, "text/html");
@@ -119941,7 +120020,7 @@ function resolveScope(args) {
   let comps;
   let projectName;
   let projectDir;
-  if (raw && raw.endsWith(".html") && existsSync70(raw) && statSync21(raw).isFile()) {
+  if (raw && raw.endsWith(".html") && existsSync70(raw) && statSync23(raw).isFile()) {
     comps = [surfaceComposition(readFileSync47(raw, "utf-8"), basename14(raw), raw)];
     projectName = basename14(raw);
     projectDir = dirname33(raw);
@@ -120151,7 +120230,7 @@ __export(info_exports, {
   examples: () => examples15,
   orientation: () => orientation
 });
-import { readFileSync as readFileSync48, readdirSync as readdirSync26, statSync as statSync23 } from "fs";
+import { readFileSync as readFileSync48, readdirSync as readdirSync26, statSync as statSync24 } from "fs";
 import { join as join73 } from "path";
 function orientation(width, height) {
   if (width > height) return "landscape";
@@ -120170,7 +120249,7 @@ function totalSize(dir) {
     if (entry.isDirectory()) {
       total += totalSize(path2);
     } else {
-      total += statSync23(path2).size;
+      total += statSync24(path2).size;
     }
   }
   return total;
@@ -120433,7 +120512,7 @@ __export(benchmark_exports, {
   default: () => benchmark_default,
   examples: () => examples17
 });
-import { existsSync as existsSync73, statSync as statSync24 } from "fs";
+import { existsSync as existsSync73, statSync as statSync25 } from "fs";
 import { resolve as resolve49, join as join74 } from "path";
 var examples17, FPS_30, FPS_60, DEFAULT_CONFIGS, benchmark_default;
 var init_benchmark = __esm({
@@ -120527,7 +120606,7 @@ var init_benchmark = __esm({
               const elapsedMs = Date.now() - startTime;
               let fileSize = null;
               if (existsSync73(outputPath)) {
-                const stat3 = statSync24(outputPath);
+                const stat3 = statSync25(outputPath);
                 fileSize = stat3.size;
               }
               runs.push({ elapsedMs, fileSize });
@@ -120784,7 +120863,7 @@ __export(manager_exports3, {
   modelPath: () => modelPath,
   selectProviders: () => selectProviders
 });
-import { existsSync as existsSync74, mkdirSync as mkdirSync35 } from "fs";
+import { existsSync as existsSync74, mkdirSync as mkdirSync36 } from "fs";
 import { homedir as homedir11, platform as platform8, arch } from "os";
 import { join as join75 } from "path";
 function isDevice(value) {
@@ -120831,7 +120910,7 @@ function modelPath(model = DEFAULT_MODEL2) {
 async function ensureModel2(model = DEFAULT_MODEL2, options) {
   const dest = modelPath(model);
   if (existsSync74(dest)) return dest;
-  mkdirSync35(MODELS_DIR2, { recursive: true });
+  mkdirSync36(MODELS_DIR2, { recursive: true });
   options?.onProgress?.(`Downloading ${model} weights (~168 MB)...`);
   await downloadFile(MODEL_URLS[model], dest);
   if (!existsSync74(dest)) {
@@ -121783,7 +121862,7 @@ var init_transcribe2 = __esm({
 });
 
 // src/tts/manager.ts
-import { existsSync as existsSync77, mkdirSync as mkdirSync36 } from "fs";
+import { existsSync as existsSync77, mkdirSync as mkdirSync37 } from "fs";
 import { homedir as homedir12 } from "os";
 import { join as join77 } from "path";
 function inferLangFromVoiceId(voiceId) {
@@ -121802,7 +121881,7 @@ async function ensureModel3(model = DEFAULT_MODEL3, options) {
       `Unknown TTS model: ${model}. Available: ${Object.keys(MODEL_URLS2).join(", ")}`
     );
   }
-  mkdirSync36(MODELS_DIR3, { recursive: true });
+  mkdirSync37(MODELS_DIR3, { recursive: true });
   options?.onProgress?.(`Downloading TTS model ${model} (~311 MB)...`);
   await downloadFile(url, modelPath2);
   if (!existsSync77(modelPath2)) {
@@ -121813,7 +121892,7 @@ async function ensureModel3(model = DEFAULT_MODEL3, options) {
 async function ensureVoices(options) {
   const voicesPath = join77(VOICES_DIR, "voices-v1.0.bin");
   if (existsSync77(voicesPath)) return voicesPath;
-  mkdirSync36(VOICES_DIR, { recursive: true });
+  mkdirSync37(VOICES_DIR, { recursive: true });
   options?.onProgress?.("Downloading voice data (~27 MB)...");
   await downloadFile(VOICES_URL, voicesPath);
   if (!existsSync77(voicesPath)) {
@@ -121945,12 +122024,12 @@ __export(synthesize_exports, {
   synthesize: () => synthesize
 });
 import { execFileSync as execFileSync11 } from "child_process";
-import { existsSync as existsSync78, writeFileSync as writeFileSync27, mkdirSync as mkdirSync37, readdirSync as readdirSync27, unlinkSync as unlinkSync5 } from "fs";
+import { existsSync as existsSync78, writeFileSync as writeFileSync27, mkdirSync as mkdirSync38, readdirSync as readdirSync27, unlinkSync as unlinkSync5 } from "fs";
 import { join as join78, dirname as dirname36, basename as basename15 } from "path";
 import { homedir as homedir13 } from "os";
 function ensureSynthScript() {
   if (!existsSync78(SCRIPT_PATH)) {
-    mkdirSync37(SCRIPT_DIR, { recursive: true });
+    mkdirSync38(SCRIPT_DIR, { recursive: true });
     writeFileSync27(SCRIPT_PATH, SYNTH_SCRIPT);
     const currentName = basename15(SCRIPT_PATH);
     try {
@@ -121991,7 +122070,7 @@ async function synthesize(text2, outputPath, options) {
     ensureVoices({ onProgress: options?.onProgress })
   ]);
   const scriptPath = ensureSynthScript();
-  mkdirSync37(dirname36(outputPath), { recursive: true });
+  mkdirSync38(dirname36(outputPath), { recursive: true });
   options?.onProgress?.(`Generating speech with voice ${voice} (${lang})...`);
   try {
     const stdout2 = execFileSync11(
@@ -123211,6 +123290,7 @@ var validate_exports = {};
 __export(validate_exports, {
   default: () => validate_default,
   extractCompositionErrorsFromLint: () => extractCompositionErrorsFromLint,
+  raceMediaReady: () => raceMediaReady,
   shouldIgnoreRequestFailure: () => shouldIgnoreRequestFailure
 });
 import { existsSync as existsSync81, readFileSync as readFileSync53 } from "fs";
@@ -123247,13 +123327,49 @@ async function seekTo2(page, time) {
   }, time);
   await new Promise((r2) => setTimeout(r2, SEEK_SETTLE_MS2));
 }
-async function auditClipDurations(page, analyzeClipMediaFit2) {
-  const clips = await page.evaluate(() => {
+function raceMediaReady(el, deadlineMs) {
+  if (Number.isFinite(el.duration) && el.duration > 0) return Promise.resolve();
+  return new Promise((resolve62) => {
+    const onReady = () => {
+      el.removeEventListener("loadedmetadata", onReady);
+      el.removeEventListener("error", onReady);
+      clearTimeout(timer);
+      resolve62();
+    };
+    el.addEventListener("loadedmetadata", onReady, { once: true });
+    el.addEventListener("error", onReady, { once: true });
+    const timer = setTimeout(onReady, Math.max(0, deadlineMs - Date.now()));
+  });
+}
+async function auditClipDurations(page, analyzeClipMediaFit2, extraWaitMs) {
+  const clips = await page.evaluate(async (maxWaitMs) => {
+    const nodes = Array.from(
+      document.querySelectorAll("video[data-duration], audio[data-duration]")
+    );
+    const deadline = Date.now() + maxWaitMs;
+    await Promise.all(
+      nodes.map((el) => {
+        if (Number.isFinite(el.duration) && el.duration > 0) return Promise.resolve();
+        return new Promise((resolve62) => {
+          const cleanup = () => {
+            el.removeEventListener("loadedmetadata", onReady);
+            el.removeEventListener("error", onReady);
+            clearTimeout(timer);
+          };
+          const onReady = () => {
+            cleanup();
+            resolve62();
+          };
+          el.addEventListener("loadedmetadata", onReady, { once: true });
+          el.addEventListener("error", onReady, { once: true });
+          const timer = setTimeout(onReady, Math.max(0, deadline - Date.now()));
+        });
+      })
+    );
     const rows = [];
-    document.querySelectorAll("video[data-duration], audio[data-duration]").forEach((node) => {
-      const el = node;
+    for (const el of nodes) {
       const slot = parseFloat(el.getAttribute("data-duration") ?? "");
-      if (!(slot > 0)) return;
+      if (!(slot > 0)) continue;
       rows.push({
         id: el.id || el.getAttribute("src") || `(${el.tagName.toLowerCase()})`,
         kind: el.tagName === "AUDIO" ? "Audio" : "Video",
@@ -123262,9 +123378,9 @@ async function auditClipDurations(page, analyzeClipMediaFit2) {
         duration: el.duration,
         loop: el.loop || el.getAttribute("data-loop") === "true"
       });
-    });
+    }
     return rows;
-  });
+  }, extraWaitMs);
   const warnings = [];
   const unreadable = [];
   for (const clip of clips) {
@@ -123383,7 +123499,7 @@ async function validateInBrowser(project, opts) {
     });
     await page.goto(server.url, { waitUntil: "domcontentloaded", timeout: 1e4 });
     await new Promise((r2) => setTimeout(r2, opts.timeout ?? 3e3));
-    for (const w3 of await auditClipDurations(page, analyzeClipMediaFit2)) {
+    for (const w3 of await auditClipDurations(page, analyzeClipMediaFit2, opts.timeout ?? 3e3)) {
       warnings.push(w3);
     }
     if (opts.contrast) {
@@ -129885,7 +130001,7 @@ var require_node_domexception = __commonJS({
 });
 
 // ../../node_modules/.bun/fetch-blob@3.2.0/node_modules/fetch-blob/from.js
-import { statSync as statSync25, createReadStream as createReadStream4, promises as fs2 } from "fs";
+import { statSync as statSync26, createReadStream as createReadStream4, promises as fs2 } from "fs";
 import { basename as basename17 } from "path";
 var import_node_domexception, stat, blobFromSync, blobFrom, fileFrom, fileFromSync, fromBlob, fromFile, BlobDataItem;
 var init_from = __esm({
@@ -129895,10 +130011,10 @@ var init_from = __esm({
     init_file();
     init_fetch_blob();
     ({ stat } = fs2);
-    blobFromSync = (path2, type) => fromBlob(statSync25(path2), path2, type);
+    blobFromSync = (path2, type) => fromBlob(statSync26(path2), path2, type);
     blobFrom = (path2, type) => stat(path2).then((stat3) => fromBlob(stat3, path2, type));
     fileFrom = (path2, type) => stat(path2).then((stat3) => fromFile(stat3, path2, type));
-    fileFromSync = (path2, type) => fromFile(statSync25(path2), path2, type);
+    fileFromSync = (path2, type) => fromFile(statSync26(path2), path2, type);
     fromBlob = (stat3, path2, type = "") => new fetch_blob_default([new BlobDataItem({
       path: path2,
       size: stat3.size,
@@ -143689,7 +143805,7 @@ var require_websocket = __commonJS({
     var http4 = __require("http");
     var net2 = __require("net");
     var tls = __require("tls");
-    var { randomBytes: randomBytes4, createHash: createHash14 } = __require("crypto");
+    var { randomBytes: randomBytes4, createHash: createHash15 } = __require("crypto");
     var { Duplex, Readable: Readable4 } = __require("stream");
     var { URL: URL2 } = __require("url");
     var PerMessageDeflate2 = require_permessage_deflate();
@@ -144349,7 +144465,7 @@ var require_websocket = __commonJS({
           abortHandshake(websocket, socket, "Invalid Upgrade header");
           return;
         }
-        const digest = createHash14("sha1").update(key2 + GUID).digest("base64");
+        const digest = createHash15("sha1").update(key2 + GUID).digest("base64");
         if (res.headers["sec-websocket-accept"] !== digest) {
           abortHandshake(websocket, socket, "Invalid Sec-WebSocket-Accept header");
           return;
@@ -144716,7 +144832,7 @@ var require_websocket_server = __commonJS({
     var EventEmitter = __require("events");
     var http4 = __require("http");
     var { Duplex } = __require("stream");
-    var { createHash: createHash14 } = __require("crypto");
+    var { createHash: createHash15 } = __require("crypto");
     var extension2 = require_extension();
     var PerMessageDeflate2 = require_permessage_deflate();
     var subprotocol2 = require_subprotocol();
@@ -145017,7 +145133,7 @@ var require_websocket_server = __commonJS({
           );
         }
         if (this._state > RUNNING) return abortHandshake(socket, 503);
-        const digest = createHash14("sha1").update(key2 + GUID).digest("base64");
+        const digest = createHash15("sha1").update(key2 + GUID).digest("base64");
         const headers = [
           "HTTP/1.1 101 Switching Protocols",
           "Upgrade: websocket",
@@ -156052,7 +156168,7 @@ async function uploadBlobInternal(file, uploadUrl, apiClient, httpOptions) {
         break;
       }
       retryCount++;
-      await sleep(currentDelayMs);
+      await sleep2(currentDelayMs);
       currentDelayMs = currentDelayMs * DELAY_MULTIPLIER;
     }
     offset2 += chunkSize;
@@ -156069,7 +156185,7 @@ async function getBlobStat(file) {
   const fileStat = { size: file.size, type: file.type };
   return fileStat;
 }
-function sleep(ms) {
+function sleep2(ms) {
   return new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
 }
 function resolveCloudFlag(options) {
@@ -163294,7 +163410,7 @@ ${underline2}`);
                 break;
               }
               retryCount++;
-              await sleep(currentDelayMs);
+              await sleep2(currentDelayMs);
               currentDelayMs = currentDelayMs * DELAY_MULTIPLIER;
             }
             offset2 += bytesRead;
@@ -163465,7 +163581,7 @@ __export(snapshot_exports, {
   tailFrameTime: () => tailFrameTime
 });
 import { spawn as spawn16 } from "child_process";
-import { existsSync as existsSync84, mkdtempSync as mkdtempSync5, readFileSync as readFileSync55, mkdirSync as mkdirSync38, rmSync as rmSync18, writeFileSync as writeFileSync29 } from "fs";
+import { existsSync as existsSync84, mkdtempSync as mkdtempSync5, readFileSync as readFileSync55, mkdirSync as mkdirSync39, rmSync as rmSync18, writeFileSync as writeFileSync29 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
 import { resolve as resolve55, join as join83, relative as relative15, isAbsolute as isAbsolute14, basename as basename19 } from "path";
 function orbitStageSource() {
@@ -163667,7 +163783,7 @@ async function captureSnapshots(projectDir, opts) {
       }
       const cameraExpr = opts.angle && (opts.angle.yaw !== 0 || opts.angle.pitch !== 0) ? `(${orbitStageSource()})(${JSON.stringify(opts.angle)})` : null;
       const snapshotDir = opts.outputDir ?? join83(projectDir, "snapshots");
-      mkdirSync38(snapshotDir, { recursive: true });
+      mkdirSync39(snapshotDir, { recursive: true });
       try {
         const { readdirSync: readdirSync35 } = await import("fs");
         for (const file of readdirSync35(snapshotDir)) {
@@ -163997,7 +164113,7 @@ ${c.error("\u2717")} Snapshot failed: ${msg}`);
 });
 
 // src/capture/assetDownloader.ts
-import { writeFileSync as writeFileSync30, mkdirSync as mkdirSync39 } from "fs";
+import { writeFileSync as writeFileSync30, mkdirSync as mkdirSync40 } from "fs";
 import { join as join84, extname as extname15 } from "path";
 import { createHash as createHash12 } from "crypto";
 function svgContentHashSlug(svgSource, isLogo) {
@@ -164006,10 +164122,10 @@ function svgContentHashSlug(svgSource, isLogo) {
 }
 async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks) {
   const assetsDir = join84(outputDir, "assets");
-  mkdirSync39(assetsDir, { recursive: true });
+  mkdirSync40(assetsDir, { recursive: true });
   const assets = [];
   const downloadedUrls = /* @__PURE__ */ new Set();
-  mkdirSync39(join84(outputDir, "assets", "svgs"), { recursive: true });
+  mkdirSync40(join84(outputDir, "assets", "svgs"), { recursive: true });
   const usedSvgNames = /* @__PURE__ */ new Set();
   for (let i2 = 0; i2 < tokens.svgs.length && i2 < 30; i2++) {
     const svg = tokens.svgs[i2];
@@ -164140,7 +164256,7 @@ function normalizeUrl(u) {
 }
 async function downloadAndRewriteFonts(css, outputDir) {
   const assetsDir = join84(outputDir, "assets", "fonts");
-  mkdirSync39(assetsDir, { recursive: true });
+  mkdirSync40(assetsDir, { recursive: true });
   const fontUrlRegex = /url\(['"]?(https?:\/\/[^'")\s]+\.(?:woff2?|ttf|otf)[^'")\s]*?)['"]?\)/g;
   const fontUrls = /* @__PURE__ */ new Set();
   let match;
@@ -164333,7 +164449,7 @@ __export(video_exports, {
   runVideoMode: () => runVideoMode,
   safeFilename: () => safeFilename
 });
-import { createWriteStream as createWriteStream4, existsSync as existsSync85, mkdirSync as mkdirSync40, readFileSync as readFileSync56, unlinkSync as unlinkSync7 } from "fs";
+import { createWriteStream as createWriteStream4, existsSync as existsSync85, mkdirSync as mkdirSync41, readFileSync as readFileSync56, unlinkSync as unlinkSync7 } from "fs";
 import { resolve as resolve56, join as join85, basename as basename20 } from "path";
 async function streamToFile(url, destPath) {
   const r2 = await safeFetch(url, {
@@ -164509,7 +164625,7 @@ async function runVideoMode(args) {
     return;
   }
   const outDir = isW2hLayout ? join85(projectDir, "capture", "assets", "videos") : join85(projectDir, "assets", "videos");
-  mkdirSync40(outDir, { recursive: true });
+  mkdirSync41(outDir, { recursive: true });
   const fname = safeFilename(entry.filename || basename20(entry.url));
   const outPath = join85(outDir, fname);
   const relPath = isW2hLayout ? `capture/assets/videos/${fname}` : `assets/videos/${fname}`;
@@ -165280,7 +165396,8 @@ var init_designStyleExtractor = __esm({
   function rgbToHex(color) {
     if (!color) return "";
     if (color.startsWith('#')) return color.toUpperCase();
-    var m = color.match(/rgba?\\(\\s*(\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)\\s*(?:,\\s*([\\d.]+))?/);
+    // capture optional alpha (group 4), allowing both comma and modern slash (rgb r g b / a) syntax.
+    var m = color.match(/rgba?\\(\\s*(\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)(?:\\s*[,/]\\s*([\\d.]+))?/);
     if (!m) return color;
     // fully-transparent fill (rgba(...,0)) \u2192 sentinel, NOT #000000 \u2014 otherwise a transparent
     // chip/tab/stat ground reads as solid black on a light-ground site.
@@ -165292,8 +165409,15 @@ var init_designStyleExtractor = __esm({
     return f.split(",")[0].replace(/['"]/g, "").trim();
   }
 
+  // keep only gradient background-images (drop url() sprites + "none"); gradients are a core
+  // brand signal (Stripe/ElevenLabs/Snowflake mesh washes) that a flat background-color misses.
+  function gradientOf(v) {
+    return v && v.indexOf("gradient") >= 0 ? v.trim() : "";
+  }
+
   function getStyles(el) {
     var s = getComputedStyle(el);
+    var bf = s.backdropFilter || s.webkitBackdropFilter || "";
     return {
       fontFamily: cleanFont(s.fontFamily),
       fontSize: s.fontSize,
@@ -165302,6 +165426,8 @@ var init_designStyleExtractor = __esm({
       letterSpacing: s.letterSpacing,
       color: rgbToHex(s.color),
       background: rgbToHex(s.backgroundColor),
+      backgroundImage: gradientOf(s.backgroundImage),
+      backdropFilter: bf === "none" ? "" : bf,
       padding: s.padding,
       borderRadius: s.borderRadius,
       border: s.border,
@@ -165370,23 +165496,37 @@ var init_designStyleExtractor = __esm({
   }
 
   // \u2500\u2500 2. Buttons \u2500\u2500
+  // a page's primary CTA is very often a FILLED pill in the nav/header ("Sign up", "Start for free").
+  // Old code dropped everything under <nav>, losing that CTA; keep nav elements that carry a solid
+  // fill (a real button), still dropping plain nav text links.
+  var isFilledEl = (el) => {
+    var cs = getComputedStyle(el);
+    var bg = cs.backgroundColor;
+    var solid = !!bg && bg !== "transparent" && !/rgba?\\([^)]*,\\s*0\\s*\\)/.test(bg);
+    // a gradient-filled CTA (e.g. Snowflake's blue pill = background: var(--ui-background-03)) has a
+    // transparent background-COLOR but a gradient background-IMAGE \u2014 count it as filled too.
+    return solid || (cs.backgroundImage || "").indexOf("gradient") >= 0;
+  };
   var buttonEls = Array.from(document.querySelectorAll(
     'button, a[class*="btn"], a[class*="button"], a[role="button"], ' +
     '[class*="btn-"], [class*="button-"], [class*="cta"]'
   )).filter(function(el) {
-    return isVisible(el) && !el.closest('nav, [role="navigation"]');
-  }).slice(0, 10);
+    if (!isVisible(el)) return false;
+    return el.closest('nav, [role="navigation"]') ? isFilledEl(el) : true;
+  }).slice(0, 16);
 
   var buttonMap = {};
   for (var bi = 0; bi < buttonEls.length; bi++) {
     var bs = getStyles(buttonEls[bi]);
-    // Deduplicate by visual appearance
-    var bKey = bs.background + "|" + bs.borderRadius + "|" + bs.border;
+    // Deduplicate by visual appearance (gradient fill kept distinct so a gradient CTA survives)
+    var bKey = bs.background + "|" + bs.backgroundImage + "|" + bs.borderRadius + "|" + bs.border;
     if (!buttonMap[bKey]) {
       var btnText = (buttonEls[bi].textContent || "").trim().slice(0, 40);
       buttonMap[bKey] = {
         label: btnText || "button",
         background: bs.background,
+        backgroundImage: bs.backgroundImage,
+        backdropFilter: bs.backdropFilter,
         color: bs.color,
         padding: bs.padding,
         borderRadius: bs.borderRadius,
@@ -165398,7 +165538,7 @@ var init_designStyleExtractor = __esm({
       };
     }
   }
-  var buttons = Object.values(buttonMap).slice(0, 4);
+  var buttons = Object.values(buttonMap).slice(0, 6);
 
   // \u2500\u2500 3. Cards / containers \u2500\u2500
   var cardEls = Array.from(document.querySelectorAll(
@@ -165413,11 +165553,14 @@ var init_designStyleExtractor = __esm({
   var cardMap = {};
   for (var ci = 0; ci < cardEls.length; ci++) {
     var cs = getStyles(cardEls[ci]);
-    var cKey = cs.background + "|" + cs.borderRadius + "|" + cs.border;
+    // gradient fill + glass blur kept in the key so a gradient/frosted card is a distinct variant
+    var cKey = cs.background + "|" + cs.backgroundImage + "|" + cs.backdropFilter + "|" + cs.borderRadius + "|" + cs.border;
     if (!cardMap[cKey]) {
       cardMap[cKey] = {
         label: "card",
         background: cs.background,
+        backgroundImage: cs.backgroundImage,
+        backdropFilter: cs.backdropFilter,
         color: cs.color,
         padding: cs.padding,
         borderRadius: cs.borderRadius,
@@ -165439,6 +165582,8 @@ var init_designStyleExtractor = __esm({
     nav = {
       label: "navigation",
       background: ns.background,
+      backgroundImage: ns.backgroundImage,
+      backdropFilter: ns.backdropFilter,
       color: ns.color,
       padding: ns.padding,
       borderRadius: ns.borderRadius,
@@ -165622,6 +165767,90 @@ var init_designStyleExtractor = __esm({
     .slice(0, 5)
     .map(function(e) { return { value: e[0], count: e[1] }; });
 
+  // \u2500\u2500 8. Dominant gradient / mesh backgrounds \u2500\u2500
+  // A site's signature color wash (Stripe/ElevenLabs/Snowflake) lives in gradient background-images
+  // on large blocks \u2014 often on a pseudo-element (::before glow orbs) rather than the block itself.
+  // Weight each distinct gradient by the total on-screen area it covers; return the top few.
+  var gradientArea = {};
+  var gradSamples = Array.from(document.querySelectorAll(
+    "body, main, section, header, div, [class*='hero'], [class*='gradient'], [class*='bg'], [class*='background']"
+  )).slice(0, 400);
+
+  // max stop chroma (max\u2212min RGB) of a gradient: a vivid brand wash scores high, a neutral
+  // white/cream scrim ~0. Used to rank washes so a small vivid gradient beats a big grey scrim.
+  function gradientChroma(g) {
+    var max = 0, re = /rgba?\\(\\s*(\\d+)[,\\s]+(\\d+)[,\\s]+(\\d+)/g, m;
+    while ((m = re.exec(g))) {
+      var r = +m[1], gr = +m[2], b = +m[3];
+      var c = Math.max(r, gr, b) - Math.min(r, gr, b);
+      if (c > max) max = c;
+    }
+    return max;
+  }
+
+  function addGradient(val, area) {
+    var g = gradientOf(val);
+    if (!g || area < 20000) return; // ignore tiny decorative gradients
+    var norm = g.replace(/\\s+/g, " ");
+    gradientArea[norm] = (gradientArea[norm] || 0) + area;
+  }
+
+  for (var gi = 0; gi < gradSamples.length; gi++) {
+    var gel = gradSamples[gi];
+    if (!isVisible(gel)) continue;
+    var grect = gel.getBoundingClientRect();
+    var garea = grect.width * grect.height;
+    if (garea < 20000) continue;
+    addGradient(getComputedStyle(gel).backgroundImage, garea);
+    addGradient(getComputedStyle(gel, "::before").backgroundImage, garea);
+    addGradient(getComputedStyle(gel, "::after").backgroundImage, garea);
+  }
+
+  // rank by chroma-weighted area so the brand's signature color wash outranks a larger neutral scrim
+  var backgrounds = Object.entries(gradientArea)
+    .map(function(e) { return { value: e[0], area: Math.round(e[1]), score: e[1] * (1 + 2 * gradientChroma(e[0]) / 255) }; })
+    .sort(function(a, b) { return b.score - a.score; })
+    .slice(0, 6)
+    .map(function(e) { return { value: e.value, area: e.area }; });
+
+  // \u2500\u2500 9. Frosted-glass panels (backdrop-filter) \u2500\u2500
+  // A defining material on modern hero UIs (HeyGen's prompt box, Stripe's floating chrome): a
+  // translucent surface with a backdrop blur. Capture the RAW fill (rgba/gradient \u2014 alpha preserved,
+  // unlike rgbToHex) + the blur, ranked by area. This is what lets a frame render a real frosted card.
+  var glassSamples = Array.from(document.querySelectorAll(
+    "div, section, header, nav, aside, [class*='card'], [class*='panel'], [class*='glass'], [class*='blur'], [class*='modal'], [class*='overlay'], [class*='input']"
+  )).slice(0, 400);
+  var glassByKey = {};
+  for (var qi = 0; qi < glassSamples.length; qi++) {
+    var qel = glassSamples[qi];
+    if (!isVisible(qel)) continue;
+    var qs = getComputedStyle(qel);
+    var bf = qs.backdropFilter || qs.webkitBackdropFilter || "";
+    if (!bf || bf === "none" || bf.indexOf("blur") < 0) continue;
+    var qrect = qel.getBoundingClientRect();
+    var qarea = qrect.width * qrect.height;
+    if (qarea < 8000) continue; // ignore tiny blurred chips
+    // raw fill with alpha intact: prefer a translucent gradient, else the rgba background-color
+    var gi2 = qs.backgroundImage;
+    var rawFill = gi2 && gi2.indexOf("gradient") >= 0 ? gi2.replace(/\\s+/g, " ").trim() : qs.backgroundColor;
+    var key = bf + "|" + rawFill + "|" + qs.borderRadius;
+    if (!glassByKey[key]) {
+      glassByKey[key] = {
+        backdropFilter: bf,
+        background: rawFill,
+        border: qs.border,
+        borderRadius: qs.borderRadius,
+        boxShadow: qs.boxShadow === "none" ? "" : qs.boxShadow,
+        area: 0
+      };
+    }
+    glassByKey[key].area += qarea;
+  }
+  var glass = Object.values(glassByKey)
+    .sort(function(a, b) { return b.area - a.area; })
+    .slice(0, 3)
+    .map(function(g) { return { backdropFilter: g.backdropFilter, background: g.background, border: g.border, borderRadius: g.borderRadius, boxShadow: g.boxShadow, area: Math.round(g.area) }; });
+
   return {
     typography: uniqueTypo,
     spacing: { observed: observedSpacing.slice(0, 15), baseUnit: baseUnit },
@@ -165632,7 +165861,9 @@ var init_designStyleExtractor = __esm({
     nav: nav,
     chips: chips,
     statCells: statCells,
-    tabs: tabs
+    tabs: tabs,
+    backgrounds: backgrounds,
+    glass: glass
   };
 })()`;
   }
@@ -165962,7 +166193,7 @@ var init_animationCataloger = __esm({
 });
 
 // src/capture/mediaCapture.ts
-import { mkdirSync as mkdirSync41, writeFileSync as writeFileSync33, readdirSync as readdirSync30, readFileSync as readFileSync58, statSync as statSync26 } from "fs";
+import { mkdirSync as mkdirSync43, writeFileSync as writeFileSync33, readdirSync as readdirSync30, readFileSync as readFileSync58, statSync as statSync27 } from "fs";
 import { join as join87, extname as extname16 } from "path";
 async function saveLottieAnimations(discoveredLotties, lottieDir) {
   let savedCount = 0;
@@ -166024,7 +166255,7 @@ async function saveLottieAnimations(discoveredLotties, lottieDir) {
 async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
   const manifest = [];
   const previewDir = join87(lottieDir, "previews");
-  mkdirSync41(previewDir, { recursive: true });
+  mkdirSync43(previewDir, { recursive: true });
   for (const file of readdirSync30(lottieDir)) {
     if (!file.endsWith(".json")) continue;
     try {
@@ -166032,7 +166263,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
       const fr = raw.fr || 30;
       const dur = ((raw.op || 0) - (raw.ip || 0)) / fr;
       const previewName = file.replace(".json", "-preview.png");
-      const fileSize = statSync26(join87(lottieDir, file)).size;
+      const fileSize = statSync27(join87(lottieDir, file)).size;
       if (fileSize > 2e6) continue;
       let previewPage;
       try {
@@ -166190,9 +166421,9 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
   const merged = [...byKey.values()];
   if (merged.length === 0) return;
   const videoManifestDir = join87(outputDir, "assets", "videos");
-  mkdirSync41(videoManifestDir, { recursive: true });
+  mkdirSync43(videoManifestDir, { recursive: true });
   const previewDir = join87(videoManifestDir, "previews");
-  mkdirSync41(previewDir, { recursive: true });
+  mkdirSync43(previewDir, { recursive: true });
   const videoManifest = [];
   const dlStart = Date.now();
   for (let vi = 0; vi < merged.length && vi < 20; vi++) {
@@ -166314,7 +166545,7 @@ var init_mediaCapture = __esm({
 });
 
 // src/capture/contentExtractor.ts
-import { existsSync as existsSync87, readdirSync as readdirSync31, statSync as statSync27, readFileSync as readFileSync59 } from "fs";
+import { existsSync as existsSync87, readdirSync as readdirSync31, statSync as statSync28, readFileSync as readFileSync59 } from "fs";
 import { basename as basename21, join as join88 } from "path";
 async function detectLibraries(page, capturedShaders) {
   let detectedLibraries = [];
@@ -166491,7 +166722,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
       const results = await Promise.allSettled(
         batch.map(async (file) => {
           const filePath = join88(outputDir, "assets", file);
-          const stat3 = statSync27(filePath);
+          const stat3 = statSync28(filePath);
           if (stat3.size > 4e6) return { file, caption: "" };
           const buffer = readFileSync59(filePath);
           const base64 = buffer.toString("base64");
@@ -166615,7 +166846,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
     for (const file of readdirSync31(assetsPath)) {
       if (file === "svgs" || file === "fonts" || file === "lottie" || file === "videos") continue;
       const filePath = join88(assetsPath, file);
-      const stat3 = statSync27(filePath);
+      const stat3 = statSync28(filePath);
       if (!stat3.isFile()) continue;
       const sizeKb = Math.round(stat3.size / 1024);
       const catalogMatch = catalogedAssets.find(
@@ -166898,11 +167129,11 @@ var screenshotCapture_exports = {};
 __export(screenshotCapture_exports, {
   captureScrollScreenshots: () => captureScrollScreenshots
 });
-import { writeFileSync as writeFileSync36, mkdirSync as mkdirSync43 } from "fs";
+import { writeFileSync as writeFileSync36, mkdirSync as mkdirSync44 } from "fs";
 import { join as join91 } from "path";
 async function captureScrollScreenshots(page, outputDir) {
   const screenshotsDir = join91(outputDir, "screenshots");
-  mkdirSync43(screenshotsDir, { recursive: true });
+  mkdirSync44(screenshotsDir, { recursive: true });
   const MAX_SCREENSHOTS = 20;
   const filePaths = [];
   try {
@@ -167342,7 +167573,7 @@ var capture_exports = {};
 __export(capture_exports, {
   captureWebsite: () => captureWebsite
 });
-import { mkdirSync as mkdirSync44, writeFileSync as writeFileSync37, existsSync as existsSync90 } from "fs";
+import { mkdirSync as mkdirSync45, writeFileSync as writeFileSync37, existsSync as existsSync90 } from "fs";
 import { join as join93 } from "path";
 async function captureWebsite(opts, onProgress) {
   const {
@@ -167360,9 +167591,9 @@ async function captureWebsite(opts, onProgress) {
     onProgress?.(stage, detail);
   };
   loadEnvFile(outputDir);
-  mkdirSync44(join93(outputDir, "extracted"), { recursive: true });
-  mkdirSync44(join93(outputDir, "screenshots"), { recursive: true });
-  mkdirSync44(join93(outputDir, "assets"), { recursive: true });
+  mkdirSync45(join93(outputDir, "extracted"), { recursive: true });
+  mkdirSync45(join93(outputDir, "screenshots"), { recursive: true });
+  mkdirSync45(join93(outputDir, "assets"), { recursive: true });
   progress("browser", "Launching headless Chrome...");
   const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
   const browser = await ensureBrowser2();
@@ -167523,7 +167754,7 @@ async function captureWebsite(opts, onProgress) {
     }
     if (discoveredLotties.length > 0) {
       const lottieDir = join93(outputDir, "assets", "lottie");
-      mkdirSync44(lottieDir, { recursive: true });
+      mkdirSync45(lottieDir, { recursive: true });
       const savedCount = await saveLottieAnimations(discoveredLotties, lottieDir);
       if (savedCount > 0) {
         await renderLottiePreviews(chromeBrowser, lottieDir, outputDir);
@@ -168025,8 +168256,8 @@ var init_capture2 = __esm({
         } catch (err) {
           const errMsg = normalizeErrorMessage(err);
           try {
-            const { mkdirSync: mkdirSync49, writeFileSync: writeFileSync40 } = await import("fs");
-            mkdirSync49(outputDir, { recursive: true });
+            const { mkdirSync: mkdirSync50, writeFileSync: writeFileSync40 } = await import("fs");
+            mkdirSync50(outputDir, { recursive: true });
             const isTimeout = /timeout|timed out/i.test(errMsg);
             const reason = isTimeout ? "Page navigation timed out \u2014 the site may be blocking headless browsers or requires authentication." : `Capture failed: ${errMsg}`;
             writeFileSync40(
@@ -168072,14 +168303,14 @@ __export(state_exports, {
   stateFilePath: () => stateFilePath,
   writeStackOutputs: () => writeStackOutputs
 });
-import { existsSync as existsSync91, mkdirSync as mkdirSync45, readdirSync as readdirSync34, readFileSync as readFileSync61, rmSync as rmSync19, writeFileSync as writeFileSync38 } from "fs";
+import { existsSync as existsSync91, mkdirSync as mkdirSync46, readdirSync as readdirSync34, readFileSync as readFileSync61, rmSync as rmSync19, writeFileSync as writeFileSync38 } from "fs";
 import { dirname as dirname40, join as join94 } from "path";
 function stateFilePath(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   return join94(cwd, STATE_DIR_NAME, `${STATE_FILE_PREFIX}${stackName}.json`);
 }
 function writeStackOutputs(outputs, cwd = process.cwd()) {
   const path2 = stateFilePath(outputs.stackName, cwd);
-  mkdirSync45(dirname40(path2), { recursive: true });
+  mkdirSync46(dirname40(path2), { recursive: true });
   writeFileSync38(path2, JSON.stringify(outputs, null, 2) + "\n");
   return path2;
 }
@@ -168563,10 +168794,10 @@ async function waitForCompletion(executionArn, stack, intervalMs, json) {
       }
       return;
     }
-    await sleep2(intervalMs);
+    await sleep3(intervalMs);
   }
 }
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((res) => setTimeout(res, ms));
 }
 var init_render2 = __esm({
@@ -169632,7 +169863,7 @@ __export(cloudrun_exports, {
 });
 import { spawnSync as spawnSync6 } from "child_process";
 import { createRequire as createRequire4 } from "module";
-import { existsSync as existsSync97, mkdirSync as mkdirSync46, readFileSync as readFileSync66, writeFileSync as writeFileSync39 } from "fs";
+import { existsSync as existsSync97, mkdirSync as mkdirSync47, readFileSync as readFileSync66, writeFileSync as writeFileSync39 } from "fs";
 import { homedir as homedir14 } from "os";
 import { dirname as dirname42, join as join100, resolve as resolve61 } from "path";
 function stateDir() {
@@ -169642,7 +169873,7 @@ function statePath() {
   return join100(stateDir(), "cloudrun-state.json");
 }
 function writeState(state) {
-  mkdirSync46(stateDir(), { recursive: true });
+  mkdirSync47(stateDir(), { recursive: true });
   writeFileSync39(statePath(), JSON.stringify(state, null, 2));
 }
 function readState(args) {
@@ -169805,7 +170036,7 @@ function findRepoRoot(tfDir) {
 }
 function writeCloudBuildConfig(image) {
   const cfgPath = join100(stateDir(), "cloudrun-cloudbuild.yaml");
-  mkdirSync46(stateDir(), { recursive: true });
+  mkdirSync47(stateDir(), { recursive: true });
   writeFileSync39(
     cfgPath,
     [
@@ -170380,7 +170611,7 @@ async function pollUntilTerminal(client, renderId, options = {}) {
   const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
   const maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
   const now = options.now ?? (() => Date.now());
-  const sleep3 = options.sleep ?? defaultAbortableSleep(options.signal);
+  const sleep5 = options.sleep ?? defaultAbortableSleep(options.signal);
   const started = now();
   while (true) {
     if (options.signal?.aborted) {
@@ -170395,7 +170626,7 @@ async function pollUntilTerminal(client, renderId, options = {}) {
     if (elapsed >= maxWaitMs) {
       throw new PollTimeoutError(detail, elapsed);
     }
-    await sleep3(intervalMs);
+    await sleep5(intervalMs);
   }
 }
 function signalAbortError(signal) {
@@ -170436,7 +170667,7 @@ var init_poll = __esm({
 });
 
 // src/cloud/download.ts
-import { createWriteStream as createWriteStream5, mkdirSync as mkdirSync47, unlinkSync as unlinkSync8 } from "fs";
+import { createWriteStream as createWriteStream5, mkdirSync as mkdirSync48, unlinkSync as unlinkSync8 } from "fs";
 import { dirname as dirname43 } from "path";
 async function downloadToFile(url, destPath, options = {}) {
   const fetchImpl = options.fetchImpl ?? fetch;
@@ -170447,7 +170678,7 @@ async function downloadToFile(url, destPath, options = {}) {
   if (!res.body) {
     throw new Error(`Failed to download ${url}: empty response body`);
   }
-  mkdirSync47(dirname43(destPath), { recursive: true });
+  mkdirSync48(dirname43(destPath), { recursive: true });
   const totalHeader = res.headers.get("content-length");
   const total = totalHeader ? Number.parseInt(totalHeader, 10) : void 0;
   const totalOpt = total !== void 0 && Number.isFinite(total) ? total : void 0;
@@ -170653,6 +170884,33 @@ var init_client2 = __esm({
           signal: args.signal
         });
       }
+      /**
+       * Create Asset Upload
+       *
+       * Begin a direct-to-S3 upload. Returns an asset_id and a presigned upload_url; PUT the file bytes to upload_url, then call POST /v3/assets/{asset_id}/complete. Unlike POST /v3/assets (which proxies the bytes), this never sends the file through the API.
+       */
+      async createAssetUpload(args) {
+        return await this.request({
+          method: "POST",
+          path: "/v3/assets/direct-uploads",
+          body: args.body,
+          idempotencyKey: args.idempotencyKey,
+          signal: args.signal
+        });
+      }
+      /**
+       * Complete Asset Upload
+       *
+       * Finalize a direct-to-S3 upload into a reusable asset. Call after the upload PUT returns 200. Idempotent: repeated calls return the same finalized asset.
+       */
+      async completeAssetUpload(args) {
+        return await this.request({
+          method: "POST",
+          path: `/v3/assets/${encodeURIComponent(args.asset_id)}/complete`,
+          body: args.body,
+          signal: args.signal
+        });
+      }
       /**
        * Create HyperFrames Render
        *
@@ -171782,7 +172040,7 @@ var init_errors2 = __esm({
     init_format();
     init_client2();
     ERROR_CODE_HINTS = {
-      hyperframes_project_too_large: "The zip exceeded the 32 MB limit. Trim large media (or pre-host them and reference by URL), then try again.",
+      hyperframes_project_too_large: "The zip exceeded the 200 MB limit. Trim large media (or pre-host them and reference by URL), then try again.",
       hyperframes_render_not_found: "The render_id no longer exists \u2014 either soft-deleted or never created.",
       invalid_parameter: "Check the listed parameter against `hyperframes cloud render --help` for the accepted values.",
       authentication_failed: "Run `hyperframes auth status` to confirm your credential; `hyperframes auth login` to re-auth.",
@@ -171848,6 +172106,91 @@ var init_parsing = __esm({
   }
 });
 
+// src/cloud/upload.ts
+import { createHash as createHash14 } from "crypto";
+function sha256Hex2(bytes) {
+  return createHash14("sha256").update(bytes).digest("hex");
+}
+function sleep4(ms) {
+  return new Promise((r2) => setTimeout(r2, ms));
+}
+function normalizeUploadHeaders(raw) {
+  const out = {};
+  for (const [k2, v2] of Object.entries(raw ?? {})) {
+    if (typeof v2 === "string") out[k2] = v2;
+    else if (typeof v2 === "number" || typeof v2 === "boolean") out[k2] = String(v2);
+  }
+  return out;
+}
+async function putBytesToPresignedUrl(fetchImpl, uploadUrl, uploadHeaders, bytes) {
+  const headers = {
+    "content-type": CONTENT_TYPE_ZIP,
+    ...normalizeUploadHeaders(uploadHeaders)
+  };
+  const res = await fetchImpl(uploadUrl, {
+    method: "PUT",
+    headers,
+    body: bytes
+  });
+  if (!res.ok) {
+    const detail = await res.text().catch(() => "");
+    throw new Error(
+      `Direct upload PUT failed: ${res.status} ${res.statusText}${detail ? ` \u2014 ${detail.slice(0, 300)}` : ""}`
+    );
+  }
+}
+async function completeWithRetry(client, asset_id, checksum_sha256) {
+  let lastErr;
+  for (let attempt = 0; attempt < COMPLETE_MAX_RETRIES; attempt++) {
+    try {
+      return await client.completeAssetUpload({
+        asset_id,
+        body: { checksum_sha256 }
+      });
+    } catch (err) {
+      const retryable = err instanceof HyperframesApiError && err.status === 409;
+      if (!retryable || attempt === COMPLETE_MAX_RETRIES - 1) {
+        throw err;
+      }
+      lastErr = err;
+      await sleep4(COMPLETE_RETRY_BASE_MS * (attempt + 1));
+    }
+  }
+  throw lastErr ?? new Error("completeAssetUpload retries exhausted");
+}
+async function uploadZipViaDirectUpload(opts) {
+  const start = Date.now();
+  const { bytes, filename, idempotencyKey } = opts;
+  const size_bytes = bytes.byteLength;
+  const checksum_sha256 = sha256Hex2(bytes);
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  opts.onProgress?.({ phase: "initialize" });
+  const initialize = await opts.client.createAssetUpload({
+    body: { filename, content_type: CONTENT_TYPE_ZIP, size_bytes, checksum_sha256 },
+    idempotencyKey
+  });
+  opts.onProgress?.({ phase: "upload", percent: 0 });
+  await putBytesToPresignedUrl(fetchImpl, initialize.upload_url, initialize.upload_headers, bytes);
+  opts.onProgress?.({ phase: "upload", percent: 100 });
+  opts.onProgress?.({ phase: "complete" });
+  const completed = await completeWithRetry(opts.client, initialize.asset_id, checksum_sha256);
+  return {
+    asset_id: completed.asset_id,
+    size_bytes,
+    duration_ms: Date.now() - start
+  };
+}
+var COMPLETE_MAX_RETRIES, COMPLETE_RETRY_BASE_MS, CONTENT_TYPE_ZIP;
+var init_upload = __esm({
+  "src/cloud/upload.ts"() {
+    "use strict";
+    init_client2();
+    COMPLETE_MAX_RETRIES = 5;
+    COMPLETE_RETRY_BASE_MS = 500;
+    CONTENT_TYPE_ZIP = "application/zip";
+  }
+});
+
 // src/cloud/statusColor.ts
 function colorStatus(status) {
   switch (status) {
@@ -172008,22 +172351,25 @@ async function maybeUploadProject(client, source, asJson, idempotencyKey) {
   }
   if (!asJson) {
     console.log("");
-    console.log(`${c.accent("\u25C6")}  Uploading to /v3/assets`);
+    console.log(`${c.accent("\u25C6")}  Uploading (direct-to-S3)`);
   }
   const uploadStart = Date.now();
   let uploaded;
   try {
-    uploaded = await client.uploadAsset({
-      file: archive.buffer,
+    uploaded = await uploadZipViaDirectUpload({
+      client,
+      bytes: archive.buffer,
       filename: `${project.name}.zip`,
-      // Tag the multipart part with application/zip so downstream
-      // proxies / WAFs / any server-side path that keys off the
-      // part Content-Type see the intended type. The asset
-      // controller currently sniffs magic bytes from the file
-      // bytes, so this is belt-and-suspenders today; without it,
-      // FormData defaults to application/octet-stream.
-      mimeType: "application/zip",
-      idempotencyKey
+      idempotencyKey,
+      onProgress: !asJson ? (ev) => {
+        if (ev.phase === "initialize") {
+          console.log(c.dim(`   initializing\u2026`));
+        } else if (ev.phase === "upload" && ev.percent === 0) {
+          console.log(c.dim(`   uploading to S3\u2026`));
+        } else if (ev.phase === "complete") {
+          console.log(c.dim(`   finalizing\u2026`));
+        }
+      } : void 0
     });
   } catch (err) {
     reportApiError("Upload failed", err);
@@ -172160,6 +172506,7 @@ var init_render3 = __esm({
     init_cloud();
     init_errors2();
     init_parsing();
+    init_upload();
     init_statusColor();
     VALID_QUALITY2 = ["draft", "standard", "high"];
     VALID_FORMAT2 = ["mp4", "webm", "mov"];
@@ -173600,7 +173947,7 @@ __export(autoUpdate_exports, {
   scheduleBackgroundInstall: () => scheduleBackgroundInstall
 });
 import { spawn as spawn17 } from "child_process";
-import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync48, openSync as openSync3 } from "fs";
+import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync49, openSync as openSync3 } from "fs";
 import { homedir as homedir16 } from "os";
 import { join as join103 } from "path";
 import { compareVersions as compareVersions3 } from "compare-versions";
@@ -173617,14 +173964,14 @@ function majorOf(version2) {
 }
 function log(line2) {
   try {
-    mkdirSync48(CONFIG_DIR2, { recursive: true, mode: 448 });
+    mkdirSync49(CONFIG_DIR2, { recursive: true, mode: 448 });
     appendFileSync2(LOG_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${line2}
 `, { mode: 384 });
   } catch {
   }
 }
 function launchDetachedInstall(installCommand, version2) {
-  mkdirSync48(CONFIG_DIR2, { recursive: true, mode: 448 });
+  mkdirSync49(CONFIG_DIR2, { recursive: true, mode: 448 });
   const configFile = join103(CONFIG_DIR2, "config.json");
   const nodeScript = `
     const { exec } = require("node:child_process");