hyperframes 0.8.0 → 0.8.1

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.0" : "0.0.0-dev";
+    VERSION = true ? "0.8.1" : "0.0.0-dev";
   }
 });
 
@@ -783,19 +783,19 @@ function __awaiter(thisArg, _arguments, P2, generator) {
       resolve77(value);
     });
   }
-  return new (P2 || (P2 = Promise))(function(resolve77, reject) {
+  return new (P2 || (P2 = Promise))(function(resolve77, reject2) {
     function fulfilled(value) {
       try {
         step(generator.next(value));
       } catch (e3) {
-        reject(e3);
+        reject2(e3);
       }
     }
     function rejected(value) {
       try {
         step(generator["throw"](value));
       } catch (e3) {
-        reject(e3);
+        reject2(e3);
       }
     }
     function step(result) {
@@ -936,7 +936,7 @@ function __asyncGenerator(thisArg, _arguments, generator) {
   }, i2;
   function awaitReturn(f3) {
     return function(v2) {
-      return Promise.resolve(v2).then(f3, reject);
+      return Promise.resolve(v2).then(f3, reject2);
     };
   }
   function verb(n2, f3) {
@@ -957,12 +957,12 @@ function __asyncGenerator(thisArg, _arguments, generator) {
     }
   }
   function step(r2) {
-    r2.value instanceof __await ? Promise.resolve(r2.value.v).then(fulfill, reject) : settle(q2[0][2], r2);
+    r2.value instanceof __await ? Promise.resolve(r2.value.v).then(fulfill, reject2) : settle(q2[0][2], r2);
   }
   function fulfill(value) {
     resume("next", value);
   }
-  function reject(value) {
+  function reject2(value) {
     resume("throw", value);
   }
   function settle(f3, v2) {
@@ -990,15 +990,15 @@ function __asyncValues(o) {
   }, i2);
   function verb(n2) {
     i2[n2] = o[n2] && function(v2) {
-      return new Promise(function(resolve77, reject) {
-        v2 = o[n2](v2), settle(resolve77, reject, v2.done, v2.value);
+      return new Promise(function(resolve77, reject2) {
+        v2 = o[n2](v2), settle(resolve77, reject2, v2.done, v2.value);
       });
     };
   }
-  function settle(resolve77, reject, d2, v2) {
+  function settle(resolve77, reject2, d2, v2) {
     Promise.resolve(v2).then(function(v3) {
       resolve77({ value: v3, done: d2 });
-    }, reject);
+    }, reject2);
   }
 }
 function __makeTemplateObject(cooked, raw) {
@@ -28077,14 +28077,14 @@ var require_lib = __commonJS({
     };
     var mixinPluginNames = Object.keys(mixinPlugins);
     var ExpressionParser = class extends LValParser {
-      checkProto(prop2, isRecord21, sawProto, refExpressionErrors) {
+      checkProto(prop2, isRecord23, sawProto, refExpressionErrors) {
         if (prop2.type === "SpreadElement" || this.isObjectMethod(prop2) || prop2.computed || prop2.shorthand) {
           return sawProto;
         }
         const key2 = prop2.key;
         const name = key2.type === "Identifier" ? key2.name : key2.value;
         if (name === "__proto__") {
-          if (isRecord21) {
+          if (isRecord23) {
             this.raise(Errors.RecordNoProto, key2);
             return true;
           }
@@ -29142,8 +29142,8 @@ var require_lib = __commonJS({
       parseTemplateSubstitution() {
         return this.parseExpression();
       }
-      parseObjectLike(close, isPattern, isRecord21, refExpressionErrors) {
-        if (isRecord21) {
+      parseObjectLike(close, isPattern, isRecord23, refExpressionErrors) {
+        if (isRecord23) {
           this.expectPlugin("recordAndTuple");
         }
         const oldInFSharpPipelineDirectBody = this.state.inFSharpPipelineDirectBody;
@@ -29168,9 +29168,9 @@ var require_lib = __commonJS({
             prop2 = this.parseBindingProperty();
           } else {
             prop2 = this.parsePropertyDefinition(refExpressionErrors);
-            sawProto = this.checkProto(prop2, isRecord21, sawProto, refExpressionErrors);
+            sawProto = this.checkProto(prop2, isRecord23, sawProto, refExpressionErrors);
           }
-          if (isRecord21 && !this.isObjectProperty(prop2) && prop2.type !== "SpreadElement") {
+          if (isRecord23 && !this.isObjectProperty(prop2) && prop2.type !== "SpreadElement") {
             this.raise(Errors.InvalidRecordProperty, prop2);
           }
           if (prop2.shorthand) {
@@ -29183,7 +29183,7 @@ var require_lib = __commonJS({
         let type = "ObjectExpression";
         if (isPattern) {
           type = "ObjectPattern";
-        } else if (isRecord21) {
+        } else if (isRecord23) {
           type = "RecordExpression";
         }
         return this.finishNode(node, type);
@@ -40807,7 +40807,7 @@ function formatAttributes(attributes2, opts) {
   var _a4;
   if (!attributes2)
     return;
-  const encode3 = ((_a4 = opts.encodeEntities) !== null && _a4 !== void 0 ? _a4 : opts.decodeEntities) === false ? replaceQuotes : opts.xmlMode || opts.encodeEntities !== "utf8" ? encodeXML : escapeAttribute;
+  const encode4 = ((_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}="${encode3(value)}"`;
+    return `${key2}="${encode4(value)}"`;
   }).join(" ");
 }
 function render(node, options = {}) {
@@ -65186,9 +65186,9 @@ async function awaitBeforeDeadline(operation, deadline, label2) {
   try {
     return await Promise.race([
       operation,
-      new Promise((_, reject) => {
+      new Promise((_, reject2) => {
         timeout = setTimeout(
-          () => reject(new Error(`beginFrame probe timeout during ${label2}`)),
+          () => reject2(new Error(`beginFrame probe timeout during ${label2}`)),
           remainingMs
         );
       })
@@ -66511,10 +66511,10 @@ async function produceDrawElementFrame(page, width, height, quality = 80, syncTo
     );
   }
   const frameId = ++state.nextId;
-  const encodeResult = new Promise((resolve77, reject) => {
+  const encodeResult = new Promise((resolve77, reject2) => {
     const timer = setTimeout(() => {
       if (state.pending.delete(frameId)) {
-        reject(new Error(`drawElement worker encode timed out (frame ${frameId})`));
+        reject2(new Error(`drawElement worker encode timed out (frame ${frameId})`));
       }
     }, 3e4);
     state.pending.set(frameId, {
@@ -66524,7 +66524,7 @@ async function produceDrawElementFrame(page, width, height, quality = 80, syncTo
       },
       reject: (e3) => {
         clearTimeout(timer);
-        reject(e3);
+        reject2(e3);
       }
     });
   });
@@ -66671,10 +66671,10 @@ async function produceDrawElementFrameBatch(page, times, width, height, quality
   for (let i2 = 0; i2 < times.length; i2++) {
     const frameId = ++state.nextId;
     fids.push(frameId);
-    const p2 = new Promise((resolve77, reject) => {
+    const p2 = new Promise((resolve77, reject2) => {
       const timer = setTimeout(() => {
         if (state.pending.delete(frameId)) {
-          reject(new Error(`drawElement worker encode timed out (frame ${frameId})`));
+          reject2(new Error(`drawElement worker encode timed out (frame ${frameId})`));
         }
       }, 3e4);
       state.pending.set(frameId, {
@@ -66684,7 +66684,7 @@ async function produceDrawElementFrameBatch(page, times, width, height, quality
         },
         reject: (e3) => {
           clearTimeout(timer);
-          reject(e3);
+          reject2(e3);
         }
       });
     });
@@ -66951,10 +66951,10 @@ async function initThreeDProjectionInPage() {
   const toDataUrl = async (url) => {
     const resp = await fetch(url);
     const blob = await resp.blob();
-    return new Promise((resolve77, reject) => {
+    return new Promise((resolve77, reject2) => {
       const r2 = new FileReader();
       r2.onload = () => resolve77(String(r2.result));
-      r2.onerror = () => reject(new Error(`FileReader failed for ${url}`));
+      r2.onerror = () => reject2(new Error(`FileReader failed for ${url}`));
       r2.readAsDataURL(blob);
     });
   };
@@ -67752,7 +67752,7 @@ function getDrawElementVerificationDetails(err) {
 async function decodeDynamicCssBackgroundImages(page) {
   await page.evaluate(async () => {
     const root = globalThis;
-    const decode = root.__hfDecodeDynamicCssBackgroundImages ??= async () => {
+    const decode2 = root.__hfDecodeDynamicCssBackgroundImages ??= async () => {
       const decoded = root.__hf_css_background_decoded ??= /* @__PURE__ */ new Set();
       const urls = [];
       const parseBackgroundUrls = (value) => {
@@ -67813,7 +67813,7 @@ async function decodeDynamicCssBackgroundImages(page) {
         })
       );
     };
-    await decode();
+    await decode2();
   });
 }
 function appendBrowserDiagnostic(session, text2) {
@@ -71599,12 +71599,12 @@ function createFrameReorderBuffer(startFrame, endFrame) {
   let cursor = startFrame;
   let aborted = null;
   const pending = /* @__PURE__ */ new Map();
-  const enqueueAt = (frame, resolve77, reject) => {
+  const enqueueAt = (frame, resolve77, reject2) => {
     const list = pending.get(frame);
     if (list === void 0) {
-      pending.set(frame, [{ resolve: resolve77, reject }]);
+      pending.set(frame, [{ resolve: resolve77, reject: reject2 }]);
     } else {
-      list.push({ resolve: resolve77, reject });
+      list.push({ resolve: resolve77, reject: reject2 });
     }
   };
   const flushAt = (frame) => {
@@ -71613,31 +71613,31 @@ function createFrameReorderBuffer(startFrame, endFrame) {
     pending.delete(frame);
     for (const waiter of list) waiter.resolve();
   };
-  const waitForFrame = (frame) => new Promise((resolve77, reject) => {
+  const waitForFrame = (frame) => new Promise((resolve77, reject2) => {
     if (aborted) {
-      reject(aborted);
+      reject2(aborted);
       return;
     }
     if (frame === cursor) {
       resolve77();
       return;
     }
-    enqueueAt(frame, resolve77, reject);
+    enqueueAt(frame, resolve77, reject2);
   });
   const advanceTo = (frame) => {
     cursor = frame;
     flushAt(frame);
   };
-  const waitForAllDone = () => new Promise((resolve77, reject) => {
+  const waitForAllDone = () => new Promise((resolve77, reject2) => {
     if (aborted) {
-      reject(aborted);
+      reject2(aborted);
       return;
     }
     if (cursor >= endFrame) {
       resolve77();
       return;
     }
-    enqueueAt(endFrame, resolve77, reject);
+    enqueueAt(endFrame, resolve77, reject2);
   });
   const abort = (err) => {
     if (aborted) return;
@@ -72168,7 +72168,7 @@ async function waitForCacheLock(signal) {
   if (signal?.aborted) {
     throw new UrlDownloadError("cancelled", false, "Download cancelled");
   }
-  await new Promise((resolve77, reject) => {
+  await new Promise((resolve77, reject2) => {
     const timeout = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
       resolve77();
@@ -72176,7 +72176,7 @@ async function waitForCacheLock(signal) {
     const onAbort = () => {
       clearTimeout(timeout);
       signal?.removeEventListener("abort", onAbort);
-      reject(new UrlDownloadError("cancelled", false, "Download cancelled"));
+      reject2(new UrlDownloadError("cancelled", false, "Download cancelled"));
     };
     signal?.addEventListener("abort", onAbort, { once: true });
   });
@@ -73092,7 +73092,21 @@ function resolveAliasDisplayName2(alias) {
   if (!slug) return void 0;
   return CANONICAL_FONT_DISPLAY_NAMES2[slug];
 }
-var CANVAS_DIMENSIONS2, VALID_CANVAS_RESOLUTIONS2, COMPOSITION_VARIABLE_TYPES2, FONT_ALIAS_MAP2, FONT_ALIAS_KEYS2, CANONICAL_FONT_DISPLAY_NAMES2, COMPOSITION_ATTRIBUTES3, CANONICAL_AUTHORED_TIMING_ATTRIBUTES3, DERIVED_TIMING_ATTRIBUTES3, LEGACY_TIMING_ATTRIBUTES3;
+function isRecord4(v2) {
+  return typeof v2 === "object" && v2 !== null;
+}
+function isVariableType2(t2) {
+  return typeof t2 === "string" && t2 in DEFAULT_TYPEOF2;
+}
+function isCompositionVariable2(v2) {
+  if (!isRecord4(v2)) return false;
+  if (typeof v2.id !== "string" || typeof v2.label !== "string") return false;
+  if (!isVariableType2(v2.type)) return false;
+  if (typeof v2.default !== DEFAULT_TYPEOF2[v2.type]) return false;
+  if (v2.type === "enum" && !Array.isArray(v2.options)) return false;
+  return true;
+}
+var CANVAS_DIMENSIONS2, VALID_CANVAS_RESOLUTIONS2, COMPOSITION_VARIABLE_TYPES2, FONT_ALIAS_MAP2, FONT_ALIAS_KEYS2, CANONICAL_FONT_DISPLAY_NAMES2, DEFAULT_TYPEOF2, COMPOSITION_ATTRIBUTES3, CANONICAL_AUTHORED_TIMING_ATTRIBUTES3, DERIVED_TIMING_ATTRIBUTES3, LEGACY_TIMING_ATTRIBUTES3;
 var init_composition = __esm({
   "../parsers/dist/composition.js"() {
     "use strict";
@@ -73217,6 +73231,15 @@ var init_composition = __esm({
       lato: "Lato",
       poppins: "Poppins"
     };
+    DEFAULT_TYPEOF2 = {
+      string: "string",
+      number: "number",
+      color: "string",
+      boolean: "boolean",
+      enum: "string",
+      font: "string",
+      image: "string"
+    };
     COMPOSITION_ATTRIBUTES3 = Object.freeze({
       start: "data-start",
       duration: "data-duration",
@@ -77114,7 +77137,7 @@ var require_processor = __commonJS({
           if (options === void 0) {
             options = {};
           }
-          return new Promise(function(resolve77, reject) {
+          return new Promise(function(resolve77, reject2) {
             try {
               var root_1 = _this._root(rule, options);
               Promise.resolve(_this.func(root_1)).then(function(transform) {
@@ -77124,9 +77147,9 @@ var require_processor = __commonJS({
                   rule.selector = string;
                 }
                 return { transform, root: root_1, string };
-              }).then(resolve77, reject);
+              }).then(resolve77, reject2);
             } catch (e3) {
-              reject(e3);
+              reject2(e3);
               return;
             }
           });
@@ -81218,9 +81241,9 @@ function shouldBlockRender(strictErrors, strictAll, totalErrors, totalWarnings)
   return strictErrors && totalErrors > 0 || strictAll && (totalErrors > 0 || totalWarnings > 0);
 }
 function execFileAsync(file, args) {
-  return new Promise((resolvePromise, reject) => {
+  return new Promise((resolvePromise, reject2) => {
     execFile(file, args, { timeout: PROBE_TIMEOUT_MS }, (error, stdout2) => {
-      if (error) reject(error);
+      if (error) reject2(error);
       else resolvePromise(stdout2.toString());
     });
   });
@@ -95513,12 +95536,54 @@ async function fetchItemManifest(name, type, baseUrl = DEFAULT_REGISTRY_URL) {
     throw err;
   }
 }
+function describeCauseChain(err) {
+  const parts = [];
+  let current2 = err;
+  const seen = /* @__PURE__ */ new Set();
+  while (current2 instanceof Error && !seen.has(current2)) {
+    seen.add(current2);
+    const code = current2.code;
+    const text2 = code && !current2.message.includes(String(code)) ? `${current2.message} [${String(code)}]` : current2.message;
+    if (text2 && !parts.includes(text2)) parts.push(text2);
+    current2 = current2.cause;
+  }
+  if (parts.length === 0) return String(err);
+  const [head, ...rest] = parts;
+  return rest.length ? `${head} (${rest.join("; ")})` : head;
+}
+function isRetryableTransport(err) {
+  const text2 = describeCauseChain(err).toLowerCase();
+  if (/certificate|self-signed|self signed|unable to verify|altname|ssl|tls/.test(text2)) {
+    return false;
+  }
+  return /fetch failed|econnreset|econnrefused|etimedout|eai_again|socket hang up|timeouterror|aborted|network/.test(
+    text2
+  );
+}
+async function fetchWithRetry(url, attempts = 3) {
+  let lastErr;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    try {
+      return await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+    } catch (err) {
+      lastErr = err;
+      if (attempt === attempts || !isRetryableTransport(err)) break;
+      await new Promise((resolve77) => setTimeout(resolve77, 150 * attempt));
+    }
+  }
+  throw lastErr;
+}
 async function fetchItemFile(item, file, destPath, baseUrl = DEFAULT_REGISTRY_URL) {
   if (/(^|[/\\])\.\.([/\\]|$)/.test(file.path)) {
     throw new Error(`Unsafe file.path "${file.path}": path segments may not contain "..".`);
   }
   const url = `${baseUrl}/${ITEM_TYPE_DIRS[item.type]}/${item.name}/${file.path}`;
-  const res = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+  let res;
+  try {
+    res = await fetchWithRetry(url);
+  } catch (err) {
+    throw new Error(`File fetch failed: ${url} \u2014 ${describeCauseChain(err)}`, { cause: err });
+  }
   if (!res.ok) {
     throw new Error(`File fetch failed: ${url} \u2014 HTTP ${res.status}`);
   }
@@ -95545,7 +95610,8 @@ __export(resolver_exports, {
   loadAllItems: () => loadAllItems,
   resolveItem: () => resolveItem,
   resolveItemWithDependencies: () => resolveItemWithDependencies,
-  resolveItemsByTag: () => resolveItemsByTag
+  resolveItemsByTag: () => resolveItemsByTag,
+  unreachableRegistryMessage: () => unreachableRegistryMessage
 });
 function defaultWarn(message) {
   process.stderr.write(`hyperframes:registry ${message}
@@ -95585,17 +95651,21 @@ async function resolveItem(name, options = {}) {
   }
   const item = items[items.length - 1];
   if (!item) {
-    throw new Error(`Item "${name}" not found \u2014 registry unreachable or empty.`);
+    throw new Error(unreachableRegistryMessage(name, options.baseUrl));
   }
   return item;
 }
+function unreachableRegistryMessage(name, baseUrl) {
+  const where = baseUrl && !baseUrl.startsWith(DEFAULT_REGISTRY_URL) ? ` Contacted ${baseUrl}, set by this project's hyperframes.json, not the public registry.` : "";
+  return `Item "${name}" not found \u2014 registry unreachable or empty.${where}`;
+}
 async function resolveItemWithDependencies(name, options = {}) {
   const entries2 = await listRegistryItems(void 0, options);
   const entry = entries2.find((e3) => e3.name === name);
   if (!entry) {
     const available = entries2.map((e3) => e3.name).join(", ");
     throw new Error(
-      available.length > 0 ? `Item "${name}" not found in registry. Available: ${available}` : `Item "${name}" not found \u2014 registry unreachable or empty.`
+      available.length > 0 ? `Item "${name}" not found in registry. Available: ${available}` : unreachableRegistryMessage(name, options.baseUrl)
     );
   }
   const entryByName = new Map(entries2.map((e3) => [e3.name, e3]));
@@ -95610,7 +95680,7 @@ async function resolveItemWithDependencies(name, options = {}) {
     if (!registryEntry) {
       const available = entries2.map((e3) => e3.name).join(", ");
       throw new Error(
-        available.length > 0 ? `Dependency "${itemName}" not found in registry. Available: ${available}` : `Dependency "${itemName}" not found \u2014 registry unreachable or empty.`
+        available.length > 0 ? `Dependency "${itemName}" not found in registry. Available: ${available}` : unreachableRegistryMessage(itemName, options.baseUrl)
       );
     }
     const pending = fetchItemManifest(registryEntry.name, registryEntry.type, options.baseUrl);
@@ -95651,10 +95721,108 @@ var init_resolver = __esm({
   }
 });
 
+// ../core/dist/variables.js
+var init_variables = __esm({
+  "../core/dist/variables.js"() {
+    "use strict";
+    init_composition();
+    init_getVariables();
+    init_validateVariables();
+  }
+});
+
+// src/registry/variableDefaults.ts
+function findDeclaration(source) {
+  const at4 = source.indexOf(`${ATTR}=`);
+  if (at4 === -1) return null;
+  const quote = source[at4 + ATTR.length + 1];
+  if (quote !== "'" && quote !== '"') return null;
+  const start = at4 + ATTR.length + 2;
+  const end = source.indexOf(quote, start);
+  if (end === -1) return null;
+  return { start, end, raw: source.slice(start, end) };
+}
+function decode(raw) {
+  return raw.replace(/&#39;/g, "'").replace(/&quot;/g, '"');
+}
+function encode2(json, quote) {
+  return quote === "'" ? json.replace(/'/g, "&#39;") : json.replace(/"/g, "&quot;");
+}
+function optionValues(decl) {
+  return decl.type === "enum" ? decl.options.map((option) => option.value) : null;
+}
+function rejectEnum(decl, value) {
+  const options = optionValues(decl);
+  if (!options) return null;
+  return options.includes(String(value)) ? null : `not one of ${options.join(", ")}`;
+}
+function rejectNumber(decl, value) {
+  if (decl.type !== "number") return null;
+  const n2 = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n2)) return "not a number";
+  if (decl.min !== void 0 && n2 < decl.min) return `below min ${decl.min}`;
+  if (decl.max !== void 0 && n2 > decl.max) return `above max ${decl.max}`;
+  return null;
+}
+function reject(decl, value) {
+  return rejectEnum(decl, value) ?? rejectNumber(decl, value);
+}
+function applyVariableDefaults(source, values) {
+  const ids = Object.keys(values);
+  if (ids.length === 0) return { html: source, applied: [], unknown: [], invalid: [] };
+  const found = findDeclaration(source);
+  if (!found) return { html: source, applied: [], unknown: ids, invalid: [] };
+  let parsed;
+  try {
+    parsed = JSON.parse(decode(found.raw));
+  } catch {
+    return { html: source, applied: [], unknown: ids, invalid: [] };
+  }
+  if (!Array.isArray(parsed)) return { html: source, applied: [], unknown: ids, invalid: [] };
+  const declared = parsed.filter(isCompositionVariable2);
+  if (declared.length !== parsed.length) {
+    return { html: source, applied: [], unknown: ids, invalid: [] };
+  }
+  const applied = [];
+  const invalid = [];
+  const byId = new Map(declared.map((decl) => [decl.id, decl]));
+  const updated = /* @__PURE__ */ new Map();
+  for (const [id, value] of Object.entries(values)) {
+    const decl = byId.get(id);
+    if (!decl) continue;
+    const reason = reject(decl, value);
+    if (reason) {
+      invalid.push({ id, reason });
+      continue;
+    }
+    updated.set(id, decl.type === "number" ? Number(value) : String(value));
+    applied.push(id);
+  }
+  const unknown = ids.filter((id) => !byId.has(id));
+  if (applied.length === 0) return { html: source, applied, unknown, invalid };
+  const quote = source[found.start - 1];
+  const body = declared.map((decl) => {
+    const next = updated.has(decl.id) ? { ...decl, default: updated.get(decl.id) } : decl;
+    return `    ${JSON.stringify(next)}`;
+  }).join(",\n");
+  const rewritten = encode2(`[
+${body}
+  ]`, quote);
+  const html = source.slice(0, found.start) + rewritten + source.slice(found.end);
+  return { html, applied, unknown, invalid };
+}
+var ATTR;
+var init_variableDefaults = __esm({
+  "src/registry/variableDefaults.ts"() {
+    "use strict";
+    init_variables();
+    ATTR = "data-composition-variables";
+  }
+});
+
 // src/registry/installer.ts
 var installer_exports = {};
 __export(installer_exports, {
-  assertSafeTarget: () => assertSafeTarget,
   hasLocalEdits: () => hasLocalEdits,
   installItem: () => installItem
 });
@@ -95705,6 +95873,9 @@ function assertSafeTarget(destDir, target) {
     throw new Error(`Unsafe target "${target}": resolves outside destDir ${destDir}.`);
   }
 }
+function isInstalledComponentSnippet(item, file) {
+  return item.type === "hyperframes:component" && file.target.toLowerCase().endsWith(".html");
+}
 function isInstalledRegistryBlockComposition(item, file) {
   return item.type === "hyperframes:block" && file.type === "hyperframes:composition" && file.target.toLowerCase().endsWith(".html");
 }
@@ -95715,6 +95886,30 @@ function addRegistryItemMarker(source, item) {
   return `<!-- hyperframes-registry-item: ${item.name} -->
 ${source}`;
 }
+async function installOneFile(item, file, destDir, baseUrl, record, options) {
+  const destPath = resolve11(destDir, file.target);
+  if (!options.force && existsSync23(destPath) && hasLocalEdits(record, file.target, readFileSync13(destPath))) {
+    return { destPath, target: file.target, preserved: true, hash: null, vars: null };
+  }
+  await fetchItemFile(item, file, destPath, baseUrl);
+  if (isInstalledRegistryBlockComposition(item, file)) {
+    const source = readFileSync13(destPath, "utf-8");
+    writeFileSync9(destPath, addRegistryItemMarker(source, item), "utf-8");
+  }
+  let vars = null;
+  if (options.variableValues && isInstalledComponentSnippet(item, file)) {
+    const source = readFileSync13(destPath, "utf-8");
+    vars = applyVariableDefaults(source, options.variableValues);
+    if (vars.applied.length > 0) writeFileSync9(destPath, vars.html, "utf-8");
+  }
+  return {
+    destPath,
+    target: file.target,
+    preserved: false,
+    hash: digest(readFileSync13(destPath)),
+    vars
+  };
+}
 async function installItem(item, options) {
   const baseUrl = options.baseUrl ?? DEFAULT_REGISTRY_URL;
   const destDir = resolve11(options.destDir);
@@ -95723,23 +95918,9 @@ async function installItem(item, options) {
   }
   const record = readInstallRecord(destDir);
   const outcomes = await Promise.all(
-    item.files.map(async (file) => {
-      const destPath = resolve11(destDir, file.target);
-      if (!options.force && existsSync23(destPath) && hasLocalEdits(record, file.target, readFileSync13(destPath))) {
-        return { destPath, target: file.target, preserved: true, hash: null };
-      }
-      await fetchItemFile(item, file, destPath, baseUrl);
-      if (isInstalledRegistryBlockComposition(item, file)) {
-        const source = readFileSync13(destPath, "utf-8");
-        writeFileSync9(destPath, addRegistryItemMarker(source, item), "utf-8");
-      }
-      return {
-        destPath,
-        target: file.target,
-        preserved: false,
-        hash: digest(readFileSync13(destPath))
-      };
-    })
+    item.files.map(
+      (file) => installOneFile(item, file, destDir, baseUrl, record, options)
+    )
   );
   const written = outcomes.filter((o) => !o.preserved).map((o) => o.destPath);
   const preserved = outcomes.filter((o) => o.preserved).map((o) => o.destPath);
@@ -95749,13 +95930,26 @@ async function installItem(item, options) {
     }
     writeInstallRecord(destDir, record);
   }
-  return { written, preserved };
+  const vars = outcomes.map((o) => o.vars).filter((v2) => v2 !== null);
+  return {
+    written,
+    preserved,
+    variablesApplied: vars.flatMap((v2) => v2.applied),
+    // An id nothing declared is only genuinely unknown once every file has had
+    // a chance at it, so intersect rather than union.
+    variablesUnknown: vars.length ? vars.reduce(
+      (acc, v2) => acc.filter((id) => v2.unknown.includes(id)),
+      vars[0].unknown
+    ) : [],
+    variablesInvalid: vars.flatMap((v2) => v2.invalid)
+  };
 }
 var INSTALL_RECORD;
 var init_installer = __esm({
   "src/registry/installer.ts"() {
     "use strict";
     init_remote();
+    init_variableDefaults();
     INSTALL_RECORD = "hyperframes.lock.json";
   }
 });
@@ -96105,6 +96299,7 @@ __export(ffmpeg_exports, {
   detectH264EncoderMode: () => detectH264EncoderMode,
   findFFmpeg: () => findFFmpeg,
   findFFprobe: () => findFFprobe,
+  getFFmpegInstallCommand: () => getFFmpegInstallCommand,
   getFFmpegInstallHint: () => getFFmpegInstallHint,
   resolveH264EncoderMode: () => resolveH264EncoderMode
 });
@@ -96129,26 +96324,40 @@ function findFFmpeg() {
 function findFFprobe() {
   return findFfBinary("ffprobe", { configuredMustExist: true });
 }
-function getFFmpegInstallHint() {
+function getFFmpegInstallCommand() {
   switch (process.platform) {
     case "darwin":
       return "brew install ffmpeg";
     case "linux": {
       const distro = detectLinuxDistro();
+      if (distro.family === "unknown") return void 0;
       return ffmpegInstallCommand(distro.family);
     }
+    // winget ships with Windows 10 1809+ and Windows 11. Machines without it
+    // still get the manual download route from the hint below.
     case "win32":
-      return "Download the 64-bit Windows build from https://ffmpeg.org/download.html#build-windows and add its bin/ directory to PATH.";
+      return "winget install --id Gyan.FFmpeg -e";
     default:
-      return "https://ffmpeg.org/download.html";
+      return void 0;
+  }
+}
+function getFFmpegInstallHint() {
+  const command2 = getFFmpegInstallCommand();
+  if (command2 && process.platform === "win32") {
+    return `${command2}, or download the 64-bit build from ${FFMPEG_DOWNLOAD_URL}#build-windows and add its bin/ directory to PATH.`;
   }
+  if (command2) return command2;
+  if (process.platform === "linux") return ffmpegInstallCommand("unknown");
+  return FFMPEG_DOWNLOAD_URL;
 }
+var FFMPEG_DOWNLOAD_URL;
 var init_ffmpeg = __esm({
   "src/browser/ffmpeg.ts"() {
     "use strict";
     init_ffBinaries();
     init_linuxDeps();
     init_ffBinaries();
+    FFMPEG_DOWNLOAD_URL = "https://ffmpeg.org/download.html";
   }
 });
 
@@ -96183,7 +96392,7 @@ function downloadFile(url, dest, options = {}) {
   const tmp = `${dest}.${process.pid}.${randomUUID6()}.tmp`;
   const timeoutMs = options.timeoutMs ?? DEFAULT_DOWNLOAD_TIMEOUT_MS;
   const maxBytes = options.maxBytes;
-  return new Promise((resolve77, reject) => {
+  return new Promise((resolve77, reject2) => {
     const follow = (u, hops = 0) => {
       let activeResponse;
       let responsePipelineStarted = false;
@@ -96198,7 +96407,7 @@ function downloadFile(url, dest, options = {}) {
               if (hops >= MAX_REDIRECTS2) {
                 res.resume();
                 removePartialFile(tmp);
-                reject(
+                reject2(
                   new Error(`Download failed: more than ${MAX_REDIRECTS2} redirects from ${url}`)
                 );
                 return;
@@ -96208,7 +96417,7 @@ function downloadFile(url, dest, options = {}) {
                 follow(redirectTarget(location, u), hops + 1);
               } catch (error) {
                 removePartialFile(tmp);
-                reject(error);
+                reject2(error);
               }
               return;
             }
@@ -96216,7 +96425,7 @@ function downloadFile(url, dest, options = {}) {
           if (res.statusCode !== 200) {
             res.resume();
             removePartialFile(tmp);
-            reject(new Error(`Download failed: HTTP ${res.statusCode}`));
+            reject2(new Error(`Download failed: HTTP ${res.statusCode}`));
             return;
           }
           const file = createWriteStream2(tmp);
@@ -96227,12 +96436,12 @@ function downloadFile(url, dest, options = {}) {
             resolve77();
           }).catch((err) => {
             removePartialFile(tmp);
-            reject(requestError ?? err);
+            reject2(requestError ?? err);
           });
         });
       } catch (error) {
         removePartialFile(tmp);
-        reject(error);
+        reject2(error);
         return;
       }
       request.setTimeout(timeoutMs, () => {
@@ -96245,7 +96454,7 @@ function downloadFile(url, dest, options = {}) {
           return;
         }
         removePartialFile(tmp);
-        reject(err);
+        reject2(err);
       });
     };
     follow(url);
@@ -98202,7 +98411,7 @@ function hasGit2() {
 }
 function spawnNpx(args, opts = {}) {
   const npx = buildNpxCommand(args);
-  return new Promise((resolve77, reject) => {
+  return new Promise((resolve77, reject2) => {
     const child = spawn6(npx.command, npx.args, {
       // Route the child's stdout to the parent's stderr (fd 2), keeping stdin
       // inherited. `skills update --json` runs this installer before printing its
@@ -98233,10 +98442,10 @@ function spawnNpx(args, opts = {}) {
     child.on("close", (code, signal) => {
       if (code === 0) resolve77();
       else if (signal === "SIGINT" || code === 130)
-        reject(new CliResultSignal({ exitCode: 0, kind: "success", presented: true }));
-      else reject(new Error(`npx ${args.join(" ")} exited with code ${code}`));
+        reject2(new CliResultSignal({ exitCode: 0, kind: "success", presented: true }));
+      else reject2(new Error(`npx ${args.join(" ")} exited with code ${code}`));
     });
-    child.on("error", reject);
+    child.on("error", reject2);
   });
 }
 function skillSelectionArgs(selection) {
@@ -101513,8 +101722,8 @@ async function waitForProxy(promise, timeoutMs = DEFAULT_PROXY_WAIT_TIMEOUT_MS)
   try {
     return await Promise.race([
       promise,
-      new Promise((_resolve, reject) => {
-        timer = setTimeout(() => reject(new ProxyWaitTimeoutError(timeoutMs)), timeoutMs);
+      new Promise((_resolve, reject2) => {
+        timer = setTimeout(() => reject2(new ProxyWaitTimeoutError(timeoutMs)), timeoutMs);
         timer.unref();
       })
     ]);
@@ -101557,14 +101766,14 @@ function getCanonicalProxyCachePath(source, variant) {
   );
 }
 function acquireSlot() {
-  return new Promise((resolveSlot, reject) => {
+  return new Promise((resolveSlot, reject2) => {
     const tryAcquire = () => {
       if (activeTranscodes < MAX_CONCURRENT_TRANSCODES) {
         activeTranscodes++;
         resolveSlot();
       } else {
         if (waitQueue.length >= MAX_QUEUED_TRANSCODES) {
-          reject(new ProxyCapacityError());
+          reject2(new ProxyCapacityError());
           return;
         }
         waitQueue.push(tryAcquire);
@@ -101641,7 +101850,7 @@ async function runFfmpeg2(sourcePath, outputPath, variant) {
     evenScale,
     `format=${pixelFormat}`
   ].join(",") : [evenScale, `format=${pixelFormat}`].join(",");
-  return new Promise((resolvePromise, reject) => {
+  return new Promise((resolvePromise, reject2) => {
     const commonArgs = ["-y", "-i", sourcePath, "-vf", videoFilter];
     const h264Args = [
       "-c:v",
@@ -101704,13 +101913,13 @@ async function runFfmpeg2(sourcePath, outputPath, variant) {
       stderrTail = (stderrTail + chunk.toString()).slice(-STDERR_TAIL_MAX_CHARS);
     });
     proc.on("error", (err) => {
-      reject(new ProxyTranscodeError(`failed to spawn ffmpeg: ${err.message}`, null, stderrTail));
+      reject2(new ProxyTranscodeError(`failed to spawn ffmpeg: ${err.message}`, null, stderrTail));
     });
     proc.on("close", (code, signal) => {
       if (code === 0) {
         resolvePromise();
       } else if (signal) {
-        reject(
+        reject2(
           new ProxyTranscodeError(
             `ffmpeg killed by ${signal} (timeout ${TRANSCODE_TIMEOUT_MS}ms or external kill)`,
             null,
@@ -101718,7 +101927,7 @@ async function runFfmpeg2(sourcePath, outputPath, variant) {
           )
         );
       } else {
-        reject(new ProxyTranscodeError(`ffmpeg exited with code ${code}`, code, stderrTail));
+        reject2(new ProxyTranscodeError(`ffmpeg exited with code ${code}`, code, stderrTail));
       }
     });
   });
@@ -108949,7 +109158,7 @@ function computePeaks(floats, count) {
   return peaks.map((p2) => p2 / maxPeak);
 }
 function decodeAudioPeaks(audioPath) {
-  return new Promise((resolvePromise, reject) => {
+  return new Promise((resolvePromise, reject2) => {
     const proc = spawn9(
       findFfBinary("ffmpeg") ?? "ffmpeg",
       [
@@ -108972,19 +109181,19 @@ function decodeAudioPeaks(audioPath) {
     proc.stdout?.on("data", (chunk) => chunks.push(chunk));
     proc.on("close", (code) => {
       if (code !== 0 && chunks.length === 0) {
-        reject(new Error(`ffmpeg exited with code ${code}`));
+        reject2(new Error(`ffmpeg exited with code ${code}`));
         return;
       }
       const buf = Buffer.concat(chunks);
       const numSamples = Math.floor(buf.length / 4);
       if (numSamples === 0) {
-        reject(new Error("ffmpeg produced no audio samples"));
+        reject2(new Error("ffmpeg produced no audio samples"));
         return;
       }
       const ab = buf.buffer.slice(buf.byteOffset, buf.byteOffset + numSamples * 4);
       resolvePromise(computePeaks(new Float32Array(ab), PEAK_COUNT));
     });
-    proc.on("error", reject);
+    proc.on("error", reject2);
   });
 }
 async function generateWaveformCache(projectDir, assetPath) {
@@ -112434,7 +112643,7 @@ function registerWaveformRoutes(api, adapter2) {
     return c3.json({ peaks });
   });
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null;
 }
 function collectFontsFromDir(dir) {
@@ -112458,10 +112667,10 @@ function listInstalledFontFamilies() {
   return cachedFonts;
 }
 function parseGoogleFontMetadata(value) {
-  if (!isRecord4(value) || !Array.isArray(value.familyMetadataList)) return [];
+  if (!isRecord5(value) || !Array.isArray(value.familyMetadataList)) return [];
   const families = [];
   for (const entry of value.familyMetadataList) {
-    if (!isRecord4(entry) || typeof entry.family !== "string") continue;
+    if (!isRecord5(entry) || typeof entry.family !== "string") continue;
     families.push(entry.family);
   }
   return families;
@@ -113197,10 +113406,10 @@ var init_dist9 = __esm({
         let entry = this.entries.get(key2);
         if (!entry) {
           let resolve510;
-          let reject;
+          let reject2;
           const promise = new Promise((resolvePromise, rejectPromise) => {
             resolve510 = resolvePromise;
-            reject = rejectPromise;
+            reject2 = rejectPromise;
           });
           entry = {
             key: key2,
@@ -113210,7 +113419,7 @@ var init_dist9 = __esm({
             work,
             promise,
             resolve: resolve510,
-            reject
+            reject: reject2
           };
           this.entries.set(key2, entry);
           this.queue.push(entry);
@@ -113223,7 +113432,7 @@ var init_dist9 = __esm({
         return /* @__PURE__ */ new Set([...this.entries.keys(), ...[...this.activeEntries].map((entry) => entry.key)]);
       }
       lease(entry, signal) {
-        return new Promise((resolve510, reject) => {
+        return new Promise((resolve510, reject2) => {
           let released = false;
           const release4 = () => {
             if (released) return;
@@ -113241,7 +113450,7 @@ var init_dist9 = __esm({
           };
           const onAbort = () => {
             release4();
-            reject(new DOMException("Aborted", "AbortError"));
+            reject2(new DOMException("Aborted", "AbortError"));
           };
           signal.addEventListener("abort", onAbort, { once: true });
           entry.promise.then(
@@ -113251,7 +113460,7 @@ var init_dist9 = __esm({
             },
             (reason) => {
               release4();
-              reject(reason);
+              reject2(reason);
             }
           );
         });
@@ -117435,10 +117644,10 @@ var require_compress_binding = __commonJS({
           });
         } else {
           if (readAsync) {
-            return new Promise(function(resolve77, reject) {
+            return new Promise(function(resolve77, reject2) {
               readAsync(wasmBinaryFile, function(response) {
                 resolve77(new Uint8Array(response));
-              }, reject);
+              }, reject2);
             });
           }
         }
@@ -118991,10 +119200,10 @@ var require_decompress_binding = __commonJS({
           });
         } else {
           if (readAsync) {
-            return new Promise(function(resolve77, reject) {
+            return new Promise(function(resolve77, reject2) {
               readAsync(wasmBinaryFile, function(response) {
                 resolve77(new Uint8Array(response));
-              }, reject);
+              }, reject2);
             });
           }
         }
@@ -120596,14 +120805,14 @@ function throwIfCallerAborted(signal) {
 async function waitForFontFetchRetry(delayMs, signal) {
   throwIfCallerAborted(signal);
   if (delayMs <= 0) return;
-  await new Promise((resolve77, reject) => {
+  await new Promise((resolve77, reject2) => {
     const timeout = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
       resolve77();
     }, delayMs);
     const onAbort = () => {
       clearTimeout(timeout);
-      reject(signal ? callerAbortReason(signal) : new DOMException("Cancelled", "AbortError"));
+      reject2(signal ? callerAbortReason(signal) : new DOMException("Cancelled", "AbortError"));
     };
     signal?.addEventListener("abort", onAbort, { once: true });
     if (signal?.aborted) onAbort();
@@ -125334,10 +125543,10 @@ function resolveDeStallTimeoutMs() {
   return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_DE_STALL_MS;
 }
 function raceAgainstStall(promise, deadlineMs, message, signal) {
-  return new Promise((resolve77, reject) => {
+  return new Promise((resolve77, reject2) => {
     const timer = setTimeout(
       () => {
-        reject(
+        reject2(
           new Error(
             signal?.aborted ? "[Render] Sequential drawElement capture aborted while a capture call was in flight." : message
           )
@@ -125352,7 +125561,7 @@ function raceAgainstStall(promise, deadlineMs, message, signal) {
       },
       (error) => {
         clearTimeout(timer);
-        reject(error);
+        reject2(error);
       }
     );
   });
@@ -126233,8 +126442,8 @@ async function createShaderTransitionWorkerPool(opts) {
       if (terminated) {
         throw new Error("shader-blend pool already terminated");
       }
-      return new Promise((resolve77, reject) => {
-        const task = traceEnabled ? { req, resolve: resolve77, reject, enqueuedAtMs: Date.now(), traceId: ++nextTaskId } : { req, resolve: resolve77, reject };
+      return new Promise((resolve77, reject2) => {
+        const task = traceEnabled ? { req, resolve: resolve77, reject: reject2, enqueuedAtMs: Date.now(), traceId: ++nextTaskId } : { req, resolve: resolve77, reject: reject2 };
         const idle = slots.find((s2) => !s2.busy && !s2.dead);
         if (idle) {
           queue.unshift(task);
@@ -126242,7 +126451,7 @@ async function createShaderTransitionWorkerPool(opts) {
         } else if (slots.some((s2) => !s2.dead)) {
           queue.push(task);
         } else {
-          reject(new Error("shader-blend pool has no live workers"));
+          reject2(new Error("shader-blend pool has no live workers"));
         }
       });
     },
@@ -130135,7 +130344,7 @@ async function startHealthWorker(options = {}) {
     stdout: false,
     stderr: false
   });
-  await new Promise((resolve77, reject) => {
+  await new Promise((resolve77, reject2) => {
     const onMessage = (msg) => {
       if (msg?.type === "listening") {
         worker.off("error", onError);
@@ -130144,13 +130353,13 @@ async function startHealthWorker(options = {}) {
       } else if (msg?.type === "listen-error") {
         worker.off("error", onError);
         worker.off("message", onMessage);
-        reject(new Error(`[healthWorker] failed to bind port ${port}: ${msg.error}`));
+        reject2(new Error(`[healthWorker] failed to bind port ${port}: ${msg.error}`));
       }
     };
     const onError = (err) => {
       worker.off("error", onError);
       worker.off("message", onMessage);
-      reject(err);
+      reject2(err);
     };
     worker.on("message", onMessage);
     worker.on("error", onError);
@@ -130885,7 +131094,7 @@ var init_parityContract2 = __esm({
 function getDistributedRenderCapabilities() {
   return DISTRIBUTED_RENDER_CAPABILITIES;
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function protocolMatches(descriptor, expected) {
@@ -130897,7 +131106,7 @@ function capabilitiesAccept(capabilities, protocol) {
   );
 }
 function readPlanProtocol(planJson, capabilities = DISTRIBUTED_RENDER_CAPABILITIES.roles.chunk) {
-  if (!isRecord5(planJson)) {
+  if (!isRecord6(planJson)) {
     throw new PlanProtocolUnsupportedError("plan.json must contain a JSON object");
   }
   if (!Object.prototype.hasOwnProperty.call(planJson, "protocol")) {
@@ -130909,7 +131118,7 @@ function readPlanProtocol(planJson, capabilities = DISTRIBUTED_RENDER_CAPABILITI
     return PLAN_PROTOCOL_V1;
   }
   const descriptor = planJson.protocol;
-  if (!isRecord5(descriptor)) {
+  if (!isRecord6(descriptor)) {
     throw new PlanProtocolUnsupportedError("plan.json protocol descriptor must be an object");
   }
   for (const field of ["schemaVersion", "artifactLayout", "hashSchema"]) {
@@ -132239,7 +132448,7 @@ function canFallbackToCopy(error) {
   const code = error.code;
   return code === "EXDEV" || code === "EPERM" || code === "EACCES" || code === "ENOTSUP";
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function manifestDigests(manifestBytes) {
@@ -132249,11 +132458,11 @@ function manifestDigests(manifestBytes) {
   } catch {
     throw new PlanV2IntegrityError("manifest publisher received invalid JSON");
   }
-  if (!isRecord6(value) || !Array.isArray(value.artifacts)) {
+  if (!isRecord7(value) || !Array.isArray(value.artifacts)) {
     throw new PlanV2IntegrityError("manifest publisher requires an artifacts array");
   }
   return value.artifacts.map((artifact, index) => {
-    if (!isRecord6(artifact)) {
+    if (!isRecord7(artifact)) {
       throw new PlanV2IntegrityError(`manifest artifacts[${index}] must be an object`);
     }
     return assertPlanV2Sha256(artifact.sha256, `manifest artifacts[${index}].sha256`);
@@ -132345,7 +132554,7 @@ import {
 import { createHash as createHash17 } from "crypto";
 import { tmpdir as tmpdir11 } from "os";
 import { dirname as dirname30, isAbsolute as isAbsolute13, join as join71, relative as relative15, resolve as resolve37, sep as sep11 } from "path";
-function isRecord7(value) {
+function isRecord8(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function isSha256(value) {
@@ -132517,7 +132726,7 @@ function parseChunkSlices(value) {
   const indexes = /* @__PURE__ */ new Set();
   return value.map((chunk, position) => {
     const field = `meta/chunks.json[${position}]`;
-    if (!isRecord7(chunk)) throw new PlanV2IntegrityError(`${field} must be an object`);
+    if (!isRecord8(chunk)) throw new PlanV2IntegrityError(`${field} must be an object`);
     const index = readNonNegativeInteger2(chunk.index, `${field}.index`);
     const startFrame = readNonNegativeInteger2(chunk.startFrame, `${field}.startFrame`);
     const endFrame = readPositiveInteger2(chunk.endFrame, `${field}.endFrame`);
@@ -132591,7 +132800,7 @@ function buildPlanV2Publication(executionPlanDir) {
     throw new PlanV2IntegrityError(`execution plan is missing plan.json: ${executionPlanPath}`);
   }
   const executionPlanValue = readJsonFile(executionPlanPath, "execution plan.json");
-  if (!isRecord7(executionPlanValue)) {
+  if (!isRecord8(executionPlanValue)) {
     throw new PlanV2IntegrityError("execution plan.json must be an object");
   }
   const executionPlan = executionPlanValue;
@@ -132609,7 +132818,7 @@ function buildPlanV2Publication(executionPlanDir) {
   const artifacts = [];
   const blobs = /* @__PURE__ */ new Map();
   const dimensions = executionPlan.dimensions;
-  if (!isRecord7(dimensions)) {
+  if (!isRecord8(dimensions)) {
     throw new PlanV2IntegrityError("execution plan.json.dimensions must be an object");
   }
   validateExtractionCacheCompleteSentinels(executionPlanDir);
@@ -132792,7 +133001,7 @@ function readDistributedFormat(value) {
   return value;
 }
 function parseArtifact(value, index) {
-  if (!isRecord7(value)) throw new PlanV2IntegrityError(`artifacts[${index}] must be an object`);
+  if (!isRecord8(value)) throw new PlanV2IntegrityError(`artifacts[${index}] must be an object`);
   const path2 = readString2(value.path, `artifacts[${index}].path`);
   assertSafeRelativePath(path2);
   if (!isSha256(value.sha256)) {
@@ -132822,8 +133031,8 @@ function parseArtifact(value, index) {
   };
 }
 function parsePlanV2Manifest(value) {
-  if (!isRecord7(value)) throw new PlanV2IntegrityError("manifest must be an object");
-  if (!isRecord7(value.protocol) || value.protocol.schemaVersion !== PLAN_PROTOCOL_V2.schemaVersion || value.protocol.artifactLayout !== PLAN_PROTOCOL_V2.artifactLayout || value.protocol.hashSchema !== PLAN_PROTOCOL_V2.hashSchema) {
+  if (!isRecord8(value)) throw new PlanV2IntegrityError("manifest must be an object");
+  if (!isRecord8(value.protocol) || value.protocol.schemaVersion !== PLAN_PROTOCOL_V2.schemaVersion || value.protocol.artifactLayout !== PLAN_PROTOCOL_V2.artifactLayout || value.protocol.hashSchema !== PLAN_PROTOCOL_V2.hashSchema) {
     throw new PlanV2IntegrityError("manifest protocol is not the supported v2 descriptor");
   }
   if (!isSha256(value.planHash) || !isSha256(value.sourcePlanV1Hash)) {
@@ -132839,7 +133048,7 @@ function parsePlanV2Manifest(value) {
   }
   if (!paths.has("plan.json"))
     throw new PlanV2IntegrityError("manifest must include the local execution plan.json artifact");
-  if (!isRecord7(value.limitations) || value.limitations.videoDependencyMode !== "exact-rendered-frames" && value.limitations.videoDependencyMode !== "full-source-pack") {
+  if (!isRecord8(value.limitations) || value.limitations.videoDependencyMode !== "exact-rendered-frames" && value.limitations.videoDependencyMode !== "full-source-pack") {
     throw new PlanV2IntegrityError("unsupported video dependency mode");
   }
   const parsed = {
@@ -132949,7 +133158,7 @@ function validatePlanV2MaterializedTarget(planDir, expectedTarget) {
   const markerPath = join71(planDir, PLAN_V2_MATERIALIZATION_MARKER);
   if (!existsSync65(markerPath)) return null;
   const marker = readJsonFile(markerPath, "materialization marker");
-  if (!isRecord7(marker) || !isRecord7(marker.manifest) || !isRecord7(marker.target)) {
+  if (!isRecord8(marker) || !isRecord8(marker.manifest) || !isRecord8(marker.target)) {
     throw new PlanV2IntegrityError("malformed materialization marker");
   }
   const target = marker.target;
@@ -134546,15 +134755,15 @@ ${decoder.getStderr().slice(-400)}`
   return processed;
 }
 function waitForExit(proc, label2, getStderr) {
-  return new Promise((resolve77, reject) => {
-    proc.on("error", reject);
+  return new Promise((resolve77, reject2) => {
+    proc.on("error", reject2);
     proc.on("exit", (code, signal) => {
       if (code === 0 && !signal) {
         resolve77();
         return;
       }
       const cause = signal ? `killed by ${signal}` : `exited with code ${code}`;
-      reject(new Error(`${label2} ${cause}: ${getStderr().slice(-400)}`));
+      reject2(new Error(`${label2} ${cause}: ${getStderr().slice(-400)}`));
     });
   });
 }
@@ -134579,6 +134788,234 @@ var init_pipeline = __esm({
   }
 });
 
+// src/browser/preflight.ts
+var preflight_exports = {};
+__export(preflight_exports, {
+  checkDisk: () => checkDisk,
+  parseToolVersion: () => parseToolVersion,
+  runEnvironmentChecks: () => runEnvironmentChecks
+});
+import { execFileSync as execFileSync8 } from "child_process";
+import { existsSync as existsSync69 } from "fs";
+import { platform as platform7 } from "os";
+function parseToolVersion(raw) {
+  const m2 = raw.match(/(ffmpeg|ffprobe)\s+version\s+([\d][\d.\-\w]*)/i);
+  return m2 ? `${m2[1]} ${m2[2]}` : raw.trim();
+}
+function configuredMissingDetail(envName) {
+  const configured = process.env[envName]?.trim();
+  if (!configured || existsSync69(configured)) return void 0;
+  return `Configured path does not exist: ${envName}="${configured}"`;
+}
+function readToolVersion(binaryPath) {
+  try {
+    const raw = execFileSync8(binaryPath, ["-version"], { encoding: "utf-8", timeout: 5e3 }).split("\n")[0] ?? "";
+    const version2 = parseToolVersion(raw);
+    return { ok: true, detail: version2 ? `${version2} at ${binaryPath}` : binaryPath };
+  } catch (error) {
+    const status = typeof error === "object" && error !== null && "status" in error ? error.status : void 0;
+    const exitDetail = typeof status === "number" ? ` (exit code ${status})` : "";
+    return {
+      ok: false,
+      detail: `Failed to run "${binaryPath}" -version${exitDetail}.`
+    };
+  }
+}
+function checkFFmpeg() {
+  const missingConfigured = configuredMissingDetail(FFMPEG_PATH_ENV);
+  if (missingConfigured) {
+    return {
+      name: "FFmpeg",
+      ok: false,
+      level: "error",
+      title: "FFmpeg not found",
+      detail: missingConfigured,
+      hint: getFFmpegInstallHint()
+    };
+  }
+  const path2 = findFFmpeg();
+  if (path2) {
+    const version2 = readToolVersion(path2);
+    if (!version2.ok) {
+      return {
+        name: "FFmpeg",
+        ok: false,
+        level: "error",
+        title: "FFmpeg cannot start",
+        detail: version2.detail,
+        hint: "Install a working 64-bit FFmpeg build with all required runtime DLLs.",
+        path: path2
+      };
+    }
+    return { name: "FFmpeg", ok: true, level: "ok", detail: version2.detail, path: path2 };
+  }
+  return {
+    name: "FFmpeg",
+    ok: false,
+    level: "error",
+    title: "FFmpeg not found",
+    // Second sentence dropped: "the render cannot proceed" is already said by
+    // the error this accompanies, and in Studio by the disabled Export button.
+    detail: "FFmpeg is required to encode video.",
+    hint: getFFmpegInstallHint()
+  };
+}
+function checkFFprobe() {
+  const missingConfigured = configuredMissingDetail(FFPROBE_PATH_ENV);
+  if (missingConfigured) {
+    return {
+      name: "FFprobe",
+      ok: false,
+      level: "error",
+      title: "FFprobe not found",
+      detail: missingConfigured,
+      hint: getFFmpegInstallHint()
+    };
+  }
+  const path2 = findFFprobe();
+  if (path2) {
+    const version2 = readToolVersion(path2);
+    return { name: "FFprobe", ok: true, level: "ok", detail: version2.detail, path: path2 };
+  }
+  return {
+    name: "FFprobe",
+    ok: false,
+    level: "error",
+    title: "FFprobe not found",
+    detail: "FFprobe is required to probe media assets. It ships with FFmpeg but was not found on PATH.",
+    hint: getFFmpegInstallHint()
+  };
+}
+function chromeSharedLibOutcome(executablePath, found) {
+  if (process.platform !== "linux") return found;
+  const probe = probeChromeSharedLibs(executablePath);
+  if (probe.probeUnavailable || probe.ok) return found;
+  const distro = detectLinuxDistro();
+  return {
+    name: "Chrome",
+    ok: false,
+    level: "error",
+    title: "Chrome cannot launch (missing system libraries)",
+    detail: `Chrome at ${executablePath} is missing shared libraries on ${distroLabel(distro)}: ${probe.missing.join(", ")}`,
+    hint: chromeDepsInstallCommand(distro.family),
+    path: executablePath
+  };
+}
+async function checkChrome(browserPath) {
+  if (browserPath) {
+    if (existsSync69(browserPath)) {
+      return chromeSharedLibOutcome(browserPath, {
+        name: "Chrome",
+        ok: true,
+        level: "ok",
+        detail: `explicit: ${browserPath}`,
+        path: browserPath
+      });
+    }
+    return {
+      name: "Chrome",
+      ok: false,
+      level: "error",
+      title: "Chrome not found",
+      detail: `Chrome binary not found at "${browserPath}".`,
+      hint: "Run: npx hyperframes browser ensure"
+    };
+  }
+  let info;
+  try {
+    info = await findBrowser();
+  } catch {
+    info = void 0;
+  }
+  if (info) {
+    return chromeSharedLibOutcome(info.executablePath, {
+      name: "Chrome",
+      ok: true,
+      level: "ok",
+      detail: `${info.source}: ${info.executablePath}`,
+      path: info.executablePath
+    });
+  }
+  return {
+    name: "Chrome",
+    ok: false,
+    level: "error",
+    title: "Chrome not found",
+    detail: "Chrome Headless Shell is required for local rendering.",
+    hint: "Run: npx hyperframes browser ensure"
+  };
+}
+function checkDisk(path2 = ".", freeDiskMb = getFreeDiskMb) {
+  const freeMb = freeDiskMb(path2);
+  if (freeMb === null) {
+    return { name: "Disk", ok: true, level: "ok", detail: "Unable to check" };
+  }
+  const freeGb = (freeMb / 1024).toFixed(1);
+  if (freeMb < 1024) {
+    return {
+      name: "Disk",
+      ok: false,
+      level: "error",
+      title: "Low disk space",
+      detail: `${freeGb} GB free at ${path2}`,
+      hint: "Renders produce large temp files. Free disk space before rendering."
+    };
+  }
+  return { name: "Disk", ok: true, level: "ok", detail: `${freeGb} GB free at ${path2}` };
+}
+function checkWindowsUncPath(projectDir = process.cwd()) {
+  if (platform7() !== "win32") return void 0;
+  if (!projectDir.startsWith("\\\\")) return void 0;
+  return {
+    name: "Windows path",
+    ok: true,
+    level: "warn",
+    detail: `UNC path: ${projectDir}`,
+    hint: "Chrome may fail to launch from a network share. Use a local drive if render startup fails."
+  };
+}
+async function runEnvironmentChecks(options = {}) {
+  const outcomes = [];
+  const ffmpeg = checkFFmpeg();
+  outcomes.push(ffmpeg);
+  const ffprobe = checkFFprobe();
+  outcomes.push(ffprobe);
+  let browser;
+  if (options.includeBrowser) {
+    const chrome = await checkChrome(options.browserPath);
+    outcomes.push(chrome);
+    if (chrome.ok && chrome.path) {
+      browser = {
+        executablePath: chrome.path,
+        source: options.browserPath ? "env" : "cache"
+      };
+    }
+  }
+  if (options.includeDisk) {
+    const diskPaths = [...new Set(options.diskPaths ?? [options.projectDir ?? "."])];
+    outcomes.push(...diskPaths.map((path2) => checkDisk(path2)));
+  }
+  if (options.includeWindowsUnc) {
+    const unc = checkWindowsUncPath(options.projectDir);
+    if (unc) outcomes.push(unc);
+  }
+  return {
+    outcomes,
+    ...ffmpeg.ok && ffmpeg.path ? { ffmpegPath: ffmpeg.path } : {},
+    ...ffprobe.path ? { ffprobePath: ffprobe.path } : {},
+    ...browser ? { browser } : {}
+  };
+}
+var init_preflight = __esm({
+  "src/browser/preflight.ts"() {
+    "use strict";
+    init_manager2();
+    init_ffmpeg();
+    init_linuxDeps();
+    init_system();
+  }
+});
+
 // src/server/studioServer.ts
 var studioServer_exports = {};
 __export(studioServer_exports, {
@@ -134589,7 +135026,7 @@ __export(studioServer_exports, {
 });
 import { Hono as Hono5 } from "hono";
 import { streamSSE as streamSSE4 } from "hono/streaming";
-import { existsSync as existsSync69, readFileSync as readFileSync41, writeFileSync as writeFileSync27, statSync as statSync25, unlinkSync as unlinkSync6 } from "fs";
+import { existsSync as existsSync70, readFileSync as readFileSync41, writeFileSync as writeFileSync27, statSync as statSync25, unlinkSync as unlinkSync6 } from "fs";
 import { resolve as resolve38, join as join78, basename as basename11 } from "path";
 async function loadStudioProducer() {
   return isDevMode() ? await Promise.resolve().then(() => (init_src2(), src_exports2)) : await Promise.resolve().then(() => (init_src2(), src_exports2));
@@ -134600,12 +135037,12 @@ function resolveDistDir() {
 function resolveStudioBundle() {
   const builtPath = resolve38(__dirname, "studio");
   const builtIndex = resolve38(builtPath, "index.html");
-  if (existsSync69(builtIndex)) {
+  if (existsSync70(builtIndex)) {
     return { dir: builtPath, indexPath: builtIndex, available: true, checkedPaths: [builtIndex] };
   }
   const devPath = resolve38(__dirname, "..", "..", "..", "studio", "dist");
   const devIndex = resolve38(devPath, "index.html");
-  if (existsSync69(devIndex)) {
+  if (existsSync70(devIndex)) {
     return {
       dir: devPath,
       indexPath: devIndex,
@@ -134622,9 +135059,9 @@ function resolveStudioBundle() {
 }
 function resolveRuntimePath() {
   const builtPath = resolve38(__dirname, "hyperframe-runtime.js");
-  if (existsSync69(builtPath)) return builtPath;
+  if (existsSync70(builtPath)) return builtPath;
   const iifePath = resolve38(__dirname, "hyperframe.runtime.iife.js");
-  if (existsSync69(iifePath)) return iifePath;
+  if (existsSync70(iifePath)) return iifePath;
   const devPath = resolve38(
     __dirname,
     "..",
@@ -134634,12 +135071,12 @@ function resolveRuntimePath() {
     "dist",
     "hyperframe.runtime.iife.js"
   );
-  if (existsSync69(devPath)) return devPath;
+  if (existsSync70(devPath)) return devPath;
   return builtPath;
 }
 function readStudioManualEditManifestContent(projectDir) {
   const manifestPath2 = join78(projectDir, STUDIO_MANUAL_EDITS_PATH2);
-  if (!existsSync69(manifestPath2)) return "";
+  if (!existsSync70(manifestPath2)) return "";
   try {
     return readFileSync41(manifestPath2, "utf-8");
   } catch {
@@ -134750,7 +135187,7 @@ async function closeThumbnailBrowser() {
 async function loadPreviewServerBuildSignature() {
   const runtimeSignature = await loadRuntimeSourceSignature();
   const studioBundle = resolveStudioBundle();
-  const studioIndex = studioBundle.available && existsSync69(studioBundle.indexPath) ? readFileSync41(studioBundle.indexPath, "utf-8") : "";
+  const studioIndex = studioBundle.available && existsSync70(studioBundle.indexPath) ? readFileSync41(studioBundle.indexPath, "utf-8") : "";
   return hashSignatureParts([
     VERSION,
     runtimeSignature,
@@ -134764,7 +135201,7 @@ async function loadPreviewServerBuildSignature() {
 }
 function rewriteWrittenToHostViewport(projectDir, written) {
   const indexPath2 = join78(projectDir, "index.html");
-  if (!existsSync69(indexPath2)) return;
+  if (!existsSync70(indexPath2)) return;
   const indexHtml = readFileSync41(indexPath2, "utf-8");
   const hostW = indexHtml.match(/data-width="(\d+)"/)?.[1];
   const hostH = indexHtml.match(/data-height="(\d+)"/)?.[1];
@@ -134876,7 +135313,7 @@ function createStudioServer(options) {
           for (const suffix of ["", ".meta.json"]) {
             const fp = suffix ? opts.outputPath.replace(/\.(mp4|webm|mov)$/, suffix) : opts.outputPath;
             try {
-              if (existsSync69(fp)) unlinkSync6(fp);
+              if (existsSync70(fp)) unlinkSync6(fp);
             } catch {
             }
           }
@@ -134963,7 +135400,7 @@ function createStudioServer(options) {
         return null;
       }
       const sourcePath = join78(opts.project.dir, opts.compPath);
-      if (existsSync69(sourcePath)) {
+      if (existsSync70(sourcePath)) {
         assertWebGpuRequirement(
           readFileSync41(sourcePath, "utf-8"),
           session.requestedGpuMode,
@@ -135089,7 +135526,7 @@ function createStudioServer(options) {
   });
   app.get("/api/runtime.js", (c3) => {
     const serve4 = async () => {
-      const runtimeSource = await loadRuntimeSource() ?? (existsSync69(runtimePath) ? readFileSync41(runtimePath, "utf-8") : null);
+      const runtimeSource = await loadRuntimeSource() ?? (existsSync70(runtimePath) ? readFileSync41(runtimePath, "utf-8") : null);
       if (!runtimeSource) return c3.text("runtime not available", 404);
       return c3.body(runtimeSource, 200, {
         "Content-Type": "text/javascript",
@@ -135124,6 +135561,27 @@ function createStudioServer(options) {
       }
     });
   });
+  let ffmpegReady = false;
+  app.get("/api/environment/ffmpeg", async (c3) => {
+    if (ffmpegReady) return c3.json({ ok: true });
+    const [{ runEnvironmentChecks: runEnvironmentChecks2 }, { getFFmpegInstallCommand: getFFmpegInstallCommand2 }] = await Promise.all([
+      Promise.resolve().then(() => (init_preflight(), preflight_exports)),
+      Promise.resolve().then(() => (init_ffmpeg(), ffmpeg_exports))
+    ]);
+    const { outcomes } = await runEnvironmentChecks2();
+    const failed = outcomes.find((outcome) => !outcome.ok);
+    if (!failed) {
+      ffmpegReady = true;
+      return c3.json({ ok: true });
+    }
+    return c3.json({
+      ok: false,
+      title: failed.title ?? `${failed.name} not found`,
+      detail: failed.detail,
+      hint: failed.hint,
+      command: getFFmpegInstallCommand2()
+    });
+  });
   let cachedFFmpegPath;
   app.post("/api/projects/:id/render", async (c3, next) => {
     const { findFFmpeg: findFFmpeg2, getFFmpegInstallHint: getFFmpegInstallHint2 } = await Promise.resolve().then(() => (init_ffmpeg(), ffmpeg_exports));
@@ -135150,7 +135608,7 @@ function createStudioServer(options) {
   });
   const serveStudioStaticFile = (c3) => {
     const filePath = resolve38(studioDir, c3.req.path.slice(1));
-    if (!existsSync69(filePath) || !statSync25(filePath).isFile()) return c3.text("not found", 404);
+    if (!existsSync70(filePath) || !statSync25(filePath).isFile()) return c3.text("not found", 404);
     const content = readFileSync41(filePath);
     return new Response(content, {
       headers: { "Content-Type": getMimeType(filePath), "Cache-Control": "no-store" }
@@ -135171,7 +135629,7 @@ function createStudioServer(options) {
   }
   app.get("*", (c3) => {
     const indexPath2 = resolve38(studioDir, "index.html");
-    if (!existsSync69(indexPath2)) {
+    if (!existsSync70(indexPath2)) {
       return c3.html(
         `<!doctype html>
 <html>
@@ -135268,7 +135726,7 @@ __export(preview_exports, {
 });
 import { spawn as spawn13 } from "child_process";
 import {
-  existsSync as existsSync70,
+  existsSync as existsSync71,
   lstatSync as lstatSync7,
   mkdirSync as mkdirSync37,
   readFileSync as readFileSync43,
@@ -135563,7 +136021,7 @@ function compactSelectionPayload(selection) {
 }
 function studioLandingSearch(projectDir) {
   const storyboardPath = join79(projectDir, STORYBOARD_FILENAME);
-  if (!existsSync70(storyboardPath)) return "";
+  if (!existsSync71(storyboardPath)) return "";
   let frames;
   try {
     frames = parseStoryboard(readFileSync43(storyboardPath, "utf8")).frames;
@@ -135572,7 +136030,7 @@ function studioLandingSearch(projectDir) {
   }
   if (frames.some((f3) => f3.status === "built")) return "?view=storyboard";
   const srcs = frames.map((f3) => f3.src).filter((s2) => typeof s2 === "string" && s2.length > 0);
-  const planning = frames.length > 0 && frames.every((f3) => f3.status === "outline") && srcs.length > 0 && !srcs.some((s2) => existsSync70(join79(projectDir, s2)));
+  const planning = frames.length > 0 && frames.every((f3) => f3.status === "outline") && srcs.length > 0 && !srcs.some((s2) => existsSync71(join79(projectDir, s2)));
   return planning ? "?view=storyboard" : "";
 }
 function studioDeepLink(url, projectName, projectDir) {
@@ -135604,7 +136062,7 @@ function linkProjectIntoStudioData(dir, projectsDir, projectName) {
   mkdirSync37(projectsDir, { recursive: true });
   let createdSymlink = false;
   if (dir !== symlinkPath) {
-    if (existsSync70(symlinkPath)) {
+    if (existsSync71(symlinkPath)) {
       try {
         const stat3 = lstatSync7(symlinkPath);
         if (stat3.isSymbolicLink() && resolve39(readlinkSync(symlinkPath)) !== resolve39(dir)) {
@@ -135613,7 +136071,7 @@ function linkProjectIntoStudioData(dir, projectsDir, projectName) {
       } catch {
       }
     }
-    if (!existsSync70(symlinkPath)) {
+    if (!existsSync71(symlinkPath)) {
       symlinkSync3(dir, symlinkPath, process.platform === "win32" ? "junction" : "dir");
       createdSymlink = true;
     }
@@ -135624,7 +136082,7 @@ function removeSymlinkOnExit(createdSymlink, symlinkPath) {
   if (!createdSymlink) return;
   process.on("exit", () => {
     try {
-      if (existsSync70(symlinkPath)) unlinkSync7(symlinkPath);
+      if (existsSync71(symlinkPath)) unlinkSync7(symlinkPath);
     } catch {
     }
   });
@@ -136188,7 +136646,7 @@ __export(init_exports, {
   resolveVideoDurationSeconds: () => resolveVideoDurationSeconds
 });
 import {
-  existsSync as existsSync71,
+  existsSync as existsSync73,
   mkdirSync as mkdirSync38,
   copyFileSync as copyFileSync9,
   cpSync as cpSync5,
@@ -136198,7 +136656,7 @@ import {
 } from "fs";
 import { resolve as resolve40, basename as basename13, join as join80, dirname as dirname34 } from "path";
 import { fileURLToPath as fileURLToPath9 } from "url";
-import { execFileSync as execFileSync8, spawn as spawn14 } from "child_process";
+import { execFileSync as execFileSync9, spawn as spawn14 } from "child_process";
 function resolveVideoDurationSeconds({
   streamDuration,
   frameDuration,
@@ -136212,7 +136670,7 @@ function probeVideo(filePath) {
   try {
     const ffprobePath = findFFprobe();
     if (!ffprobePath) return void 0;
-    const raw = execFileSync8(
+    const raw = execFileSync9(
       ffprobePath,
       ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", "--", filePath],
       { encoding: "utf-8", timeout: 15e3 }
@@ -136291,14 +136749,14 @@ function resolveAssetDir(devSegments, builtSegments) {
   const base2 = dirname34(fileURLToPath9(import.meta.url));
   const devPath = resolve40(base2, ...devSegments);
   const builtPath = resolve40(base2, ...builtSegments);
-  return existsSync71(devPath) ? devPath : builtPath;
+  return existsSync73(devPath) ? devPath : builtPath;
 }
 function getStaticTemplateDir(templateId) {
   const base2 = dirname34(fileURLToPath9(import.meta.url));
   const devPath = resolve40(base2, "..", "templates", templateId);
-  if (existsSync71(devPath)) return devPath;
+  if (existsSync73(devPath)) return devPath;
   const registryPath = resolve40(base2, "..", "..", "..", "..", "registry", "examples", templateId);
-  if (existsSync71(registryPath)) return registryPath;
+  if (existsSync73(registryPath)) return registryPath;
   return resolve40(base2, "templates", templateId);
 }
 function getSharedTemplateDir() {
@@ -136324,7 +136782,7 @@ function buildPackageScripts() {
 }
 function writeDefaultPackageJson(destDir, projectName) {
   const packageJsonPath = resolve40(destDir, "package.json");
-  if (existsSync71(packageJsonPath)) return;
+  if (existsSync73(packageJsonPath)) return;
   writeFileSync28(
     packageJsonPath,
     `${JSON.stringify(
@@ -136546,7 +137004,7 @@ function applyResolutionPreset(destDir, resolution) {
 async function scaffoldProject(destDir, name, templateId, localVideoName, durationSeconds, tailwind = false, resolution, authoringSkill) {
   mkdirSync38(destDir, { recursive: true });
   const templateDir = getStaticTemplateDir(templateId);
-  if (existsSync71(join80(templateDir, "index.html"))) {
+  if (existsSync73(join80(templateDir, "index.html"))) {
     cpSync5(templateDir, destDir, { recursive: true });
   } else {
     await fetchRemoteTemplate(templateId, destDir);
@@ -136567,7 +137025,7 @@ async function scaffoldProject(destDir, name, templateId, localVideoName, durati
     ),
     "utf-8"
   );
-  if (!existsSync71(resolve40(destDir, "hyperframes.json"))) {
+  if (!existsSync73(resolve40(destDir, "hyperframes.json"))) {
     const { writeProjectConfig: writeProjectConfig2, DEFAULT_PROJECT_CONFIG: DEFAULT_PROJECT_CONFIG2 } = await Promise.resolve().then(() => (init_projectConfig(), projectConfig_exports));
     const { normalizeSkillSlug: normalizeSkillSlug2 } = await Promise.resolve().then(() => (init_skill(), skill_exports));
     const skill = normalizeSkillSlug2(authoringSkill);
@@ -136578,7 +137036,7 @@ async function scaffoldProject(destDir, name, templateId, localVideoName, durati
   }
   writeDefaultPackageJson(destDir, name);
   const sharedDir = getSharedTemplateDir();
-  if (existsSync71(sharedDir)) {
+  if (existsSync73(sharedDir)) {
     for (const entry of readdirSync26(sharedDir, { withFileTypes: true })) {
       const src = join80(sharedDir, entry.name);
       const dest = resolve40(destDir, entry.name);
@@ -136798,7 +137256,7 @@ var init_init = __esm({
           const templateId2 = exampleFlag ?? "blank";
           const name2 = args.name ?? "my-video";
           const destDir2 = resolve40(name2);
-          if (existsSync71(destDir2) && readdirSync26(destDir2).length > 0) {
+          if (existsSync73(destDir2) && readdirSync26(destDir2).length > 0) {
             console.error(c.error(`Directory already exists and is not empty: ${name2}`));
             failCommand();
           }
@@ -136807,12 +137265,12 @@ var init_init = __esm({
             failCommand();
           }
           const videoPath = videoFlag ? resolve40(videoFlag) : void 0;
-          if (videoPath && !existsSync71(videoPath)) {
+          if (videoPath && !existsSync73(videoPath)) {
             console.error(c.error(`Video file not found: ${videoFlag}`));
             failCommand();
           }
           const audioPath = audioFlag ? resolve40(audioFlag) : void 0;
-          if (audioPath && !existsSync71(audioPath)) {
+          if (audioPath && !existsSync73(audioPath)) {
             console.error(c.error(`Audio file not found: ${audioFlag}`));
             failCommand();
           }
@@ -136875,7 +137333,7 @@ var init_init = __esm({
           }
           trackInitTemplate(templateId2, { tailwind });
           const transcriptFile2 = resolve40(destDir2, "transcript.json");
-          if (existsSync71(transcriptFile2)) {
+          if (existsSync73(transcriptFile2)) {
             await patchTranscript(destDir2, transcriptFile2);
           }
           console.log(c.success(`Created ${c.accent(name2 + "/")}`));
@@ -136939,7 +137397,7 @@ var init_init = __esm({
           name = nameResult;
         }
         const destDir = resolve40(name);
-        if (existsSync71(destDir) && readdirSync26(destDir).length > 0) {
+        if (existsSync73(destDir) && readdirSync26(destDir).length > 0) {
           const overwrite = await ue({
             message: `Directory ${c.accent(name)} already exists and is not empty. Overwrite?`,
             initialValue: false
@@ -136954,7 +137412,7 @@ var init_init = __esm({
         let videoDuration;
         if (videoFlag) {
           const videoPath = resolve40(videoFlag);
-          if (!existsSync71(videoPath)) {
+          if (!existsSync73(videoPath)) {
             R2.error(`File not found: ${videoFlag}`);
             me("Setup cancelled.");
             failCommand();
@@ -136966,7 +137424,7 @@ var init_init = __esm({
           videoDuration = result.meta.durationSeconds;
         } else if (audioFlag) {
           const audioPath = resolve40(audioFlag);
-          if (!existsSync71(audioPath)) {
+          if (!existsSync73(audioPath)) {
             R2.error(`File not found: ${audioFlag}`);
             me("Setup cancelled.");
             failCommand();
@@ -137068,7 +137526,7 @@ ${c.dim("Use --example blank for offline use.")}`
         }
         trackInitTemplate(templateId, { tailwind });
         const transcriptFile = resolve40(destDir, "transcript.json");
-        if (existsSync71(transcriptFile)) {
+        if (existsSync73(transcriptFile)) {
           await patchTranscript(destDir, transcriptFile);
         }
         const files = readdirSync26(destDir);
@@ -137089,9 +137547,9 @@ ${c.dim("Use --example blank for offline use.")}`
 
 // src/utils/clipboard.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { platform as platform7 } from "os";
+import { platform as platform8 } from "os";
 function detectProvider() {
-  const os = platform7();
+  const os = platform8();
   if (os === "darwin") {
     return { cmd: "pbcopy", args: [] };
   }
@@ -137139,12 +137597,13 @@ __export(add_exports, {
   AddError: () => AddError,
   buildSnippet: () => buildSnippet,
   default: () => add_default,
+  describeInstallFailure: () => describeInstallFailure,
   examples: () => examples4,
   parseVariableValues: () => parseVariableValues,
   remapTarget: () => remapTarget,
   runAdd: () => runAdd
 });
-import { existsSync as existsSync73 } from "fs";
+import { existsSync as existsSync74 } from "fs";
 import { resolve as resolve41, relative as relative17 } from "path";
 function remapTarget(item, originalTarget, paths) {
   if (item.type === "hyperframes:block") {
@@ -137196,28 +137655,51 @@ function assertCompatibleOrThrow(items, cliVersion) {
     throw err;
   }
 }
-async function installAll(installPlan, destDir, baseUrl, force) {
+async function installAll(installPlan, destDir, baseUrl, force, requestedName, variableValues) {
   const written = [];
   const preserved = [];
+  let variablesApplied = [];
+  let variablesUnknown = [];
+  let variablesInvalid = [];
   try {
     for (const planItem of installPlan) {
-      const result = await installItem(planItem, { destDir, baseUrl, force });
+      const result = await installItem(planItem, {
+        destDir,
+        baseUrl,
+        force,
+        // Only the item the user named. A dependency dragged in behind it never
+        // declared these variables and must not be rewritten by them.
+        variableValues: planItem.name === requestedName ? variableValues : null
+      });
       written.push(...result.written);
       preserved.push(...result.preserved);
+      if (planItem.name === requestedName) {
+        variablesApplied = result.variablesApplied;
+        variablesUnknown = result.variablesUnknown;
+        variablesInvalid = result.variablesInvalid;
+      }
     }
   } catch (err) {
-    throw new AddError(
-      `Install failed: ${err instanceof Error ? err.message : String(err)}`,
-      "install-failed"
-    );
+    throw new AddError(describeInstallFailure(err, baseUrl), "install-failed");
   }
-  return { written, preserved };
+  return { written, preserved, variablesApplied, variablesUnknown, variablesInvalid };
+}
+function describeInstallFailure(err, registry) {
+  const message = err instanceof Error ? err.message : String(err);
+  const cause = err instanceof Error && err.cause instanceof Error ? err.cause.message : "";
+  const transport = /fetch failed|ENOTFOUND|ECONNRESET|ECONNREFUSED|ETIMEDOUT|EAI_AGAIN|socket hang up|aborted/i;
+  if (!transport.test(`${message} ${cause}`)) return `Install failed: ${message}`;
+  const custom = registry && !registry.startsWith(DEFAULT_REGISTRY_URL) ? `
+  This project's hyperframes.json sets registry to ${registry}, so that is the host being contacted, not the public registry. If it is down or private, that is the failure.` : "";
+  return `Install failed: could not download the item's files.
+  ${message}
+  Item files are not cached, so every install fetches them. This is usually the registry host or the network rather than a bad command.` + custom + "\n  Retry, or set HTTPS_PROXY if you are behind a proxy.";
 }
 async function runAdd(opts) {
   const projectDir = resolve41(opts.projectDir);
   let config = loadProjectConfig(projectDir);
-  const hasConfig = existsSync73(projectConfigPath(projectDir));
-  if (!hasConfig && existsSync73(resolve41(projectDir, "index.html"))) {
+  const hasConfig = existsSync74(projectConfigPath(projectDir));
+  if (!hasConfig && existsSync74(resolve41(projectDir, "index.html"))) {
     writeProjectConfig(projectDir, DEFAULT_PROJECT_CONFIG);
     config = DEFAULT_PROJECT_CONFIG;
   }
@@ -137242,11 +137724,14 @@ async function runAdd(opts) {
       target: remapTarget(resolvedItem, f3.target, config.paths)
     }))
   }));
-  const { written, preserved } = await installAll(
+  const variableValues = parseVariableValues(opts.vars);
+  const { written, preserved, variablesApplied, variablesUnknown, variablesInvalid } = await installAll(
     installPlan,
     projectDir,
     config.registry,
-    opts.force ?? false
+    opts.force ?? false,
+    item.name,
+    variableValues
   );
   for (const planItem of installPlan) {
     trackRegistryItemAdded({
@@ -137258,8 +137743,14 @@ async function runAdd(opts) {
   const itemForInstall = installPlan[installPlan.length - 1];
   const primaryFile = itemForInstall.files.find((f3) => f3.type === "hyperframes:snippet") ?? itemForInstall.files.find((f3) => f3.type === "hyperframes:composition") ?? itemForInstall.files[0];
   const snippetTargetRel = primaryFile?.target ?? "";
-  const snippet = buildSnippet(item, snippetTargetRel, parseVariableValues(opts.vars));
+  const snippet = buildSnippet(item, snippetTargetRel, variableValues);
   const clipboardCopied = !opts.skipClipboard && snippet ? copyToClipboard(snippet) : false;
+  for (const { id, reason } of variablesInvalid) {
+    warnings.push(`--vars ${id} ignored: ${reason}`);
+  }
+  if (variablesUnknown.length > 0) {
+    warnings.push(`--vars ignored (not declared by ${item.name}): ${variablesUnknown.join(", ")}`);
+  }
   return {
     ok: true,
     name: item.name,
@@ -137270,6 +137761,7 @@ async function runAdd(opts) {
     installed: installPlan.map((planItem) => planItem.name),
     snippet,
     clipboardCopied,
+    variablesApplied,
     warnings
   };
 }
@@ -137350,7 +137842,7 @@ var init_add = __esm({
         const projectDir = resolve41(args.dir ?? process.cwd());
         const json = args.json === true;
         const skipClipboard = args.clipboard === false;
-        const hasConfigBefore = existsSync73(projectConfigPath(projectDir));
+        const hasConfigBefore = existsSync74(projectConfigPath(projectDir));
         try {
           const result = await runAdd({
             name: args.name,
@@ -137359,7 +137851,7 @@ var init_add = __esm({
             force: args.force,
             vars: args.vars
           });
-          const wroteConfig = !hasConfigBefore && existsSync73(projectConfigPath(projectDir));
+          const wroteConfig = !hasConfigBefore && existsSync74(projectConfigPath(projectDir));
           if (json) {
             console.log(JSON.stringify(result));
             return;
@@ -137380,6 +137872,9 @@ var init_add = __esm({
           for (const file of result.written) {
             console.log(`  ${c.dim(relative17(projectDir, file))}`);
           }
+          if (result.variablesApplied.length > 0) {
+            console.log(`  ${c.dim(`variables applied: ${result.variablesApplied.join(", ")}`)}`);
+          }
           if (result.snippet) {
             console.log("");
             console.log(c.dim("Include snippet:"));
@@ -137397,7 +137892,7 @@ var init_add = __esm({
             failCommand();
           }
           let config = loadProjectConfig(projectDir);
-          if (!existsSync73(projectConfigPath(projectDir)) && existsSync73(resolve41(projectDir, "index.html"))) {
+          if (!existsSync74(projectConfigPath(projectDir)) && existsSync74(resolve41(projectDir, "index.html"))) {
             writeProjectConfig(projectDir, DEFAULT_PROJECT_CONFIG);
             config = DEFAULT_PROJECT_CONFIG;
           }
@@ -137467,23 +137962,48 @@ function tokenize(text2) {
 function hasNoSearchableTokens(query2) {
   return tokenize(query2).length === 0 && query2.trim().length > 0;
 }
+function expandCompounds(want, order, vocabulary) {
+  const infer = (token) => {
+    if (!want.has(token)) want.set(token, INFERRED_TOKEN_WEIGHT);
+  };
+  for (const token of order) {
+    if (token.length < 6) continue;
+    for (let cut = 3; cut <= token.length - 3; cut++) {
+      const head = token.slice(0, cut);
+      const tail = token.slice(cut);
+      if (vocabulary.has(head) && vocabulary.has(tail)) {
+        infer(head);
+        infer(tail);
+        break;
+      }
+    }
+  }
+  for (let i2 = 0; i2 < order.length - 1; i2++) {
+    const joined = `${order[i2]}${order[i2 + 1]}`;
+    if (vocabulary.has(joined)) infer(joined);
+  }
+}
 function rankByWords(query2, items, textOf) {
-  const want = new Set(tokenize(query2));
+  const asked = tokenize(query2);
+  const want = new Map(asked.map((token) => [token, 1]));
   if (want.size === 0) return items.map((item) => ({ item, score: 0 }));
   const parsed = items.map((item) => {
     const { strong, weak } = textOf(item);
     const strongTokens = new Set(tokenize(strong));
     return { item, strongTokens, allTokens: /* @__PURE__ */ new Set([...strongTokens, ...tokenize(weak)]) };
   });
+  const vocabulary = /* @__PURE__ */ new Set();
+  for (const entry of parsed) for (const token of entry.allTokens) vocabulary.add(token);
+  expandCompounds(want, asked, vocabulary);
   const idf = /* @__PURE__ */ new Map();
-  for (const token of want) {
+  for (const token of want.keys()) {
     const df = parsed.reduce((count, p2) => count + (p2.allTokens.has(token) ? 1 : 0), 0);
     idf.set(token, Math.log((parsed.length + 1) / (df + 1)) + 1);
   }
   return parsed.map(({ item, strongTokens, allTokens }) => {
     let shared = 0;
-    for (const token of want) {
-      const weight = idf.get(token) ?? 1;
+    for (const [token, asking] of want) {
+      const weight = (idf.get(token) ?? 1) * asking;
       if (strongTokens.has(token)) shared += STRONG_FIELD_WEIGHT * weight;
       else if (allTokens.has(token)) shared += weight;
     }
@@ -137497,7 +138017,7 @@ function nameOf(item) {
   const named = item;
   return typeof named?.name === "string" ? named.name : "";
 }
-var STOP, STRONG_FIELD_WEIGHT, PLURAL_RULES;
+var STOP, STRONG_FIELD_WEIGHT, PLURAL_RULES, INFERRED_TOKEN_WEIGHT;
 var init_localSearch = __esm({
   "src/registry/localSearch.ts"() {
     "use strict";
@@ -137515,12 +138035,13 @@ var init_localSearch = __esm({
       [/s$/, ""]
       // counts -> count, pulses -> pulse
     ];
+    INFERRED_TOKEN_WEIGHT = 0.35;
   }
 });
 
 // src/registry/localModel.ts
 import { createHash as createHash19 } from "crypto";
-import { existsSync as existsSync74, mkdirSync as mkdirSync39, readFileSync as readFileSync45, unlinkSync as unlinkSync8 } from "fs";
+import { existsSync as existsSync75, mkdirSync as mkdirSync39, readFileSync as readFileSync45, unlinkSync as unlinkSync8 } from "fs";
 import { homedir as homedir15 } from "os";
 import { join as join81 } from "path";
 function localModelConsent() {
@@ -137537,7 +138058,7 @@ function localTokenizerPath() {
 }
 function modelFileIsValid(file) {
   const path2 = file.dest();
-  if (!existsSync74(path2)) return false;
+  if (!existsSync75(path2)) return false;
   try {
     return createHash19("sha256").update(readFileSync45(path2)).digest("hex") === file.sha256;
   } catch {
@@ -137676,7 +138197,7 @@ function wordPiece(word, config) {
   }
   return pieces;
 }
-function encode2(text2, config) {
+function encode3(text2, config) {
   const tokens = [config.clsToken];
   for (const word of preTokenize(normalize(text2))) tokens.push(...wordPiece(word, config));
   tokens.push(config.sepToken);
@@ -137727,7 +138248,7 @@ async function loadLocalEmbedder() {
     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 encodings = texts.map((text2) => truncate(encode3(prefix + text2, config)));
       const width = Math.max(...encodings.map((e3) => e3.ids.length));
       const batch = encodings.length;
       const ids = new BigInt64Array(batch * width);
@@ -137791,7 +138312,7 @@ var init_localEmbedder = __esm({
 });
 
 // src/registry/localSemantic.ts
-import { existsSync as existsSync75, mkdirSync as mkdirSync40, readFileSync as readFileSync47, writeFileSync as writeFileSync29 } from "fs";
+import { existsSync as existsSync76, mkdirSync as mkdirSync40, readFileSync as readFileSync47, writeFileSync as writeFileSync29 } from "fs";
 import { homedir as homedir16 } from "os";
 import { join as join83 } from "path";
 function localVectorDirectory() {
@@ -137845,7 +138366,7 @@ async function fetchLocalVectors(registryBaseUrl, options = {}) {
   }
 }
 function hasLocalVectors(directory = localVectorDirectory()) {
-  return existsSync75(join83(directory, "local-vectors.bin")) && existsSync75(join83(directory, "local-vectors.json"));
+  return existsSync76(join83(directory, "local-vectors.bin")) && existsSync76(join83(directory, "local-vectors.json"));
 }
 function loadLocalVectors(directory = localVectorDirectory()) {
   const meta = JSON.parse(
@@ -138345,7 +138866,7 @@ var init_mediaProxyPreview = __esm({
 });
 
 // src/utils/compositionServer.ts
-import { createReadStream as createReadStream6, existsSync as existsSync76, statSync as statSync26 } from "fs";
+import { createReadStream as createReadStream6, existsSync as existsSync77, 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";
@@ -138360,7 +138881,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) => existsSync76(p2)) ?? null;
+  return candidates.find((p2) => existsSync77(p2)) ?? null;
 }
 function resolvePlayerPath() {
   const d2 = helperDir();
@@ -138369,7 +138890,7 @@ function resolvePlayerPath() {
     resolve44(d2, "hyperframes-player.global.js"),
     resolve44(d2, "..", "hyperframes-player.global.js")
   ];
-  return candidates.find((p2) => existsSync76(p2)) ?? null;
+  return candidates.find((p2) => existsSync77(p2)) ?? null;
 }
 function resolveSlideshowPath() {
   const d2 = helperDir();
@@ -138378,7 +138899,7 @@ function resolveSlideshowPath() {
     resolve44(d2, "hyperframes-slideshow.global.js"),
     resolve44(d2, "..", "hyperframes-slideshow.global.js")
   ];
-  return candidates.find((p2) => existsSync76(p2)) ?? null;
+  return candidates.find((p2) => existsSync77(p2)) ?? null;
 }
 function injectRuntime(html) {
   return injectTagsAtHeadStart(html, `<script src="/runtime.js"></script>`);
@@ -138506,7 +139027,7 @@ __export(play_exports, {
   examples: () => examples6,
   registerCompositionRoute: () => registerCompositionRoute
 });
-import { existsSync as existsSync77, readFileSync as readFileSync48 } from "fs";
+import { existsSync as existsSync78, readFileSync as readFileSync48 } 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));
@@ -138514,7 +139035,7 @@ 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 (!existsSync77(filePath)) return ctx.text("Not found", 404);
+    if (!existsSync78(filePath)) return ctx.text("Not found", 404);
     if (filePath.endsWith(".html")) {
       let html = injectRuntime(readFileSync48(filePath, "utf-8"));
       if (autoProxy) {
@@ -138749,7 +139270,7 @@ __export(present_exports, {
   default: () => present_default,
   examples: () => examples7
 });
-import { existsSync as existsSync78, readFileSync as readFileSync49 } from "fs";
+import { existsSync as existsSync79, readFileSync as readFileSync49 } from "fs";
 import { resolve as resolve46 } from "path";
 function buildPresentPage(projectName, islandJson) {
   return `<!doctype html>
@@ -138983,7 +139504,7 @@ 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 (!existsSync78(filePath)) return ctx.text("Not found", 404);
+          if (!existsSync79(filePath)) return ctx.text("Not found", 404);
           if (filePath.endsWith(".html")) return ctx.html(readFileSync49(filePath, "utf-8"));
           return ctx.body(readFileSync49(filePath), 200, { "Content-Type": assetContentType(filePath) });
         });
@@ -139628,9 +140149,9 @@ async function startLoopback(opts) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   let resolveResult;
   let rejectResult;
-  const result = new Promise((resolve77, reject) => {
+  const result = new Promise((resolve77, reject2) => {
     resolveResult = resolve77;
-    rejectResult = reject;
+    rejectResult = reject2;
   });
   let redirectUri = "";
   const server = createServer(
@@ -139656,10 +140177,10 @@ async function startLoopback(opts) {
   return { result, redirectUri, close };
 }
 async function listen(server, port) {
-  await new Promise((resolve77, reject) => {
-    server.once("error", reject);
+  await new Promise((resolve77, reject2) => {
+    server.once("error", reject2);
     server.listen(port, "127.0.0.1", () => {
-      server.off("error", reject);
+      server.off("error", reject2);
       resolve77();
     });
   });
@@ -140323,12 +140844,12 @@ var init_auth = __esm({
 
 // src/utils/projectLink.ts
 import { randomUUID as randomUUID11 } from "crypto";
-import { existsSync as existsSync79, mkdirSync as mkdirSync41, readFileSync as readFileSync50, writeFileSync as writeFileSync30 } from "fs";
+import { existsSync as existsSync80, mkdirSync as mkdirSync41, readFileSync as readFileSync50, writeFileSync as writeFileSync30 } from "fs";
 import { homedir as homedir18 } from "os";
 import { join as join85, resolve as resolve47 } from "path";
 function readJsonRecord(path2) {
   try {
-    if (!existsSync79(path2)) return null;
+    if (!existsSync80(path2)) return null;
     const parsed = JSON.parse(readFileSync50(path2, "utf-8"));
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return null;
     return parsed;
@@ -140411,14 +140932,14 @@ var init_projectLink = __esm({
 
 // src/utils/publishProject.ts
 import { basename as basename14, dirname as dirname37, join as join86, posix as posix5, relative as relative18, resolve as resolve48 } from "path";
-import { existsSync as existsSync80, readdirSync as readdirSync27, readFileSync as readFileSync51, statSync as statSync27 } from "fs";
+import { existsSync as existsSync81, readdirSync as readdirSync27, readFileSync as readFileSync51, statSync as statSync27 } from "fs";
 import AdmZip from "adm-zip";
 import ignore2 from "ignore";
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function dataRecord(payload) {
-  if (!isRecord8(payload) || !isRecord8(payload["data"])) return null;
+  if (!isRecord9(payload) || !isRecord9(payload["data"])) return null;
   return payload["data"];
 }
 function stringField2(record, key2) {
@@ -140469,7 +140990,7 @@ function parseStagedUploadResponse(payload, archiveByteLength) {
 function getUploadHeaders(data2, uploadUrl, contentType, archiveByteLength) {
   const headers = {};
   const uploadHeaders = data2["upload_headers"];
-  if (isRecord8(uploadHeaders)) {
+  if (isRecord9(uploadHeaders)) {
     for (const [key2, value] of Object.entries(uploadHeaders)) {
       if (typeof value === "string" && key2.trim()) {
         headers[key2] = value;
@@ -140495,7 +141016,7 @@ async function readErrorMessage(response, fallback) {
   const contentType = response.headers.get("content-type") || "";
   if (contentType.includes("application/json")) {
     const payload = await readJson(response);
-    if (isRecord8(payload) && typeof payload["message"] === "string") {
+    if (isRecord9(payload) && typeof payload["message"] === "string") {
       return payload["message"];
     }
   }
@@ -140506,7 +141027,7 @@ async function readErrorMessage(response, fallback) {
   return text2.trim() ? `${fallback}: ${text2.trim().slice(0, 180)}` : fallback;
 }
 function systemErrorMetadata(value) {
-  if (!isRecord8(value)) return [];
+  if (!isRecord9(value)) return [];
   const metadata = [];
   if (typeof value["code"] === "string") metadata.push(value["code"]);
   if (typeof value["syscall"] === "string") metadata.push(`syscall=${value["syscall"]}`);
@@ -140574,7 +141095,7 @@ function shouldIgnoreSegment(segment) {
 function createProjectIgnore(rootDir) {
   const matcher = ignore2().add(DEFAULT_PROJECT_IGNORE);
   const ignorePath = join86(rootDir, HYPERFRAMES_IGNORE_FILE);
-  if (existsSync80(ignorePath)) {
+  if (existsSync81(ignorePath)) {
     matcher.add(readFileSync51(ignorePath, "utf-8"));
   }
   return matcher;
@@ -140618,7 +141139,7 @@ function tryResolveExternal(ctx, rawPath, referrerAbsDir) {
   const absPath = resolve48(referrerAbsDir, rawPath);
   if (isPathInside(absPath, ctx.absProjectDir)) return null;
   try {
-    if (!existsSync80(absPath) || !statSync27(absPath).isFile()) return null;
+    if (!existsSync81(absPath) || !statSync27(absPath).isFile()) return null;
   } catch {
     return null;
   }
@@ -140904,7 +141425,7 @@ var init_publishProject = __esm({
 });
 
 // src/utils/publishProxyBake.ts
-import { existsSync as existsSync81 } from "fs";
+import { existsSync as existsSync83 } from "fs";
 import { readFile as readFile4 } from "fs/promises";
 import { basename as basename15, dirname as dirname38, resolve as resolve49 } from "path";
 function emptyManifest() {
@@ -140962,7 +141483,7 @@ async function bakeMediaProxies(projectDir, fileContents) {
         const rootRelativeSrc = rewriteAssetPath(
           entryPath,
           cleaned,
-          (path2) => existsSync81(resolve49(absProjectDir, path2))
+          (path2) => existsSync83(resolve49(absProjectDir, path2))
         );
         for (const candidate of resolveLocalAssetCandidates(absProjectDir, rootRelativeSrc)) {
           const archivePath = proxyByAbsolutePath.get(candidate);
@@ -141007,7 +141528,7 @@ __export(publish_exports, {
   parseUpdateTarget: () => parseUpdateTarget
 });
 import { join as join87, relative as relative19, resolve as resolve50 } from "path";
-import { existsSync as existsSync83 } from "fs";
+import { existsSync as existsSync84 } from "fs";
 function parseUpdateTarget(value) {
   const trimmed = value.trim();
   const pathMatch = trimmed.match(/\/p\/([^/?#]+)/);
@@ -141078,7 +141599,7 @@ var init_publish = __esm({
         const rawArg = args.dir;
         const dir = resolve50(rawArg ?? ".");
         const indexPath2 = join87(dir, "index.html");
-        if (existsSync83(indexPath2)) {
+        if (existsSync84(indexPath2)) {
           const lintResult = await lintProject(dir);
           if (lintResult.totalErrors > 0 || lintResult.totalWarnings > 0) {
             console.log();
@@ -141700,7 +142221,7 @@ function reportVariableIssues(issues, options) {
     failCommand();
   }
 }
-var init_variables = __esm({
+var init_variables2 = __esm({
   "src/utils/variables.ts"() {
     "use strict";
     init_commandResult();
@@ -141723,7 +142244,7 @@ __export(batchRender_exports, {
 });
 import { mkdirSync as mkdirSync43, readFileSync as readFileSync55, writeFileSync as writeFileSync31 } from "fs";
 import { dirname as dirname40, join as join89, resolve as resolve53, sep as sep12 } from "path";
-function isRecord9(value) {
+function isRecord10(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function parseJson(raw, source) {
@@ -141735,7 +142256,7 @@ function parseJson(raw, source) {
 }
 function parseBatchRows(raw, source) {
   const parsed = parseJson(raw, source);
-  const rows = Array.isArray(parsed) ? parsed : isRecord9(parsed) ? parsed.rows : void 0;
+  const rows = Array.isArray(parsed) ? parsed : isRecord10(parsed) ? parsed.rows : void 0;
   if (!Array.isArray(rows)) {
     throw new BatchRenderInputError(
       "Invalid batch payload",
@@ -141746,7 +142267,7 @@ function parseBatchRows(raw, source) {
     throw new BatchRenderInputError("Empty batch", `${source} contains zero rows.`);
   }
   return rows.map((row, index) => {
-    if (!isRecord9(row)) {
+    if (!isRecord10(row)) {
       throw new BatchRenderInputError(
         "Invalid batch row",
         `Row ${index} must be a JSON object of variable values.`
@@ -142027,7 +142548,7 @@ var init_batchRender = __esm({
     init_colors();
     init_format();
     init_errorMessage();
-    init_variables();
+    init_variables2();
     BatchRenderInputError = class extends Error {
       title;
       hint;
@@ -142250,7 +142771,7 @@ var init_execute = __esm({
     init_lintProject();
     init_errorMessage();
     init_commandResult();
-    init_variables();
+    init_variables2();
     init_events();
     init_plan2();
   }
@@ -142271,7 +142792,7 @@ var init_producer = __esm({
 });
 
 // src/utils/webmAlphaCheck.ts
-import { execFileSync as execFileSync9 } from "child_process";
+import { execFileSync as execFileSync10 } from "child_process";
 function webmAlphaAdvisory(format, probe) {
   if (format !== "webm") return void 0;
   if (!probe.probed) return void 0;
@@ -142287,7 +142808,7 @@ function probeWebmAlpha(filePath) {
   try {
     const ffprobePath = findFFprobe();
     if (!ffprobePath) return { probed: false, alphaMode: false };
-    const raw = execFileSync9(
+    const raw = execFileSync10(
       ffprobePath,
       [
         "-v",
@@ -142326,7 +142847,7 @@ function sampledAlphaIsFullyOpaque(filePath) {
   const ffmpegPath = findFFmpeg();
   if (!ffmpegPath) return void 0;
   try {
-    const buf = execFileSync9(
+    const buf = execFileSync10(
       ffmpegPath,
       [
         "-v",
@@ -142581,226 +143102,6 @@ var init_dockerRunArgs = __esm({
   }
 });
 
-// src/browser/preflight.ts
-import { execFileSync as execFileSync10 } from "child_process";
-import { existsSync as existsSync84 } from "fs";
-import { platform as platform8 } from "os";
-function parseToolVersion(raw) {
-  const m2 = raw.match(/(ffmpeg|ffprobe)\s+version\s+([\d][\d.\-\w]*)/i);
-  return m2 ? `${m2[1]} ${m2[2]}` : raw.trim();
-}
-function configuredMissingDetail(envName) {
-  const configured = process.env[envName]?.trim();
-  if (!configured || existsSync84(configured)) return void 0;
-  return `Configured path does not exist: ${envName}="${configured}"`;
-}
-function readToolVersion(binaryPath) {
-  try {
-    const raw = execFileSync10(binaryPath, ["-version"], { encoding: "utf-8", timeout: 5e3 }).split("\n")[0] ?? "";
-    const version2 = parseToolVersion(raw);
-    return { ok: true, detail: version2 ? `${version2} at ${binaryPath}` : binaryPath };
-  } catch (error) {
-    const status = typeof error === "object" && error !== null && "status" in error ? error.status : void 0;
-    const exitDetail = typeof status === "number" ? ` (exit code ${status})` : "";
-    return {
-      ok: false,
-      detail: `Failed to run "${binaryPath}" -version${exitDetail}.`
-    };
-  }
-}
-function checkFFmpeg() {
-  const missingConfigured = configuredMissingDetail(FFMPEG_PATH_ENV);
-  if (missingConfigured) {
-    return {
-      name: "FFmpeg",
-      ok: false,
-      level: "error",
-      title: "FFmpeg not found",
-      detail: missingConfigured,
-      hint: getFFmpegInstallHint()
-    };
-  }
-  const path2 = findFFmpeg();
-  if (path2) {
-    const version2 = readToolVersion(path2);
-    if (!version2.ok) {
-      return {
-        name: "FFmpeg",
-        ok: false,
-        level: "error",
-        title: "FFmpeg cannot start",
-        detail: version2.detail,
-        hint: "Install a working 64-bit FFmpeg build with all required runtime DLLs.",
-        path: path2
-      };
-    }
-    return { name: "FFmpeg", ok: true, level: "ok", detail: version2.detail, path: path2 };
-  }
-  return {
-    name: "FFmpeg",
-    ok: false,
-    level: "error",
-    title: "FFmpeg not found",
-    detail: "FFmpeg is required to encode video. The render cannot proceed without it.",
-    hint: getFFmpegInstallHint()
-  };
-}
-function checkFFprobe() {
-  const missingConfigured = configuredMissingDetail(FFPROBE_PATH_ENV);
-  if (missingConfigured) {
-    return {
-      name: "FFprobe",
-      ok: false,
-      level: "error",
-      title: "FFprobe not found",
-      detail: missingConfigured,
-      hint: getFFmpegInstallHint()
-    };
-  }
-  const path2 = findFFprobe();
-  if (path2) {
-    const version2 = readToolVersion(path2);
-    return { name: "FFprobe", ok: true, level: "ok", detail: version2.detail, path: path2 };
-  }
-  return {
-    name: "FFprobe",
-    ok: false,
-    level: "error",
-    title: "FFprobe not found",
-    detail: "FFprobe is required to probe media assets. It ships with FFmpeg but was not found on PATH.",
-    hint: getFFmpegInstallHint()
-  };
-}
-function chromeSharedLibOutcome(executablePath, found) {
-  if (process.platform !== "linux") return found;
-  const probe = probeChromeSharedLibs(executablePath);
-  if (probe.probeUnavailable || probe.ok) return found;
-  const distro = detectLinuxDistro();
-  return {
-    name: "Chrome",
-    ok: false,
-    level: "error",
-    title: "Chrome cannot launch (missing system libraries)",
-    detail: `Chrome at ${executablePath} is missing shared libraries on ${distroLabel(distro)}: ${probe.missing.join(", ")}`,
-    hint: chromeDepsInstallCommand(distro.family),
-    path: executablePath
-  };
-}
-async function checkChrome(browserPath) {
-  if (browserPath) {
-    if (existsSync84(browserPath)) {
-      return chromeSharedLibOutcome(browserPath, {
-        name: "Chrome",
-        ok: true,
-        level: "ok",
-        detail: `explicit: ${browserPath}`,
-        path: browserPath
-      });
-    }
-    return {
-      name: "Chrome",
-      ok: false,
-      level: "error",
-      title: "Chrome not found",
-      detail: `Chrome binary not found at "${browserPath}".`,
-      hint: "Run: npx hyperframes browser ensure"
-    };
-  }
-  let info;
-  try {
-    info = await findBrowser();
-  } catch {
-    info = void 0;
-  }
-  if (info) {
-    return chromeSharedLibOutcome(info.executablePath, {
-      name: "Chrome",
-      ok: true,
-      level: "ok",
-      detail: `${info.source}: ${info.executablePath}`,
-      path: info.executablePath
-    });
-  }
-  return {
-    name: "Chrome",
-    ok: false,
-    level: "error",
-    title: "Chrome not found",
-    detail: "Chrome Headless Shell is required for local rendering.",
-    hint: "Run: npx hyperframes browser ensure"
-  };
-}
-function checkDisk(path2 = ".", freeDiskMb = getFreeDiskMb) {
-  const freeMb = freeDiskMb(path2);
-  if (freeMb === null) {
-    return { name: "Disk", ok: true, level: "ok", detail: "Unable to check" };
-  }
-  const freeGb = (freeMb / 1024).toFixed(1);
-  if (freeMb < 1024) {
-    return {
-      name: "Disk",
-      ok: false,
-      level: "error",
-      title: "Low disk space",
-      detail: `${freeGb} GB free at ${path2}`,
-      hint: "Renders produce large temp files. Free disk space before rendering."
-    };
-  }
-  return { name: "Disk", ok: true, level: "ok", detail: `${freeGb} GB free at ${path2}` };
-}
-function checkWindowsUncPath(projectDir = process.cwd()) {
-  if (platform8() !== "win32") return void 0;
-  if (!projectDir.startsWith("\\\\")) return void 0;
-  return {
-    name: "Windows path",
-    ok: true,
-    level: "warn",
-    detail: `UNC path: ${projectDir}`,
-    hint: "Chrome may fail to launch from a network share. Use a local drive if render startup fails."
-  };
-}
-async function runEnvironmentChecks(options = {}) {
-  const outcomes = [];
-  const ffmpeg = checkFFmpeg();
-  outcomes.push(ffmpeg);
-  const ffprobe = checkFFprobe();
-  outcomes.push(ffprobe);
-  let browser;
-  if (options.includeBrowser) {
-    const chrome = await checkChrome(options.browserPath);
-    outcomes.push(chrome);
-    if (chrome.ok && chrome.path) {
-      browser = {
-        executablePath: chrome.path,
-        source: options.browserPath ? "env" : "cache"
-      };
-    }
-  }
-  if (options.includeDisk) {
-    const diskPaths = [...new Set(options.diskPaths ?? [options.projectDir ?? "."])];
-    outcomes.push(...diskPaths.map((path2) => checkDisk(path2)));
-  }
-  if (options.includeWindowsUnc) {
-    const unc = checkWindowsUncPath(options.projectDir);
-    if (unc) outcomes.push(unc);
-  }
-  return {
-    outcomes,
-    ...ffmpeg.ok && ffmpeg.path ? { ffmpegPath: ffmpeg.path } : {},
-    ...ffprobe.path ? { ffprobePath: ffprobe.path } : {},
-    ...browser ? { browser } : {}
-  };
-}
-var init_preflight = __esm({
-  "src/browser/preflight.ts"() {
-    "use strict";
-    init_manager2();
-    init_ffmpeg();
-    init_linuxDeps();
-    init_system();
-  }
-});
-
 // src/browser/macosOldChromeCrash.ts
 function isMacosOldChromeCrashError(errorMessage2) {
   if (!/Failed to launch the browser process/i.test(errorMessage2)) return false;
@@ -143021,16 +143322,16 @@ async function renderDocker(projectDir, outputPath, options) {
     console.log("");
   }
   try {
-    await new Promise((resolvePromise, reject) => {
+    await new Promise((resolvePromise, reject2) => {
       const child = spawn15("docker", dockerArgs, {
         // When quiet, still show stderr so container errors surface
         stdio: options.quiet ? ["pipe", "pipe", "inherit"] : "inherit"
       });
       child.on("close", (code) => {
         if (code === 0) resolvePromise();
-        else reject(new Error(`Docker render exited with code ${code}`));
+        else reject2(new Error(`Docker render exited with code ${code}`));
       });
-      child.on("error", (err) => reject(err));
+      child.on("error", (err) => reject2(err));
     });
   } catch (error) {
     handleRenderError(error, options, startTime, true, "Check Docker is running: docker info");
@@ -146044,7 +146345,7 @@ async function collectRotationSample(page, time) {
   return raw.flatMap((value) => parseRotationSample(value, time));
 }
 function parseRotationSample(value, time) {
-  if (!isRecord10(value)) return [];
+  if (!isRecord11(value)) return [];
   const selector = stringValue2(value, "selector");
   const cx = numberValue2(value, "cx");
   const cy = numberValue2(value, "cy");
@@ -146070,7 +146371,7 @@ function requiredNumbers(value, keys2) {
   return out;
 }
 function parseOffPivotRotationSample(value) {
-  if (!isRecord10(value)) return [];
+  if (!isRecord11(value)) return [];
   const selector = stringValue2(value, "selector");
   const nums = requiredNumbers(value, OFF_PIVOT_REQUIRED_NUMBERS);
   if (!selector || !nums) return [];
@@ -146322,7 +146623,7 @@ async function finishContrast(page, screenshot, time, candidates) {
 }
 function parsePreparedContrast(raw) {
   return raw.flatMap((value) => {
-    if (!isRecord10(value)) return [];
+    if (!isRecord11(value)) return [];
     const raw2 = Reflect.get(value, "candidate");
     const candidate = parseContrastCandidate(raw2);
     const anchor = parseAnchor(Reflect.get(value, "anchor"));
@@ -146330,7 +146631,7 @@ function parsePreparedContrast(raw) {
   });
 }
 function parseContrastCandidate(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const selector = stringValue2(value, "selector");
   const text2 = stringValue2(value, "text");
   const fg = rgbaValue(Reflect.get(value, "fg"));
@@ -146339,7 +146640,7 @@ function parseContrastCandidate(value) {
   return selector && text2 !== null && fg && large !== null && bbox ? { selector, text: text2, fg, large, bbox } : null;
 }
 function parseFinishedContrast(value) {
-  if (!isRecord10(value)) return [];
+  if (!isRecord11(value)) return [];
   const selector = stringValue2(value, "selector");
   const text2 = stringValue2(value, "text");
   const ratio = numberValue2(value, "ratio");
@@ -146360,7 +146661,7 @@ function joinContrastEntries(finished2, prepared) {
   });
 }
 function parseLayoutIssue(value) {
-  if (!isRecord10(value)) return [];
+  if (!isRecord11(value)) return [];
   const code = layoutCodeValue(Reflect.get(value, "code"));
   const severity = severityValue(Reflect.get(value, "severity"));
   const time = numberValue2(value, "time");
@@ -146373,7 +146674,7 @@ function parseLayoutIssue(value) {
   return [issue];
 }
 function parseGeometryCandidate(value, time) {
-  if (!isRecord10(value)) return [];
+  if (!isRecord11(value)) return [];
   const rect = parseRect(Reflect.get(value, "rect"));
   const elementRect = parseRect(Reflect.get(value, "elementRect"));
   if (!rect || !elementRect) return [];
@@ -146421,9 +146722,9 @@ function assignOptionalLayoutFields(issue, value) {
   if (coveredFraction !== null) issue.coveredFraction = coveredFraction;
 }
 function recordField(value, key2) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const field = Reflect.get(value, key2);
-  return isRecord10(field) ? field : null;
+  return isRecord11(field) ? field : null;
 }
 function parseMotionFrame(value, time, selectors, scopes) {
   const rawData = recordField(value, "data");
@@ -146440,14 +146741,14 @@ function parseMotionFrame(value, time, selectors, scopes) {
   return { time, data: data2, liveness };
 }
 function parseFrameSample(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const rect = parseRect(Reflect.get(value, "rect"));
   const opacity = numberValue2(value, "opacity");
   const visible = booleanValue(value, "visible");
   return rect && opacity !== null && visible !== null ? { rect, opacity, visible } : null;
 }
 function parseAnchor(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const selector = stringValue2(value, "selector");
   const sourceFile = stringValue2(value, "sourceFile");
   const time = numberValue2(value, "time");
@@ -146479,7 +146780,7 @@ function fallbackAnchor(request) {
   };
 }
 function parseBbox(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const x3 = numberValue2(value, "x");
   const y = numberValue2(value, "y");
   const width = numberValue2(value, "width") ?? numberValue2(value, "w");
@@ -146487,7 +146788,7 @@ function parseBbox(value) {
   return x3 !== null && y !== null && width !== null && height !== null ? { x: x3, y, width, height } : null;
 }
 function parseRect(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const left = numberValue2(value, "left");
   const top = numberValue2(value, "top");
   const right = numberValue2(value, "right");
@@ -146497,7 +146798,7 @@ function parseRect(value) {
   return left !== null && top !== null && right !== null && bottom !== null && width !== null && height !== null ? { left, top, right, bottom, width, height } : null;
 }
 function parseOverflow(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const overflow = {};
   for (const side of ["left", "right", "top", "bottom"]) {
     const amount = numberValue2(value, side);
@@ -146517,7 +146818,7 @@ function rgbaValue(value) {
   return [red, green, blue, alpha].every((channel) => typeof channel === "number") ? [red, green, blue, alpha] : null;
 }
 function stringRecord(value) {
-  if (!isRecord10(value)) return null;
+  if (!isRecord11(value)) return null;
   const record = {};
   for (const key2 of Object.keys(value)) {
     const entry = Reflect.get(value, key2);
@@ -146530,7 +146831,7 @@ function assignOptionalString(issue, source, key2) {
   const value = stringValue2(source, key2);
   if (value !== null) issue[key2] = value;
 }
-function isRecord10(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function stringValue2(value, key2) {
@@ -155011,7 +155312,7 @@ var require_p_retry = __commonJS({
       return error;
     };
     var isNetworkError = (errorMessage2) => networkErrorMsgs.includes(errorMessage2);
-    var pRetry2 = (input2, options) => new Promise((resolve77, reject) => {
+    var pRetry2 = (input2, options) => new Promise((resolve77, reject2) => {
       options = {
         onFailedAttempt: () => {
         },
@@ -155024,25 +155325,25 @@ var require_p_retry = __commonJS({
           resolve77(await input2(attemptNumber));
         } catch (error) {
           if (!(error instanceof Error)) {
-            reject(new TypeError(`Non-error was thrown: "${error}". You should only throw errors.`));
+            reject2(new TypeError(`Non-error was thrown: "${error}". You should only throw errors.`));
             return;
           }
           if (error instanceof AbortError3) {
             operation.stop();
-            reject(error.originalError);
+            reject2(error.originalError);
           } else if (error instanceof TypeError && !isNetworkError(error.message)) {
             operation.stop();
-            reject(error);
+            reject2(error);
           } else {
             decorateErrorWithCounts(error, attemptNumber, options);
             try {
               await options.onFailedAttempt(error);
             } catch (error2) {
-              reject(error2);
+              reject2(error2);
               return;
             }
             if (!operation.retry(error)) {
-              reject(operation.mainError());
+              reject2(operation.mainError());
             }
           }
         }
@@ -155686,8 +155987,8 @@ var require_helpers = __commonJS({
     function req(url, opts = {}) {
       const href = typeof url === "string" ? url : url.href;
       const req2 = (href.startsWith("https:") ? https2 : http4).request(url, opts);
-      const promise = new Promise((resolve77, reject) => {
-        req2.once("response", resolve77).once("error", reject).end();
+      const promise = new Promise((resolve77, reject2) => {
+        req2.once("response", resolve77).once("error", reject2).end();
       });
       req2.then = promise.then.bind(promise);
       return req2;
@@ -155864,7 +156165,7 @@ var require_parse_proxy_response = __commonJS({
     var debug_1 = __importDefault2(__require("debug"));
     var debug = (0, debug_1.default)("https-proxy-agent:parse-proxy-response");
     function parseProxyResponse(socket) {
-      return new Promise((resolve77, reject) => {
+      return new Promise((resolve77, reject2) => {
         let buffersLength = 0;
         const buffers = [];
         function read() {
@@ -155882,12 +156183,12 @@ var require_parse_proxy_response = __commonJS({
         function onend() {
           cleanup();
           debug("onend");
-          reject(new Error("Proxy connection ended before receiving CONNECT response"));
+          reject2(new Error("Proxy connection ended before receiving CONNECT response"));
         }
         function onerror(err) {
           cleanup();
           debug("onerror %o", err);
-          reject(err);
+          reject2(err);
         }
         function ondata(b2) {
           buffers.push(b2);
@@ -155903,7 +156204,7 @@ var require_parse_proxy_response = __commonJS({
           const firstLine = headerParts.shift();
           if (!firstLine) {
             socket.destroy();
-            return reject(new Error("No header received from proxy CONNECT response"));
+            return reject2(new Error("No header received from proxy CONNECT response"));
           }
           const firstLineParts = firstLine.split(" ");
           const statusCode = +firstLineParts[1];
@@ -155915,7 +156216,7 @@ var require_parse_proxy_response = __commonJS({
             const firstColon = header.indexOf(":");
             if (firstColon === -1) {
               socket.destroy();
-              return reject(new Error(`Invalid header from proxy CONNECT response: "${header}"`));
+              return reject2(new Error(`Invalid header from proxy CONNECT response: "${header}"`));
             }
             const key2 = header.slice(0, firstColon).toLowerCase();
             const value = header.slice(firstColon + 1).trimStart();
@@ -156344,9 +156645,9 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released reader");
       }
       function defaultReaderClosedPromiseInitialize(reader) {
-        reader._closedPromise = newPromise((resolve77, reject) => {
+        reader._closedPromise = newPromise((resolve77, reject2) => {
           reader._closedPromise_resolve = resolve77;
-          reader._closedPromise_reject = reject;
+          reader._closedPromise_reject = reject2;
         });
       }
       function defaultReaderClosedPromiseInitializeAsRejected(reader, reason) {
@@ -156519,9 +156820,9 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve77, reject) => {
+          const promise = newPromise((resolve77, reject2) => {
             resolvePromise = resolve77;
-            rejectPromise = reject;
+            rejectPromise = reject2;
           });
           const readRequest = {
             _chunkSteps: (chunk) => resolvePromise({ value: chunk, done: false }),
@@ -156625,9 +156926,9 @@ var require_ponyfill_es2018 = __commonJS({
           const reader = this._reader;
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve77, reject) => {
+          const promise = newPromise((resolve77, reject2) => {
             resolvePromise = resolve77;
-            rejectPromise = reject;
+            rejectPromise = reject2;
           });
           const readRequest = {
             _chunkSteps: (chunk) => {
@@ -157645,9 +157946,9 @@ var require_ponyfill_es2018 = __commonJS({
           }
           let resolvePromise;
           let rejectPromise;
-          const promise = newPromise((resolve77, reject) => {
+          const promise = newPromise((resolve77, reject2) => {
             resolvePromise = resolve77;
-            rejectPromise = reject;
+            rejectPromise = reject2;
           });
           const readIntoRequest = {
             _chunkSteps: (chunk) => resolvePromise({ value: chunk, done: false }),
@@ -157958,11 +158259,11 @@ var require_ponyfill_es2018 = __commonJS({
           wasAlreadyErroring = true;
           reason = void 0;
         }
-        const promise = newPromise((resolve77, reject) => {
+        const promise = newPromise((resolve77, reject2) => {
           stream._pendingAbortRequest = {
             _promise: void 0,
             _resolve: resolve77,
-            _reject: reject,
+            _reject: reject2,
             _reason: reason,
             _wasAlreadyErroring: wasAlreadyErroring
           };
@@ -157978,10 +158279,10 @@ var require_ponyfill_es2018 = __commonJS({
         if (state === "closed" || state === "errored") {
           return promiseRejectedWith(new TypeError(`The stream (in ${state} state) is not in the writable state and cannot be closed`));
         }
-        const promise = newPromise((resolve77, reject) => {
+        const promise = newPromise((resolve77, reject2) => {
           const closeRequest = {
             _resolve: resolve77,
-            _reject: reject
+            _reject: reject2
           };
           stream._closeRequest = closeRequest;
         });
@@ -157993,10 +158294,10 @@ var require_ponyfill_es2018 = __commonJS({
         return promise;
       }
       function WritableStreamAddWriteRequest(stream) {
-        const promise = newPromise((resolve77, reject) => {
+        const promise = newPromise((resolve77, reject2) => {
           const writeRequest = {
             _resolve: resolve77,
-            _reject: reject
+            _reject: reject2
           };
           stream._writeRequests.push(writeRequest);
         });
@@ -158611,9 +158912,9 @@ var require_ponyfill_es2018 = __commonJS({
         return new TypeError("Cannot " + name + " a stream using a released writer");
       }
       function defaultWriterClosedPromiseInitialize(writer) {
-        writer._closedPromise = newPromise((resolve77, reject) => {
+        writer._closedPromise = newPromise((resolve77, reject2) => {
           writer._closedPromise_resolve = resolve77;
-          writer._closedPromise_reject = reject;
+          writer._closedPromise_reject = reject2;
           writer._closedPromiseState = "pending";
         });
       }
@@ -158648,9 +158949,9 @@ var require_ponyfill_es2018 = __commonJS({
         writer._closedPromiseState = "resolved";
       }
       function defaultWriterReadyPromiseInitialize(writer) {
-        writer._readyPromise = newPromise((resolve77, reject) => {
+        writer._readyPromise = newPromise((resolve77, reject2) => {
           writer._readyPromise_resolve = resolve77;
-          writer._readyPromise_reject = reject;
+          writer._readyPromise_reject = reject2;
         });
         writer._readyPromiseState = "pending";
       }
@@ -158736,7 +159037,7 @@ var require_ponyfill_es2018 = __commonJS({
         source._disturbed = true;
         let shuttingDown = false;
         let currentWrite = promiseResolvedWith(void 0);
-        return newPromise((resolve77, reject) => {
+        return newPromise((resolve77, reject2) => {
           let abortAlgorithm;
           if (signal !== void 0) {
             abortAlgorithm = () => {
@@ -158879,7 +159180,7 @@ var require_ponyfill_es2018 = __commonJS({
               signal.removeEventListener("abort", abortAlgorithm);
             }
             if (isError) {
-              reject(error);
+              reject2(error);
             } else {
               resolve77(void 0);
             }
@@ -160298,9 +160599,9 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve77, reject) => {
+        controller._finishPromise = newPromise((resolve77, reject2) => {
           controller._finishPromise_resolve = resolve77;
-          controller._finishPromise_reject = reject;
+          controller._finishPromise_reject = reject2;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
         TransformStreamDefaultControllerClearAlgorithms(controller);
@@ -160325,9 +160626,9 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const readable = stream._readable;
-        controller._finishPromise = newPromise((resolve77, reject) => {
+        controller._finishPromise = newPromise((resolve77, reject2) => {
           controller._finishPromise_resolve = resolve77;
-          controller._finishPromise_reject = reject;
+          controller._finishPromise_reject = reject2;
         });
         const flushPromise = controller._flushAlgorithm();
         TransformStreamDefaultControllerClearAlgorithms(controller);
@@ -160356,9 +160657,9 @@ var require_ponyfill_es2018 = __commonJS({
           return controller._finishPromise;
         }
         const writable = stream._writable;
-        controller._finishPromise = newPromise((resolve77, reject) => {
+        controller._finishPromise = newPromise((resolve77, reject2) => {
           controller._finishPromise_resolve = resolve77;
-          controller._finishPromise_reject = reject;
+          controller._finishPromise_reject = reject2;
         });
         const cancelPromise = controller._cancelAlgorithm(reason);
         TransformStreamDefaultControllerClearAlgorithms(controller);
@@ -162326,7 +162627,7 @@ import zlib2 from "zlib";
 import Stream2, { PassThrough as PassThrough2, pipeline as pump } from "stream";
 import { Buffer as Buffer4 } from "buffer";
 async function fetch3(url, options_) {
-  return new Promise((resolve77, reject) => {
+  return new Promise((resolve77, reject2) => {
     const request = new Request2(url, options_);
     const { parsedURL, options } = getNodeRequestOptions(request);
     if (!supportedSchemas.has(parsedURL.protocol)) {
@@ -162343,7 +162644,7 @@ async function fetch3(url, options_) {
     let response = null;
     const abort = () => {
       const error = new AbortError("The operation was aborted.");
-      reject(error);
+      reject2(error);
       if (request.body && request.body instanceof Stream2.Readable) {
         request.body.destroy(error);
       }
@@ -162371,7 +162672,7 @@ async function fetch3(url, options_) {
       }
     };
     request_.on("error", (error) => {
-      reject(new FetchError(`request to ${request.url} failed, reason: ${error.message}`, "system", error));
+      reject2(new FetchError(`request to ${request.url} failed, reason: ${error.message}`, "system", error));
       finalize();
     });
     fixResponseChunkedTransferBadEnding(request_, (error) => {
@@ -162404,14 +162705,14 @@ async function fetch3(url, options_) {
           locationURL = location === null ? null : new URL(location, request.url);
         } catch {
           if (request.redirect !== "manual") {
-            reject(new FetchError(`uri requested responds with an invalid redirect URL: ${location}`, "invalid-redirect"));
+            reject2(new FetchError(`uri requested responds with an invalid redirect URL: ${location}`, "invalid-redirect"));
             finalize();
             return;
           }
         }
         switch (request.redirect) {
           case "error":
-            reject(new FetchError(`uri requested responds with a redirect, redirect mode is set to error: ${request.url}`, "no-redirect"));
+            reject2(new FetchError(`uri requested responds with a redirect, redirect mode is set to error: ${request.url}`, "no-redirect"));
             finalize();
             return;
           case "manual":
@@ -162421,7 +162722,7 @@ async function fetch3(url, options_) {
               break;
             }
             if (request.counter >= request.follow) {
-              reject(new FetchError(`maximum redirect reached at: ${request.url}`, "max-redirect"));
+              reject2(new FetchError(`maximum redirect reached at: ${request.url}`, "max-redirect"));
               finalize();
               return;
             }
@@ -162444,7 +162745,7 @@ async function fetch3(url, options_) {
               }
             }
             if (response_.statusCode !== 303 && request.body && options_.body instanceof Stream2.Readable) {
-              reject(new FetchError("Cannot follow redirect with body being a readable stream", "unsupported-redirect"));
+              reject2(new FetchError("Cannot follow redirect with body being a readable stream", "unsupported-redirect"));
               finalize();
               return;
             }
@@ -162462,7 +162763,7 @@ async function fetch3(url, options_) {
             return;
           }
           default:
-            return reject(new TypeError(`Redirect option '${request.redirect}' is not a valid value of RequestRedirect`));
+            return reject2(new TypeError(`Redirect option '${request.redirect}' is not a valid value of RequestRedirect`));
         }
       }
       if (signal) {
@@ -162472,7 +162773,7 @@ async function fetch3(url, options_) {
       }
       let body = pump(response_, new PassThrough2(), (error) => {
         if (error) {
-          reject(error);
+          reject2(error);
         }
       });
       if (process.version < "v12.10") {
@@ -162500,7 +162801,7 @@ async function fetch3(url, options_) {
       if (codings === "gzip" || codings === "x-gzip") {
         body = pump(body, zlib2.createGunzip(zlibOptions), (error) => {
           if (error) {
-            reject(error);
+            reject2(error);
           }
         });
         response = new Response2(body, responseOptions);
@@ -162510,20 +162811,20 @@ async function fetch3(url, options_) {
       if (codings === "deflate" || codings === "x-deflate") {
         const raw = pump(response_, new PassThrough2(), (error) => {
           if (error) {
-            reject(error);
+            reject2(error);
           }
         });
         raw.once("data", (chunk) => {
           if ((chunk[0] & 15) === 8) {
             body = pump(body, zlib2.createInflate(), (error) => {
               if (error) {
-                reject(error);
+                reject2(error);
               }
             });
           } else {
             body = pump(body, zlib2.createInflateRaw(), (error) => {
               if (error) {
-                reject(error);
+                reject2(error);
               }
             });
           }
@@ -162541,7 +162842,7 @@ async function fetch3(url, options_) {
       if (codings === "br") {
         body = pump(body, zlib2.createBrotliDecompress(), (error) => {
           if (error) {
-            reject(error);
+            reject2(error);
           }
         });
         response = new Response2(body, responseOptions);
@@ -162551,7 +162852,7 @@ async function fetch3(url, options_) {
       response = new Response2(body, responseOptions);
       resolve77(response);
     });
-    writeToStream(request_, request).catch(reject);
+    writeToStream(request_, request).catch(reject2);
   });
 }
 function fixResponseChunkedTransferBadEnding(request, errorCallback) {
@@ -168631,18 +168932,18 @@ var require_jwtaccess = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve77, reject) => {
+        return new Promise((resolve77, reject2) => {
           if (!inputStream) {
-            reject(new Error("Must pass in a stream containing the service account auth settings."));
+            reject2(new Error("Must pass in a stream containing the service account auth settings."));
           }
           let s2 = "";
-          inputStream.setEncoding("utf8").on("data", (chunk) => s2 += chunk).on("error", reject).on("end", () => {
+          inputStream.setEncoding("utf8").on("data", (chunk) => s2 += chunk).on("error", reject2).on("end", () => {
             try {
               const data2 = JSON.parse(s2);
               this.fromJSON(data2);
               resolve77();
             } catch (err) {
-              reject(err);
+              reject2(err);
             }
           });
         });
@@ -168879,18 +169180,18 @@ var require_jwtclient = __commonJS({
         }
       }
       fromStreamAsync(inputStream) {
-        return new Promise((resolve77, reject) => {
+        return new Promise((resolve77, reject2) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the service account auth settings.");
           }
           let s2 = "";
-          inputStream.setEncoding("utf8").on("error", reject).on("data", (chunk) => s2 += chunk).on("end", () => {
+          inputStream.setEncoding("utf8").on("error", reject2).on("data", (chunk) => s2 += chunk).on("end", () => {
             try {
               const data2 = JSON.parse(s2);
               this.fromJSON(data2);
               resolve77();
             } catch (e3) {
-              reject(e3);
+              reject2(e3);
             }
           });
         });
@@ -169021,18 +169322,18 @@ var require_refreshclient = __commonJS({
         }
       }
       async fromStreamAsync(inputStream) {
-        return new Promise((resolve77, reject) => {
+        return new Promise((resolve77, reject2) => {
           if (!inputStream) {
-            return reject(new Error("Must pass in a stream containing the user refresh token."));
+            return reject2(new Error("Must pass in a stream containing the user refresh token."));
           }
           let s2 = "";
-          inputStream.setEncoding("utf8").on("error", reject).on("data", (chunk) => s2 += chunk).on("end", () => {
+          inputStream.setEncoding("utf8").on("error", reject2).on("data", (chunk) => s2 += chunk).on("end", () => {
             try {
               const data2 = JSON.parse(s2);
               this.fromJSON(data2);
               return resolve77();
             } catch (err) {
-              return reject(err);
+              return reject2(err);
             }
           });
         });
@@ -170863,7 +171164,7 @@ var require_pluggable_auth_handler = __commonJS({
        * @return A promise that resolves with the executable response.
        */
       retrieveResponseFromExecutable(envMap) {
-        return new Promise((resolve77, reject) => {
+        return new Promise((resolve77, reject2) => {
           const child = childProcess.spawn(this.commandComponents[0], this.commandComponents.slice(1), {
             env: { ...process.env, ...Object.fromEntries(envMap) }
           });
@@ -170877,7 +171178,7 @@ var require_pluggable_auth_handler = __commonJS({
           const timeout = setTimeout(() => {
             child.removeAllListeners();
             child.kill();
-            return reject(new Error("The executable failed to finish within the timeout specified."));
+            return reject2(new Error("The executable failed to finish within the timeout specified."));
           }, this.timeoutMillis);
           child.on("close", (code) => {
             clearTimeout(timeout);
@@ -170888,12 +171189,12 @@ var require_pluggable_auth_handler = __commonJS({
                 return resolve77(response);
               } catch (error) {
                 if (error instanceof executable_response_1.ExecutableResponseError) {
-                  return reject(error);
+                  return reject2(error);
                 }
-                return reject(new executable_response_1.ExecutableResponseError(`The executable returned an invalid response: ${output}`));
+                return reject2(new executable_response_1.ExecutableResponseError(`The executable returned an invalid response: ${output}`));
               }
             } else {
-              return reject(new ExecutableError(output, code.toString()));
+              return reject2(new ExecutableError(output, code.toString()));
             }
           });
         });
@@ -171788,12 +172089,12 @@ var require_googleauth = __commonJS({
         }
       }
       fromStreamAsync(inputStream, options) {
-        return new Promise((resolve77, reject) => {
+        return new Promise((resolve77, reject2) => {
           if (!inputStream) {
             throw new Error("Must pass in a stream containing the Google auth settings.");
           }
           const chunks = [];
-          inputStream.setEncoding("utf8").on("error", reject).on("data", (chunk) => chunks.push(chunk)).on("end", () => {
+          inputStream.setEncoding("utf8").on("error", reject2).on("data", (chunk) => chunks.push(chunk)).on("end", () => {
             try {
               try {
                 const data2 = JSON.parse(chunks.join(""));
@@ -171811,7 +172112,7 @@ var require_googleauth = __commonJS({
                 return resolve77(client);
               }
             } catch (err) {
-              return reject(err);
+              return reject2(err);
             }
           });
         });
@@ -179656,7 +179957,7 @@ function __asyncGenerator2(thisArg, _arguments, generator) {
   }, i2;
   function awaitReturn(f3) {
     return function(v2) {
-      return Promise.resolve(v2).then(f3, reject);
+      return Promise.resolve(v2).then(f3, reject2);
     };
   }
   function verb(n2, f3) {
@@ -179677,12 +179978,12 @@ function __asyncGenerator2(thisArg, _arguments, generator) {
     }
   }
   function step(r2) {
-    r2.value instanceof __await2 ? Promise.resolve(r2.value.v).then(fulfill, reject) : settle(q2[0][2], r2);
+    r2.value instanceof __await2 ? Promise.resolve(r2.value.v).then(fulfill, reject2) : settle(q2[0][2], r2);
   }
   function fulfill(value) {
     resume("next", value);
   }
-  function reject(value) {
+  function reject2(value) {
     resume("throw", value);
   }
   function settle(f3, v2) {
@@ -179697,15 +179998,15 @@ function __asyncValues2(o) {
   }, i2);
   function verb(n2) {
     i2[n2] = o[n2] && function(v2) {
-      return new Promise(function(resolve77, reject) {
-        v2 = o[n2](v2), settle(resolve77, reject, v2.done, v2.value);
+      return new Promise(function(resolve77, reject2) {
+        v2 = o[n2](v2), settle(resolve77, reject2, v2.done, v2.value);
       });
     };
   }
-  function settle(resolve77, reject, d2, v2) {
+  function settle(resolve77, reject2, d2, v2) {
     Promise.resolve(v2).then(function(v3) {
       resolve77({ value: v3, done: d2 });
-    }, reject);
+    }, reject2);
   }
 }
 function isValidResponse(response) {
@@ -195091,11 +195392,11 @@ function round4(value) {
 function average(values) {
   return values.reduce((sum, value) => sum + value, 0) / Math.max(1, values.length);
 }
-function isRecord11(value) {
+function isRecord12(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function asRecord(value) {
-  return isRecord11(value) ? value : {};
+  return isRecord12(value) ? value : {};
 }
 function probeMedia2(mediaPath, ffprobePath) {
   try {
@@ -195627,7 +195928,7 @@ function containsColorGradingVariableRef(value) {
   if (typeof value !== "object" || value === null) return false;
   return Object.values(value).some(containsColorGradingVariableRef);
 }
-function isRecord12(value) {
+function isRecord13(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseStoredGrading(raw) {
@@ -195639,16 +195940,16 @@ function parseStoredGrading(raw) {
   }
 }
 function mergeGradingPatch(current2, patch) {
-  if (!isRecord12(current2) || !isRecord12(patch)) return patch;
+  if (!isRecord13(current2) || !isRecord13(patch)) return patch;
   const merged = { ...current2 };
   for (const [key2, value] of Object.entries(patch)) {
-    merged[key2] = isRecord12(value) && isRecord12(merged[key2]) ? mergeGradingPatch(merged[key2], value) : value;
+    merged[key2] = isRecord13(value) && isRecord13(merged[key2]) ? mergeGradingPatch(merged[key2], value) : value;
   }
   return merged;
 }
 function serializeGradingPatch(before3, patch) {
   assertKnownGradingShape(patch);
-  if (isColorGradingVariableRef(before3) && isRecord12(patch)) {
+  if (isColorGradingVariableRef(before3) && isRecord13(patch)) {
     throw new Error("Cannot merge a grading patch into an unresolved whole-grade variable");
   }
   const current2 = typeof before3 === "string" && !isColorGradingVariableRef(before3) ? { preset: before3 } : before3;
@@ -196021,7 +196322,7 @@ import {
 import { tmpdir as tmpdir17 } from "os";
 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) {
+function isRecord14(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function hasOwn3(record, key2) {
@@ -196082,22 +196383,22 @@ function serializedGradingForCell(cell) {
   return serializeHfColorGrading(normalized2);
 }
 function lutSrcFromGrading(grading) {
-  if (!isRecord13(grading) || !hasOwn3(grading, "lut")) return null;
+  if (!isRecord14(grading) || !hasOwn3(grading, "lut")) return null;
   const lut = grading.lut;
   if (typeof lut === "string" && lut.trim()) return lut.trim();
-  if (!isRecord13(lut)) return null;
+  if (!isRecord14(lut)) return null;
   const src = lut.src;
   return typeof src === "string" && src.trim() ? src.trim() : null;
 }
 function rewriteGradingLutSrc(grading, src) {
-  if (!isRecord13(grading) || !hasOwn3(grading, "lut")) return grading;
+  if (!isRecord14(grading) || !hasOwn3(grading, "lut")) return grading;
   const lut = grading.lut;
   const next = cloneRecord(grading);
   if (typeof lut === "string") {
     next.lut = { src };
     return next;
   }
-  if (isRecord13(lut)) {
+  if (isRecord14(lut)) {
     const nextLut = cloneRecord(lut);
     nextLut.src = src;
     next.lut = nextLut;
@@ -196118,7 +196419,7 @@ function parseGradesFile(filePath) {
     throw new Error("Grades file must be a JSON array of { label, grading } objects");
   }
   return parsed.map((entry, index) => {
-    if (!isRecord13(entry)) {
+    if (!isRecord14(entry)) {
       throw new Error(`Grade entry ${index + 1} must be an object with label and grading`);
     }
     const label2 = entry.label;
@@ -197282,10 +197583,10 @@ async function streamToFile(url, destPath) {
   if (!r2.body) throw new Error(`empty response body for ${url}`);
   const file = createWriteStream4(destPath, { flags: "wx" });
   let streamError = null;
-  const streamErrored = new Promise((_, reject) => {
+  const streamErrored = new Promise((_, reject2) => {
     file.once("error", (e3) => {
       streamError = e3;
-      reject(e3);
+      reject2(e3);
     });
   });
   let bytes = 0;
@@ -198914,9 +199215,9 @@ async function withRemainingBudget(work, remainingMs, label2) {
   try {
     return await Promise.race([
       work,
-      new Promise((_resolve, reject) => {
+      new Promise((_resolve, reject2) => {
         timer = setTimeout(() => {
-          reject(new StageBudgetTimeoutError(label2, remainingMs));
+          reject2(new StageBudgetTimeoutError(label2, remainingMs));
         }, remainingMs);
       })
     ]);
@@ -199627,9 +199928,9 @@ function resolveVisionRequestTimeoutMs() {
 async function runBoundedVisionRequest(request, timeoutMs) {
   const controller = new AbortController();
   let timer;
-  const timeout = new Promise((_resolve, reject) => {
+  const timeout = new Promise((_resolve, reject2) => {
     timer = setTimeout(() => {
-      reject(new VisionRequestTimeoutError(timeoutMs));
+      reject2(new VisionRequestTimeoutError(timeoutMs));
       controller.abort();
     }, timeoutMs);
   });
@@ -202347,7 +202648,7 @@ var init_render2 = __esm({
     "use strict";
     init_commandResult();
     init_colors();
-    init_variables();
+    init_variables2();
     init_dimensions();
     init_state();
   }
@@ -202599,7 +202900,7 @@ var init_render_batch = __esm({
     init_commandResult();
     init_colors();
     init_format();
-    init_variables();
+    init_variables2();
     init_errorMessage();
     init_dimensions();
     init_state();
@@ -203950,7 +204251,7 @@ var init_cloudrun = __esm({
     init_dist();
     init_parseOutputResolution();
     init_colors();
-    init_variables();
+    init_variables2();
     init_errorMessage();
     init_compositionFps();
     examples34 = [
@@ -204238,10 +204539,10 @@ function signalAbortError(signal) {
   return reason instanceof Error ? reason : new Error("Poll aborted");
 }
 function defaultAbortableSleep(signal) {
-  return (ms) => new Promise((resolve77, reject) => {
+  return (ms) => new Promise((resolve77, reject2) => {
     const onAbort = () => {
       clearTimeout(timer);
-      reject(signalAbortError(signal));
+      reject2(signalAbortError(signal));
     };
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
@@ -204320,7 +204621,7 @@ async function downloadToFile(url, destPath, options = {}) {
   return { path: destPath, bytes };
 }
 function waitForDrain(file, signal) {
-  return new Promise((resolve77, reject) => {
+  return new Promise((resolve77, reject2) => {
     const cleanup = () => {
       file.off("drain", onDrain);
       file.off("error", onError);
@@ -204333,16 +204634,16 @@ function waitForDrain(file, signal) {
     };
     const onError = (err) => {
       cleanup();
-      reject(err);
+      reject2(err);
     };
     const onClose = () => {
       cleanup();
-      reject(new Error("write stream closed before drain"));
+      reject2(new Error("write stream closed before drain"));
     };
     const onAbort = () => {
       cleanup();
       const reason = signal?.reason;
-      reject(reason instanceof Error ? reason : new Error("Download aborted"));
+      reject2(reason instanceof Error ? reason : new Error("Download aborted"));
     };
     file.once("drain", onDrain);
     file.once("error", onError);
@@ -205224,7 +205525,7 @@ var init_render3 = __esm({
     init_project();
     init_errorMessage();
     init_publishProject();
-    init_variables();
+    init_variables2();
     init_updateCheck();
     init_cloud();
     init_errors2();
@@ -206147,10 +206448,10 @@ async function collectApiKey(inline) {
   return await promptForKey();
 }
 async function readAllWithTimeout(stream, timeoutMs) {
-  return await new Promise((resolve77, reject) => {
+  return await new Promise((resolve77, reject2) => {
     const chunks = [];
     const timer = setTimeout(() => {
-      reject(new Error(`Timed out waiting for stdin (${timeoutMs}ms). Pipe the key explicitly.`));
+      reject2(new Error(`Timed out waiting for stdin (${timeoutMs}ms). Pipe the key explicitly.`));
     }, timeoutMs);
     stream.on("data", (chunk) => {
       chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
@@ -206161,7 +206462,7 @@ async function readAllWithTimeout(stream, timeoutMs) {
     });
     stream.on("error", (err) => {
       clearTimeout(timer);
-      reject(err);
+      reject2(err);
     });
   });
 }
@@ -206714,7 +207015,7 @@ async function readFigmaErrorMessage(res) {
   }
   try {
     const body = JSON.parse(text2);
-    if (isRecord14(body)) {
+    if (isRecord15(body)) {
       if (typeof body.err === "string")
         return body.err;
       if (typeof body.message === "string")
@@ -206729,20 +207030,20 @@ function requireNodeId(ref2) {
     throw new Error(`figma ref ${ref2.fileKey} has no nodeId`);
   return ref2.nodeId;
 }
-function isRecord14(value) {
+function isRecord15(value) {
   return typeof value === "object" && value !== null;
 }
 function optionalString(value) {
   return typeof value === "string" ? value : void 0;
 }
 function toVariablePayload(payload) {
-  if (!isRecord14(payload) || typeof payload.name !== "string")
+  if (!isRecord15(payload) || typeof payload.name !== "string")
     return null;
   return {
     name: payload.name,
     key: optionalString(payload.key),
     resolvedType: optionalString(payload.resolvedType),
-    valuesByMode: isRecord14(payload.valuesByMode) ? payload.valuesByMode : void 0,
+    valuesByMode: isRecord15(payload.valuesByMode) ? payload.valuesByMode : void 0,
     variableCollectionId: optionalString(payload.variableCollectionId)
   };
 }
@@ -206817,7 +207118,7 @@ function createFigmaClient(options) {
         scopeHint: SCOPE_HINTS.fileContent,
         endpoint: "images"
       });
-      const images = isRecord14(body) && isRecord14(body.images) ? body.images : {};
+      const images = isRecord15(body) && isRecord15(body.images) ? body.images : {};
       return nodeIds.map((nodeId) => {
         const url = images[nodeId];
         return {
@@ -206832,8 +207133,8 @@ function createFigmaClient(options) {
         scopeHint: SCOPE_HINTS.fileContent,
         endpoint: "files_images"
       });
-      const meta = isRecord14(body) && isRecord14(body.meta) ? body.meta : {};
-      const images = isRecord14(meta.images) ? meta.images : {};
+      const meta = isRecord15(body) && isRecord15(body.meta) ? body.meta : {};
+      const images = isRecord15(meta.images) ? meta.images : {};
       const out = /* @__PURE__ */ new Map();
       for (const [ref2, url] of Object.entries(images)) {
         if (typeof url === "string")
@@ -206846,9 +207147,9 @@ function createFigmaClient(options) {
         enterpriseGated: true,
         endpoint: "variables_local"
       });
-      const meta = isRecord14(body) && isRecord14(body.meta) ? body.meta : {};
-      const variables = isRecord14(meta.variables) ? meta.variables : {};
-      const collections = isRecord14(meta.variableCollections) ? meta.variableCollections : {};
+      const meta = isRecord15(body) && isRecord15(body.meta) ? body.meta : {};
+      const variables = isRecord15(meta.variables) ? meta.variables : {};
+      const collections = isRecord15(meta.variableCollections) ? meta.variableCollections : {};
       const typed = {};
       for (const [id, payload] of Object.entries(variables)) {
         const v2 = toVariablePayload(payload);
@@ -206862,9 +207163,9 @@ function createFigmaClient(options) {
         scopeHint: SCOPE_HINTS.libraryContent,
         endpoint: "styles"
       });
-      const meta = isRecord14(body) && isRecord14(body.meta) ? body.meta : {};
+      const meta = isRecord15(body) && isRecord15(body.meta) ? body.meta : {};
       const styles = Array.isArray(meta.styles) ? meta.styles : [];
-      return styles.filter((s2) => isRecord14(s2) && typeof s2.key === "string" && typeof s2.name === "string" && typeof s2.style_type === "string");
+      return styles.filter((s2) => isRecord15(s2) && typeof s2.key === "string" && typeof s2.name === "string" && typeof s2.style_type === "string");
     },
     async nodeTree(ref2) {
       const nodeId = requireNodeId(ref2);
@@ -206873,10 +207174,10 @@ function createFigmaClient(options) {
         scopeHint: SCOPE_HINTS.fileContent,
         endpoint: "files_nodes"
       });
-      const nodes = isRecord14(body) && isRecord14(body.nodes) ? body.nodes : {};
+      const nodes = isRecord15(body) && isRecord15(body.nodes) ? body.nodes : {};
       const entry = nodes[nodeId];
-      const doc = isRecord14(entry) ? entry.document : void 0;
-      if (!isRecord14(doc) || typeof doc.id !== "string" || typeof doc.name !== "string" || typeof doc.type !== "string")
+      const doc = isRecord15(entry) ? entry.document : void 0;
+      if (!isRecord15(doc) || typeof doc.id !== "string" || typeof doc.name !== "string" || typeof doc.type !== "string")
         throw new FigmaClientError("NODE_NOT_FOUND", `node ${nodeId} not found in ${ref2.fileKey}`, void 0, "files_nodes");
       return { ...doc, id: doc.id, name: doc.name, type: doc.type };
     },
@@ -206885,8 +207186,8 @@ function createFigmaClient(options) {
         scopeHint: SCOPE_HINTS.fileMetadata,
         endpoint: "file_meta"
       });
-      const version2 = isRecord14(body) && typeof body.version === "string" ? body.version : "";
-      const lastModified = isRecord14(body) && typeof body.lastModified === "string" ? body.lastModified : "";
+      const version2 = isRecord15(body) && typeof body.version === "string" ? body.version : "";
+      const lastModified = isRecord15(body) && typeof body.lastModified === "string" ? body.lastModified : "";
       return { version: version2, lastModified };
     }
   };
@@ -207228,11 +207529,11 @@ import { join as join134 } from "path";
 function bindingsPath(projectDir) {
   return join134(mediaDir(projectDir), BINDINGS_FILE);
 }
-function isRecord15(value) {
+function isRecord16(value) {
   return typeof value === "object" && value !== null;
 }
 function isBindingRecord(value) {
-  return isRecord15(value) && value.kind === "binding" && typeof value.figmaId === "string" && typeof value.sourceFileKey === "string" && typeof value.compositionVariableId === "string" && typeof value.version === "string";
+  return isRecord16(value) && value.kind === "binding" && typeof value.figmaId === "string" && typeof value.sourceFileKey === "string" && typeof value.compositionVariableId === "string" && typeof value.version === "string";
 }
 function readLines(projectDir) {
   return readJsonlValues(bindingsPath(projectDir));
@@ -207258,14 +207559,14 @@ var init_bindings = __esm({
 });
 
 // ../core/dist/figma/color.js
-function isRecord16(value) {
+function isRecord17(value) {
   return typeof value === "object" && value !== null;
 }
 function toHexByte(channel) {
   return Math.round(channel * 255).toString(16).padStart(2, "0").toUpperCase();
 }
 function figmaColorToCss(value, extraOpacity = 1) {
-  if (!isRecord16(value))
+  if (!isRecord17(value))
     return null;
   const { r: r2, g, b: b2, a } = value;
   if (typeof r2 !== "number" || typeof g !== "number" || typeof b2 !== "number")
@@ -207283,11 +207584,11 @@ var init_color = __esm({
 });
 
 // ../core/dist/figma/nodeDocument.js
-function isRecord17(value) {
+function isRecord18(value) {
   return typeof value === "object" && value !== null;
 }
 function asNodeDocument(value) {
-  if (isRecord17(value) && typeof value.id === "string" && typeof value.name === "string" && typeof value.type === "string") {
+  if (isRecord18(value) && typeof value.id === "string" && typeof value.name === "string" && typeof value.type === "string") {
     return { ...value, id: value.id, name: value.name, type: value.type };
   }
   return null;
@@ -207310,17 +207611,17 @@ var init_nodeDocument = __esm({
 });
 
 // ../core/dist/figma/resolveBindings.js
-function isRecord18(value) {
+function isRecord19(value) {
   return typeof value === "object" && value !== null;
 }
 function aliasId(value) {
-  if (isRecord18(value) && value.type === "VARIABLE_ALIAS" && typeof value.id === "string")
+  if (isRecord19(value) && value.type === "VARIABLE_ALIAS" && typeof value.id === "string")
     return value.id;
   return null;
 }
 function boundVariableSites(node, out) {
   const bound = node.boundVariables;
-  if (!isRecord18(bound))
+  if (!isRecord19(bound))
     return;
   for (const [property, value] of Object.entries(bound)) {
     const candidates = Array.isArray(value) ? value : [value];
@@ -207333,7 +207634,7 @@ function boundVariableSites(node, out) {
 }
 function styleSites(node, out) {
   const styles = node.styles;
-  if (!isRecord18(styles))
+  if (!isRecord19(styles))
     return;
   for (const [slot, styleId] of Object.entries(styles)) {
     if (typeof styleId === "string" && styleId.length > 0)
@@ -207379,12 +207680,12 @@ var init_resolveBindings = __esm({
 });
 
 // ../core/dist/figma/nodeToHtml.js
-function isRecord19(value) {
+function isRecord20(value) {
   return typeof value === "object" && value !== null;
 }
 function boxOf(node) {
   const b2 = node.absoluteBoundingBox;
-  if (isRecord19(b2) && typeof b2.x === "number" && typeof b2.y === "number" && typeof b2.width === "number" && typeof b2.height === "number")
+  if (isRecord20(b2) && typeof b2.x === "number" && typeof b2.y === "number" && typeof b2.width === "number" && typeof b2.height === "number")
     return { x: b2.x, y: b2.y, width: b2.width, height: b2.height };
   return null;
 }
@@ -207399,7 +207700,7 @@ function firstVisibleFill(node) {
   if (!Array.isArray(fills))
     return null;
   for (const fill of fills) {
-    if (isRecord19(fill) && fill.visible !== false)
+    if (isRecord20(fill) && fill.visible !== false)
       return fill;
   }
   return null;
@@ -207410,7 +207711,7 @@ function gradientCss(fill) {
     return null;
   const parts = [];
   for (const stop of stops) {
-    if (!isRecord19(stop) || typeof stop.position !== "number")
+    if (!isRecord20(stop) || typeof stop.position !== "number")
       return null;
     const color = figmaColorToCss(stop.color);
     if (color === null)
@@ -207435,7 +207736,7 @@ function hasImageFill(node) {
   return firstVisibleFill(node)?.type === "IMAGE";
 }
 function dropShadowCss(effect) {
-  if (!isRecord19(effect.offset))
+  if (!isRecord20(effect.offset))
     return null;
   const color = figmaColorToCss(effect.color);
   const { x: x3, y } = effect.offset;
@@ -207445,7 +207746,7 @@ function dropShadowCss(effect) {
   return `box-shadow: ${round5(x3)}px ${round5(y)}px ${round5(radius)}px ${color}`;
 }
 function effectCss(effect) {
-  if (!isRecord19(effect) || effect.visible === false)
+  if (!isRecord20(effect) || effect.visible === false)
     return null;
   if (effect.type === "DROP_SHADOW")
     return dropShadowCss(effect);
@@ -207465,7 +207766,7 @@ function effectsCss(node, styles) {
 }
 function textCss(node, styles) {
   const s2 = node.style;
-  if (!isRecord19(s2))
+  if (!isRecord20(s2))
     return;
   if (typeof s2.fontFamily === "string")
     styles.push(`font-family: '${s2.fontFamily.replace(/['"\\;]/g, "")}'`);
@@ -207613,13 +207914,13 @@ var init_nodeToHtml = __esm({
 });
 
 // ../core/dist/figma/tokensToVariables.js
-function isRecord20(value) {
+function isRecord21(value) {
   return typeof value === "object" && value !== null;
 }
 function baseModeValue(payload, collections) {
   const modes = payload.valuesByMode ?? {};
   const collection = collections[payload.variableCollectionId ?? ""];
-  if (isRecord20(collection) && typeof collection.defaultModeId === "string") {
+  if (isRecord21(collection) && typeof collection.defaultModeId === "string") {
     const preferred = modes[collection.defaultModeId];
     if (preferred !== void 0)
       return preferred;
@@ -207630,7 +207931,7 @@ function baseModeValue(payload, collections) {
 }
 function collectionName(payload, collections) {
   const collection = collections[payload.variableCollectionId ?? ""];
-  return isRecord20(collection) && typeof collection.name === "string" ? collection.name : null;
+  return isRecord21(collection) && typeof collection.name === "string" ? collection.name : null;
 }
 function resolveValue2(start, vars) {
   const chain = [];
@@ -207643,7 +207944,7 @@ function resolveValue2(start, vars) {
     if (!payload)
       return null;
     const value = baseModeValue(payload, vars.variableCollections);
-    if (isRecord20(value) && value.type === "VARIABLE_ALIAS" && typeof value.id === "string") {
+    if (isRecord21(value) && value.type === "VARIABLE_ALIAS" && typeof value.id === "string") {
       currentId = value.id;
       continue;
     }