hyperframes 0.7.103 → 0.7.105

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.7.103" : "0.0.0-dev";
+    VERSION = true ? "0.7.105" : "0.0.0-dev";
   }
 });
 
@@ -4819,7 +4819,7 @@ var require_util = __commonJS({
       return url;
     }
     exports.urlGenerate = urlGenerate;
-    function normalize(aPath) {
+    function normalize3(aPath) {
       var path2 = aPath;
       var url = urlParse(aPath);
       if (url) {
@@ -4856,8 +4856,8 @@ var require_util = __commonJS({
       }
       return path2;
     }
-    exports.normalize = normalize;
-    function join138(aRoot, aPath) {
+    exports.normalize = normalize3;
+    function join140(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -4882,14 +4882,14 @@ var require_util = __commonJS({
         aRootUrl.host = aPath;
         return urlGenerate(aRootUrl);
       }
-      var joined = aPath.charAt(0) === "/" ? aPath : normalize(aRoot.replace(/\/+$/, "") + "/" + aPath);
+      var joined = aPath.charAt(0) === "/" ? aPath : normalize3(aRoot.replace(/\/+$/, "") + "/" + aPath);
       if (aRootUrl) {
         aRootUrl.path = joined;
         return urlGenerate(aRootUrl);
       }
       return joined;
     }
-    exports.join = join138;
+    exports.join = join140;
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -5062,9 +5062,9 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join138(urlGenerate(parsed), sourceURL);
+        sourceURL = join140(urlGenerate(parsed), sourceURL);
       }
-      return normalize(sourceURL);
+      return normalize3(sourceURL);
     }
     exports.computeSourceURL = computeSourceURL;
   }
@@ -6815,7 +6815,7 @@ var require_esprima2 = __commonJS({
               return parse9(code, parsingOptions, delegate);
             }
             exports2.parseScript = parseScript2;
-            function tokenize(code, options, delegate) {
+            function tokenize2(code, options, delegate) {
               var tokenizer2 = new tokenizer_1.Tokenizer(code, options);
               var tokens;
               tokens = [];
@@ -6838,7 +6838,7 @@ var require_esprima2 = __commonJS({
               }
               return tokens;
             }
-            exports2.tokenize = tokenize;
+            exports2.tokenize = tokenize2;
             var syntax_1 = __webpack_require__(2);
             exports2.Syntax = syntax_1.Syntax;
             exports2.version = "4.0.1";
@@ -13003,7 +13003,7 @@ var require_options = __commonJS({
       tokens: true
     };
     var hasOwn4 = defaults.hasOwnProperty;
-    function normalize(opts) {
+    function normalize3(opts) {
       var options = opts || defaults;
       function get(key2) {
         return hasOwn4.call(options, key2) ? options[key2] : defaults[key2];
@@ -13030,7 +13030,7 @@ var require_options = __commonJS({
         tokens: !!get("tokens")
       };
     }
-    exports.normalize = normalize;
+    exports.normalize = normalize3;
   }
 });
 
@@ -21731,7 +21731,7 @@ var require_lib = __commonJS({
     }
     var skipWhiteSpace2 = /(?:\s|\/\/.*|\/\*[^]*?\*\/)*/g;
     var skipWhiteSpaceInLine = /(?:[^\S\n\r\u2028\u2029]|\/\/.*|\/\*.*?\*\/)*/g;
-    function isWhitespace3(code2) {
+    function isWhitespace4(code2) {
       switch (code2) {
         case 9:
         case 11:
@@ -23238,7 +23238,7 @@ var require_lib = __commonJS({
               }
               break;
             default:
-              if (isWhitespace3(ch)) {
+              if (isWhitespace4(ch)) {
                 ++this.state.pos;
               } else if (ch === 45 && !this.inModule && this.optionFlags & 8192) {
                 const pos = this.state.pos;
@@ -40807,7 +40807,7 @@ function formatAttributes(attributes2, opts) {
   var _a4;
   if (!attributes2)
     return;
-  const encode2 = ((_a4 = opts.encodeEntities) !== null && _a4 !== void 0 ? _a4 : opts.decodeEntities) === false ? replaceQuotes : opts.xmlMode || opts.encodeEntities !== "utf8" ? encodeXML : escapeAttribute;
+  const encode3 = ((_a4 = opts.encodeEntities) !== null && _a4 !== void 0 ? _a4 : opts.decodeEntities) === false ? replaceQuotes : opts.xmlMode || opts.encodeEntities !== "utf8" ? encodeXML : escapeAttribute;
   return Object.keys(attributes2).map((key2) => {
     var _a5, _b;
     const value = (_a5 = attributes2[key2]) !== null && _a5 !== void 0 ? _a5 : "";
@@ -40817,7 +40817,7 @@ function formatAttributes(attributes2, opts) {
     if (!opts.emptyAttrs && !opts.xmlMode && value === "") {
       return key2;
     }
-    return `${key2}="${encode2(value)}"`;
+    return `${key2}="${encode3(value)}"`;
   }).join(" ");
 }
 function render(node, options = {}) {
@@ -62930,7 +62930,10 @@ function passthroughFields(parsed) {
     skillsUpdateAvailable: parsed.skillsUpdateAvailable,
     skillsOutdatedCount: parsed.skillsOutdatedCount,
     skillsMissingCount: parsed.skillsMissingCount,
-    skillsRemovedCount: parsed.skillsRemovedCount
+    skillsRemovedCount: parsed.skillsRemovedCount,
+    // Consent, so it survives the run that recorded it. Undefined stays
+    // undefined on purpose: it means never asked, which is not the same as no.
+    localEmbeddingEnabled: parsed.localEmbeddingEnabled
   };
 }
 function guardedFields(parsed) {
@@ -63465,6 +63468,12 @@ function resolveDefaultDrawElement(args) {
   if (!isDrawElementPlatform(args.platform) || args.browserGpuMode === "software") return false;
   return args.workerEncode;
 }
+function explainDrawElementDisabled(args) {
+  if (!isDrawElementPlatform(args.platform)) return "unsupported_platform";
+  if (args.browserGpuMode === "software") return "software_gpu";
+  if (!args.workerEncode) return "worker_encode_off";
+  return "disabled";
+}
 function resolveConfig(overrides) {
   const env = (key2) => process.env[key2];
   const envNum = (key2, fallback) => {
@@ -74478,7 +74487,7 @@ var require_tokenize = __commonJS({
     var _b;
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.FIELDS = void 0;
-    exports.default = tokenize;
+    exports.default = tokenize2;
     var t2 = __importStar2(require_tokenTypes());
     var unescapable = (_a4 = {}, _a4[t2.tab] = true, _a4[t2.newline] = true, _a4[t2.cr] = true, _a4[t2.feed] = true, _a4);
     var wordDelimiters = (_b = {}, _b[t2.space] = true, _b[t2.tab] = true, _b[t2.newline] = true, _b[t2.cr] = true, _b[t2.feed] = true, _b[t2.ampersand] = true, _b[t2.asterisk] = true, _b[t2.bang] = true, _b[t2.comma] = true, _b[t2.colon] = true, _b[t2.semicolon] = true, _b[t2.openParenthesis] = true, _b[t2.closeParenthesis] = true, _b[t2.openSquare] = true, _b[t2.closeSquare] = true, _b[t2.singleQuote] = true, _b[t2.doubleQuote] = true, _b[t2.plus] = true, _b[t2.pipe] = true, _b[t2.tilde] = true, _b[t2.greaterThan] = true, _b[t2.equals] = true, _b[t2.dollar] = true, _b[t2.caret] = true, _b[t2.slash] = true, _b);
@@ -74531,7 +74540,7 @@ var require_tokenize = __commonJS({
       START_POS: 5,
       END_POS: 6
     };
-    function tokenize(input2) {
+    function tokenize2(input2) {
       var tokens = [];
       var css = input2.css.valueOf();
       var length = css.length;
@@ -90278,6 +90287,7 @@ __export(src_exports, {
   encodeFramesChunkedConcat: () => encodeFramesChunkedConcat,
   encodeFramesFromDir: () => encodeFramesFromDir,
   executeParallelCapture: () => executeParallelCapture,
+  explainDrawElementDisabled: () => explainDrawElementDisabled,
   extractAllVideoFrames: () => extractAllVideoFrames,
   extractAudioMetadata: () => extractAudioMetadata,
   extractFinalVideoFrameTimestamp: () => extractFinalVideoFrameTimestamp,
@@ -94442,49 +94452,88 @@ var init_ffmpeg = __esm({
 });
 
 // src/utils/download.ts
+import { randomUUID as randomUUID6 } from "crypto";
 import { createWriteStream as createWriteStream2, renameSync as renameSync4, unlinkSync as unlinkSync2 } from "fs";
 import { get as httpsGet } from "https";
+import { Transform as Transform2 } from "stream";
 import { pipeline as pipeline2 } from "stream/promises";
+function redirectTarget(location, from) {
+  return new URL(location, from).toString();
+}
 function removePartialFile(path2) {
   try {
     unlinkSync2(path2);
   } catch {
   }
 }
+function enforceByteLimit(maxBytes) {
+  let received = 0;
+  return new Transform2({
+    transform(chunk, _encoding, callback) {
+      received += chunk.byteLength;
+      callback(
+        received > maxBytes ? new Error(`Download exceeded ${maxBytes} bytes`) : null,
+        chunk
+      );
+    }
+  });
+}
 function downloadFile(url, dest, options = {}) {
-  const tmp = `${dest}.tmp`;
+  const tmp = `${dest}.${process.pid}.${randomUUID6()}.tmp`;
   const timeoutMs = options.timeoutMs ?? DEFAULT_DOWNLOAD_TIMEOUT_MS;
+  const maxBytes = options.maxBytes;
   return new Promise((resolve77, reject) => {
-    const follow = (u) => {
+    const follow = (u, hops = 0) => {
       let activeResponse;
       let responsePipelineStarted = false;
       let requestError;
-      const request = httpsGet(u, (res) => {
-        activeResponse = res;
-        if (res.statusCode === 301 || res.statusCode === 302) {
-          const location = res.headers.location;
-          if (location) {
+      let request;
+      try {
+        request = httpsGet(u, (res) => {
+          activeResponse = res;
+          if (res.statusCode && REDIRECT_CODES.has(res.statusCode)) {
+            const location = res.headers.location;
+            if (location) {
+              if (hops >= MAX_REDIRECTS2) {
+                res.resume();
+                removePartialFile(tmp);
+                reject(
+                  new Error(`Download failed: more than ${MAX_REDIRECTS2} redirects from ${url}`)
+                );
+                return;
+              }
+              res.resume();
+              try {
+                follow(redirectTarget(location, u), hops + 1);
+              } catch (error) {
+                removePartialFile(tmp);
+                reject(error);
+              }
+              return;
+            }
+          }
+          if (res.statusCode !== 200) {
             res.resume();
-            follow(location);
+            removePartialFile(tmp);
+            reject(new Error(`Download failed: HTTP ${res.statusCode}`));
             return;
           }
-        }
-        if (res.statusCode !== 200) {
-          res.resume();
-          removePartialFile(tmp);
-          reject(new Error(`Download failed: HTTP ${res.statusCode}`));
-          return;
-        }
-        const file = createWriteStream2(tmp);
-        responsePipelineStarted = true;
-        pipeline2(res, file).then(() => {
-          renameSync4(tmp, dest);
-          resolve77();
-        }).catch((err) => {
-          removePartialFile(tmp);
-          reject(requestError ?? err);
+          const file = createWriteStream2(tmp);
+          responsePipelineStarted = true;
+          const transfer = maxBytes === void 0 ? pipeline2(res, file) : pipeline2(res, enforceByteLimit(maxBytes), file);
+          transfer.then(() => {
+            renameSync4(tmp, dest);
+            resolve77();
+          }).catch((err) => {
+            removePartialFile(tmp);
+            reject(requestError ?? err);
+          });
         });
-      });
+      } catch (error) {
+        removePartialFile(tmp);
+        reject(error);
+        return;
+      }
       request.setTimeout(timeoutMs, () => {
         request.destroy(new Error(`Download timed out after ${timeoutMs}ms`));
       });
@@ -94501,11 +94550,13 @@ function downloadFile(url, dest, options = {}) {
     follow(url);
   });
 }
-var DEFAULT_DOWNLOAD_TIMEOUT_MS;
+var DEFAULT_DOWNLOAD_TIMEOUT_MS, REDIRECT_CODES, MAX_REDIRECTS2;
 var init_download = __esm({
   "src/utils/download.ts"() {
     "use strict";
     DEFAULT_DOWNLOAD_TIMEOUT_MS = 3e4;
+    REDIRECT_CODES = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
+    MAX_REDIRECTS2 = 10;
   }
 });
 
@@ -94714,7 +94765,7 @@ import { execFileSync as execFileSync5 } from "child_process";
 import { existsSync as existsSync25, readFileSync as readFileSync14, mkdirSync as mkdirSync12, unlinkSync as unlinkSync3 } from "fs";
 import { join as join21, extname as extname5 } from "path";
 import { tmpdir as tmpdir3 } from "os";
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID7 } from "crypto";
 function detectLanguage(whisperPath, modelPath2, wavPath) {
   try {
     const output = execFileSync5(whisperPath, ["--model", modelPath2, "--detect-language", wavPath], {
@@ -94856,7 +94907,7 @@ function isVideoFile(filePath) {
   return VIDEO_EXTENSIONS.has(extname5(filePath).toLowerCase());
 }
 function tempWavPath() {
-  return join21(tmpdir3(), `hyperframes-audio-${process.pid}-${randomUUID6()}.wav`);
+  return join21(tmpdir3(), `hyperframes-audio-${process.pid}-${randomUUID7()}.wav`);
 }
 function extractAudio(videoPath) {
   const ffmpegPath = findFFmpeg();
@@ -97313,8 +97364,8 @@ function detectHyperframesServer(port, normalizedProjectDir, expectedServerBuild
             if (json.isHyperframes !== true) {
               return resolveResult({ type: "not-hyperframes" });
             }
-            const normalize = (p2) => resolve14(p2).replace(/\\/g, "/").toLowerCase();
-            if (normalize(json.projectDir) === normalizedProjectDir) {
+            const normalize3 = (p2) => resolve14(p2).replace(/\\/g, "/").toLowerCase();
+            if (normalize3(json.projectDir) === normalizedProjectDir) {
               if (expectedServerBuildSignature !== null && json.serverBuildSignature !== expectedServerBuildSignature) {
                 return resolveResult({ type: "mismatch", projectName: json.projectName });
               }
@@ -98075,6 +98126,7 @@ function shouldWatchProjectFile(filename) {
 }
 function createProjectWatcher(projectDir) {
   const listeners = /* @__PURE__ */ new Set();
+  const pendingPaths = /* @__PURE__ */ new Set();
   let debounceTimer = null;
   let watcher = null;
   try {
@@ -98082,10 +98134,16 @@ function createProjectWatcher(projectDir) {
       if (!filename) return;
       const relativePath = filename.toString();
       if (!shouldWatchProjectFile(relativePath)) return;
+      pendingPaths.add(relativePath);
       if (debounceTimer) clearTimeout(debounceTimer);
       debounceTimer = setTimeout(() => {
-        for (const fn of listeners) {
-          fn(relativePath);
+        const changedPaths = [...pendingPaths];
+        pendingPaths.clear();
+        debounceTimer = null;
+        for (const changedPath of changedPaths) {
+          for (const fn of listeners) {
+            fn(changedPath);
+          }
         }
       }, DEBOUNCE_MS);
     });
@@ -98104,6 +98162,7 @@ function createProjectWatcher(projectDir) {
     },
     close() {
       if (debounceTimer) clearTimeout(debounceTimer);
+      pendingPaths.clear();
       watcher?.close();
       listeners.clear();
     }
@@ -99464,7 +99523,7 @@ var init_chunk_6H3V3WGJ = __esm({
 
 // ../studio-server/dist/chunk-ZPI6QXJH.js
 import { spawn as spawn8 } from "child_process";
-import { createHash as createHash7, randomUUID as randomUUID7 } from "crypto";
+import { createHash as createHash7, randomUUID as randomUUID8 } from "crypto";
 import {
   existsSync as existsSync210,
   mkdirSync as mkdirSync15,
@@ -99788,7 +99847,7 @@ async function transcodeToCache(absoluteSourcePath, cachePath2, variant) {
     if (existsSync210(cachePath2)) return cachePath2;
     const cacheDir = dirname14(cachePath2);
     mkdirSync15(cacheDir, { recursive: true });
-    const tempPath = join29(cacheDir, `.tmp-${randomUUID7()}-${basename4(cachePath2)}`);
+    const tempPath = join29(cacheDir, `.tmp-${randomUUID8()}-${basename4(cachePath2)}`);
     try {
       await runFfmpeg2(absoluteSourcePath, tempPath, variant);
       renameSync6(tempPath, cachePath2);
@@ -106705,7 +106764,7 @@ import { basename as basename5, join as join42 } from "path";
 import { mkdirSync as mkdirSync22, readdirSync as readdirSync32, readFileSync as readFileSync32, unlinkSync as unlinkSync5, writeFileSync as writeFileSync32 } from "fs";
 import { Buffer as Buffer2 } from "buffer";
 import { join as join52, relative as relative22 } from "path";
-import { createHash as createHash22, randomUUID as randomUUID8 } from "crypto";
+import { createHash as createHash22, randomUUID as randomUUID9 } from "crypto";
 import { existsSync as existsSync37, readFileSync as readFileSync42, realpathSync as realpathSync6 } from "fs";
 import { randomUUID as randomUUID22 } from "crypto";
 import { dirname as dirname15, relative as relative32, resolve as resolve24, sep as sep7 } from "path";
@@ -107168,7 +107227,7 @@ function fileContentVersion(content) {
 }
 function createWriteToken(requestToken) {
   const token = requestToken?.trim();
-  return token && token.length <= 200 ? token : randomUUID8();
+  return token && token.length <= 200 ? token : randomUUID9();
 }
 function recordFileWriteReceipt(absPath, receipt) {
   const now = Date.now();
@@ -107178,12 +107237,13 @@ function recordFileWriteReceipt(absPath, receipt) {
   current2.push({ ...receipt, recordedAt: now });
   receipts.set(absPath, current2);
 }
-function consumeFileWriteReceipt(absPath) {
+function consumeFileWriteReceipt(absPath, expectedVersion) {
   const now = Date.now();
   const current2 = (receipts.get(absPath) ?? []).filter(
     (entry) => now - entry.recordedAt < RECEIPT_TTL_MS
   );
-  const receipt = current2.shift() ?? null;
+  const receiptIndex = current2.findIndex((entry) => entry.version === expectedVersion);
+  const receipt = receiptIndex === -1 ? null : current2.splice(receiptIndex, 1)[0] ?? null;
   if (current2.length > 0) receipts.set(absPath, current2);
   else receipts.delete(absPath);
   if (!receipt) return null;
@@ -107524,19 +107584,44 @@ function commitElementPatchBatches(projectDir, batches, writeFile4 = writeFileSy
   }
   return { durable: true, files };
 }
+function commitElementPatchBatchesWithReceipts(c3, projectDir, batches) {
+  const result = commitElementPatchBatches(projectDir, batches);
+  if ("error" in result || !result.durable) return result;
+  for (const file of result.files) {
+    if (!file.changed) continue;
+    const absPath = resolveWithinProject(projectDir, file.sourceFile);
+    if (!absPath) throw new Error(`Committed element patch escaped project: ${file.sourceFile}`);
+    recordMutationReceipt(c3, file.sourceFile, absPath, file.after);
+  }
+  return result;
+}
+function recordMutationReceipt(c3, filePath, absPath, html) {
+  const version2 = fileContentVersion(html);
+  const writeToken = createWriteToken(c3.req.header("X-Hyperframes-Write-Token"));
+  recordFileWriteReceipt(absPath, { path: filePath, version: version2, writeToken });
+  return { version: version2, writeToken };
+}
+function writeFileWithReceipt(c3, filePath, absPath, html) {
+  writeFileSync42(absPath, html, "utf-8");
+  return recordMutationReceipt(c3, filePath, absPath, html);
+}
+function writeMutationResult(c3, projectDir, filePath, absPath, html) {
+  const backup = snapshotBeforeWrite(projectDir, absPath);
+  if (backup.error) console.warn(`Failed to create backup for ${filePath}: ${backup.error}`);
+  const { version: version2 } = writeFileWithReceipt(c3, filePath, absPath, html);
+  return { backupPath: backupPathForResponse(projectDir, backup.backupPath), version: version2 };
+}
 function writeIfChanged(c3, projectDir, filePath, absPath, original, next) {
   if (next === original) {
     return c3.json({ ok: true, changed: false, content: original, path: filePath });
   }
-  const backup = snapshotBeforeWrite(projectDir, absPath);
-  if (backup.error) console.warn(`Failed to create backup for ${filePath}: ${backup.error}`);
-  writeFileSync42(absPath, next, "utf-8");
+  const { backupPath } = writeMutationResult(c3, projectDir, filePath, absPath, next);
   return c3.json({
     ok: true,
     changed: true,
     content: next,
     path: filePath,
-    backupPath: backupPathForResponse(projectDir, backup.backupPath)
+    backupPath
   });
 }
 function rejectUnsafeMutationValues(c3, unsafeFields) {
@@ -107904,10 +107989,13 @@ async function applyGsapMutations(c3, res, mutations) {
     return c3.json({ error: "file changed during GSAP mutation", conflict: true }, 409);
   }
   if (changed) {
-    const backup = snapshotBeforeWrite(res.project.dir, res.absPath);
-    if (backup.error) console.warn(`Failed to create backup for ${res.filePath}: ${backup.error}`);
-    backupPath = backupPathForResponse(res.project.dir, backup.backupPath);
-    writeFileSync42(res.absPath, newHtml, "utf-8");
+    backupPath = writeMutationResult(
+      c3,
+      res.project.dir,
+      res.filePath,
+      res.absPath,
+      newHtml
+    ).backupPath;
   }
   const responsePayload = {
     ok: true,
@@ -108864,10 +108952,12 @@ function registerFileRoutes(api, adapter2) {
     }
     const backup = snapshotBeforeWrite(ctx.project.dir, ctx.absPath);
     if (backup.error) return c3.json({ error: `backup failed: ${backup.error}` }, 500);
-    writeFileSync42(ctx.absPath, insertion.html, "utf-8");
-    const version2 = fileContentVersion(insertion.html);
-    const writeToken = createWriteToken(c3.req.header("X-Hyperframes-Write-Token"));
-    recordFileWriteReceipt(ctx.absPath, { path: ctx.filePath, version: version2, writeToken });
+    const { version: version2, writeToken } = writeFileWithReceipt(
+      c3,
+      ctx.filePath,
+      ctx.absPath,
+      insertion.html
+    );
     c3.header("ETag", version2);
     return c3.json({
       ok: true,
@@ -109065,10 +109155,13 @@ function registerFileRoutes(api, adapter2) {
         version: version22
       });
     }
-    const backup = snapshotBeforeWrite(ctx.project.dir, ctx.absPath);
-    if (backup.error) console.warn(`Failed to create backup for ${ctx.filePath}: ${backup.error}`);
-    writeFileSync42(ctx.absPath, result.html, "utf-8");
-    const version2 = fileContentVersion(result.html);
+    const { version: version2, backupPath } = writeMutationResult(
+      c3,
+      ctx.project.dir,
+      ctx.filePath,
+      ctx.absPath,
+      result.html
+    );
     c3.header("ETag", version2);
     return c3.json({
       ok: true,
@@ -109077,7 +109170,7 @@ function registerFileRoutes(api, adapter2) {
       newId: result.newId,
       path: ctx.filePath,
       version: version2,
-      backupPath: backupPathForResponse(ctx.project.dir, backup.backupPath)
+      backupPath
     });
   });
   api.post("/projects/:id/file-mutations/patch-element/*", async (c3) => {
@@ -109112,16 +109205,20 @@ function registerFileRoutes(api, adapter2) {
         path: ctx.filePath
       });
     }
-    const backup = snapshotBeforeWrite(ctx.project.dir, ctx.absPath);
-    if (backup.error) console.warn(`Failed to create backup for ${ctx.filePath}: ${backup.error}`);
-    writeFileSync42(ctx.absPath, patched, "utf-8");
+    const { backupPath } = writeMutationResult(
+      c3,
+      ctx.project.dir,
+      ctx.filePath,
+      ctx.absPath,
+      patched
+    );
     return c3.json({
       ok: true,
       changed: true,
       matched,
       content: patched,
       path: ctx.filePath,
-      backupPath: backupPathForResponse(ctx.project.dir, backup.backupPath)
+      backupPath
     });
   });
   api.post("/projects/:id/file-mutations/patch-element-batches", async (c3) => {
@@ -109133,7 +109230,7 @@ function registerFileRoutes(api, adapter2) {
     }
     const unsafeFields = findUnsafeElementPatchBatchValues(body.batches);
     if (unsafeFields.length > 0) return rejectUnsafeMutationValues(c3, unsafeFields);
-    const result = commitElementPatchBatches(project.dir, body.batches);
+    const result = commitElementPatchBatchesWithReceipts(c3, project.dir, body.batches);
     if ("error" in result) {
       return elementPatchBatchCommitErrorResponse(c3, result.error, result.sourceFile);
     }
@@ -109151,7 +109248,7 @@ function registerFileRoutes(api, adapter2) {
     if (unsafeFields.length > 0) {
       return rejectUnsafeMutationValues(c3, unsafeFields);
     }
-    const result = commitElementPatchBatches(ctx.project.dir, [batch]);
+    const result = commitElementPatchBatchesWithReceipts(c3, ctx.project.dir, [batch]);
     if ("error" in result) {
       return elementPatchBatchCommitErrorResponse(c3, result.error, result.sourceFile);
     }
@@ -109207,16 +109304,20 @@ function registerFileRoutes(api, adapter2) {
         result.error === "grouped elements must share a single parent" ? 422 : 400
       );
     }
-    const backup = snapshotBeforeWrite(ctx.project.dir, ctx.absPath);
-    if (backup.error) console.warn(`Failed to create backup for ${ctx.filePath}: ${backup.error}`);
-    writeFileSync42(ctx.absPath, result.html, "utf-8");
+    const { backupPath } = writeMutationResult(
+      c3,
+      ctx.project.dir,
+      ctx.filePath,
+      ctx.absPath,
+      result.html
+    );
     return c3.json({
       ok: true,
       changed: true,
       groupId: result.groupId,
       content: result.html,
       path: ctx.filePath,
-      backupPath: backupPathForResponse(ctx.project.dir, backup.backupPath)
+      backupPath
     });
   });
   api.post("/projects/:id/file-mutations/unwrap-elements/*", async (c3) => {
@@ -125332,7 +125433,7 @@ import {
 import { tmpdir as tmpdir8 } from "os";
 import { join as join60, dirname as dirname25, resolve as resolve33 } from "path";
 import { totalmem as totalmem2 } from "os";
-import { randomUUID as randomUUID9 } from "crypto";
+import { randomUUID as randomUUID10 } from "crypto";
 import { fileURLToPath as fileURLToPath5 } from "url";
 function sampleDirectoryBytes(dir) {
   let total = 0;
@@ -125504,6 +125605,18 @@ function buildMissingFrameRetryBatches(ranges, maxWorkers, workDir, attempt, ran
   }
   return batches;
 }
+function resolveObservedCaptureMode(forceScreenshot, platform10 = process.platform) {
+  return forceScreenshot || platform10 !== "linux" ? "screenshot" : "beginframe";
+}
+function createCaptureObservabilityUpdater(observability, platform10 = process.platform) {
+  return (patch) => {
+    Object.assign(observability, patch);
+    observability.captureMode = resolveObservedCaptureMode(
+      Boolean(observability.forceScreenshot),
+      platform10
+    );
+  };
+}
 function getNextRetryWorkerCount(currentWorkers) {
   return Math.max(1, Math.floor(currentWorkers / 2));
 }
@@ -125691,7 +125804,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
 }
 function createRenderJob(config) {
   return {
-    id: randomUUID9(),
+    id: randomUUID10(),
     config: {
       ...config,
       fps: toFps(config.fps),
@@ -125975,7 +126088,7 @@ async function executeRenderPipeline(input2) {
   const chunkedEncodeSize = cfg.chunkSizeFrames;
   const captureObservability = {
     forceScreenshot: Boolean(cfg.forceScreenshot),
-    captureMode: cfg.forceScreenshot ? "screenshot" : "beginframe",
+    captureMode: resolveObservedCaptureMode(Boolean(cfg.forceScreenshot)),
     browserGpuMode: cfg.browserGpuMode,
     protocolTimeoutMs: cfg.protocolTimeout,
     pageNavigationTimeoutMs: cfg.pageNavigationTimeout,
@@ -125983,10 +126096,7 @@ async function executeRenderPipeline(input2) {
   };
   let extractionObservability;
   let compositionHash;
-  const updateCaptureObservability = (patch) => {
-    Object.assign(captureObservability, patch);
-    captureObservability.captureMode = captureObservability.forceScreenshot ? "screenshot" : "beginframe";
-  };
+  const updateCaptureObservability = createCaptureObservabilityUpdater(captureObservability);
   const captureAttempts = [];
   const dedupPerfs = [];
   const layeredCaptureWarnings = [];
@@ -126109,7 +126219,11 @@ async function executeRenderPipeline(input2) {
     perfStages.compileOnlyMs = compileResult.compileOnlyMs;
     let captureForceScreenshot = compileResult.forceScreenshot;
     const deCompileGate = compileResult.deCompileGate;
-    let deClampReason;
+    let deClampReason = cfg.useDrawElement ? void 0 : explainDrawElementDisabled({
+      platform: process.platform,
+      browserGpuMode: cfg.browserGpuMode,
+      workerEncode: cfg.enableDrawElementWorkerEncode
+    });
     let deWorkerInversion;
     let deParallelStreamForced = false;
     let captureParallelStreamForced = false;
@@ -126617,7 +126731,7 @@ async function executeRenderPipeline(input2) {
     });
     if (captureParallelStreamEligible) {
       captureParallelStreamForced = true;
-      const captureParallelStream = process.platform === "linux" && !captureForceScreenshot ? "beginframe" : "screenshot";
+      const captureParallelStream = resolveObservedCaptureMode(captureForceScreenshot);
       log2.info(
         `[Render] Parallel ${captureParallelStream} capture will stream to the encoder (interleaved, ${workerCount} workers) instead of the disk path. Set HF_CAPTURE_PARALLEL_STREAM=false to disable.`
       );
@@ -132975,7 +133089,13 @@ function createStudioServer(options) {
   app.get("/api/events", (c3) => {
     return streamSSE4(c3, async (stream) => {
       const listener = (path2) => {
-        const receipt = consumeFileWriteReceipt(resolve38(projectDir, path2));
+        const absPath = resolve38(projectDir, path2);
+        let version2 = null;
+        try {
+          version2 = fileContentVersion(readFileSync40(absPath, "utf-8"));
+        } catch {
+        }
+        const receipt = version2 ? consumeFileWriteReceipt(absPath, version2) : null;
         stream.writeSSE({ event: "file-change", data: JSON.stringify(receipt ?? { path: path2 }) }).catch(() => {
         });
       };
@@ -135260,24 +135380,583 @@ var init_add = __esm({
   }
 });
 
+// src/registry/localSearch.ts
+function tokenize(text2) {
+  const words = text2.toLowerCase().match(/[a-z]+/g) ?? [];
+  return words.filter((word) => word.length > 2 && !STOP.has(word));
+}
+function rankByWords(query2, items, textOf) {
+  const want = new Set(tokenize(query2));
+  if (want.size === 0) return items.map((item) => ({ item, score: 0 }));
+  return items.map((item) => {
+    const have = new Set(tokenize(textOf(item)));
+    let shared = 0;
+    for (const token of want) if (have.has(token)) shared += 1;
+    return { item, score: shared / (Math.sqrt(have.size) || 1) };
+  }).sort((a, b2) => b2.score - a.score || nameOf(b2.item).localeCompare(nameOf(a.item)));
+}
+function searchByWords(query2, items, textOf) {
+  return rankByWords(query2, items, textOf).filter((scored) => scored.score > 0).map((scored) => scored.item);
+}
+function nameOf(item) {
+  const named = item;
+  return typeof named?.name === "string" ? named.name : "";
+}
+var STOP;
+var init_localSearch = __esm({
+  "src/registry/localSearch.ts"() {
+    "use strict";
+    STOP = new Set(
+      "the a an and or of to in on at is are be it its for with that this as by from into one two must not no all over under across while when where which who whom whose they them their we our you your he she his her but if then than so such can may might will would should each other another same both few more most some any every".split(" ")
+    );
+  }
+});
+
+// src/registry/localModel.ts
+import { createHash as createHash18 } from "crypto";
+import { existsSync as existsSync71, mkdirSync as mkdirSync39, readFileSync as readFileSync44, unlinkSync as unlinkSync8 } from "fs";
+import { homedir as homedir15 } from "os";
+import { join as join81 } from "path";
+function localModelConsent() {
+  return readConfig().localEmbeddingEnabled;
+}
+function recordLocalModelConsent(enabled) {
+  writeConfig({ ...readConfig(), localEmbeddingEnabled: enabled });
+}
+function localModelPath() {
+  return join81(MODELS_DIR3, `${LOCAL_MODEL_ID}.onnx`);
+}
+function localTokenizerPath() {
+  return join81(MODELS_DIR3, `${LOCAL_MODEL_ID}.tokenizer.json`);
+}
+function modelFileIsValid(file) {
+  const path2 = file.dest();
+  if (!existsSync71(path2)) return false;
+  try {
+    return createHash18("sha256").update(readFileSync44(path2)).digest("hex") === file.sha256;
+  } catch {
+    return false;
+  }
+}
+function isLocalModelReady() {
+  return LOCAL_MODEL_ARTIFACTS.every(modelFileIsValid);
+}
+function localModelStatus() {
+  const consent = localModelConsent();
+  if (consent === false) return { status: "declined" };
+  if (isLocalModelReady()) return { status: "ready" };
+  if (consent === void 0) return { status: "not-asked" };
+  return { status: "unavailable", reason: "model not downloaded yet" };
+}
+async function ensureLocalModel() {
+  if (isLocalModelReady()) return true;
+  try {
+    mkdirSync39(MODELS_DIR3, { recursive: true });
+    for (const file of LOCAL_MODEL_ARTIFACTS) {
+      if (modelFileIsValid(file)) continue;
+      const dest = file.dest();
+      await downloadFile(file.url, dest, { maxBytes: file.bytes });
+      if (!modelFileIsValid(file)) {
+        unlinkSync8(dest);
+        return false;
+      }
+    }
+    return isLocalModelReady();
+  } catch {
+    return false;
+  }
+}
+function nonInteractiveConsentMessage() {
+  return `On-device search needs a one-time ${LOCAL_MODEL_SIZE_MB} MB download that stays on this machine. Nothing is sent anywhere. Ask the person you are working for, and pass --on-device --yes once they agree.`;
+}
+function downloadOfferMessage(matchCount) {
+  const found = matchCount === void 0 ? "Use on-device meaning search." : matchCount === 0 ? "No matches from word search." : `Only ${matchCount} match${matchCount === 1 ? "" : "es"} from word search.`;
+  return `${found} Download a ${LOCAL_MODEL_SIZE_MB} MB search model for better offline results? It stays on your machine and nothing is sent.`;
+}
+var LOCAL_MODEL_ID, LOCAL_MODEL_DIMENSIONS, LOCAL_MODEL_SIZE_MB, QUERY_INSTRUCTION, MODELS_DIR3, MODEL_REPO, LOCAL_MODEL_REVISION, LOCAL_MODEL_ARTIFACTS;
+var init_localModel = __esm({
+  "src/registry/localModel.ts"() {
+    "use strict";
+    init_download();
+    init_config();
+    LOCAL_MODEL_ID = "bge-small-en-v1.5";
+    LOCAL_MODEL_DIMENSIONS = 384;
+    LOCAL_MODEL_SIZE_MB = 33;
+    QUERY_INSTRUCTION = "Represent this sentence for searching relevant passages: ";
+    MODELS_DIR3 = join81(homedir15(), ".hyperframes", "models");
+    MODEL_REPO = "Xenova/bge-small-en-v1.5";
+    LOCAL_MODEL_REVISION = "ea104dacec62c0de699686887e3f920caeb4f3e3";
+    LOCAL_MODEL_ARTIFACTS = [
+      {
+        url: `https://huggingface.co/${MODEL_REPO}/resolve/${LOCAL_MODEL_REVISION}/onnx/model_quantized.onnx`,
+        dest: () => localModelPath(),
+        bytes: 34014426,
+        sha256: "6c9c6101a956d62dfb5e7190c538226c0c5bb9cb27b651234b6df063ee7dbfe4"
+      },
+      {
+        url: `https://huggingface.co/${MODEL_REPO}/resolve/${LOCAL_MODEL_REVISION}/tokenizer.json`,
+        dest: () => localTokenizerPath(),
+        bytes: 711396,
+        sha256: "d241a60d5e8f04cc1b2b3e9ef7a4921b27bf526d9f6050ab90f9267a1f9e5c66"
+      }
+    ];
+  }
+});
+
+// src/registry/wordpiece.ts
+function configFromTokenizerJson(raw) {
+  const parsed = JSON.parse(raw);
+  const model = parsed.model;
+  if (!model?.vocab) throw new Error("tokenizer.json has no WordPiece vocab");
+  return {
+    vocab: model.vocab,
+    unkToken: model.unk_token ?? "[UNK]",
+    continuingSubwordPrefix: model.continuing_subword_prefix ?? "##",
+    maxInputCharsPerWord: model.max_input_chars_per_word ?? 100,
+    clsToken: "[CLS]",
+    sepToken: "[SEP]"
+  };
+}
+function normalize(text2) {
+  let out = "";
+  for (const char of text2) {
+    const code = char.codePointAt(0);
+    if (code === 0 || code === 65533) continue;
+    if (isControl(char, code)) continue;
+    if (isWhitespace3(char, code)) {
+      out += " ";
+      continue;
+    }
+    out += isChinese(code) ? ` ${char} ` : char;
+  }
+  return out.toLowerCase().normalize("NFD").replace(new RegExp("\\p{Mn}", "gu"), "");
+}
+function preTokenize(normalized2) {
+  const words = [];
+  for (const chunk of normalized2.split(/\s+/)) {
+    if (!chunk) continue;
+    let current2 = "";
+    for (const char of chunk) {
+      if (isPunctuation(char)) {
+        if (current2) words.push(current2);
+        words.push(char);
+        current2 = "";
+      } else {
+        current2 += char;
+      }
+    }
+    if (current2) words.push(current2);
+  }
+  return words;
+}
+function wordPiece(word, config) {
+  if ([...word].length > config.maxInputCharsPerWord) return [config.unkToken];
+  const pieces = [];
+  let start = 0;
+  while (start < word.length) {
+    let end = word.length;
+    let match = null;
+    while (start < end) {
+      const candidate = start === 0 ? word.slice(start, end) : config.continuingSubwordPrefix + word.slice(start, end);
+      if (candidate in config.vocab) {
+        match = candidate;
+        break;
+      }
+      end -= 1;
+    }
+    if (match === null) return [config.unkToken];
+    pieces.push(match);
+    start = end;
+  }
+  return pieces;
+}
+function encode2(text2, config) {
+  const tokens = [config.clsToken];
+  for (const word of preTokenize(normalize(text2))) tokens.push(...wordPiece(word, config));
+  tokens.push(config.sepToken);
+  const unk = config.vocab[config.unkToken];
+  const ids = tokens.map((token) => config.vocab[token] ?? unk);
+  return {
+    ids,
+    attentionMask: ids.map(() => 1),
+    tokenTypeIds: ids.map(() => 0)
+  };
+}
+function isControl(char, code) {
+  if (char === "	" || char === "\n" || char === "\r") return false;
+  return code < 32 || code === 127 || new RegExp("\\p{Cc}|\\p{Cf}", "u").test(char);
+}
+function isWhitespace3(char, code) {
+  return char === " " || char === "	" || char === "\n" || char === "\r" || code === 11 || code === 12 || new RegExp("\\p{Zs}", "u").test(char);
+}
+function isPunctuation(char) {
+  const code = char.codePointAt(0);
+  const asciiSymbol = code >= 33 && code <= 47 || code >= 58 && code <= 64 || code >= 91 && code <= 96 || code >= 123 && code <= 126;
+  return asciiSymbol || new RegExp("\\p{P}", "u").test(char);
+}
+function isChinese(code) {
+  return code >= 19968 && code <= 40959 || code >= 13312 && code <= 19903 || code >= 131072 && code <= 173791 || code >= 173824 && code <= 177983 || code >= 177984 && code <= 178207 || code >= 178208 && code <= 183983 || code >= 63744 && code <= 64255 || code >= 194560 && code <= 195103;
+}
+var init_wordpiece = __esm({
+  "src/registry/wordpiece.ts"() {
+    "use strict";
+  }
+});
+
+// src/registry/localEmbedder.ts
+import { readFileSync as readFileSync45 } from "fs";
+async function localRuntimeAvailable() {
+  try {
+    await import("onnxruntime-node");
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function loadLocalEmbedder() {
+  const ort = await import("onnxruntime-node");
+  const config = configFromTokenizerJson(readFileSync45(localTokenizerPath(), "utf-8"));
+  const session = await ort.InferenceSession.create(localModelPath());
+  return {
+    async embed(texts, options) {
+      if (texts.length === 0) return [];
+      const prefix = options?.isQuery ? QUERY_INSTRUCTION : "";
+      const encodings = texts.map((text2) => truncate(encode2(prefix + text2, config)));
+      const width = Math.max(...encodings.map((e3) => e3.ids.length));
+      const batch = encodings.length;
+      const ids = new BigInt64Array(batch * width);
+      const mask = new BigInt64Array(batch * width);
+      const types5 = new BigInt64Array(batch * width);
+      encodings.forEach((encoding, row) => {
+        encoding.ids.forEach((id, column) => {
+          const at4 = row * width + column;
+          ids[at4] = BigInt(id);
+          mask[at4] = 1n;
+          types5[at4] = 0n;
+        });
+      });
+      const dims = [batch, width];
+      const output = await session.run({
+        input_ids: new ort.Tensor("int64", ids, dims),
+        attention_mask: new ort.Tensor("int64", mask, dims),
+        token_type_ids: new ort.Tensor("int64", types5, dims)
+      });
+      const hidden = output["last_hidden_state"];
+      if (!hidden) throw new Error("model returned no last_hidden_state");
+      const data2 = hidden.data;
+      const hiddenSize = hidden.dims[2];
+      if (hiddenSize !== LOCAL_MODEL_DIMENSIONS) {
+        throw new Error(
+          `model produced ${hiddenSize} dimensions, expected ${LOCAL_MODEL_DIMENSIONS}`
+        );
+      }
+      return encodings.map((_, row) => {
+        const start = row * width * hiddenSize;
+        return normalize2(Array.from(data2.subarray(start, start + hiddenSize)));
+      });
+    }
+  };
+}
+function truncate(encoding) {
+  if (encoding.ids.length <= MAX_TOKENS) return encoding;
+  const ids = [
+    ...encoding.ids.slice(0, MAX_TOKENS - 1),
+    encoding.ids[encoding.ids.length - 1]
+  ];
+  return { ids, attentionMask: ids.map(() => 1), tokenTypeIds: ids.map(() => 0) };
+}
+function normalize2(vector) {
+  const norm = Math.sqrt(vector.reduce((sum, value) => sum + value * value, 0));
+  return norm === 0 ? vector : vector.map((value) => value / norm);
+}
+function cosine(a, b2) {
+  let sum = 0;
+  for (let i2 = 0; i2 < a.length; i2 += 1) sum += a[i2] * b2[i2];
+  return sum;
+}
+var MAX_TOKENS;
+var init_localEmbedder = __esm({
+  "src/registry/localEmbedder.ts"() {
+    "use strict";
+    init_localModel();
+    init_wordpiece();
+    MAX_TOKENS = 512;
+  }
+});
+
+// src/registry/localSemantic.ts
+import { existsSync as existsSync73, mkdirSync as mkdirSync40, readFileSync as readFileSync46, writeFileSync as writeFileSync28 } from "fs";
+import { homedir as homedir16 } from "os";
+import { join as join83 } from "path";
+function localVectorDirectory() {
+  return process.env["HYPERFRAMES_CATALOG_ARTIFACT_DIR"] ?? join83(homedir16(), ".hyperframes", "catalog");
+}
+function vectorPairAgrees(fetched) {
+  const meta = fetched.find(([file]) => file === "local-vectors.json")?.[1];
+  const bin = fetched.find(([file]) => file === "local-vectors.bin")?.[1];
+  if (!meta || !bin) return false;
+  try {
+    const parsed = JSON.parse(meta.toString("utf-8"));
+    if (parsed.dimensions !== LOCAL_MODEL_DIMENSIONS) return false;
+    return bin.byteLength === (parsed.names?.length ?? -1) * LOCAL_MODEL_DIMENSIONS * 4;
+  } catch {
+    return false;
+  }
+}
+function vectorRevisionAgrees(fetched, expectedRevision) {
+  if (expectedRevision === void 0) return true;
+  const meta = fetched.find(([file]) => file === "local-vectors.json")?.[1];
+  if (!meta) return false;
+  try {
+    const parsed = JSON.parse(meta.toString("utf-8"));
+    return parsed.revision === expectedRevision;
+  } catch {
+    return false;
+  }
+}
+async function fetchLocalVectors(registryBaseUrl, options = {}) {
+  const directory = options.directory ?? localVectorDirectory();
+  const base2 = registryBaseUrl.replace(/\/+$/, "");
+  try {
+    mkdirSync40(directory, { recursive: true, mode: 448 });
+    const fetched = [];
+    for (const file of ["local-vectors.json", "local-vectors.bin"]) {
+      const response = await fetch(`${base2}/catalog-artifact/${file}`, {
+        signal: AbortSignal.timeout(CATALOG_ARTIFACT_TIMEOUT_MS)
+      });
+      if (!response.ok) return false;
+      fetched.push([file, Buffer.from(await response.arrayBuffer())]);
+    }
+    if (!vectorPairAgrees(fetched) || !vectorRevisionAgrees(fetched, options.expectedRevision)) {
+      return false;
+    }
+    for (const [file, bytes] of fetched) {
+      writeFileSync28(join83(directory, file), bytes, { mode: 384 });
+    }
+    return hasLocalVectors(directory);
+  } catch {
+    return false;
+  }
+}
+function hasLocalVectors(directory = localVectorDirectory()) {
+  return existsSync73(join83(directory, "local-vectors.bin")) && existsSync73(join83(directory, "local-vectors.json"));
+}
+function loadLocalVectors(directory = localVectorDirectory()) {
+  const meta = JSON.parse(
+    readFileSync46(join83(directory, "local-vectors.json"), "utf-8")
+  );
+  const buffer = readFileSync46(join83(directory, "local-vectors.bin"));
+  const vectors = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.byteLength / 4);
+  const expected = meta.names.length * meta.dimensions;
+  if (vectors.length !== expected) {
+    throw new Error(`local vectors hold ${vectors.length} floats, expected ${expected}`);
+  }
+  if (meta.dimensions !== LOCAL_MODEL_DIMENSIONS) {
+    throw new Error(
+      `local vectors are ${meta.dimensions}-dimension, model produces ${LOCAL_MODEL_DIMENSIONS}`
+    );
+  }
+  return { names: meta.names, dimensions: meta.dimensions, vectors };
+}
+function localVectorNames(directory = localVectorDirectory()) {
+  if (!hasLocalVectors(directory)) return [];
+  try {
+    const meta = JSON.parse(readFileSync46(join83(directory, "local-vectors.json"), "utf-8"));
+    return meta.names ?? [];
+  } catch {
+    return [];
+  }
+}
+function cachedLocalVectorRevision(directory = localVectorDirectory()) {
+  if (!hasLocalVectors(directory)) return void 0;
+  try {
+    const meta = JSON.parse(readFileSync46(join83(directory, "local-vectors.json"), "utf-8"));
+    return typeof meta.revision === "string" ? meta.revision : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function localSemanticRanking(query2, directory = localVectorDirectory()) {
+  if (!isLocalModelReady() || !hasLocalVectors(directory)) return null;
+  const set = loadLocalVectors(directory);
+  const embedder = await loadLocalEmbedder();
+  const [queryVector] = await embedder.embed([query2], { isQuery: true });
+  if (!queryVector) return null;
+  const scored = set.names.map((name, row) => {
+    const start = row * set.dimensions;
+    return {
+      name,
+      score: cosine(queryVector, Array.from(set.vectors.subarray(start, start + set.dimensions)))
+    };
+  });
+  scored.sort((a, b2) => b2.score - a.score || b2.name.localeCompare(a.name));
+  return scored;
+}
+var CATALOG_ARTIFACT_TIMEOUT_MS;
+var init_localSemantic = __esm({
+  "src/registry/localSemantic.ts"() {
+    "use strict";
+    init_localEmbedder();
+    init_localModel();
+    CATALOG_ARTIFACT_TIMEOUT_MS = 3e4;
+  }
+});
+
 // src/commands/catalog.ts
 var catalog_exports = {};
 __export(catalog_exports, {
+  countUnindexed: () => countUnindexed,
   default: () => catalog_default,
-  examples: () => examples5
+  examples: () => examples5,
+  pickByName: () => pickByName
 });
 import { resolve as resolve43 } from "path";
+async function prepareOnDeviceTier(opts) {
+  const warnings = [];
+  const warn = (message) => {
+    warnings.push(message);
+    console.error(message);
+  };
+  const status = opts.status;
+  if (!opts.assumedYes && status.status === "declined") {
+    warn(
+      "on-device search skipped: the model download was previously declined. Re-run with --yes to consent."
+    );
+    return warnings;
+  }
+  if (!opts.assumedYes && status.status === "not-asked" && !opts.canPrompt) {
+    warn(nonInteractiveConsentMessage());
+    return warnings;
+  }
+  if (!opts.assumedYes && status.status === "not-asked") {
+    const answer = await ue({
+      message: downloadOfferMessage(),
+      initialValue: true
+    });
+    if (q(answer) || answer !== true) {
+      recordLocalModelConsent(false);
+      warn("on-device search skipped: the download was declined.");
+      return warnings;
+    }
+  }
+  if (!await localRuntimeAvailable()) {
+    warn(
+      "on-device search needs the native ONNX runtime, which a single-file build cannot load. Install the CLI normally (npm i -g hyperframes) to use this tier."
+    );
+    return warnings;
+  }
+  if (status.status === "declined" || status.status === "not-asked") {
+    recordLocalModelConsent(true);
+  }
+  const model = await ensureLocalModel();
+  const revisionStale = opts.artifactRevision !== void 0 && cachedLocalVectorRevision() !== opts.artifactRevision;
+  if (!hasLocalVectors() || revisionStale || countUnindexed(opts.registryNames, localVectorNames()) > 0) {
+    await fetchLocalVectors(opts.registry, { expectedRevision: opts.artifactRevision });
+  }
+  const vectors = hasLocalVectors();
+  if (!model || !vectors) {
+    warn(
+      `on-device search unavailable: ${!model ? "model" : "catalog vectors"} could not be fetched`
+    );
+  } else if (opts.artifactRevision !== void 0 && cachedLocalVectorRevision() !== opts.artifactRevision) {
+    warn("on-device search is using the previous catalog vectors because the update failed");
+  }
+  return warnings;
+}
+function pickByName(items, names, registryNames) {
+  const byName = new Map(items.map((item) => [item.name, item]));
+  const ranked = names.map((name) => byName.get(name)).filter((item) => item !== void 0);
+  return { ranked, missing: names.filter((name) => !registryNames.has(name)).length };
+}
+function countUnindexed(registryNames, indexedNames) {
+  const indexed = new Set(indexedNames);
+  let count = 0;
+  for (const name of registryNames) {
+    if (!indexed.has(name)) count += 1;
+  }
+  return count;
+}
+async function applySearch(items, query2, registryNames, status) {
+  const warnings = [];
+  if (status.status === "ready") {
+    try {
+      const ranking = await localSemanticRanking(query2);
+      if (ranking) {
+        const { ranked, missing } = pickByName(
+          items,
+          ranking.map((entry) => entry.name),
+          registryNames
+        );
+        const best = ranked[0];
+        if (best) {
+          const scoreByName = new Map(ranking.map((entry) => [entry.name, entry.score]));
+          return {
+            items: ranked.slice(0, 25),
+            localMode: "local-model",
+            warnings,
+            missing,
+            unindexed: countUnindexed(registryNames, localVectorNames()),
+            topScore: scoreByName.get(best.name) ?? null
+          };
+        }
+      }
+    } catch (error) {
+      const warning = `on-device search did not run: ${error instanceof Error ? error.message : "unknown error"}`;
+      warnings.push(warning);
+      console.error(warning);
+    }
+  }
+  const words = searchByWords(
+    query2,
+    items,
+    (item) => `${item.name} ${item.title} ${item.description} ${(item.tags ?? []).join(" ")}`
+  );
+  return { items: words, localMode: "words", warnings, missing: 0, unindexed: 0, topScore: null };
+}
+function tierToken(searched) {
+  return searched?.localMode === "local-model" ? "on-device" : "words";
+}
+function tierDetail(searched) {
+  return searched?.localMode === "local-model" ? "on-device meaning search" : "local word match";
+}
+function reportLocalModelOption(json) {
+  if (!json && process.stdout.isTTY) return;
+  if (localModelStatus().status !== "not-asked") return;
+  console.error(nonInteractiveConsentMessage());
+}
+async function offerLocalModel(matchCount, json, registryBaseUrl, artifactRevision) {
+  if (json || !process.stdout.isTTY) return;
+  if (localModelStatus().status !== "not-asked") return;
+  const answer = await ue({
+    message: downloadOfferMessage(matchCount),
+    initialValue: true
+  });
+  if (q(answer)) return;
+  recordLocalModelConsent(answer === true);
+  if (answer !== true) return;
+  const vectors = hasLocalVectors() || await fetchLocalVectors(registryBaseUrl, { expectedRevision: artifactRevision });
+  console.log(
+    c.dim(
+      vectors ? "  Run the search again to download the model and rank by meaning." : "  Could not fetch the catalog vectors; offline ranking stays off until they are available."
+    )
+  );
+}
 var examples5, catalog_default;
 var init_catalog = __esm({
   "src/commands/catalog.ts"() {
     "use strict";
-    init_commandResult();
     init_dist();
     init_dist8();
     init_colors();
     init_resolver();
+    init_remote();
     init_projectConfig();
+    init_commandResult();
     init_add();
+    init_localSearch();
+    init_localModel();
+    init_localEmbedder();
+    init_localSemantic();
     examples5 = [
       ["List all blocks and components", "hyperframes catalog"],
       ["List blocks only", "hyperframes catalog --type block"],
@@ -135306,8 +135985,26 @@ var init_catalog = __esm({
         "human-friendly": {
           type: "boolean",
           description: "Interactive picker \u2014 select an item to install"
+        },
+        query: {
+          type: "string",
+          description: "Search by meaning when the on-device model is on, otherwise by name, title, description and tags"
+        },
+        yes: {
+          type: "boolean",
+          alias: "y",
+          description: "Assume yes for prompts this run, including the on-device model download"
+        },
+        "on-device": {
+          type: "boolean",
+          // Consent for the model download is otherwise only reachable through a
+          // prompt that fires on a TTY, which leaves every agent and CI run unable
+          // to opt in at all.
+          description: "Use on-device meaning search; pass --yes to approve a first non-interactive download"
         }
       },
+      // one flag-parsing entry point feeding three output paths (json, interactive, table); splitting those is its own change
+      // fallow-ignore-next-line complexity
       async run({ args }) {
         const json = args.json === true;
         const interactive = args["human-friendly"] === true;
@@ -135318,12 +136015,14 @@ var init_catalog = __esm({
         else if (args.type === "component") typeFilter = "hyperframes:component";
         else if (args.type) {
           console.error(`Invalid --type: "${args.type}". Use "block" or "component".`);
-          failCommand();
-        }
-        const entries2 = await listRegistryItems(typeFilter ? { type: typeFilter } : void 0, {
-          baseUrl: config.registry
-        });
-        const filtered = entries2.filter((e3) => e3.type !== "hyperframes:example");
+          finishCommand(1);
+        }
+        const manifest = await fetchRegistryManifest(config.registry);
+        const entries2 = manifest?.items ?? [];
+        const artifactRevision = manifest?.catalogArtifact?.revision;
+        const catalog = entries2.filter((e3) => e3.type !== "hyperframes:example");
+        const registryNames = new Set(catalog.map((e3) => e3.name));
+        const filtered = typeFilter ? catalog.filter((e3) => e3.type === typeFilter) : catalog;
         if (filtered.length === 0) {
           if (json) console.log("[]");
           else console.log("No items found in registry.");
@@ -135331,10 +136030,56 @@ var init_catalog = __esm({
         }
         const items = await loadAllItems(filtered, { baseUrl: config.registry });
         const tagFilter = args.tag?.toLowerCase();
-        const matching = tagFilter ? items.filter((item) => item.tags?.some((t2) => t2.toLowerCase() === tagFilter)) : items;
+        const tagged = tagFilter ? items.filter((item) => item.tags?.some((t2) => t2.toLowerCase() === tagFilter)) : items;
+        const query2 = typeof args.query === "string" ? args.query.trim() : "";
+        const searchContext = query2 ? { status: localModelStatus() } : null;
+        const routineUpdate = searchContext?.status.status === "unavailable" || searchContext?.status.status === "ready" && artifactRevision !== void 0 && cachedLocalVectorRevision() !== artifactRevision;
+        const shouldPrepare = args["on-device"] === true || routineUpdate;
+        let warnings = [];
+        let effectiveStatus = searchContext?.status;
+        if (searchContext && shouldPrepare) {
+          warnings = await prepareOnDeviceTier({
+            assumedYes: args.yes === true,
+            artifactRevision,
+            canPrompt: process.stdout.isTTY === true && !json,
+            registry: config.registry,
+            registryNames,
+            status: searchContext.status
+          });
+          effectiveStatus = localModelStatus();
+        }
+        const searched = effectiveStatus ? await applySearch(tagged, query2, registryNames, effectiveStatus) : null;
+        if (searched) warnings.push(...searched.warnings);
+        const matching = searched ? searched.items : tagged;
         if (matching.length === 0) {
-          if (json) console.log("[]");
-          else console.log(`No items match tag "${args.tag}".`);
+          if (json && query2) {
+            console.log(
+              JSON.stringify(
+                {
+                  query: query2,
+                  tier: tierToken(searched),
+                  tier_detail: tierDetail(searched),
+                  dropped: searched?.missing ?? 0,
+                  unindexed: searched?.unindexed ?? 0,
+                  ...searched?.topScore != null ? { top_score: searched.topScore } : {},
+                  shown: 0,
+                  total: tagged.length,
+                  ...warnings.length ? { warnings } : {},
+                  results: []
+                },
+                null,
+                2
+              )
+            );
+          } else if (json) console.log("[]");
+          else {
+            const criteria = [
+              query2 ? `query "${query2}"` : null,
+              args.tag ? `tag "${args.tag}"` : null
+            ].filter(Boolean);
+            console.log(`No items match ${criteria.join(" and ")}.`);
+          }
+          if (query2) await offerLocalModel(0, json, config.registry, artifactRevision);
           return;
         }
         if (json) {
@@ -135347,9 +136092,49 @@ var init_catalog = __esm({
             ..."dimensions" in item && item.dimensions ? { dimensions: item.dimensions } : {},
             ..."duration" in item && item.duration ? { duration: item.duration } : {}
           }));
-          console.log(JSON.stringify(output, null, 2));
+          if (!query2) {
+            console.log(JSON.stringify(output, null, 2));
+            return;
+          }
+          console.log(
+            JSON.stringify(
+              {
+                query: query2,
+                tier: tierToken(searched),
+                tier_detail: tierDetail(searched),
+                dropped: searched?.missing ?? 0,
+                unindexed: searched?.unindexed ?? 0,
+                ...searched?.topScore != null ? { top_score: searched.topScore } : {},
+                shown: output.length,
+                total: tagged.length,
+                ...warnings.length ? { warnings } : {},
+                results: output
+              },
+              null,
+              2
+            )
+          );
           return;
         }
+        if (searched) {
+          const how = tierDetail(searched);
+          const unshowable = searched.missing > 0 ? ` \xB7 ${searched.missing} ranked ${searched.missing === 1 ? "move" : "moves"} not in this registry` : "";
+          console.log(c.dim(`  ${matching.length} of ${tagged.length} moves \xB7 ${how}${unshowable}`));
+          if (searched.unindexed > 0) {
+            const remedy = args["on-device"] === true ? "The published index is behind this registry." : "Re-run with --on-device to refresh it.";
+            console.log(
+              c.warn(
+                `  ${searched.unindexed} of ${registryNames.size} moves are missing from the on-device index, so meaning search cannot return them. ${remedy}`
+              )
+            );
+          }
+          if (searched.localMode === "words") {
+            if (warnings.length === 0) {
+              reportLocalModelOption(json);
+              await offerLocalModel(matching.length, json, config.registry, artifactRevision);
+            }
+          }
+        }
         if (interactive) {
           const options = matching.map((item) => ({
             value: item.name,
@@ -135416,7 +136201,7 @@ var init_mediaProxyPreview = __esm({
 });
 
 // src/utils/compositionServer.ts
-import { createReadStream as createReadStream6, existsSync as existsSync71, statSync as statSync26 } from "fs";
+import { createReadStream as createReadStream6, existsSync as existsSync74, statSync as statSync26 } from "fs";
 import { resolve as resolve44, dirname as dirname35 } from "path";
 import { Readable as Readable3 } from "stream";
 import { fileURLToPath as fileURLToPath10 } from "url";
@@ -135431,7 +136216,7 @@ function resolveRuntimePath2() {
     // Monorepo dev: src/<dir>/ → src/ → cli/ → packages/ then into core/dist/
     resolve44(d2, "..", "..", "..", "core", "dist", "hyperframe.runtime.iife.js")
   ];
-  return candidates.find((p2) => existsSync71(p2)) ?? null;
+  return candidates.find((p2) => existsSync74(p2)) ?? null;
 }
 function resolvePlayerPath() {
   const d2 = helperDir();
@@ -135440,7 +136225,7 @@ function resolvePlayerPath() {
     resolve44(d2, "hyperframes-player.global.js"),
     resolve44(d2, "..", "hyperframes-player.global.js")
   ];
-  return candidates.find((p2) => existsSync71(p2)) ?? null;
+  return candidates.find((p2) => existsSync74(p2)) ?? null;
 }
 function resolveSlideshowPath() {
   const d2 = helperDir();
@@ -135449,7 +136234,7 @@ function resolveSlideshowPath() {
     resolve44(d2, "hyperframes-slideshow.global.js"),
     resolve44(d2, "..", "hyperframes-slideshow.global.js")
   ];
-  return candidates.find((p2) => existsSync71(p2)) ?? null;
+  return candidates.find((p2) => existsSync74(p2)) ?? null;
 }
 function injectRuntime(html) {
   return injectTagsAtHeadStart(html, `<script src="/runtime.js"></script>`);
@@ -135577,7 +136362,7 @@ __export(play_exports, {
   examples: () => examples6,
   registerCompositionRoute: () => registerCompositionRoute
 });
-import { existsSync as existsSync73, readFileSync as readFileSync44 } from "fs";
+import { existsSync as existsSync75, readFileSync as readFileSync47 } from "fs";
 import { resolve as resolve45 } from "path";
 async function registerCompositionRoute(app, project, autoProxy) {
   const { isSafePath: isSafePath2 } = await Promise.resolve().then(() => (init_studio_api(), studio_api_exports));
@@ -135585,9 +136370,9 @@ async function registerCompositionRoute(app, project, autoProxy) {
     const reqPath = ctx.req.path.replace("/composition/", "");
     const filePath = resolve45(project.dir, reqPath);
     if (!isSafePath2(project.dir, filePath)) return ctx.text("Forbidden", 403);
-    if (!existsSync73(filePath)) return ctx.text("Not found", 404);
+    if (!existsSync75(filePath)) return ctx.text("Not found", 404);
     if (filePath.endsWith(".html")) {
-      let html = injectRuntime(readFileSync44(filePath, "utf-8"));
+      let html = injectRuntime(readFileSync47(filePath, "utf-8"));
       if (autoProxy) {
         html = await injectMediaCodecMapIntoHtml(html, project.dir, [{ html, compSrcPath: reqPath }]);
       }
@@ -135768,13 +136553,13 @@ var init_play = __esm({
         const { createAdaptorServer } = await import("@hono/node-server");
         const app = new Hono6();
         app.get("/player.js", (ctx) => {
-          return ctx.body(readFileSync44(playerPath, "utf-8"), 200, {
+          return ctx.body(readFileSync47(playerPath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           });
         });
         app.get("/runtime.js", (ctx) => {
-          return ctx.body(readFileSync44(runtimePath, "utf-8"), 200, {
+          return ctx.body(readFileSync47(runtimePath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           });
@@ -135820,7 +136605,7 @@ __export(present_exports, {
   default: () => present_default,
   examples: () => examples7
 });
-import { existsSync as existsSync74, readFileSync as readFileSync45 } from "fs";
+import { existsSync as existsSync76, readFileSync as readFileSync48 } from "fs";
 import { resolve as resolve46 } from "path";
 function buildPresentPage(projectName, islandJson) {
   return `<!doctype html>
@@ -136012,7 +136797,7 @@ var init_present = __esm({
           setCommandExitCode(1);
           return;
         }
-        const indexHtml = readFileSync45(project.indexPath, "utf-8");
+        const indexHtml = readFileSync48(project.indexPath, "utf-8");
         const { slideshowIslandRegex: slideshowIslandRegex2 } = await Promise.resolve().then(() => (init_slideshow2(), slideshow_exports));
         const islandMatch = slideshowIslandRegex2("i").exec(indexHtml);
         if (!islandMatch?.[1]) {
@@ -136038,14 +136823,14 @@ var init_present = __esm({
         const app = new Hono6();
         app.get(
           "/player.js",
-          (ctx) => ctx.body(readFileSync45(playerPath, "utf-8"), 200, {
+          (ctx) => ctx.body(readFileSync48(playerPath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           })
         );
         app.get(
           "/slideshow.js",
-          (ctx) => ctx.body(readFileSync45(slideshowPath, "utf-8"), 200, {
+          (ctx) => ctx.body(readFileSync48(slideshowPath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           })
@@ -136054,9 +136839,9 @@ var init_present = __esm({
           const reqPath = ctx.req.path.replace("/composition/", "");
           const filePath = resolve46(project.dir, reqPath);
           if (!isSafePath2(project.dir, filePath)) return ctx.text("Forbidden", 403);
-          if (!existsSync74(filePath)) return ctx.text("Not found", 404);
-          if (filePath.endsWith(".html")) return ctx.html(readFileSync45(filePath, "utf-8"));
-          return ctx.body(readFileSync45(filePath), 200, { "Content-Type": assetContentType(filePath) });
+          if (!existsSync76(filePath)) return ctx.text("Not found", 404);
+          if (filePath.endsWith(".html")) return ctx.html(readFileSync48(filePath, "utf-8"));
+          return ctx.body(readFileSync48(filePath), 200, { "Content-Type": assetContentType(filePath) });
         });
         app.get("/", (ctx) => ctx.html(buildPresentPage(project.name, islandJson)));
         ge(c.bold("hyperframes present"));
@@ -136300,15 +137085,15 @@ var init_client2 = __esm({
 });
 
 // src/auth/paths.ts
-import { homedir as homedir15 } from "os";
-import { join as join81 } from "path";
+import { homedir as homedir17 } from "os";
+import { join as join84 } from "path";
 function configDir() {
   const override = process.env["HEYGEN_CONFIG_DIR"];
   if (override && override.length > 0) return override;
-  return join81(homedir15(), ".heygen");
+  return join84(homedir17(), ".heygen");
 }
 function credentialPath() {
-  return join81(configDir(), CREDENTIAL_FILENAME);
+  return join84(configDir(), CREDENTIAL_FILENAME);
 }
 var CREDENTIAL_FILENAME;
 var init_paths2 = __esm({
@@ -136672,10 +137457,10 @@ var init_resolver2 = __esm({
 });
 
 // src/auth/pkce.ts
-import { createHash as createHash18, randomBytes as randomBytes3 } from "crypto";
+import { createHash as createHash19, randomBytes as randomBytes3 } from "crypto";
 function generatePkcePair() {
   const verifier = base64UrlEncode(randomBytes3(VERIFIER_BYTES));
-  const challenge = base64UrlEncode(createHash18("sha256").update(verifier).digest());
+  const challenge = base64UrlEncode(createHash19("sha256").update(verifier).digest());
   return { verifier, challenge, method: "S256" };
 }
 function generateState() {
@@ -137393,14 +138178,14 @@ var init_auth = __esm({
 });
 
 // src/utils/projectLink.ts
-import { randomUUID as randomUUID10 } from "crypto";
-import { existsSync as existsSync75, mkdirSync as mkdirSync39, readFileSync as readFileSync46, writeFileSync as writeFileSync28 } from "fs";
-import { homedir as homedir16 } from "os";
-import { join as join83, resolve as resolve47 } from "path";
+import { randomUUID as randomUUID11 } from "crypto";
+import { existsSync as existsSync77, mkdirSync as mkdirSync41, readFileSync as readFileSync49, writeFileSync as writeFileSync29 } from "fs";
+import { homedir as homedir18 } from "os";
+import { join as join85, resolve as resolve47 } from "path";
 function readJsonRecord(path2) {
   try {
-    if (!existsSync75(path2)) return null;
-    const parsed = JSON.parse(readFileSync46(path2, "utf-8"));
+    if (!existsSync77(path2)) return null;
+    const parsed = JSON.parse(readFileSync49(path2, "utf-8"));
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
     return parsed;
   } catch {
@@ -137425,8 +138210,8 @@ function readProjectLinks() {
 }
 function writeProjectLinks(links) {
   try {
-    mkdirSync39(CONFIG_DIR2, { recursive: true, mode: 448 });
-    writeFileSync28(PROJECTS_FILE, `${JSON.stringify(links, null, 2)}
+    mkdirSync41(CONFIG_DIR2, { recursive: true, mode: 448 });
+    writeFileSync29(PROJECTS_FILE, `${JSON.stringify(links, null, 2)}
 `, { mode: 384 });
   } catch {
   }
@@ -137444,13 +138229,13 @@ function ensureProjectId(absDir) {
   const path2 = resolve47(absDir);
   const existing = links[path2];
   if (existing) return existing.projectId;
-  const projectId = randomUUID10();
+  const projectId = randomUUID11();
   links[path2] = { projectId, url: "" };
   writeProjectLinks(links);
   return projectId;
 }
 function teamProjectPath(projectDir) {
-  return join83(resolve47(projectDir), TEAM_PROJECT_DIR, TEAM_PROJECT_FILE);
+  return join85(resolve47(projectDir), TEAM_PROJECT_DIR, TEAM_PROJECT_FILE);
 }
 function readTeamProject(projectDir) {
   const record = readJsonRecord(teamProjectPath(projectDir));
@@ -137464,8 +138249,8 @@ function writeTeamProject(projectDir, team) {
     projectId: team.projectId,
     ...team.spaceId ? { spaceId: team.spaceId } : {}
   };
-  mkdirSync39(join83(resolve47(projectDir), TEAM_PROJECT_DIR), { recursive: true });
-  writeFileSync28(file, `${JSON.stringify(body, null, 2)}
+  mkdirSync41(join85(resolve47(projectDir), TEAM_PROJECT_DIR), { recursive: true });
+  writeFileSync29(file, `${JSON.stringify(body, null, 2)}
 `);
   return file;
 }
@@ -137473,16 +138258,16 @@ var CONFIG_DIR2, PROJECTS_FILE, TEAM_PROJECT_DIR, TEAM_PROJECT_FILE;
 var init_projectLink = __esm({
   "src/utils/projectLink.ts"() {
     "use strict";
-    CONFIG_DIR2 = join83(homedir16(), ".hyperframes");
-    PROJECTS_FILE = join83(CONFIG_DIR2, "projects.json");
+    CONFIG_DIR2 = join85(homedir18(), ".hyperframes");
+    PROJECTS_FILE = join85(CONFIG_DIR2, "projects.json");
     TEAM_PROJECT_DIR = ".hyperframes";
     TEAM_PROJECT_FILE = "project.json";
   }
 });
 
 // src/utils/publishProject.ts
-import { basename as basename14, dirname as dirname37, join as join84, posix as posix5, relative as relative18, resolve as resolve48 } from "path";
-import { existsSync as existsSync76, readdirSync as readdirSync27, readFileSync as readFileSync47, statSync as statSync27 } from "fs";
+import { basename as basename14, dirname as dirname37, join as join86, posix as posix5, relative as relative18, resolve as resolve48 } from "path";
+import { existsSync as existsSync78, readdirSync as readdirSync27, readFileSync as readFileSync50, statSync as statSync27 } from "fs";
 import AdmZip from "adm-zip";
 import ignore2 from "ignore";
 function isRecord8(value) {
@@ -137644,16 +138429,16 @@ function shouldIgnoreSegment(segment) {
 }
 function createProjectIgnore(rootDir) {
   const matcher = ignore2().add(DEFAULT_PROJECT_IGNORE);
-  const ignorePath = join84(rootDir, HYPERFRAMES_IGNORE_FILE);
-  if (existsSync76(ignorePath)) {
-    matcher.add(readFileSync47(ignorePath, "utf-8"));
+  const ignorePath = join86(rootDir, HYPERFRAMES_IGNORE_FILE);
+  if (existsSync78(ignorePath)) {
+    matcher.add(readFileSync50(ignorePath, "utf-8"));
   }
   return matcher;
 }
 function collectProjectFiles(rootDir, currentDir, paths, matcher) {
   for (const entry of readdirSync27(currentDir, { withFileTypes: true })) {
     if (shouldIgnoreSegment(entry.name)) continue;
-    const absolutePath = join84(currentDir, entry.name);
+    const absolutePath = join86(currentDir, entry.name);
     const relativePath = relative18(rootDir, absolutePath).replaceAll("\\", "/");
     if (!relativePath) continue;
     if (entry.isDirectory()) {
@@ -137679,7 +138464,7 @@ function addExternalAsset(ctx, absPath) {
     while (ctx.usedArchivePaths.has(`${base2}_${i2}${ext}`)) i2++;
     archivePath = `${base2}_${i2}${ext}`;
   }
-  ctx.fileContents.set(archivePath, readFileSync47(absPath));
+  ctx.fileContents.set(archivePath, readFileSync50(absPath));
   ctx.externalMap.set(absPath, archivePath);
   ctx.usedArchivePaths.add(archivePath);
   return archivePath;
@@ -137689,7 +138474,7 @@ function tryResolveExternal(ctx, rawPath, referrerAbsDir) {
   const absPath = resolve48(referrerAbsDir, rawPath);
   if (isPathInside(absPath, ctx.absProjectDir)) return null;
   try {
-    if (!existsSync76(absPath) || !statSync27(absPath).isFile()) return null;
+    if (!existsSync78(absPath) || !statSync27(absPath).isFile()) return null;
   } catch {
     return null;
   }
@@ -137794,7 +138579,7 @@ function buildPublishFileMap(projectDir) {
   }
   const fileContents = /* @__PURE__ */ new Map();
   for (const filePath of filePaths) {
-    fileContents.set(filePath, readFileSync47(join84(absProjectDir, filePath)));
+    fileContents.set(filePath, readFileSync50(join86(absProjectDir, filePath)));
   }
   localizeExternalAssets(absProjectDir, fileContents);
   return fileContents;
@@ -137980,7 +138765,7 @@ var init_publishProject = __esm({
 });
 
 // src/utils/publishProxyBake.ts
-import { existsSync as existsSync77 } from "fs";
+import { existsSync as existsSync79 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
 import { basename as basename15, dirname as dirname38, resolve as resolve49 } from "path";
 function emptyManifest() {
@@ -138038,7 +138823,7 @@ async function bakeMediaProxies(projectDir, fileContents) {
         const rootRelativeSrc = rewriteAssetPath(
           entryPath,
           cleaned,
-          (path2) => existsSync77(resolve49(absProjectDir, path2))
+          (path2) => existsSync79(resolve49(absProjectDir, path2))
         );
         for (const candidate of resolveLocalAssetCandidates(absProjectDir, rootRelativeSrc)) {
           const archivePath = proxyByAbsolutePath.get(candidate);
@@ -138082,8 +138867,8 @@ __export(publish_exports, {
   examples: () => examples8,
   parseUpdateTarget: () => parseUpdateTarget
 });
-import { join as join85, relative as relative19, resolve as resolve50 } from "path";
-import { existsSync as existsSync78 } from "fs";
+import { join as join87, relative as relative19, resolve as resolve50 } from "path";
+import { existsSync as existsSync80 } from "fs";
 function parseUpdateTarget(value) {
   const trimmed = value.trim();
   const pathMatch = trimmed.match(/\/p\/([^/?#]+)/);
@@ -138153,8 +138938,8 @@ var init_publish = __esm({
       async run({ args }) {
         const rawArg = args.dir;
         const dir = resolve50(rawArg ?? ".");
-        const indexPath2 = join85(dir, "index.html");
-        if (existsSync78(indexPath2)) {
+        const indexPath2 = join87(dir, "index.html");
+        if (existsSync80(indexPath2)) {
           const lintResult = await lintProject(dir);
           if (lintResult.totalErrors > 0 || lintResult.totalWarnings > 0) {
             console.log();
@@ -138295,7 +139080,7 @@ var init_publish = __esm({
 
 // src/commands/render/plan.ts
 import { statSync as statSync28 } from "fs";
-import { dirname as dirname39, join as join86, resolve as resolve51 } from "path";
+import { dirname as dirname39, join as join88, resolve as resolve51 } from "path";
 function formatFpsParseError(input2, reason) {
   switch (reason) {
     case "empty":
@@ -138465,8 +139250,8 @@ function createRenderPlan(args, now = /* @__PURE__ */ new Date()) {
   const rendersDir = resolve51("renders");
   const ext = FORMAT_EXT[format];
   const timestamp = formatRenderOutputTimestamp(now);
-  const batchOutputTemplate = args.output ? args.output : join86(rendersDir, `${project.name}_${timestamp}_{index}${ext}`);
-  const outputPath = args.output ? resolve51(args.output) : join86(rendersDir, `${project.name}_${timestamp}${ext}`);
+  const batchOutputTemplate = args.output ? args.output : join88(rendersDir, `${project.name}_${timestamp}_{index}${ext}`);
+  const outputPath = args.output ? resolve51(args.output) : join88(rendersDir, `${project.name}_${timestamp}${ext}`);
   const useDocker = args.docker ?? false;
   const useGpu = args.gpu ?? false;
   const browserGpuMode = resolveBrowserGpuForCli(useDocker, args["browser-gpu"]);
@@ -138597,7 +139382,7 @@ var init_plan2 = __esm({
 
 // src/commands/render/present.ts
 import { cpus as cpus4 } from "os";
-import { readFileSync as readFileSync48 } from "fs";
+import { readFileSync as readFileSync51 } from "fs";
 async function presentRenderPlan(plan2) {
   await presentRenderWarnings(plan2);
   if (plan2.effectiveQuiet || plan2.batchPath) return;
@@ -138640,7 +139425,7 @@ function presentRenderSummary(plan2) {
 async function warnForSlideshow(plan2) {
   try {
     const { slideshowIslandRegex: slideshowIslandRegex2 } = await Promise.resolve().then(() => (init_slideshow2(), slideshow_exports));
-    if (!slideshowIslandRegex2("i").test(readFileSync48(plan2.renderTarget, "utf8"))) return;
+    if (!slideshowIslandRegex2("i").test(readFileSync51(plan2.renderTarget, "utf8"))) return;
     console.log(
       c.warn("\u26A0") + "  This composition carries a slideshow island \u2014 `render` captures only the first scene, so the MP4 will be truncated to slide 1. Use " + c.accent("hyperframes present") + " for the deck; a linear main-line MP4 export is not yet available."
     );
@@ -138657,9 +139442,9 @@ var init_present2 = __esm({
 });
 
 // src/utils/variables.ts
-import { readFileSync as readFileSync49 } from "fs";
+import { readFileSync as readFileSync53 } from "fs";
 import { resolve as resolve52 } from "path";
-function parseVariablesArg(inline, filePath, readFile5 = (p2) => readFileSync49(resolve52(p2), "utf8")) {
+function parseVariablesArg(inline, filePath, readFile5 = (p2) => readFileSync53(resolve52(p2), "utf8")) {
   if (inline != null && filePath != null) {
     return { ok: false, error: { kind: "conflict" } };
   }
@@ -138742,7 +139527,7 @@ function validateVariablesAgainstProject(indexPath2, values) {
 function loadProjectVariableSchema(indexPath2) {
   let html;
   try {
-    html = readFileSync49(indexPath2, "utf8");
+    html = readFileSync53(indexPath2, "utf8");
   } catch {
     return [];
   }
@@ -138797,8 +139582,8 @@ __export(batchRender_exports, {
   resolveOutputTemplate: () => resolveOutputTemplate,
   runBatchRender: () => runBatchRender
 });
-import { mkdirSync as mkdirSync40, readFileSync as readFileSync50, writeFileSync as writeFileSync29 } from "fs";
-import { dirname as dirname40, join as join87, resolve as resolve53, sep as sep12 } from "path";
+import { mkdirSync as mkdirSync43, readFileSync as readFileSync54, writeFileSync as writeFileSync30 } from "fs";
+import { dirname as dirname40, join as join89, resolve as resolve53, sep as sep12 } from "path";
 function isRecord9(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -138923,7 +139708,7 @@ function reportBatchVariableIssues(row, index, schema, quiet, json) {
 }
 function prepareBatchRender(options) {
   const batchPath = resolve53(options.batchPath);
-  const read = options.readFile ?? ((path2) => readFileSync50(path2, "utf8"));
+  const read = options.readFile ?? ((path2) => readFileSync54(path2, "utf8"));
   let raw;
   try {
     raw = read(batchPath);
@@ -138939,7 +139724,7 @@ function prepareBatchRender(options) {
     variables,
     outputPath: resolve53(resolveOutputTemplate(options.outputTemplate, variables, index))
   }));
-  const manifestPath2 = join87(
+  const manifestPath2 = join89(
     commonOutputDirectory(rows.map((row) => row.outputPath)),
     "manifest.json"
   );
@@ -138987,8 +139772,8 @@ function summarizeManifest(manifest) {
 }
 function writeManifest(manifest) {
   summarizeManifest(manifest);
-  mkdirSync40(dirname40(manifest.manifestPath), { recursive: true });
-  writeFileSync29(manifest.manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf8");
+  mkdirSync43(dirname40(manifest.manifestPath), { recursive: true });
+  writeFileSync30(manifest.manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf8");
 }
 async function renderBatchRow(row, manifest, options) {
   const manifestRow = manifest.rows[row.index];
@@ -139002,7 +139787,7 @@ async function renderBatchRow(row, manifest, options) {
     console.log(c.dim(`Batch row ${row.index}: ${row.outputPath}`));
   }
   try {
-    mkdirSync40(dirname40(row.outputPath), { recursive: true });
+    mkdirSync43(dirname40(row.outputPath), { recursive: true });
     const result = await options.renderOne(row);
     manifestRow.status = "completed";
     manifestRow.durationMs = result.durationMs ?? null;
@@ -139119,13 +139904,13 @@ var init_batchRender = __esm({
 });
 
 // src/commands/render/execute.ts
-import { mkdirSync as mkdirSync41, readFileSync as readFileSync51 } from "fs";
+import { mkdirSync as mkdirSync44, readFileSync as readFileSync55 } from "fs";
 function renderLintContinuationHint(strictErrors) {
   return strictErrors ? "  Continuing render despite lint warnings. Use --strict-all to block warnings." : "  Continuing render despite lint issues. Use --strict to block errors.";
 }
 async function executeRenderPlan(plan2, dependencies) {
   applyRenderEnvironment(plan2);
-  if (!plan2.batchPath) mkdirSync41(renderOutputDirectory(plan2), { recursive: true });
+  if (!plan2.batchPath) mkdirSync44(renderOutputDirectory(plan2), { recursive: true });
   let batchModule;
   let preparedBatch;
   if (plan2.batchPath) {
@@ -139260,7 +140045,7 @@ async function runResolutionPreflight(plan2, checkResolution) {
   if (!plan2.outputResolution) return;
   let issue;
   try {
-    issue = await checkResolution(readFileSync51(plan2.renderTarget, "utf8"), plan2.outputResolution, {
+    issue = await checkResolution(readFileSync55(plan2.renderTarget, "utf8"), plan2.outputResolution, {
       alphaRequested: plan2.format === "webm" || plan2.format === "mov" || plan2.format === "png-sequence",
       hdrRequested: plan2.hdrMode === "force-hdr",
       aspectAgnostic: plan2.outputResolutionAspectAgnostic
@@ -139659,7 +140444,7 @@ var init_dockerRunArgs = __esm({
 
 // src/browser/preflight.ts
 import { execFileSync as execFileSync10 } from "child_process";
-import { existsSync as existsSync79 } from "fs";
+import { existsSync as existsSync81 } from "fs";
 import { platform as platform8 } from "os";
 function parseToolVersion(raw) {
   const m2 = raw.match(/(ffmpeg|ffprobe)\s+version\s+([\d][\d.\-\w]*)/i);
@@ -139667,7 +140452,7 @@ function parseToolVersion(raw) {
 }
 function configuredMissingDetail(envName) {
   const configured = process.env[envName]?.trim();
-  if (!configured || existsSync79(configured)) return void 0;
+  if (!configured || existsSync81(configured)) return void 0;
   return `Configured path does not exist: ${envName}="${configured}"`;
 }
 function readToolVersion(binaryPath) {
@@ -139764,7 +140549,7 @@ function chromeSharedLibOutcome(executablePath, found) {
 }
 async function checkChrome(browserPath) {
   if (browserPath) {
-    if (existsSync79(browserPath)) {
+    if (existsSync81(browserPath)) {
       return chromeSharedLibOutcome(browserPath, {
         name: "Chrome",
         ok: true,
@@ -139922,9 +140707,9 @@ __export(render_exports, {
   renderLocal: () => renderLocal,
   resolveBrowserGpuForCli: () => resolveBrowserGpuForCli
 });
-import { mkdtempSync as mkdtempSync12, readdirSync as readdirSync28, readFileSync as readFileSync53, statSync as statSync29, writeFileSync as writeFileSync30, rmSync as rmSync27 } from "fs";
+import { mkdtempSync as mkdtempSync12, readdirSync as readdirSync28, readFileSync as readFileSync56, statSync as statSync29, writeFileSync as writeFileSync31, rmSync as rmSync27 } from "fs";
 import { freemem as freemem5, tmpdir as tmpdir12 } from "os";
-import { resolve as resolve54, dirname as dirname41, join as join88, basename as basename16 } from "path";
+import { resolve as resolve54, dirname as dirname41, join as join90, basename as basename16 } from "path";
 import { execFileSync as execFileSync11, spawn as spawn15 } from "child_process";
 async function readCompositionDimensions(compositionHtml) {
   try {
@@ -139990,8 +140775,8 @@ function ensureDockerImage(version2, platform10, quiet) {
   }
   if (!quiet) console.log(c.dim(`  Building Docker image: ${tag} (${platform10})...`));
   const dockerfilePath = resolveDockerfilePath();
-  const tmpDir = mkdtempSync12(join88(tmpdir12(), "hyperframes-docker-"));
-  writeFileSync30(join88(tmpDir, "Dockerfile"), readFileSync53(dockerfilePath));
+  const tmpDir = mkdtempSync12(join90(tmpdir12(), "hyperframes-docker-"));
+  writeFileSync31(join90(tmpDir, "Dockerfile"), readFileSync56(dockerfilePath));
   const targetArch = platform10 === "linux/arm64" ? "arm64" : "amd64";
   try {
     execFileSync11(
@@ -140617,7 +141402,7 @@ function printRenderComplete(outputPath, elapsedMs, quiet, outputDurationSeconds
       for (const entry of readdirSync28(outputPath, { withFileTypes: true })) {
         if (!entry.isFile()) continue;
         try {
-          total += statSync29(join88(outputPath, entry.name)).size;
+          total += statSync29(join90(outputPath, entry.name)).size;
         } catch {
         }
       }
@@ -141029,7 +141814,7 @@ __export(staticProjectServer_exports, {
   serveStaticProjectHtml: () => serveStaticProjectHtml
 });
 import { createServer as createServer2 } from "http";
-import { createReadStream as createReadStream7, existsSync as existsSync80, statSync as statSync30 } from "fs";
+import { createReadStream as createReadStream7, existsSync as existsSync83, statSync as statSync30 } from "fs";
 import { isAbsolute as isAbsolute14, relative as relative20, resolve as resolve55 } from "path";
 function serveFileWithRange(filePath, rangeHeader, res, contentType = getMimeType(filePath)) {
   const size = statSync30(filePath).size;
@@ -141133,7 +141918,7 @@ async function serveStaticProjectHtml(projectDir, html, bindErrorMessage = "Fail
       const filePath = resolve55(root, requestPath);
       const rel = relative20(root, filePath);
       if (rel.startsWith("..") || isAbsolute14(rel)) continue;
-      if (existsSync80(filePath)) {
+      if (existsSync83(filePath)) {
         if (proxyRequest) {
           void serveProxyRequest(
             projectDir,
@@ -141597,8 +142382,8 @@ var init_motionAudit = __esm({
 });
 
 // src/utils/motionSpec.ts
-import { existsSync as existsSync81, readFileSync as readFileSync54, readdirSync as readdirSync29 } from "fs";
-import { basename as basename17, join as join89 } from "path";
+import { existsSync as existsSync84, readFileSync as readFileSync57, readdirSync as readdirSync29 } from "fs";
+import { basename as basename17, join as join91 } from "path";
 function isObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -141640,11 +142425,11 @@ function parseMotionSpec(raw) {
   return { ok: true, spec };
 }
 function findMotionSpec(projectDir) {
-  if (!existsSync81(projectDir)) return null;
+  if (!existsSync84(projectDir)) return null;
   const entries2 = readdirSync29(projectDir);
   const sidecars = entries2.filter((name) => name.endsWith(".motion.json")).sort();
   if (!sidecars[0]) return null;
-  if (sidecars.length === 1) return join89(projectDir, sidecars[0]);
+  if (sidecars.length === 1) return join91(projectDir, sidecars[0]);
   const htmlBases = new Set(
     entries2.filter((name) => name.endsWith(".html")).map((name) => basename17(name, ".html"))
   );
@@ -141654,12 +142439,12 @@ function findMotionSpec(projectDir) {
       `ambiguous motion sidecars in ${projectDir}: ${matched.join(", ")} each match a composition \u2014 remove the sidecars you do not need, or use one composition per project`
     );
   }
-  return join89(projectDir, matched[0] ?? sidecars[0]);
+  return join91(projectDir, matched[0] ?? sidecars[0]);
 }
 function readMotionSpec(path2) {
   let raw;
   try {
-    raw = JSON.parse(readFileSync54(path2, "utf-8"));
+    raw = JSON.parse(readFileSync57(path2, "utf-8"));
   } catch (err) {
     return { ok: false, errors: [`could not read ${basename17(path2)}: ${err.message}`] };
   }
@@ -141712,8 +142497,8 @@ __export(layout_exports, {
   loadBrowserScript: () => loadBrowserScript,
   parseAt: () => parseAt
 });
-import { existsSync as existsSync83, readFileSync as readFileSync55 } from "fs";
-import { dirname as dirname42, join as join90 } from "path";
+import { existsSync as existsSync85, readFileSync as readFileSync58 } from "fs";
+import { dirname as dirname42, join as join93 } from "path";
 import { fileURLToPath as fileURLToPath11 } from "url";
 function buildMotionSampleTimes(duration) {
   if (!Number.isFinite(duration) || duration <= 0) return [];
@@ -141871,9 +142656,9 @@ async function runLayoutAudit(projectDir, opts) {
   }
 }
 function loadBrowserScript(name) {
-  const candidates = [join90(__dirname2, name), join90(__dirname2, "commands", name)];
+  const candidates = [join93(__dirname2, name), join93(__dirname2, "commands", name)];
   for (const candidate of candidates) {
-    if (existsSync83(candidate)) return readFileSync55(candidate, "utf-8");
+    if (existsSync85(candidate)) return readFileSync58(candidate, "utf-8");
   }
   throw new Error(`Missing browser script ${name}`);
 }
@@ -142270,9 +143055,9 @@ __export(validate_exports, {
   resolveNavigationTimeoutMs: () => resolveNavigationTimeoutMs,
   shouldIgnoreRequestFailure: () => shouldIgnoreRequestFailure
 });
-import { existsSync as existsSync84, mkdtempSync as mkdtempSync13, readFileSync as readFileSync56, rmSync as rmSync28 } from "fs";
+import { existsSync as existsSync86, mkdtempSync as mkdtempSync13, readFileSync as readFileSync59, rmSync as rmSync28 } from "fs";
 import { tmpdir as tmpdir13 } from "os";
-import { join as join91, dirname as dirname43 } from "path";
+import { join as join94, dirname as dirname43 } from "path";
 import { fileURLToPath as fileURLToPath12 } from "url";
 function resolveNavigationTimeoutMs(optTimeout) {
   return Math.max(NAV_TIMEOUT_FLOOR_MS, optTimeout ?? 0);
@@ -142421,11 +143206,11 @@ async function runContrastAudit(page) {
 }
 function loadContrastAuditScript() {
   const candidates = [
-    join91(__dirname3, "contrast-audit.browser.js"),
-    join91(__dirname3, "commands", "contrast-audit.browser.js")
+    join94(__dirname3, "contrast-audit.browser.js"),
+    join94(__dirname3, "commands", "contrast-audit.browser.js")
   ];
   for (const candidate of candidates) {
-    if (existsSync84(candidate)) return readFileSync56(candidate, "utf-8");
+    if (existsSync86(candidate)) return readFileSync59(candidate, "utf-8");
   }
   throw new Error("Missing contrast audit browser script");
 }
@@ -142437,7 +143222,7 @@ async function localizeRemoteAssets(html) {
   try {
     const { loadProducer: loadProducer2 } = await Promise.resolve().then(() => (init_producer(), producer_exports));
     const { localizeRemoteMediaSources: localizeRemoteMediaSources2, localizeRemoteImageSources: localizeRemoteImageSources2, localizeRemoteFontFaces: localizeRemoteFontFaces2 } = await loadProducer2();
-    dir = mkdtempSync13(join91(tmpdir13(), "hf-validate-assets-"));
+    dir = mkdtempSync13(join94(tmpdir13(), "hf-validate-assets-"));
     const assetDir = dir;
     const media = await localizeRemoteMediaSources2(html, assetDir);
     const images = await localizeRemoteImageSources2(media.html, assetDir);
@@ -142755,8 +143540,8 @@ __export(checkBrowser_exports, {
   preResolveHostileMediaProxies: () => preResolveHostileMediaProxies,
   runBrowserCheck: () => runBrowserCheck
 });
-import { mkdirSync as mkdirSync43, writeFileSync as writeFileSync31 } from "fs";
-import { join as join93, resolve as resolve56 } from "path";
+import { mkdirSync as mkdirSync45, writeFileSync as writeFileSync33 } from "fs";
+import { join as join95, resolve as resolve56 } from "path";
 async function preResolveHostileMediaProxies(projectDir, html, autoProxyOverride) {
   if (!resolveAutoProxy(projectDir, autoProxyOverride)) return;
   let codecMap;
@@ -142856,8 +143641,8 @@ async function captureFindingCrops(project, options, requests) {
     chromeBrowser = session.browser;
     const page = session.page;
     await waitForPreferredSeekTarget(page);
-    const snapshotDir = join93(project.dir, "snapshots");
-    mkdirSync43(snapshotDir, { recursive: true });
+    const snapshotDir = join95(project.dir, "snapshots");
+    mkdirSync45(snapshotDir, { recursive: true });
     for (const request of requests) {
       await seekCompositionTimeline(page, request.time, AUDIT_SEEK_OPTIONS);
       const canvas = await page.evaluate(() => ({
@@ -142866,8 +143651,8 @@ async function captureFindingCrops(project, options, requests) {
       }));
       const region = padCropRegion(request.bbox, canvas, DEFAULT_ZOOM_PADDING_PX);
       const buffer = await captureRegionCrop(page, region, DEFAULT_ZOOM_SCALE);
-      writeFileSync31(join93(snapshotDir, request.filename), buffer);
-      written.push(join93("snapshots", request.filename));
+      writeFileSync33(join95(snapshotDir, request.filename), buffer);
+      written.push(join95("snapshots", request.filename));
     }
     return written;
   } finally {
@@ -143673,8 +144458,8 @@ var init_checkBrowser = __esm({
 });
 
 // src/utils/checkPipeline.ts
-import { mkdirSync as mkdirSync44, writeFileSync as writeFileSync33 } from "fs";
-import { join as join94, relative as relative21 } from "path";
+import { mkdirSync as mkdirSync46, writeFileSync as writeFileSync34 } from "fs";
+import { join as join96, relative as relative21 } from "path";
 function selectContrastTimes(grid) {
   if (grid.length <= 5) return [...grid];
   return Array.from({ length: 5 }, (_, index) => {
@@ -144619,12 +145404,12 @@ async function runBrowserCheck2(project, options, motion) {
   return module.runBrowserCheck(project, options, motion, runAuditGrid);
 }
 async function writeSnapshot(projectDir, index, time, pngBase64) {
-  const snapshotDir = join94(projectDir, "snapshots");
-  mkdirSync44(snapshotDir, { recursive: true });
+  const snapshotDir = join96(projectDir, "snapshots");
+  mkdirSync46(snapshotDir, { recursive: true });
   const filename = `frame-${String(index).padStart(2, "0")}-at-${time.toFixed(1)}s.png`;
-  const path2 = join94(snapshotDir, filename);
-  writeFileSync33(path2, Buffer.from(pngBase64, "base64"));
-  return join94("snapshots", filename);
+  const path2 = join96(snapshotDir, filename);
+  writeFileSync34(path2, Buffer.from(pngBase64, "base64"));
+  return join96("snapshots", filename);
 }
 async function captureFindingCrops2(project, options, requests) {
   const module = await Promise.resolve().then(() => (init_checkBrowser(), checkBrowser_exports));
@@ -145219,28 +146004,28 @@ var init_beats = __esm({
 });
 
 // src/beats/headlessAnalyzer.ts
-import { existsSync as existsSync85, readFileSync as readFileSync57 } from "fs";
+import { existsSync as existsSync87, readFileSync as readFileSync60 } from "fs";
 import { createRequire as createRequire3 } from "module";
-import { dirname as dirname44, join as join95 } from "path";
+import { dirname as dirname44, join as join97 } from "path";
 import { fileURLToPath as fileURLToPath13 } from "url";
 function findPrebuiltBundle() {
   const here = dirname44(fileURLToPath13(import.meta.url));
   const candidates = [
-    join95(here, "beat-analyzer.global.js"),
+    join97(here, "beat-analyzer.global.js"),
     // dist root (tsup-bundled cli)
-    join95(here, "../beat-analyzer.global.js"),
+    join97(here, "../beat-analyzer.global.js"),
     // dist/beats → dist
-    join95(here, "../dist/beat-analyzer.global.js")
+    join97(here, "../dist/beat-analyzer.global.js")
   ];
   for (const p2 of candidates) {
-    if (existsSync85(p2)) return p2;
+    if (existsSync87(p2)) return p2;
   }
   return null;
 }
 async function buildFromCoreSource() {
   const esbuild = await import("esbuild");
   const coreRoot = dirname44(require2.resolve("@hyperframes/core/package.json"));
-  const entry = join95(coreRoot, "src/beats/beatDetection.ts");
+  const entry = join97(coreRoot, "src/beats/beatDetection.ts");
   const result = await esbuild.build({
     stdin: {
       contents: `import { analyzeMusicFromBuffer } from ${JSON.stringify(entry)};
@@ -145262,7 +146047,7 @@ function buildAnalyzerBundle() {
   if (bundlePromise) return bundlePromise;
   bundlePromise = (async () => {
     const prebuilt = findPrebuiltBundle();
-    if (prebuilt) return readFileSync57(prebuilt, "utf8");
+    if (prebuilt) return readFileSync60(prebuilt, "utf8");
     return buildFromCoreSource();
   })().catch((err) => {
     bundlePromise = null;
@@ -145340,14 +146125,14 @@ __export(beats_exports, {
   default: () => beats_default,
   examples: () => examples13
 });
-import { existsSync as existsSync86, readFileSync as readFileSync58, mkdirSync as mkdirSync45, writeFileSync as writeFileSync34 } from "fs";
-import { resolve as resolve57, join as join96, dirname as dirname45 } from "path";
+import { existsSync as existsSync88, readFileSync as readFileSync61, mkdirSync as mkdirSync47, writeFileSync as writeFileSync35 } from "fs";
+import { resolve as resolve57, join as join98, dirname as dirname45 } from "path";
 function fail(message) {
   console.error(c.error(message));
   failCommand();
 }
 function resolveMusicTarget(project) {
-  const src = findMusicAudioSrc(readFileSync58(project.indexPath, "utf-8"));
+  const src = findMusicAudioSrc(readFileSync61(project.indexPath, "utf-8"));
   if (!src) {
     fail(
       'No music track found. Add data-timeline-role="music" to the <audio> element (or give it an id like music/bgm/soundtrack).'
@@ -145356,12 +146141,12 @@ function resolveMusicTarget(project) {
   const rel = audioRelPathForSrc(src);
   if (!rel) fail(`Cannot derive a beat-file path for music src: ${src}`);
   const audioPath = resolve57(project.dir, rel);
-  if (!existsSync86(audioPath)) fail(`Audio file not found: ${rel}`);
+  if (!existsSync88(audioPath)) fail(`Audio file not found: ${rel}`);
   return { rel, audioPath };
 }
 async function detect(audioPath) {
   try {
-    return await analyzeBeatsHeadless(readFileSync58(audioPath));
+    return await analyzeBeatsHeadless(readFileSync61(audioPath));
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     const hint2 = /chrome|executable|browser|ENOENT/i.test(msg) ? "\nRun: npx hyperframes browser ensure" : "";
@@ -145412,9 +146197,9 @@ var init_beats2 = __esm({
         if (result.beatTimes.length === 0) {
           fail(`No beats detected in ${rel} \u2014 nothing written. (Track may be silent/ambient.)`);
         }
-        const outPath = join96(project.dir, "beats", `${rel}.json`);
-        mkdirSync45(dirname45(outPath), { recursive: true });
-        writeFileSync34(outPath, serializeBeats(result.beatTimes, result.beatStrengths, rel));
+        const outPath = join98(project.dir, "beats", `${rel}.json`);
+        mkdirSync47(dirname45(outPath), { recursive: true });
+        writeFileSync35(outPath, serializeBeats(result.beatTimes, result.beatStrengths, rel));
         report(`beats/${rel}.json`, result, Boolean(args.json));
       }
     });
@@ -147369,10 +148154,10 @@ __export(motionShot_exports, {
   ensureShotOutputDir: () => ensureShotOutputDir,
   seekAllAdaptersInBrowser: () => seekAllAdaptersInBrowser
 });
-import { mkdirSync as mkdirSync46, writeFileSync as writeFileSync35 } from "fs";
+import { mkdirSync as mkdirSync48, writeFileSync as writeFileSync36 } from "fs";
 import { dirname as dirname46 } from "path";
 function ensureShotOutputDir(outPath) {
-  mkdirSync46(dirname46(outPath), { recursive: true });
+  mkdirSync48(dirname46(outPath), { recursive: true });
 }
 function applyOrbitCamera(selectors, cam) {
   const first = document.querySelector(selectors[0] ?? "");
@@ -147693,7 +148478,7 @@ async function captureGhostOnionSkin(page, requests, times, size, camera, outPat
   );
   const b64 = String(dataUrl).replace(/^data:image\/png;base64,/, "");
   if (!b64) throw new Error("ghost composite returned no data");
-  writeFileSync35(outPath, Buffer.from(b64, "base64"));
+  writeFileSync36(outPath, Buffer.from(b64, "base64"));
   return outPath;
 }
 async function captureMarkerOnionSkin(page, requests, times, size, camera, frame, outPath) {
@@ -147763,7 +148548,7 @@ async function captureMarkerOnionSkin(page, requests, times, size, camera, frame
   await new Promise((r2) => setTimeout(r2, 60));
   const buf = await page.screenshot({ type: "png" });
   if (!buf) throw new Error("screenshot returned no data");
-  writeFileSync35(outPath, buf);
+  writeFileSync36(outPath, buf);
   return outPath;
 }
 async function captureMotionPathShot(projectDir, requestsIn, outPath, opts = {}) {
@@ -147835,8 +148620,8 @@ __export(keyframes_exports, {
   resolveScope: () => resolveScope,
   surfaceComposition: () => surfaceComposition
 });
-import { existsSync as existsSync87, readFileSync as readFileSync59, statSync as statSync31 } from "fs";
-import { resolve as resolve58, dirname as dirname47, basename as basename18, join as join97, relative as relative23, sep as sep13 } from "path";
+import { existsSync as existsSync89, readFileSync as readFileSync63, statSync as statSync31 } from "fs";
+import { resolve as resolve58, dirname as dirname47, basename as basename18, join as join99, relative as relative23, sep as sep13 } from "path";
 function queryIncludingTemplates(html, selector) {
   const doc = new DOMParser().parseFromString(html, "text/html");
   const roots = [doc];
@@ -148197,7 +148982,7 @@ function groupTraces(tweens) {
   return traces;
 }
 function collectCompositions(indexPath2) {
-  const html = readFileSync59(indexPath2, "utf-8");
+  const html = readFileSync63(indexPath2, "utf-8");
   const baseDir = dirname47(indexPath2);
   const out = [
     surfaceComposition(html, basename18(indexPath2), basename18(indexPath2))
@@ -148207,9 +148992,9 @@ function collectCompositions(indexPath2) {
     const src = div.getAttribute("data-composition-src");
     if (!src) continue;
     const subPath = resolve58(baseDir, src);
-    if (!existsSync87(subPath)) continue;
+    if (!existsSync89(subPath)) continue;
     const id = div.getAttribute("data-composition-id") ?? src;
-    out.push(surfaceComposition(readFileSync59(subPath, "utf-8"), id, src));
+    out.push(surfaceComposition(readFileSync63(subPath, "utf-8"), id, src));
   }
   return out;
 }
@@ -148326,9 +149111,9 @@ function resolveScope(args) {
   let projectName;
   let projectDir;
   let entryFile;
-  if (raw && raw.endsWith(".html") && existsSync87(raw) && statSync31(raw).isFile()) {
+  if (raw && raw.endsWith(".html") && existsSync89(raw) && statSync31(raw).isFile()) {
     const entryPath = resolve58(raw);
-    comps = [surfaceComposition(readFileSync59(entryPath, "utf-8"), basename18(entryPath), entryPath)];
+    comps = [surfaceComposition(readFileSync63(entryPath, "utf-8"), basename18(entryPath), entryPath)];
     projectName = basename18(entryPath);
     projectDir = findProjectRoot(entryPath);
     entryFile = relative23(projectDir, entryPath).split(sep13).join("/");
@@ -148358,8 +149143,8 @@ function findProjectRoot(entryPath) {
   const entryDir = dirname47(entryPath);
   let candidate = entryDir;
   for (; ; ) {
-    if (existsSync87(join97(candidate, "index.html"))) return candidate;
-    if (existsSync87(join97(candidate, ".git"))) return entryDir;
+    if (existsSync89(join99(candidate, "index.html"))) return candidate;
+    if (existsSync89(join99(candidate, ".git"))) return entryDir;
     const parent = dirname47(candidate);
     if (parent === candidate) return entryDir;
     candidate = parent;
@@ -148549,8 +149334,8 @@ __export(info_exports, {
   examples: () => examples16,
   orientation: () => orientation
 });
-import { readFileSync as readFileSync60, readdirSync as readdirSync30, statSync as statSync33 } from "fs";
-import { join as join98 } from "path";
+import { readFileSync as readFileSync64, readdirSync as readdirSync30, statSync as statSync33 } from "fs";
+import { join as join100 } from "path";
 function orientation(width, height) {
   if (width > height) return "landscape";
   if (height > width) return "portrait";
@@ -148564,7 +149349,7 @@ function durationFromHtml(html, fallback) {
 function totalSize(dir) {
   let total = 0;
   for (const entry of readdirSync30(dir, { withFileTypes: true })) {
-    const path2 = join98(dir, entry.name);
+    const path2 = join100(dir, entry.name);
     if (entry.isDirectory()) {
       total += totalSize(path2);
     } else {
@@ -148596,7 +149381,7 @@ var init_info = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync60(project.indexPath, "utf-8");
+        const html = readFileSync64(project.indexPath, "utf-8");
         ensureDOMParser();
         const parsed = parseHtml(html);
         const tracks = new Set(parsed.elements.map((el) => el.zIndex));
@@ -148656,7 +149441,7 @@ __export(compositions_exports, {
   parseCompositions: () => parseCompositions,
   parseSubComposition: () => parseSubComposition
 });
-import { existsSync as existsSync88, readFileSync as readFileSync61 } from "fs";
+import { existsSync as existsSync90, readFileSync as readFileSync65 } from "fs";
 import { resolve as resolve59, dirname as dirname48 } from "path";
 function countRenderableDescendants(root) {
   return Array.from(root.querySelectorAll("*")).filter(
@@ -148736,8 +149521,8 @@ function parseCompositions(html, baseDir) {
     const compositionSrc = div.getAttribute("data-composition-src");
     if (compositionSrc) {
       const subPath = resolve59(baseDir, compositionSrc);
-      if (existsSync88(subPath)) {
-        const subHtml = readFileSync61(subPath, "utf-8");
+      if (existsSync90(subPath)) {
+        const subHtml = readFileSync65(subPath, "utf-8");
         const subInfo = parseSubComposition(subHtml, id, width, height);
         compositions.push({ ...subInfo, source: compositionSrc });
         return;
@@ -148843,7 +149628,7 @@ var init_compositions = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync61(project.indexPath, "utf-8");
+        const html = readFileSync65(project.indexPath, "utf-8");
         ensureDOMParser();
         const compositions = parseCompositions(html, dirname48(project.indexPath));
         if (args.json) {
@@ -148881,8 +149666,8 @@ __export(benchmark_exports, {
   default: () => benchmark_default,
   examples: () => examples18
 });
-import { existsSync as existsSync89, statSync as statSync34 } from "fs";
-import { resolve as resolve60, join as join99 } from "path";
+import { existsSync as existsSync91, statSync as statSync34 } from "fs";
+import { resolve as resolve60, join as join101 } from "path";
 var examples18, FPS_30, FPS_60, DEFAULT_CONFIGS, benchmark_default;
 var init_benchmark = __esm({
   "src/commands/benchmark.ts"() {
@@ -148961,7 +149746,7 @@ var init_benchmark = __esm({
           s2?.start(`Benchmarking ${config.label}...`);
           for (let i2 = 0; i2 < runsPerConfig; i2++) {
             s2?.message(`${config.label} \u2014 run ${i2 + 1}/${runsPerConfig}`);
-            const outputPath = join99(
+            const outputPath = join101(
               benchDir,
               `${config.label.replace(/[^a-zA-Z0-9]/g, "_")}_run${i2}.mp4`
             );
@@ -148975,7 +149760,7 @@ var init_benchmark = __esm({
               await producer.executeRenderJob(job, project.dir, outputPath);
               const elapsedMs = Date.now() - startTime;
               let fileSize = null;
-              if (existsSync89(outputPath)) {
+              if (existsSync91(outputPath)) {
                 const stat3 = statSync34(outputPath);
                 fileSize = stat3.size;
               }
@@ -149250,12 +150035,12 @@ __export(remove_background_exports, {
   examples: () => examples20
 });
 import { resolve as resolve61 } from "path";
-import { existsSync as existsSync90 } from "fs";
+import { existsSync as existsSync93 } from "fs";
 async function showInfo(json) {
   const { selectProviders: selectProviders2, listAvailableProviders: listAvailableProviders2, DEFAULT_MODEL: DEFAULT_MODEL5, MODEL_MEMORY_MB: MODEL_MEMORY_MB2, modelPath: modelPath2 } = await Promise.resolve().then(() => (init_manager3(), manager_exports3));
   const providers = listAvailableProviders2();
   const auto = selectProviders2("auto");
-  const cached2 = existsSync90(modelPath2());
+  const cached2 = existsSync93(modelPath2());
   if (json) {
     console.log(
       JSON.stringify({
@@ -149461,9 +150246,9 @@ var init_remove_background = __esm({
 
 // src/whisper/parakeet.ts
 import { execFileSync as execFileSync12 } from "child_process";
-import { existsSync as existsSync91, mkdtempSync as mkdtempSync14, readFileSync as readFileSync63, rmSync as rmSync29, writeFileSync as writeFileSync36 } from "fs";
-import { homedir as homedir17, tmpdir as tmpdir14 } from "os";
-import { basename as basename19, extname as extname16, join as join100 } from "path";
+import { existsSync as existsSync94, mkdtempSync as mkdtempSync14, readFileSync as readFileSync66, rmSync as rmSync29, writeFileSync as writeFileSync37 } from "fs";
+import { homedir as homedir19, tmpdir as tmpdir14 } from "os";
+import { basename as basename19, extname as extname16, join as join103 } from "path";
 function isRunnable(bin) {
   try {
     execFileSync12(bin, ["--help"], { stdio: ["ignore", "ignore", "ignore"], timeout: 1e4 });
@@ -149475,10 +150260,10 @@ function isRunnable(bin) {
 function findParakeet() {
   const candidates = [
     process.env.HYPERFRAMES_PARAKEET,
-    join100(homedir17(), ".venvs", "parakeet", "bin", "parakeet-mlx")
+    join103(homedir19(), ".venvs", "parakeet", "bin", "parakeet-mlx")
   ].filter((p2) => Boolean(p2));
   for (const path2 of candidates) {
-    if (existsSync91(path2) && isRunnable(path2)) return path2;
+    if (existsSync94(path2) && isRunnable(path2)) return path2;
   }
   try {
     const which = process.platform === "win32" ? "where" : "which";
@@ -149488,7 +150273,7 @@ function findParakeet() {
       timeout: 5e3
     });
     const first = out.split(/\r?\n/).map((s2) => s2.trim()).find(Boolean);
-    if (first && existsSync91(first)) return first;
+    if (first && existsSync94(first)) return first;
   } catch {
   }
   return void 0;
@@ -149525,22 +150310,22 @@ function transcribeWithParakeet(inputPath, dir, options) {
     );
   }
   const model = options?.model ?? DEFAULT_MODEL3;
-  const cached2 = existsSync91(
-    join100(homedir17(), ".cache", "huggingface", "hub", `models--${model.replace(/\//g, "--")}`)
+  const cached2 = existsSync94(
+    join103(homedir19(), ".cache", "huggingface", "hub", `models--${model.replace(/\//g, "--")}`)
   );
   options?.onProgress?.(
     cached2 ? "Transcribing with Parakeet..." : "Downloading Parakeet model (first run, ~600MB)..."
   );
-  const workDir = mkdtempSync14(join100(tmpdir14(), "hyperframes-parakeet-"));
+  const workDir = mkdtempSync14(join103(tmpdir14(), "hyperframes-parakeet-"));
   try {
     const argv2 = [inputPath, "--model", model, "--output-format", "json", "--output-dir", workDir];
     if (options?.language) argv2.push("--language", options.language);
     execFileSync12(runner, argv2, { stdio: ["ignore", "pipe", "pipe"], timeout: 18e5 });
-    const produced = join100(workDir, `${basename19(inputPath, extname16(inputPath))}.json`);
-    if (!existsSync91(produced)) throw new Error("Parakeet did not produce output.");
-    const words = mergeTokensToWords(JSON.parse(readFileSync63(produced, "utf-8")));
-    const transcriptPath = join100(dir, "transcript.json");
-    writeFileSync36(transcriptPath, JSON.stringify(words, null, 2));
+    const produced = join103(workDir, `${basename19(inputPath, extname16(inputPath))}.json`);
+    if (!existsSync94(produced)) throw new Error("Parakeet did not produce output.");
+    const words = mergeTokensToWords(JSON.parse(readFileSync66(produced, "utf-8")));
+    const transcriptPath = join103(dir, "transcript.json");
+    writeFileSync37(transcriptPath, JSON.stringify(words, null, 2));
     const durationSeconds = words.length > 0 ? words[words.length - 1].end : 0;
     return { transcriptPath, wordCount: words.length, durationSeconds, speechOnsetSeconds: null };
   } finally {
@@ -149562,8 +150347,8 @@ __export(transcribe_exports2, {
   default: () => transcribe_default,
   examples: () => examples21
 });
-import { existsSync as existsSync93, writeFileSync as writeFileSync37 } from "fs";
-import { resolve as resolve62, join as join101, extname as extname17, dirname as dirname49 } from "path";
+import { existsSync as existsSync95, writeFileSync as writeFileSync38 } from "fs";
+import { resolve as resolve62, join as join104, extname as extname17, dirname as dirname49 } from "path";
 function parseTimeoutMs(raw, json) {
   const source = raw ?? process.env["HYPERFRAMES_TRANSCRIBE_TIMEOUT_MS"];
   if (source == null || source === "") return void 0;
@@ -149599,8 +150384,8 @@ async function importTranscript(inputPath, dir, json) {
   const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
   const { words, format } = loadTranscript2(inputPath);
   if (words.length === 0) exitNoWords(json);
-  const outPath = join101(dir, "transcript.json");
-  writeFileSync37(outPath, JSON.stringify(words, null, 2));
+  const outPath = join104(dir, "transcript.json");
+  writeFileSync38(outPath, JSON.stringify(words, null, 2));
   patchCaptionHtml2(dir, words);
   if (json) {
     console.log(
@@ -149617,9 +150402,9 @@ async function exportTranscript(inputPath, dir, to, output, json, preserveCues)
   const { words, format } = loadTranscript2(inputPath);
   if (words.length === 0) exitNoWords(json);
   const preGrouped = preserveCues || format === "srt" || format === "vtt" || void 0;
-  const outPath = resolve62(output ?? join101(dir, `transcript.${to}`));
+  const outPath = resolve62(output ?? join104(dir, `transcript.${to}`));
   const content = to === "srt" ? formatSrt2(words, { preGrouped }) : formatVtt2(words, { preGrouped });
-  writeFileSync37(outPath, content);
+  writeFileSync38(outPath, content);
   if (json) {
     console.log(
       JSON.stringify({ ok: true, format: to, wordCount: words.length, outputPath: outPath })
@@ -149668,7 +150453,7 @@ async function transcribeAudio(inputPath, dir, opts) {
         );
       }
     }
-    writeFileSync37(result.transcriptPath, JSON.stringify(words, null, 2));
+    writeFileSync38(result.transcriptPath, JSON.stringify(words, null, 2));
     patchCaptionHtml2(dir, words);
     if (opts.json) {
       console.log(
@@ -149801,7 +150586,7 @@ var init_transcribe2 = __esm({
       },
       async run({ args }) {
         const inputPath = resolve62(args.input);
-        if (!existsSync93(inputPath)) {
+        if (!existsSync95(inputPath)) {
           const message = `File not found: ${args.input}`;
           trackCommandFailure("transcribe", message);
           console.error(c.error(message));
@@ -149838,9 +150623,9 @@ var init_transcribe2 = __esm({
 });
 
 // src/tts/manager.ts
-import { existsSync as existsSync94, mkdirSync as mkdirSync47 } from "fs";
-import { homedir as homedir18 } from "os";
-import { join as join103 } from "path";
+import { existsSync as existsSync96, mkdirSync as mkdirSync49 } from "fs";
+import { homedir as homedir20 } from "os";
+import { join as join105 } from "path";
 function inferLangFromVoiceId(voiceId) {
   const first = voiceId.charAt(0).toLowerCase();
   return VOICE_PREFIX_LANG[first] ?? "en-us";
@@ -149849,41 +150634,41 @@ function isSupportedLang(value) {
   return SUPPORTED_LANGS.includes(value);
 }
 async function ensureModel3(model = DEFAULT_MODEL4, options) {
-  const modelPath2 = join103(MODELS_DIR3, `${model}.onnx`);
-  if (existsSync94(modelPath2)) return modelPath2;
+  const modelPath2 = join105(MODELS_DIR4, `${model}.onnx`);
+  if (existsSync96(modelPath2)) return modelPath2;
   const url = MODEL_URLS2[model];
   if (!url) {
     throw new Error(
       `Unknown TTS model: ${model}. Available: ${Object.keys(MODEL_URLS2).join(", ")}`
     );
   }
-  mkdirSync47(MODELS_DIR3, { recursive: true });
+  mkdirSync49(MODELS_DIR4, { recursive: true });
   options?.onProgress?.(`Downloading TTS model ${model} (~311 MB)...`);
   await downloadFile(url, modelPath2);
-  if (!existsSync94(modelPath2)) {
+  if (!existsSync96(modelPath2)) {
     throw new Error(`Model download failed: ${model}`);
   }
   return modelPath2;
 }
 async function ensureVoices(options) {
-  const voicesPath = join103(VOICES_DIR, "voices-v1.0.bin");
-  if (existsSync94(voicesPath)) return voicesPath;
-  mkdirSync47(VOICES_DIR, { recursive: true });
+  const voicesPath = join105(VOICES_DIR, "voices-v1.0.bin");
+  if (existsSync96(voicesPath)) return voicesPath;
+  mkdirSync49(VOICES_DIR, { recursive: true });
   options?.onProgress?.("Downloading voice data (~27 MB)...");
   await downloadFile(VOICES_URL, voicesPath);
-  if (!existsSync94(voicesPath)) {
+  if (!existsSync96(voicesPath)) {
     throw new Error("Voice data download failed");
   }
   return voicesPath;
 }
-var CACHE_DIR3, MODELS_DIR3, VOICES_DIR, DEFAULT_MODEL4, MODEL_URLS2, VOICES_URL, SUPPORTED_LANGS, VOICE_PREFIX_LANG, BUNDLED_VOICES, DEFAULT_VOICE;
+var CACHE_DIR3, MODELS_DIR4, VOICES_DIR, DEFAULT_MODEL4, MODEL_URLS2, VOICES_URL, SUPPORTED_LANGS, VOICE_PREFIX_LANG, BUNDLED_VOICES, DEFAULT_VOICE;
 var init_manager4 = __esm({
   "src/tts/manager.ts"() {
     "use strict";
     init_download();
-    CACHE_DIR3 = join103(homedir18(), ".cache", "hyperframes", "tts");
-    MODELS_DIR3 = join103(CACHE_DIR3, "models");
-    VOICES_DIR = join103(CACHE_DIR3, "voices");
+    CACHE_DIR3 = join105(homedir20(), ".cache", "hyperframes", "tts");
+    MODELS_DIR4 = join105(CACHE_DIR3, "models");
+    VOICES_DIR = join105(CACHE_DIR3, "voices");
     DEFAULT_MODEL4 = "kokoro-v1.0";
     MODEL_URLS2 = {
       "kokoro-v1.0": "https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx"
@@ -150012,19 +150797,19 @@ __export(synthesize_exports, {
   synthesize: () => synthesize
 });
 import { execFileSync as execFileSync14 } from "child_process";
-import { existsSync as existsSync95, writeFileSync as writeFileSync38, mkdirSync as mkdirSync48, readdirSync as readdirSync31, unlinkSync as unlinkSync8 } from "fs";
-import { join as join104, dirname as dirname50, basename as basename20 } from "path";
-import { homedir as homedir19 } from "os";
+import { existsSync as existsSync97, writeFileSync as writeFileSync39, mkdirSync as mkdirSync50, readdirSync as readdirSync31, unlinkSync as unlinkSync9 } from "fs";
+import { join as join106, dirname as dirname50, basename as basename20 } from "path";
+import { homedir as homedir21 } from "os";
 function ensureSynthScript() {
-  if (!existsSync95(SCRIPT_PATH)) {
-    mkdirSync48(SCRIPT_DIR, { recursive: true });
-    writeFileSync38(SCRIPT_PATH, SYNTH_SCRIPT);
+  if (!existsSync97(SCRIPT_PATH)) {
+    mkdirSync50(SCRIPT_DIR, { recursive: true });
+    writeFileSync39(SCRIPT_PATH, SYNTH_SCRIPT);
     const currentName = basename20(SCRIPT_PATH);
     try {
       for (const entry of readdirSync31(SCRIPT_DIR)) {
         if (entry !== currentName && /^synth(-v\d+)?\.py$/.test(entry)) {
           try {
-            unlinkSync8(join104(SCRIPT_DIR, entry));
+            unlinkSync9(join106(SCRIPT_DIR, entry));
           } catch {
           }
         }
@@ -150058,7 +150843,7 @@ async function synthesize(text2, outputPath, options) {
     ensureVoices({ onProgress: options?.onProgress })
   ]);
   const scriptPath = ensureSynthScript();
-  mkdirSync48(dirname50(outputPath), { recursive: true });
+  mkdirSync50(dirname50(outputPath), { recursive: true });
   options?.onProgress?.(`Generating speech with voice ${voice} (${lang})...`);
   try {
     const espeakLang = ESPEAK_LANG_OVERRIDES[lang] ?? lang;
@@ -150071,7 +150856,7 @@ async function synthesize(text2, outputPath, options) {
         stdio: ["pipe", "pipe", "pipe"]
       }
     );
-    if (!existsSync95(outputPath)) {
+    if (!existsSync97(outputPath)) {
       throw new Error("Synthesis completed but no output file was created");
     }
     const lines = stdout2.trim().split("\n");
@@ -150084,7 +150869,7 @@ async function synthesize(text2, outputPath, options) {
       langApplied: result.langApplied
     };
   } catch (err) {
-    if (err instanceof SyntaxError && existsSync95(outputPath)) {
+    if (err instanceof SyntaxError && existsSync97(outputPath)) {
       throw new Error(
         "Speech was generated but metadata could not be read. Check the output file manually."
       );
@@ -150139,8 +150924,8 @@ print(json.dumps({
     ESPEAK_LANG_OVERRIDES = {
       zh: "cmn"
     };
-    SCRIPT_DIR = join104(homedir19(), ".cache", "hyperframes", "tts");
-    SCRIPT_PATH = join104(SCRIPT_DIR, "synth-v2.py");
+    SCRIPT_DIR = join106(homedir21(), ".cache", "hyperframes", "tts");
+    SCRIPT_PATH = join106(SCRIPT_DIR, "synth-v2.py");
   }
 });
 
@@ -150150,7 +150935,7 @@ __export(tts_exports, {
   default: () => tts_default,
   examples: () => examples22
 });
-import { existsSync as existsSync96, readFileSync as readFileSync64 } from "fs";
+import { existsSync as existsSync98, readFileSync as readFileSync67 } from "fs";
 import { resolve as resolve63, extname as extname18 } from "path";
 function listVoices(json) {
   const rows = BUNDLED_VOICES.map((v2) => ({ ...v2, defaultLang: inferLangFromVoiceId(v2.id) }));
@@ -150267,8 +151052,8 @@ var init_tts = __esm({
         }
         let text2;
         const maybeFile = resolve63(input2);
-        if (existsSync96(maybeFile) && extname18(maybeFile).toLowerCase() === ".txt") {
-          text2 = readFileSync64(maybeFile, "utf-8").trim();
+        if (existsSync98(maybeFile) && extname18(maybeFile).toLowerCase() === ".txt") {
+          text2 = readFileSync67(maybeFile, "utf-8").trim();
           if (!text2) {
             console.error(c.error("File is empty."));
             failCommand();
@@ -150360,15 +151145,15 @@ __export(docs_exports, {
   default: () => docs_default,
   examples: () => examples23
 });
-import { readFileSync as readFileSync65, existsSync as existsSync97 } from "fs";
-import { resolve as resolve64, dirname as dirname51, join as join105 } from "path";
+import { readFileSync as readFileSync68, existsSync as existsSync99 } from "fs";
+import { resolve as resolve64, dirname as dirname51, join as join107 } from "path";
 import { fileURLToPath as fileURLToPath14 } from "url";
 function docsDir() {
   const thisFile = fileURLToPath14(import.meta.url);
   const dir = dirname51(thisFile);
   const devPath = resolve64(dir, "..", "docs");
   const builtPath = resolve64(dir, "docs");
-  return existsSync97(devPath) ? devPath : builtPath;
+  return existsSync99(devPath) ? devPath : builtPath;
 }
 function formatInlineCode(line2) {
   return line2.replace(/`([^`]+)`/g, (_match, code) => c.accent(code));
@@ -150466,12 +151251,12 @@ var init_docs = __esm({
           }
           failCommand();
         }
-        const filePath = join105(docsDir(), entry.file);
-        if (!existsSync97(filePath)) {
+        const filePath = join107(docsDir(), entry.file);
+        if (!existsSync99(filePath)) {
           console.error(c.error(`Doc file not found: ${filePath}`));
           failCommand();
         }
-        const content = readFileSync65(filePath, "utf-8");
+        const content = readFileSync68(filePath, "utf-8");
         console.log();
         renderMarkdown(content);
       }
@@ -150545,7 +151330,7 @@ __export(doctor_exports, {
   redactHome: () => redactHome
 });
 import { execFileSync as execFileSync15, execSync as execSync5 } from "child_process";
-import { existsSync as existsSync98 } from "fs";
+import { existsSync as existsSync100 } from "fs";
 import { platform as platform9 } from "os";
 import { dirname as dirname52 } from "path";
 function checkDocker() {
@@ -150635,7 +151420,7 @@ function checkDisk2() {
   }
   return { ok: true, detail: `${freeGb} GB free` };
 }
-function checkFramesCache(env = process.env, freeDiskMb = getFreeDiskMb, fileExists = existsSync98) {
+function checkFramesCache(env = process.env, freeDiskMb = getFreeDiskMb, fileExists = existsSync100) {
   const resolution = resolveExtractCacheDir(env);
   if (resolution.disabled) {
     return {
@@ -150869,7 +151654,7 @@ __export(upgrade_exports, {
   upgradeProjectPins: () => upgradeProjectPins
 });
 import { execFileSync as execFileSync16 } from "child_process";
-import { existsSync as existsSync99, readFileSync as readFileSync66, writeFileSync as writeFileSync39, renameSync as renameSync14 } from "fs";
+import { existsSync as existsSync101, readFileSync as readFileSync69, writeFileSync as writeFileSync40, renameSync as renameSync14 } from "fs";
 import { resolve as resolve65 } from "path";
 async function confirmUpgrade() {
   const shouldUpgrade = await ue({ message: "Upgrade now?" });
@@ -150929,10 +151714,10 @@ function resolveProjectArgs(project, opts) {
 }
 async function upgradeProjectPins(dir, opts) {
   const pkgPath = resolve65(dir, "package.json");
-  if (!existsSync99(pkgPath)) {
+  if (!existsSync101(pkgPath)) {
     return { changed: false, from: [], to: "", path: pkgPath };
   }
-  const raw = JSON.parse(readFileSync66(pkgPath, "utf-8"));
+  const raw = JSON.parse(readFileSync69(pkgPath, "utf-8"));
   const scripts = raw.scripts ?? {};
   const { latest } = await checkForUpdate(true);
   if (!isSafeVersion(latest)) return { changed: false, from: [], to: latest, path: pkgPath };
@@ -150940,14 +151725,14 @@ async function upgradeProjectPins(dir, opts) {
   if (rewrite.changed && !opts.check) {
     raw.scripts = rewrite.scripts;
     const tmp = `${pkgPath}.tmp`;
-    writeFileSync39(tmp, `${JSON.stringify(raw, null, 2)}
+    writeFileSync40(tmp, `${JSON.stringify(raw, null, 2)}
 `, "utf-8");
     renameSync14(tmp, pkgPath);
   }
   return { changed: rewrite.changed, from: rewrite.fromVersions, to: latest, path: pkgPath };
 }
 function printProjectPinResult(res, checkOnly) {
-  if (!existsSync99(res.path)) {
+  if (!existsSync101(res.path)) {
     console.log(`   ${c.dim("No package.json found \u2014 nothing to upgrade.")}`);
     return;
   }
@@ -151095,13 +151880,13 @@ function normalizeRepoUrl(repoUrl) {
   const trimmed = repoUrl.trim().replace(/\/$/, "").replace(/\.git$/, "");
   return trimmed || HYPERFRAMES_REPO_URL;
 }
-function truncate(value, max) {
+function truncate2(value, max) {
   return value.length > max ? `${value.slice(0, max - 1)}\u2026` : value;
 }
 function buildIssueTitle(rating, comment) {
   const firstLine = comment?.split("\n")[0]?.trim();
   if (!firstLine) return `Render feedback (rating ${rating}/${FEEDBACK_RATING_SCALE})`;
-  return `[feedback] ${truncate(firstLine, TITLE_MAX)}`;
+  return `[feedback] ${truncate2(firstLine, TITLE_MAX)}`;
 }
 function buildIssueBody(input2) {
   const comment = input2.comment?.trim();
@@ -151110,7 +151895,7 @@ function buildIssueBody(input2) {
     `**Rating:** ${input2.rating}/${FEEDBACK_RATING_SCALE}`,
     "",
     "## Comment",
-    comment ? truncate(comment, COMMENT_MAX) : "_No comment provided._",
+    comment ? truncate2(comment, COMMENT_MAX) : "_No comment provided._",
     "",
     "## Minimal repro",
     repro,
@@ -151209,7 +151994,7 @@ __export(feedback_exports, {
   default: () => feedback_default,
   examples: () => examples26
 });
-import { randomUUID as randomUUID11 } from "crypto";
+import { randomUUID as randomUUID12 } from "crypto";
 import { resolve as resolve66 } from "path";
 import open from "open";
 function normalizeComment(raw) {
@@ -151362,7 +152147,7 @@ var init_feedback2 = __esm({
         }
         const comment = normalizeComment(args.comment);
         const doctorSummary = await getDoctorSummary();
-        const feedbackId = randomUUID11();
+        const feedbackId = randomUUID12();
         const config = readConfig();
         const joinKeys = buildTelemetryJoinKeys({
           feedbackId,
@@ -151587,8 +152372,8 @@ __export(contactSheet_exports, {
   createSvgContactSheet: () => createSvgContactSheet
 });
 import sharp from "sharp";
-import { readdirSync as readdirSync33, readFileSync as readFileSync67, writeFileSync as writeFileSync40, unlinkSync as unlinkSync9, existsSync as existsSync100 } from "fs";
-import { join as join106, extname as extname19, basename as basename21, dirname as dirname53 } from "path";
+import { readdirSync as readdirSync33, readFileSync as readFileSync70, writeFileSync as writeFileSync41, unlinkSync as unlinkSync10, existsSync as existsSync103 } from "fs";
+import { join as join108, extname as extname19, basename as basename21, dirname as dirname53 } from "path";
 async function createContactSheet(imagePaths, outputPath, opts = {}) {
   const {
     cols = 3,
@@ -151674,10 +152459,10 @@ async function createContactSheetPages(imagePaths, outputBasePath, opts = {}, la
   return results;
 }
 async function createScrollContactSheet(screenshotsDir, outputPath, budget = {}) {
-  if (!existsSync100(screenshotsDir)) return [];
+  if (!existsSync103(screenshotsDir)) return [];
   const scrollFiles = readdirSync33(screenshotsDir).filter((f3) => f3.startsWith("scroll-") && f3.endsWith(".png")).sort();
   if (scrollFiles.length === 0) return [];
-  const paths = scrollFiles.map((f3) => join106(screenshotsDir, f3));
+  const paths = scrollFiles.map((f3) => join108(screenshotsDir, f3));
   const labels = scrollFiles.map((f3) => {
     const m2 = f3.match(/scroll-(\d+)\.png/);
     return m2 ? `${m2[1]}% scroll` : f3;
@@ -151691,10 +152476,10 @@ async function createScrollContactSheet(screenshotsDir, outputPath, budget = {})
   );
 }
 async function createSnapshotContactSheet(snapshotsDir, outputPath, budget = {}) {
-  if (!existsSync100(snapshotsDir)) return [];
+  if (!existsSync103(snapshotsDir)) return [];
   const snapshotFiles = readdirSync33(snapshotsDir).filter((f3) => f3.startsWith("frame-") && f3.endsWith(".png")).sort();
   if (snapshotFiles.length === 0) return [];
-  const paths = snapshotFiles.map((f3) => join106(snapshotsDir, f3));
+  const paths = snapshotFiles.map((f3) => join108(snapshotsDir, f3));
   const labels = snapshotFiles.map((f3) => {
     const m2 = f3.match(/at-([\d.]+)s/);
     return m2 ? `${m2[1]}s` : f3;
@@ -151708,11 +152493,11 @@ async function createSnapshotContactSheet(snapshotsDir, outputPath, budget = {})
   );
 }
 async function createAssetContactSheet(assetsDir, outputPath, budget = {}) {
-  if (!existsSync100(assetsDir)) return [];
+  if (!existsSync103(assetsDir)) return [];
   const imageExts = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".webp"]);
   const assetFiles = readdirSync33(assetsDir).filter((f3) => imageExts.has(extname19(f3).toLowerCase()) && !f3.includes("contact-sheet")).sort();
   if (assetFiles.length === 0) return [];
-  const paths = assetFiles.map((f3) => join106(assetsDir, f3));
+  const paths = assetFiles.map((f3) => join108(assetsDir, f3));
   return createContactSheetPages(paths, outputPath, {
     cols: 4,
     cellWidth: 480,
@@ -151723,7 +152508,7 @@ async function createAssetContactSheet(assetsDir, outputPath, budget = {}) {
 }
 async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir, budget = {}) {
   const dirsToScan = [svgsDir, assetsRootDir].filter(
-    (d2) => d2 !== void 0 && existsSync100(d2)
+    (d2) => d2 !== void 0 && existsSync103(d2)
   );
   if (dirsToScan.length === 0) return [];
   const seen = /* @__PURE__ */ new Set();
@@ -151732,7 +152517,7 @@ async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir, budget
     for (const f3 of readdirSync33(dir).filter((f4) => f4.endsWith(".svg")).sort()) {
       if (!seen.has(f3)) {
         seen.add(f3);
-        svgPaths.push(join106(dir, f3));
+        svgPaths.push(join108(dir, f3));
       }
     }
   }
@@ -151745,14 +152530,14 @@ async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir, budget
   for (let i2 = 0; i2 < svgPaths.length; i2++) {
     if ((budget.remainingMs?.() ?? 1) <= 0) break;
     const svgPath = svgPaths[i2];
-    const tmpPath = join106(tmpDir, `.thumb-${i2}.png`);
+    const tmpPath = join108(tmpDir, `.thumb-${i2}.png`);
     try {
-      const svgBuf = readFileSync67(svgPath);
+      const svgBuf = readFileSync70(svgPath);
       const thumb = await sharp(svgBuf).resize(thumbSize, thumbSize, {
         fit: "contain",
         background: { r: 245, g: 245, b: 245, alpha: 1 }
       }).flatten({ background: { r: 245, g: 245, b: 245 } }).png().toBuffer();
-      writeFileSync40(tmpPath, thumb);
+      writeFileSync41(tmpPath, thumb);
       tmpPaths.push(tmpPath);
       labels.push(svgFileNames[i2].replace(".svg", ""));
     } catch {
@@ -151776,7 +152561,7 @@ async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir, budget
   } finally {
     for (const tmp of tmpPaths) {
       try {
-        unlinkSync9(tmp);
+        unlinkSync10(tmp);
       } catch {
       }
     }
@@ -159667,7 +160452,7 @@ var require_gaxios = __commonJS({
     var retry_js_1 = require_retry3();
     var stream_1 = __require("stream");
     var interceptor_js_1 = require_interceptor();
-    var randomUUID12 = async () => globalThis.crypto?.randomUUID() || (await import("crypto")).randomUUID();
+    var randomUUID13 = async () => globalThis.crypto?.randomUUID() || (await import("crypto")).randomUUID();
     var HTTP_STATUS_NO_CONTENT = 204;
     var Gaxios = class {
       agentCache = /* @__PURE__ */ new Map();
@@ -159940,7 +160725,7 @@ var require_gaxios = __commonJS({
          */
         ["Blob", "File", "FormData"].includes(opts.data?.constructor?.name || "");
         if (opts.multipart?.length) {
-          const boundary = await randomUUID12();
+          const boundary = await randomUUID13();
           preparedHeaders.set("content-type", `multipart/related; boundary=${boundary}`);
           opts.body = stream_1.Readable.from(this.getMultipartRequest(opts.multipart, boundary));
         } else if (shouldDirectlyPassData) {
@@ -171752,7 +172537,7 @@ var require_websocket = __commonJS({
     var http4 = __require("http");
     var net2 = __require("net");
     var tls = __require("tls");
-    var { randomBytes: randomBytes4, createHash: createHash21 } = __require("crypto");
+    var { randomBytes: randomBytes4, createHash: createHash23 } = __require("crypto");
     var { Duplex, Readable: Readable5 } = __require("stream");
     var { URL: URL2 } = __require("url");
     var PerMessageDeflate2 = require_permessage_deflate();
@@ -172412,7 +173197,7 @@ var require_websocket = __commonJS({
           abortHandshake(websocket, socket, "Invalid Upgrade header");
           return;
         }
-        const digest = createHash21("sha1").update(key2 + GUID).digest("base64");
+        const digest = createHash23("sha1").update(key2 + GUID).digest("base64");
         if (res.headers["sec-websocket-accept"] !== digest) {
           abortHandshake(websocket, socket, "Invalid Sec-WebSocket-Accept header");
           return;
@@ -172779,7 +173564,7 @@ var require_websocket_server = __commonJS({
     var EventEmitter = __require("events");
     var http4 = __require("http");
     var { Duplex } = __require("stream");
-    var { createHash: createHash21 } = __require("crypto");
+    var { createHash: createHash23 } = __require("crypto");
     var extension2 = require_extension();
     var PerMessageDeflate2 = require_permessage_deflate();
     var subprotocol2 = require_subprotocol();
@@ -173080,7 +173865,7 @@ var require_websocket_server = __commonJS({
           );
         }
         if (this._state > RUNNING) return abortHandshake(socket, 503);
-        const digest = createHash21("sha1").update(key2 + GUID).digest("base64");
+        const digest = createHash23("sha1").update(key2 + GUID).digest("base64");
         const headers = [
           "HTTP/1.1 101 Switching Protocols",
           "Upgrade: websocket",
@@ -191532,9 +192317,9 @@ __export(snapshot_exports, {
   resolveSnapshotVideoFrameTime: () => resolveSnapshotVideoFrameTime,
   tailFrameTime: () => tailFrameTime
 });
-import { existsSync as existsSync101, mkdtempSync as mkdtempSync15, readFileSync as readFileSync68, mkdirSync as mkdirSync49, rmSync as rmSync30, writeFileSync as writeFileSync41 } from "fs";
+import { existsSync as existsSync104, mkdtempSync as mkdtempSync15, readFileSync as readFileSync71, mkdirSync as mkdirSync51, rmSync as rmSync30, writeFileSync as writeFileSync43 } from "fs";
 import { tmpdir as tmpdir15 } from "os";
-import { resolve as resolve67, join as join107, relative as relative24, isAbsolute as isAbsolute15, basename as basename25 } from "path";
+import { resolve as resolve67, join as join109, relative as relative24, isAbsolute as isAbsolute15, basename as basename25 } from "path";
 function orbitStageSource() {
   return `function(cam) {
     var root = document.querySelector("[data-composition-id]")
@@ -191580,8 +192365,8 @@ function requireSnapshotFfmpeg(ffmpegPath) {
   );
 }
 async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false) {
-  const tmp = mkdtempSync15(join107(tmpdir15(), "hf-snapshot-frame-"));
-  const outPath = join107(tmp, "frame.png");
+  const tmp = mkdtempSync15(join109(tmpdir15(), "hf-snapshot-frame-"));
+  const outPath = join109(tmp, "frame.png");
   try {
     const ffmpegPath = requireSnapshotFfmpeg(findFFmpeg());
     const args = ["-hide_banner", "-loglevel", "error"];
@@ -191601,8 +192386,8 @@ async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDeco
       outPath
     );
     const result = await runFfmpegOnce(ffmpegPath, args, FFMPEG_EXTRACT_TIMEOUT_MS);
-    if (result.code !== 0 || result.timedOut || !existsSync101(outPath)) return null;
-    return readFileSync68(outPath);
+    if (result.code !== 0 || result.timedOut || !existsSync104(outPath)) return null;
+    return readFileSync71(outPath);
   } finally {
     try {
       rmSync30(tmp, { recursive: true, force: true });
@@ -191694,13 +192479,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 ?? join107(projectDir, "snapshots");
-      mkdirSync49(snapshotDir, { recursive: true });
+      const snapshotDir = opts.outputDir ?? join109(projectDir, "snapshots");
+      mkdirSync51(snapshotDir, { recursive: true });
       try {
         const { readdirSync: readdirSync39 } = await import("fs");
         for (const file of readdirSync39(snapshotDir)) {
           if (/\.(png|jpg|jpeg)$/i.test(file)) {
-            rmSync30(join107(snapshotDir, file), { force: true });
+            rmSync30(join109(snapshotDir, file), { force: true });
           }
         }
       } catch {
@@ -191786,7 +192571,7 @@ async function captureSnapshots(projectDir, opts) {
               const decodedPath = decodeURIComponent(url.pathname).replace(/^\//, "");
               const candidate = resolve67(projectDir, decodedPath);
               const rel2 = relative24(projectDir, candidate);
-              if (!rel2.startsWith("..") && !isAbsolute15(rel2) && existsSync101(candidate)) {
+              if (!rel2.startsWith("..") && !isAbsolute15(rel2) && existsSync104(candidate)) {
                 ffmpegInput = candidate;
                 inputIsLocal = true;
               } else if (url.protocol === "http:" || url.protocol === "https:") {
@@ -191829,7 +192614,7 @@ async function captureSnapshots(projectDir, opts) {
         }
         const timeLabel = formatSnapshotTimestamp(time);
         const filename = `frame-${String(i2).padStart(2, "0")}-at-${timeLabel}.png`;
-        const framePath = join107(snapshotDir, filename);
+        const framePath = join109(snapshotDir, filename);
         if (opts.zoom) {
           const canvas = await page.evaluate(() => ({
             width: window.innerWidth,
@@ -191847,7 +192632,7 @@ async function captureSnapshots(projectDir, opts) {
             region,
             opts.zoomScale ?? DEFAULT_ZOOM_SCALE
           );
-          writeFileSync41(framePath, buffer);
+          writeFileSync43(framePath, buffer);
         } else {
           await page.screenshot({ path: framePath, type: "png", omitBackground: true });
         }
@@ -191963,7 +192748,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 ? resolve67(String(args.output)) : join107(project.dir, "snapshots");
+          const snapshotDir = args.output ? resolve67(String(args.output)) : join109(project.dir, "snapshots");
           const paths = await captureSnapshots(project.dir, {
             frames,
             timeout,
@@ -191994,7 +192779,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,
-              join107(snapshotDir, "contact-sheet.jpg")
+              join109(snapshotDir, "contact-sheet.jpg")
             );
             if (sheets.length > 0) {
               const label3 = sheets.length === 1 ? "contact-sheet.jpg" : `contact-sheet-1..${sheets.length}.jpg`;
@@ -192030,9 +192815,9 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to ${args.output ? snaps
                 const results = await Promise.allSettled(
                   paths.map(async (p2) => {
                     const filename = basename25(p2);
-                    const filePath = join107(snapshotDir, filename);
-                    if (!existsSync101(filePath)) return { filename, desc: "file not found" };
-                    const raw = readFileSync68(filePath);
+                    const filePath = join109(snapshotDir, filename);
+                    if (!existsSync104(filePath)) return { filename, desc: "file not found" };
+                    const raw = readFileSync71(filePath);
                     let imageData;
                     let mimeType = "image/png";
                     if (sharpFn) {
@@ -192068,8 +192853,8 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to ${args.output ? snaps
                     descriptions.push(`## (error)`, `Gemini call failed: ${errMsg.slice(0, 120)}`, ``);
                   }
                 }
-                const descPath = join107(snapshotDir, "descriptions.md");
-                writeFileSync41(descPath, descriptions.join("\n"));
+                const descPath = join109(snapshotDir, "descriptions.md");
+                writeFileSync43(descPath, descriptions.join("\n"));
                 console.log(`   ${c.dim("descriptions.md")} (Gemini frame analysis)`);
               }
             } catch (descErr) {
@@ -192401,8 +193186,8 @@ __export(media_treatment_exports, {
   mediaTreatmentCommand: () => mediaTreatmentCommand,
   resolveMediaTreatmentSource: () => resolveMediaTreatmentSource
 });
-import { existsSync as existsSync103, readFileSync as readFileSync69, writeFileSync as writeFileSync43 } from "fs";
-import { join as join108, relative as relative26, resolve as resolve69 } from "path";
+import { existsSync as existsSync105, readFileSync as readFileSync73, writeFileSync as writeFileSync44 } from "fs";
+import { join as join110, relative as relative26, resolve as resolve69 } from "path";
 function getMediaTreatmentCapabilityOverview() {
   const capabilities = getHfColorGradingCapabilities();
   const family = (id, label2, description) => ({
@@ -192780,7 +193565,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, (path2) => existsSync103(join108(projectDir, path2)));
+  const projectRelative = cleanSource.startsWith("/") ? cleanSource : rewriteAssetPath(compositionFile, cleanSource, (path2) => existsSync105(join110(projectDir, path2)));
   const asset = resolveExistingLocalAsset(projectDir, projectRelative);
   if (!asset) throw new Error(`Media file not found: ${source}`);
   return asset.resolved;
@@ -192833,7 +193618,7 @@ function resolveMutationFile(args) {
   if (!isPathInside(filePath, project.dir) || !filePath.toLowerCase().endsWith(".html")) {
     throw new Error("--file must be an HTML file inside the project");
   }
-  if (!existsSync103(filePath)) throw new Error(`Composition file not found: ${fileArg}`);
+  if (!existsSync105(filePath)) throw new Error(`Composition file not found: ${fileArg}`);
   return { project, filePath };
 }
 function analyzeTarget(args) {
@@ -192845,7 +193630,7 @@ function analyzeTarget(args) {
   }
   const selectorIndex = parseSelectorIndex(readOptionalString(args["selector-index"]));
   const { element, tag } = selectMediaElement(
-    readFileSync69(filePath, "utf8"),
+    readFileSync73(filePath, "utf8"),
     selector,
     selectorIndex
   );
@@ -192870,14 +193655,14 @@ function prepareMutation(args) {
   const clear = args.clear === true;
   const apply = args.apply === true;
   const selectorIndex = parseSelectorIndex(readOptionalString(args["selector-index"]));
-  const result = applyMediaTreatmentToHtml(readFileSync69(filePath, "utf8"), {
+  const result = applyMediaTreatmentToHtml(readFileSync73(filePath, "utf8"), {
     selector,
     selectorIndex,
     grading: parseGrading(readOptionalString(args.grading), apply, clear),
     clear
   });
   const dryRun = args["dry-run"] === true;
-  if (result.changed && !dryRun) writeFileSync43(filePath, result.html);
+  if (result.changed && !dryRun) writeFileSync44(filePath, result.html);
   const action = result.value === null ? "clear" : "apply";
   return {
     action,
@@ -193056,15 +193841,15 @@ __export(grade_compare_exports, {
 });
 import {
   copyFileSync as copyFileSync10,
-  existsSync as existsSync104,
-  mkdirSync as mkdirSync50,
+  existsSync as existsSync106,
+  mkdirSync as mkdirSync53,
   mkdtempSync as mkdtempSync16,
-  readFileSync as readFileSync70,
+  readFileSync as readFileSync74,
   rmSync as rmSync31,
-  writeFileSync as writeFileSync44
+  writeFileSync as writeFileSync45
 } from "fs";
 import { tmpdir as tmpdir16 } from "os";
-import { basename as basename27, dirname as dirname54, extname as extname21, join as join109, resolve as resolve70 } from "path";
+import { basename as basename27, dirname as dirname54, extname as extname21, join as join111, resolve as resolve70 } from "path";
 import sharp2 from "sharp";
 function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -193150,12 +193935,12 @@ function rewriteGradingLutSrc(grading, src) {
   return next;
 }
 function parseGradesFile(filePath) {
-  if (!existsSync104(filePath)) {
+  if (!existsSync106(filePath)) {
     throw new Error(`Grades file not found: ${filePath}`);
   }
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync70(filePath, "utf-8"));
+    parsed = JSON.parse(readFileSync74(filePath, "utf-8"));
   } catch (err) {
     throw new Error(`Could not parse grades JSON: ${normalizeErrorMessage(err)}`);
   }
@@ -193320,19 +194105,19 @@ function frameFileNameForPath(framePath) {
   return "frame.png";
 }
 async function prepareGradeCompareTempProject(opts) {
-  const tempDir = mkdtempSync16(join109(tmpdir16(), "hf-grade-compare-"));
+  const tempDir = mkdtempSync16(join111(tmpdir16(), "hf-grade-compare-"));
   try {
     const frameFileName2 = opts.frameFileName ?? frameFileNameForPath(opts.framePath);
-    writeFileSync44(join109(tempDir, frameFileName2), opts.frameBuffer);
+    writeFileSync45(join111(tempDir, frameFileName2), opts.frameBuffer);
     let lutIndex = 0;
     const stagedCells = opts.cells.map((cell) => {
       const lutSrc = lutSrcFromGrading(cell.grading);
       if (!lutSrc) return cell;
       const sourcePath = resolveFromBase(opts.projectDir, lutSrc);
-      if (!existsSync104(sourcePath)) {
+      if (!existsSync106(sourcePath)) {
         throw new Error(`LUT file not found for "${cell.label}": ${sourcePath}`);
       }
-      const lutText = readFileSync70(sourcePath, "utf-8");
+      const lutText = readFileSync74(sourcePath, "utf-8");
       try {
         parseCubeLut(lutText, { maxSize: 64 });
       } catch (err) {
@@ -193343,7 +194128,7 @@ async function prepareGradeCompareTempProject(opts) {
       const lutExt = extname21(sourcePath) || ".cube";
       const stagedName = `lut-${lutIndex}${lutExt}`;
       lutIndex += 1;
-      copyFileSync10(sourcePath, join109(tempDir, stagedName));
+      copyFileSync10(sourcePath, join111(tempDir, stagedName));
       return {
         label: cell.label,
         grading: rewriteGradingLutSrc(cell.grading, stagedName)
@@ -193355,7 +194140,7 @@ async function prepareGradeCompareTempProject(opts) {
       frameWidth: opts.frameWidth,
       frameHeight: opts.frameHeight
     });
-    writeFileSync44(join109(tempDir, "index.html"), html);
+    writeFileSync45(join111(tempDir, "index.html"), html);
     return { tempDir, html, cells: stagedCells };
   } catch (err) {
     rmSync31(tempDir, { recursive: true, force: true });
@@ -193367,8 +194152,8 @@ function isVideoPath2(filePath) {
   return [".mp4", ".mov", ".m4v", ".webm", ".mkv", ".avi", ".mpeg", ".mpg", ".ogv"].includes(ext);
 }
 async function extractVideoFrameToBuffer2(videoPath) {
-  const tmp = mkdtempSync16(join109(tmpdir16(), "hf-grade-compare-frame-"));
-  const outPath = join109(tmp, "frame.png");
+  const tmp = mkdtempSync16(join111(tmpdir16(), "hf-grade-compare-frame-"));
+  const outPath = join111(tmp, "frame.png");
   try {
     const ffmpegPath = findFFmpeg();
     if (!ffmpegPath) return null;
@@ -193391,20 +194176,20 @@ async function extractVideoFrameToBuffer2(videoPath) {
     if (result.timedOut) {
       throw new Error(`ffmpeg timed out extracting first frame from ${videoPath}`);
     }
-    if (result.code !== 0 || !existsSync104(outPath)) {
+    if (result.code !== 0 || !existsSync106(outPath)) {
       const detail = result.stderr.trim() ? `: ${result.stderr.trim()}` : "";
       throw new Error(`ffmpeg could not extract first frame from ${videoPath}${detail}`);
     }
-    return readFileSync70(outPath);
+    return readFileSync74(outPath);
   } finally {
     rmSync31(tmp, { recursive: true, force: true });
   }
 }
 async function loadReferenceFrame(framePath) {
-  if (!existsSync104(framePath)) {
+  if (!existsSync106(framePath)) {
     throw new Error(`Reference frame not found: ${framePath}`);
   }
-  const buffer = isVideoPath2(framePath) ? await extractVideoFrameToBuffer2(framePath) : readFileSync70(framePath);
+  const buffer = isVideoPath2(framePath) ? await extractVideoFrameToBuffer2(framePath) : readFileSync74(framePath);
   if (!buffer) {
     throw new Error(`Could not extract a frame from video: ${framePath}`);
   }
@@ -193423,7 +194208,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 = join109(projectDir, "grade-compare.png");
+  const sheetPath = join111(projectDir, "grade-compare.png");
   try {
     const {
       browser: chromeBrowser,
@@ -193564,7 +194349,7 @@ var init_grade_compare = __esm({
             prepared.tempDir,
             parsed.timeoutMs
           );
-          mkdirSync50(dirname54(parsed.outPath), { recursive: true });
+          mkdirSync53(dirname54(parsed.outPath), { recursive: true });
           copyFileSync10(tempSheet, parsed.outPath);
           trackCompareSheet({
             command: "grade-compare",
@@ -193609,9 +194394,9 @@ __export(compare_exports, {
   parseCompareArgs: () => parseCompareArgs,
   prepareCompareVariantProjects: () => prepareCompareVariantProjects
 });
-import { cpSync as cpSync6, existsSync as existsSync105, mkdirSync as mkdirSync51, mkdtempSync as mkdtempSync17, renameSync as renameSync15, rmSync as rmSync33, statSync as statSync36 } from "fs";
+import { cpSync as cpSync6, existsSync as existsSync107, mkdirSync as mkdirSync54, mkdtempSync as mkdtempSync17, renameSync as renameSync15, rmSync as rmSync33, statSync as statSync36 } from "fs";
 import { tmpdir as tmpdir17 } from "os";
-import { basename as basename28, dirname as dirname55, extname as extname23, join as join110 } from "path";
+import { basename as basename28, dirname as dirname55, extname as extname23, join as join113 } from "path";
 function defaultLabelForPath(input2) {
   const name = basename28(input2);
   return extname23(name).toLowerCase() === ".html" ? basename28(name, extname23(name)) : name;
@@ -193710,7 +194495,7 @@ function inputError(variant) {
   );
 }
 function stageHtmlVariant(variant) {
-  const stagedDir = mkdtempSync17(join110(tmpdir17(), "hf-compare-variant-"));
+  const stagedDir = mkdtempSync17(join113(tmpdir17(), "hf-compare-variant-"));
   try {
     cpSync6(dirname55(variant.inputPath), stagedDir, {
       recursive: true,
@@ -193721,7 +194506,7 @@ function stageHtmlVariant(variant) {
     });
     const sourceName = basename28(variant.inputPath);
     if (sourceName !== "index.html") {
-      renameSync15(join110(stagedDir, sourceName), join110(stagedDir, "index.html"));
+      renameSync15(join113(stagedDir, sourceName), join113(stagedDir, "index.html"));
     }
     return {
       ...variant,
@@ -193737,11 +194522,11 @@ function prepareCompareVariantProjects(variants) {
   const prepared = [];
   try {
     for (const variant of variants) {
-      if (!existsSync105(variant.inputPath)) {
+      if (!existsSync107(variant.inputPath)) {
         throw inputError(variant);
       }
       const stat3 = statSync36(variant.inputPath);
-      if (stat3.isDirectory() && existsSync105(join110(variant.inputPath, "index.html"))) {
+      if (stat3.isDirectory() && existsSync107(join113(variant.inputPath, "index.html"))) {
         prepared.push({
           ...variant,
           projectDir: variant.inputPath
@@ -193807,13 +194592,13 @@ async function renderCompareSheet(parsed) {
   const capResult = capCompareVariants(parsed.variants);
   const variants = capResult.variants;
   const prepared = prepareCompareVariantProjects(variants);
-  const frameDir = mkdtempSync17(join110(tmpdir17(), "hf-compare-frames-"));
+  const frameDir = mkdtempSync17(join113(tmpdir17(), "hf-compare-frames-"));
   const framePaths = [];
   try {
     let renderReadyTimedOut = false;
     for (let i2 = 0; i2 < prepared.length; i2++) {
       const variant = prepared[i2];
-      const framePath = join110(frameDir, `variant-${String(i2 + 1).padStart(2, "0")}.png`);
+      const framePath = join113(frameDir, `variant-${String(i2 + 1).padStart(2, "0")}.png`);
       const rendered = await renderCompareVariant(variant, {
         atSeconds: parsed.atSeconds,
         framePath,
@@ -193822,7 +194607,7 @@ async function renderCompareSheet(parsed) {
       framePaths.push(rendered.framePath);
       renderReadyTimedOut = renderReadyTimedOut || rendered.renderReadyTimedOut;
     }
-    mkdirSync51(dirname55(parsed.outPath), { recursive: true });
+    mkdirSync54(dirname55(parsed.outPath), { recursive: true });
     await createContactSheet(framePaths, parsed.outPath, {
       cols: parsed.cols ?? defaultCompareCols(framePaths.length),
       maxImages: framePaths.length,
@@ -193941,11 +194726,11 @@ ${c.error("\u2717")} Compare failed: ${message}`);
 });
 
 // src/capture/assetDownloader.ts
-import { writeFileSync as writeFileSync45, mkdirSync as mkdirSync53 } from "fs";
-import { join as join111, extname as extname24 } from "path";
-import { createHash as createHash19 } from "crypto";
+import { writeFileSync as writeFileSync46, mkdirSync as mkdirSync55 } from "fs";
+import { join as join114, extname as extname24 } from "path";
+import { createHash as createHash20 } from "crypto";
 function svgContentHashSlug(svgSource, isLogo) {
-  const hash2 = createHash19("sha1").update(svgSource).digest("hex").slice(0, 8);
+  const hash2 = createHash20("sha1").update(svgSource).digest("hex").slice(0, 8);
   return isLogo ? `logo-${hash2}` : `svg-${hash2}`;
 }
 function toStandaloneSvg(outerHTML) {
@@ -193963,11 +194748,11 @@ function toStandaloneSvg(outerHTML) {
   return outerHTML.replace(original, tag);
 }
 async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks, options = {}) {
-  const assetsDir = join111(outputDir, "assets");
-  mkdirSync53(assetsDir, { recursive: true });
+  const assetsDir = join114(outputDir, "assets");
+  mkdirSync55(assetsDir, { recursive: true });
   const assets = [];
   const downloadedUrls = /* @__PURE__ */ new Set();
-  mkdirSync53(join111(outputDir, "assets", "svgs"), { recursive: true });
+  mkdirSync55(join114(outputDir, "assets", "svgs"), { recursive: true });
   const usedSvgNames = /* @__PURE__ */ new Set();
   for (let i2 = 0; i2 < tokens.svgs.length && i2 < 30; i2++) {
     const svg = tokens.svgs[i2];
@@ -193984,7 +194769,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks,
     const name = `${finalSlug}.svg`;
     const localPath = `assets/svgs/${name}`;
     try {
-      writeFileSync45(join111(outputDir, localPath), svgFile, "utf-8");
+      writeFileSync46(join114(outputDir, localPath), svgFile, "utf-8");
       assets.push({ url: "", localPath, type: "svg" });
     } catch {
     }
@@ -193999,7 +194784,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks,
       const localPath = `assets/${name}`;
       const buffer = await fetchBuffer(icon.href, Math.min(1e4, remainingMs));
       if (buffer) {
-        writeFileSync45(join111(outputDir, localPath), buffer);
+        writeFileSync46(join114(outputDir, localPath), buffer);
         assets.push({ url: icon.href, localPath, type: "favicon" });
         break;
       }
@@ -194066,7 +194851,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks,
         const name = `${slug}${ext}`;
         usedNames.add(slug);
         const localPath = `assets/${name}`;
-        writeFileSync45(join111(outputDir, localPath), buffer);
+        writeFileSync46(join114(outputDir, localPath), buffer);
         assets.push({ url, localPath, type: "image" });
         imgIdx++;
       } catch {
@@ -194080,7 +194865,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks,
       const localPath = `assets/og-image${ext}`;
       const buffer = remainingMs > 0 ? await fetchBuffer(tokens.ogImage, Math.min(1e4, remainingMs)) : null;
       if (buffer && buffer.length > 5e3) {
-        writeFileSync45(join111(outputDir, localPath), buffer);
+        writeFileSync46(join114(outputDir, localPath), buffer);
         assets.push({ url: tokens.ogImage, localPath, type: "image" });
       }
     } catch {
@@ -194103,8 +194888,8 @@ function normalizeUrl(u) {
   }
 }
 async function downloadAndRewriteFonts(css, outputDir, options = {}) {
-  const assetsDir = join111(outputDir, "assets", "fonts");
-  mkdirSync53(assetsDir, { recursive: true });
+  const assetsDir = join114(outputDir, "assets", "fonts");
+  mkdirSync55(assetsDir, { recursive: true });
   const fontUrlRegex = /url\(['"]?(https?:\/\/[^'")\s]+\.(?:woff2?|ttf|otf)[^'")\s]*?)['"]?\)/g;
   const fontUrls = /* @__PURE__ */ new Set();
   let match;
@@ -194143,11 +194928,11 @@ async function downloadAndRewriteFonts(css, outputDir, options = {}) {
     try {
       const urlObj = new URL(fontUrl);
       const filename = urlObj.pathname.split("/").pop() || `font-${count}.woff2`;
-      const localPath = join111(assetsDir, filename);
+      const localPath = join114(assetsDir, filename);
       const relativePath = `assets/fonts/${filename}`;
       const buffer = await fetchBuffer(fontUrl, Math.min(1e4, remainingMs));
       if (buffer) {
-        writeFileSync45(localPath, buffer);
+        writeFileSync46(localPath, buffer);
         rewritten = rewritten.split(fontUrl).join(relativePath);
       }
     } catch {
@@ -194299,8 +195084,8 @@ __export(video_exports, {
   runVideoMode: () => runVideoMode,
   safeFilename: () => safeFilename
 });
-import { createWriteStream as createWriteStream4, existsSync as existsSync106, mkdirSync as mkdirSync54, readFileSync as readFileSync71, unlinkSync as unlinkSync10 } from "fs";
-import { resolve as resolve71, join as join113, basename as basename29 } from "path";
+import { createWriteStream as createWriteStream4, existsSync as existsSync108, mkdirSync as mkdirSync56, readFileSync as readFileSync75, unlinkSync as unlinkSync11 } from "fs";
+import { resolve as resolve71, join as join115, basename as basename29 } from "path";
 async function streamToFile(url, destPath) {
   const r2 = await safeFetch(url, {
     signal: AbortSignal.timeout(12e4),
@@ -194362,7 +195147,7 @@ async function streamToFile(url, destPath) {
     file.destroy();
     if (e3.code !== "EEXIST") {
       try {
-        unlinkSync10(destPath);
+        unlinkSync11(destPath);
       } catch {
       }
     }
@@ -194419,11 +195204,11 @@ function pickManifestEntry(manifest, args) {
 }
 async function runVideoMode(args) {
   const projectDir = resolve71(args.project);
-  const directPath = join113(projectDir, "extracted", "video-manifest.json");
-  const w2hPath = join113(projectDir, "capture", "extracted", "video-manifest.json");
-  const manifestPath2 = existsSync106(directPath) ? directPath : w2hPath;
+  const directPath = join115(projectDir, "extracted", "video-manifest.json");
+  const w2hPath = join115(projectDir, "capture", "extracted", "video-manifest.json");
+  const manifestPath2 = existsSync108(directPath) ? directPath : w2hPath;
   const isW2hLayout = manifestPath2 === w2hPath;
-  if (!existsSync106(manifestPath2)) {
+  if (!existsSync108(manifestPath2)) {
     console.error(
       `${c.error("\u2717")} no video-manifest.json at ${directPath} or ${w2hPath}
   Was this directory produced by \`hyperframes capture\`?`
@@ -194433,7 +195218,7 @@ async function runVideoMode(args) {
   }
   let manifest;
   try {
-    manifest = JSON.parse(readFileSync71(manifestPath2, "utf-8"));
+    manifest = JSON.parse(readFileSync75(manifestPath2, "utf-8"));
   } catch (e3) {
     console.error(`${c.error("\u2717")} video-manifest.json is malformed: ${e3.message}`);
     setCommandExitCode(1);
@@ -194474,10 +195259,10 @@ async function runVideoMode(args) {
     setCommandExitCode(1);
     return;
   }
-  const outDir = isW2hLayout ? join113(projectDir, "capture", "assets", "videos") : join113(projectDir, "assets", "videos");
-  mkdirSync54(outDir, { recursive: true });
+  const outDir = isW2hLayout ? join115(projectDir, "capture", "assets", "videos") : join115(projectDir, "assets", "videos");
+  mkdirSync56(outDir, { recursive: true });
   const fname = safeFilename(entry.filename || basename29(entry.url));
-  const outPath = join113(outDir, fname);
+  const outPath = join115(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})`
@@ -195721,8 +196506,8 @@ var init_designStyleExtractor = __esm({
 });
 
 // src/capture/fontMetadataExtractor.ts
-import { readdirSync as readdirSync34, readFileSync as readFileSync73, writeFileSync as writeFileSync46, existsSync as existsSync107 } from "fs";
-import { join as join114 } from "path";
+import { readdirSync as readdirSync34, readFileSync as readFileSync76, writeFileSync as writeFileSync47, existsSync as existsSync109 } from "fs";
+import { join as join116 } from "path";
 import * as fontkit from "fontkit";
 function isFontCollection(value) {
   return value.type === "TTC" || value.type === "DFont";
@@ -195730,10 +196515,10 @@ function isFontCollection(value) {
 function extractFontMetadata(fontsDir, outputPath) {
   const files = [];
   const unidentified = [];
-  if (existsSync107(fontsDir)) {
+  if (existsSync109(fontsDir)) {
     const fontFiles = readdirSync34(fontsDir).filter((f3) => /\.(woff2?|ttf|otf)$/i.test(f3));
     for (const filename of fontFiles) {
-      const fullPath = join114(fontsDir, filename);
+      const fullPath = join116(fontsDir, filename);
       const meta = readSingleFont(fullPath, filename);
       if (meta.identified) {
         files.push(meta);
@@ -195755,7 +196540,7 @@ function extractFontMetadata(fontsDir, outputPath) {
       tool: "fontkit"
     }
   };
-  writeFileSync46(outputPath, JSON.stringify(manifest, null, 2), "utf-8");
+  writeFileSync47(outputPath, JSON.stringify(manifest, null, 2), "utf-8");
   return manifest;
 }
 function readSingleFont(fullPath, filename) {
@@ -195772,7 +196557,7 @@ function readSingleFont(fullPath, filename) {
     isIcon: false
   };
   try {
-    const buf = readFileSync73(fullPath);
+    const buf = readFileSync76(fullPath);
     const created = fontkit.create(buf);
     const font = isFontCollection(created) ? created.fonts[0] : created;
     if (!font) return empty2;
@@ -196044,8 +196829,8 @@ var init_animationCataloger = __esm({
 });
 
 // src/capture/mediaCapture.ts
-import { mkdirSync as mkdirSync55, writeFileSync as writeFileSync47, readdirSync as readdirSync35, readFileSync as readFileSync74, statSync as statSync37 } from "fs";
-import { join as join115, extname as extname25 } from "path";
+import { mkdirSync as mkdirSync57, writeFileSync as writeFileSync48, readdirSync as readdirSync35, readFileSync as readFileSync77, statSync as statSync37 } from "fs";
+import { join as join117, extname as extname25 } from "path";
 function liveRemainingMs(budget, fallbackMs) {
   return budget.remainingMs?.() ?? fallbackMs;
 }
@@ -196083,7 +196868,7 @@ async function saveLottieAnimations(discoveredLotties, lottieDir, budget = {}) {
             const hash2 = buf.toString("base64").slice(0, 100);
             if (savedHashes.has(hash2)) continue;
             savedHashes.add(hash2);
-            writeFileSync47(join115(lottieDir, `animation-${savedCount}.lottie`), buf);
+            writeFileSync48(join117(lottieDir, `animation-${savedCount}.lottie`), buf);
             savedCount++;
             continue;
           }
@@ -196101,7 +196886,7 @@ async function saveLottieAnimations(discoveredLotties, lottieDir, budget = {}) {
         } catch {
           continue;
         }
-        writeFileSync47(join115(lottieDir, `animation-${savedCount}.json`), jsonData, "utf-8");
+        writeFileSync48(join117(lottieDir, `animation-${savedCount}.json`), jsonData, "utf-8");
         savedCount++;
       }
     } catch {
@@ -196111,18 +196896,18 @@ async function saveLottieAnimations(discoveredLotties, lottieDir, budget = {}) {
 }
 async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget = {}) {
   const manifest = [];
-  const previewDir = join115(lottieDir, "previews");
-  mkdirSync55(previewDir, { recursive: true });
+  const previewDir = join117(lottieDir, "previews");
+  mkdirSync57(previewDir, { recursive: true });
   for (const file of readdirSync35(lottieDir)) {
     if (!file.endsWith(".json")) continue;
     if (liveRemainingMs(budget, 1) <= 0) break;
     try {
-      const raw = JSON.parse(readFileSync74(join115(lottieDir, file), "utf-8"));
+      const raw = JSON.parse(readFileSync77(join117(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 = statSync37(join115(lottieDir, file)).size;
+      const fileSize = statSync37(join117(lottieDir, file)).size;
       if (fileSize > 2e6) continue;
       let previewPage;
       try {
@@ -196130,7 +196915,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget
         previewPage = await chromeBrowser.newPage();
         if (liveRemainingMs(budget, 1) <= 0) break;
         await previewPage.setViewport({ width: 400, height: 400 });
-        const animData = JSON.parse(readFileSync74(join115(lottieDir, file), "utf-8"));
+        const animData = JSON.parse(readFileSync77(join117(lottieDir, file), "utf-8"));
         const midFrame = Math.floor(((raw.op || 0) - (raw.ip || 0)) * 0.3);
         await previewPage.setContent(
           `<!DOCTYPE html>
@@ -196161,7 +196946,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget
         });
         if (liveRemainingMs(budget, 1) > 0) {
           await previewPage.screenshot({
-            path: join115(previewDir, previewName),
+            path: join117(previewDir, previewName),
             type: "png",
             omitBackground: true
           });
@@ -196186,8 +196971,8 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir, budget
     }
   }
   if (manifest.length > 0) {
-    writeFileSync47(
-      join115(outputDir, "extracted", "lottie-manifest.json"),
+    writeFileSync48(
+      join117(outputDir, "extracted", "lottie-manifest.json"),
       JSON.stringify(manifest, null, 2),
       "utf-8"
     );
@@ -196225,7 +197010,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}`;
-    writeFileSync47(join115(videosDir, safe), Buffer.concat(chunks));
+    writeFileSync48(join117(videosDir, safe), Buffer.concat(chunks));
     return `assets/videos/${safe}`;
   } catch {
     return null;
@@ -196292,10 +197077,10 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
   }
   const merged = [...byKey.values()];
   if (merged.length === 0) return;
-  const videoManifestDir = join115(outputDir, "assets", "videos");
-  mkdirSync55(videoManifestDir, { recursive: true });
-  const previewDir = join115(videoManifestDir, "previews");
-  mkdirSync55(previewDir, { recursive: true });
+  const videoManifestDir = join117(outputDir, "assets", "videos");
+  mkdirSync57(videoManifestDir, { recursive: true });
+  const previewDir = join117(videoManifestDir, "previews");
+  mkdirSync57(previewDir, { recursive: true });
   const videoManifest = [];
   const dlStart = Date.now();
   for (let vi = 0; vi < merged.length && vi < 20; vi++) {
@@ -196323,7 +197108,7 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
           await new Promise((r2) => setTimeout(r2, 200));
           if (liveRemainingMs(opts ?? {}, 1) > 0) {
             await page.screenshot({
-              path: join115(previewDir, previewName),
+              path: join117(previewDir, previewName),
               clip: {
                 x: Math.max(0, rect.x),
                 y: Math.max(0, rect.y),
@@ -196359,8 +197144,8 @@ async function captureVideoManifest(page, outputDir, progress, opts) {
     });
   }
   if (videoManifest.length > 0) {
-    writeFileSync47(
-      join115(outputDir, "extracted", "video-manifest.json"),
+    writeFileSync48(
+      join117(outputDir, "extracted", "video-manifest.json"),
       JSON.stringify(videoManifest, null, 2),
       "utf-8"
     );
@@ -196429,8 +197214,8 @@ var init_mediaCapture = __esm({
 });
 
 // src/capture/contentExtractor.ts
-import { existsSync as existsSync108, readdirSync as readdirSync36, statSync as statSync38, readFileSync as readFileSync75 } from "fs";
-import { basename as basename30, join as join116 } from "path";
+import { existsSync as existsSync110, readdirSync as readdirSync36, statSync as statSync38, readFileSync as readFileSync78 } from "fs";
+import { basename as basename30, join as join118 } from "path";
 function resolveVisionPhaseCompletion(outcome, remainingMs) {
   if (outcome.budgetExhausted || remainingMs <= 0) {
     return { status: "degraded", reason: "budget-exhausted" };
@@ -196668,7 +197453,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
         return response.text?.trim() || "";
       };
     }
-    const imageFiles = readdirSync36(join116(outputDir, "assets")).filter(
+    const imageFiles = readdirSync36(join118(outputDir, "assets")).filter(
       (f3) => /\.(png|jpg|jpeg|webp|gif)$/i.test(f3)
     );
     const BATCH_SIZE = 20;
@@ -196696,10 +197481,10 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
       const batch = imageFiles.slice(i2, i2 + BATCH_SIZE);
       const results = await Promise.allSettled(
         batch.map(async (file) => {
-          const filePath = join116(outputDir, "assets", file);
+          const filePath = join118(outputDir, "assets", file);
           const stat3 = statSync38(filePath);
           if (stat3.size > 4e6) return { file, caption: "" };
-          const buffer = readFileSync75(filePath);
+          const buffer = readFileSync78(filePath);
           const base64 = buffer.toString("base64");
           const ext = file.split(".").pop()?.toLowerCase() || "png";
           const mimeType = ext === "jpg" ? "image/jpeg" : `image/${ext}`;
@@ -196729,12 +197514,12 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
       `${Object.keys(geminiCaptions).length} images captioned with ${providerName}`
     );
     const svgFiles = [];
-    const assetsDir = join116(outputDir, "assets");
+    const assetsDir = join118(outputDir, "assets");
     for (const f3 of readdirSync36(assetsDir)) {
       if (/\.svg$/i.test(f3)) svgFiles.push({ file: f3, relPath: f3 });
     }
-    const svgsSubdir = join116(assetsDir, "svgs");
-    if (existsSync108(svgsSubdir)) {
+    const svgsSubdir = join118(assetsDir, "svgs");
+    if (existsSync110(svgsSubdir)) {
       for (const f3 of readdirSync36(svgsSubdir)) {
         if (/\.svg$/i.test(f3)) svgFiles.push({ file: f3, relPath: `svgs/${f3}` });
       }
@@ -196764,10 +197549,10 @@ async function captionImagesWithGemini(outputDir, progress, warnings, options =
         const batch = svgFiles.slice(i2, i2 + SVG_BATCH);
         const results = await Promise.allSettled(
           batch.map(async ({ relPath }) => {
-            const filePath = join116(assetsDir, relPath);
+            const filePath = join118(assetsDir, relPath);
             let pngBase64;
             try {
-              const svgSource = readFileSync75(filePath, "utf-8");
+              const svgSource = readFileSync78(filePath, "utf-8");
               const lightFillHits = (svgSource.match(/fill\s*=\s*["'](#fff(fff)?|white|#[ef][ef][ef]|#[ef]{6})["']/gi) || []).length;
               const darkFillHits = (svgSource.match(/fill\s*=\s*["'](#000(000)?|black|#[0-3]{6}|#[0-3]{3})["']/gi) || []).length;
               const bg = lightFillHits > darkFillHits ? { r: 32, g: 32, b: 32 } : { r: 255, g: 255, b: 255 };
@@ -196833,11 +197618,11 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   const uncaptionedLines = [];
   const svgLines = [];
   const fontLines = [];
-  const assetsPath = join116(outputDir, "assets");
+  const assetsPath = join118(outputDir, "assets");
   try {
     for (const file of readdirSync36(assetsPath)) {
       if (file === "svgs" || file === "fonts" || file === "lottie" || file === "videos") continue;
-      const filePath = join116(assetsPath, file);
+      const filePath = join118(assetsPath, file);
       const stat3 = statSync38(filePath);
       if (!stat3.isFile()) continue;
       const sizeKb = Math.round(stat3.size / 1024);
@@ -196866,7 +197651,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   } catch {
   }
   try {
-    const svgsPath = join116(assetsPath, "svgs");
+    const svgsPath = join118(assetsPath, "svgs");
     for (const file of readdirSync36(svgsPath)) {
       if (!file.endsWith(".svg")) continue;
       const svgMatch = tokens.svgs.find(
@@ -196885,7 +197670,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   } catch {
   }
   try {
-    const fontsPath = join116(assetsPath, "fonts");
+    const fontsPath = join118(assetsPath, "fonts");
     for (const file of readdirSync36(fontsPath)) {
       fontLines.push(`fonts/${file} \u2014 font file`);
     }
@@ -196894,7 +197679,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   const videoLines = [];
   try {
     const manifest = JSON.parse(
-      readFileSync75(join116(outputDir, "extracted", "video-manifest.json"), "utf-8")
+      readFileSync78(join118(outputDir, "extracted", "video-manifest.json"), "utf-8")
     );
     for (const v2 of manifest) {
       if (!v2.localPath) continue;
@@ -196929,8 +197714,8 @@ var agentPromptGenerator_exports = {};
 __export(agentPromptGenerator_exports, {
   generateAgentPrompt: () => generateAgentPrompt
 });
-import { writeFileSync as writeFileSync48, readdirSync as readdirSync37, existsSync as existsSync109 } from "fs";
-import { join as join117 } from "path";
+import { writeFileSync as writeFileSync49, readdirSync as readdirSync37, existsSync as existsSync111 } from "fs";
+import { join as join119 } from "path";
 function inferColorRole(hex) {
   const r2 = parseInt(hex.slice(1, 3), 16) / 255;
   const g = parseInt(hex.slice(3, 5), 16) / 255;
@@ -196949,9 +197734,9 @@ function inferColorRole(hex) {
 }
 function generateAgentPrompt(outputDir, url, tokens, _animations, hasScreenshot, hasLottie, hasShaders, _catalogedAssets, _detectedLibraries) {
   const prompt = buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShaders);
-  writeFileSync48(join117(outputDir, "AGENTS.md"), prompt, "utf-8");
-  writeFileSync48(join117(outputDir, "CLAUDE.md"), prompt, "utf-8");
-  writeFileSync48(join117(outputDir, ".cursorrules"), prompt, "utf-8");
+  writeFileSync49(join119(outputDir, "AGENTS.md"), prompt, "utf-8");
+  writeFileSync49(join119(outputDir, "CLAUDE.md"), prompt, "utf-8");
+  writeFileSync49(join119(outputDir, ".cursorrules"), prompt, "utf-8");
 }
 function buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShaders) {
   const title = tokens.title || new URL(url).hostname.replace(/^www\./, "");
@@ -196960,8 +197745,8 @@ function buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShader
     (f3) => f3.family + (f3.variable && f3.weightRange ? ` (${f3.weightRange[0]}-${f3.weightRange[1]} variable)` : f3.weights.length > 0 ? ` (${f3.weights.join(",")})` : "")
   ).join(", ") || "none detected";
   function contactSheetRows(dir, baseFile, label2) {
-    const fullDir = join117(outputDir, dir);
-    if (!existsSync109(fullDir)) return [];
+    const fullDir = join119(outputDir, dir);
+    if (!existsSync111(fullDir)) return [];
     const baseName = baseFile.replace(/\.jpg$/, "");
     const escapedBase = baseName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
     const paginatedRe = new RegExp(`^${escapedBase}(?:-(\\d+))?\\.jpg$`);
@@ -196993,7 +197778,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 (existsSync109(join117(outputDir, "extracted", "design-styles.json"))) {
+  if (existsSync111(join119(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. |"
     );
@@ -197064,15 +197849,15 @@ var init_agentPromptGenerator = __esm({
 });
 
 // src/capture/scaffolding.ts
-import { existsSync as existsSync110, writeFileSync as writeFileSync49, readFileSync as readFileSync76 } from "fs";
-import { join as join118, resolve as resolve72 } from "path";
+import { existsSync as existsSync113, writeFileSync as writeFileSync50, readFileSync as readFileSync79 } from "fs";
+import { join as join120, resolve as resolve72 } from "path";
 function loadEnvFile(startDir) {
   try {
     let dir = resolve72(startDir);
     for (let i2 = 0; i2 < 5; i2++) {
       const envPath = resolve72(dir, ".env");
       try {
-        const envContent = readFileSync76(envPath, "utf-8");
+        const envContent = readFileSync79(envPath, "utf-8");
         for (const line2 of envContent.split("\n")) {
           const trimmed = line2.trim();
           if (!trimmed || trimmed.startsWith("#")) continue;
@@ -197091,10 +197876,10 @@ function loadEnvFile(startDir) {
   }
 }
 async function generateProjectScaffold(outputDir, url, tokens, animationCatalog, hasScreenshots, hasLotties, hasShaders, catalogedAssets, progress, warnings, detectedLibraries) {
-  const metaPath = join118(outputDir, "meta.json");
-  if (!existsSync110(metaPath)) {
+  const metaPath = join120(outputDir, "meta.json");
+  if (!existsSync113(metaPath)) {
     const hostname2 = new URL(url).hostname.replace(/^www\./, "");
-    writeFileSync49(
+    writeFileSync50(
       metaPath,
       JSON.stringify({ id: hostname2 + "-video", name: tokens.title || hostname2 }, null, 2),
       "utf-8"
@@ -197151,8 +197936,8 @@ __export(screenshotCapture_exports, {
   captureScrollScreenshots: () => captureScrollScreenshots,
   pngHeight: () => pngHeight
 });
-import { writeFileSync as writeFileSync50, mkdirSync as mkdirSync56 } from "fs";
-import { join as join119 } from "path";
+import { writeFileSync as writeFileSync51, mkdirSync as mkdirSync58 } from "fs";
+import { join as join121 } 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;
@@ -197177,7 +197962,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;
-    writeFileSync50(join119(screenshotsDir, "full-page.png"), buffer);
+    writeFileSync51(join121(screenshotsDir, "full-page.png"), buffer);
     return "screenshots/full-page.png";
   } finally {
     try {
@@ -197192,8 +197977,8 @@ async function captureFullPagePlate(page, screenshotsDir, budget = {}) {
   }
 }
 async function captureScrollScreenshots(page, outputDir, budget = {}) {
-  const screenshotsDir = join119(outputDir, "screenshots");
-  mkdirSync56(screenshotsDir, { recursive: true });
+  const screenshotsDir = join121(outputDir, "screenshots");
+  mkdirSync58(screenshotsDir, { recursive: true });
   const MAX_SCREENSHOTS = 20;
   const filePaths = [];
   if ((budget.remainingMs?.() ?? 1) <= 0) return filePaths;
@@ -197286,10 +198071,10 @@ async function captureScrollScreenshots(page, outputDir, budget = {}) {
         finalPositions[i2] / Math.max(1, scrollHeight - viewportHeight) * 100
       );
       const filename = `scroll-${String(Math.min(pct, 100)).padStart(3, "0")}.png`;
-      const filePath = join119(screenshotsDir, filename);
+      const filePath = join121(screenshotsDir, filename);
       if ((budget.remainingMs?.() ?? 1) <= 0) break;
       const buffer = await page.screenshot({ type: "png" });
-      writeFileSync50(filePath, buffer);
+      writeFileSync51(filePath, buffer);
       filePaths.push(`screenshots/${filename}`);
     }
     await page.evaluate(`window.scrollTo(0, 0)`);
@@ -197642,8 +198427,8 @@ var capture_exports = {};
 __export(capture_exports, {
   captureWebsite: () => captureWebsite
 });
-import { mkdirSync as mkdirSync57, writeFileSync as writeFileSync51, existsSync as existsSync111 } from "fs";
-import { join as join120 } from "path";
+import { mkdirSync as mkdirSync59, writeFileSync as writeFileSync53, existsSync as existsSync114 } from "fs";
+import { join as join123 } from "path";
 async function captureWebsite(opts, onProgress) {
   const {
     url,
@@ -197684,9 +198469,9 @@ async function captureWebsite(opts, onProgress) {
   };
   phase("browser", "started");
   loadEnvFile(outputDir);
-  mkdirSync57(join120(outputDir, "extracted"), { recursive: true });
-  mkdirSync57(join120(outputDir, "screenshots"), { recursive: true });
-  mkdirSync57(join120(outputDir, "assets"), { recursive: true });
+  mkdirSync59(join123(outputDir, "extracted"), { recursive: true });
+  mkdirSync59(join123(outputDir, "screenshots"), { recursive: true });
+  mkdirSync59(join123(outputDir, "assets"), { recursive: true });
   progress("browser", "Launching headless Chrome...");
   const { ensureBrowser: ensureBrowser2 } = await Promise.resolve().then(() => (init_manager2(), manager_exports2));
   const browser = await ensureBrowser2();
@@ -197862,8 +198647,8 @@ async function captureWebsite(opts, onProgress) {
     } catch {
     }
     if (discoveredLotties.length > 0 && remainingMs() > 0) {
-      const lottieDir = join120(outputDir, "assets", "lottie");
-      mkdirSync57(lottieDir, { recursive: true });
+      const lottieDir = join123(outputDir, "assets", "lottie");
+      mkdirSync59(lottieDir, { recursive: true });
       const lottieBudget = { remainingMs };
       const savedCount = await saveLottieAnimations(discoveredLotties, lottieDir, lottieBudget);
       if (savedCount > 0 && remainingMs() > 0) {
@@ -197882,8 +198667,8 @@ async function captureWebsite(opts, onProgress) {
           return true;
         });
         capturedShaders = unique;
-        writeFileSync51(
-          join120(outputDir, "extracted", "shaders.json"),
+        writeFileSync53(
+          join123(outputDir, "extracted", "shaders.json"),
           JSON.stringify(unique, null, 2),
           "utf-8"
         );
@@ -197897,16 +198682,16 @@ async function captureWebsite(opts, onProgress) {
       ...tokens,
       svgs: tokens.svgs.map(({ outerHTML: _, ...rest }) => rest)
     };
-    writeFileSync51(
-      join120(outputDir, "extracted", "tokens.json"),
+    writeFileSync53(
+      join123(outputDir, "extracted", "tokens.json"),
       JSON.stringify(tokensForDisk, null, 2),
       "utf-8"
     );
     progress("style", "Extracting design styles...");
     try {
       const designStyles = await extractDesignStyles(page1);
-      writeFileSync51(
-        join120(outputDir, "extracted", "design-styles.json"),
+      writeFileSync53(
+        join123(outputDir, "extracted", "design-styles.json"),
         JSON.stringify(designStyles, null, 2),
         "utf-8"
       );
@@ -198006,8 +198791,8 @@ ${err.stack}` : normalizeErrorMessage(err);
     }
     try {
       const fontsManifest = extractFontMetadata(
-        join120(outputDir, "assets", "fonts"),
-        join120(outputDir, "extracted", "fonts-manifest.json")
+        join123(outputDir, "assets", "fonts"),
+        join123(outputDir, "extracted", "fonts-manifest.json")
       );
       if (fontsManifest.families.length > 0) {
         const summary = fontsManifest.families.map((f3) => `${f3.family}${f3.variable ? " (variable)" : ""} \xD7 ${f3.fileCount}`).join(", ");
@@ -198033,8 +198818,8 @@ ${err.stack}` : normalizeErrorMessage(err);
         scrollTriggeredElements: (animationCatalog.scrollTargets || []).length,
         representativeAnimations: representativeAnims
       };
-      writeFileSync51(
-        join120(outputDir, "extracted", "animations.json"),
+      writeFileSync53(
+        join123(outputDir, "extracted", "animations.json"),
         JSON.stringify(leanCatalog, null, 2),
         "utf-8"
       );
@@ -198079,8 +198864,8 @@ ${err.stack}` : normalizeErrorMessage(err);
         ...tokens,
         svgs: tokens.svgs.map(({ outerHTML: _, ...rest }) => rest)
       };
-      writeFileSync51(
-        join120(outputDir, "extracted", "tokens.json"),
+      writeFileSync53(
+        join123(outputDir, "extracted", "tokens.json"),
         JSON.stringify(tokensForDisk2, null, 2),
         "utf-8"
       );
@@ -198096,12 +198881,12 @@ ${extracted.bodyHtml}
 </body>
 </html>
 `;
-      writeFileSync51(join120(outputDir, "extracted", "page.html"), pageHtml, "utf-8");
+      writeFileSync53(join123(outputDir, "extracted", "page.html"), pageHtml, "utf-8");
     } catch (err) {
       warnings.push(`page.html write failed: ${err}`);
     }
     if (visibleTextContent) {
-      writeFileSync51(join120(outputDir, "extracted", "visible-text.txt"), visibleTextContent, "utf-8");
+      writeFileSync53(join123(outputDir, "extracted", "visible-text.txt"), visibleTextContent, "utf-8");
     }
     let geminiCaptions = {};
     if (skipVision) {
@@ -198137,8 +198922,8 @@ ${extracted.bodyHtml}
       if (lines.length > 0) {
         const hasVisionKey = !!(!skipVision && (process.env.OPENROUTER_API_KEY || process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY));
         const header = hasVisionKey ? "# Asset Descriptions\n\nOne line per file. Read this instead of opening every image individually.\n\nTo find a specific brand or icon, **grep this file for the brand name in the description text** (e.g. `grep -i 'autodesk' asset-descriptions.md`). The Gemini Vision captions identify what's actually in each file \u2014 that's the agent's selector.\n\nThe `logo-<hash>.svg` filename prefix is a cheap structural hint (DOM said this SVG was inside a `<header>`, home-link `<a>`, or had an aria-label matching the page brand). It is NOT a content claim \u2014 many `logo-*` files are nav icons or decorative shapes. Trust the captions, not the filename prefix.\n\n" : "# Asset Descriptions\n\n\u26A0\uFE0F  GEMINI_API_KEY not set \u2014 descriptions below are catalog-derived (alt text, headings, section context, filename) instead of Vision-generated. To get richer Vision descriptions on the next capture, set GEMINI_API_KEY (or GOOGLE_API_KEY) and re-run.\n\nThe `logo-<hash>.svg` filename prefix is a structural hint (DOM said this SVG was inside a `<header>`, home-link `<a>`, or had an aria-label matching the page brand). To pick the actual brand logo without Vision, open the `logo-*` candidates in a previewer or rasterize them with `sharp` before referencing \u2014 composing a fake logo ships off-brand in the final video.\n\n";
-        writeFileSync51(
-          join120(outputDir, "extracted", "asset-descriptions.md"),
+        writeFileSync53(
+          join123(outputDir, "extracted", "asset-descriptions.md"),
           header + lines.map((l) => "- " + l).join("\n") + "\n",
           "utf-8"
         );
@@ -198156,8 +198941,8 @@ ${extracted.bodyHtml}
         const { createScrollContactSheet: createScrollContactSheet2, createAssetContactSheet: createAssetContactSheet2, createSvgContactSheet: createSvgContactSheet2 } = await Promise.resolve().then(() => (init_contactSheet(), contactSheet_exports));
         const contactSheetBudget = { remainingMs };
         const scrollSheets = await createScrollContactSheet2(
-          join120(outputDir, "screenshots"),
-          join120(outputDir, "screenshots", "contact-sheet.jpg"),
+          join123(outputDir, "screenshots"),
+          join123(outputDir, "screenshots", "contact-sheet.jpg"),
           contactSheetBudget
         );
         if (scrollSheets.length > 0)
@@ -198165,11 +198950,11 @@ ${extracted.bodyHtml}
             "design",
             `Screenshot contact sheet generated (${scrollSheets.length} page${scrollSheets.length > 1 ? "s" : ""})`
           );
-        const assetsImgDir = join120(outputDir, "assets");
-        if (existsSync111(assetsImgDir)) {
+        const assetsImgDir = join123(outputDir, "assets");
+        if (existsSync114(assetsImgDir)) {
           const assetSheets = await createAssetContactSheet2(
             assetsImgDir,
-            join120(outputDir, "assets", "contact-sheet.jpg"),
+            join123(outputDir, "assets", "contact-sheet.jpg"),
             contactSheetBudget
           );
           if (assetSheets.length > 0)
@@ -198178,9 +198963,9 @@ ${extracted.bodyHtml}
               `Asset contact sheet generated (${assetSheets.length} page${assetSheets.length > 1 ? "s" : ""})`
             );
         }
-        const svgsDir = join120(outputDir, "assets", "svgs");
-        const assetsRootDir = join120(outputDir, "assets");
-        const svgOutputPath = existsSync111(svgsDir) ? join120(outputDir, "assets", "svgs", "contact-sheet.jpg") : join120(outputDir, "assets", "contact-sheet-svgs.jpg");
+        const svgsDir = join123(outputDir, "assets", "svgs");
+        const assetsRootDir = join123(outputDir, "assets");
+        const svgOutputPath = existsSync114(svgsDir) ? join123(outputDir, "assets", "svgs", "contact-sheet.jpg") : join123(outputDir, "assets", "contact-sheet-svgs.jpg");
         const svgSheets = await createSvgContactSheet2(
           svgsDir,
           svgOutputPath,
@@ -198213,7 +198998,7 @@ ${extracted.bodyHtml}
       animationCatalog,
       screenshots.length > 0,
       discoveredLotties.length > 0,
-      existsSync111(join120(outputDir, "extracted", "shaders.json")),
+      existsSync114(join123(outputDir, "extracted", "shaders.json")),
       catalogedAssets,
       progress,
       warnings,
@@ -198391,14 +199176,14 @@ var init_capture2 = __esm({
         let outputName = args.output ?? "capture";
         let outputDir = resolve73(outputName);
         if (isDefaultOutput) {
-          const { existsSync: existsSync126 } = await import("fs");
+          const { existsSync: existsSync128 } = await import("fs");
           let n2 = 2;
-          while (existsSync126(outputDir) && n2 < 100) {
+          while (existsSync128(outputDir) && n2 < 100) {
             outputName = `capture-${n2}`;
             outputDir = resolve73(outputName);
             n2++;
           }
-          if (existsSync126(outputDir)) {
+          if (existsSync128(outputDir)) {
             console.error(`./capture-{2..99} are all taken. Pass -o <name> to pick a directory.`);
             failCommand();
           }
@@ -198487,11 +199272,11 @@ var init_capture2 = __esm({
         } catch (err) {
           const errMsg = normalizeErrorMessage(err);
           try {
-            const { mkdirSync: mkdirSync68, writeFileSync: writeFileSync61 } = await import("fs");
-            mkdirSync68(outputDir, { recursive: true });
+            const { mkdirSync: mkdirSync70, writeFileSync: writeFileSync63 } = await import("fs");
+            mkdirSync70(outputDir, { recursive: true });
             const isTimeout = /timeout|timed out/i.test(errMsg);
             const reason = isTimeout ? "Page navigation timed out \u2014 the site may be blocking headless browsers or requires authentication." : `Capture failed: ${errMsg}`;
-            writeFileSync61(
+            writeFileSync63(
               `${outputDir}/BLOCKED.md`,
               `# Capture Failed
 
@@ -198555,33 +199340,33 @@ __export(state_exports, {
   stateFilePath: () => stateFilePath,
   writeStackOutputs: () => writeStackOutputs
 });
-import { existsSync as existsSync113, mkdirSync as mkdirSync58, readdirSync as readdirSync38, readFileSync as readFileSync77, rmSync as rmSync34, writeFileSync as writeFileSync53 } from "fs";
-import { dirname as dirname56, join as join121 } from "path";
+import { existsSync as existsSync115, mkdirSync as mkdirSync60, readdirSync as readdirSync38, readFileSync as readFileSync80, rmSync as rmSync34, writeFileSync as writeFileSync54 } from "fs";
+import { dirname as dirname56, join as join124 } from "path";
 function stateFilePath(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
-  return join121(cwd, STATE_DIR_NAME, `${STATE_FILE_PREFIX}${stackName}.json`);
+  return join124(cwd, STATE_DIR_NAME, `${STATE_FILE_PREFIX}${stackName}.json`);
 }
 function writeStackOutputs(outputs, cwd = process.cwd()) {
   const path2 = stateFilePath(outputs.stackName, cwd);
-  mkdirSync58(dirname56(path2), { recursive: true });
-  writeFileSync53(path2, JSON.stringify(outputs, null, 2) + "\n");
+  mkdirSync60(dirname56(path2), { recursive: true });
+  writeFileSync54(path2, JSON.stringify(outputs, null, 2) + "\n");
   return path2;
 }
 function readStackOutputs(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   const path2 = stateFilePath(stackName, cwd);
-  if (!existsSync113(path2)) return null;
+  if (!existsSync115(path2)) return null;
   try {
-    return JSON.parse(readFileSync77(path2, "utf-8"));
+    return JSON.parse(readFileSync80(path2, "utf-8"));
   } catch {
     return null;
   }
 }
 function deleteStackOutputs(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   const path2 = stateFilePath(stackName, cwd);
-  if (existsSync113(path2)) rmSync34(path2);
+  if (existsSync115(path2)) rmSync34(path2);
 }
 function listStackNames(cwd = process.cwd()) {
-  const dir = join121(cwd, STATE_DIR_NAME);
-  if (!existsSync113(dir)) return [];
+  const dir = join124(cwd, STATE_DIR_NAME);
+  if (!existsSync115(dir)) return [];
   return readdirSync38(dir).filter((f3) => f3.startsWith(STATE_FILE_PREFIX) && f3.endsWith(".json")).map((f3) => f3.slice(STATE_FILE_PREFIX.length, -".json".length));
 }
 function requireStack(stackName, cwd = process.cwd()) {
@@ -198612,8 +199397,8 @@ var init_state = __esm({
 
 // src/commands/lambda/sam.ts
 import { execFileSync as execFileSync18, spawnSync as spawnSync4 } from "child_process";
-import { existsSync as existsSync114 } from "fs";
-import { join as join123 } from "path";
+import { existsSync as existsSync116 } from "fs";
+import { join as join125 } from "path";
 function assertSamAvailable() {
   try {
     execFileSync18("sam", ["--version"], { stdio: "ignore" });
@@ -198633,8 +199418,8 @@ function assertAwsCliAvailable() {
   }
 }
 function locateSamTemplate(repoRoot2) {
-  const candidate = join123(repoRoot2, "examples", "aws-lambda", "template.yaml");
-  if (!existsSync114(candidate)) {
+  const candidate = join125(repoRoot2, "examples", "aws-lambda", "template.yaml");
+  if (!existsSync116(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.`
     );
@@ -198667,7 +199452,7 @@ function samDeploy(opts) {
   if (opts.awsProfile) {
     args.push("--profile", opts.awsProfile);
   }
-  const samDir = join123(opts.repoRoot, "examples", "aws-lambda");
+  const samDir = join125(opts.repoRoot, "examples", "aws-lambda");
   const result = spawnSync4("sam", args, { cwd: samDir, stdio: opts.stdio ?? "inherit" });
   if (result.status !== 0) {
     throw new Error(
@@ -198685,7 +199470,7 @@ function samDelete(opts) {
   if (opts.awsProfile) {
     args.push("--profile", opts.awsProfile);
   }
-  const samDir = join123(opts.repoRoot, "examples", "aws-lambda");
+  const samDir = join125(opts.repoRoot, "examples", "aws-lambda");
   const result = spawnSync4("sam", args, { cwd: samDir, stdio: opts.stdio ?? "inherit" });
   if (result.status !== 0) {
     throw new Error(`[lambda] sam delete exited with code ${result.status ?? "unknown"}`);
@@ -198735,17 +199520,17 @@ var init_sam = __esm({
 });
 
 // src/commands/lambda/repoRoot.ts
-import { existsSync as existsSync115 } from "fs";
+import { existsSync as existsSync117 } from "fs";
 import { dirname as dirname57, resolve as resolve74 } from "path";
 import { fileURLToPath as fileURLToPath15 } from "url";
 function repoRoot() {
   const override = process.env.HYPERFRAMES_REPO_ROOT;
-  if (override && existsSync115(resolve74(override, "packages", "aws-lambda", "package.json"))) {
+  if (override && existsSync117(resolve74(override, "packages", "aws-lambda", "package.json"))) {
     return override;
   }
   let dir = dirname57(fileURLToPath15(import.meta.url));
   for (let depth = 0; depth < 12; depth++) {
-    if (existsSync115(resolve74(dir, "packages", "aws-lambda", "package.json"))) {
+    if (existsSync117(resolve74(dir, "packages", "aws-lambda", "package.json"))) {
       return dir;
     }
     const parent = dirname57(dir);
@@ -198768,8 +199553,8 @@ __export(deploy_exports, {
   runDeploy: () => runDeploy
 });
 import { spawnSync as spawnSync5 } from "child_process";
-import { existsSync as existsSync116 } from "fs";
-import { join as join124, resolve as resolve75 } from "path";
+import { existsSync as existsSync118 } from "fs";
+import { join as join126, resolve as resolve75 } from "path";
 async function runDeploy(args = {}) {
   const resolved2 = {
     stackName: args.stackName ?? DEFAULT_STACK_NAME,
@@ -198786,8 +199571,8 @@ async function runDeploy(args = {}) {
     console.log(c.dim("\u2192 Building handler ZIP"));
     buildHandlerZip(root);
   } else {
-    const zip = join124(root, "packages", "aws-lambda", "dist", "handler.zip");
-    if (!existsSync116(zip)) {
+    const zip = join126(root, "packages", "aws-lambda", "dist", "handler.zip");
+    if (!existsSync118(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.`
       );
@@ -198830,7 +199615,7 @@ async function runDeploy(args = {}) {
 function buildHandlerZip(root) {
   const result = spawnSync5(
     "bun",
-    ["run", "--cwd", join124(root, "packages", "aws-lambda"), "build:zip"],
+    ["run", "--cwd", join126(root, "packages", "aws-lambda"), "build:zip"],
     { stdio: "inherit" }
   );
   if (result.status !== 0) {
@@ -198899,14 +199684,14 @@ var init_sites = __esm({
 });
 
 // src/commands/lambda/_dimensions.ts
-import { readFileSync as readFileSync78 } from "fs";
-import { join as join125 } from "path";
+import { readFileSync as readFileSync81 } from "fs";
+import { join as join127 } from "path";
 function warnOnDimensionMismatch(args) {
   if (args.quiet) return;
   if (args.outputResolution) return;
   let html;
   try {
-    html = readFileSync78(join125(args.projectDir, "index.html"), "utf-8");
+    html = readFileSync81(join127(args.projectDir, "index.html"), "utf-8");
   } catch {
     return;
   }
@@ -198935,8 +199720,8 @@ __export(render_exports2, {
   buildLambdaRenderConfig: () => buildLambdaRenderConfig,
   runRender: () => runRender
 });
-import { existsSync as existsSync117 } from "fs";
-import { join as join126, resolve as resolvePath2 } from "path";
+import { existsSync as existsSync119 } from "fs";
+import { join as join128, resolve as resolvePath2 } from "path";
 async function loadSDK2() {
   return import("@hyperframes/aws-lambda/sdk");
 }
@@ -198952,8 +199737,8 @@ async function runRender(args) {
   });
   const variables = resolveVariablesArg(args.variables, args.variablesFile);
   if (variables && Object.keys(variables).length > 0) {
-    const indexPath2 = join126(projectDir, "index.html");
-    if (existsSync117(indexPath2)) {
+    const indexPath2 = join128(projectDir, "index.html");
+    if (existsSync119(indexPath2)) {
       const issues = validateVariablesAgainstProject(indexPath2, variables);
       reportVariableIssues(issues, { strict: args.strictVariables ?? false, quiet: args.json });
     } else if (args.strictVariables && !args.json) {
@@ -199086,8 +199871,8 @@ __export(render_batch_exports, {
   runRenderBatch: () => runRenderBatch,
   runWithConcurrencyLimit: () => runWithConcurrencyLimit
 });
-import { existsSync as existsSync118, readFileSync as readFileSync79 } from "fs";
-import { join as join127, resolve as resolvePath3 } from "path";
+import { existsSync as existsSync120, readFileSync as readFileSync83 } from "fs";
+import { join as join129, resolve as resolvePath3 } from "path";
 async function loadSDK3() {
   return import("@hyperframes/aws-lambda/sdk");
 }
@@ -199095,7 +199880,7 @@ async function runRenderBatch(args) {
   const projectDir = resolvePath3(args.projectDir);
   const stack = requireStack(args.stackName);
   const batchPath = resolvePath3(args.batch);
-  if (!existsSync118(batchPath)) {
+  if (!existsSync120(batchPath)) {
     errorBox("Batch file not found", `No such file: ${batchPath}`);
     failCommand();
   }
@@ -199111,7 +199896,7 @@ async function runRenderBatch(args) {
     outputResolution: args.outputResolution,
     quiet: args.json
   });
-  const schema = loadProjectVariableSchema(join127(projectDir, "index.html"));
+  const schema = loadProjectVariableSchema(join129(projectDir, "index.html"));
   const strict = args.strictVariables ?? false;
   let hadStrictIssue = false;
   for (const { entry, lineNumber } of entries2) {
@@ -199246,7 +200031,7 @@ function buildLambdaBatchRenderConfig(args) {
   return config;
 }
 function parseBatchFile(path2) {
-  const raw = readFileSync79(path2, "utf8");
+  const raw = readFileSync83(path2, "utf8");
   const lines = raw.split(/\r?\n/);
   const out = [];
   for (let i2 = 0; i2 < lines.length; i2++) {
@@ -199440,7 +200225,7 @@ __export(policies_exports, {
   runPolicies: () => runPolicies,
   validatePolicy: () => validatePolicy
 });
-import { readFileSync as readFileSync80 } from "fs";
+import { readFileSync as readFileSync84 } from "fs";
 function allRequiredActions() {
   const set = /* @__PURE__ */ new Set();
   for (const group of Object.values(REQUIRED_ACTIONS)) {
@@ -199546,7 +200331,7 @@ async function runPolicies(args) {
   }
 }
 function validatePolicy(policyPath) {
-  const raw = readFileSync80(policyPath, "utf-8");
+  const raw = readFileSync84(policyPath, "utf-8");
   const parsed = JSON.parse(raw);
   const statements = Array.isArray(parsed.Statement) ? parsed.Statement : parsed.Statement ? [
     parsed.Statement
@@ -200157,9 +200942,9 @@ __export(cloudrun_exports, {
   missingCloudRunAdapterMessage: () => missingCloudRunAdapterMessage
 });
 import { spawnSync as spawnSync6 } from "child_process";
-import { existsSync as existsSync119, mkdirSync as mkdirSync59, readFileSync as readFileSync81, writeFileSync as writeFileSync54 } from "fs";
-import { homedir as homedir20 } from "os";
-import { join as join128, resolve as resolve76 } from "path";
+import { existsSync as existsSync121, mkdirSync as mkdirSync61, readFileSync as readFileSync85, writeFileSync as writeFileSync55 } from "fs";
+import { homedir as homedir22 } from "os";
+import { join as join130, resolve as resolve76 } from "path";
 function loadCloudRunAdapter() {
   cloudRunAdapterPromise ??= Promise.all([
     import("@hyperframes/gcp-cloud-run/sdk"),
@@ -200178,14 +200963,14 @@ Or, for an opt-in project setup:
   ${c.accent("npm install @hyperframes/gcp-cloud-run")}`;
 }
 function stateDir() {
-  return join128(homedir20(), ".hyperframes");
+  return join130(homedir22(), ".hyperframes");
 }
 function statePath() {
-  return join128(stateDir(), "cloudrun-state.json");
+  return join130(stateDir(), "cloudrun-state.json");
 }
 function writeState(state) {
-  mkdirSync59(stateDir(), { recursive: true });
-  writeFileSync54(statePath(), JSON.stringify(state, null, 2));
+  mkdirSync61(stateDir(), { recursive: true });
+  writeFileSync55(statePath(), JSON.stringify(state, null, 2));
 }
 function readState(args) {
   const overrides = {
@@ -200193,9 +200978,9 @@ function readState(args) {
     region: args.region
   };
   let base2 = {};
-  if (existsSync119(statePath())) {
+  if (existsSync121(statePath())) {
     try {
-      base2 = JSON.parse(readFileSync81(statePath(), "utf8"));
+      base2 = JSON.parse(readFileSync85(statePath(), "utf8"));
     } catch {
     }
   }
@@ -200338,13 +201123,13 @@ function machineVars(args, project, region, image) {
 }
 function findRepoRoot(tfDir) {
   const candidate = resolve76(tfDir, "..", "..", "..");
-  if (existsSync119(join128(candidate, "packages", "gcp-cloud-run", "Dockerfile"))) return candidate;
+  if (existsSync121(join130(candidate, "packages", "gcp-cloud-run", "Dockerfile"))) return candidate;
   return null;
 }
 function writeCloudBuildConfig(image) {
-  const cfgPath = join128(stateDir(), "cloudrun-cloudbuild.yaml");
-  mkdirSync59(stateDir(), { recursive: true });
-  writeFileSync54(
+  const cfgPath = join130(stateDir(), "cloudrun-cloudbuild.yaml");
+  mkdirSync61(stateDir(), { recursive: true });
+  writeFileSync55(
     cfgPath,
     [
       "steps:",
@@ -200487,7 +201272,7 @@ async function runRenderBatch2(args) {
     failCommand();
   }
   const fps = resolveCloudRunFps(args, projectDir, "render-batch");
-  if (!existsSync119(resolve76(batchPath))) {
+  if (!existsSync121(resolve76(batchPath))) {
     console.error(`[cloudrun render-batch] batch file not found: ${batchPath}`);
     failCommand();
   }
@@ -200554,7 +201339,7 @@ async function runRenderBatch2(args) {
   if (failed.length > 0) failCommand();
 }
 function parseBatchFile2(path2) {
-  const lines = readFileSync81(path2, "utf8").split(/\r?\n/);
+  const lines = readFileSync85(path2, "utf8").split(/\r?\n/);
   const entries2 = [];
   lines.forEach((line2, idx) => {
     const trimmed = line2.trim();
@@ -200579,7 +201364,7 @@ function parseBatchFile2(path2) {
 async function runDestroy2(args) {
   const { getTerraformModuleDir } = await loadCloudRunAdapter();
   const tfDir = getTerraformModuleDir();
-  const state = existsSync119(statePath()) ? JSON.parse(readFileSync81(statePath(), "utf8")) : {};
+  const state = existsSync121(statePath()) ? JSON.parse(readFileSync85(statePath(), "utf8")) : {};
   const project = args.project ?? state.projectId;
   const region = args.region ?? state.region ?? "us-central1";
   const image = args.image ?? "unused:latest";
@@ -200634,8 +201419,8 @@ function resolveAndValidateVariables(args, projectDir) {
     args["variables-file"]
   );
   if (variables && Object.keys(variables).length > 0) {
-    const indexPath2 = join128(projectDir, "index.html");
-    if (existsSync119(indexPath2)) {
+    const indexPath2 = join130(projectDir, "index.html");
+    if (existsSync121(indexPath2)) {
       const issues = validateVariablesAgainstProject(indexPath2, variables);
       reportVariableIssues(issues, {
         strict: Boolean(args["strict-variables"]),
@@ -200881,7 +201666,7 @@ ${HELP2}`);
 });
 
 // src/cloud/detectAspectRatio.ts
-import { readFileSync as readFileSync83 } from "fs";
+import { readFileSync as readFileSync86 } from "fs";
 function extractAttributeNumber(tag, re2) {
   const match = tag.match(re2);
   if (!match) return null;
@@ -200893,7 +201678,7 @@ function extractAttributeNumber(tag, re2) {
 function detectAspectRatioFromHtml(entryHtmlPath) {
   let html;
   try {
-    html = readFileSync83(entryHtmlPath, "utf-8");
+    html = readFileSync86(entryHtmlPath, "utf-8");
   } catch (err) {
     return { kind: "read-error", error: normalizeErrorMessage(err) };
   }
@@ -200996,7 +201781,7 @@ var init_poll = __esm({
 });
 
 // src/cloud/download.ts
-import { createWriteStream as createWriteStream5, mkdirSync as mkdirSync60, unlinkSync as unlinkSync11 } from "fs";
+import { createWriteStream as createWriteStream5, mkdirSync as mkdirSync63, unlinkSync as unlinkSync12 } from "fs";
 import { dirname as dirname58 } from "path";
 async function downloadToFile(url, destPath, options = {}) {
   const fetchImpl = options.fetchImpl ?? fetch;
@@ -201007,7 +201792,7 @@ async function downloadToFile(url, destPath, options = {}) {
   if (!res.body) {
     throw new Error(`Failed to download ${url}: empty response body`);
   }
-  mkdirSync60(dirname58(destPath), { recursive: true });
+  mkdirSync63(dirname58(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;
@@ -201037,7 +201822,7 @@ async function downloadToFile(url, destPath, options = {}) {
     await closeFile(file);
     if (errored) {
       try {
-        unlinkSync11(destPath);
+        unlinkSync12(destPath);
       } catch {
       }
     }
@@ -201487,9 +202272,9 @@ var init_parsing = __esm({
 });
 
 // src/cloud/upload.ts
-import { createHash as createHash20 } from "crypto";
+import { createHash as createHash21 } from "crypto";
 function sha256Hex2(bytes) {
-  return createHash20("sha256").update(bytes).digest("hex");
+  return createHash21("sha256").update(bytes).digest("hex");
 }
 function sleep4(ms) {
   return new Promise((r2) => setTimeout(r2, ms));
@@ -201601,7 +202386,7 @@ __export(render_exports3, {
   validateResolutionFormatCombo: () => validateResolutionFormatCombo
 });
 import { isAbsolute as isAbsolute17, relative as relative27, resolve as resolvePath4 } from "path";
-import { existsSync as existsSync120 } from "fs";
+import { existsSync as existsSync122 } from "fs";
 function parsePollIntervalMs(raw) {
   const n2 = parseNumericFlag(raw, { flag: "--poll-interval", min: 1 });
   return n2 === void 0 ? DEFAULT_POLL_INTERVAL_MS : Math.round(n2 * 1e3);
@@ -201651,7 +202436,7 @@ function resolveAspectRatioForSubmit(project, compositionArg, explicit, asJson)
   const dir = project.dir ?? ".";
   const entryRelative = compositionArg ?? "index.html";
   const entryPath = resolvePath4(dir, entryRelative);
-  if (!existsSync120(entryPath)) {
+  if (!existsSync122(entryPath)) {
     errorBox(
       "Composition not found",
       `Entry file "${entryRelative}" does not exist in ${dir}.`,
@@ -203682,7 +204467,7 @@ var init_parseFigmaRef = __esm({
 });
 
 // ../core/dist/figma/freeze.js
-import { copyFileSync as copyFileSync11, mkdirSync as mkdirSync61, rmSync as rmSync35, statSync as statSync39, writeFileSync as writeFileSync55 } from "fs";
+import { copyFileSync as copyFileSync11, mkdirSync as mkdirSync64, rmSync as rmSync35, statSync as statSync39, writeFileSync as writeFileSync56 } from "fs";
 import { dirname as dirname59 } from "path";
 function exceedsFreezeCap(byteLength) {
   return byteLength > MAX_FREEZE_BYTES;
@@ -203692,14 +204477,14 @@ 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`);
-  mkdirSync61(dirname59(destPath), { recursive: true });
+  mkdirSync64(dirname59(destPath), { recursive: true });
   try {
-    writeFileSync55(destPath, bytes, { flag: "wx" });
+    writeFileSync56(destPath, bytes, { flag: "wx" });
   } catch (err) {
     if (err.code !== "EEXIST")
       throw err;
     rmSync35(destPath);
-    writeFileSync55(destPath, bytes, { flag: "wx" });
+    writeFileSync56(destPath, bytes, { flag: "wx" });
   }
   return bytes.length;
 }
@@ -203712,12 +204497,12 @@ var init_freeze = __esm({
 });
 
 // ../core/dist/figma/jsonl.js
-import { existsSync as existsSync121, readFileSync as readFileSync84 } from "fs";
+import { existsSync as existsSync123, readFileSync as readFileSync87 } from "fs";
 function readJsonlValues(path2) {
-  if (!existsSync121(path2))
+  if (!existsSync123(path2))
     return [];
   const out = [];
-  for (const line2 of readFileSync84(path2, "utf8").split(/\r?\n/)) {
+  for (const line2 of readFileSync87(path2, "utf8").split(/\r?\n/)) {
     const trimmed = line2.trim();
     if (trimmed.length === 0)
       continue;
@@ -203736,16 +204521,16 @@ var init_jsonl = __esm({
 });
 
 // ../core/dist/figma/manifest.js
-import { appendFileSync as appendFileSync2, existsSync as existsSync122, mkdirSync as mkdirSync63, readFileSync as readFileSync85, writeFileSync as writeFileSync56 } from "fs";
-import { join as join129 } from "path";
+import { appendFileSync as appendFileSync2, existsSync as existsSync124, mkdirSync as mkdirSync65, readFileSync as readFileSync88, writeFileSync as writeFileSync57 } from "fs";
+import { join as join131 } from "path";
 function mediaDir(projectDir) {
-  return join129(projectDir, ".media");
+  return join131(projectDir, ".media");
 }
 function manifestPath(projectDir) {
-  return join129(mediaDir(projectDir), MANIFEST_FILE2);
+  return join131(mediaDir(projectDir), MANIFEST_FILE2);
 }
 function typeDirPath(projectDir, type) {
-  return join129(mediaDir(projectDir), TYPE_DIRS[type]);
+  return join131(mediaDir(projectDir), TYPE_DIRS[type]);
 }
 function isFigmaManifestRecord(value) {
   if (typeof value !== "object" || value === null)
@@ -203769,7 +204554,7 @@ function readManifest(projectDir) {
   return readJsonlValues(manifestPath(projectDir)).filter(isFigmaManifestRecord);
 }
 function appendRecord(projectDir, record) {
-  mkdirSync63(typeDirPath(projectDir, record.type), { recursive: true });
+  mkdirSync65(typeDirPath(projectDir, record.type), { recursive: true });
   appendFileSync2(manifestPath(projectDir), JSON.stringify(record) + "\n");
 }
 function findAllByFigmaNode(projectDir, fileKey, nodeId) {
@@ -203777,7 +204562,7 @@ function findAllByFigmaNode(projectDir, fileKey, nodeId) {
 }
 function updateRecord(projectDir, record) {
   const p2 = manifestPath(projectDir);
-  const lines = readFileSync85(p2, "utf8").split(/\r?\n/);
+  const lines = readFileSync88(p2, "utf8").split(/\r?\n/);
   const out = lines.map((line2) => {
     const trimmed = line2.trim();
     if (trimmed.length === 0)
@@ -203790,15 +204575,15 @@ function updateRecord(projectDir, record) {
     }
     return line2;
   });
-  writeFileSync56(p2, out.join("\n"));
+  writeFileSync57(p2, out.join("\n"));
 }
 function nextId(projectDir, type) {
   const re2 = new RegExp(`^${type}_(\\d+)$`);
   let max = 0;
   const p2 = manifestPath(projectDir);
-  if (!existsSync122(p2))
+  if (!existsSync124(p2))
     return `${type}_001`;
-  for (const line2 of readFileSync85(p2, "utf8").split(/\r?\n/)) {
+  for (const line2 of readFileSync88(p2, "utf8").split(/\r?\n/)) {
     const trimmed = line2.trim();
     if (trimmed.length === 0)
       continue;
@@ -203831,13 +204616,13 @@ var init_manifest = __esm({
 });
 
 // ../core/dist/figma/mediaIndex.js
-import { mkdirSync as mkdirSync64, writeFileSync as writeFileSync57 } from "fs";
-import { dirname as dirname60, join as join130 } from "path";
+import { mkdirSync as mkdirSync66, writeFileSync as writeFileSync58 } from "fs";
+import { dirname as dirname60, join as join133 } from "path";
 function isRow(value) {
   return typeof value === "object" && value !== null;
 }
 function indexPath(projectDir) {
-  return join130(mediaDir(projectDir), "index.md");
+  return join133(mediaDir(projectDir), "index.md");
 }
 function pad(str, len2) {
   return String(str ?? "").padEnd(len2);
@@ -203882,8 +204667,8 @@ function regenerateIndex(projectDir) {
   const records = readJsonlValues(manifestPath(projectDir)).filter(isRow);
   const content = generateIndexContent(records);
   const p2 = indexPath(projectDir);
-  mkdirSync64(dirname60(p2), { recursive: true });
-  writeFileSync57(p2, content);
+  mkdirSync66(dirname60(p2), { recursive: true });
+  writeFileSync58(p2, content);
   return content;
 }
 var init_mediaIndex = __esm({
@@ -203948,10 +204733,10 @@ var init_sanitizeSvg = __esm({
 });
 
 // ../core/dist/figma/bindings.js
-import { appendFileSync as appendFileSync3, mkdirSync as mkdirSync65, writeFileSync as writeFileSync58 } from "fs";
-import { join as join131 } from "path";
+import { appendFileSync as appendFileSync3, mkdirSync as mkdirSync67, writeFileSync as writeFileSync59 } from "fs";
+import { join as join134 } from "path";
 function bindingsPath(projectDir) {
-  return join131(mediaDir(projectDir), BINDINGS_FILE);
+  return join134(mediaDir(projectDir), BINDINGS_FILE);
 }
 function isRecord15(value) {
   return typeof value === "object" && value !== null;
@@ -203968,9 +204753,9 @@ function readBindings(projectDir) {
 function upsertBindings(projectDir, records) {
   const incoming = new Set(records.map((r2) => r2.figmaId));
   const survivors = readLines(projectDir).filter((line2) => !(isBindingRecord(line2) && incoming.has(line2.figmaId)));
-  mkdirSync65(mediaDir(projectDir), { recursive: true });
+  mkdirSync67(mediaDir(projectDir), { recursive: true });
   const lines = [...survivors, ...records].map((r2) => JSON.stringify(r2)).join("\n");
-  writeFileSync58(bindingsPath(projectDir), lines.length > 0 ? lines + "\n" : "");
+  writeFileSync59(bindingsPath(projectDir), lines.length > 0 ? lines + "\n" : "");
 }
 var BINDINGS_FILE;
 var init_bindings = __esm({
@@ -204551,8 +205336,8 @@ __export(asset_exports, {
   runAssetImport: () => runAssetImport,
   runAssetImportMany: () => runAssetImportMany
 });
-import { existsSync as existsSync123 } from "fs";
-import { join as join133, relative as relative28 } from "path";
+import { existsSync as existsSync125 } from "fs";
+import { join as join135, relative as relative28 } from "path";
 function gatherAssetRefs(positionals) {
   return positionals.flatMap((r2) => /^https?:/i.test(r2.trim()) ? [r2] : r2.split(",")).map((r2) => r2.trim()).filter((r2) => r2.length > 0);
 }
@@ -204566,7 +205351,7 @@ function requireNodeRef(refInput) {
 }
 function reuseExisting(fileKey, nodeId, opts, version2, deps, description, entity) {
   const existing = findAllByFigmaNode(deps.projectDir, fileKey, nodeId).find(
-    (r2) => r2.provenance.format === opts.format && (r2.provenance.scale ?? 1) === (opts.scale ?? 1) && r2.provenance.version === version2 && existsSync123(join133(deps.projectDir, r2.path))
+    (r2) => r2.provenance.format === opts.format && (r2.provenance.scale ?? 1) === (opts.scale ?? 1) && r2.provenance.version === version2 && existsSync125(join135(deps.projectDir, r2.path))
   );
   if (!existing) return null;
   let record = existing;
@@ -204589,7 +205374,7 @@ async function freezeAndRecord(fileKey, nodeId, url, ext, opts, version2, deps,
     bytes = new TextEncoder().encode(sanitizeSvg(new TextDecoder().decode(bytes)));
   }
   const id = nextId(deps.projectDir, "image");
-  const destAbs = join133(typeDirPath(deps.projectDir, "image"), `${id}.${ext}`);
+  const destAbs = join135(typeDirPath(deps.projectDir, "image"), `${id}.${ext}`);
   freezeBytes(bytes, destAbs);
   const record = {
     id,
@@ -204758,12 +205543,12 @@ __export(tokens_exports, {
   default: () => tokens_default,
   runTokensImport: () => runTokensImport
 });
-import { writeFileSync as writeFileSync59 } from "fs";
-import { join as join134 } from "path";
+import { writeFileSync as writeFileSync60 } from "fs";
+import { join as join136 } from "path";
 async function runTokensImport(refInput, deps) {
   const { fileKey } = parseFigmaRef(refInput);
   const { version: version2 } = await deps.client.fileVersion(fileKey);
-  const sidecarPath = join134(deps.projectDir, "figma-tokens.json");
+  const sidecarPath = join136(deps.projectDir, "figma-tokens.json");
   let vars = null;
   try {
     vars = await deps.client.variables(fileKey);
@@ -204773,7 +205558,7 @@ async function runTokensImport(refInput, deps) {
   if (vars !== null) {
     const out = tokensToVariables(vars, { fileKey, version: version2 });
     upsertBindings(deps.projectDir, out.bindings);
-    writeFileSync59(sidecarPath, JSON.stringify(out.sidecar, null, 2) + "\n");
+    writeFileSync60(sidecarPath, JSON.stringify(out.sidecar, null, 2) + "\n");
     return { mode: "variables", entries: out.entries, sidecarPath };
   }
   const styles = await deps.client.styles(fileKey);
@@ -204787,7 +205572,7 @@ async function runTokensImport(refInput, deps) {
       value: null
     }))
   };
-  writeFileSync59(sidecarPath, JSON.stringify(sidecar, null, 2) + "\n");
+  writeFileSync60(sidecarPath, JSON.stringify(sidecar, null, 2) + "\n");
   return { mode: "styles", entries: [], sidecarPath, styleCount: styles.length };
 }
 var tokens_default;
@@ -204837,8 +205622,8 @@ __export(component_exports, {
   default: () => component_default,
   runComponentImport: () => runComponentImport
 });
-import { existsSync as existsSync124, mkdirSync as mkdirSync66, writeFileSync as writeFileSync60 } from "fs";
-import { join as join135, relative as relative29 } from "path";
+import { existsSync as existsSync126, mkdirSync as mkdirSync68, writeFileSync as writeFileSync61 } from "fs";
+import { join as join137, relative as relative29 } from "path";
 function escapeAttr2(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
@@ -204849,20 +205634,20 @@ 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 = join135(deps.projectDir, "compositions", "components", name);
-  if (existsSync124(componentDir))
+  const componentDir = join137(deps.projectDir, "compositions", "components", name);
+  if (existsSync126(componentDir))
     console.warn(
       `component dir compositions/components/${name} already exists \u2014 overwriting (rename the figma frame for a separate import)`
     );
-  mkdirSync66(componentDir, { recursive: true });
+  mkdirSync68(componentDir, { recursive: true });
   const { html, frozenAssets, failedRasterize } = await rasterizeFallback(
     mapped,
     ref2.fileKey,
     componentDir,
     deps
   );
-  const htmlFile = join135(componentDir, `${name}.html`);
-  writeFileSync60(htmlFile, html + "\n");
+  const htmlFile = join137(componentDir, `${name}.html`);
+  writeFileSync61(htmlFile, html + "\n");
   const registryItem = {
     name,
     type: "hyperframes:component",
@@ -204882,8 +205667,8 @@ async function runComponentImport(refInput, deps) {
       }))
     ]
   };
-  writeFileSync60(
-    join135(componentDir, "registry-item.json"),
+  writeFileSync61(
+    join137(componentDir, "registry-item.json"),
     JSON.stringify(registryItem, null, 2) + "\n"
   );
   return {
@@ -204908,7 +205693,7 @@ async function rasterizeFallback(mapped, fileKey, componentDir, deps) {
       continue;
     }
     frozenAssets.push(asset.record.path);
-    const srcRel = relative29(componentDir, join135(deps.projectDir, asset.record.path)).replaceAll(
+    const srcRel = relative29(componentDir, join137(deps.projectDir, asset.record.path)).replaceAll(
       "\\",
       "/"
     );
@@ -205055,9 +205840,9 @@ __export(autoUpdate_exports, {
   scheduleBackgroundInstall: () => scheduleBackgroundInstall
 });
 import { spawn as spawn16 } from "child_process";
-import { appendFileSync as appendFileSync4, mkdirSync as mkdirSync67, openSync as openSync8 } from "fs";
-import { homedir as homedir21 } from "os";
-import { join as join136 } from "path";
+import { appendFileSync as appendFileSync4, mkdirSync as mkdirSync69, openSync as openSync8 } from "fs";
+import { homedir as homedir23 } from "os";
+import { join as join138 } from "path";
 import { compareVersions as compareVersions3 } from "compare-versions";
 function isAutoInstallDisabled() {
   if (isDevMode()) return true;
@@ -205072,15 +205857,15 @@ function majorOf(version2) {
 }
 function log(line2) {
   try {
-    mkdirSync67(CONFIG_DIR3, { recursive: true, mode: 448 });
+    mkdirSync69(CONFIG_DIR3, { recursive: true, mode: 448 });
     appendFileSync4(LOG_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${line2}
 `, { mode: 384 });
   } catch {
   }
 }
 function launchDetachedInstall(invocation, displayCommand, version2) {
-  mkdirSync67(CONFIG_DIR3, { recursive: true, mode: 448 });
-  const configFile = join136(CONFIG_DIR3, "config.json");
+  mkdirSync69(CONFIG_DIR3, { recursive: true, mode: 448 });
+  const configFile = join138(CONFIG_DIR3, "config.json");
   const nodeScript = `
     const { execFile } = require("node:child_process");
     const { readFileSync, renameSync, writeFileSync } = require("node:fs");
@@ -205201,8 +205986,8 @@ var init_autoUpdate = __esm({
     init_config();
     init_env();
     init_installerDetection();
-    CONFIG_DIR3 = join136(homedir21(), ".hyperframes");
-    LOG_FILE = join136(CONFIG_DIR3, "auto-update.log");
+    CONFIG_DIR3 = join138(homedir23(), ".hyperframes");
+    LOG_FILE = join138(CONFIG_DIR3, "auto-update.log");
     PENDING_TIMEOUT_MS = 10 * 60 * 1e3;
   }
 });
@@ -205393,9 +206178,9 @@ var init_help = __esm({
 init_version();
 init_dist();
 init_runId();
-import { dirname as dirname61, join as join137 } from "path";
+import { dirname as dirname61, join as join139 } from "path";
 import { fileURLToPath as fileURLToPath16 } from "url";
-import { existsSync as existsSync125 } from "fs";
+import { existsSync as existsSync127 } from "fs";
 
 // src/utils/reject-unknown-flags.ts
 var ALWAYS_KNOWN = /* @__PURE__ */ new Set(["help", "h", "version", "v", "json"]);
@@ -205512,8 +206297,8 @@ for (const stream of [process.stdout, process.stderr]) {
 }
 (() => {
   const here = dirname61(fileURLToPath16(import.meta.url));
-  const shader = join137(here, "shaderTransitionWorker.js");
-  if (!process.env.HF_SHADER_WORKER_ENTRY && existsSync125(shader)) {
+  const shader = join139(here, "shaderTransitionWorker.js");
+  if (!process.env.HF_SHADER_WORKER_ENTRY && existsSync127(shader)) {
     process.env.HF_SHADER_WORKER_ENTRY = shader;
   }
 })();
@@ -205525,10 +206310,10 @@ if (rootVersionRequested) {
   process.exit(0);
 }
 try {
-  const { readFileSync: readFileSync86 } = await import("fs");
+  const { readFileSync: readFileSync89 } = await import("fs");
   const { resolve: resolve77 } = await import("path");
   const envPath = resolve77(process.cwd(), ".env");
-  const envContent = readFileSync86(envPath, "utf-8");
+  const envContent = readFileSync89(envPath, "utf-8");
   for (const rawLine of envContent.split("\n")) {
     let line2 = rawLine.trim();
     if (!line2 || line2.startsWith("#")) continue;