hyperframes 0.8.62 → 0.8.63

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.62" : "0.0.0-dev";
+    VERSION = true ? "0.8.63" : "0.0.0-dev";
   }
 });
 
@@ -4887,7 +4887,7 @@ var require_util = __commonJS({
       return path;
     }
     exports.normalize = normalize3;
-    function join163(aRoot, aPath) {
+    function join164(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -4919,7 +4919,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports.join = join163;
+    exports.join = join164;
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -5092,7 +5092,7 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join163(urlGenerate(parsed), sourceURL);
+        sourceURL = join164(urlGenerate(parsed), sourceURL);
       }
       return normalize3(sourceURL);
     }
@@ -60906,8 +60906,8 @@ function redactKnownPaths(value, paths) {
   for (const path of paths) {
     if (typeof path !== "string" || path.length === 0)
       continue;
-    const basename34 = path.split(/[\\/]/).pop() ?? "";
-    for (const literal2 of [path, basename34].filter((v2) => v2.length > 2)) {
+    const basename35 = path.split(/[\\/]/).pop() ?? "";
+    for (const literal2 of [path, basename35].filter((v2) => v2.length > 2)) {
       out = out.split(literal2).join("[path]");
     }
   }
@@ -66117,17 +66117,22 @@ var BrowserLeasePool;
 var init_browserLeasePool = __esm({
   "../engine/src/services/browserLeasePool.ts"() {
     "use strict";
-    BrowserLeasePool = class {
+    BrowserLeasePool = class _BrowserLeasePool {
       constructor(options) {
         this.options = options;
       }
       options;
+      /** Under the CLI's 3s exit watchdog, alongside the render-wait bound it races. */
+      static DRAIN_FORCE_CLOSE_MS = 1e3;
       available = /* @__PURE__ */ new Map();
       entries = /* @__PURE__ */ new Set();
       leasesByBrowser = /* @__PURE__ */ new Map();
       drainPromise = null;
+      closed = false;
       async acquire(fingerprintInput, pooled) {
+        if (this.closed) throw new Error("Browser pool is closed; no new browsers can be acquired");
         if (this.drainPromise) await this.drainPromise;
+        if (this.closed) throw new Error("Browser pool is closed; no new browsers can be acquired");
         const fingerprint = freezeFingerprint(fingerprintInput);
         const entry = this.reserveEntry(fingerprint, pooled);
         return this.issueLease(entry);
@@ -66186,17 +66191,30 @@ var init_browserLeasePool = __esm({
         if (this.drainPromise) return this.drainPromise;
         const entries2 = [...this.entries];
         for (const entry of entries2) this.requestClose(entry, false);
-        this.drainPromise = Promise.all(entries2.map((entry) => entry.closePromise)).then(() => {
+        const settle = Promise.all(entries2.map((entry) => entry.closePromise));
+        const bound = new Promise(
+          (resolve84) => setTimeout(resolve84, _BrowserLeasePool.DRAIN_FORCE_CLOSE_MS).unref()
+        );
+        this.drainPromise = Promise.race([settle, bound]).then(() => {
+          for (const entry of entries2) if (this.entries.has(entry)) this.requestClose(entry, true);
+          return settle;
+        }).then(() => {
           this.drainPromise = null;
         });
         return this.drainPromise;
       }
+      /** Terminal: drains every entry and refuses every `acquire()` after. */
+      close() {
+        this.closed = true;
+        return this.drain();
+      }
       /** Test-only state reset. Call `drain()` first when entries own real browsers. */
       reset() {
         this.available.clear();
         this.entries.clear();
         this.leasesByBrowser.clear();
         this.drainPromise = null;
+        this.closed = false;
       }
       createEntry(key2, fingerprint, pooled) {
         const entry = {
@@ -66730,6 +66748,9 @@ function forceReleaseBrowser(browser) {
 async function drainBrowserPool() {
   await browserLeasePool.drain();
 }
+async function closeBrowserPool() {
+  await browserLeasePool.close();
+}
 function probeNvidiaVramMb() {
   if (_cachedVramMb !== null) return _cachedVramMb;
   try {
@@ -73753,11 +73774,19 @@ async function extractMediaMetadata(filePath) {
   });
   return probePromise;
 }
+function resolveStreamWindow(filePath, metadata) {
+  const videoStreamDurationSeconds = metadata.videoStreamDurationSeconds;
+  const candidateStart = metadata.videoStreamStartSeconds ?? 0;
+  const videoStreamStartSeconds = Number.isFinite(candidateStart) ? candidateStart : 0;
+  const cacheKey = `${filePath}\0${String(videoStreamStartSeconds)}\0${String(videoStreamDurationSeconds)}`;
+  return { videoStreamStartSeconds, videoStreamDurationSeconds, cacheKey };
+}
 async function extractFinalVideoFrameTimestamp(filePath, metadata, signal) {
-  const videoDurationSeconds = metadata.videoStreamDurationSeconds;
-  const candidateStreamStart = metadata.videoStreamStartSeconds ?? 0;
-  const videoStreamStartSeconds = Number.isFinite(candidateStreamStart) ? candidateStreamStart : 0;
-  const cacheKey = `${filePath}\0${String(videoStreamStartSeconds)}\0${String(videoDurationSeconds)}`;
+  const {
+    videoStreamStartSeconds,
+    videoStreamDurationSeconds: videoDurationSeconds,
+    cacheKey
+  } = resolveStreamWindow(filePath, metadata);
   let probeCache = finalVideoFrameTimestampCache;
   if (signal) {
     probeCache = finalVideoFrameTimestampSignalCaches.get(signal) ?? /* @__PURE__ */ new Map();
@@ -73860,19 +73889,27 @@ async function extractAudioMetadata(filePath, options) {
   });
   return probePromise;
 }
-async function analyzeKeyframeIntervals(filePath) {
-  const cached3 = keyframeCache.get(filePath);
+async function analyzeKeyframeIntervals(filePath, metadata) {
+  const { videoStreamStartSeconds, videoStreamDurationSeconds, cacheKey } = resolveStreamWindow(
+    filePath,
+    metadata
+  );
+  const cached3 = keyframeCache.get(cacheKey);
   if (cached3) return cached3;
-  const promise = analyzeKeyframeIntervalsUncached(filePath);
-  keyframeCache.set(filePath, promise);
+  const promise = analyzeKeyframeIntervalsUncached(
+    filePath,
+    videoStreamStartSeconds,
+    videoStreamDurationSeconds
+  );
+  keyframeCache.set(cacheKey, promise);
   promise.catch(() => {
-    if (keyframeCache.get(filePath) === promise) {
-      keyframeCache.delete(filePath);
+    if (keyframeCache.get(cacheKey) === promise) {
+      keyframeCache.delete(cacheKey);
     }
   });
   return promise;
 }
-async function analyzeKeyframeIntervalsUncached(filePath) {
+async function analyzeKeyframeIntervalsUncached(filePath, videoStreamStartSeconds, videoStreamDurationSeconds) {
   const stdout2 = await runFfprobe(filePath, [
     "-select_streams",
     "v:0",
@@ -73884,14 +73921,26 @@ async function analyzeKeyframeIntervalsUncached(filePath) {
     "csv=p=0"
   ]);
   const timestamps = stdout2.split("\n").map((line3) => parseFloat(line3.trim())).filter((t) => Number.isFinite(t));
-  if (timestamps.length < 2) {
+  if (timestamps.length === 0) {
     return {
       avgIntervalSeconds: 0,
       maxIntervalSeconds: 0,
-      keyframeCount: timestamps.length,
+      keyframeCount: 0,
       isProblematic: false
     };
   }
+  if (timestamps.length === 1) {
+    const streamEnd = videoStreamStartSeconds + videoStreamDurationSeconds;
+    const rawInterval = streamEnd - (timestamps[0] ?? videoStreamStartSeconds);
+    const singleGopInterval = Number.isFinite(rawInterval) ? Math.max(rawInterval, 0) : 0;
+    const roundedInterval = Math.round(singleGopInterval * 100) / 100;
+    return {
+      avgIntervalSeconds: roundedInterval,
+      maxIntervalSeconds: roundedInterval,
+      keyframeCount: 1,
+      isProblematic: singleGopInterval > PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS
+    };
+  }
   let maxInterval = 0;
   let totalInterval = 0;
   for (let i = 1; i < timestamps.length; i++) {
@@ -73904,10 +73953,10 @@ async function analyzeKeyframeIntervalsUncached(filePath) {
     avgIntervalSeconds: Math.round(avgInterval * 100) / 100,
     maxIntervalSeconds: Math.round(maxInterval * 100) / 100,
     keyframeCount: timestamps.length,
-    isProblematic: maxInterval > 2
+    isProblematic: maxInterval > PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS
   };
 }
-var FFPROBE_STDERR_MAX_BYTES, FFPROBE_STDOUT_MAX_CHARS, FFPROBE_ERROR_MAX_CHARS, videoMetadataCache, finalVideoFrameTimestampCache, finalVideoFrameTimestampSignalCaches, audioMetadataCache, mediaProbeOutputCache, mediaProbeOutputSignalCaches, MEDIA_PROBE_OUTPUT_CACHE_MAX_ENTRIES, AAC_LC_SAMPLES_PER_PACKET, STILL_IMAGE_DEMUXERS, StructurallyIncompletePngError, extractVideoMetadata, keyframeCache;
+var FFPROBE_STDERR_MAX_BYTES, FFPROBE_STDOUT_MAX_CHARS, FFPROBE_ERROR_MAX_CHARS, videoMetadataCache, finalVideoFrameTimestampCache, finalVideoFrameTimestampSignalCaches, audioMetadataCache, mediaProbeOutputCache, mediaProbeOutputSignalCaches, MEDIA_PROBE_OUTPUT_CACHE_MAX_ENTRIES, AAC_LC_SAMPLES_PER_PACKET, STILL_IMAGE_DEMUXERS, StructurallyIncompletePngError, extractVideoMetadata, keyframeCache, PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS;
 var init_ffprobe = __esm({
   "../engine/src/utils/ffprobe.ts"() {
     "use strict";
@@ -73950,6 +73999,7 @@ var init_ffprobe = __esm({
     };
     extractVideoMetadata = extractMediaMetadata;
     keyframeCache = /* @__PURE__ */ new Map();
+    PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS = 2;
   }
 });
 
@@ -75140,10 +75190,10 @@ function collectSubCompositionSrcs(html) {
 function cleanAssetUrl(url) {
   return url.trim().split(/[?#]/, 1)[0] ?? "";
 }
-function isWithinProjectRoot(projectDir, candidate) {
-  const projectRoot = resolve6(projectDir);
-  const relativePath = relative2(projectRoot, candidate);
-  return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute2(relativePath);
+function isWithinProjectRoot(projectDir, candidate, pathModule = { resolve: resolve6, relative: relative2, isAbsolute: isAbsolute2 }) {
+  const projectRoot = pathModule.resolve(projectDir);
+  const relativePath = pathModule.relative(projectRoot, candidate);
+  return relativePath === "" || !relativePath.startsWith("..") && !pathModule.isAbsolute(relativePath);
 }
 function addCandidate(candidates, candidate) {
   if (!candidates.includes(candidate)) candidates.push(candidate);
@@ -95460,6 +95510,14 @@ function readRegularFile(filePath) {
     closeSync4(fd);
   }
 }
+function resolveContainedPaths(projectDir, compiledDir, relativePath) {
+  const projectPath = join20(projectDir, relativePath);
+  if (!isWithinProjectRoot(projectDir, projectPath)) return null;
+  if (!compiledDir) return { projectPath, compiledPath: null };
+  const compiledPath = join20(compiledDir, relativePath);
+  if (!isWithinProjectRoot(compiledDir, compiledPath)) return null;
+  return { projectPath, compiledPath };
+}
 function createFileServer(options) {
   const { projectDir, compiledDir, port = 0, stripEmbeddedRuntime = true } = options;
   const headScripts = options.headScripts ?? [];
@@ -95469,8 +95527,9 @@ function createFileServer(options) {
     let requestPath = c3.req.path;
     if (requestPath === "/") requestPath = "/index.html";
     const relativePath = requestPath.replace(/^\//, "");
-    const compiledPath = compiledDir ? join20(compiledDir, relativePath) : null;
-    const content = (compiledPath ? readRegularFile(compiledPath) : null) ?? readRegularFile(join20(projectDir, relativePath));
+    const resolved2 = resolveContainedPaths(projectDir, compiledDir, relativePath);
+    if (!resolved2) return c3.text("Not found", 404);
+    const content = (resolved2.compiledPath ? readRegularFile(resolved2.compiledPath) : null) ?? readRegularFile(resolved2.projectPath);
     if (content === null) return c3.text("Not found", 404);
     const ext = extname4(relativePath).toLowerCase();
     const contentType = MIME_TYPES[ext] || "application/octet-stream";
@@ -95501,6 +95560,7 @@ var init_fileServer = __esm({
   "../engine/src/services/fileServer.ts"() {
     "use strict";
     init_compiler();
+    init_assetResolution();
     MIME_TYPES = {
       ".html": "text/html; charset=utf-8",
       ".css": "text/css; charset=utf-8",
@@ -96654,6 +96714,7 @@ __export(src_exports, {
   classifyVideoExtractionError: () => classifyVideoExtractionError,
   cloneCaptureWarning: () => cloneCaptureWarning,
   cloneCaptureWarnings: () => cloneCaptureWarnings,
+  closeBrowserPool: () => closeBrowserPool,
   closeCaptureSession: () => closeCaptureSession,
   completeDeferredDrawElementInit: () => completeDeferredDrawElementInit,
   compositionRequiresWebGpu: () => compositionRequiresWebGpu,
@@ -96981,6 +97042,18 @@ var init_agent_runtime = __esm({
     "use strict";
     init_platform();
     VENDOR_RULES = [
+      // IBM Bob Shell — both shell execution paths stamp BOBSHELL_CLI=1 onto the
+      // child environment: childProcessFallback's spawn env and executeWithPty's
+      // PTY env. Keep this ahead of other agents because Bob inherits the parent
+      // environment, so a Bob session launched from Codex or Claude can carry both
+      // vendors' markers; BOBSHELL_CLI identifies the immediate executor.
+      // BOBSHELL_API_KEY is deliberately ignored: it is an authentication setting,
+      // not proof that Bob launched the current process.
+      // Source: IBM Bob Shell 1.0.6 bundle (lb.childProcessFallback / executeWithPty).
+      {
+        name: "bob",
+        check: (env) => typeof env["BOBSHELL_CLI"] === "string"
+      },
       // Anthropic Claude Code — sets CLAUDECODE=1 on every Bash/PowerShell tool
       // spawn (Shell.ts:321) and CLAUDE_CODE_ENTRYPOINT at startup, inherited by
       // every child (main.tsx:527). Both propagate to spawned subprocesses.
@@ -133534,10 +133607,12 @@ var init_videoFrameCoverage = __esm({
 });
 
 // ../producer/src/services/renderMediaCollector.ts
-function parseNumeric4(value) {
-  if (value == null || value === "") return null;
-  const parsed = Number.parseFloat(value);
-  return Number.isFinite(parsed) ? parsed : null;
+function resolveHostEnd(host, hostStart) {
+  return resolveAuthoredTimingWindow({
+    start: hostStart,
+    duration: host.getAttribute("data-duration"),
+    end: host.getAttribute("data-end")
+  })?.end ?? null;
 }
 function resolveHostWindow(element, document2, startCache, visiting) {
   const hosts = [];
@@ -133549,7 +133624,7 @@ function resolveHostWindow(element, document2, startCache, visiting) {
   let limit = Infinity;
   for (const host of hosts.reverse()) {
     const hostStart = resolveReferencedStart(document2, host, startCache, visiting);
-    const hostEnd = parseNumeric4(host.getAttribute("data-end"));
+    const hostEnd = resolveHostEnd(host, hostStart);
     if (hostEnd != null) limit = Math.min(limit, offset2 + hostEnd);
     offset2 += hostStart;
   }
@@ -139555,10 +139630,11 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     if (isHttpUrl(video.src)) continue;
     const videoPath = resolve33(projectDir, video.src);
     const reencode = `ffmpeg -i "${video.src}" -c:v libx264 -r 30 -g 30 -keyint_min 30 -movflags +faststart -c:a copy output.mp4`;
-    Promise.all([
-      withMediaProbeSlot(() => analyzeKeyframeIntervals(videoPath)),
-      withMediaProbeSlot(() => extractMediaMetadata(videoPath))
-    ]).then(([analysis, metadata]) => {
+    (async () => {
+      const metadata = await withMediaProbeSlot(() => extractMediaMetadata(videoPath));
+      const analysis = await withMediaProbeSlot(
+        () => analyzeKeyframeIntervals(videoPath, metadata)
+      );
       if (analysis.isProblematic) {
         defaultLogger.warn(
           `[Compiler] WARNING: Video "${video.id}" has sparse keyframes (max interval: ${analysis.maxIntervalSeconds}s). This causes seek failures and frame freezing. Re-encode with: ${reencode}`
@@ -139569,7 +139645,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
           `[Compiler] Video "${video.id}" is variable frame rate (VFR); the engine will normalize it to CFR before frame extraction. If rendering feels slow on this video, pre-encode once with: ${reencode}`
         );
       }
-    }).catch(() => {
+    })().catch(() => {
     });
   }
   const { document: document2 } = parseHTML(html);
@@ -151340,7 +151416,6 @@ var init_pipeline = __esm({
 // src/server/studioServer.ts
 var studioServer_exports = {};
 __export(studioServer_exports, {
-  closeThumbnailBrowser: () => closeThumbnailBrowser,
   createStudioServer: () => createStudioServer,
   loadPreviewServerBuildSignature: () => loadPreviewServerBuildSignature,
   resolveStudioBundle: () => resolveStudioBundle
@@ -151448,7 +151523,8 @@ async function downloadRemoteGifImageSources(html, downloadDir, downloadToTemp2)
   );
   return sourceAssets;
 }
-async function getThumbnailBrowser(requestedGpuMode) {
+async function getThumbnailBrowser(requestedGpuMode, isShuttingDown) {
+  if (isShuttingDown()) return null;
   if (_thumbnailBrowserLease?.browser.connected && _thumbnailBrowserModes?.requested === requestedGpuMode) {
     return {
       browser: _thumbnailBrowserLease.browser,
@@ -151463,6 +151539,7 @@ async function getThumbnailBrowser(requestedGpuMode) {
   if (_thumbnailBrowserLease) await closeThumbnailBrowser();
   _thumbnailBrowserInitializing = (async () => {
     try {
+      if (isShuttingDown()) return null;
       const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
       const { acquireBrowser: acquireBrowser2, buildChromeArgs: buildChromeArgs2 } = await Promise.resolve().then(() => (init_src(), src_exports));
       let executablePath;
@@ -151503,6 +151580,8 @@ async function getThumbnailBrowser(requestedGpuMode) {
   return _thumbnailBrowserInitializing;
 }
 async function closeThumbnailBrowser() {
+  if (_thumbnailBrowserInitializing) await _thumbnailBrowserInitializing.catch(() => {
+  });
   if (!_thumbnailBrowserLease) return;
   const lease = _thumbnailBrowserLease;
   _thumbnailBrowserLease = null;
@@ -151566,6 +151645,8 @@ function createStudioServer(options) {
       cachedProjectSignature = null;
     }
   });
+  const inFlightRenders = /* @__PURE__ */ new Map();
+  let shuttingDown = false;
   const adapter2 = {
     // Explicit option wins (preview's resolved --proxy/--no-proxy + config);
     // otherwise honor the project's hyperframes.json media.autoProxy so every
@@ -151629,6 +151710,15 @@ function createStudioServer(options) {
     runtimeUrl: "/api/runtime.js",
     rendersDir: () => join91(projectDir, "renders"),
     startRender(opts) {
+      if (shuttingDown) {
+        return {
+          id: opts.jobId,
+          status: "failed",
+          progress: 0,
+          outputPath: opts.outputPath,
+          error: "Studio server is shutting down"
+        };
+      }
       refreshTelemetryPosture();
       const abortController = new AbortController();
       const state = {
@@ -151639,7 +151729,7 @@ function createStudioServer(options) {
         cancel: () => abortController.abort()
       };
       const startTime = Date.now();
-      (async () => {
+      const run2 = (async () => {
         let renderJob;
         const removeCancelledOutput = () => {
           state.status = "cancelled";
@@ -151711,6 +151801,9 @@ function createStudioServer(options) {
           }
         }
       })();
+      inFlightRenders.set(abortController, run2);
+      const forget = () => void inFlightRenders.delete(abortController);
+      run2.then(forget, forget);
       return state;
     },
     startBackgroundRemoval(opts) {
@@ -151723,9 +151816,11 @@ function createStudioServer(options) {
       });
     },
     async generateThumbnail(opts) {
-      const session = await getThumbnailBrowser(browserGpuMode);
+      const session = await getThumbnailBrowser(browserGpuMode, () => shuttingDown);
       if (!session) {
-        console.warn("[Studio] Thumbnail: no browser available \u2014 Chrome may not be installed");
+        if (!shuttingDown) {
+          console.warn("[Studio] Thumbnail: no browser available \u2014 Chrome may not be installed");
+        }
         return null;
       }
       const sourcePath = join91(opts.project.dir, opts.compPath);
@@ -151943,6 +152038,7 @@ function createStudioServer(options) {
   });
   const serveStudioStaticFile = (cacheControl) => (c3) => {
     const filePath = resolve39(studioDir, c3.req.path.slice(1));
+    if (!isWithinProjectRoot(studioDir, filePath)) return c3.text("not found", 404);
     const content = readBundleFile(filePath);
     if (content === null) return c3.text("not found", 404);
     return new Response(content, {
@@ -152028,9 +152124,27 @@ function createStudioServer(options) {
     }
     return c3.html(html, 200, { "Cache-Control": "no-cache" });
   });
-  return { app, watcher, adapter: adapter2 };
+  const shutdown = async () => {
+    shuttingDown = true;
+    const renders = [...inFlightRenders];
+    for (const [abortController] of renders) abortController.abort();
+    const { killTrackedProcesses: killTrackedProcesses2, closeBrowserPool: closeBrowserPool2 } = await Promise.resolve().then(() => (init_src(), src_exports));
+    killTrackedProcesses2();
+    const closeBrowsers = Promise.allSettled([
+      closeThumbnailBrowser().catch(() => {
+      }),
+      closeBrowserPool2().catch(() => {
+      })
+    ]);
+    await Promise.race([
+      Promise.allSettled(renders.map(([, done]) => done)),
+      new Promise((resolve84) => setTimeout(resolve84, RENDER_SHUTDOWN_WAIT_MS).unref())
+    ]);
+    await closeBrowsers;
+  };
+  return { app, watcher, adapter: adapter2, shutdown };
 }
-var STUDIO_MANUAL_EDITS_PATH2, IMMUTABLE_CACHE_CONTROL, REMOTE_GIF_IMG_SRC_RE, _thumbnailBrowserLease, _thumbnailBrowserInitializing, _thumbnailBrowserModes;
+var STUDIO_MANUAL_EDITS_PATH2, RENDER_SHUTDOWN_WAIT_MS, IMMUTABLE_CACHE_CONTROL, REMOTE_GIF_IMG_SRC_RE, _thumbnailBrowserLease, _thumbnailBrowserInitializing, _thumbnailBrowserModes;
 var init_studioServer = __esm({
   "src/server/studioServer.ts"() {
     "use strict";
@@ -152045,9 +152159,11 @@ var init_studioServer = __esm({
     init_dist9();
     init_projectConfig();
     init_screenshotClip();
+    init_assetResolution();
     init_captureCompositionFrame();
     init_gpuPolicy();
     STUDIO_MANUAL_EDITS_PATH2 = ".hyperframes/studio-manual-edits.json";
+    RENDER_SHUTDOWN_WAIT_MS = 2e3;
     IMMUTABLE_CACHE_CONTROL = "public, max-age=31536000, immutable";
     REMOTE_GIF_IMG_SRC_RE = /<img\b[^>]*?\bsrc\s*=\s*["'](https?:\/\/[^"']+\.gif(?:[?#][^"']*)?)["'][^>]*>/gi;
     _thumbnailBrowserLease = null;
@@ -152756,7 +152872,11 @@ async function runEmbeddedMode(dir, startPort, options) {
     return;
   }
   const serverBuildSignature = await loadPreviewServerBuildSignature2();
-  const { app, watcher } = createStudioServer2({
+  const {
+    app,
+    watcher,
+    shutdown: shutdownStudio
+  } = createStudioServer2({
     projectDir: dir,
     projectName: pName,
     autoProxy: options?.autoProxy,
@@ -152845,28 +152965,17 @@ async function runEmbeddedMode(dir, startPort, options) {
     const shutdown = () => {
       if (shuttingDown) return;
       shuttingDown = true;
-      process.off("SIGINT", shutdown);
-      process.off("SIGTERM", shutdown);
       rl?.close();
       reportPreviewShutdown(Boolean(options?.json));
       setTimeout(() => requestCliExit(0), 3e3).unref();
-      const cleanup = async () => {
-        const { closeThumbnailBrowser: closeThumbnailBrowser2 } = await Promise.resolve().then(() => (init_studioServer(), studioServer_exports));
-        const { drainBrowserPool: drainBrowserPool2, killTrackedProcesses: killTrackedProcesses2 } = await Promise.resolve().then(() => (init_src(), src_exports));
-        killTrackedProcesses2();
-        await closeThumbnailBrowser2().catch(() => {
-        });
-        await drainBrowserPool2().catch(() => {
-        });
-      };
-      cleanup().catch(() => {
+      shutdownStudio().catch(() => {
       }).finally(() => {
         watcher.close();
         result.server.close(() => resolveRun());
       });
     };
-    process.once("SIGINT", shutdown);
-    process.once("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
     Promise.resolve().then(() => (init_src(), src_exports)).then(({ killTrackedProcesses: killTrackedProcesses2 }) => {
       process.once("exit", () => {
         if (!shuttingDown) killTrackedProcesses2();
@@ -174692,9 +174801,27 @@ var init_events2 = __esm({
 });
 
 // src/capture/captureFile.ts
-import { writeFileSync as writeFileSync47 } from "fs";
+var captureFile_exports = {};
+__export(captureFile_exports, {
+  writeCaptureFileSync: () => writeCaptureFileSync
+});
+import { mkdtempSync as mkdtempSync24, renameSync as renameSync21, rmSync as rmSync37, writeFileSync as writeFileSync47 } from "fs";
+import { basename as basename27, dirname as dirname61, join as join126 } from "path";
+function publishCaptureFileSync(path, data2, options) {
+  const stagingDir = mkdtempSync24(join126(dirname61(path), ".capture-"));
+  try {
+    const staged = join126(stagingDir, basename27(path));
+    writeCaptureFileSync(staged, data2, { ...options, flag: "wx" });
+    renameSync21(staged, path);
+  } finally {
+    rmSync37(stagingDir, { recursive: true, force: true });
+  }
+}
 function writeCaptureFileSync(path, data2, options) {
   const normalized2 = typeof options === "string" ? { encoding: options } : options;
+  if (normalized2?.flag === void 0 || normalized2.flag === "w") {
+    return publishCaptureFileSync(path, data2, normalized2);
+  }
   writeFileSync47(path, data2, { ...normalized2, mode: 384 });
 }
 var init_captureFile = __esm({
@@ -174714,7 +174841,7 @@ __export(contactSheet_exports, {
 });
 import sharp from "sharp";
 import { readdirSync as readdirSync39, readFileSync as readFileSync85, unlinkSync as unlinkSync10, existsSync as existsSync111 } from "fs";
-import { join as join126, extname as extname19, basename as basename27, dirname as dirname61 } from "path";
+import { join as join127, extname as extname19, basename as basename28, dirname as dirname62 } from "path";
 async function createContactSheet(imagePaths, outputPath, opts = {}) {
   const {
     cols = 3,
@@ -174748,7 +174875,7 @@ async function createContactSheet(imagePaths, outputPath, opts = {}) {
     overlays.push({ input: resized, left: x2, top: y + labelH });
     let labelText = `${i + 1}`;
     if (labelMode === "filename") {
-      labelText = `${i + 1}. ${basename27(files[i]).replace(extname19(files[i]), "")}`;
+      labelText = `${i + 1}. ${basename28(files[i]).replace(extname19(files[i]), "")}`;
     } else if (labelMode === "custom" && labels?.[i]) {
       labelText = `${i + 1}. ${labels[i]}`;
     }
@@ -174766,11 +174893,8 @@ async function createContactSheet(imagePaths, outputPath, opts = {}) {
       background: { r: 26, g: 26, b: 26 }
     }
   }).composite(overlays);
-  if (extname19(outputPath).toLowerCase() === ".png") {
-    await sheet.png().toFile(outputPath);
-  } else {
-    await sheet.jpeg({ quality }).toFile(outputPath);
-  }
+  const encoded = extname19(outputPath).toLowerCase() === ".png" ? await sheet.png().toBuffer() : await sheet.jpeg({ quality }).toBuffer();
+  writeCaptureFileSync(outputPath, encoded);
   return outputPath;
 }
 function escapeXml2(s) {
@@ -174803,7 +174927,7 @@ async function createScrollContactSheet(screenshotsDir, outputPath, budget = {})
   if (!existsSync111(screenshotsDir)) return [];
   const scrollFiles = readdirSync39(screenshotsDir).filter((f) => f.startsWith("scroll-") && f.endsWith(".png")).sort();
   if (scrollFiles.length === 0) return [];
-  const paths = scrollFiles.map((f) => join126(screenshotsDir, f));
+  const paths = scrollFiles.map((f) => join127(screenshotsDir, f));
   const labels = scrollFiles.map((f) => {
     const m = f.match(/scroll-(\d+)\.png/);
     return m ? `${m[1]}% scroll` : f;
@@ -174820,7 +174944,7 @@ async function createSnapshotContactSheet(snapshotsDir, outputPath, budget = {})
   if (!existsSync111(snapshotsDir)) return [];
   const snapshotFiles = readdirSync39(snapshotsDir).filter((f) => f.startsWith("frame-") && f.endsWith(".png")).sort();
   if (snapshotFiles.length === 0) return [];
-  const paths = snapshotFiles.map((f) => join126(snapshotsDir, f));
+  const paths = snapshotFiles.map((f) => join127(snapshotsDir, f));
   const labels = snapshotFiles.map((f) => {
     const m = f.match(/at-([\d.]+)s/);
     return m ? `${m[1]}s` : f;
@@ -174838,7 +174962,7 @@ async function createAssetContactSheet(assetsDir, outputPath, budget = {}) {
   const imageExts = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".webp"]);
   const assetFiles = readdirSync39(assetsDir).filter((f) => imageExts.has(extname19(f).toLowerCase()) && !f.includes("contact-sheet")).sort();
   if (assetFiles.length === 0) return [];
-  const paths = assetFiles.map((f) => join126(assetsDir, f));
+  const paths = assetFiles.map((f) => join127(assetsDir, f));
   return createContactSheetPages(paths, outputPath, {
     cols: 4,
     cellWidth: 480,
@@ -174858,20 +174982,20 @@ async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir, budget
     for (const f of readdirSync39(dir).filter((f2) => f2.endsWith(".svg")).sort()) {
       if (!seen.has(f)) {
         seen.add(f);
-        svgPaths.push(join126(dir, f));
+        svgPaths.push(join127(dir, f));
       }
     }
   }
   if (svgPaths.length === 0) return [];
   const svgFileNames = svgPaths.map((p2) => p2.split("/").pop());
   const thumbSize = 200;
-  const tmpDir = dirname61(outputPath);
+  const tmpDir = dirname62(outputPath);
   const tmpPaths = [];
   const labels = [];
   for (let i = 0; i < svgPaths.length; i++) {
     if ((budget.remainingMs?.() ?? 1) <= 0) break;
     const svgPath = svgPaths[i];
-    const tmpPath = join126(tmpDir, `.thumb-${i}.png`);
+    const tmpPath = join127(tmpDir, `.thumb-${i}.png`);
     try {
       const svgBuf = readFileSync85(svgPath);
       const thumb = await sharp(svgBuf).resize(thumbSize, thumbSize, {
@@ -174930,9 +175054,9 @@ __export(snapshot_exports, {
   resolveSnapshotVideoRateSpec: () => resolveSnapshotVideoRateSpec,
   tailFrameTime: () => tailFrameTime
 });
-import { existsSync as existsSync112, mkdtempSync as mkdtempSync24, readFileSync as readFileSync86, mkdirSync as mkdirSync56, rmSync as rmSync37, writeFileSync as writeFileSync48 } from "fs";
+import { existsSync as existsSync112, mkdtempSync as mkdtempSync25, readFileSync as readFileSync86, mkdirSync as mkdirSync56, rmSync as rmSync38, writeFileSync as writeFileSync48 } from "fs";
 import { tmpdir as tmpdir16 } from "os";
-import { resolve as resolve72, join as join127, relative as relative31, isAbsolute as isAbsolute19, basename as basename28, posix as posix6 } from "path";
+import { resolve as resolve72, join as join128, relative as relative31, isAbsolute as isAbsolute19, basename as basename29, posix as posix6 } from "path";
 function orbitStageSource() {
   return `function(cam) {
     var root = document.querySelector("[data-composition-id]")
@@ -174986,8 +175110,8 @@ function requireSnapshotFfmpeg(ffmpegPath) {
   );
 }
 async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false, accurateSeek = false) {
-  const tmp = mkdtempSync24(join127(tmpdir16(), "hf-snapshot-frame-"));
-  const outPath = join127(tmp, "frame.png");
+  const tmp = mkdtempSync25(join128(tmpdir16(), "hf-snapshot-frame-"));
+  const outPath = join128(tmp, "frame.png");
   try {
     const ffmpegPath = requireSnapshotFfmpeg(findFFmpeg());
     const args = ["-hide_banner", "-loglevel", "error"];
@@ -175009,7 +175133,7 @@ async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDeco
     return readFileSync86(outPath);
   } finally {
     try {
-      rmSync37(tmp, { recursive: true, force: true });
+      rmSync38(tmp, { recursive: true, force: true });
     } catch {
     }
   }
@@ -175098,13 +175222,13 @@ 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 ?? join127(projectDir, "snapshots");
+      const snapshotDir = opts.outputDir ?? join128(projectDir, "snapshots");
       mkdirSync56(snapshotDir, { recursive: true });
       try {
         const { readdirSync: readdirSync46 } = await import("fs");
         for (const file of readdirSync46(snapshotDir)) {
           if (/\.(png|jpg|jpeg)$/i.test(file)) {
-            rmSync37(join127(snapshotDir, file), { force: true });
+            rmSync38(join128(snapshotDir, file), { force: true });
           }
         }
       } catch {
@@ -175238,7 +175362,7 @@ async function captureSnapshots(projectDir, opts) {
         const timeLabel = formatSnapshotTimestamp(time);
         const index = String(i).padStart(2, "0");
         const filename = `frame-${index}-at-${timeLabel}.png`;
-        const framePath = join127(snapshotDir, filename);
+        const framePath = join128(snapshotDir, filename);
         if (opts.zoom) {
           const canvas = await page.evaluate(() => ({
             width: window.innerWidth,
@@ -175267,9 +175391,9 @@ async function captureSnapshots(projectDir, opts) {
               `   ${c.warn("\u26A0")} --against has no frame at ${timeLabel} \u2014 reference pair skipped`
             );
           } else {
-            const refPath = join127(snapshotDir, `ref-${index}-at-${timeLabel}.png`);
+            const refPath = join128(snapshotDir, `ref-${index}-at-${timeLabel}.png`);
             writeFileSync48(refPath, refPng);
-            const pairPath = join127(snapshotDir, `pair-${index}-at-${timeLabel}.jpg`);
+            const pairPath = join128(snapshotDir, `pair-${index}-at-${timeLabel}.jpg`);
             const { createContactSheet: createContactSheet2 } = await Promise.resolve().then(() => (init_contactSheet(), contactSheet_exports));
             await createContactSheet2([framePath, refPath], pairPath, {
               cols: 2,
@@ -175436,7 +175560,7 @@ var init_snapshot = __esm({
         const angleLabel = camera && (camera.yaw !== 0 || camera.pitch !== 0) ? ` ${c.dim(`(angle yaw ${camera.yaw}\xB0 pitch ${camera.pitch}\xB0)`)}` : "";
         console.log(`${c.accent("\u25C6")}  Capturing ${label2} from ${c.accent(project.name)}${angleLabel}`);
         try {
-          const snapshotDir = args.output ? resolve72(String(args.output)) : join127(project.dir, "snapshots");
+          const snapshotDir = args.output ? resolve72(String(args.output)) : join128(project.dir, "snapshots");
           const paths = await captureSnapshots(project.dir, {
             frames,
             timeout,
@@ -175473,7 +175597,7 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to ${args.output ? snaps
             const { createSnapshotContactSheet: createSnapshotContactSheet2 } = await Promise.resolve().then(() => (init_contactSheet(), contactSheet_exports));
             const sheets = await createSnapshotContactSheet2(
               snapshotDir,
-              join127(snapshotDir, "contact-sheet.jpg")
+              join128(snapshotDir, "contact-sheet.jpg")
             );
             if (sheets.length > 0) {
               const label3 = sheets.length === 1 ? "contact-sheet.jpg" : `contact-sheet-1..${sheets.length}.jpg`;
@@ -175508,8 +175632,8 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to ${args.output ? snaps
                 }
                 const results = await Promise.allSettled(
                   paths.map(async (p2) => {
-                    const filename = basename28(p2);
-                    const filePath = join127(snapshotDir, filename);
+                    const filename = basename29(p2);
+                    const filePath = join128(snapshotDir, filename);
                     if (!existsSync112(filePath)) return { filename, desc: "file not found" };
                     const raw = readFileSync86(filePath);
                     let imageData;
@@ -175547,7 +175671,7 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to ${args.output ? snaps
                     descriptions.push(`## (error)`, `Gemini call failed: ${errMsg.slice(0, 120)}`, ``);
                   }
                 }
-                const descPath = join127(snapshotDir, "descriptions.md");
+                const descPath = join128(snapshotDir, "descriptions.md");
                 writeFileSync48(descPath, descriptions.join("\n"));
                 console.log(`   ${c.dim("descriptions.md")} (Gemini frame analysis)`);
               }
@@ -175601,7 +175725,7 @@ var init_pathArgs = __esm({
 
 // ../core/dist/mediaGradeAnalyzer.js
 import { execFileSync as execFileSync18 } from "child_process";
-import { basename as basename29, extname as extname20 } from "path";
+import { basename as basename30, extname as extname20 } from "path";
 function clamp2(value, key2) {
   const limit = ADJUST_LIMITS2[key2];
   if (!Number.isFinite(value))
@@ -175881,7 +176005,7 @@ __export(media_treatment_exports, {
   resolveMediaTreatmentSource: () => resolveMediaTreatmentSource
 });
 import { existsSync as existsSync113, readFileSync as readFileSync87, writeFileSync as writeFileSync49 } from "fs";
-import { join as join128, relative as relative34, resolve as resolve74 } from "path";
+import { join as join129, relative as relative34, resolve as resolve74 } from "path";
 function getMediaTreatmentCapabilityOverview() {
   const capabilities = getHfColorGradingCapabilities();
   const family = (id, label2, description) => ({
@@ -176259,7 +176383,7 @@ function resolveMediaTreatmentSource(projectDir, compositionFile, source) {
   }
   const cleanSource = cleanAssetUrl(sourceUrl);
   if (!cleanSource) throw new Error("Selected media has no analyzable local src");
-  const projectRelative = cleanSource.startsWith("/") ? cleanSource : rewriteAssetPath(compositionFile, cleanSource, (path) => existsSync113(join128(projectDir, path)));
+  const projectRelative = cleanSource.startsWith("/") ? cleanSource : rewriteAssetPath(compositionFile, cleanSource, (path) => existsSync113(join129(projectDir, path)));
   const asset = resolveExistingLocalAsset(projectDir, projectRelative);
   if (!asset) throw new Error(`Media file not found: ${source}`);
   return asset.resolved;
@@ -176537,13 +176661,13 @@ import {
   copyFileSync as copyFileSync10,
   existsSync as existsSync114,
   mkdirSync as mkdirSync57,
-  mkdtempSync as mkdtempSync25,
+  mkdtempSync as mkdtempSync26,
   readFileSync as readFileSync88,
-  rmSync as rmSync38,
+  rmSync as rmSync39,
   writeFileSync as writeFileSync50
 } from "fs";
 import { tmpdir as tmpdir17 } from "os";
-import { basename as basename30, dirname as dirname62, extname as extname21, join as join129, resolve as resolve75 } from "path";
+import { basename as basename31, dirname as dirname63, extname as extname21, join as join130, resolve as resolve75 } from "path";
 import sharp2 from "sharp";
 function isRecord15(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -176661,7 +176785,7 @@ function resolveLutCells(luts) {
     throw new Error("--luts must include at least one LUT path");
   }
   return paths.map(
-    (lutPath) => validateCell(basename30(lutPath, extname21(lutPath)), { lut: { src: lutPath } })
+    (lutPath) => validateCell(basename31(lutPath, extname21(lutPath)), { lut: { src: lutPath } })
   );
 }
 function prependBaselineCell(cells) {
@@ -176799,10 +176923,10 @@ function frameFileNameForPath(framePath) {
   return "frame.png";
 }
 async function prepareGradeCompareTempProject(opts) {
-  const tempDir = mkdtempSync25(join129(tmpdir17(), "hf-grade-compare-"));
+  const tempDir = mkdtempSync26(join130(tmpdir17(), "hf-grade-compare-"));
   try {
     const frameFileName2 = opts.frameFileName ?? frameFileNameForPath(opts.framePath);
-    writeFileSync50(join129(tempDir, frameFileName2), opts.frameBuffer);
+    writeFileSync50(join130(tempDir, frameFileName2), opts.frameBuffer);
     let lutIndex = 0;
     const stagedCells = opts.cells.map((cell) => {
       const lutSrc = lutSrcFromGrading(cell.grading);
@@ -176822,7 +176946,7 @@ async function prepareGradeCompareTempProject(opts) {
       const lutExt = extname21(sourcePath) || ".cube";
       const stagedName = `lut-${lutIndex}${lutExt}`;
       lutIndex += 1;
-      copyFileSync10(sourcePath, join129(tempDir, stagedName));
+      copyFileSync10(sourcePath, join130(tempDir, stagedName));
       return {
         label: cell.label,
         grading: rewriteGradingLutSrc(cell.grading, stagedName)
@@ -176834,10 +176958,10 @@ async function prepareGradeCompareTempProject(opts) {
       frameWidth: opts.frameWidth,
       frameHeight: opts.frameHeight
     });
-    writeFileSync50(join129(tempDir, "index.html"), html);
+    writeFileSync50(join130(tempDir, "index.html"), html);
     return { tempDir, html, cells: stagedCells };
   } catch (err) {
-    rmSync38(tempDir, { recursive: true, force: true });
+    rmSync39(tempDir, { recursive: true, force: true });
     throw err;
   }
 }
@@ -176846,8 +176970,8 @@ function isVideoPath2(filePath) {
   return [".mp4", ".mov", ".m4v", ".webm", ".mkv", ".avi", ".mpeg", ".mpg", ".ogv"].includes(ext);
 }
 async function extractVideoFrameToBuffer2(videoPath) {
-  const tmp = mkdtempSync25(join129(tmpdir17(), "hf-grade-compare-frame-"));
-  const outPath = join129(tmp, "frame.png");
+  const tmp = mkdtempSync26(join130(tmpdir17(), "hf-grade-compare-frame-"));
+  const outPath = join130(tmp, "frame.png");
   try {
     const ffmpegPath = findFFmpeg();
     if (!ffmpegPath) return null;
@@ -176876,7 +177000,7 @@ async function extractVideoFrameToBuffer2(videoPath) {
     }
     return readFileSync88(outPath);
   } finally {
-    rmSync38(tmp, { recursive: true, force: true });
+    rmSync39(tmp, { recursive: true, force: true });
   }
 }
 async function loadReferenceFrame(framePath) {
@@ -176902,7 +177026,7 @@ async function captureGradeCompareSheet(projectDir, timeoutMs) {
   const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
   const html = await bundleToSingleHtml2(projectDir);
   const server = await serveStaticProjectHtml(projectDir, html);
-  const sheetPath = join129(projectDir, "grade-compare.png");
+  const sheetPath = join130(projectDir, "grade-compare.png");
   try {
     const {
       browser: chromeBrowser,
@@ -177025,7 +177149,7 @@ var init_grade_compare = __esm({
           }
           if (!parsed.json) {
             console.log(
-              `${c.accent("\u25C6")}  Rendering ${cells.length} grade candidates from ${c.accent(basename30(parsed.framePath))}`
+              `${c.accent("\u25C6")}  Rendering ${cells.length} grade candidates from ${c.accent(basename31(parsed.framePath))}`
             );
           }
           const frame = await loadReferenceFrame(parsed.framePath);
@@ -177043,7 +177167,7 @@ var init_grade_compare = __esm({
             prepared.tempDir,
             parsed.timeoutMs
           );
-          mkdirSync57(dirname62(parsed.outPath), { recursive: true });
+          mkdirSync57(dirname63(parsed.outPath), { recursive: true });
           copyFileSync10(tempSheet, parsed.outPath);
           trackCompareSheet({
             command: "grade-compare",
@@ -177070,7 +177194,7 @@ ${c.error("\u2717")} Grade compare failed: ${message}`);
           failCommand();
         } finally {
           if (preparedDir) {
-            rmSync38(preparedDir, { recursive: true, force: true });
+            rmSync39(preparedDir, { recursive: true, force: true });
           }
         }
       }
@@ -177088,12 +177212,12 @@ __export(compare_exports, {
   parseCompareArgs: () => parseCompareArgs,
   prepareCompareVariantProjects: () => prepareCompareVariantProjects
 });
-import { cpSync as cpSync6, existsSync as existsSync115, mkdirSync as mkdirSync58, mkdtempSync as mkdtempSync26, renameSync as renameSync21, rmSync as rmSync39, statSync as statSync43 } from "fs";
+import { cpSync as cpSync6, existsSync as existsSync115, mkdirSync as mkdirSync58, mkdtempSync as mkdtempSync27, renameSync as renameSync23, rmSync as rmSync40, statSync as statSync43 } from "fs";
 import { tmpdir as tmpdir18 } from "os";
-import { basename as basename31, dirname as dirname63, extname as extname23, join as join130 } from "path";
+import { basename as basename32, dirname as dirname64, extname as extname23, join as join131 } from "path";
 function defaultLabelForPath(input2) {
-  const name = basename31(input2);
-  return extname23(name).toLowerCase() === ".html" ? basename31(name, extname23(name)) : name;
+  const name = basename32(input2);
+  return extname23(name).toLowerCase() === ".html" ? basename32(name, extname23(name)) : name;
 }
 function parsePathArgs(args) {
   return (args._ ?? []).filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean);
@@ -177189,18 +177313,18 @@ function inputError(variant) {
   );
 }
 function stageHtmlVariant(variant) {
-  const stagedDir = mkdtempSync26(join130(tmpdir18(), "hf-compare-variant-"));
+  const stagedDir = mkdtempSync27(join131(tmpdir18(), "hf-compare-variant-"));
   try {
-    cpSync6(dirname63(variant.inputPath), stagedDir, {
+    cpSync6(dirname64(variant.inputPath), stagedDir, {
       recursive: true,
       filter: (src) => {
-        const base2 = basename31(src);
+        const base2 = basename32(src);
         return base2 !== "node_modules" && base2 !== ".git";
       }
     });
-    const sourceName = basename31(variant.inputPath);
+    const sourceName = basename32(variant.inputPath);
     if (sourceName !== "index.html") {
-      renameSync21(join130(stagedDir, sourceName), join130(stagedDir, "index.html"));
+      renameSync23(join131(stagedDir, sourceName), join131(stagedDir, "index.html"));
     }
     return {
       ...variant,
@@ -177208,7 +177332,7 @@ function stageHtmlVariant(variant) {
       stagedDir
     };
   } catch (err) {
-    rmSync39(stagedDir, { recursive: true, force: true });
+    rmSync40(stagedDir, { recursive: true, force: true });
     throw err;
   }
 }
@@ -177220,7 +177344,7 @@ function prepareCompareVariantProjects(variants) {
         throw inputError(variant);
       }
       const stat = statSync43(variant.inputPath);
-      if (stat.isDirectory() && existsSync115(join130(variant.inputPath, "index.html"))) {
+      if (stat.isDirectory() && existsSync115(join131(variant.inputPath, "index.html"))) {
         prepared.push({
           ...variant,
           projectDir: variant.inputPath
@@ -177237,7 +177361,7 @@ function prepareCompareVariantProjects(variants) {
   } catch (err) {
     for (const variant of prepared) {
       if (variant.stagedDir) {
-        rmSync39(variant.stagedDir, { recursive: true, force: true });
+        rmSync40(variant.stagedDir, { recursive: true, force: true });
       }
     }
     throw err;
@@ -177246,7 +177370,7 @@ function prepareCompareVariantProjects(variants) {
 function cleanupPreparedCompareVariants(variants) {
   for (const variant of variants) {
     if (variant.stagedDir) {
-      rmSync39(variant.stagedDir, { recursive: true, force: true });
+      rmSync40(variant.stagedDir, { recursive: true, force: true });
     }
   }
 }
@@ -177286,13 +177410,13 @@ async function renderCompareSheet(parsed) {
   const capResult = capCompareVariants(parsed.variants);
   const variants = capResult.variants;
   const prepared = prepareCompareVariantProjects(variants);
-  const frameDir = mkdtempSync26(join130(tmpdir18(), "hf-compare-frames-"));
+  const frameDir = mkdtempSync27(join131(tmpdir18(), "hf-compare-frames-"));
   const framePaths = [];
   try {
     let renderReadyTimedOut = false;
     for (let i = 0; i < prepared.length; i++) {
       const variant = prepared[i];
-      const framePath = join130(frameDir, `variant-${String(i + 1).padStart(2, "0")}.png`);
+      const framePath = join131(frameDir, `variant-${String(i + 1).padStart(2, "0")}.png`);
       const rendered = await renderCompareVariant(variant, {
         atSeconds: parsed.atSeconds,
         framePath,
@@ -177301,7 +177425,7 @@ async function renderCompareSheet(parsed) {
       framePaths.push(rendered.framePath);
       renderReadyTimedOut = renderReadyTimedOut || rendered.renderReadyTimedOut;
     }
-    mkdirSync58(dirname63(parsed.outPath), { recursive: true });
+    mkdirSync58(dirname64(parsed.outPath), { recursive: true });
     await createContactSheet(framePaths, parsed.outPath, {
       cols: parsed.cols ?? defaultCompareCols(framePaths.length),
       maxImages: framePaths.length,
@@ -177318,7 +177442,7 @@ async function renderCompareSheet(parsed) {
     return buildCompareSuccessPayload(parsed.outPath, variants, capResult);
   } finally {
     cleanupPreparedCompareVariants(prepared);
-    rmSync39(frameDir, { recursive: true, force: true });
+    rmSync40(frameDir, { recursive: true, force: true });
   }
 }
 function printJson2(payload) {
@@ -177674,9 +177798,9 @@ function captureFontExtension(bytes) {
   }
 }
 function preferredFontFilename(url, extension) {
-  const basename34 = new URL(url).pathname.split("/").pop() ?? "";
-  const dot = basename34.lastIndexOf(".");
-  const stem = dot > 0 ? basename34.slice(0, dot) : basename34;
+  const basename35 = new URL(url).pathname.split("/").pop() ?? "";
+  const dot = basename35.lastIndexOf(".");
+  const stem = dot > 0 ? basename35.slice(0, dot) : basename35;
   if (/^[a-zA-Z0-9_-][a-zA-Z0-9_.-]{0,119}$/.test(stem) && !/[. ]$/.test(stem) && !/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(stem)) {
     return `${stem}${extension}`;
   }
@@ -177857,7 +177981,7 @@ var init_captureImageValidation = __esm({
 
 // src/capture/assetDownloader.ts
 import { mkdirSync as mkdirSync59 } from "fs";
-import { join as join131, extname as extname24 } from "path";
+import { join as join133, extname as extname24 } from "path";
 import { createHash as createHash27 } from "crypto";
 function noDrops() {
   return { "size-floor": 0, "budget-exhausted": 0, "cap-reached": 0, unavailable: 0 };
@@ -177919,7 +178043,7 @@ async function fetchAndInspectIcon(icon, rank, stem, outputDir, timeoutMs, byteB
   const ext = await captureImageExtension(buffer);
   if (!ext) return null;
   const file = `assets/${stem}${ext}`;
-  writeCaptureFileSync(join131(outputDir, file), buffer);
+  writeCaptureFileSync(join133(outputDir, file), buffer);
   const verdict = await classifyIcon(buffer, ext);
   return {
     buffer,
@@ -177941,7 +178065,7 @@ function promoteHeadline(manifest, bytesByFile, outputDir) {
   )[0];
   if (!chosen) return null;
   const file = `assets/favicon${extname24(chosen.file)}`;
-  writeCaptureFileSync(join131(outputDir, file), bytesByFile.get(chosen.file));
+  writeCaptureFileSync(join133(outputDir, file), bytesByFile.get(chosen.file));
   manifest.headline = {
     file,
     source: chosen.file,
@@ -177996,13 +178120,13 @@ async function downloadDeclaredIcons(faviconLinks, outputDir, drops, options) {
 }
 async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks, options = {}) {
   options = { ...options, byteBudget: options.byteBudget ?? createCaptureDownloadBudget() };
-  const assetsDir = join131(outputDir, "assets");
+  const assetsDir = join133(outputDir, "assets");
   mkdirSync59(assetsDir, { recursive: true });
   const assets = [];
   const drops = noDrops();
   const downloadedUrls = /* @__PURE__ */ new Set();
   let icons = emptyIconManifest();
-  mkdirSync59(join131(outputDir, "assets", "svgs"), { recursive: true });
+  mkdirSync59(join133(outputDir, "assets", "svgs"), { recursive: true });
   const usedSvgNames = /* @__PURE__ */ new Set();
   const MAX_INLINE_SVGS = 30;
   drops["cap-reached"] += Math.max(0, tokens.svgs.length - MAX_INLINE_SVGS);
@@ -178024,7 +178148,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks,
     const name = `${finalSlug}.svg`;
     const localPath = `assets/svgs/${name}`;
     try {
-      writeCaptureFileSync(join131(outputDir, localPath), svgFile, "utf-8");
+      writeCaptureFileSync(join133(outputDir, localPath), svgFile, "utf-8");
       assets.push({ url: "", localPath, type: "svg" });
     } catch {
       drops.unavailable++;
@@ -178114,7 +178238,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks,
         const name = `${slug}${ext}`;
         usedNames.add(slug);
         const localPath = `assets/${name}`;
-        writeCaptureFileSync(join131(outputDir, localPath), buffer);
+        writeCaptureFileSync(join133(outputDir, localPath), buffer);
         assets.push({ url, localPath, type: "image" });
         imgIdx++;
       } catch {
@@ -178141,7 +178265,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks,
           drops["size-floor"]++;
         } else {
           const localPath = `assets/og-image${ext}`;
-          writeCaptureFileSync(join131(outputDir, localPath), buffer);
+          writeCaptureFileSync(join133(outputDir, localPath), buffer);
           assets.push({ url: tokens.ogImage, localPath, type: "image" });
         }
       }
@@ -178167,7 +178291,7 @@ function normalizeUrl(u) {
 }
 async function downloadAndRewriteFonts(css, outputDir, options = {}) {
   options = { ...options, byteBudget: options.byteBudget ?? createCaptureDownloadBudget() };
-  const assetsDir = join131(outputDir, "assets", "fonts");
+  const assetsDir = join133(outputDir, "assets", "fonts");
   mkdirSync59(assetsDir, { recursive: true });
   const drops = noDrops();
   const fontUrlRegex = /url\(['"]?(https?:\/\/[^'")\s]+\.(?:woff2?|ttf|otf)[^'")\s]*?)['"]?\)/g;
@@ -178225,7 +178349,7 @@ async function downloadAndRewriteFonts(css, outputDir, options = {}) {
       const extension = buffer && captureFontExtension(buffer);
       if (buffer && extension) {
         const filename = captureFontFilename(fontUrl, extension, usedFontNames);
-        const localPath = join131(assetsDir, filename);
+        const localPath = join133(assetsDir, filename);
         const relativePath = `assets/fonts/${filename}`;
         writeCaptureFileSync(localPath, buffer);
         rewritten = rewritten.split(fontUrl).join(relativePath);
@@ -178349,7 +178473,7 @@ __export(video_exports, {
   safeFilename: () => safeFilename
 });
 import { createWriteStream as createWriteStream3, existsSync as existsSync116, mkdirSync as mkdirSync60, readFileSync as readFileSync89, unlinkSync as unlinkSync11 } from "fs";
-import { resolve as resolve76, join as join133, basename as basename32 } from "path";
+import { resolve as resolve76, join as join134, basename as basename33 } from "path";
 async function streamToFile(url, destPath) {
   const r = await safeFetch(url, {
     signal: AbortSignal.timeout(12e4),
@@ -178427,9 +178551,9 @@ function safeFilename(name) {
   return decoded.replace(/[^A-Za-z0-9._-]+/g, "_");
 }
 function findFilenameCollision(manifest, selected) {
-  const selectedName = safeFilename(selected.filename || basename32(selected.url));
+  const selectedName = safeFilename(selected.filename || basename33(selected.url));
   return manifest.filter(
-    (e2) => e2.index !== selected.index && safeFilename(e2.filename || basename32(e2.url)) === selectedName
+    (e2) => e2.index !== selected.index && safeFilename(e2.filename || basename33(e2.url)) === selectedName
   );
 }
 function pickManifestEntry(manifest, args) {
@@ -178468,8 +178592,8 @@ function pickManifestEntry(manifest, args) {
 }
 async function runVideoMode(args) {
   const projectDir = resolve76(args.project);
-  const directPath = join133(projectDir, "extracted", "video-manifest.json");
-  const w2hPath = join133(projectDir, "capture", "extracted", "video-manifest.json");
+  const directPath = join134(projectDir, "extracted", "video-manifest.json");
+  const w2hPath = join134(projectDir, "capture", "extracted", "video-manifest.json");
   const manifestPath3 = existsSync116(directPath) ? directPath : w2hPath;
   const isW2hLayout = manifestPath3 === w2hPath;
   if (!existsSync116(manifestPath3)) {
@@ -178518,15 +178642,15 @@ async function runVideoMode(args) {
   const collisions = findFilenameCollision(manifest, entry);
   if (collisions.length > 0) {
     console.error(
-      `${c.error("\u2717")} filename "${safeFilename(entry.filename || basename32(entry.url))}" collides with manifest entr${collisions.length === 1 ? "y" : "ies"} ${collisions.map((co) => `[${co.index}]`).join(", ")}. Refusing to download \u2014 the on-disk file's bytes would not match the requested entry.`
+      `${c.error("\u2717")} filename "${safeFilename(entry.filename || basename33(entry.url))}" collides with manifest entr${collisions.length === 1 ? "y" : "ies"} ${collisions.map((co) => `[${co.index}]`).join(", ")}. Refusing to download \u2014 the on-disk file's bytes would not match the requested entry.`
     );
     setCommandExitCode(1);
     return;
   }
-  const outDir = isW2hLayout ? join133(projectDir, "capture", "assets", "videos") : join133(projectDir, "assets", "videos");
+  const outDir = isW2hLayout ? join134(projectDir, "capture", "assets", "videos") : join134(projectDir, "assets", "videos");
   mkdirSync60(outDir, { recursive: true });
-  const fname = safeFilename(entry.filename || basename32(entry.url));
-  const outPath = join133(outDir, fname);
+  const fname = safeFilename(entry.filename || basename33(entry.url));
+  const outPath = join134(outDir, fname);
   const relPath = isW2hLayout ? `capture/assets/videos/${fname}` : `assets/videos/${fname}`;
   console.log(
     `${c.accent("\u25B8")} downloading [${entry.index}] ${entry.filename} (${entry.sourceWidth || entry.width}\xD7${entry.sourceHeight || entry.height})`
@@ -178567,7 +178691,7 @@ var init_video = __esm({
 
 // src/capture/partialCapture.ts
 import { mkdirSync as mkdirSync61 } from "fs";
-import { join as join134 } from "path";
+import { join as join135 } from "path";
 function serializeTokensForCapture(tokens) {
   const tokensForDisk = {
     ...tokens,
@@ -178616,15 +178740,15 @@ function createPartialCaptureState(opts) {
 function writePartialCaptureBundle(opts, state, lastPhase) {
   const hostname2 = new URL(opts.url).hostname.replace(/^www\./, "");
   mkdirSync61(opts.outputDir, { recursive: true });
-  const extractedDir = join134(opts.outputDir, "extracted");
+  const extractedDir = join135(opts.outputDir, "extracted");
   mkdirSync61(extractedDir, { recursive: true });
-  writeCaptureFileSync(join134(extractedDir, "tokens.json"), serializeTokensForCapture(state.tokens));
+  writeCaptureFileSync(join135(extractedDir, "tokens.json"), serializeTokensForCapture(state.tokens));
   writeCaptureFileSync(
-    join134(extractedDir, "design-styles.json"),
+    join135(extractedDir, "design-styles.json"),
     JSON.stringify(state.designStyles, null, 2)
   );
-  writeCaptureFileSync(join134(extractedDir, "page.html"), state.pageHtml);
-  const metaPath = join134(opts.outputDir, "meta.json");
+  writeCaptureFileSync(join135(extractedDir, "page.html"), state.pageHtml);
+  const metaPath = join135(opts.outputDir, "meta.json");
   try {
     writeCaptureFileSync(
       metaPath,
@@ -179263,7 +179387,7 @@ __export(agentPromptGenerator_exports, {
   generateAgentPrompt: () => generateAgentPrompt
 });
 import { readdirSync as readdirSync40, existsSync as existsSync117 } from "fs";
-import { join as join135 } from "path";
+import { join as join136 } from "path";
 function inferColorRole(hex) {
   const r = parseInt(hex.slice(1, 3), 16) / 255;
   const g = parseInt(hex.slice(3, 5), 16) / 255;
@@ -179282,9 +179406,9 @@ function inferColorRole(hex) {
 }
 function generateAgentPrompt(outputDir, url, tokens, _animations, hasScreenshot, hasLottie, hasShaders, _catalogedAssets, _detectedLibraries) {
   const prompt = buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShaders);
-  writeCaptureFileSync(join135(outputDir, "AGENTS.md"), prompt, "utf-8");
-  writeCaptureFileSync(join135(outputDir, "CLAUDE.md"), prompt, "utf-8");
-  writeCaptureFileSync(join135(outputDir, ".cursorrules"), prompt, "utf-8");
+  writeCaptureFileSync(join136(outputDir, "AGENTS.md"), prompt, "utf-8");
+  writeCaptureFileSync(join136(outputDir, "CLAUDE.md"), prompt, "utf-8");
+  writeCaptureFileSync(join136(outputDir, ".cursorrules"), prompt, "utf-8");
 }
 function buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShaders) {
   const title = tokens.title || new URL(url).hostname.replace(/^www\./, "");
@@ -179293,7 +179417,7 @@ function buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShader
     (f) => f.family + (f.variable && f.weightRange ? ` (${f.weightRange[0]}-${f.weightRange[1]} variable)` : f.weights.length > 0 ? ` (${f.weights.join(",")})` : "")
   ).join(", ") || "none detected";
   function contactSheetRows(dir, baseFile, label2) {
-    const fullDir = join135(outputDir, dir);
+    const fullDir = join136(outputDir, dir);
     if (!existsSync117(fullDir)) return [];
     const baseName = baseFile.replace(/\.jpg$/, "");
     const escapedBase = baseName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -179326,7 +179450,7 @@ function buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShader
   tableRows.push(
     `| \`extracted/tokens.json\` | Design tokens: ${tokens.colors.length} colors, ${tokens.fonts.length} fonts, ${tokens.headings?.length ?? 0} headings, ${tokens.ctas?.length ?? 0} CTAs |`
   );
-  if (existsSync117(join135(outputDir, "extracted", "design-styles.json"))) {
+  if (existsSync117(join136(outputDir, "extracted", "design-styles.json"))) {
     tableRows.push(
       "| `extracted/design-styles.json` | Computed styles from live DOM: typography hierarchy, button/card/nav styles, spacing scale, border-radius, box shadows. Primary data source for DESIGN.md. |"
     );
@@ -179399,7 +179523,7 @@ var init_agentPromptGenerator = __esm({
 
 // src/capture/scaffolding.ts
 import { existsSync as existsSync118, readFileSync as readFileSync90 } from "fs";
-import { join as join136, resolve as resolve77 } from "path";
+import { join as join137, resolve as resolve77 } from "path";
 function loadEnvFile(startDir) {
   try {
     let dir = resolve77(startDir);
@@ -179425,7 +179549,7 @@ function loadEnvFile(startDir) {
   }
 }
 async function generateProjectScaffold(outputDir, url, tokens, animationCatalog, hasScreenshots, hasLotties, hasShaders, catalogedAssets, progress, warnings, detectedLibraries) {
-  const metaPath = join136(outputDir, "meta.json");
+  const metaPath = join137(outputDir, "meta.json");
   if (!existsSync118(metaPath)) {
     const hostname2 = new URL(url).hostname.replace(/^www\./, "");
     writeNewFileSync(
@@ -179566,10 +179690,10 @@ var init_navigateForCapture = __esm({
 });
 
 // src/capture/responseRecord.ts
-import { join as join137 } from "path";
+import { join as join138 } from "path";
 function writeResponseRecord(extractedDir, record2) {
   writeCaptureFileSync(
-    join137(extractedDir, RESPONSE_RECORD_FILENAME),
+    join138(extractedDir, RESPONSE_RECORD_FILENAME),
     JSON.stringify(record2, null, 2),
     "utf-8"
   );
@@ -179584,7 +179708,7 @@ var init_responseRecord = __esm({
 });
 
 // src/capture/navigationPhase.ts
-import { join as join138 } from "path";
+import { join as join139 } from "path";
 async function navigatePage(context) {
   let navigation;
   try {
@@ -179638,7 +179762,7 @@ async function checkPageContent(context) {
 function persistNavigationResult(context, navigationResponse, pageContentCheck) {
   context.httpStatus = navigationResponse ? navigationResponse.status() : null;
   if (context.canWrite()) {
-    writeResponseRecord(join138(context.outputDir, "extracted"), { status: context.httpStatus });
+    writeResponseRecord(join139(context.outputDir, "extracted"), { status: context.httpStatus });
   }
   const blockedReason = detectBlockedPage({
     httpStatus: context.httpStatus,
@@ -179683,7 +179807,7 @@ import {
   fstatSync as fstatSync9,
   closeSync as closeSync15
 } from "fs";
-import { basename as basename33, join as join139 } from "path";
+import { basename as basename34, join as join140 } from "path";
 function resolveVisionPhaseCompletion(outcome, remainingMs) {
   if (outcome.budgetExhausted || remainingMs <= 0) {
     return { status: "degraded", reason: "budget-exhausted" };
@@ -179964,7 +180088,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
         return response.text?.trim() || "";
       };
     }
-    const imageFiles = readdirSync41(join139(outputDir, "assets")).filter(
+    const imageFiles = readdirSync41(join140(outputDir, "assets")).filter(
       (f) => /\.(png|jpg|jpeg|webp|gif)$/i.test(f)
     );
     const BATCH_SIZE = 20;
@@ -179992,7 +180116,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
       const batch = imageFiles.slice(i, i + BATCH_SIZE);
       const results = await Promise.allSettled(
         batch.map(async (file) => {
-          const filePath = join139(outputDir, "assets", file);
+          const filePath = join140(outputDir, "assets", file);
           const fd = openSync14(filePath, "r", 384);
           let buffer;
           try {
@@ -180031,11 +180155,11 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
       `${Object.keys(geminiCaptions).length} images captioned with ${providerName}`
     );
     const svgFiles = [];
-    const assetsDir = join139(outputDir, "assets");
+    const assetsDir = join140(outputDir, "assets");
     for (const f of readdirSync41(assetsDir)) {
       if (/\.svg$/i.test(f)) svgFiles.push({ file: f, relPath: f });
     }
-    const svgsSubdir = join139(assetsDir, "svgs");
+    const svgsSubdir = join140(assetsDir, "svgs");
     if (existsSync119(svgsSubdir)) {
       for (const f of readdirSync41(svgsSubdir)) {
         if (/\.svg$/i.test(f)) svgFiles.push({ file: f, relPath: `svgs/${f}` });
@@ -180069,7 +180193,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
         sharp5.concurrency(1);
         try {
           for (const { relPath } of batch) {
-            const filePath = join139(assetsDir, relPath);
+            const filePath = join140(assetsDir, relPath);
             try {
               const svgSource = readFileSync91(filePath, "utf-8");
               const lightFillHits = (svgSource.match(/fill\s*=\s*["'](#fff(fff)?|white|#[ef][ef][ef]|#[ef]{6})["']/gi) || []).length;
@@ -180144,11 +180268,11 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   const uncaptionedLines = [];
   const svgLines = [];
   const fontLines = [];
-  const assetsPath = join139(outputDir, "assets");
+  const assetsPath = join140(outputDir, "assets");
   try {
     for (const file of readdirSync41(assetsPath)) {
       if (file === "svgs" || file === "fonts" || file === "lottie" || file === "videos") continue;
-      const filePath = join139(assetsPath, file);
+      const filePath = join140(assetsPath, file);
       const stat = statSync44(filePath);
       if (!stat.isFile()) continue;
       const sizeKb = Math.round(stat.size / 1024);
@@ -180177,7 +180301,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   } catch {
   }
   try {
-    const svgsPath = join139(assetsPath, "svgs");
+    const svgsPath = join140(assetsPath, "svgs");
     for (const file of readdirSync41(svgsPath)) {
       if (!file.endsWith(".svg")) continue;
       const svgMatch = tokens.svgs.find(
@@ -180196,7 +180320,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   } catch {
   }
   try {
-    const fontsPath = join139(assetsPath, "fonts");
+    const fontsPath = join140(assetsPath, "fonts");
     for (const file of readdirSync41(fontsPath)) {
       fontLines.push(`fonts/${file} \u2014 font file`);
     }
@@ -180205,11 +180329,11 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   const videoLines = [];
   try {
     const manifest = JSON.parse(
-      readFileSync91(join139(outputDir, "extracted", "video-manifest.json"), "utf-8")
+      readFileSync91(join140(outputDir, "extracted", "video-manifest.json"), "utf-8")
     );
     for (const v2 of manifest) {
       if (!v2.localPath) continue;
-      const base2 = basename33(v2.localPath) || v2.filename || "";
+      const base2 = basename34(v2.localPath) || v2.filename || "";
       if (!base2) continue;
       const desc = (v2.caption || v2.heading || "").trim().replace(/\s+/g, " ").slice(0, 140) || "motion clip";
       const dimW = v2.sourceWidth || v2.width;
@@ -181481,7 +181605,7 @@ var init_lottiePreviewRequests = __esm({
 
 // src/capture/mediaCapture.ts
 import { mkdirSync as mkdirSync63, readdirSync as readdirSync43, readFileSync as readFileSync93, statSync as statSync45 } from "fs";
-import { join as join140, extname as extname25 } from "path";
+import { join as join141, extname as extname25 } from "path";
 function liveRemainingMs(budget, fallbackMs) {
   return budget.remainingMs?.() ?? fallbackMs;
 }
@@ -181519,7 +181643,7 @@ async function saveLottieAnimations(discoveredLotties, lottieDir, budget = {}) {
         if (savedHashes.has(hash2)) continue;
         savedHashes.add(hash2);
         if (!validLottieJson(jsonData)) continue;
-        writeCaptureFileSync(join140(lottieDir, `animation-${savedCount}.json`), jsonData, "utf-8");
+        writeCaptureFileSync(join141(lottieDir, `animation-${savedCount}.json`), jsonData, "utf-8");
         savedCount++;
       }
     } catch {
@@ -181529,18 +181653,18 @@ async function saveLottieAnimations(discoveredLotties, lottieDir, budget = {}) {
 }
 async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget = {}) {
   const manifest = [];
-  const previewDir = join140(lottieDir, "previews");
+  const previewDir = join141(lottieDir, "previews");
   mkdirSync63(previewDir, { recursive: true });
   for (const file of readdirSync43(lottieDir)) {
     if (!file.endsWith(".json")) continue;
     if (liveRemainingMs(budget, 1) <= 0) break;
     try {
-      const raw = JSON.parse(readFileSync93(join140(lottieDir, file), "utf-8"));
+      const raw = JSON.parse(readFileSync93(join141(lottieDir, file), "utf-8"));
       const fr = raw.fr || 30;
       const dur = ((raw.op || 0) - (raw.ip || 0)) / fr;
       const previewName = file.replace(".json", "-preview.png");
       let preview;
-      const fileSize = statSync45(join140(lottieDir, file)).size;
+      const fileSize = statSync45(join141(lottieDir, file)).size;
       if (fileSize > 2e6) continue;
       let previewPage;
       try {
@@ -181549,7 +181673,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget
         if (liveRemainingMs(budget, 1) <= 0) break;
         await guardLottiePreviewRequests(previewPage);
         await previewPage.setViewport({ width: 400, height: 400 });
-        const animData = JSON.parse(readFileSync93(join140(lottieDir, file), "utf-8"));
+        const animData = JSON.parse(readFileSync93(join141(lottieDir, file), "utf-8"));
         const midFrame = Math.floor(((raw.op || 0) - (raw.ip || 0)) * 0.3);
         await previewPage.setContent(
           `<!DOCTYPE html>
@@ -181579,11 +181703,8 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget
         await previewPage.waitForFunction(() => window.__READY === true, { timeout: 5e3 }).catch(() => {
         });
         if (liveRemainingMs(budget, 1) > 0) {
-          await previewPage.screenshot({
-            path: join140(previewDir, previewName),
-            type: "png",
-            omitBackground: true
-          });
+          const shot = await previewPage.screenshot({ type: "png", omitBackground: true });
+          writeCaptureFileSync(join141(previewDir, previewName), shot);
           preview = `assets/lottie/previews/${previewName}`;
         }
       } catch {
@@ -181606,7 +181727,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget
   }
   if (manifest.length > 0) {
     writeCaptureFileSync(
-      join140(outputDir, "extracted", "lottie-manifest.json"),
+      join141(outputDir, "extracted", "lottie-manifest.json"),
       JSON.stringify(manifest, null, 2),
       "utf-8"
     );
@@ -181644,7 +181765,7 @@ async function downloadVideoBody(srcUrl, filename, videosDir, timeoutMs) {
     }
     if (total < 1024) return null;
     const safe = /\.[a-z0-9]+$/i.test(filename) ? filename.replace(/[^\w.-]/g, "_") : `video${ext}`;
-    writeCaptureFileSync(join140(videosDir, safe), Buffer.concat(chunks));
+    writeCaptureFileSync(join141(videosDir, safe), Buffer.concat(chunks));
     return `assets/videos/${safe}`;
   } catch {
     return null;
@@ -181711,9 +181832,9 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
   }
   const merged = [...byKey.values()];
   if (merged.length === 0) return;
-  const videoManifestDir = join140(outputDir, "assets", "videos");
+  const videoManifestDir = join141(outputDir, "assets", "videos");
   mkdirSync63(videoManifestDir, { recursive: true });
-  const previewDir = join140(videoManifestDir, "previews");
+  const previewDir = join141(videoManifestDir, "previews");
   mkdirSync63(previewDir, { recursive: true });
   const videoManifest = [];
   const dlStart = Date.now();
@@ -181741,8 +181862,8 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
         if (rect && rect.width >= 10) {
           await new Promise((r) => setTimeout(r, 200));
           if (liveRemainingMs(opts ?? {}, 1) > 0) {
-            await page.screenshot({
-              path: join140(previewDir, previewName),
+            const shot = await page.screenshot({
+              type: "png",
               clip: {
                 x: Math.max(0, rect.x),
                 y: Math.max(0, rect.y),
@@ -181750,6 +181871,7 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
                 height: Math.min(rect.height, 1080)
               }
             });
+            writeCaptureFileSync(join141(previewDir, previewName), shot);
             preview = `assets/videos/previews/${previewName}`;
           }
         }
@@ -181779,7 +181901,7 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
   }
   if (videoManifest.length > 0) {
     writeCaptureFileSync(
-      join140(outputDir, "extracted", "video-manifest.json"),
+      join141(outputDir, "extracted", "video-manifest.json"),
       JSON.stringify(videoManifest, null, 2),
       "utf-8"
     );
@@ -181902,7 +182024,7 @@ __export(screenshotCapture_exports, {
   pngHeight: () => pngHeight
 });
 import { mkdirSync as mkdirSync64 } from "fs";
-import { join as join141 } from "path";
+import { join as join143 } from "path";
 function pngHeight(buf) {
   if (buf.length < 24) return null;
   if (buf[12] !== 73 || buf[13] !== 72 || buf[14] !== 68 || buf[15] !== 82) return null;
@@ -181927,7 +182049,7 @@ async function captureFullPagePlate(page, screenshotsDir, budget = {}) {
     const buffer = await page.screenshot({ type: "png", fullPage: true });
     const produced = pngHeight(buffer);
     if (produced != null && produced > MAX_PLATE_HEIGHT_PX) return null;
-    writeCaptureFileSync(join141(screenshotsDir, "full-page.png"), buffer);
+    writeCaptureFileSync(join143(screenshotsDir, "full-page.png"), buffer);
     return "screenshots/full-page.png";
   } finally {
     try {
@@ -181942,7 +182064,7 @@ async function captureFullPagePlate(page, screenshotsDir, budget = {}) {
   }
 }
 async function captureScrollScreenshots(page, outputDir, budget = {}) {
-  const screenshotsDir = join141(outputDir, "screenshots");
+  const screenshotsDir = join143(outputDir, "screenshots");
   mkdirSync64(screenshotsDir, { recursive: true });
   const MAX_SCREENSHOTS = 20;
   const filePaths = [];
@@ -182039,7 +182161,7 @@ async function captureScrollScreenshots(page, outputDir, budget = {}) {
         finalPositions[i] / Math.max(1, scrollHeight - viewportHeight) * 100
       );
       const filename = `scroll-${String(Math.min(pct, 100)).padStart(3, "0")}.png`;
-      const filePath = join141(screenshotsDir, filename);
+      const filePath = join143(screenshotsDir, filename);
       if ((budget.remainingMs?.() ?? 1) <= 0) break;
       const buffer = await page.screenshot({ type: "png" });
       writeCaptureFileSync(filePath, buffer);
@@ -182397,7 +182519,7 @@ var init_assetCataloger = __esm({
 
 // src/capture/coreExtractionPhase.ts
 import { mkdirSync as mkdirSync65 } from "fs";
-import { join as join143 } from "path";
+import { join as join144 } from "path";
 async function runCoreExtraction(input2) {
   let {
     page1,
@@ -182487,7 +182609,7 @@ async function runCoreExtraction(input2) {
     await collectNetworkLotties();
     const saveDiscoveredLotties = async () => {
       if (discoveredLotties.length > 0 && remainingMs() > 0) {
-        const lottieDir = join143(outputDir, "assets", "lottie");
+        const lottieDir = join144(outputDir, "assets", "lottie");
         if (!canWrite()) return;
         mkdirSync65(lottieDir, { recursive: true });
         const lottieBudget = { remainingMs, byteBudget: downloadByteBudget };
@@ -182514,7 +182636,7 @@ async function runCoreExtraction(input2) {
         capturedShaders = unique;
         if (canWrite()) {
           writeCaptureFileSync(
-            join143(outputDir, "extracted", "shaders.json"),
+            join144(outputDir, "extracted", "shaders.json"),
             JSON.stringify(unique, null, 2),
             "utf-8"
           );
@@ -182531,7 +182653,7 @@ async function runCoreExtraction(input2) {
     state.tokens = tokens;
     if (canWrite()) {
       writeCaptureFileSync(
-        join143(outputDir, "extracted", "tokens.json"),
+        join144(outputDir, "extracted", "tokens.json"),
         serializeTokensForCapture(tokens),
         "utf-8"
       );
@@ -182542,7 +182664,7 @@ async function runCoreExtraction(input2) {
       state.designStyles = designStyles;
       if (canWrite()) {
         writeCaptureFileSync(
-          join143(outputDir, "extracted", "design-styles.json"),
+          join144(outputDir, "extracted", "design-styles.json"),
           JSON.stringify(designStyles, null, 2),
           "utf-8"
         );
@@ -182685,7 +182807,7 @@ var init_coreExtractionPhase = __esm({
 
 // src/capture/fontMetadataExtractor.ts
 import { readdirSync as readdirSync44, readFileSync as readFileSync94, existsSync as existsSync120 } from "fs";
-import { join as join144 } from "path";
+import { join as join145 } from "path";
 import * as fontkit from "fontkit";
 function isFontCollection(value) {
   return value.type === "TTC" || value.type === "DFont";
@@ -182696,7 +182818,7 @@ function extractFontMetadata(fontsDir, outputPath) {
   if (existsSync120(fontsDir)) {
     const fontFiles = readdirSync44(fontsDir).filter((f) => /\.(woff2?|ttf|otf)$/i.test(f));
     for (const filename of fontFiles) {
-      const fullPath = join144(fontsDir, filename);
+      const fullPath = join145(fontsDir, filename);
       const meta = readSingleFont(fullPath, filename);
       if (meta.identified) {
         files.push(meta);
@@ -182871,7 +182993,7 @@ var init_fontMetadataExtractor = __esm({
 
 // src/capture/postExtractionPhase.ts
 import { existsSync as existsSync121 } from "fs";
-import { join as join145 } from "path";
+import { join as join146 } from "path";
 function hasVisionCredentials(skipVision) {
   return Boolean(
     !skipVision && (process.env.OPENROUTER_API_KEY || process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY || process.env.HYPERFRAMES_VERTEX_PROJECT_ID && process.env.HYPERFRAMES_VERTEX_SERVICE_ACCOUNT)
@@ -182879,7 +183001,7 @@ function hasVisionCredentials(skipVision) {
 }
 function writeAssetDescriptionsFile(outputDir, lines, header2) {
   writeCaptureFileSync(
-    join145(outputDir, "extracted", "asset-descriptions.md"),
+    join146(outputDir, "extracted", "asset-descriptions.md"),
     header2 + lines.map((line3) => `- ${line3}`).join("\n") + "\n",
     "utf-8"
   );
@@ -182922,8 +183044,8 @@ async function runPostExtraction(input2) {
     );
     try {
       const fontsManifest = extractFontMetadata(
-        join145(outputDir, "assets", "fonts"),
-        join145(outputDir, "extracted", "fonts-manifest.json")
+        join146(outputDir, "assets", "fonts"),
+        join146(outputDir, "extracted", "fonts-manifest.json")
       );
       if (fontsManifest.families.length > 0) {
         const summary = fontsManifest.families.map((f) => `${f.family}${f.variable ? " (variable)" : ""} \xD7 ${f.fileCount}`).join(", ");
@@ -182954,7 +183076,7 @@ async function runPostExtraction(input2) {
       };
       if (canWrite()) {
         writeCaptureFileSync(
-          join145(outputDir, "extracted", "animations.json"),
+          join146(outputDir, "extracted", "animations.json"),
           JSON.stringify(leanCatalog, null, 2),
           "utf-8"
         );
@@ -182977,7 +183099,7 @@ async function runPostExtraction(input2) {
         state.assets = assets;
         if (canWrite()) {
           writeCaptureFileSync(
-            join145(outputDir, "extracted", "icons-manifest.json"),
+            join146(outputDir, "extracted", "icons-manifest.json"),
             JSON.stringify(assetPass.icons, null, 2),
             "utf-8"
           );
@@ -183029,7 +183151,7 @@ async function runPostExtraction(input2) {
       if (assets.length && Array.isArray(tokens.sections)) {
         if (canWrite()) {
           writeCaptureFileSync(
-            join145(outputDir, "extracted", "tokens.json"),
+            join146(outputDir, "extracted", "tokens.json"),
             serializeTokensForCapture(tokens),
             "utf-8"
           );
@@ -183052,14 +183174,14 @@ ${extracted.bodyHtml}
 `;
     state.pageHtml = pageHtml;
     if (canWrite())
-      writeCaptureFileSync(join145(outputDir, "extracted", "page.html"), pageHtml, "utf-8");
+      writeCaptureFileSync(join146(outputDir, "extracted", "page.html"), pageHtml, "utf-8");
   } catch (err) {
     warnings.push(`page.html write failed: ${err}`);
   }
   if (visibleTextContent) {
     if (canWrite()) {
       writeCaptureFileSync(
-        join145(outputDir, "extracted", "visible-text.txt"),
+        join146(outputDir, "extracted", "visible-text.txt"),
         visibleTextContent,
         "utf-8"
       );
@@ -183121,8 +183243,8 @@ ${extracted.bodyHtml}
         const contactSheetBudget = { remainingMs };
         const runScrollContactSheet = async () => {
           const scrollSheets = await createScrollContactSheet2(
-            join145(outputDir, "screenshots"),
-            join145(outputDir, "screenshots", "contact-sheet.jpg"),
+            join146(outputDir, "screenshots"),
+            join146(outputDir, "screenshots", "contact-sheet.jpg"),
             contactSheetBudget
           );
           if (scrollSheets.length > 0)
@@ -183133,11 +183255,11 @@ ${extracted.bodyHtml}
         };
         await runScrollContactSheet();
         const runAssetContactSheet = async () => {
-          const assetsImgDir = join145(outputDir, "assets");
+          const assetsImgDir = join146(outputDir, "assets");
           if (existsSync121(assetsImgDir)) {
             const assetSheets = await createAssetContactSheet2(
               assetsImgDir,
-              join145(outputDir, "assets", "contact-sheet.jpg"),
+              join146(outputDir, "assets", "contact-sheet.jpg"),
               contactSheetBudget
             );
             if (assetSheets.length > 0)
@@ -183149,9 +183271,9 @@ ${extracted.bodyHtml}
         };
         await runAssetContactSheet();
         const runSvgContactSheet = async () => {
-          const svgsDir = join145(outputDir, "assets", "svgs");
-          const assetsRootDir = join145(outputDir, "assets");
-          const svgOutputPath = existsSync121(svgsDir) ? join145(outputDir, "assets", "svgs", "contact-sheet.jpg") : join145(outputDir, "assets", "contact-sheet-svgs.jpg");
+          const svgsDir = join146(outputDir, "assets", "svgs");
+          const assetsRootDir = join146(outputDir, "assets");
+          const svgOutputPath = existsSync121(svgsDir) ? join146(outputDir, "assets", "svgs", "contact-sheet.jpg") : join146(outputDir, "assets", "contact-sheet-svgs.jpg");
           const svgSheets = await createSvgContactSheet2(
             svgsDir,
             svgOutputPath,
@@ -183197,7 +183319,7 @@ var init_postExtractionPhase = __esm({
 
 // src/capture/captureAttempt.ts
 import { mkdirSync as mkdirSync66, existsSync as existsSync122 } from "fs";
-import { join as join146 } from "path";
+import { join as join147 } from "path";
 async function captureWebsiteAttempt(opts, onProgress, disableWebgl, watchdog, state) {
   const {
     url,
@@ -183242,9 +183364,9 @@ async function captureWebsiteAttempt(opts, onProgress, disableWebgl, watchdog, s
   };
   phase("browser", "started");
   loadEnvFile(outputDir);
-  mkdirSync66(join146(outputDir, "extracted"), { recursive: true });
-  mkdirSync66(join146(outputDir, "screenshots"), { recursive: true });
-  mkdirSync66(join146(outputDir, "assets"), { recursive: true });
+  mkdirSync66(join147(outputDir, "extracted"), { recursive: true });
+  mkdirSync66(join147(outputDir, "screenshots"), { recursive: true });
+  mkdirSync66(join147(outputDir, "assets"), { recursive: true });
   progress("browser", "Launching headless Chrome...");
   const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
   const browser = await ensureBrowser2();
@@ -183411,7 +183533,7 @@ async function captureWebsiteAttempt(opts, onProgress, disableWebgl, watchdog, s
         animationCatalog,
         screenshots.length > 0,
         discoveredLotties.length > 0,
-        existsSync122(join146(outputDir, "extracted", "shaders.json")),
+        existsSync122(join147(outputDir, "extracted", "shaders.json")),
         catalogedAssets,
         progress,
         warnings,
@@ -183765,11 +183887,12 @@ var init_capture2 = __esm({
         } catch (err) {
           const errMsg = normalizeErrorMessage(err);
           try {
-            const { mkdirSync: mkdirSync76, writeFileSync: writeFileSync60 } = await import("fs");
+            const { mkdirSync: mkdirSync76 } = await import("fs");
             const { formatCaptureFailureReason: formatCaptureFailureReason2 } = await Promise.resolve().then(() => (init_captureTimeout(), captureTimeout_exports));
+            const { writeCaptureFileSync: writeCaptureFileSync2 } = await Promise.resolve().then(() => (init_captureFile(), captureFile_exports));
             mkdirSync76(outputDir, { recursive: true });
             const reason = formatCaptureFailureReason2(errMsg);
-            writeFileSync60(
+            writeCaptureFileSync2(
               `${outputDir}/BLOCKED.md`,
               `# Capture Failed
 
@@ -183833,14 +183956,14 @@ __export(state_exports, {
   stateFilePath: () => stateFilePath,
   writeStackOutputs: () => writeStackOutputs
 });
-import { existsSync as existsSync123, mkdirSync as mkdirSync67, readdirSync as readdirSync45, readFileSync as readFileSync95, rmSync as rmSync40, writeFileSync as writeFileSync51 } from "fs";
-import { dirname as dirname64, join as join147 } from "path";
+import { existsSync as existsSync123, mkdirSync as mkdirSync67, readdirSync as readdirSync45, readFileSync as readFileSync95, rmSync as rmSync41, writeFileSync as writeFileSync51 } from "fs";
+import { dirname as dirname65, join as join148 } from "path";
 function stateFilePath(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
-  return join147(cwd, STATE_DIR_NAME, `${STATE_FILE_PREFIX}${stackName}.json`);
+  return join148(cwd, STATE_DIR_NAME, `${STATE_FILE_PREFIX}${stackName}.json`);
 }
 function writeStackOutputs(outputs, cwd = process.cwd()) {
   const path = stateFilePath(outputs.stackName, cwd);
-  mkdirSync67(dirname64(path), { recursive: true });
+  mkdirSync67(dirname65(path), { recursive: true });
   writeFileSync51(path, JSON.stringify(outputs, null, 2) + "\n");
   return path;
 }
@@ -183855,10 +183978,10 @@ function readStackOutputs(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
 }
 function deleteStackOutputs(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   const path = stateFilePath(stackName, cwd);
-  if (existsSync123(path)) rmSync40(path);
+  if (existsSync123(path)) rmSync41(path);
 }
 function listStackNames(cwd = process.cwd()) {
-  const dir = join147(cwd, STATE_DIR_NAME);
+  const dir = join148(cwd, STATE_DIR_NAME);
   if (!existsSync123(dir)) return [];
   return readdirSync45(dir).filter((f) => f.startsWith(STATE_FILE_PREFIX) && f.endsWith(".json")).map((f) => f.slice(STATE_FILE_PREFIX.length, -".json".length));
 }
@@ -183891,7 +184014,7 @@ var init_state = __esm({
 // src/commands/lambda/sam.ts
 import { execFileSync as execFileSync19, spawnSync as spawnSync5 } from "child_process";
 import { existsSync as existsSync124 } from "fs";
-import { join as join148 } from "path";
+import { join as join149 } from "path";
 function assertSamAvailable() {
   try {
     execFileSync19("sam", ["--version"], { stdio: "ignore" });
@@ -183911,7 +184034,7 @@ function assertAwsCliAvailable() {
   }
 }
 function locateSamTemplate(repoRoot2) {
-  const candidate = join148(repoRoot2, "examples", "aws-lambda", "template.yaml");
+  const candidate = join149(repoRoot2, "examples", "aws-lambda", "template.yaml");
   if (!existsSync124(candidate)) {
     throw new Error(
       `[lambda] SAM template not found at ${candidate}. If you're running from an installed package, point --sam-template at your local copy of examples/aws-lambda/template.yaml.`
@@ -183945,7 +184068,7 @@ function samDeploy(opts) {
   if (opts.awsProfile) {
     args.push("--profile", opts.awsProfile);
   }
-  const samDir = join148(opts.repoRoot, "examples", "aws-lambda");
+  const samDir = join149(opts.repoRoot, "examples", "aws-lambda");
   const result = spawnSync5("sam", args, { cwd: samDir, stdio: opts.stdio ?? "inherit" });
   if (result.status !== 0) {
     throw new Error(
@@ -183963,7 +184086,7 @@ function samDelete(opts) {
   if (opts.awsProfile) {
     args.push("--profile", opts.awsProfile);
   }
-  const samDir = join148(opts.repoRoot, "examples", "aws-lambda");
+  const samDir = join149(opts.repoRoot, "examples", "aws-lambda");
   const result = spawnSync5("sam", args, { cwd: samDir, stdio: opts.stdio ?? "inherit" });
   if (result.status !== 0) {
     throw new Error(`[lambda] sam delete exited with code ${result.status ?? "unknown"}`);
@@ -184014,19 +184137,19 @@ var init_sam = __esm({
 
 // src/commands/lambda/repoRoot.ts
 import { existsSync as existsSync125 } from "fs";
-import { dirname as dirname65, resolve as resolve79 } from "path";
+import { dirname as dirname66, resolve as resolve79 } from "path";
 import { fileURLToPath as fileURLToPath17 } from "url";
 function repoRoot() {
   const override = process.env.HYPERFRAMES_REPO_ROOT;
   if (override && existsSync125(resolve79(override, "packages", "aws-lambda", "package.json"))) {
     return override;
   }
-  let dir = dirname65(fileURLToPath17(import.meta.url));
+  let dir = dirname66(fileURLToPath17(import.meta.url));
   for (let depth = 0; depth < 12; depth++) {
     if (existsSync125(resolve79(dir, "packages", "aws-lambda", "package.json"))) {
       return dir;
     }
-    const parent = dirname65(dir);
+    const parent = dirname66(dir);
     if (parent === dir) break;
     dir = parent;
   }
@@ -184047,7 +184170,7 @@ __export(deploy_exports, {
 });
 import { spawnSync as spawnSync6 } from "child_process";
 import { existsSync as existsSync126 } from "fs";
-import { join as join149, resolve as resolve80 } from "path";
+import { join as join150, resolve as resolve80 } from "path";
 async function runDeploy(args = {}) {
   const resolved2 = {
     stackName: args.stackName ?? DEFAULT_STACK_NAME,
@@ -184064,7 +184187,7 @@ async function runDeploy(args = {}) {
     console.log(c.dim("\u2192 Building handler ZIP"));
     buildHandlerZip(root);
   } else {
-    const zip = join149(root, "packages", "aws-lambda", "dist", "handler.zip");
+    const zip = join150(root, "packages", "aws-lambda", "dist", "handler.zip");
     if (!existsSync126(zip)) {
       throw new Error(
         `--skip-build set but ${zip} does not exist. Run \`bun run --cwd packages/aws-lambda build:zip\` first or drop --skip-build.`
@@ -184108,7 +184231,7 @@ async function runDeploy(args = {}) {
 function buildHandlerZip(root) {
   const result = spawnSync6(
     "bun",
-    ["run", "--cwd", join149(root, "packages", "aws-lambda"), "build:zip"],
+    ["run", "--cwd", join150(root, "packages", "aws-lambda"), "build:zip"],
     { stdio: "inherit" }
   );
   if (result.status !== 0) {
@@ -184178,13 +184301,13 @@ var init_sites = __esm({
 
 // src/commands/lambda/_dimensions.ts
 import { readFileSync as readFileSync96 } from "fs";
-import { join as join150 } from "path";
+import { join as join151 } from "path";
 function warnOnDimensionMismatch(args) {
   if (args.quiet) return;
   if (args.outputResolution) return;
   let html;
   try {
-    html = readFileSync96(join150(args.projectDir, "index.html"), "utf-8");
+    html = readFileSync96(join151(args.projectDir, "index.html"), "utf-8");
   } catch {
     return;
   }
@@ -184214,7 +184337,7 @@ __export(render_exports2, {
   runRender: () => runRender
 });
 import { existsSync as existsSync127 } from "fs";
-import { join as join151, resolve as resolvePath2 } from "path";
+import { join as join152, resolve as resolvePath2 } from "path";
 async function loadSDK2() {
   return import("@hyperframes/aws-lambda/sdk");
 }
@@ -184230,7 +184353,7 @@ async function runRender(args) {
   });
   const variables = resolveVariablesArg(args.variables, args.variablesFile);
   if (variables && Object.keys(variables).length > 0) {
-    const indexPath2 = join151(projectDir, "index.html");
+    const indexPath2 = join152(projectDir, "index.html");
     if (existsSync127(indexPath2)) {
       const issues = validateVariablesAgainstProject(indexPath2, variables);
       reportVariableIssues(issues, { strict: args.strictVariables ?? false, quiet: args.json });
@@ -184365,7 +184488,7 @@ __export(render_batch_exports, {
   runWithConcurrencyLimit: () => runWithConcurrencyLimit
 });
 import { existsSync as existsSync128, readFileSync as readFileSync97 } from "fs";
-import { join as join152, resolve as resolvePath3 } from "path";
+import { join as join153, resolve as resolvePath3 } from "path";
 async function loadSDK3() {
   return import("@hyperframes/aws-lambda/sdk");
 }
@@ -184389,7 +184512,7 @@ async function runRenderBatch(args) {
     outputResolution: args.outputResolution,
     quiet: args.json
   });
-  const schema = loadProjectVariableSchema(join152(projectDir, "index.html"));
+  const schema = loadProjectVariableSchema(join153(projectDir, "index.html"));
   const strict = args.strictVariables ?? false;
   let hadStrictIssue = false;
   for (const { entry, lineNumber } of entries2) {
@@ -185437,7 +185560,7 @@ __export(cloudrun_exports, {
 import { spawnSync as spawnSync7 } from "child_process";
 import { existsSync as existsSync129, mkdirSync as mkdirSync68, readFileSync as readFileSync99, writeFileSync as writeFileSync53 } from "fs";
 import { homedir as homedir24 } from "os";
-import { join as join153, resolve as resolve81 } from "path";
+import { join as join154, resolve as resolve81 } from "path";
 function loadCloudRunAdapter() {
   cloudRunAdapterPromise ??= Promise.all([
     import("@hyperframes/gcp-cloud-run/sdk"),
@@ -185456,10 +185579,10 @@ Or, for an opt-in project setup:
   ${c.accent("npm install @hyperframes/gcp-cloud-run")}`;
 }
 function stateDir() {
-  return join153(homedir24(), ".hyperframes");
+  return join154(homedir24(), ".hyperframes");
 }
 function statePath() {
-  return join153(stateDir(), "cloudrun-state.json");
+  return join154(stateDir(), "cloudrun-state.json");
 }
 function writeState2(state) {
   mkdirSync68(stateDir(), { recursive: true });
@@ -185616,11 +185739,11 @@ function machineVars(args, project, region, image) {
 }
 function findRepoRoot(tfDir) {
   const candidate = resolve81(tfDir, "..", "..", "..");
-  if (existsSync129(join153(candidate, "packages", "gcp-cloud-run", "Dockerfile"))) return candidate;
+  if (existsSync129(join154(candidate, "packages", "gcp-cloud-run", "Dockerfile"))) return candidate;
   return null;
 }
 function writeCloudBuildConfig(image) {
-  const cfgPath = join153(stateDir(), "cloudrun-cloudbuild.yaml");
+  const cfgPath = join154(stateDir(), "cloudrun-cloudbuild.yaml");
   mkdirSync68(stateDir(), { recursive: true });
   writeFileSync53(
     cfgPath,
@@ -185912,7 +186035,7 @@ function resolveAndValidateVariables(args, projectDir) {
     args["variables-file"]
   );
   if (variables && Object.keys(variables).length > 0) {
-    const indexPath2 = join153(projectDir, "index.html");
+    const indexPath2 = join154(projectDir, "index.html");
     if (existsSync129(indexPath2)) {
       const issues = validateVariablesAgainstProject(indexPath2, variables);
       reportVariableIssues(issues, {
@@ -186279,13 +186402,13 @@ import {
   createWriteStream as createWriteStream4,
   lstatSync as lstatSync11,
   mkdirSync as mkdirSync69,
-  mkdtempSync as mkdtempSync27,
+  mkdtempSync as mkdtempSync28,
   readlinkSync as readlinkSync2,
-  renameSync as renameSync23,
-  rmSync as rmSync41,
+  renameSync as renameSync24,
+  rmSync as rmSync43,
   statSync as statSync46
 } from "fs";
-import { dirname as dirname66, join as join154, resolve as resolve82 } from "path";
+import { dirname as dirname67, join as join155, resolve as resolve82 } from "path";
 import { pipeline as pipeline3 } from "stream/promises";
 async function downloadToFile(url, destPath, options = {}) {
   const fetchImpl = options.fetchImpl ?? fetch;
@@ -186296,14 +186419,14 @@ async function downloadToFile(url, destPath, options = {}) {
   if (!res.body) {
     throw new Error(`Failed to download ${url}: empty response body`);
   }
-  mkdirSync69(dirname66(destPath), { recursive: true });
+  mkdirSync69(dirname67(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;
   const destination = resolveDownloadDestination(destPath);
   const previous = statSync46(destination, { throwIfNoEntry: false });
-  const stage = mkdtempSync27(join154(dirname66(destination), ".hf-download-"));
-  const stagedFile = join154(stage, "download");
+  const stage = mkdtempSync28(join155(dirname67(destination), ".hf-download-"));
+  const stagedFile = join155(stage, "download");
   let bytes = 0;
   try {
     await pipeline3(
@@ -186324,13 +186447,13 @@ async function downloadToFile(url, destPath, options = {}) {
     );
     options.signal?.throwIfAborted();
     if (previous?.isFile()) chmodSync2(stagedFile, previous.mode & 511);
-    renameSync23(stagedFile, destination);
+    renameSync24(stagedFile, destination);
   } catch (error) {
     const reason = options.signal?.reason;
     if (options.signal?.aborted && reason instanceof Error) throw reason;
     throw error;
   } finally {
-    rmSync41(stage, { recursive: true, force: true });
+    rmSync43(stage, { recursive: true, force: true });
   }
   return { path: destPath, bytes };
 }
@@ -186338,7 +186461,7 @@ function resolveDownloadDestination(destPath) {
   let destination = resolve82(destPath);
   for (let hops = 0; hops < 40; hops++) {
     if (!lstatSync11(destination, { throwIfNoEntry: false })?.isSymbolicLink()) return destination;
-    destination = resolve82(dirname66(destination), readlinkSync2(destination));
+    destination = resolve82(dirname67(destination), readlinkSync2(destination));
   }
   throw new Error(`Too many symbolic links in download destination: ${destPath}`);
 }
@@ -188939,8 +189062,8 @@ var init_parseFigmaRef = __esm({
 });
 
 // ../core/dist/figma/freeze.js
-import { copyFileSync as copyFileSync11, mkdirSync as mkdirSync70, rmSync as rmSync43, statSync as statSync47, writeFileSync as writeFileSync54 } from "fs";
-import { dirname as dirname67 } from "path";
+import { copyFileSync as copyFileSync11, mkdirSync as mkdirSync70, rmSync as rmSync44, statSync as statSync47, writeFileSync as writeFileSync54 } from "fs";
+import { dirname as dirname68 } from "path";
 function exceedsFreezeCap(byteLength) {
   return byteLength > MAX_FREEZE_BYTES;
 }
@@ -188949,13 +189072,13 @@ function freezeBytes(bytes, destPath) {
     throw new Error("freeze failed: empty bytes");
   if (exceedsFreezeCap(bytes.length))
     throw new Error(`freeze failed: ${bytes.length} bytes exceeds ${MAX_FREEZE_BYTES} cap`);
-  mkdirSync70(dirname67(destPath), { recursive: true });
+  mkdirSync70(dirname68(destPath), { recursive: true });
   try {
     writeFileSync54(destPath, bytes, { flag: "wx" });
   } catch (err) {
     if (err.code !== "EEXIST")
       throw err;
-    rmSync43(destPath);
+    rmSync44(destPath);
     writeFileSync54(destPath, bytes, { flag: "wx" });
   }
   return bytes.length;
@@ -188994,15 +189117,15 @@ var init_jsonl = __esm({
 
 // ../core/dist/figma/manifest.js
 import { appendFileSync as appendFileSync2, existsSync as existsSync132, mkdirSync as mkdirSync71, readFileSync as readFileSync103, writeFileSync as writeFileSync55 } from "fs";
-import { join as join155 } from "path";
+import { join as join156 } from "path";
 function mediaDir(projectDir) {
-  return join155(projectDir, ".media");
+  return join156(projectDir, ".media");
 }
 function manifestPath2(projectDir) {
-  return join155(mediaDir(projectDir), MANIFEST_FILE2);
+  return join156(mediaDir(projectDir), MANIFEST_FILE2);
 }
 function typeDirPath(projectDir, type) {
-  return join155(mediaDir(projectDir), TYPE_DIRS[type]);
+  return join156(mediaDir(projectDir), TYPE_DIRS[type]);
 }
 function isFigmaManifestRecord(value) {
   if (typeof value !== "object" || value === null)
@@ -189089,12 +189212,12 @@ var init_manifest = __esm({
 
 // ../core/dist/figma/mediaIndex.js
 import { mkdirSync as mkdirSync72, writeFileSync as writeFileSync56 } from "fs";
-import { dirname as dirname68, join as join156 } from "path";
+import { dirname as dirname69, join as join157 } from "path";
 function isRow(value) {
   return typeof value === "object" && value !== null;
 }
 function indexPath(projectDir) {
-  return join156(mediaDir(projectDir), "index.md");
+  return join157(mediaDir(projectDir), "index.md");
 }
 function pad(str, len2) {
   return String(str ?? "").padEnd(len2);
@@ -189139,7 +189262,7 @@ function regenerateIndex(projectDir) {
   const records = readJsonlValues(manifestPath2(projectDir)).filter(isRow);
   const content = generateIndexContent(records);
   const p2 = indexPath(projectDir);
-  mkdirSync72(dirname68(p2), { recursive: true });
+  mkdirSync72(dirname69(p2), { recursive: true });
   writeFileSync56(p2, content);
   return content;
 }
@@ -189206,9 +189329,9 @@ var init_sanitizeSvg = __esm({
 
 // ../core/dist/figma/bindings.js
 import { appendFileSync as appendFileSync3, mkdirSync as mkdirSync73, writeFileSync as writeFileSync57 } from "fs";
-import { join as join157 } from "path";
+import { join as join158 } from "path";
 function bindingsPath(projectDir) {
-  return join157(mediaDir(projectDir), BINDINGS_FILE);
+  return join158(mediaDir(projectDir), BINDINGS_FILE);
 }
 function isRecord17(value) {
   return typeof value === "object" && value !== null;
@@ -189809,7 +189932,7 @@ __export(asset_exports, {
   runAssetImportMany: () => runAssetImportMany
 });
 import { existsSync as existsSync133 } from "fs";
-import { join as join158, relative as relative36 } from "path";
+import { join as join159, relative as relative36 } from "path";
 function gatherAssetRefs(positionals) {
   return positionals.flatMap((r) => /^https?:/i.test(r.trim()) ? [r] : r.split(",")).map((r) => r.trim()).filter((r) => r.length > 0);
 }
@@ -189823,7 +189946,7 @@ function requireNodeRef(refInput) {
 }
 function reuseExisting(fileKey2, nodeId, opts, version2, deps, description, entity) {
   const existing = findAllByFigmaNode(deps.projectDir, fileKey2, nodeId).find(
-    (r) => r.provenance.format === opts.format && (r.provenance.scale ?? 1) === (opts.scale ?? 1) && r.provenance.version === version2 && existsSync133(join158(deps.projectDir, r.path))
+    (r) => r.provenance.format === opts.format && (r.provenance.scale ?? 1) === (opts.scale ?? 1) && r.provenance.version === version2 && existsSync133(join159(deps.projectDir, r.path))
   );
   if (!existing) return null;
   let record2 = existing;
@@ -189846,7 +189969,7 @@ async function freezeAndRecord(fileKey2, nodeId, url, ext, opts, version2, deps,
     bytes = new TextEncoder().encode(sanitizeSvg(new TextDecoder().decode(bytes)));
   }
   const id = nextId(deps.projectDir, "image");
-  const destAbs = join158(typeDirPath(deps.projectDir, "image"), `${id}.${ext}`);
+  const destAbs = join159(typeDirPath(deps.projectDir, "image"), `${id}.${ext}`);
   freezeBytes(bytes, destAbs);
   const record2 = {
     id,
@@ -190016,11 +190139,11 @@ __export(tokens_exports, {
   runTokensImport: () => runTokensImport
 });
 import { writeFileSync as writeFileSync58 } from "fs";
-import { join as join159 } from "path";
+import { join as join160 } from "path";
 async function runTokensImport(refInput, deps) {
   const { fileKey: fileKey2 } = parseFigmaRef(refInput);
   const { version: version2 } = await deps.client.fileVersion(fileKey2);
-  const sidecarPath = join159(deps.projectDir, "figma-tokens.json");
+  const sidecarPath = join160(deps.projectDir, "figma-tokens.json");
   let vars = null;
   try {
     vars = await deps.client.variables(fileKey2);
@@ -190095,7 +190218,7 @@ __export(component_exports, {
   runComponentImport: () => runComponentImport
 });
 import { existsSync as existsSync134, mkdirSync as mkdirSync74, writeFileSync as writeFileSync59 } from "fs";
-import { join as join160, relative as relative37 } from "path";
+import { join as join161, relative as relative37 } from "path";
 function escapeAttr2(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
@@ -190106,7 +190229,7 @@ async function runComponentImport(refInput, deps) {
   const bindings = resolveBindings(tree, readBindings(deps.projectDir));
   const mapped = nodeToHtml(tree, bindings, { rootName: deps.name });
   const name = slugify(deps.name ?? tree.name);
-  const componentDir = join160(deps.projectDir, "compositions", "components", name);
+  const componentDir = join161(deps.projectDir, "compositions", "components", name);
   if (existsSync134(componentDir))
     console.warn(
       `component dir compositions/components/${name} already exists \u2014 overwriting (rename the figma frame for a separate import)`
@@ -190118,7 +190241,7 @@ async function runComponentImport(refInput, deps) {
     componentDir,
     deps
   );
-  const htmlFile = join160(componentDir, `${name}.html`);
+  const htmlFile = join161(componentDir, `${name}.html`);
   writeFileSync59(htmlFile, html + "\n");
   const registryItem = {
     name,
@@ -190140,7 +190263,7 @@ async function runComponentImport(refInput, deps) {
     ]
   };
   writeFileSync59(
-    join160(componentDir, "registry-item.json"),
+    join161(componentDir, "registry-item.json"),
     JSON.stringify(registryItem, null, 2) + "\n"
   );
   return {
@@ -190165,7 +190288,7 @@ async function rasterizeFallback(mapped, fileKey2, componentDir, deps) {
       continue;
     }
     frozenAssets.push(asset.record.path);
-    const srcRel = relative37(componentDir, join160(deps.projectDir, asset.record.path)).replaceAll(
+    const srcRel = relative37(componentDir, join161(deps.projectDir, asset.record.path)).replaceAll(
       "\\",
       "/"
     );
@@ -190314,7 +190437,7 @@ __export(autoUpdate_exports, {
 import { spawn as spawn19 } from "child_process";
 import { appendFileSync as appendFileSync4, mkdirSync as mkdirSync75, openSync as openSync15 } from "fs";
 import { homedir as homedir25 } from "os";
-import { join as join161 } from "path";
+import { join as join162 } from "path";
 import { compareVersions as compareVersions3 } from "compare-versions";
 function isAutoInstallDisabled() {
   if (isDevMode()) return true;
@@ -190337,7 +190460,7 @@ function log(line3) {
 }
 function launchDetachedInstall(invocation, displayCommand, version2) {
   mkdirSync75(CONFIG_DIR3, { recursive: true, mode: 448 });
-  const configFile = join161(CONFIG_DIR3, "config.json");
+  const configFile = join162(CONFIG_DIR3, "config.json");
   const nodeScript = `
     const { execFile } = require("node:child_process");
     const { readFileSync, renameSync, writeFileSync } = require("node:fs");
@@ -190458,8 +190581,8 @@ var init_autoUpdate = __esm({
     init_config();
     init_env();
     init_installerDetection();
-    CONFIG_DIR3 = join161(homedir25(), ".hyperframes");
-    LOG_FILE = join161(CONFIG_DIR3, "auto-update.log");
+    CONFIG_DIR3 = join162(homedir25(), ".hyperframes");
+    LOG_FILE = join162(CONFIG_DIR3, "auto-update.log");
     PENDING_TIMEOUT_MS = 10 * 60 * 1e3;
   }
 });
@@ -190655,7 +190778,7 @@ var init_help = __esm({
 init_version();
 init_dist();
 init_runId();
-import { dirname as dirname69, join as join162, resolve as resolve83 } from "path";
+import { dirname as dirname70, join as join163, resolve as resolve83 } from "path";
 import { fileURLToPath as fileURLToPath18 } from "url";
 import { existsSync as existsSync135 } from "fs";
 
@@ -190774,8 +190897,8 @@ for (const stream of [process.stdout, process.stderr]) {
   });
 }
 (() => {
-  const here = dirname69(fileURLToPath18(import.meta.url));
-  const shader = join162(here, "shaderTransitionWorker.js");
+  const here = dirname70(fileURLToPath18(import.meta.url));
+  const shader = join163(here, "shaderTransitionWorker.js");
   if (!process.env.HF_SHADER_WORKER_ENTRY && existsSync135(shader)) {
     process.env.HF_SHADER_WORKER_ENTRY = shader;
   }
@@ -190816,7 +190939,7 @@ try {
 var isHelp = process.argv.includes("--help") || process.argv.includes("-h");
 async function assertStudioWorkspaceBuilt() {
   if (!isDevMode()) return;
-  const repoRoot2 = resolve83(dirname69(fileURLToPath18(import.meta.url)), "..", "..", "..");
+  const repoRoot2 = resolve83(dirname70(fileURLToPath18(import.meta.url)), "..", "..", "..");
   const { checkStudioWorkspaceBuild: checkStudioWorkspaceBuild2, formatWorkspaceBuildProblems: formatWorkspaceBuildProblems2 } = await Promise.resolve().then(() => (init_workspaceBuildCheck(), workspaceBuildCheck_exports));
   const problems = checkStudioWorkspaceBuild2(repoRoot2);
   if (problems.length === 0) return;