hyperframes 0.7.53 → 0.7.54

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.7.53" : "0.0.0-dev";
+    VERSION = true ? "0.7.54" : "0.0.0-dev";
   }
 });
 
@@ -64600,8 +64600,13 @@ async function getCompositionDuration(session) {
     return window.__hf?.duration ?? 0;
   });
 }
+function computeDeVerifySampleFractions(k2) {
+  if (k2 <= 0) return [];
+  if (k2 === 1) return [0.95];
+  return [...Array.from({ length: k2 - 1 }, (_, i2) => (i2 + 1) / k2), 0.95];
+}
 async function captureDeVerificationFrames(session, page, logInitPhase) {
-  const kRaw = Number(process.env.HF_DE_VERIFY ?? "4");
+  const kRaw = Number(process.env.HF_DE_VERIFY ?? session.options.deVerifySamples ?? "4");
   const k2 = Number.isFinite(kRaw) ? Math.max(0, Math.min(8, Math.floor(kRaw))) : 4;
   if (k2 === 0 || process.env.HF_FORCE_DRAWELEMENT === "1") return;
   if (session.options.format === "png") return;
@@ -64623,7 +64628,7 @@ async function captureDeVerificationFrames(session, page, logInitPhase) {
     }
   }
   const boundary = await computeClipBoundaryFrames(page, fps);
