hyperframes 0.4.10 → 0.4.11

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.4.10" : "0.0.0-dev";
+    VERSION = true ? "0.4.11" : "0.0.0-dev";
   }
 });
 
@@ -3476,9 +3476,25 @@ var init_media = __esm({
       // video_nested_in_timed_element
       ({ source, tags }) => {
         const findings = [];
+        const voidElements3 = /* @__PURE__ */ new Set([
+          "area",
+          "base",
+          "br",
+          "col",
+          "embed",
+          "hr",
+          "img",
+          "input",
+          "link",
+          "meta",
+          "source",
+          "track",
+          "wbr"
+        ]);
         const timedTagPositions = [];
         for (const tag of tags) {
           if (tag.name === "video" || tag.name === "audio") continue;
+          if (voidElements3.has(tag.name)) continue;
           if (readAttr(tag.raw, "data-composition-id")) continue;
           if (readAttr(tag.raw, "data-start")) {
             timedTagPositions.push({
@@ -3646,7 +3662,9 @@ function extractGsapWindows(script) {
   let index = 0;
   while ((match = methodPattern.exec(script)) !== null && index < parsed.animations.length) {
     const raw = match[0];
-    const meta = parseGsapWindowMeta(match[1] ?? "", match[2] ?? "");
+    const args = match[2] ?? "";
+    if (!/^\s*["']/.test(args)) continue;
+    const meta = parseGsapWindowMeta(match[1] ?? "", args);
     const animation = parsed.animations[index];
     index += 1;
     if (!animation) continue;
@@ -20997,6 +21015,12 @@ async function createCaptureSession(serverUrl, outputDir, options, onBeforeCaptu
   );
   const { browser, captureMode } = await acquireBrowser(chromeArgs, config);
   const page = await browser.newPage();
+  await page.evaluateOnNewDocument(() => {
+    const w = window;
+    if (typeof w.__name !== "function") {
+      w.__name = (fn, _name) => fn;
+    }
+  });
   const browserVersion = await browser.version();
   const expectedMajor = config?.expectedChromiumMajor;
   if (Number.isFinite(expectedMajor)) {
@@ -21101,9 +21125,10 @@ async function initializeSession(session) {
         `[FrameCapture] window.__hf not ready after ${pageReadyTimeout2}ms. Page must expose window.__hf = { duration, seek }.`
       );
     }
+    const skipIdsLiteral = JSON.stringify(session.options.skipReadinessVideoIds ?? []);
     const videosReady = await pollPageExpression(
       page,
-      `document.querySelectorAll("video").length === 0 || Array.from(document.querySelectorAll("video")).every(v => v.readyState >= 1)`,
+      `(() => { const skip = new Set(${skipIdsLiteral}); const vids = Array.from(document.querySelectorAll("video")).filter(v => !skip.has(v.id)); return vids.length === 0 || vids.every(v => v.readyState >= 1); })()`,
       pageReadyTimeout2
     );
     if (!videosReady) {
@@ -21163,10 +21188,11 @@ async function initializeSession(session) {
       `[FrameCapture] window.__hf not ready after ${pageReadyTimeout}ms. Page must expose window.__hf = { duration, seek }.`
     );
   }
+  const beginframeSkipIdsLiteral = JSON.stringify(session.options.skipReadinessVideoIds ?? []);
   const videoDeadline = Date.now() + (session.config?.playerReadyTimeout ?? DEFAULT_CONFIG2.playerReadyTimeout);
   while (Date.now() < videoDeadline) {
     const videosReady = await page.evaluate(
-      `document.querySelectorAll("video").length === 0 || Array.from(document.querySelectorAll("video")).every(v => v.readyState >= 1)`
+      `(() => { const skip = new Set(${beginframeSkipIdsLiteral}); const vids = Array.from(document.querySelectorAll("video")).filter(v => !skip.has(v.id)); return vids.length === 0 || vids.every(v => v.readyState >= 1); })()`
     );
     if (videosReady) break;
     await new Promise((r2) => setTimeout(r2, 100));
@@ -22184,6 +22210,8 @@ var init_streamingEncoder = __esm({
 
 // ../engine/src/utils/ffprobe.ts
 import { spawn as spawn6 } from "child_process";
+import { readFileSync as readFileSync14 } from "fs";
+import { extname as extname4 } from "path";
 function runFfprobe(args) {
   return new Promise((resolve35, reject) => {
     const proc = spawn6("ffprobe", args);
@@ -22220,6 +22248,67 @@ function parseProbeJson(stdout2) {
     );
   }
 }
+function crc32(buf) {
+  let crc = 4294967295;
+  for (let i2 = 0; i2 < buf.length; i2++) {
+    crc ^= buf[i2] ?? 0;
+    for (let bit = 0; bit < 8; bit++) {
+      const mask = -(crc & 1);
+      crc = crc >>> 1 ^ 3988292384 & mask;
+    }
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+function extractPngMetadataFromBuffer(buf) {
+  if (buf.length < 8 || buf[0] !== 137 || buf[1] !== 80 || buf[2] !== 78 || buf[3] !== 71 || buf[4] !== 13 || buf[5] !== 10 || buf[6] !== 26 || buf[7] !== 10) {
+    return null;
+  }
+  let width = 0;
+  let height = 0;
+  let seenIdat = false;
+  let pos = 8;
+  while (pos + 12 <= buf.length) {
+    const chunkLen = buf.readUInt32BE(pos);
+    const chunkType = buf.toString("ascii", pos + 4, pos + 8);
+    if (pos + 12 + chunkLen > buf.length) return null;
+    const chunkData = buf.subarray(pos + 8, pos + 8 + chunkLen);
+    const chunkCrc = buf.readUInt32BE(pos + 8 + chunkLen);
+    const chunkBytes = Buffer.concat([Buffer.from(chunkType, "ascii"), chunkData]);
+    if (crc32(chunkBytes) !== chunkCrc) return null;
+    if (chunkType === "IHDR" && chunkLen >= 8) {
+      width = buf.readUInt32BE(pos + 8);
+      height = buf.readUInt32BE(pos + 12);
+    }
+    if (chunkType === "IDAT") {
+      seenIdat = true;
+    }
+    if (chunkType === "cICP" && chunkLen === 4 && !seenIdat) {
+      const primariesCode = chunkData[0] ?? 0;
+      const transferCode = chunkData[1] ?? 0;
+      const matrixCode = chunkData[2] ?? 0;
+      return {
+        width,
+        height,
+        colorSpace: {
+          colorPrimaries: primariesCode === 9 ? "bt2020" : primariesCode === 1 ? "bt709" : `unknown-${primariesCode}`,
+          colorTransfer: transferCode === 16 ? "smpte2084" : transferCode === 18 ? "arib-std-b67" : transferCode === 1 ? "bt709" : `unknown-${transferCode}`,
+          colorSpace: matrixCode === 9 ? "bt2020nc" : matrixCode === 0 ? "gbr" : `unknown-${matrixCode}`
+        }
+      };
+    }
+    if (chunkType === "IEND") break;
+    pos += 12 + chunkLen;
+  }
+  return width > 0 && height > 0 ? { width, height, colorSpace: null } : null;
+}
+function extractStillImageMetadata(filePath) {
+  if (extname4(filePath).toLowerCase() !== ".png") return null;
+  try {
+    return extractPngMetadataFromBuffer(readFileSync14(filePath));
+  } catch {
+    return null;
+  }
+}
 function parseFrameRate(frameRateStr) {
   if (!frameRateStr) return 0;
   const parts = frameRateStr.split("/");
@@ -22234,18 +22323,38 @@ async function extractVideoMetadata(filePath) {
   const cached2 = videoMetadataCache.get(filePath);
   if (cached2) return cached2;
   const probePromise = (async () => {
-    const stdout2 = await runFfprobe([
-      "-v",
-      "quiet",
-      "-print_format",
-      "json",
-      "-show_format",
-      "-show_streams",
-      filePath
-    ]);
-    const output = parseProbeJson(stdout2);
-    const videoStream = output.streams.find((s2) => s2.codec_type === "video");
-    if (!videoStream) throw new Error("[FFmpeg] No video stream found");
+    const stillImageMeta = extractStillImageMetadata(filePath);
+    let output = null;
+    try {
+      const stdout2 = await runFfprobe([
+        "-v",
+        "quiet",
+        "-print_format",
+        "json",
+        "-show_format",
+        "-show_streams",
+        filePath
+      ]);
+      output = parseProbeJson(stdout2);
+    } catch (error) {
+      if (!stillImageMeta) throw error;
+    }
+    const videoStream = output?.streams.find((s2) => s2.codec_type === "video");
+    if (!videoStream) {
+      if (stillImageMeta) {
+        return {
+          durationSeconds: 0,
+          width: stillImageMeta.width,
+          height: stillImageMeta.height,
+          fps: 0,
+          videoCodec: "png",
+          hasAudio: false,
+          isVFR: false,
+          colorSpace: stillImageMeta.colorSpace
+        };
+      }
+      throw new Error("[FFmpeg] No video stream found");
+    }
     const rFps = parseFrameRate(videoStream.r_frame_rate);
     const avgFps = parseFrameRate(videoStream.avg_frame_rate);
     const fps = avgFps || rFps;
@@ -22253,16 +22362,17 @@ async function extractVideoMetadata(filePath) {
     const colorTransfer = videoStream.color_transfer || "";
     const colorPrimaries = videoStream.color_primaries || "";
     const colorSpaceVal = videoStream.color_space || "";
-    const hasColorInfo = !!(colorTransfer || colorPrimaries || colorSpaceVal);
+    const ffprobeColorSpace = colorTransfer || colorPrimaries || colorSpaceVal ? { colorTransfer, colorPrimaries, colorSpace: colorSpaceVal } : null;
+    const colorSpace = ffprobeColorSpace ?? stillImageMeta?.colorSpace ?? null;
     return {
-      durationSeconds: output.format.duration ? parseFloat(output.format.duration) : 0,
-      width: videoStream.width || 0,
-      height: videoStream.height || 0,
+      durationSeconds: output?.format.duration ? parseFloat(output.format.duration) : 0,
+      width: videoStream.width || stillImageMeta?.width || 0,
+      height: videoStream.height || stillImageMeta?.height || 0,
       fps,
       videoCodec: videoStream.codec_name || "unknown",
-      hasAudio: output.streams.some((s2) => s2.codec_type === "audio"),
+      hasAudio: output?.streams.some((s2) => s2.codec_type === "audio") ?? false,
       isVFR,
-      colorSpace: hasColorInfo ? { colorTransfer, colorPrimaries, colorSpace: colorSpaceVal } : null
+      colorSpace
     };
   })();
   videoMetadataCache.set(filePath, probePromise);
@@ -22369,13 +22479,13 @@ var init_ffprobe = __esm({
 // ../engine/src/utils/urlDownloader.ts
 import { createWriteStream as createWriteStream2, existsSync as existsSync17, mkdirSync as mkdirSync11 } from "fs";
 import { createHash } from "crypto";
-import { join as join20, extname as extname4 } from "path";
+import { join as join20, extname as extname5 } from "path";
 import { Readable } from "stream";
 import { finished } from "stream/promises";
 function getFilenameFromUrl(url) {
   const hash2 = createHash("md5").update(url).digest("hex").slice(0, 12);
   const urlObj = new URL(url);
-  const ext = extname4(urlObj.pathname) || ".mp4";
+  const ext = extname5(urlObj.pathname) || ".mp4";
   return `download_${hash2}${ext}`;
 }
 async function downloadToTemp(url, destDir, timeoutMs = 3e5) {
@@ -22479,6 +22589,34 @@ function parseVideoElements(html) {
   }
   return videos;
 }
+function parseImageElements(html) {
+  const images = [];
+  const { document: document2 } = parseHTML(html);
+  const imgEls = document2.querySelectorAll("img[src]");
+  let autoIdCounter = 0;
+  for (const el of imgEls) {
+    const src = el.getAttribute("src");
+    if (!src) continue;
+    const id = el.getAttribute("id") || `hf-img-${autoIdCounter++}`;
+    if (!el.getAttribute("id")) {
+      el.setAttribute("id", id);
+    }
+    const startAttr = el.getAttribute("data-start");
+    const endAttr = el.getAttribute("data-end");
+    const durationAttr = el.getAttribute("data-duration");
+    const start = startAttr ? parseFloat(startAttr) : 0;
+    let end = 0;
+    if (endAttr) {
+      end = parseFloat(endAttr);
+    } else if (durationAttr) {
+      end = start + parseFloat(durationAttr);
+    } else {
+      end = Infinity;
+    }
+    images.push({ id, src, start, end });
+  }
+  return images;
+}
 async function extractVideoFramesRange(videoPath, videoId, startTime, duration, options, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
   const { fps, outputDir, quality = 95, format = "jpg" } = options;
@@ -22966,8 +23104,8 @@ async function queryVideoElementBounds(page, videoIds) {
     });
   }, videoIds);
 }
-async function queryElementStacking(page, nativeHdrVideoIds) {
-  const hdrIds = Array.from(nativeHdrVideoIds);
+async function queryElementStacking(page, nativeHdrIds) {
+  const hdrIds = Array.from(nativeHdrIds);
   return page.evaluate((hdrIdList) => {
     const hdrSet = new Set(hdrIdList);
     const elements = document.querySelectorAll("[data-start]");
@@ -23096,7 +23234,12 @@ async function queryElementStacking(page, nativeHdrVideoIds) {
         // affine blit can apply rotation/scale/translate properly. For DOM
         // elements, the element-level transform is sufficient for reference.
         transform: isHdrEl ? getViewportMatrix(el) : style.transform || "none",
-        borderRadius: isHdrEl ? getEffectiveBorderRadius(el) : [0, 0, 0, 0]
+        borderRadius: isHdrEl ? getEffectiveBorderRadius(el) : [0, 0, 0, 0],
+        // `getComputedStyle` returns "" when the property doesn't apply (e.g.
+        // for non-replaced elements); normalize to the CSS defaults so callers
+        // can rely on a populated value.
+        objectFit: style.objectFit || "fill",
+        objectPosition: style.objectPosition || "50% 50%"
       });
     }
     return results;
@@ -23624,8 +23767,8 @@ var init_parallelCoordinator = __esm({
 // ../engine/src/services/fileServer.ts
 import { Hono as Hono2 } from "hono";
 import { serve } from "@hono/node-server";
-import { readFileSync as readFileSync14, existsSync as existsSync21, statSync as statSync6 } from "fs";
-import { join as join24, extname as extname5 } from "path";
+import { readFileSync as readFileSync15, existsSync as existsSync21, statSync as statSync6 } from "fs";
+import { join as join24, extname as extname6 } from "path";
 function stripEmbeddedRuntimeScripts(html) {
   if (!html) return html;
   const scriptRe = /<script\b[^>]*>[\s\S]*?<\/script>/gi;
@@ -23702,14 +23845,14 @@ function createFileServer(options) {
     if (!existsSync21(filePath) || !statSync6(filePath).isFile()) {
       return c2.text("Not found", 404);
     }
-    const ext = extname5(filePath).toLowerCase();
+    const ext = extname6(filePath).toLowerCase();
     const contentType = MIME_TYPES2[ext] || "application/octet-stream";
     if (ext === ".html") {
-      const rawHtml = readFileSync14(filePath, "utf-8");
+      const rawHtml = readFileSync15(filePath, "utf-8");
       const html = relativePath === "index.html" ? injectScriptsIntoHtml(rawHtml, headScripts, bodyScripts, stripEmbeddedRuntime) : rawHtml;
       return c2.text(html, 200, { "Content-Type": contentType });
     }
-    const content = readFileSync14(filePath);
+    const content = readFileSync15(filePath);
     return new Response(content, {
       status: 200,
       headers: { "Content-Type": contentType }
@@ -24103,6 +24246,125 @@ function blitRgb48leAffine(canvas, source, matrix, srcW, srcH, canvasW, canvasH,
     }
   }
 }
+function parseObjectPositionAxis(value, axis) {
+  const lower2 = value.trim().toLowerCase();
+  if (lower2 === "left" || lower2 === "top") return 0;
+  if (lower2 === "right" || lower2 === "bottom") return 1;
+  if (lower2 === "center" || lower2 === "") return 0.5;
+  if (lower2.endsWith("%")) {
+    const pct = parseFloat(lower2) / 100;
+    return Number.isFinite(pct) ? Math.max(0, Math.min(1, pct)) : 0.5;
+  }
+  if (axis === "x" || axis === "y") return 0.5;
+  return 0.5;
+}
+function parseObjectPosition(css) {
+  if (!css || !css.trim()) return { x: 0.5, y: 0.5 };
+  const tokens = css.trim().split(/\s+/);
+  if (tokens.length === 1) {
+    const single = tokens[0] ?? "";
+    const v = parseObjectPositionAxis(single, "x");
+    return { x: v, y: 0.5 };
+  }
+  return {
+    x: parseObjectPositionAxis(tokens[0] ?? "", "x"),
+    y: parseObjectPositionAxis(tokens[1] ?? "", "y")
+  };
+}
+function computeObjectFitRect(srcW, srcH, dstW, dstH, fit, pos) {
+  let renderedW = dstW;
+  let renderedH = dstH;
+  if (fit === "fill") {
+    return { dx: 0, dy: 0, dw: dstW, dh: dstH };
+  }
+  if (fit === "none") {
+    renderedW = srcW;
+    renderedH = srcH;
+  } else if (fit === "scale-down") {
+    const scale = Math.min(dstW / srcW, dstH / srcH, 1);
+    renderedW = srcW * scale;
+    renderedH = srcH * scale;
+  } else if (fit === "cover") {
+    const scale = Math.max(dstW / srcW, dstH / srcH);
+    renderedW = srcW * scale;
+    renderedH = srcH * scale;
+  } else {
+    const scale = Math.min(dstW / srcW, dstH / srcH);
+    renderedW = srcW * scale;
+    renderedH = srcH * scale;
+  }
+  const dx = (dstW - renderedW) * pos.x;
+  const dy = (dstH - renderedH) * pos.y;
+  return { dx, dy, dw: renderedW, dh: renderedH };
+}
+function resampleRgb48leObjectFit(source, srcW, srcH, dstW, dstH, fit = "fill", objectPosition) {
+  if (srcW <= 0 || srcH <= 0 || dstW <= 0 || dstH <= 0) {
+    return source;
+  }
+  if (fit === "fill" && srcW === dstW && srcH === dstH) {
+    return source;
+  }
+  const pos = parseObjectPosition(objectPosition);
+  const rect = computeObjectFitRect(srcW, srcH, dstW, dstH, fit, pos);
+  const dst = Buffer.alloc(dstW * dstH * 6);
+  const stride = dstW * 6;
+  const xMin = Math.max(0, Math.floor(rect.dx));
+  const yMin = Math.max(0, Math.floor(rect.dy));
+  const xMax = Math.min(dstW, Math.ceil(rect.dx + rect.dw));
+  const yMax = Math.min(dstH, Math.ceil(rect.dy + rect.dh));
+  if (rect.dw <= 0 || rect.dh <= 0) {
+    return dst;
+  }
+  const invScaleX = srcW / rect.dw;
+  const invScaleY = srcH / rect.dh;
+  for (let dy = yMin; dy < yMax; dy++) {
+    const rowOff = dy * stride;
+    const sy = (dy + 0.5 - rect.dy) * invScaleY - 0.5;
+    const syc = Math.max(0, Math.min(srcH - 1, sy));
+    const y0 = Math.floor(syc);
+    const y1 = Math.min(y0 + 1, srcH - 1);
+    const fy = syc - y0;
+    const ify = 1 - fy;
+    for (let dx = xMin; dx < xMax; dx++) {
+      const sx = (dx + 0.5 - rect.dx) * invScaleX - 0.5;
+      const sxc = Math.max(0, Math.min(srcW - 1, sx));
+      const x0 = Math.floor(sxc);
+      const x1 = Math.min(x0 + 1, srcW - 1);
+      const fx = sxc - x0;
+      const ifx = 1 - fx;
+      const off00 = (y0 * srcW + x0) * 6;
+      const off10 = (y0 * srcW + x1) * 6;
+      const off01 = (y1 * srcW + x0) * 6;
+      const off11 = (y1 * srcW + x1) * 6;
+      const w00 = ifx * ify;
+      const w10 = fx * ify;
+      const w01 = ifx * fy;
+      const w11 = fx * fy;
+      const r2 = source.readUInt16LE(off00) * w00 + source.readUInt16LE(off10) * w10 + source.readUInt16LE(off01) * w01 + source.readUInt16LE(off11) * w11;
+      const g = source.readUInt16LE(off00 + 2) * w00 + source.readUInt16LE(off10 + 2) * w10 + source.readUInt16LE(off01 + 2) * w01 + source.readUInt16LE(off11 + 2) * w11;
+      const b = source.readUInt16LE(off00 + 4) * w00 + source.readUInt16LE(off10 + 4) * w10 + source.readUInt16LE(off01 + 4) * w01 + source.readUInt16LE(off11 + 4) * w11;
+      const dstOff = rowOff + dx * 6;
+      dst.writeUInt16LE(Math.round(r2), dstOff);
+      dst.writeUInt16LE(Math.round(g), dstOff + 2);
+      dst.writeUInt16LE(Math.round(b), dstOff + 4);
+    }
+  }
+  return dst;
+}
+function normalizeObjectFit(value) {
+  switch ((value ?? "").trim().toLowerCase()) {
+    case "cover":
+      return "cover";
+    case "contain":
+      return "contain";
+    case "none":
+      return "none";
+    case "scale-down":
+      return "scale-down";
+    default:
+      return "fill";
+  }
+}
 function parseTransformMatrix(css) {
   if (!css || css === "none") return null;
   const match = css.match(
@@ -25035,6 +25297,7 @@ var init_hdrCapture = __esm({
 var src_exports = {};
 __export(src_exports, {
   DEFAULT_CONFIG: () => DEFAULT_CONFIG2,
+  DEFAULT_HDR10_MASTERING: () => DEFAULT_HDR10_MASTERING,
   DOM_LAYER_MASK_STYLE_ID: () => DOM_LAYER_MASK_STYLE_ID,
   ENABLE_BROWSER_POOL: () => ENABLE_BROWSER_POOL,
   ENCODER_PRESETS: () => ENCODER_PRESETS,
@@ -25101,8 +25364,10 @@ __export(src_exports, {
   linearToHdr: () => linearToHdr,
   mergeWorkerFrames: () => mergeWorkerFrames,
   muxVideoWithAudio: () => muxVideoWithAudio,
+  normalizeObjectFit: () => normalizeObjectFit,
   pageScreenshotCapture: () => pageScreenshotCapture,
   parseAudioElements: () => parseAudioElements,
+  parseImageElements: () => parseImageElements,
   parseTransformMatrix: () => parseTransformMatrix,
   parseVideoElements: () => parseVideoElements,
   prepareCaptureSessionForReuse: () => prepareCaptureSessionForReuse,
@@ -25112,6 +25377,7 @@ __export(src_exports, {
   queryVideoElementBounds: () => queryVideoElementBounds,
   releaseBrowser: () => releaseBrowser,
   removeDomLayerMask: () => removeDomLayerMask,
+  resampleRgb48leObjectFit: () => resampleRgb48leObjectFit,
   resolveConfig: () => resolveConfig,
   resolveHeadlessShellPath: () => resolveHeadlessShellPath,
   roundedRectAlpha: () => roundedRectAlpha,
@@ -25231,7 +25497,7 @@ var init_staticGuard = __esm({
 });
 
 // ../core/src/compiler/htmlBundler.ts
-import { readFileSync as readFileSync15, existsSync as existsSync23 } from "fs";
+import { readFileSync as readFileSync16, existsSync as existsSync23 } from "fs";
 import { join as join26, resolve as resolve11, isAbsolute as isAbsolute2, sep as sep2 } from "path";
 import { transformSync } from "esbuild";
 function parseHTMLContent(html) {
@@ -25302,7 +25568,7 @@ function isRelativeUrl(url) {
 function safeReadFile(filePath) {
   if (!existsSync23(filePath)) return null;
   try {
-    return readFileSync15(filePath, "utf-8");
+    return readFileSync16(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -25310,7 +25576,7 @@ function safeReadFile(filePath) {
 function safeReadFileBuffer(filePath) {
   if (!existsSync23(filePath)) return null;
   try {
-    return readFileSync15(filePath);
+    return readFileSync16(filePath);
   } catch {
     return null;
   }
@@ -25503,7 +25769,7 @@ function stripJsCommentsParserSafe(source) {
 async function bundleToSingleHtml(projectDir, options) {
   const indexPath = join26(projectDir, "index.html");
   if (!existsSync23(indexPath)) throw new Error("index.html not found in project directory");
-  const rawHtml = readFileSync15(indexPath, "utf-8");
+  const rawHtml = readFileSync16(indexPath, "utf-8");
   const compiled = await compileHtml(rawHtml, projectDir, options?.probeMediaDuration);
   const staticGuard = validateHyperframeHtmlContract(compiled);
   if (!staticGuard.isValid) {
@@ -25778,7 +26044,7 @@ var init_compiler = __esm({
 
 // ../producer/src/services/hyperframeRuntimeLoader.ts
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync24, readFileSync as readFileSync16 } from "fs";
+import { existsSync as existsSync24, readFileSync as readFileSync17 } from "fs";
 import { dirname as dirname8, resolve as resolve12 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveHyperframeManifestPath() {
@@ -25807,7 +26073,7 @@ function resolveVerifiedHyperframeRuntime() {
       `[HyperframeRuntimeLoader] Missing manifest at ${manifestPath}. Build core runtime artifacts before rendering.`
     );
   }
-  const manifestRaw = readFileSync16(manifestPath, "utf8");
+  const manifestRaw = readFileSync17(manifestPath, "utf8");
   const manifest = JSON.parse(manifestRaw);
   const runtimeFileName = manifest.artifacts?.iife;
   if (!runtimeFileName || !manifest.sha256) {
@@ -25819,7 +26085,7 @@ function resolveVerifiedHyperframeRuntime() {
   if (!existsSync24(runtimePath)) {
     throw new Error(`[HyperframeRuntimeLoader] Missing runtime artifact at ${runtimePath}.`);
   }
-  const runtimeSource = readFileSync16(runtimePath, "utf8");
+  const runtimeSource = readFileSync17(runtimePath, "utf8");
   const runtimeSha = createHash2("sha256").update(runtimeSource, "utf8").digest("hex");
   if (runtimeSha !== manifest.sha256) {
     throw new Error(
@@ -25858,8 +26124,8 @@ var init_hyperframeRuntimeLoader = __esm({
 // ../producer/src/services/fileServer.ts
 import { Hono as Hono3 } from "hono";
 import { serve as serve2 } from "@hono/node-server";
-import { readFileSync as readFileSync17, existsSync as existsSync25, statSync as statSync7 } from "fs";
-import { join as join27, extname as extname6 } from "path";
+import { readFileSync as readFileSync18, existsSync as existsSync25, statSync as statSync7 } from "fs";
+import { join as join27, extname as extname7 } from "path";
 function stripEmbeddedRuntimeScripts3(html) {
   if (!html) return html;
   const scriptRe = /<script\b[^>]*>[\s\S]*?<\/script>/gi;
@@ -25953,10 +26219,10 @@ function createFileServer2(options) {
       }
       return c2.text("Not found", 404);
     }
-    const ext = extname6(filePath).toLowerCase();
+    const ext = extname7(filePath).toLowerCase();
     const contentType = MIME_TYPES3[ext] || "application/octet-stream";
     if (ext === ".html") {
-      const rawHtml = readFileSync17(filePath, "utf-8");
+      const rawHtml = readFileSync18(filePath, "utf-8");
       const isIndex = relativePath === "index.html";
       let html = rawHtml;
       if (preHeadScripts.length > 0) {
@@ -25965,7 +26231,7 @@ function createFileServer2(options) {
       html = isIndex ? injectScriptsIntoHtml2(html, headScripts, bodyScripts, stripEmbeddedRuntime) : html;
       return c2.text(html, 200, { "Content-Type": contentType });
     }
-    const content = readFileSync17(filePath);
+    const content = readFileSync18(filePath);
     return new Response(content, {
       status: 200,
       headers: { "Content-Type": contentType }
@@ -26411,7 +26677,7 @@ var init_fontData_generated = __esm({
 });
 
 // ../producer/src/services/deterministicFonts.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync15, readFileSync as readFileSync18, writeFileSync as writeFileSync9 } from "fs";
+import { existsSync as existsSync26, mkdirSync as mkdirSync15, readFileSync as readFileSync19, writeFileSync as writeFileSync9 } from "fs";
 import { homedir as homedir7 } from "os";
 import { join as join29 } from "path";
 function normalizeFamilyName(family) {
@@ -26567,7 +26833,7 @@ async function fetchGoogleFont(familyName) {
         continue;
       }
     }
-    const fontBytes = readFileSync18(cachePath2);
+    const fontBytes = readFileSync19(cachePath2);
     const dataUri = `data:font/woff2;base64,${fontBytes.toString("base64")}`;
     faces.push({ weight, style, dataUri });
   }
@@ -26749,7 +27015,7 @@ var init_deterministicFonts = __esm({
 });
 
 // ../producer/src/services/htmlCompiler.ts
-import { readFileSync as readFileSync19, existsSync as existsSync27, mkdirSync as mkdirSync16 } from "fs";
+import { readFileSync as readFileSync20, existsSync as existsSync27, mkdirSync as mkdirSync16 } from "fs";
 import { join as join30, dirname as dirname9, resolve as resolve14 } from "path";
 import postcss from "postcss";
 function dedupeElementsById(elements) {
@@ -26853,6 +27119,7 @@ async function compileHtmlFile(html, baseDir, downloadDir) {
 async function parseSubCompositions(html, projectDir, downloadDir, parentOffset = 0, parentEnd = Infinity, visited = /* @__PURE__ */ new Set()) {
   const videos = [];
   const audios = [];
+  const images = [];
   const subCompositions = /* @__PURE__ */ new Map();
   const { document: document2 } = parseHTML(html);
   const compEls = document2.querySelectorAll("[data-composition-src]");
@@ -26872,7 +27139,7 @@ async function parseSubCompositions(html, projectDir, downloadDir, parentOffset
     if (!existsSync27(filePath)) {
       continue;
     }
-    const rawSubHtml = readFileSync19(filePath, "utf-8");
+    const rawSubHtml = readFileSync20(filePath, "utf-8");
     const nestedVisited = new Set(visited);
     nestedVisited.add(filePath);
     workItems.push({ srcPath, absoluteStart, absoluteEnd, filePath, rawSubHtml, nestedVisited });
@@ -26894,12 +27161,14 @@ async function parseSubCompositions(html, projectDir, downloadDir, parentOffset
       );
       const subVideos = parseVideoElements(compiledSub);
       const subAudios = parseAudioElements(compiledSub);
+      const subImages = parseImageElements(compiledSub);
       return {
         srcPath: item.srcPath,
         compiledSub,
         nested,
         subVideos,
         subAudios,
+        subImages,
         absoluteStart: item.absoluteStart,
         absoluteEnd: item.absoluteEnd
       };
@@ -26912,6 +27181,7 @@ async function parseSubCompositions(html, projectDir, downloadDir, parentOffset
     }
     videos.push(...r2.nested.videos);
     audios.push(...r2.nested.audios);
+    images.push(...r2.nested.images);
     for (const v of r2.subVideos) {
       v.start += r2.absoluteStart;
       v.end += r2.absoluteStart;
@@ -26932,10 +27202,20 @@ async function parseSubCompositions(html, projectDir, downloadDir, parentOffset
         audios.push(a);
       }
     }
-    if (r2.subVideos.length > 0 || r2.subAudios.length > 0 || r2.nested.videos.length > 0 || r2.nested.audios.length > 0) {
+    for (const img of r2.subImages) {
+      img.start += r2.absoluteStart;
+      img.end += r2.absoluteStart;
+      if (img.end > r2.absoluteEnd) {
+        img.end = r2.absoluteEnd;
+      }
+      if (img.start < r2.absoluteEnd) {
+        images.push(img);
+      }
+    }
+    if (r2.subVideos.length > 0 || r2.subAudios.length > 0 || r2.subImages.length > 0 || r2.nested.videos.length > 0 || r2.nested.audios.length > 0 || r2.nested.images.length > 0) {
     }
   }
-  return { videos, audios, subCompositions };
+  return { videos, audios, images, subCompositions };
 }
 function promoteCssImportsToLinkTags(html) {
   const { document: document2 } = parseHTML(html);
@@ -27067,7 +27347,7 @@ function inlineSubCompositions(html, subCompositions, projectDir) {
     if (!compHtml) {
       const filePath = resolve14(projectDir, srcPath);
       if (existsSync27(filePath)) {
-        compHtml = readFileSync19(filePath, "utf-8");
+        compHtml = readFileSync20(filePath, "utf-8");
       }
     }
     if (!compHtml) {
@@ -27235,7 +27515,9 @@ ${html}
 </html>`;
 }
 async function inlineExternalScripts(html) {
-  const { document: document2 } = parseHTML(html);
+  const fullHtml = ensureFullDocument(html);
+  const wrappedFragment = fullHtml !== html;
+  const { document: document2 } = parseHTML(fullHtml);
   const scripts = document2.querySelectorAll("script[src]");
   const externalScripts = [];
   for (const el of scripts) {
@@ -27254,20 +27536,20 @@ async function inlineExternalScripts(html) {
       return { src, text: await response.text() };
     })
   );
-  let result = html;
   for (let i2 = 0; i2 < downloads.length; i2++) {
     const download = downloads[i2];
-    const { src } = externalScripts[i2];
+    const { el, src } = externalScripts[i2];
     if (download.status === "fulfilled") {
-      const escapedSrc = src.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-      const scriptTagRe = new RegExp(
-        `<script\\b[^>]*\\bsrc=["']${escapedSrc}["'][^>]*>\\s*</script>`,
-        "is"
-      );
       const safeText = download.value.text.replace(/<\/script/gi, "<\\/script");
-      result = result.replace(scriptTagRe, `<script>/* inlined: ${src} */
+      const inlineScript = document2.createElement("script");
+      for (const attr of Array.from(el.attributes)) {
+        if (attr.name.toLowerCase() === "src") continue;
+        inlineScript.setAttribute(attr.name, attr.value);
+      }
+      inlineScript.textContent = `/* inlined: ${src} */
 ${safeText}
-</script>`);
+`;
+      el.replaceWith(inlineScript);
       console.log(`[Compiler] Inlined CDN script: ${src}`);
     } else {
       console.warn(
@@ -27275,7 +27557,7 @@ ${safeText}
       );
     }
   }
-  return result;
+  return wrappedFragment ? document2.body.innerHTML || "" : document2.toString();
 }
 function collectExternalAssets(html, projectDir) {
   const absProjectDir = resolve14(projectDir);
@@ -27335,7 +27617,7 @@ function collectExternalAssets(html, projectDir) {
   };
 }
 async function compileForRender(projectDir, htmlPath, downloadDir) {
-  const rawHtml = readFileSync19(htmlPath, "utf-8");
+  const rawHtml = readFileSync20(htmlPath, "utf-8");
   const { html: compiledHtml, unresolvedCompositions } = await compileHtmlFile(
     rawHtml,
     projectDir,
@@ -27344,6 +27626,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir) {
   const {
     videos: subVideos,
     audios: subAudios,
+    images: subImages,
     subCompositions
   } = await parseSubCompositions(compiledHtml, projectDir, downloadDir);
   const fullHtml = ensureFullDocument(compiledHtml);
@@ -27360,8 +27643,10 @@ async function compileForRender(projectDir, htmlPath, downloadDir) {
   const { html, externalAssets } = collectExternalAssets(assembledHtml, projectDir);
   const mainVideos = parseVideoElements(html);
   const mainAudios = parseAudioElements(html);
+  const mainImages = parseImageElements(html);
   const videos = dedupeElementsById([...mainVideos, ...subVideos]);
   const audios = dedupeElementsById([...mainAudios, ...subAudios]);
+  const images = dedupeElementsById([...mainImages, ...subImages]);
   for (const video of videos) {
     if (isHttpUrl(video.src)) continue;
     const videoPath = resolve14(projectDir, video.src);
@@ -27392,6 +27677,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir) {
     subCompositions,
     videos,
     audios,
+    images,
     unresolvedCompositions,
     externalAssets,
     width,
@@ -27476,12 +27762,15 @@ async function recompileWithResolutions(compiled, resolutions, projectDir, downl
   const {
     videos: subVideos,
     audios: subAudios,
+    images: subImages,
     subCompositions
   } = await parseSubCompositions(html, projectDir, downloadDir);
   const mainVideos = parseVideoElements(html);
   const mainAudios = parseAudioElements(html);
+  const mainImages = parseImageElements(html);
   const videos = dedupeElementsById([...mainVideos, ...subVideos]);
   const audios = dedupeElementsById([...mainAudios, ...subAudios]);
+  const images = dedupeElementsById([...mainImages, ...subImages]);
   const remaining = compiled.unresolvedCompositions.filter(
     (c2) => !resolutions.some((r2) => r2.id === c2.id)
   );
@@ -27491,6 +27780,7 @@ async function recompileWithResolutions(compiled, resolutions, projectDir, downl
     subCompositions,
     videos,
     audios,
+    images,
     unresolvedCompositions: remaining,
     renderModeHints: compiled.renderModeHints
   };
@@ -27557,7 +27847,7 @@ import {
   existsSync as existsSync28,
   mkdirSync as mkdirSync17,
   rmSync as rmSync6,
-  readFileSync as readFileSync20,
+  readFileSync as readFileSync21,
   readdirSync as readdirSync11,
   writeFileSync as writeFileSync10,
   copyFileSync as copyFileSync2,
@@ -27700,7 +27990,7 @@ function blitHdrVideoLayer(canvas, el, time, fps, hdrFrameDirs, hdrStartTimes, w
     return;
   }
   try {
-    const { data: hdrRgb, width: srcW, height: srcH } = decodePngToRgb48le(readFileSync20(framePath));
+    const { data: hdrRgb, width: srcW, height: srcH } = decodePngToRgb48le(readFileSync21(framePath));
     if (sourceTransfer && targetTransfer && sourceTransfer !== targetTransfer) {
       convertTransfer(hdrRgb, sourceTransfer, targetTransfer);
     }
@@ -27742,6 +28032,55 @@ function blitHdrVideoLayer(canvas, el, time, fps, hdrFrameDirs, hdrStartTimes, w
     }
   }
 }
+function blitHdrImageLayer(canvas, el, hdrImageBuffers, width, height, log, sourceTransfer, targetTransfer) {
+  const buf = hdrImageBuffers.get(el.id);
+  if (!buf) {
+    return;
+  }
+  try {
+    let hdrRgb = buf.data;
+    if (sourceTransfer && targetTransfer && sourceTransfer !== targetTransfer) {
+      hdrRgb = Buffer.from(buf.data);
+      convertTransfer(hdrRgb, sourceTransfer, targetTransfer);
+    }
+    const viewportMatrix = parseTransformMatrix(el.transform);
+    const br = el.borderRadius;
+    const hasBorderRadius = br[0] > 0 || br[1] > 0 || br[2] > 0 || br[3] > 0;
+    const borderRadiusParam = hasBorderRadius ? br : void 0;
+    if (viewportMatrix) {
+      blitRgb48leAffine(
+        canvas,
+        hdrRgb,
+        viewportMatrix,
+        buf.width,
+        buf.height,
+        width,
+        height,
+        el.opacity < 0.999 ? el.opacity : void 0,
+        borderRadiusParam
+      );
+    } else {
+      blitRgb48leRegion(
+        canvas,
+        hdrRgb,
+        el.x,
+        el.y,
+        buf.width,
+        buf.height,
+        width,
+        height,
+        el.opacity < 0.999 ? el.opacity : void 0,
+        borderRadiusParam
+      );
+    }
+  } catch (err) {
+    if (log) {
+      log.debug(`HDR image blit failed for ${el.id}`, {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+}
 function createRenderJob(config) {
   return {
     id: randomUUID2(),
@@ -27793,6 +28132,10 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
   let lastBrowserConsole = [];
   let restoreLogger = null;
   const perfStages = {};
+  const hdrDiagnostics = {
+    videoExtractionFailures: 0,
+    imageDecodeFailures: 0
+  };
   const perfOutputPath = join31(workDir, "perf-summary.json");
   const cfg = { ...job.config.producerConfig ?? resolveConfig() };
   const outputFormat = job.config.format ?? "mp4";
@@ -27824,7 +28167,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       throw new Error(`Entry file not found: ${htmlPath}`);
     }
     assertNotAborted();
-    const rawEntry = readFileSync20(htmlPath, "utf-8");
+    const rawEntry = readFileSync21(htmlPath, "utf-8");
     if (entryFile !== "index.html" && rawEntry.trimStart().startsWith("<template")) {
       const wrapperPath = join31(workDir, "standalone-entry.html");
       const projectIndexPath = join31(projectDir, "index.html");
@@ -27834,7 +28177,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
         );
       }
       const standaloneHtml = extractStandaloneEntryFromIndex(
-        readFileSync20(projectIndexPath, "utf-8"),
+        readFileSync21(projectIndexPath, "utf-8"),
         entryFile
       );
       if (!standaloneHtml) {
@@ -27869,6 +28212,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       duration: compiled.staticDuration,
       videos: compiled.videos,
       audios: compiled.audios,
+      images: compiled.images,
       width: compiled.width,
       height: compiled.height
     };
@@ -27933,6 +28277,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
           assertNotAborted();
           composition.videos = compiled.videos;
           composition.audios = compiled.audios;
+          composition.images = compiled.images;
           writeCompiledArtifacts(compiled, workDir, Boolean(job.config.debug));
         }
       }
@@ -28088,6 +28433,30 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
         })
       );
     }
+    const nativeHdrImageIds = /* @__PURE__ */ new Set();
+    const imageTransfers = /* @__PURE__ */ new Map();
+    const hdrImageSrcPaths = /* @__PURE__ */ new Map();
+    const imageColorSpaces = [];
+    if (job.config.hdr && composition.images.length > 0) {
+      const probed = await Promise.all(
+        composition.images.map(async (img) => {
+          let imgPath = img.src;
+          if (!imgPath.startsWith("/")) {
+            const fromCompiled = existsSync28(join31(compiledDir, imgPath)) ? join31(compiledDir, imgPath) : join31(projectDir, imgPath);
+            imgPath = fromCompiled;
+          }
+          if (!existsSync28(imgPath)) return null;
+          const meta = await extractVideoMetadata(imgPath);
+          if (isHdrColorSpace(meta.colorSpace)) {
+            nativeHdrImageIds.add(img.id);
+            imageTransfers.set(img.id, detectTransfer(meta.colorSpace));
+            hdrImageSrcPaths.set(img.id, imgPath);
+          }
+          return meta.colorSpace;
+        })
+      );
+      imageColorSpaces.push(...probed);
+    }
     if (composition.videos.length > 0) {
       extractionResult = await extractAllVideoFrames(
         composition.videos,
@@ -28125,21 +28494,22 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       perfStages.videoExtractMs = Date.now() - stage2Start;
     }
     let effectiveHdr;
-    if (job.config.hdr && frameLookup) {
-      const colorSpaces = (extractionResult?.extracted ?? []).map((ext) => ext.metadata.colorSpace);
-      const info = analyzeCompositionHdr(colorSpaces);
-      if (info.hasHdr && info.dominantTransfer) {
-        effectiveHdr = { transfer: info.dominantTransfer };
-      }
-    }
-    if (job.config.hdr && !effectiveHdr && nativeHdrVideoIds.size > 0) {
-      const firstTransfer = videoTransfers.values().next().value;
-      if (firstTransfer) {
-        effectiveHdr = { transfer: firstTransfer };
+    if (job.config.hdr) {
+      const videoColorSpaces = (extractionResult?.extracted ?? []).map(
+        (ext) => ext.metadata.colorSpace
+      );
+      const allColorSpaces = [...videoColorSpaces, ...imageColorSpaces];
+      if (allColorSpaces.length > 0) {
+        const info = analyzeCompositionHdr(allColorSpaces);
+        if (info.hasHdr && info.dominantTransfer) {
+          effectiveHdr = { transfer: info.dominantTransfer };
+        }
       }
     }
     if (effectiveHdr && outputFormat !== "mp4") {
-      log.info(`[Render] HDR source detected but format is ${outputFormat} \u2014 using SDR`);
+      log.warn(
+        `[Render] HDR source detected but format is ${outputFormat} \u2014 falling back to SDR. Use --format mp4 for HDR10 output.`
+      );
       effectiveHdr = void 0;
     }
     if (effectiveHdr) {
@@ -28192,12 +28562,14 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     const FORMAT_EXT2 = { mp4: ".mp4", webm: ".webm", mov: ".mov" };
     const videoExt = FORMAT_EXT2[outputFormat] ?? ".mp4";
     const videoOnlyPath = join31(workDir, `video-only${videoExt}`);
-    const hasHdrContent = effectiveHdr && nativeHdrVideoIds.size > 0;
+    const nativeHdrIds = /* @__PURE__ */ new Set([...nativeHdrVideoIds, ...nativeHdrImageIds]);
+    const hasHdrContent = effectiveHdr && nativeHdrIds.size > 0;
     const encoderHdr = hasHdrContent ? effectiveHdr : void 0;
     const preset = getEncoderPreset(job.config.quality, outputFormat, encoderHdr);
     job.framesRendered = 0;
     if (hasHdrContent) {
       log.info("[Render] HDR layered composite: z-ordered DOM + native HLG video layers");
+      cfg.forceScreenshot = true;
       const hdrVideoIds = composition.videos.filter((v) => nativeHdrVideoIds.has(v.id)).map((v) => v.id);
       const hdrVideoSrcPaths = /* @__PURE__ */ new Map();
       for (const v of composition.videos) {
@@ -28213,7 +28585,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       const domSession = await createCaptureSession(
         fileServer.url,
         framesDir,
-        captureOptions,
+        { ...captureOptions, skipReadinessVideoIds: Array.from(nativeHdrVideoIds) },
         createVideoFrameInjector(frameLookup),
         cfg
       );
@@ -28267,13 +28639,22 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       );
       assertNotAborted();
       const hdrExtractionDims = /* @__PURE__ */ new Map();
+      const hdrImageFitInfo = /* @__PURE__ */ new Map();
       const hdrVideoStartTimes = /* @__PURE__ */ new Map();
       for (const v of composition.videos) {
         if (hdrVideoIds.includes(v.id)) {
           hdrVideoStartTimes.set(v.id, v.start);
         }
       }
-      const uniqueStartTimes = [...new Set(hdrVideoStartTimes.values())].sort((a, b) => a - b);
+      const hdrImageStartTimes = /* @__PURE__ */ new Map();
+      for (const img of composition.images) {
+        if (nativeHdrImageIds.has(img.id)) {
+          hdrImageStartTimes.set(img.id, img.start);
+        }
+      }
+      const uniqueStartTimes = [
+        .../* @__PURE__ */ new Set([...hdrVideoStartTimes.values(), ...hdrImageStartTimes.values()])
+      ].sort((a, b) => a - b);
       for (const seekTime of uniqueStartTimes) {
         await domSession.page.evaluate((t3) => {
           if (window.__hf && typeof window.__hf.seek === "function") window.__hf.seek(t3);
@@ -28281,11 +28662,17 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
         if (domSession.onBeforeCapture) {
           await domSession.onBeforeCapture(domSession.page, seekTime);
         }
-        const stacking = await queryElementStacking(domSession.page, nativeHdrVideoIds);
+        const stacking = await queryElementStacking(domSession.page, nativeHdrIds);
         for (const el of stacking) {
           if (el.isHdr && el.layoutWidth > 0 && el.layoutHeight > 0 && !hdrExtractionDims.has(el.id)) {
             hdrExtractionDims.set(el.id, { width: el.layoutWidth, height: el.layoutHeight });
           }
+          if (el.isHdr && nativeHdrImageIds.has(el.id) && !hdrImageFitInfo.has(el.id)) {
+            hdrImageFitInfo.set(el.id, {
+              fit: el.objectFit,
+              position: el.objectPosition
+            });
+          }
         }
       }
       const hdrFrameDirs = /* @__PURE__ */ new Map();
@@ -28316,14 +28703,59 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
         ];
         const result = await runFfmpeg(ffmpegArgs, { signal: abortSignal });
         if (!result.success) {
-          log.warn("HDR frame pre-extraction failed; loop will fill with black", {
+          hdrDiagnostics.videoExtractionFailures += 1;
+          log.error("HDR frame pre-extraction failed; aborting render", {
             videoId,
             srcPath,
             stderr: result.stderr.slice(-400)
           });
+          throw new Error(
+            `HDR frame extraction failed for video "${videoId}". Aborting render to avoid shipping black HDR layers.`
+          );
         }
         hdrFrameDirs.set(videoId, frameDir);
       }
+      const hdrImageBuffers = /* @__PURE__ */ new Map();
+      for (const [imageId, srcPath] of hdrImageSrcPaths) {
+        try {
+          const decoded = decodePngToRgb48le(readFileSync21(srcPath));
+          const layout2 = hdrExtractionDims.get(imageId);
+          const fitInfo = hdrImageFitInfo.get(imageId);
+          if (layout2 && (layout2.width !== decoded.width || layout2.height !== decoded.height)) {
+            const fit = normalizeObjectFit(fitInfo?.fit);
+            const resampled = resampleRgb48leObjectFit(
+              decoded.data,
+              decoded.width,
+              decoded.height,
+              layout2.width,
+              layout2.height,
+              fit,
+              fitInfo?.position
+            );
+            hdrImageBuffers.set(imageId, {
+              data: resampled,
+              width: layout2.width,
+              height: layout2.height
+            });
+          } else {
+            hdrImageBuffers.set(imageId, {
+              data: Buffer.from(decoded.data),
+              width: decoded.width,
+              height: decoded.height
+            });
+          }
+        } catch (err) {
+          hdrDiagnostics.imageDecodeFailures += 1;
+          log.error("HDR image decode failed; aborting render", {
+            imageId,
+            srcPath,
+            error: err instanceof Error ? err.message : String(err)
+          });
+          throw new Error(
+            `HDR image decode failed for image "${imageId}". Aborting render to avoid shipping missing HDR image layers.`
+          );
+        }
+      }
       assertNotAborted();
       try {
         let countNonZeroAlpha2 = function(rgba) {
@@ -28381,38 +28813,67 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
             const layer = layers[layerIdx];
             if (layer.type === "hdr") {
               const before2 = shouldLog ? countNonZeroRgb482(canvas) : 0;
-              blitHdrVideoLayer(
-                canvas,
-                layer.element,
-                time,
-                job.config.fps,
-                hdrFrameDirs,
-                hdrVideoStartTimes,
-                width,
-                height,
-                log,
-                videoTransfers.get(layer.element.id),
-                effectiveHdr?.transfer
-              );
+              const isHdrImage = nativeHdrImageIds.has(layer.element.id);
+              if (isHdrImage) {
+                blitHdrImageLayer(
+                  canvas,
+                  layer.element,
+                  hdrImageBuffers,
+                  width,
+                  height,
+                  log,
+                  imageTransfers.get(layer.element.id),
+                  effectiveHdr?.transfer
+                );
+              } else {
+                blitHdrVideoLayer(
+                  canvas,
+                  layer.element,
+                  time,
+                  job.config.fps,
+                  hdrFrameDirs,
+                  hdrVideoStartTimes,
+                  width,
+                  height,
+                  log,
+                  videoTransfers.get(layer.element.id),
+                  effectiveHdr?.transfer
+                );
+              }
               if (shouldLog) {
                 const after2 = countNonZeroRgb482(canvas);
-                const frameDir = hdrFrameDirs.get(layer.element.id);
-                const startTime = hdrVideoStartTimes.get(layer.element.id) ?? 0;
-                const localTime = time - startTime;
-                const frameNum = Math.floor(localTime * job.config.fps) + 1;
-                const expectedFrame = frameDir ? join31(frameDir, `frame_${String(frameNum).padStart(4, "0")}.png`) : null;
-                log.info("[diag] hdr layer blit", {
-                  frame: debugFrameIndex,
-                  layerIdx,
-                  id: layer.element.id,
-                  pixelsAdded: after2 - before2,
-                  totalNonZero: after2,
-                  startTime,
-                  localTime: localTime.toFixed(3),
-                  hdrFrameNum: frameNum,
-                  expectedFrame,
-                  expectedFrameExists: expectedFrame ? existsSync28(expectedFrame) : false
-                });
+                if (isHdrImage) {
+                  const buf = hdrImageBuffers.get(layer.element.id);
+                  log.info("[diag] hdr layer blit", {
+                    frame: debugFrameIndex,
+                    layerIdx,
+                    id: layer.element.id,
+                    kind: "image",
+                    pixelsAdded: after2 - before2,
+                    totalNonZero: after2,
+                    bufferDecoded: !!buf,
+                    bufferDims: buf ? `${buf.width}x${buf.height}` : null
+                  });
+                } else {
+                  const frameDir = hdrFrameDirs.get(layer.element.id);
+                  const startTime = hdrVideoStartTimes.get(layer.element.id) ?? 0;
+                  const localTime = time - startTime;
+                  const frameNum = Math.floor(localTime * job.config.fps) + 1;
+                  const expectedFrame = frameDir ? join31(frameDir, `frame_${String(frameNum).padStart(4, "0")}.png`) : null;
+                  log.info("[diag] hdr layer blit", {
+                    frame: debugFrameIndex,
+                    layerIdx,
+                    id: layer.element.id,
+                    kind: "video",
+                    pixelsAdded: after2 - before2,
+                    totalNonZero: after2,
+                    startTime,
+                    localTime: localTime.toFixed(3),
+                    hdrFrameNum: frameNum,
+                    expectedFrame,
+                    expectedFrameExists: expectedFrame ? existsSync28(expectedFrame) : false
+                  });
+                }
               }
             } else {
               const allElementIds = fullStacking.map((e2) => e2.id);
@@ -28487,7 +28948,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
           if (beforeCaptureHook) {
             await beforeCaptureHook(domSession.page, time);
           }
-          const stackingInfo = await queryElementStacking(domSession.page, nativeHdrVideoIds);
+          const stackingInfo = await queryElementStacking(domSession.page, nativeHdrIds);
           const activeTransition = transitionRanges.find(
             (t3) => i2 >= t3.startFrame && i2 <= t3.endFrame
           );
@@ -28519,22 +28980,35 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
               }
               for (const el of stackingInfo) {
                 if (!el.isHdr || !sceneIds.has(el.id)) continue;
-                blitHdrVideoLayer(
-                  sceneBuf,
-                  el,
-                  time,
-                  job.config.fps,
-                  hdrFrameDirs,
-                  hdrVideoStartTimes,
-                  width,
-                  height,
-                  log,
-                  videoTransfers.get(el.id),
-                  effectiveHdr?.transfer
-                );
+                if (nativeHdrImageIds.has(el.id)) {
+                  blitHdrImageLayer(
+                    sceneBuf,
+                    el,
+                    hdrImageBuffers,
+                    width,
+                    height,
+                    log,
+                    imageTransfers.get(el.id),
+                    effectiveHdr?.transfer
+                  );
+                } else {
+                  blitHdrVideoLayer(
+                    sceneBuf,
+                    el,
+                    time,
+                    job.config.fps,
+                    hdrFrameDirs,
+                    hdrVideoStartTimes,
+                    width,
+                    height,
+                    log,
+                    videoTransfers.get(el.id),
+                    effectiveHdr?.transfer
+                  );
+                }
               }
               const showIds = Array.from(sceneIds);
-              const hideIds = stackingInfo.map((e2) => e2.id).filter((id) => !sceneIds.has(id) || nativeHdrVideoIds.has(id));
+              const hideIds = stackingInfo.map((e2) => e2.id).filter((id) => !sceneIds.has(id) || nativeHdrIds.has(id));
               await applyDomLayerMask(domSession.page, showIds, hideIds);
               const domPng = await captureAlphaPng(domSession.page, width, height);
               await removeDomLayerMask(domSession.page, hideIds);
@@ -28655,7 +29129,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
             fileServer.url,
             workDir,
             tasks,
-            captureOptions,
+            { ...captureOptions, skipReadinessVideoIds: Array.from(nativeHdrVideoIds) },
             () => createVideoFrameInjector(frameLookup),
             abortSignal,
             (progress) => {
@@ -28685,7 +29159,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
           const session = probeSession ?? await createCaptureSession(
             fileServer.url,
             framesDir,
-            captureOptions,
+            { ...captureOptions, skipReadinessVideoIds: Array.from(nativeHdrVideoIds) },
             videoInjector,
             cfg
           );
@@ -28736,7 +29210,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
             fileServer.url,
             workDir,
             tasks,
-            captureOptions,
+            { ...captureOptions, skipReadinessVideoIds: Array.from(nativeHdrVideoIds) },
             () => createVideoFrameInjector(frameLookup),
             abortSignal,
             (progress) => {
@@ -28767,7 +29241,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
           const session = probeSession ?? await createCaptureSession(
             fileServer.url,
             framesDir,
-            captureOptions,
+            { ...captureOptions, skipReadinessVideoIds: Array.from(nativeHdrVideoIds) },
             videoInjector,
             cfg
           );
@@ -28885,6 +29359,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       videoCount: composition.videos.length,
       audioCount: composition.audios.length,
       stages: perfStages,
+      hdrDiagnostics: hdrDiagnostics.videoExtractionFailures > 0 || hdrDiagnostics.imageDecodeFailures > 0 ? { ...hdrDiagnostics } : void 0,
       captureAvgMs: totalFrames > 0 ? Math.round((perfStages.captureMs ?? 0) / totalFrames) : void 0
     };
     job.perfSummary = perfSummary;
@@ -28965,7 +29440,8 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       elapsedMs: elapsed,
       freeMemoryMB: freeMemMB,
       browserConsoleTail: lastBrowserConsole.length > 0 ? lastBrowserConsole.slice(-30) : void 0,
-      perfStages: Object.keys(perfStages).length > 0 ? { ...perfStages } : void 0
+      perfStages: Object.keys(perfStages).length > 0 ? { ...perfStages } : void 0,
+      hdrDiagnostics: hdrDiagnostics.videoExtractionFailures > 0 || hdrDiagnostics.imageDecodeFailures > 0 ? { ...hdrDiagnostics } : void 0
     };
     if (fileServer) {
       const fs4 = fileServer;
@@ -29042,7 +29518,7 @@ var init_config3 = __esm({
 });
 
 // ../producer/src/services/hyperframeLint.ts
-import { existsSync as existsSync29, readFileSync as readFileSync21, statSync as statSync8 } from "fs";
+import { existsSync as existsSync29, readFileSync as readFileSync22, statSync as statSync8 } from "fs";
 import { resolve as resolve16, join as join32 } from "path";
 function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -29085,7 +29561,7 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
     if (existsSync29(absoluteEntryPath) && statSync8(absoluteEntryPath).isFile()) {
       return {
         entryFile,
-        html: readFileSync21(absoluteEntryPath, "utf-8"),
+        html: readFileSync22(absoluteEntryPath, "utf-8"),
         source: "projectDir"
       };
     }
@@ -29715,7 +30191,7 @@ __export(studioServer_exports, {
 });
 import { Hono as Hono5 } from "hono";
 import { streamSSE as streamSSE3 } from "hono/streaming";
-import { existsSync as existsSync31, readFileSync as readFileSync22, writeFileSync as writeFileSync12, statSync as statSync10 } from "fs";
+import { existsSync as existsSync31, readFileSync as readFileSync23, writeFileSync as writeFileSync12, statSync as statSync10 } from "fs";
 import { resolve as resolve18, join as join34, basename as basename2 } from "path";
 function resolveDistDir() {
   const builtPath = resolve18(__dirname, "studio");
@@ -29889,7 +30365,7 @@ function createStudioServer(options) {
   });
   app.get("/api/runtime.js", (c2) => {
     if (!existsSync31(runtimePath)) return c2.text("runtime not built", 404);
-    return c2.body(readFileSync22(runtimePath, "utf-8"), 200, {
+    return c2.body(readFileSync23(runtimePath, "utf-8"), 200, {
       "Content-Type": "text/javascript",
       "Cache-Control": "no-store"
     });
@@ -29922,7 +30398,7 @@ function createStudioServer(options) {
   app.get("/assets/*", (c2) => {
     const filePath = resolve18(studioDir, c2.req.path.slice(1));
     if (!existsSync31(filePath) || !statSync10(filePath).isFile()) return c2.text("not found", 404);
-    const content = readFileSync22(filePath);
+    const content = readFileSync23(filePath);
     return new Response(content, {
       headers: { "Content-Type": getMimeType(filePath), "Cache-Control": "no-store" }
     });
@@ -29930,7 +30406,7 @@ function createStudioServer(options) {
   app.get("/icons/*", (c2) => {
     const filePath = resolve18(studioDir, c2.req.path.slice(1));
     if (!existsSync31(filePath) || !statSync10(filePath).isFile()) return c2.text("not found", 404);
-    const content = readFileSync22(filePath);
+    const content = readFileSync23(filePath);
     return new Response(content, {
       headers: { "Content-Type": getMimeType(filePath), "Cache-Control": "no-store" }
     });
@@ -29940,7 +30416,7 @@ function createStudioServer(options) {
     if (!existsSync31(indexPath)) {
       return c2.text("Studio not found. Rebuild with: pnpm run build", 500);
     }
-    return c2.html(readFileSync22(indexPath, "utf-8"));
+    return c2.html(readFileSync23(indexPath, "utf-8"));
   });
   return { app, watcher };
 }
@@ -30276,7 +30752,7 @@ import {
   copyFileSync as copyFileSync3,
   cpSync,
   writeFileSync as writeFileSync13,
-  readFileSync as readFileSync23,
+  readFileSync as readFileSync24,
   readdirSync as readdirSync12
 } from "fs";
 import { resolve as resolve20, basename as basename4, join as join36, dirname as dirname13 } from "path";
@@ -30362,7 +30838,7 @@ function getSharedTemplateDir() {
 function patchVideoSrc(dir, videoFilename, durationSeconds) {
   const htmlFiles = readdirSync12(dir, { withFileTypes: true, recursive: true }).filter((e2) => e2.isFile() && e2.name.endsWith(".html")).map((e2) => join36(e2.parentPath ?? e2.path, e2.name));
   for (const file of htmlFiles) {
-    let content = readFileSync23(file, "utf-8");
+    let content = readFileSync24(file, "utf-8");
     if (videoFilename) {
       content = content.replaceAll("__VIDEO_SRC__", videoFilename);
     } else {
@@ -31311,7 +31787,7 @@ __export(play_exports, {
   default: () => play_default,
   examples: () => examples5
 });
-import { existsSync as existsSync36, readFileSync as readFileSync24 } from "fs";
+import { existsSync as existsSync36, readFileSync as readFileSync25 } from "fs";
 import { resolve as resolve24, dirname as dirname14 } from "path";
 function commandDir() {
   return dirname14(new URL(import.meta.url).pathname);
@@ -31427,13 +31903,13 @@ var init_play = __esm({
         const { createAdaptorServer } = await import("@hono/node-server");
         const app = new Hono6();
         app.get("/player.js", (ctx) => {
-          return ctx.body(readFileSync24(playerPath, "utf-8"), 200, {
+          return ctx.body(readFileSync25(playerPath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           });
         });
         app.get("/runtime.js", (ctx) => {
-          return ctx.body(readFileSync24(runtimePath, "utf-8"), 200, {
+          return ctx.body(readFileSync25(runtimePath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           });
@@ -31443,7 +31919,7 @@ var init_play = __esm({
           const filePath = resolve24(project.dir, reqPath);
           if (!filePath.startsWith(project.dir)) return ctx.text("Forbidden", 403);
           if (!existsSync36(filePath)) return ctx.text("Not found", 404);
-          const content = readFileSync24(filePath, "utf-8");
+          const content = readFileSync25(filePath, "utf-8");
           if (filePath.endsWith(".html")) {
             const injected = injectRuntime(content);
             return ctx.html(injected);
@@ -31462,7 +31938,7 @@ var init_play = __esm({
             mp3: "audio/mpeg",
             wav: "audio/wav"
           };
-          return ctx.body(readFileSync24(filePath), 200, {
+          return ctx.body(readFileSync25(filePath), 200, {
             "Content-Type": types3[ext] ?? "application/octet-stream"
           });
         });
@@ -31549,6 +32025,46 @@ var init_progress = __esm({
   }
 });
 
+// src/utils/dockerRunArgs.ts
+function buildDockerRunArgs(input) {
+  const { imageTag, projectDir, outputDir, outputFilename, options } = input;
+  return [
+    "run",
+    "--rm",
+    "--platform",
+    "linux/amd64",
+    "--shm-size=2g",
+    // GPU encoding requires host GPU passthrough.
+    ...options.gpu ? ["--gpus", "all"] : [],
+    "-v",
+    `${projectDir}:/project:ro`,
+    "-v",
+    `${outputDir}:/output`,
+    imageTag,
+    "/project",
+    "--output",
+    `/output/${outputFilename}`,
+    "--fps",
+    String(options.fps),
+    "--quality",
+    options.quality,
+    "--format",
+    options.format,
+    "--workers",
+    String(options.workers),
+    ...options.crf != null ? ["--crf", String(options.crf)] : [],
+    ...options.videoBitrate ? ["--video-bitrate", options.videoBitrate] : [],
+    ...options.quiet ? ["--quiet"] : [],
+    ...options.gpu ? ["--gpu"] : [],
+    ...options.hdr ? ["--hdr"] : []
+  ];
+}
+var init_dockerRunArgs = __esm({
+  "src/utils/dockerRunArgs.ts"() {
+    "use strict";
+  }
+});
+
 // src/browser/ffmpeg.ts
 var ffmpeg_exports = {};
 __export(ffmpeg_exports, {
@@ -31592,7 +32108,7 @@ __export(render_exports, {
   default: () => render_default,
   examples: () => examples6
 });
-import { mkdirSync as mkdirSync21, readFileSync as readFileSync25, statSync as statSync12, writeFileSync as writeFileSync14, rmSync as rmSync8 } from "fs";
+import { mkdirSync as mkdirSync21, readFileSync as readFileSync26, statSync as statSync12, writeFileSync as writeFileSync14, rmSync as rmSync8 } from "fs";
 import { cpus as cpus3, freemem as freemem3, tmpdir as tmpdir3 } from "os";
 import { resolve as resolve25, dirname as dirname15, join as join37, basename as basename6 } from "path";
 import { execFileSync as execFileSync5, spawn as spawn10 } from "child_process";
@@ -31633,7 +32149,7 @@ function ensureDockerImage(version, quiet) {
   const dockerfilePath = resolveDockerfilePath();
   const tmpDir = join37(tmpdir3(), `hyperframes-docker-${Date.now()}`);
   mkdirSync21(tmpDir, { recursive: true });
-  writeFileSync14(join37(tmpDir, "Dockerfile"), readFileSync25(dockerfilePath));
+  writeFileSync14(join37(tmpDir, "Dockerfile"), readFileSync26(dockerfilePath));
   try {
     execFileSync5(
       "docker",
@@ -31679,33 +32195,23 @@ async function renderDocker(projectDir, outputPath, options) {
   }
   const outputDir = dirname15(outputPath);
   const outputFilename = basename6(outputPath);
-  const dockerArgs = [
-    "run",
-    "--rm",
-    "--platform",
-    "linux/amd64",
-    "--shm-size=2g",
-    // GPU encoding requires host GPU passthrough
-    ...options.gpu ? ["--gpus", "all"] : [],
-    "-v",
-    `${resolve25(projectDir)}:/project:ro`,
-    "-v",
-    `${resolve25(outputDir)}:/output`,
+  const dockerArgs = buildDockerRunArgs({
     imageTag,
-    "/project",
-    "--output",
-    `/output/${outputFilename}`,
-    "--fps",
-    String(options.fps),
-    "--quality",
-    options.quality,
-    "--format",
-    options.format,
-    "--workers",
-    String(options.workers),
-    ...options.quiet ? ["--quiet"] : [],
-    ...options.gpu ? ["--gpu"] : []
-  ];
+    projectDir: resolve25(projectDir),
+    outputDir: resolve25(outputDir),
+    outputFilename,
+    options: {
+      fps: options.fps,
+      quality: options.quality,
+      format: options.format,
+      workers: options.workers,
+      gpu: options.gpu,
+      hdr: options.hdr,
+      crf: options.crf,
+      videoBitrate: options.videoBitrate,
+      quiet: options.quiet
+    }
+  });
   if (!options.quiet) {
     console.log(c.dim("  Running render in Docker container..."));
     console.log("");
@@ -31749,7 +32255,9 @@ async function renderLocal(projectDir, outputPath, options) {
     format: options.format,
     workers: options.workers,
     useGpu: options.gpu,
-    hdr: options.hdr
+    hdr: options.hdr,
+    crf: options.crf,
+    videoBitrate: options.videoBitrate
   });
   const onProgress = options.quiet ? void 0 : (progressJob, message) => {
     renderProgress(progressJob.progress, message);
@@ -31833,6 +32341,7 @@ var init_render2 = __esm({
     init_system();
     init_version();
     init_env();
+    init_dockerRunArgs();
     examples6 = [
       ["Render to MP4", "hyperframes render --output output.mp4"],
       ["Render transparent overlay (ProRes)", "hyperframes render --format mov --output overlay.mov"],
@@ -31860,15 +32369,18 @@ var init_render2 = __esm({
         },
         output: {
           type: "string",
+          alias: "o",
           description: "Output path (default: renders/<name>.mp4)"
         },
         fps: {
           type: "string",
+          alias: "f",
           description: "Frame rate: 24, 30, 60",
           default: "30"
         },
         quality: {
           type: "string",
+          alias: "q",
           description: "Quality: draft, standard, high",
           default: "standard"
         },
@@ -31879,6 +32391,7 @@ var init_render2 = __esm({
         },
         workers: {
           type: "string",
+          alias: "w",
           description: "Parallel render workers (number or 'auto'). Default: auto. Each worker launches a separate Chrome process (~256 MB RAM)."
         },
         docker: {
@@ -31891,6 +32404,14 @@ var init_render2 = __esm({
           description: "Enable HDR: probe sources for PQ/HLG, output H.265 10-bit BT.2020",
           default: false
         },
+        crf: {
+          type: "string",
+          description: "Override encoder CRF. Mutually exclusive with --video-bitrate."
+        },
+        "video-bitrate": {
+          type: "string",
+          description: "Target video bitrate such as 10M. Mutually exclusive with --crf."
+        },
         gpu: { type: "boolean", description: "Use GPU encoding", default: false },
         quiet: {
           type: "boolean",
@@ -31964,6 +32485,28 @@ var init_render2 = __esm({
         const quiet = args.quiet ?? false;
         const strictAll = args["strict-all"] ?? false;
         const strictErrors = (args.strict ?? false) || strictAll;
+        const crfRaw = args.crf;
+        const videoBitrate = args["video-bitrate"]?.trim();
+        if (crfRaw != null && videoBitrate) {
+          errorBox("Conflicting encoder settings", "Use either --crf or --video-bitrate, not both.");
+          process.exit(1);
+        }
+        let crf;
+        if (crfRaw != null) {
+          const parsed = Number(crfRaw);
+          if (!Number.isInteger(parsed) || parsed < 0) {
+            errorBox("Invalid crf", `Got "${crfRaw}". Must be a non-negative integer.`);
+            process.exit(1);
+          }
+          crf = parsed;
+        }
+        if (args["video-bitrate"] != null && !videoBitrate) {
+          errorBox(
+            "Invalid video-bitrate",
+            `Got "${args["video-bitrate"]}". Must be a non-empty bitrate such as "10M".`
+          );
+          process.exit(1);
+        }
         const workerCount = workers ?? defaultWorkerCount();
         if (!quiet) {
           const workerLabel = args.workers != null ? `${workerCount} workers` : `${workerCount} workers (auto \u2014 ${CPU_CORE_COUNT} cores detected)`;
@@ -32042,6 +32585,8 @@ var init_render2 = __esm({
             workers: workerCount,
             gpu: useGpu,
             hdr: args.hdr ?? false,
+            crf,
+            videoBitrate,
             quiet
           });
         } else {
@@ -32052,6 +32597,8 @@ var init_render2 = __esm({
             workers: workerCount,
             gpu: useGpu,
             hdr: args.hdr ?? false,
+            crf,
+            videoBitrate,
             quiet,
             browserPath
           });
@@ -32279,7 +32826,7 @@ __export(info_exports, {
   default: () => info_default,
   examples: () => examples8
 });
-import { readFileSync as readFileSync26, readdirSync as readdirSync13, statSync as statSync13 } from "fs";
+import { readFileSync as readFileSync27, readdirSync as readdirSync13, statSync as statSync13 } from "fs";
 import { join as join38 } from "path";
 function totalSize(dir) {
   let total = 0;
@@ -32316,7 +32863,7 @@ var init_info = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync26(project.indexPath, "utf-8");
+        const html = readFileSync27(project.indexPath, "utf-8");
         ensureDOMParser();
         const parsed = parseHtml(html);
         const tracks = new Set(parsed.elements.map((el) => el.zIndex));
@@ -32372,7 +32919,7 @@ __export(compositions_exports, {
   default: () => compositions_default,
   examples: () => examples9
 });
-import { existsSync as existsSync37, readFileSync as readFileSync27 } from "fs";
+import { existsSync as existsSync37, readFileSync as readFileSync28 } from "fs";
 import { resolve as resolve26, dirname as dirname16 } from "path";
 function parseCompositions(html, baseDir) {
   const parser = new DOMParser();
@@ -32387,7 +32934,7 @@ function parseCompositions(html, baseDir) {
     if (compositionSrc) {
       const subPath = resolve26(baseDir, compositionSrc);
       if (existsSync37(subPath)) {
-        const subHtml = readFileSync27(subPath, "utf-8");
+        const subHtml = readFileSync28(subPath, "utf-8");
         const subInfo = parseSubComposition(subHtml, id, width, height);
         compositions.push({ ...subInfo, source: compositionSrc });
         return;
@@ -32481,7 +33028,7 @@ var init_compositions = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync27(project.indexPath, "utf-8");
+        const html = readFileSync28(project.indexPath, "utf-8");
         ensureDOMParser();
         const compositions = parseCompositions(html, dirname16(project.indexPath));
         if (compositions.length === 0) {
@@ -32826,7 +33373,7 @@ __export(transcribe_exports2, {
   examples: () => examples12
 });
 import { existsSync as existsSync39, writeFileSync as writeFileSync15 } from "fs";
-import { resolve as resolve28, join as join40, extname as extname7 } from "path";
+import { resolve as resolve28, join as join40, extname as extname8 } from "path";
 async function importTranscript(inputPath, dir, json) {
   const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
   const { words, format } = loadTranscript2(inputPath);
@@ -32956,7 +33503,7 @@ var init_transcribe2 = __esm({
           process.exit(1);
         }
         const dir = resolve28(args.dir ?? ".");
-        const ext = extname7(inputPath).toLowerCase();
+        const ext = extname8(inputPath).toLowerCase();
         const isImport = ext === ".json" || ext === ".srt" || ext === ".vtt";
         if (isImport) {
           return importTranscript(inputPath, dir, args.json);
@@ -32975,6 +33522,13 @@ var init_transcribe2 = __esm({
 import { existsSync as existsSync40, mkdirSync as mkdirSync22 } from "fs";
 import { homedir as homedir8 } from "os";
 import { join as join41 } from "path";
+function inferLangFromVoiceId(voiceId) {
+  const first = voiceId.charAt(0).toLowerCase();
+  return VOICE_PREFIX_LANG[first] ?? "en-us";
+}
+function isSupportedLang(value) {
+  return SUPPORTED_LANGS.includes(value);
+}
 async function ensureModel2(model = DEFAULT_MODEL2, options) {
   const modelPath = join41(MODELS_DIR2, `${model}.onnx`);
   if (existsSync40(modelPath)) return modelPath;
@@ -33003,7 +33557,7 @@ async function ensureVoices(options) {
   }
   return voicesPath;
 }
-var CACHE_DIR3, MODELS_DIR2, VOICES_DIR, DEFAULT_MODEL2, MODEL_URLS, VOICES_URL, BUNDLED_VOICES, DEFAULT_VOICE;
+var CACHE_DIR3, MODELS_DIR2, VOICES_DIR, DEFAULT_MODEL2, MODEL_URLS, VOICES_URL, SUPPORTED_LANGS, VOICE_PREFIX_LANG, BUNDLED_VOICES, DEFAULT_VOICE;
 var init_manager3 = __esm({
   "src/tts/manager.ts"() {
     "use strict";
@@ -33016,6 +33570,37 @@ var init_manager3 = __esm({
       "kokoro-v1.0": "https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx"
     };
     VOICES_URL = "https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin";
+    SUPPORTED_LANGS = [
+      "en-us",
+      "en-gb",
+      "es",
+      "fr-fr",
+      "hi",
+      "it",
+      "pt-br",
+      "ja",
+      "zh"
+    ];
+    VOICE_PREFIX_LANG = {
+      a: "en-us",
+      // American English
+      b: "en-gb",
+      // British English
+      e: "es",
+      // Spanish
+      f: "fr-fr",
+      // French
+      h: "hi",
+      // Hindi
+      i: "it",
+      // Italian
+      j: "ja",
+      // Japanese
+      p: "pt-br",
+      // Brazilian Portuguese
+      z: "zh"
+      // Mandarin
+    };
     BUNDLED_VOICES = [
       { id: "af_heart", label: "Heart", language: "en-US", gender: "female" },
       { id: "af_nova", label: "Nova", language: "en-US", gender: "female" },
@@ -33024,7 +33609,11 @@ var init_manager3 = __esm({
       { id: "am_michael", label: "Michael", language: "en-US", gender: "male" },
       { id: "bf_emma", label: "Emma", language: "en-GB", gender: "female" },
       { id: "bf_isabella", label: "Isabella", language: "en-GB", gender: "female" },
-      { id: "bm_george", label: "George", language: "en-GB", gender: "male" }
+      { id: "bm_george", label: "George", language: "en-GB", gender: "male" },
+      { id: "ef_dora", label: "Dora", language: "es", gender: "female" },
+      { id: "ff_siwis", label: "Siwis", language: "fr-FR", gender: "female" },
+      { id: "jf_alpha", label: "Alpha", language: "ja", gender: "female" },
+      { id: "zf_xiaobei", label: "Xiaobei", language: "zh", gender: "female" }
     ];
     DEFAULT_VOICE = "af_heart";
   }
@@ -33036,8 +33625,8 @@ __export(synthesize_exports, {
   synthesize: () => synthesize
 });
 import { execFileSync as execFileSync6 } from "child_process";
-import { existsSync as existsSync41, writeFileSync as writeFileSync16, mkdirSync as mkdirSync23 } from "fs";
-import { join as join42, dirname as dirname17 } from "path";
+import { existsSync as existsSync41, writeFileSync as writeFileSync16, mkdirSync as mkdirSync23, readdirSync as readdirSync14, unlinkSync as unlinkSync6 } from "fs";
+import { join as join42, dirname as dirname17, basename as basename7 } from "path";
 import { homedir as homedir9 } from "os";
 function findPython() {
   for (const name of ["python3", "python"]) {
@@ -33076,12 +33665,25 @@ function ensureSynthScript() {
   if (!existsSync41(SCRIPT_PATH)) {
     mkdirSync23(SCRIPT_DIR, { recursive: true });
     writeFileSync16(SCRIPT_PATH, SYNTH_SCRIPT);
+    const currentName = basename7(SCRIPT_PATH);
+    try {
+      for (const entry of readdirSync14(SCRIPT_DIR)) {
+        if (entry !== currentName && /^synth(-v\d+)?\.py$/.test(entry)) {
+          try {
+            unlinkSync6(join42(SCRIPT_DIR, entry));
+          } catch {
+          }
+        }
+      }
+    } catch {
+    }
   }
   return SCRIPT_PATH;
 }
 async function synthesize(text, outputPath, options) {
   const voice = options?.voice ?? DEFAULT_VOICE;
   const speed = options?.speed ?? 1;
+  const lang = options?.lang ?? inferLangFromVoiceId(voice);
   options?.onProgress?.("Checking Python runtime...");
   const python = findPython();
   if (!python) {
@@ -33103,11 +33705,11 @@ async function synthesize(text, outputPath, options) {
   ]);
   const scriptPath = ensureSynthScript();
   mkdirSync23(dirname17(outputPath), { recursive: true });
-  options?.onProgress?.(`Generating speech with voice ${voice}...`);
+  options?.onProgress?.(`Generating speech with voice ${voice} (${lang})...`);
   try {
     const stdout2 = execFileSync6(
       python,
-      [scriptPath, modelPath, voicesPath, text, voice, String(speed), outputPath],
+      [scriptPath, modelPath, voicesPath, text, voice, String(speed), outputPath, lang],
       {
         encoding: "utf-8",
         timeout: 3e5,
@@ -33123,7 +33725,8 @@ async function synthesize(text, outputPath, options) {
     return {
       outputPath: result.outputPath,
       sampleRate: result.sampleRate,
-      durationSeconds: result.durationSeconds
+      durationSeconds: result.durationSeconds,
+      langApplied: result.langApplied
     };
   } catch (err) {
     if (err instanceof SyntaxError && existsSync41(outputPath)) {
@@ -33146,7 +33749,7 @@ var init_synthesize = __esm({
     "use strict";
     init_manager3();
     SYNTH_SCRIPT = `
-import sys, json
+import sys, json, inspect
 
 model_path = sys.argv[1]
 voices_path = sys.argv[2]
@@ -33154,12 +33757,19 @@ text = sys.argv[3]
 voice = sys.argv[4]
 speed = float(sys.argv[5])
 output_path = sys.argv[6]
+lang = sys.argv[7] if len(sys.argv) > 7 else ""
 
 import kokoro_onnx
 import soundfile as sf
 
 model = kokoro_onnx.Kokoro(model_path, voices_path)
-samples, sample_rate = model.create(text, voice=voice, speed=speed)
+
+kwargs = {"voice": voice, "speed": speed}
+supports_lang = "lang" in inspect.signature(model.create).parameters
+if lang and supports_lang:
+    kwargs["lang"] = lang
+
+samples, sample_rate = model.create(text, **kwargs)
 sf.write(output_path, samples, sample_rate)
 
 duration = len(samples) / sample_rate
@@ -33167,10 +33777,11 @@ print(json.dumps({
     "outputPath": output_path,
     "sampleRate": sample_rate,
     "durationSeconds": round(duration, 3),
+    "langApplied": bool(lang and supports_lang),
 }))
 `;
     SCRIPT_DIR = join42(homedir9(), ".cache", "hyperframes", "tts");
-    SCRIPT_PATH = join42(SCRIPT_DIR, "synth.py");
+    SCRIPT_PATH = join42(SCRIPT_DIR, "synth-v2.py");
   }
 });
 
@@ -33180,49 +33791,64 @@ __export(tts_exports, {
   default: () => tts_default,
   examples: () => examples13
 });
-import { existsSync as existsSync42, readFileSync as readFileSync28 } from "fs";
-import { resolve as resolve29, extname as extname8 } from "path";
+import { existsSync as existsSync42, readFileSync as readFileSync29 } from "fs";
+import { resolve as resolve29, extname as extname9 } from "path";
 function listVoices(json) {
+  const rows = BUNDLED_VOICES.map((v) => ({ ...v, defaultLang: inferLangFromVoiceId(v.id) }));
   if (json) {
-    console.log(JSON.stringify(BUNDLED_VOICES));
+    console.log(JSON.stringify(rows));
     return;
   }
   console.log(`
 ${c.bold("Available voices")} (Kokoro-82M)
 `);
   console.log(
-    `  ${c.dim("ID")}                ${c.dim("Name")}         ${c.dim("Language")}   ${c.dim("Gender")}`
+    `  ${c.dim("ID")}                ${c.dim("Name")}         ${c.dim("Language")}   ${c.dim("Lang code")}  ${c.dim("Gender")}`
   );
-  console.log(`  ${c.dim("\u2500".repeat(60))}`);
-  for (const v of BUNDLED_VOICES) {
-    const id = v.id.padEnd(18);
-    const label2 = v.label.padEnd(13);
-    const lang = v.language.padEnd(10);
-    console.log(`  ${c.accent(id)} ${label2} ${lang} ${v.gender}`);
+  console.log(`  ${c.dim("\u2500".repeat(72))}`);
+  for (const row of rows) {
+    const id = row.id.padEnd(18);
+    const label2 = row.label.padEnd(13);
+    const lang = row.language.padEnd(10);
+    const code = row.defaultLang.padEnd(10);
+    console.log(`  ${c.accent(id)} ${label2} ${lang} ${code} ${row.gender}`);
   }
   console.log(
     `
-  ${c.dim("Use any Kokoro voice ID \u2014 see https://github.com/thewh1teagle/kokoro-onnx for all 54 voices")}
+  ${c.dim("Use any Kokoro voice ID \u2014 see https://github.com/thewh1teagle/kokoro-onnx for all 54 voices")}`
+  );
+  console.log(
+    `  ${c.dim("Override phonemizer with --lang <" + SUPPORTED_LANGS.join("|") + ">")}
 `
   );
 }
-var examples13, voiceList, tts_default;
+var examples13, voiceList, langList, tts_default;
 var init_tts = __esm({
   "src/commands/tts.ts"() {
     "use strict";
     init_dist();
     init_dist3();
     init_colors();
+    init_format();
     init_manager3();
     examples13 = [
       ["Generate speech from text", 'hyperframes tts "Welcome to HyperFrames"'],
       ["Choose a voice", 'hyperframes tts "Hello world" --voice am_adam'],
       ["Save to a specific file", 'hyperframes tts "Intro" --voice bf_emma --output narration.wav'],
       ["Adjust speech speed", 'hyperframes tts "Slow and clear" --speed 0.8'],
+      [
+        "Generate Spanish speech",
+        'hyperframes tts "La reuni\xF3n empieza a las nueve" --voice ef_dora --output es.wav'
+      ],
+      [
+        "Override phonemizer language",
+        'hyperframes tts "Ciao a tutti" --voice af_heart --lang it --output accented.wav'
+      ],
       ["Read text from a file", "hyperframes tts script.txt"],
       ["List available voices", "hyperframes tts --list"]
     ];
     voiceList = BUNDLED_VOICES.map((v) => `${v.id} (${v.label})`).join(", ");
+    langList = SUPPORTED_LANGS.join(", ");
     tts_default = defineCommand({
       meta: {
         name: "tts",
@@ -33249,6 +33875,11 @@ var init_tts = __esm({
           description: "Speech speed multiplier (default: 1.0)",
           alias: "s"
         },
+        lang: {
+          type: "string",
+          description: `Phonemizer language (auto-detected from voice prefix when omitted). Options: ${langList}`,
+          alias: "l"
+        },
         list: {
           type: "boolean",
           description: "List available voices and exit",
@@ -33270,8 +33901,8 @@ var init_tts = __esm({
         }
         let text;
         const maybeFile = resolve29(args.input);
-        if (existsSync42(maybeFile) && extname8(maybeFile).toLowerCase() === ".txt") {
-          text = readFileSync28(maybeFile, "utf-8").trim();
+        if (existsSync42(maybeFile) && extname9(maybeFile).toLowerCase() === ".txt") {
+          text = readFileSync29(maybeFile, "utf-8").trim();
           if (!text) {
             console.error(c.error("File is empty."));
             process.exit(1);
@@ -33290,13 +33921,31 @@ var init_tts = __esm({
           console.error(c.error("Speed must be a number between 0.1 and 3.0"));
           process.exit(1);
         }
+        const inferredLang = inferLangFromVoiceId(voice);
+        let lang = inferredLang;
+        if (args.lang != null) {
+          const requested = String(args.lang).toLowerCase();
+          if (!isSupportedLang(requested)) {
+            errorBox("Invalid --lang", `Got "${args.lang}". Must be one of: ${langList}.`);
+            process.exit(1);
+          }
+          lang = requested;
+        }
+        if (!args.json && args.lang != null && lang !== inferredLang) {
+          console.log(
+            c.dim(
+              `  Note: voice "${voice}" is ${inferredLang}, rendering with --lang ${lang} instead.`
+            )
+          );
+        }
         const { synthesize: synthesize2 } = await Promise.resolve().then(() => (init_synthesize(), synthesize_exports));
         const spin = args.json ? null : be();
-        spin?.start(`Generating speech with ${c.accent(voice)}...`);
+        spin?.start(`Generating speech with ${c.accent(voice)} (${lang})...`);
         try {
           const result = await synthesize2(text, output, {
             voice,
             speed,
+            lang,
             onProgress: spin ? (msg) => spin.message(msg) : void 0
           });
           if (args.json) {
@@ -33305,6 +33954,8 @@ var init_tts = __esm({
                 ok: true,
                 voice,
                 speed,
+                lang,
+                langApplied: result.langApplied,
                 durationSeconds: result.durationSeconds,
                 outputPath: result.outputPath
               })
@@ -33315,6 +33966,13 @@ var init_tts = __esm({
                 `Generated ${c.accent(result.durationSeconds.toFixed(1) + "s")} of speech \u2192 ${c.accent(result.outputPath)}`
               )
             );
+            if (args.lang != null && !result.langApplied) {
+              console.log(
+                c.dim(
+                  "  Note: installed kokoro-onnx version does not support the --lang kwarg; phonemization used Kokoro's default."
+                )
+              );
+            }
           }
         } catch (err) {
           const message = err instanceof Error ? err.message : String(err);
@@ -33336,7 +33994,7 @@ __export(docs_exports, {
   default: () => docs_default,
   examples: () => examples14
 });
-import { readFileSync as readFileSync29, existsSync as existsSync43 } from "fs";
+import { readFileSync as readFileSync30, existsSync as existsSync43 } from "fs";
 import { resolve as resolve30, dirname as dirname18, join as join43 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 function docsDir() {
@@ -33446,7 +34104,7 @@ var init_docs = __esm({
           console.error(c.error(`Doc file not found: ${filePath}`));
           process.exit(1);
         }
-        const content = readFileSync29(filePath, "utf-8");
+        const content = readFileSync30(filePath, "utf-8");
         console.log();
         renderMarkdown(content);
       }
@@ -33872,7 +34530,7 @@ var validate_exports = {};
 __export(validate_exports, {
   default: () => validate_default
 });
-import { existsSync as existsSync44, readFileSync as readFileSync30 } from "fs";
+import { existsSync as existsSync44, readFileSync as readFileSync31 } from "fs";
 import { resolve as resolve31, join as join44, dirname as dirname19 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 async function getCompositionDuration2(page) {
@@ -33929,7 +34587,7 @@ async function validateInBrowser(projectDir, opts) {
     "hyperframe.runtime.iife.js"
   );
   if (existsSync44(runtimePath)) {
-    const runtimeSource = readFileSync30(runtimePath, "utf-8");
+    const runtimeSource = readFileSync31(runtimePath, "utf-8");
     html = html.replace(
       /<script[^>]*data-hyperframes-preview-runtime[^>]*src="[^"]*"[^>]*><\/script>/,
       () => `<script data-hyperframes-preview-runtime="1">${runtimeSource}</script>`
@@ -33947,7 +34605,7 @@ async function validateInBrowser(projectDir, opts) {
     const filePath = join44(projectDir, decodeURIComponent(url));
     if (existsSync44(filePath)) {
       res.writeHead(200, { "Content-Type": getMimeType2(filePath) });
-      res.end(readFileSync30(filePath));
+      res.end(readFileSync31(filePath));
       return;
     }
     res.writeHead(404);
@@ -34138,7 +34796,7 @@ __export(snapshot_exports, {
   examples: () => examples18
 });
 import { spawn as spawn11 } from "child_process";
-import { existsSync as existsSync45, mkdtempSync as mkdtempSync2, readFileSync as readFileSync31, mkdirSync as mkdirSync24, rmSync as rmSync9 } from "fs";
+import { existsSync as existsSync45, mkdtempSync as mkdtempSync2, readFileSync as readFileSync32, mkdirSync as mkdirSync24, rmSync as rmSync9 } from "fs";
 import { tmpdir as tmpdir4 } from "os";
 import { resolve as resolve32, join as join45, dirname as dirname20, relative as relative4, isAbsolute as isAbsolute4 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
@@ -34183,7 +34841,7 @@ async function extractVideoFrameToBuffer(videoPath, timeSeconds) {
       }
     );
     if (result.code !== 0 || result.timedOut || !existsSync45(outPath)) return null;
-    return readFileSync31(outPath);
+    return readFileSync32(outPath);
   } finally {
     try {
       rmSync9(tmp, { recursive: true, force: true });
@@ -34206,7 +34864,7 @@ async function captureSnapshots(projectDir, opts) {
     "hyperframe.runtime.iife.js"
   );
   if (existsSync45(runtimePath)) {
-    const runtimeSource = readFileSync31(runtimePath, "utf-8");
+    const runtimeSource = readFileSync32(runtimePath, "utf-8");
     html = html.replace(
       /<script[^>]*data-hyperframes-preview-runtime[^>]*src="[^"]*"[^>]*><\/script>/,
       () => `<script data-hyperframes-preview-runtime="1">${runtimeSource}</script>`
@@ -34230,7 +34888,7 @@ async function captureSnapshots(projectDir, opts) {
     }
     if (existsSync45(filePath)) {
       res.writeHead(200, { "Content-Type": getMimeType2(filePath) });
-      res.end(readFileSync31(filePath));
+      res.end(readFileSync32(filePath));
       return;
     }
     res.writeHead(404);
@@ -34476,7 +35134,7 @@ ${c.error("\u2717")} Snapshot failed: ${msg}`);
 
 // src/capture/assetDownloader.ts
 import { writeFileSync as writeFileSync17, mkdirSync as mkdirSync25 } from "fs";
-import { join as join46, extname as extname9 } from "path";
+import { join as join46, extname as extname10 } from "path";
 async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks) {
   const assetsDir = join46(outputDir, "assets");
   mkdirSync25(assetsDir, { recursive: true });
@@ -34498,7 +35156,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks)
   for (const icon of faviconLinks || []) {
     if (!icon.href) continue;
     try {
-      const ext = extname9(new URL(icon.href).pathname) || ".ico";
+      const ext = extname10(new URL(icon.href).pathname) || ".ico";
       const name = `favicon${ext}`;
       const localPath = `assets/${name}`;
       const buffer = await fetchBuffer(icon.href);
@@ -34540,7 +35198,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks)
     const results = await Promise.allSettled(
       batch.map(async ({ url, isPoster }) => {
         const parsedUrl = new URL(url);
-        const pathExt = extname9(parsedUrl.pathname);
+        const pathExt = extname10(parsedUrl.pathname);
         const ext = pathExt && pathExt.length <= 5 ? pathExt : ".jpg";
         const buffer = await fetchBuffer(url);
         if (!buffer) return null;
@@ -34569,7 +35227,7 @@ async function downloadAssets(tokens, outputDir, catalogedAssets, faviconLinks)
   }
   if (tokens.ogImage && !downloadedUrls.has(normalizeUrl(tokens.ogImage))) {
     try {
-      const ext = extname9(new URL(tokens.ogImage).pathname) || ".jpg";
+      const ext = extname10(new URL(tokens.ogImage).pathname) || ".jpg";
       const localPath = `assets/og-image${ext}`;
       const buffer = await fetchBuffer(tokens.ogImage);
       if (buffer && buffer.length > 5e3) {
@@ -35429,7 +36087,7 @@ var init_animationCataloger = __esm({
 });
 
 // src/capture/mediaCapture.ts
-import { mkdirSync as mkdirSync26, writeFileSync as writeFileSync18, readdirSync as readdirSync14, readFileSync as readFileSync32, statSync as statSync15 } from "fs";
+import { mkdirSync as mkdirSync26, writeFileSync as writeFileSync18, readdirSync as readdirSync15, readFileSync as readFileSync33, statSync as statSync15 } from "fs";
 import { join as join47 } from "path";
 async function saveLottieAnimations(discoveredLotties, lottieDir) {
   let savedCount = 0;
@@ -35493,10 +36151,10 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
   const manifest = [];
   const previewDir = join47(lottieDir, "previews");
   mkdirSync26(previewDir, { recursive: true });
-  for (const file of readdirSync14(lottieDir)) {
+  for (const file of readdirSync15(lottieDir)) {
     if (!file.endsWith(".json")) continue;
     try {
-      const raw = JSON.parse(readFileSync32(join47(lottieDir, file), "utf-8"));
+      const raw = JSON.parse(readFileSync33(join47(lottieDir, file), "utf-8"));
       const fr = raw.fr || 30;
       const dur = ((raw.op || 0) - (raw.ip || 0)) / fr;
       const previewName = file.replace(".json", "-preview.png");
@@ -35506,7 +36164,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
       try {
         previewPage = await chromeBrowser.newPage();
         await previewPage.setViewport({ width: 400, height: 400 });
-        const animData = JSON.parse(readFileSync32(join47(lottieDir, file), "utf-8"));
+        const animData = JSON.parse(readFileSync33(join47(lottieDir, file), "utf-8"));
         const midFrame = Math.floor(((raw.op || 0) - (raw.ip || 0)) * 0.3);
         await previewPage.setContent(
           `<!DOCTYPE html>
@@ -42624,7 +43282,7 @@ var require_node_domexception = __commonJS({
 
 // ../../node_modules/.bun/fetch-blob@3.2.0/node_modules/fetch-blob/from.js
 import { statSync as statSync16, createReadStream as createReadStream2, promises as fs2 } from "fs";
-import { basename as basename7 } from "path";
+import { basename as basename8 } from "path";
 var import_node_domexception, stat, blobFromSync, blobFrom, fileFrom, fileFromSync, fromBlob, fromFile, BlobDataItem;
 var init_from = __esm({
   "../../node_modules/.bun/fetch-blob@3.2.0/node_modules/fetch-blob/from.js"() {
@@ -42648,7 +43306,7 @@ var init_from = __esm({
       size: stat3.size,
       lastModified: stat3.mtimeMs,
       start: 0
-    })], basename7(path2), { type, lastModified: stat3.mtimeMs });
+    })], basename8(path2), { type, lastModified: stat3.mtimeMs });
     BlobDataItem = class _BlobDataItem {
       #path;
       #start;
@@ -76124,7 +76782,7 @@ ${underline2}`);
 });
 
 // src/capture/contentExtractor.ts
-import { readdirSync as readdirSync15, statSync as statSync17, readFileSync as readFileSync33 } from "fs";
+import { readdirSync as readdirSync16, statSync as statSync17, readFileSync as readFileSync34 } from "fs";
 import { join as join48 } from "path";
 async function detectLibraries(page, capturedShaders) {
   let detectedLibraries = [];
@@ -76245,7 +76903,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
   try {
     const { GoogleGenAI: GoogleGenAI2 } = await Promise.resolve().then(() => (init_node4(), node_exports));
     const ai = new GoogleGenAI2({ apiKey: geminiKey });
-    const imageFiles = readdirSync15(join48(outputDir, "assets")).filter(
+    const imageFiles = readdirSync16(join48(outputDir, "assets")).filter(
       (f3) => /\.(png|jpg|jpeg|webp|gif)$/i.test(f3)
     );
     const model = process.env.HYPERFRAMES_GEMINI_MODEL || "gemini-3.1-flash-lite-preview";
@@ -76257,7 +76915,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
           const filePath = join48(outputDir, "assets", file);
           const stat3 = statSync17(filePath);
           if (stat3.size > 4e6) return { file, caption: "" };
-          const buffer = readFileSync33(filePath);
+          const buffer = readFileSync34(filePath);
           const base64 = buffer.toString("base64");
           const ext = file.split(".").pop()?.toLowerCase() || "png";
           const mimeType = ext === "jpg" ? "image/jpeg" : `image/${ext}`;
@@ -76305,7 +76963,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   const fontLines = [];
   const assetsPath = join48(outputDir, "assets");
   try {
-    for (const file of readdirSync15(assetsPath)) {
+    for (const file of readdirSync16(assetsPath)) {
       if (file === "svgs" || file === "fonts" || file === "lottie" || file === "videos") continue;
       const filePath = join48(assetsPath, file);
       const stat3 = statSync17(filePath);
@@ -76337,7 +76995,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   }
   try {
     const svgsPath = join48(assetsPath, "svgs");
-    for (const file of readdirSync15(svgsPath)) {
+    for (const file of readdirSync16(svgsPath)) {
       if (!file.endsWith(".svg")) continue;
       const svgMatch = tokens.svgs.find(
         (s2) => s2.label && file.includes(
@@ -76352,7 +77010,7 @@ function generateAssetDescriptions(outputDir, tokens, catalogedAssets, geminiCap
   }
   try {
     const fontsPath = join48(assetsPath, "fonts");
-    for (const file of readdirSync15(fontsPath)) {
+    for (const file of readdirSync16(fontsPath)) {
       fontLines.push(`fonts/${file} \u2014 font file`);
     }
   } catch {
@@ -76443,7 +77101,7 @@ var init_agentPromptGenerator = __esm({
 });
 
 // src/capture/scaffolding.ts
-import { existsSync as existsSync46, writeFileSync as writeFileSync20, readFileSync as readFileSync34 } from "fs";
+import { existsSync as existsSync46, writeFileSync as writeFileSync20, readFileSync as readFileSync35 } from "fs";
 import { join as join50, resolve as resolve33 } from "path";
 function loadEnvFile(startDir) {
   try {
@@ -76451,7 +77109,7 @@ function loadEnvFile(startDir) {
     for (let i2 = 0; i2 < 5; i2++) {
       const envPath = resolve33(dir, ".env");
       try {
-        const envContent = readFileSync34(envPath, "utf-8");
+        const envContent = readFileSync35(envPath, "utf-8");
         for (const line of envContent.split("\n")) {
           const trimmed = line.trim();
           if (!trimmed || trimmed.startsWith("#")) continue;