-  const fractions = Array.from({ length: k2 }, (_, i2) => (i2 + 1) / (k2 + 1));
+  const fractions = computeDeVerifySampleFractions(k2);
   const seekTo = async (t2) => {
     await page.evaluate((tt3) => {
       const hf = window.__hf;
@@ -64672,6 +64677,8 @@ function getCapturePerfSummary(session) {
     staticDedupArmed: (session.staticFrames?.size ?? 0) > 0,
     staticDedupPredicted: session.staticFrames?.size ?? 0,
     staticDedupSkipReason: session.staticDedupSkipReason,
+    beginFrameNoDamage: session.beginFrameNoDamageCount,
+    beginFrameHasDamage: session.beginFrameHasDamageCount,
     captureMode: session.captureMode,
     deGateReason: session.deGateReason,
     deWorkerEncode: session.workerEncodeEnabled ?? false,
@@ -70849,10 +70856,11 @@ var init_dist4 = __esm({
         ];
       },
       // missing_timeline_registry + timeline_registry_missing_init
-      ({ source, rawSource, options }) => {
+      ({ source, rawSource, rootTag, options }) => {
         if (options.isSubComposition || rawSource.trimStart().toLowerCase().startsWith("<template")) {
           return [];
         }
+        if (/(?:^|\s)data-no-timeline(?=[\s=/]|$)/i.test(rootTag?.attrs || "")) return [];
         const findings = [];
         if (!TIMELINE_REGISTRY_INIT_PATTERN.test(source) && !TIMELINE_REGISTRY_ASSIGN_PATTERN.test(source) && !TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN.test(source)) {
           findings.push({
@@ -76850,6 +76858,11 @@ async function executeWorkerTask(task, serverUrl, captureOptions, createBeforeCa
     });
   }
 }
+function resolveParallelDeVerifySamples(callerValue, workerCount) {
+  if (callerValue !== void 0) return callerValue;
+  if (workerCount <= 1) return void 0;
+  return Math.min(8, 4 + 2 * (workerCount - 1));
+}
 async function executeParallelCapture(serverUrl, workDir, tasks, captureOptions, createBeforeCaptureHook, signal, onProgress, onFrameBuffer, config) {
   const totalFrames = tasks.reduce(
     (sum, t2) => sum + Math.ceil((t2.endFrame - t2.startFrame) / (t2.frameStride ?? 1)),
@@ -76871,12 +76884,17 @@ async function executeParallelCapture(serverUrl, workDir, tasks, captureOptions,
     }
   };
   const parallel = tasks.length > 1;
+  const deVerifySamples = resolveParallelDeVerifySamples(
+    captureOptions.deVerifySamples,
+    tasks.length
+  );
+  const workerCaptureOptions = deVerifySamples === captureOptions.deVerifySamples ? captureOptions : { ...captureOptions, deVerifySamples };
   const results = await Promise.all(
     tasks.map(
       (task) => executeWorkerTask(
         task,
         serverUrl,
-        captureOptions,
+        workerCaptureOptions,
         createBeforeCaptureHook,
         signal,
         onFrameCaptured,
@@ -79261,6 +79279,7 @@ function renderObservabilityEventProperties(props) {
     de_pre_router_workers: props.captureDePreRouterWorkers,
     de_self_verify_fallback: props.captureDeSelfVerifyFallback,
     de_fallback_reason: props.captureDeFallbackReason,
+    capture_parallel_stream: props.captureParallelStream,
     observability_extract_video_count: props.observabilityExtractVideoCount,
     observability_extracted_video_count: props.observabilityExtractedVideoCount,
     observability_extract_total_frames: props.observabilityExtractTotalFrames,
@@ -79305,6 +79324,8 @@ function trackRenderComplete(props) {
       static_dedup_skip_reason: props.staticDedupSkipReason,
       static_dedup_predicted_frames: props.staticDedupPredictedFrames,
       static_dedup_reused_frames: props.staticDedupReusedFrames,
+      begin_frame_no_damage_frames: props.beginFrameNoDamageFrames,
+      begin_frame_has_damage_frames: props.beginFrameHasDamageFrames,
       de_capture_mode: props.deCaptureMode,
       de_compile_gate: props.deCompileGate,
       de_clamp_reason: props.deClampReason,
@@ -84448,6 +84469,9 @@ function buildBrowserArgs(url, options) {
   if (options.remoteDebuggingPort !== void 0 && options.userDataDir) {
     args.push(`--remote-debugging-port=${options.remoteDebuggingPort}`);
   }
+  if (options.disableGpu) {
+    args.push("--disable-gpu");
+  }
   args.push(url);
   return args;
 }
@@ -85312,6 +85336,7 @@ function renderObservabilityTelemetryPayload(observability) {
     captureDePreRouterWorkers: capture2.dePreRouterWorkers,
     captureDeSelfVerifyFallback: capture2.deSelfVerifyFallback,
     captureDeFallbackReason: capture2.deFallbackReason,
+    captureParallelStream: capture2.captureParallelStream,
     observabilityExtractVideoCount: extraction?.videoCount,
     observabilityExtractedVideoCount: extraction?.extractedVideoCount,
     observabilityExtractTotalFrames: extraction?.totalFramesExtracted,
@@ -101069,6 +101094,12 @@ function aggregateDedup(perfs) {
     skipReason: skipReasons.length > 0 ? skipReasons.join("|") : void 0
   };
 }
+function aggregateBeginFrameReuse(perfs) {
+  const noDamageFrames = perfs.reduce((sum, p2) => sum + (p2.beginFrameNoDamage ?? 0), 0);
+  const hasDamageFrames = perfs.reduce((sum, p2) => sum + (p2.beginFrameHasDamage ?? 0), 0);
+  if (noDamageFrames + hasDamageFrames === 0) return void 0;
+  return { noDamageFrames, hasDamageFrames };
+}
 function buildRenderPerfSummary(input2) {
   return {
     renderId: input2.job.id,
@@ -101112,6 +101143,7 @@ function buildRenderPerfSummary(input2) {
     peakRssMb: Math.round(input2.peakRssBytes / (1024 * 1024)),
     peakHeapUsedMb: Math.round(input2.peakHeapUsedBytes / (1024 * 1024)),
     staticDedup: aggregateDedup(input2.dedupPerfs),
+    beginFrameReuse: aggregateBeginFrameReuse(input2.dedupPerfs),
     drawElement: aggregateDrawElement(
       input2.dedupPerfs,
       input2.drawElement ?? { selfVerifyFallback: false }
@@ -106318,6 +106350,39 @@ function detectThreeDTransformUsage(html) {
 function detectMixBlendModeUsage(html) {
   return MIX_BLEND_MODE_PATTERN.test(html);
 }
+function detectAncestorBackgroundImage(html) {
+  const { document: document2 } = parseHTML(html);
+  const root = document2.querySelector("[data-composition-id]");
+  if (!root) return false;
+  const ancestors = [];
+  for (let el = root.parentElement; el; el = el.parentElement) ancestors.push(el);
+  if (document2.documentElement && !ancestors.includes(document2.documentElement)) {
+    ancestors.push(document2.documentElement);
+  }
+  for (const el of ancestors) {
+    const style = el.getAttribute("style");
+    if (style && BACKGROUND_IMAGE_DECL_PATTERN.test(`{${style}}`)) return true;
+  }
+  for (const styleEl of document2.querySelectorAll("style")) {
+    const css = styleEl.textContent ?? "";
+    for (const rule of css.matchAll(/([^{}]+)\{([^}]*)\}/g)) {
+      const [, selectorList = "", declarations = ""] = rule;
+      if (!BACKGROUND_IMAGE_DECL_PATTERN.test(`{${declarations}}`)) continue;
+      for (const selector of selectorList.split(",")) {
+        const sel = selector.trim();
+        if (!sel || sel.startsWith("@")) continue;
+        if (/^(?:html|:root)$/i.test(sel)) return true;
+        try {
+          for (const matched of document2.querySelectorAll(sel)) {
+            if (ancestors.includes(matched)) return true;
+          }
+        } catch {
+        }
+      }
+    }
+  }
+  return false;
+}
 function detectShaderTransitionUsage(html) {
   let scriptMatch;
   const scriptPattern = new RegExp(INLINE_SCRIPT_PATTERN.source, INLINE_SCRIPT_PATTERN.flags);
@@ -107150,6 +107215,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
   const hasShaderTransitions = detectShaderTransitionUsage(sanitizedHtml);
   const usesThreeDTransforms = detectThreeDTransformUsage(sanitizedHtml);
   const usesMixBlendMode = detectMixBlendModeUsage(sanitizedHtml);
+  const hasAncestorBackgroundImage = detectAncestorBackgroundImage(sanitizedHtml);
   const normalizedFontHtml = normalizeSystemFontPrimaryFamilies(
     injectTextRenderingRule2(
       coalesceHeadStylesAndBodyScripts2(promoteCssImportsToLinkTags(sanitizedHtml))
@@ -107256,7 +107322,8 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     renderModeHints,
     hasShaderTransitions,
     usesThreeDTransforms,
-    usesMixBlendMode
+    usesMixBlendMode,
+    hasAncestorBackgroundImage
   };
 }
 async function discoverMediaFromBrowser(page) {
@@ -107495,7 +107562,7 @@ async function recompileWithResolutions(compiled, resolutions, projectDir, downl
     hasShaderTransitions: compiled.hasShaderTransitions
   };
 }
-var EmptyCompositionError, INLINE_SCRIPT_PATTERN, COMPILER_MOUNT_BLOCK_START, COMPILER_MOUNT_BLOCK_END, THREE_D_CONTEXT_PATTERN, MIX_BLEND_MODE_PATTERN, SHADER_TRANSITION_USAGE_PATTERN, REMOTE_MEDIA_SUBDIR, REMOTE_MEDIA_TAG_RE, REMOTE_IMG_TAG_RE, REMOTE_BG_URL_RE, REMOTE_FONTFACE_URL_RE, MAX_STYLESHEET_BYTES, LOCAL_FONTFACE_URL_RE, GSAP_CDN_BASE;
+var EmptyCompositionError, INLINE_SCRIPT_PATTERN, COMPILER_MOUNT_BLOCK_START, COMPILER_MOUNT_BLOCK_END, THREE_D_CONTEXT_PATTERN, MIX_BLEND_MODE_PATTERN, BACKGROUND_IMAGE_DECL_PATTERN, SHADER_TRANSITION_USAGE_PATTERN, REMOTE_MEDIA_SUBDIR, REMOTE_MEDIA_TAG_RE, REMOTE_IMG_TAG_RE, REMOTE_BG_URL_RE, REMOTE_FONTFACE_URL_RE, MAX_STYLESHEET_BYTES, LOCAL_FONTFACE_URL_RE, GSAP_CDN_BASE;
 var init_htmlCompiler2 = __esm({
   "../producer/src/services/htmlCompiler.ts"() {
     "use strict";
@@ -107532,6 +107599,7 @@ Check that each file referenced by data-composition-src contains valid HTML with
     COMPILER_MOUNT_BLOCK_END = "/* __HF_COMPILER_MOUNT_END__ */";
     THREE_D_CONTEXT_PATTERN = /transform-style\s*:\s*preserve-3d|backface-visibility\s*:|perspective\s*:\s*[0-9]|perspective\s*\(|matrix3d\s*\(|rotate3d\s*\(|\btransformPerspective\b/i;
     MIX_BLEND_MODE_PATTERN = /mix-blend-mode\s*:/i;
+    BACKGROUND_IMAGE_DECL_PATTERN = /(?:^|;|\{)\s*background(?:-image)?\s*:[^;}]*(?:\bgradient\s*\(|url\s*\()/i;
     SHADER_TRANSITION_USAGE_PATTERN = /\b(?:(?:window|globalThis)\s*\.\s*)?HyperShader\s*\.\s*init\s*\(|\b__hf\s*\.\s*transitions\s*=/;
     REMOTE_MEDIA_SUBDIR = "_remote_media";
     REMOTE_MEDIA_TAG_RE = /<(?:video|audio)\b[^>]*?\bsrc\s*=\s*["'](https?:\/\/[^"']+)["'][^>]*>/gi;
@@ -107586,6 +107654,13 @@ async function runCompileStage(input2) {
       "[Render] Fast capture: composition uses mix-blend-mode \u2014 disabling drawElementImage for this render. Capture uses the platform's baseline route."
     );
   }
+  if (cfg.useDrawElement && process.env.HF_FAST_CAPTURE_ANCESTOR_BG !== "true" && compiled.hasAncestorBackgroundImage) {
+    cfg.useDrawElement = false;
+    deCompileGate = "ancestor_background_image";
+    log2.info(
+      "[Render] Fast capture: composition root's ancestors (body/html/wrapper) carry a background-image \u2014 disabling drawElementImage for this render. Capture uses the platform's baseline route."
+    );
+  }
   if (cfg.useDrawElement && process.env.PRODUCER_EXPERIMENTAL_FAST_CAPTURE !== "true" && compiled.hasShaderTransitions) {
     cfg.useDrawElement = false;
     deCompileGate = "shader_transitions";
@@ -109632,7 +109707,8 @@ import {
   mkdirSync as mkdirSync19,
   mkdtempSync as mkdtempSync3,
   openSync as openSync3,
-  readFileSync as readFileSync25
+  readFileSync as readFileSync25,
+  statfsSync as statfsSync2
 } from "fs";
 import { join as join43 } from "path";
 function tempDirSafePrefix(id) {
@@ -109715,9 +109791,52 @@ async function probeHdrExtractionDims(args) {
     }
   }
 }
+function estimateHdrExtractionBytes(videos, fps) {
+  let total = 0;
+  for (const v2 of videos) {
+    const frames = Math.ceil(Math.max(0, v2.durationSeconds) * fps);
+    total += frames * v2.width * v2.height * 6;
+  }
+  return total;
+}
+function assertHdrExtractionDiskHeadroom(framesDir, plannedVideos, fps, log2) {
+  const estimatedBytes = estimateHdrExtractionBytes(plannedVideos, fps);
+  let freeBytes;
+  try {
+    const stat3 = statfsSync2(framesDir);
+    freeBytes = stat3.bavail * stat3.bsize;
+  } catch {
+    return;
+  }
+  const estimatedGb = (estimatedBytes / 1e9).toFixed(1);
+  if (estimatedBytes > freeBytes * HDR_EXTRACTION_HEADROOM_FRACTION) {
+    throw new Error(
+      `HDR pre-extraction needs ~${estimatedGb} GB of raw 16-bit frames but only ${(freeBytes / 1e9).toFixed(1)} GB is free at ${framesDir}. If the composition doesn't need HDR output, re-run with --sdr; otherwise free up disk space and retry.`
+    );
+  }
+  if (estimatedBytes > HDR_EXTRACTION_WARN_BYTES) {
+    log2.warn(
+      `HDR pre-extraction will write ~${estimatedGb} GB of raw 16-bit frames (pass --sdr to skip if HDR output isn't needed)`,
+      { estimatedBytes, freeBytes }
+    );
+  }
+}
 async function extractHdrVideoFrames(args) {
   const { job, log: log2, framesDir, composition, prep, width, height, abortSignal, hdrDiagnostics } = args;
   const out = /* @__PURE__ */ new Map();
+  mkdirSync19(framesDir, { recursive: true });
+  const plannedVideos = [];
+  for (const [videoId] of prep.hdrVideoSrcPaths) {
+    const video = composition.videos.find((v2) => v2.id === videoId);
+    if (!video) continue;
+    const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
+    plannedVideos.push({
+      durationSeconds: video.end - video.start,
+      width: dims.width,
+      height: dims.height
+    });
+  }
+  assertHdrExtractionDiskHeadroom(framesDir, plannedVideos, fpsToNumber(job.config.fps), log2);
   for (const [videoId, srcPath] of prep.hdrVideoSrcPaths) {
     const video = composition.videos.find((v2) => v2.id === videoId);
     if (!video) continue;
@@ -109825,13 +109944,15 @@ function decodeHdrImageBuffers(args) {
   }
   return out;
 }
-var NO_FOLLOW_FLAG;
+var NO_FOLLOW_FLAG, HDR_EXTRACTION_HEADROOM_FRACTION, HDR_EXTRACTION_WARN_BYTES;
 var init_captureHdrResources = __esm({
   "../producer/src/services/render/stages/captureHdrResources.ts"() {
     "use strict";
     init_src();
     init_dist3();
     NO_FOLLOW_FLAG = constants3.O_NOFOLLOW ?? 0;
+    HDR_EXTRACTION_HEADROOM_FRACTION = 0.9;
+    HDR_EXTRACTION_WARN_BYTES = 1e10;
   }
 });
 
@@ -110940,6 +111061,8 @@ async function runEncodeStage(input2) {
     return { encodeMs: Date.now() - stage5Start };
   }
   updateJobStatus(job, "encoding", "Encoding video", 75, onProgress);
+  const scaledEncodeTimeout = Math.ceil((job.duration ?? 0) * 4e3);
+  const videoEngineCfg = scaledEncodeTimeout > engineCfg.ffmpegEncodeTimeout ? { ...engineCfg, ffmpegEncodeTimeout: scaledEncodeTimeout } : engineCfg;
   const frameExt = needsAlpha ? "png" : "jpg";
   const framePattern = `frame_%06d.${frameExt}`;
   const encoderOpts = {
@@ -110967,14 +111090,14 @@ async function runEncodeStage(input2) {
     encoderOpts,
     chunkedEncodeSize,
     abortSignal,
-    engineCfg
+    videoEngineCfg
   ) : await encodeFramesFromDir(
     framesDir,
     framePattern,
     videoOnlyPath,
     encoderOpts,
     abortSignal,
-    engineCfg
+    videoEngineCfg
   );
   assertNotAborted();
   if (!encodeResult.success) {
@@ -111056,6 +111179,7 @@ import {
   appendFileSync
 } from "fs";
 import { join as join50, dirname as dirname19, resolve as resolve26 } from "path";
+import { totalmem as totalmem2 } from "os";
 import { randomUUID as randomUUID4 } from "crypto";
 import { fileURLToPath as fileURLToPath5 } from "url";
 function sampleDirectoryBytes(dir) {
@@ -111380,11 +111504,24 @@ function createRenderJob(config) {
 function normalizeCompositionSrcPath(srcPath) {
   return srcPath.replace(/\\/g, "/").replace(/^\.\//, "");
 }
-function createStandaloneEntryRenderClone(root, host) {
+function readSceneRootDuration(entryHtml) {
+  if (!entryHtml) return null;
+  const { document: document2 } = parseHTML(entryHtml);
+  const template = document2.querySelector("template");
+  const scope = template ? parseHTML(template.innerHTML).document : document2;
+  const root = scope.querySelector("[data-composition-id]");
+  return root?.getAttribute("data-duration") ?? null;
+}
+function createStandaloneEntryRenderClone(root, host, sceneDuration) {
   const hostClone = host.cloneNode(true);
   hostClone.setAttribute("data-start", "0");
   if (root === host) return hostClone;
   const rootClone = root.cloneNode(false);
+  if (sceneDuration != null) {
+    rootClone.setAttribute("data-duration", sceneDuration);
+  } else {
+    rootClone.removeAttribute("data-duration");
+  }
   rootClone.appendChild(hostClone);
   return rootClone;
 }
@@ -111421,7 +111558,13 @@ function resolveInversionRetryPlan(args) {
   };
 }
 function shouldPreferParallelDrawElement(args) {
-  return args.routerEnabled && args.workerCount > 1 && typeof args.requestedWorkers !== "number" && args.useDrawElement && !args.deCompileGate && !args.forceScreenshot && args.outputFormat === "mp4" && args.minFrames > 0 && args.totalFrames >= args.minFrames && !args.layeredOrEffectRoute && !args.supersampling && !args.probeDeGated && !args.experimentalParallelDeOptIn;
+  return args.routerEnabled && args.workerCount > 1 && typeof args.requestedWorkers !== "number" && args.useDrawElement && !args.deCompileGate && !args.forceScreenshot && args.outputFormat === "mp4" && args.minFrames > 0 && args.totalFrames >= args.minFrames && !args.layeredOrEffectRoute && !args.supersampling && !args.probeDeGated && !args.experimentalParallelDeOptIn && // RAM floor: routed parallel DE runs 3 concurrent hardware-GPU Chrome
+  // instances. On a 16 GB machine that produced vertical black slabs in the
+  // final MP4 (wild report, CLI 0.7.52) — compositor tiles evicted under
+  // GPU/memory pressure, and sampled self-verify can miss partial-frame
+  // damage. Single-worker DE (the inversion) stays available below the
+  // floor; only the parallel bet is withheld.
+  (args.minMemoryMb <= 0 || args.totalMemoryMb >= args.minMemoryMb);
 }
 function resolveParallelRouterRetryPlan(args) {
   if (args.deParallelRouter !== "routed") return null;
@@ -111442,13 +111585,16 @@ function shouldRetryViaPinnedFallback(args) {
   if (args.isVerifyError) return true;
   return args.deWorkerInversion === "inverted" || args.deParallelRouter === "routed";
 }
+function shouldStreamParallelCapture(args) {
+  return args.routerEnabled && args.workerCount > 1 && !args.useDrawElement && args.outputFormat === "mp4" && args.streamingOk && !args.layeredOrEffectRoute;
+}
 function resolveCaptureForceScreenshotForPageSideCompositing(args) {
   return args.usePageSideCompositing ? true : args.forceScreenshot;
 }
 function shouldDiscardProbeSessionForPageSideCompositing(args) {
   return args.hasProbeSession && args.usePageSideCompositing;
 }
-function extractStandaloneEntryFromIndex(indexHtml, entryFile) {
+function extractStandaloneEntryFromIndex(indexHtml, entryFile, entryHtml) {
   const normalizedEntryFile = normalizeCompositionSrcPath(entryFile);
   const { document: document2 } = parseHTML(indexHtml);
   const body = document2.querySelector("body");
@@ -111462,7 +111608,8 @@ function extractStandaloneEntryFromIndex(indexHtml, entryFile) {
     (candidate) => candidate.hasAttribute("data-composition-id")
   ) ?? null;
   if (!root) return null;
-  const renderClone = createStandaloneEntryRenderClone(root, host);
+  const sceneDuration = readSceneRootDuration(entryHtml) ?? host.getAttribute("data-duration");
+  const renderClone = createStandaloneEntryRenderClone(root, host, sceneDuration);
   replaceBodyWithRenderClone(body, renderClone);
   return document2.toString();
 }
@@ -111582,7 +111729,8 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       }
       const standaloneHtml = extractStandaloneEntryFromIndex(
         readFileSync26(projectIndexPath, "utf-8"),
-        entryFile
+        entryFile,
+        rawEntry
       );
       if (!standaloneHtml) {
         throw new Error(
@@ -111627,6 +111775,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     let deClampReason;
     let deWorkerInversion;
     let deParallelStreamForced = false;
+    let captureParallelStreamForced = false;
     let deSelfVerifyFallback = false;
     let deFallbackReason;
     let deDrainStats;
@@ -111882,6 +112031,9 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     const deParallelMinFramesRaw = process.env.HF_DE_PARALLEL_MIN_FRAMES;
     const deParallelMinFramesNum = deParallelMinFramesRaw === void 0 || deParallelMinFramesRaw.trim() === "" ? 2e3 : Number(deParallelMinFramesRaw);
     const deParallelMinFrames = Number.isFinite(deParallelMinFramesNum) ? deParallelMinFramesNum : 2e3;
+    const deParallelMinMemRaw = process.env.HF_DE_PARALLEL_MIN_MEM_MB;
+    const deParallelMinMemNum = deParallelMinMemRaw === void 0 || deParallelMinMemRaw.trim() === "" ? 24576 : Number(deParallelMinMemRaw);
+    const deParallelMinMemoryMb = Number.isFinite(deParallelMinMemNum) ? deParallelMinMemNum : 24576;
     const deParallelRouterEligible = shouldPreferParallelDrawElement({
       workerCount: WOULD_RESOLVE_MULTI_WORKER,
       requestedWorkers: job.config.workers,
@@ -111895,7 +112047,9 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       supersampling: deviceScaleFactor > 1,
       probeDeGated: probeSession !== null && probeSession.captureMode !== "drawelement" && !probeSession.deInitDeferred,
       experimentalParallelDeOptIn: process.env.PRODUCER_EXPERIMENTAL_FAST_CAPTURE === "true" || process.env.HF_DE_PARALLEL_STREAM === "true",
-      routerEnabled: deParallelRouterEnabled
+      routerEnabled: deParallelRouterEnabled,
+      totalMemoryMb: Math.round(totalmem2() / (1024 * 1024)),
+      minMemoryMb: deParallelMinMemoryMb
     });
     let workerCount;
     const captureStageObservationData = (extra = {}) => ({
@@ -112005,6 +112159,32 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       deWorkerInversion: deWorkerInversion ?? "none",
       deParallelRouter: deParallelRouter ?? "none"
     });
+    const captureParallelStreamRouterEnabled = process.env.HF_CAPTURE_PARALLEL_STREAM === "true";
+    const captureParallelStreamArgs = {
+      workerCount,
+      useDrawElement: cfg.useDrawElement,
+      outputFormat,
+      streamingOk: shouldUseStreamingEncode(cfg, outputFormat, 1, job.duration),
+      layeredOrEffectRoute: hasHdrContent || compiled.hasShaderTransitions
+    };
+    const captureParallelStreamEligible = shouldStreamParallelCapture({
+      routerEnabled: captureParallelStreamRouterEnabled,
+      ...captureParallelStreamArgs
+    });
+    if (captureParallelStreamEligible) {
+      captureParallelStreamForced = true;
+      const captureParallelStream = process.platform === "linux" && !captureForceScreenshot ? "beginframe" : "screenshot";
+      log2.info(
+        `[Render] Parallel ${captureParallelStream} capture will stream to the encoder (interleaved, ${workerCount} workers) instead of the disk path. Set HF_CAPTURE_PARALLEL_STREAM=false to disable.`
+      );
+      updateCaptureObservability({ captureParallelStream });
+      observability.checkpoint(
+        "worker_resolution",
+        `parallel ${captureParallelStream} capture routed to streaming`
+      );
+    } else if (shouldStreamParallelCapture({ routerEnabled: true, ...captureParallelStreamArgs })) {
+      updateCaptureObservability({ captureParallelStream: "eligible_off" });
+    }
     if (workerCount > 1 && probeSession) {
       lastBrowserConsole = probeSession.browserConsoleBuffer;
       await closeCaptureSession(probeSession);
@@ -112015,7 +112195,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       outputFormat,
       workerCount,
       job.duration,
-      deParallelStreamForced
+      deParallelStreamForced || captureParallelStreamForced
     );
     log2.info("streaming-encode gate", {
       enabled: useStreamingEncode,
@@ -112172,7 +112352,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
               workerCount,
               probeSession,
               outputFormat,
-              forceParallelStream: deParallelStreamForced,
+              forceParallelStream: deParallelStreamForced || captureParallelStreamForced,
               streamingEncoderOptions: {
                 fps: job.config.fps,
                 width,
@@ -115270,6 +115450,7 @@ __export(src_exports2, {
   getCapturePerfSummary: () => getCapturePerfSummary,
   getCompositionDuration: () => getCompositionDuration,
   initializeSession: () => initializeSession,
+  injectDeterministicFontFaces: () => injectDeterministicFontFaces,
   localizeRemoteFontFaces: () => localizeRemoteFontFaces,
   localizeRemoteImageSources: () => localizeRemoteImageSources,
   localizeRemoteMediaSources: () => localizeRemoteMediaSources,
@@ -115296,6 +115477,7 @@ var init_src2 = __esm({
     init_logger();
     init_server();
     init_errorMessage2();
+    init_deterministicFonts();
     init_parityContract2();
     init_paths();
     init_hyperframeLint();
@@ -117206,7 +117388,8 @@ function openStudioBrowser(url, projectName, options) {
   openBrowser(`${url}#project/${projectName}`, {
     browserPath: options?.browserPath,
     userDataDir: options?.userDataDir,
-    remoteDebuggingPort: options?.remoteDebuggingPort
+    remoteDebuggingPort: options?.remoteDebuggingPort,
+    disableGpu: options?.browserNoGpu
   });
 }
 function printStudioSummary(projectName, url, opts = {}) {
@@ -117528,6 +117711,11 @@ var init_preview = __esm({
         "remote-debugging-port": {
           type: "string",
           description: "Chromium remote debugging port (requires --browser-path and --user-data-dir)"
+        },
+        "browser-no-gpu": {
+          type: "boolean",
+          default: false,
+          description: "Launch the opened browser with --disable-gpu (requires --browser-path). For hosts where hardware acceleration crashes the graphics driver (e.g. NVIDIA Xid resets); with the system default browser use --no-open instead."
         }
       },
       async run({ args }) {
@@ -117617,6 +117805,14 @@ var init_preview = __esm({
         }
         const noOpen = !args.open;
         const browserPath = args["browser-path"];
+        const browserNoGpu = !!args["browser-no-gpu"];
+        if (browserNoGpu && !browserPath) {
+          R2.error(
+            "--browser-no-gpu requires --browser-path (the system default browser cannot receive Chromium flags \u2014 use --no-open on GPU-unstable hosts)"
+          );
+          process.exitCode = 1;
+          return;
+        }
         const userDataDir = args["user-data-dir"];
         let remoteDebuggingPort;
         try {
@@ -117634,7 +117830,8 @@ var init_preview = __esm({
             noOpen,
             browserPath,
             userDataDir,
-            remoteDebuggingPort
+            remoteDebuggingPort,
+            browserNoGpu
           });
         }
         if (hasLocalStudio(dir)) {
@@ -117643,7 +117840,8 @@ var init_preview = __esm({
             noOpen,
             browserPath,
             userDataDir,
-            remoteDebuggingPort
+            remoteDebuggingPort,
+            browserNoGpu
           });
         }
         const forceNew = !!args["force-new"];
@@ -117653,7 +117851,8 @@ var init_preview = __esm({
           noOpen,
           browserPath,
           userDataDir,
-          remoteDebuggingPort
+          remoteDebuggingPort,
+          browserNoGpu
         });
       }
     });
@@ -121735,6 +121934,8 @@ function trackRenderMetrics(job, elapsedMs, options, docker) {
     staticDedupSkipReason: perf?.staticDedup?.skipReason,
     staticDedupPredictedFrames: perf?.staticDedup?.predictedFrames,
     staticDedupReusedFrames: perf?.staticDedup?.reusedFrames,
+    beginFrameNoDamageFrames: perf?.beginFrameReuse?.noDamageFrames,
+    beginFrameHasDamageFrames: perf?.beginFrameReuse?.hasDamageFrames,
     deCaptureMode: perf?.drawElement?.mode,
     deCompileGate: perf?.drawElement?.compileGate,
     deClampReason: perf?.drawElement?.clampReason,
@@ -123419,8 +123620,9 @@ async function seekCompositionTimeline(page, timeSeconds, options = {}) {
       )
     );
   }
-  if (options.waitForFontsMs !== void 0) {
-    await waitForCompositionFonts(page, options.waitForFontsMs);
+  const waitForFontsMs = options.waitForFontsMs ?? DEFAULT_POST_SEEK_FONT_WAIT_MS;
+  if (waitForFontsMs > 0) {
+    await waitForCompositionFonts(page, waitForFontsMs);
   }
   if (options.settleMs !== void 0) {
     const settleMs = Math.max(0, options.settleMs);
@@ -123447,12 +123649,23 @@ async function waitForCompositionFonts(page, timeoutMs) {
   await page.evaluate((ms) => {
     const fonts = Reflect.get(document, "fonts");
     if (typeof fonts !== "object" || fonts === null) return Promise.resolve();
-    const ready = Reflect.get(fonts, "ready");
-    if (!ready) return Promise.resolve();
-    return Promise.race([
-      Promise.resolve(ready).then(() => void 0),
-      new Promise((resolve64) => setTimeout(resolve64, ms))
-    ]);
+    void document.body?.offsetHeight;
+    return new Promise((resolveWait) => {
+      const deadline = setTimeout(resolveWait, ms);
+      requestAnimationFrame(() => {
+        const status = Reflect.get(fonts, "status");
+        const ready = Reflect.get(fonts, "ready");
+        if (status !== "loading" || !ready) {
+          clearTimeout(deadline);
+          resolveWait();
+          return;
+        }
+        Promise.resolve(ready).then(() => {
+          clearTimeout(deadline);
+          resolveWait();
+        });
+      });
+    });
   }, timeoutMs).catch(() => {
   });
 }
@@ -123527,7 +123740,7 @@ async function runFfmpegOnce(ffmpegPath, args, timeoutMs) {
     });
   });
 }
-var SHADER_TRANSITIONS_TIMEOUT_MS, CAPTURE_SETTLE_MS, PREFERRED_SEEK_TARGET_WAIT_MS, AUDIT_SEEK_OPTIONS, ZOOM_REGION_PATTERN, DEFAULT_ZOOM_PADDING_PX, DEFAULT_ZOOM_SCALE, MIN_CROP_REGION_PX;
+var SHADER_TRANSITIONS_TIMEOUT_MS, CAPTURE_SETTLE_MS, PREFERRED_SEEK_TARGET_WAIT_MS, DEFAULT_POST_SEEK_FONT_WAIT_MS, AUDIT_SEEK_OPTIONS, ZOOM_REGION_PATTERN, DEFAULT_ZOOM_PADDING_PX, DEFAULT_ZOOM_SCALE, MIN_CROP_REGION_PX;
 var init_captureCompositionFrame = __esm({
   "src/capture/captureCompositionFrame.ts"() {
     "use strict";
@@ -123536,6 +123749,7 @@ var init_captureCompositionFrame = __esm({
     SHADER_TRANSITIONS_TIMEOUT_MS = 9e4;
     CAPTURE_SETTLE_MS = 1500;
     PREFERRED_SEEK_TARGET_WAIT_MS = 500;
+    DEFAULT_POST_SEEK_FONT_WAIT_MS = 500;
     AUDIT_SEEK_OPTIONS = {
       fallbackToBridgeAndTimelines: true,
       animationFrameSettle: "double",
@@ -124512,6 +124726,57 @@ Examples:
   }
 });
 
+// src/utils/bundleWithLocalizedFonts.ts
+var bundleWithLocalizedFonts_exports = {};
+__export(bundleWithLocalizedFonts_exports, {
+  __resetFontLocalizationWarningsForTests: () => __resetFontLocalizationWarningsForTests,
+  bundleWithLocalizedFonts: () => bundleWithLocalizedFonts,
+  localizeWithProducer: () => localizeWithProducer
+});
+async function bundleWithLocalizedFonts(projectDir, localizeFonts = localizeWithProducer) {
+  const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
+  const html = await bundleToSingleHtml2(projectDir);
+  return localizeFonts(html);
+}
+async function loadFontInjector() {
+  try {
+    const producerSpecifier = "@hyperframes/producer";
+    const mod = await import(
+      /* @vite-ignore */
+      producerSpecifier
+    );
+    return mod.injectDeterministicFontFaces ?? null;
+  } catch {
+    return null;
+  }
+}
+function __resetFontLocalizationWarningsForTests() {
+  warnedFontLocalizationFailures.clear();
+}
+async function localizeWithProducer(html, loadInjector = loadFontInjector, warn = (m2) => console.warn(`   ${c.warn("\u26A0")} ${m2}`)) {
+  const inject = await loadInjector();
+  if (!inject) return html;
+  try {
+    return await inject(html);
+  } catch (err) {
+    const message = `Font localization failed; capturing with remote/fallback fonts instead: ${normalizeErrorMessage(err)}`;
+    if (!warnedFontLocalizationFailures.has(message)) {
+      warnedFontLocalizationFailures.add(message);
+      warn(message);
+    }
+    return html;
+  }
+}
+var warnedFontLocalizationFailures;
+var init_bundleWithLocalizedFonts = __esm({
+  "src/utils/bundleWithLocalizedFonts.ts"() {
+    "use strict";
+    init_errorMessage();
+    init_colors();
+    warnedFontLocalizationFailures = /* @__PURE__ */ new Set();
+  }
+});
+
 // src/utils/checkBrowser.ts
 var checkBrowser_exports = {};
 __export(checkBrowser_exports, {
@@ -124522,8 +124787,8 @@ __export(checkBrowser_exports, {
 import { mkdirSync as mkdirSync36, writeFileSync as writeFileSync26 } from "fs";
 import { join as join76 } from "path";
 async function runBrowserCheck(project, options, motion, runGrid) {
-  const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
-  const html = await bundleToSingleHtml2(project.dir);
+  const { bundleWithLocalizedFonts: bundleWithLocalizedFonts2 } = await Promise.resolve().then(() => (init_bundleWithLocalizedFonts(), bundleWithLocalizedFonts_exports));
+  const html = await bundleWithLocalizedFonts2(project.dir);
   const server = await serveStaticProjectHtml(project.dir, html, "Failed to bind check server");
   const drafts = [];
   let currentTime = 0;
@@ -124561,8 +124826,8 @@ async function runBrowserCheck(project, options, motion, runGrid) {
 }
 async function captureFindingCrops(project, options, requests) {
   if (requests.length === 0) return [];
-  const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
-  const html = await bundleToSingleHtml2(project.dir);
+  const { bundleWithLocalizedFonts: bundleWithLocalizedFonts2 } = await Promise.resolve().then(() => (init_bundleWithLocalizedFonts(), bundleWithLocalizedFonts_exports));
+  const html = await bundleWithLocalizedFonts2(project.dir);
   const server = await serveStaticProjectHtml(project.dir, html, "Failed to bind check server");
   let chromeBrowser;
   const written = [];
@@ -125245,6 +125510,7 @@ var init_checkBrowser = __esm({
       "container_overflow",
       "content_overlap",
       "text_occluded",
+      "text_not_painted",
       "caption_zone_collision",
       "frame_out_of_frame",
       "motion_appears_late",
@@ -172136,9 +172402,9 @@ function computeSnapshotTimes(duration, opts) {
   return { times: times.map(round5), appendedTail: false };
 }
 async function captureSnapshots(projectDir, opts) {
-  const { bundleToSingleHtml: bundleToSingleHtml2 } = await Promise.resolve().then(() => (init_compiler(), compiler_exports));
+  const { bundleWithLocalizedFonts: bundleWithLocalizedFonts2 } = await Promise.resolve().then(() => (init_bundleWithLocalizedFonts(), bundleWithLocalizedFonts_exports));
   const numFrames = opts.frames ?? 5;
-  const html = await bundleToSingleHtml2(projectDir);
+  const html = await bundleWithLocalizedFonts2(projectDir);
   const server = await serveStaticProjectHtml(projectDir, html);
   const savedPaths = [];
   try {
@@ -172213,6 +172479,9 @@ async function captureSnapshots(projectDir, opts) {
         syncVideoFrameVisibility2 = engine.syncVideoFrameVisibility;
         extractMediaMetadata2 = engine.extractMediaMetadata;
       } catch {
+        console.warn(
+          `   ${c.warn("\u26A0")} @hyperframes/engine unavailable \u2014 <video> elements will appear black in snapshots. Verify media via a draft render's extracted frames instead.`
+        );
       }
       const alphaDecoderCache = /* @__PURE__ */ new Map();
       const shouldUseVp9AlphaDecoder = (filePath) => {
@@ -172285,6 +172554,12 @@ async function captureSnapshots(projectDir, opts) {
               dataUri: `data:image/png;base64,${png.toString("base64")}`
             });
           }
+          if (active.length > 0 && updates.length < active.length) {
+            const missed = active.length - updates.length;
+            console.warn(
+              `   ${c.warn("\u26A0")} ${missed}/${active.length} active <video> frame(s) could not be extracted at ${time.toFixed(1)}s \u2014 those videos will appear black/stale in this snapshot`
+            );
+          }
           try {
             if (updates.length > 0) {
               await injectVideoFramesBatch2(page, updates);
@@ -172294,6 +172569,9 @@ async function captureSnapshots(projectDir, opts) {
               active.map((a) => a.id)
             );
           } catch {
+            console.warn(
+              `   ${c.warn("\u26A0")} video frame injection failed at ${time.toFixed(1)}s \u2014 <video> elements will appear black/stale in this snapshot`
+            );
           }
         }
         const timeLabel = `${time.toFixed(1)}s`;