@hyperframes/producer 0.8.145 → 0.8.147

package/dist/public-server.js

@@ -292,7 +292,7 @@ function buildVirtualTimeShim(options) {
   const seedRandomFromFrame = options.seedRandomFromFrame === true;
   const seededRandomBlock = seedRandomFromFrame ? String.raw`
   // Seeded Math.random / crypto.getRandomValues, keyed by virtual time.
-  // Mulberry32 — single uint32 state, deterministic, fast.
+  // Mulberry32: single uint32 state, deterministic, fast.
   var rngState = 0;
   function mulberry32() {
     rngState |= 0; rngState = (rngState + 0x6D2B79F5) | 0;
@@ -303,7 +303,7 @@ function buildVirtualTimeShim(options) {
   }
   function reseedRngFromTime(ms) {
     var ms32 = Math.max(0, Math.floor(Number(ms) || 0)) | 0;
-    // Knuth's multiplicative hash + golden-ratio offset — gives a well-
+    // Knuth's multiplicative hash + golden-ratio offset gives a well-
     // distributed seed even for frame 0 (otherwise rngState=0 degenerates
     // the PRNG's first few outputs).
     rngState = (Math.imul(ms32, -1640531527) + 0x9E3779B9) | 0;
@@ -545,7 +545,7 @@ function buildRenderModeScript(fps) {
     };
     window.__playerReady = true;
     // Media-fallback player has no timeline to bind, so render-ready is immediate.
-    // init.ts defers __renderReady until the timeline is bound \u2014 different runtime.
+    // init.ts defers __renderReady until the timeline is bound (a different runtime).
     window.__renderReady = true;
     return true;
   }
@@ -2136,7 +2136,7 @@ function blitHdrVideoLayer(canvas, el, time, fps, hdrVideoFrameSources, hdrStart
       if (matrix && !isTranslationOnly) {
         if (clipped && log) {
           log.debug(
-            `HDR clip rect on affine-transformed element ${el.id} \u2014 clip not applied (affine scissor not yet supported)`
+            `HDR clip rect on affine-transformed element ${el.id}: clip not applied (affine scissor not yet supported)`
           );
         }
         blitRgb48leAffine(
@@ -2193,7 +2193,7 @@ function blitHdrImageLayer(canvas, el, hdrImageBuffers, hdrImageTransferCache, w
     return;
   }
   if (el.clipRect && log) {
-    log.debug(`HDR clip rect on image element ${el.id} \u2014 clip not yet supported for images`);
+    log.debug(`HDR clip rect on image element ${el.id}: clip not yet supported for images`);
   }
   try {
     if (hdrPerf) hdrPerf.hdrImageLayerBlits += 1;
@@ -3379,12 +3379,13 @@ function buildRenderPerfSummary(input) {
 // src/services/render/stages/captureStreamingStage.ts
 var DEFAULT_CAPTURE_STALL_MS = 6e4;
 var DE_STALL_POLL_MS = 5e3;
+var STALL_ADVICE = "Chrome stopped answering. If another app is keeping the GPU or CPU busy (a 3D render, a game, another export), let it finish or render one job at a time, then retry.";
 var ParallelCaptureStallError = class extends Error {
   variant;
   constructor(args) {
     const phases = args.phaseSummary ? ` Last worker phases: ${args.phaseSummary}.` : "";
     super(
-      args.variant === "drain" ? `[Render] Parallel ${args.captureLabel} capture stalled: no frame progress for ${args.stallTimeoutMs}ms (stuck at ${args.lastCapturedFrames}/${args.totalFrames}).${phases}` : `[Render] Parallel ${args.captureLabel} capture stalled after ${args.stallTimeoutMs}ms with no frame progress (last frame ${args.lastCapturedFrames}/${args.totalFrames}); retrying on a fresh screenshot session.${phases}`
+      (args.variant === "drain" ? `[Render] Parallel ${args.captureLabel} capture stalled: no frame progress for ${args.stallTimeoutMs}ms (stuck at ${args.lastCapturedFrames}/${args.totalFrames}).${phases}` : `[Render] Parallel ${args.captureLabel} capture stalled after ${args.stallTimeoutMs}ms with no frame progress (last frame ${args.lastCapturedFrames}/${args.totalFrames}); retrying on a fresh screenshot session.${phases}`) + ` ${STALL_ADVICE}`
     );
     this.name = "ParallelCaptureStallError";
     this.variant = args.variant;
@@ -3402,12 +3403,13 @@ function captureModeLabel(mode) {
 }
 var SequentialCaptureStallError = class extends Error {
   captureMode;
-  constructor(captureMode, stallTimeoutMs, frameIndex, totalFrames) {
+  constructor(session, stallTimeoutMs, frameIndex, totalFrames) {
+    const step = session.captureStep ? ` while ${session.captureStep}` : "";
     super(
-      `[Render] Sequential ${captureModeLabel(captureMode)} capture stalled: no frame progress for ${stallTimeoutMs}ms (stuck at frame ${frameIndex}/${totalFrames}).`
+      `[Render] Sequential ${captureModeLabel(session.captureMode)} capture stalled: no frame progress for ${stallTimeoutMs}ms (stuck at frame ${frameIndex}/${totalFrames}${step}). ` + STALL_ADVICE
     );
     this.name = "SequentialCaptureStallError";
-    this.captureMode = captureMode;
+    this.captureMode = session.captureMode;
   }
 };
 function raceAgainstStall(promise, deadlineMs, input, signal) {
@@ -3416,9 +3418,9 @@ function raceAgainstStall(promise, deadlineMs, input, signal) {
       () => {
         reject(
           signal?.aborted ? new Error(
-            `[Render] Sequential ${captureModeLabel(input.captureMode)} capture aborted while a capture call was in flight (frame ${input.frameIndex}/${input.totalFrames}).`
+            `[Render] Sequential ${captureModeLabel(input.session.captureMode)} capture aborted while a capture call was in flight (frame ${input.frameIndex}/${input.totalFrames}).`
           ) : new SequentialCaptureStallError(
-            input.captureMode,
+            input.session,
             input.stallTimeoutMs,
             input.frameIndex,
             input.totalFrames
@@ -3546,7 +3548,7 @@ async function runWorkerEncodePipelineLoop(session, totalFrames, job, currentEnc
   const captureWithStallGuard = (idx, promise) => raceAgainstStall(
     promise,
     stallTimeoutMs - (Date.now() - lastProgressAt),
-    { captureMode: session.captureMode, frameIndex: idx, totalFrames, stallTimeoutMs },
+    { session, frameIndex: idx, totalFrames, stallTimeoutMs },
     abortSignal
   );
   const drainPrev = async () => {
@@ -3900,7 +3902,7 @@ async function runCaptureStreamingStage(input) {
             const { buffer } = await raceAgainstStall(
               captureFrameToBuffer(session, i, time),
               stallTimeoutMs - (Date.now() - lastProgressAt),
-              { captureMode: session.captureMode, frameIndex: i, totalFrames, stallTimeoutMs },
+              { session, frameIndex: i, totalFrames, stallTimeoutMs },
               abortSignal
             );
             await reorderBuffer.waitForFrame(i);
@@ -3989,7 +3991,7 @@ async function captureSegmentFrames(ctx, segment, encoder) {
       ctx.captureFrame(ctx.session, i, time),
       ctx.stallTimeoutMs - (Date.now() - lastProgressAt),
       {
-        captureMode: ctx.session.captureMode,
+        session: ctx.session,
         frameIndex: i,
         totalFrames: ctx.totalFrames,
         stallTimeoutMs: ctx.stallTimeoutMs
@@ -4385,7 +4387,7 @@ import {
 function formatDowngradeWarning(outputFormat, forcedHdrWithoutSources) {
   const hdrSourceReason = forcedHdrWithoutSources ? "HDR was forced without detected HDR sources" : "HDR source detected";
   const formatReason = outputFormat === "hls" ? "HLS output is SDR-only (H.264 in MPEG-TS)" : "HDR + alpha is not supported";
-  return `[Render] ${hdrSourceReason}, but format is "${outputFormat}" \u2014 falling back to SDR. ${formatReason}. Use --format mp4 for HDR10 output.`;
+  return `[Render] ${hdrSourceReason}, but format is "${outputFormat}", so falling back to SDR. ${formatReason}. Use --format mp4 for HDR10 output.`;
 }
 function findRenderHdrAutoPromotionTrigger(input) {
   for (const extracted of input.extractionResult?.extracted ?? []) {
@@ -4398,12 +4400,12 @@ function findRenderHdrAutoPromotionTrigger(input) {
 function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources) {
   if (forcedHdrWithoutSources) {
     input.log.warn(
-      "[Render] HDR forced by --hdr flag, but no HDR sources were detected \u2014 defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
+      "[Render] HDR forced by --hdr flag, but no HDR sources were detected, defaulting to HLG. SDR-only compositions may look perceptually wrong on HDR displays."
     );
   }
   if (!effectiveHdr) {
     input.log.info(
-      hdrMode === "force-sdr" ? "[Render] SDR forced by --sdr flag" : "[Render] No HDR sources detected \u2014 rendering SDR"
+      hdrMode === "force-sdr" ? "[Render] SDR forced by --sdr flag" : "[Render] No HDR sources detected, rendering SDR"
     );
     return;
   }
@@ -4418,9 +4420,9 @@ function logHdrResolution(input, hdrMode, effectiveHdr, forcedHdrWithoutSources)
     );
     return;
   }
-  const reason = forcedHdrWithoutSources ? "forced by --hdr flag (no HDR sources detected \u2014 defaulting to HLG)" : "forced by --hdr flag";
+  const reason = forcedHdrWithoutSources ? "forced by --hdr flag (no HDR sources detected, defaulting to HLG)" : "forced by --hdr flag";
   input.log.info(
-    `[Render] HDR ${reason} \u2014 output: ${effectiveHdr.transfer.toUpperCase()} (BT.2020, 10-bit H.265)`
+    `[Render] HDR ${reason}, output: ${effectiveHdr.transfer.toUpperCase()} (BT.2020, 10-bit H.265)`
   );
 }
 function resolveEffectiveHdrMode(input) {
@@ -4516,14 +4518,14 @@ function resolveRenderWorkerCount(totalFrames, requestedWorkers, cfg, compiled,
   const reasonCodes = new Set(compiled.renderModeHints.reasons.map((r) => r.code));
   if (reasonCodes.has("htmlInCanvas")) {
     log.warn(
-      "[Render] html-in-canvas (drawElementImage) detected \u2014 pinning to 1 worker (Chrome concurrency limitation).",
+      "[Render] html-in-canvas (drawElementImage) detected, pinning to 1 worker (Chrome concurrency limitation).",
       { requestedWorkers }
     );
     return 1;
   }
   if (cfg.lowMemoryMode && requestedWorkers === void 0) {
     log.info(
-      "[Render] Low-memory profile \u2014 pinning to 1 capture worker (auto-worker calibration skipped)."
+      "[Render] Low-memory profile, pinning to 1 capture worker (auto-worker calibration skipped)."
     );
     return 1;
   }
@@ -5158,7 +5160,7 @@ function assertVideoFrameCoverage(reports, threshold) {
   const thresholdPct = (threshold * 100).toFixed(1);
   const suffix = sorted.length > 1 ? ` (+${sorted.length - 1} more clip(s) below threshold)` : "";
   throw new VideoFrameCoverageError(
-    `Video "${worst.videoId}" captured ${worst.capturedFrames} of expected ${worst.expectedFrames} frames (coverage ${pct}%, threshold ${thresholdPct}%). check/snapshot may pass while the encoded MP4 renders this clip blank \u2014 aborting render to prevent shipping a wrong MP4.${suffix} Set HF_VIDEO_COVERAGE_THRESHOLD=0 to disable this gate.`,
+    `Video "${worst.videoId}" captured ${worst.capturedFrames} of expected ${worst.expectedFrames} frames (coverage ${pct}%, threshold ${thresholdPct}%). check/snapshot may pass while the encoded MP4 renders this clip blank, so the render is aborted to prevent shipping a wrong MP4.${suffix} Set HF_VIDEO_COVERAGE_THRESHOLD=0 to disable this gate.`,
     { threshold, worst, failedReports: sorted }
   );
 }
@@ -6054,7 +6056,7 @@ async function resolveMediaDuration(src, mediaStart, playbackRate, baseDir, down
       if (tagName !== "video") {
         if (error instanceof NotMediaPayloadError2) {
           log?.warn(
-            `[compile] Audio "${elementIdentity}" (${src}) is a text document, not a media file \u2014 the element is dropped from the render. Point it at a rendered media file.`
+            `[compile] Audio "${elementIdentity}" (${src}) is a text document, not a media file, so the element is dropped from the render. Point it at a rendered media file.`
           );
         }
         return { duration: null, resolvedPath: filePath };
@@ -6143,7 +6145,7 @@ async function compileHtmlFile(html, baseDir, downloadDir, log) {
     if (r.maxDuration != null && shouldClampResolvedMediaDuration(r.tagName, r.duration, r.maxDuration)) {
       clampList.push({ id: r.id, duration: r.maxDuration });
       log?.warn(
-        `[compile] Audio "${r.id}" (${r.src}) is ${r.maxDuration.toFixed(2)}s but its data-duration is ${r.duration.toFixed(2)}s \u2014 the slot is shortened to the media length. Set data-duration to ~${r.maxDuration.toFixed(2)}s, trim data-media-start, or use a longer/looping source if that isn't intended.`
+        `[compile] Audio "${r.id}" (${r.src}) is ${r.maxDuration.toFixed(2)}s but its data-duration is ${r.duration.toFixed(2)}s, so the slot is shortened to the media length. Set data-duration to ~${r.maxDuration.toFixed(2)}s, trim data-media-start, or use a longer/looping source if that isn't intended.`
       );
     }
   }
@@ -6532,7 +6534,7 @@ ${safeText}
     } else {
       if (download.reason instanceof ScriptIntegrityError) throw download.reason;
       defaultLogger.warn(
-        `[Compiler] WARNING: Failed to download CDN script: ${src} \u2014 ${download.reason}. The render may fail if this script is required (e.g. GSAP). Consider bundling it locally in your project.`
+        `[Compiler] WARNING: Failed to download CDN script: ${src} (${download.reason}). The render may fail if this script is required (e.g. GSAP). Consider bundling it locally in your project.`
       );
     }
   }
@@ -6584,7 +6586,7 @@ function collectExternalAssets(html, projectDir) {
   }
   if (externalAssets.size > 0) {
     defaultLogger.info(
-      `[Compiler] Found ${externalAssets.size} asset(s) outside project directory \u2014 will copy to render output`
+      `[Compiler] Found ${externalAssets.size} asset(s) outside project directory, will copy to render output`
     );
   }
   return {
@@ -6609,7 +6611,7 @@ async function downloadAndRewriteUrls(urlSet, html, remoteDir, warnLabel, logLab
         urlToLocal.set(url, localPath);
       } catch (err) {
         const identity = safeDownloadUrlIdentity(url);
-        defaultLogger.warn(`[Compiler] ${warnLabel} \u2014 using original URL as fallback.`, {
+        defaultLogger.warn(`[Compiler] ${warnLabel}, using original URL as fallback.`, {
           urlFingerprint: identity.urlFingerprint,
           host: identity.host,
           error: err instanceof Error ? err.message : String(err)
@@ -6702,7 +6704,7 @@ async function fetchExternalStylesheetCss(href) {
       timeoutMs: 15e3
     });
   } catch (err) {
-    defaultLogger.warn("[Compiler] External stylesheet fetch failed \u2014 preserving link tag.", {
+    defaultLogger.warn("[Compiler] External stylesheet fetch failed, preserving link tag.", {
       urlFingerprint: identity.urlFingerprint,
       host: identity.host,
       error: err instanceof Error ? err.message : String(err)
@@ -7346,12 +7348,15 @@ async function resolveCompositionDurations(page, unresolved) {
     const resolved = [];
     for (const id of compIds) {
       const tl = timelines[id];
-      if (tl && typeof tl.duration === "function") {
-        const dur = tl.duration();
-        if (dur > 0) {
-          resolved.push({ id, duration: dur, source: "__timelines" });
-          continue;
-        }
+      let dur = 0;
+      try {
+        dur = typeof tl?.duration === "function" ? Number(tl.duration()) : 0;
+      } catch {
+        dur = 0;
+      }
+      if (dur > 0) {
+        resolved.push({ id, duration: dur, source: "__timelines" });
+        continue;
       }
       const el = document.getElementById(id);
       if (el) {
@@ -7447,28 +7452,28 @@ async function runCompileStage(input) {
     cfg.useDrawElement = false;
     deCompileGate = "3d";
     log.info(
-      "[Render] Fast capture: composition uses a CSS 3D rendering context (perspective / preserve-3d / backface-visibility) \u2014 disabling drawElementImage for this render. Capture uses the platform's baseline route."
+      "[Render] Fast capture: composition uses a CSS 3D rendering context (perspective / preserve-3d / backface-visibility), so disabling drawElementImage for this render. Capture uses the platform's baseline route."
     );
   }
   if (cfg.useDrawElement && process.env.HF_FAST_CAPTURE_BLEND !== "true" && compiled.usesMixBlendMode) {
     cfg.useDrawElement = false;
     deCompileGate = "mix_blend_mode";
     log.info(
-      "[Render] Fast capture: composition uses mix-blend-mode \u2014 disabling drawElementImage for this render. Capture uses the platform's baseline route."
+      "[Render] Fast capture: composition uses mix-blend-mode, so 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";
     log.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."
+      "[Render] Fast capture: composition root's ancestors (body/html/wrapper) carry a background-image, so 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";
     log.info(
-      "[Render] Fast capture: composition uses shader transitions \u2014 disabling drawElementImage so page-side compositing stays available."
+      "[Render] Fast capture: composition uses shader transitions, so disabling drawElementImage so page-side compositing stays available."
     );
   }
   if (!cfg.useDrawElement && cfg.pageSideCompositingAutoDisabled) {
@@ -7796,7 +7801,7 @@ async function runProbeStage(input) {
         } else {
           beginFrameStalled = true;
           log.warn(
-            "[Render] BeginFrame liveness probe timed out \u2014 this composition stalls BeginFrame on this host (SwiftShader heavy-layer pattern). Relaunching the probe browser in screenshot capture mode; the render will use screenshot capture throughout.",
+            "[Render] BeginFrame liveness probe timed out: this composition stalls BeginFrame on this host (SwiftShader heavy-layer pattern). Relaunching the probe browser in screenshot capture mode; the render will use screenshot capture throughout.",
             { probeTimeoutMs }
           );
           lastBrowserConsole = probeSession.browserConsoleBuffer;
@@ -8010,7 +8015,7 @@ async function runProbeStage(input) {
             video.start = win.visibleStart;
             video.end = win.visibleEnd;
             log.info(
-              `[Probe] Runtime video discovery: ${video.id} visible ${win.visibleStart.toFixed(2)}s\u2013${win.visibleEnd.toFixed(2)}s`
+              `[Probe] Runtime video discovery: ${video.id} visible ${win.visibleStart.toFixed(2)}s to ${win.visibleEnd.toFixed(2)}s`
             );
           }
         }
@@ -8058,7 +8063,7 @@ async function runProbeStage(input) {
         });
         if (!timelinesInfo.gsapLoaded) {
           diagnostics.push(
-            "GSAP is not loaded \u2014 CDN script may have failed to download. Bundle GSAP locally in your project instead of using a CDN <script src>."
+            "GSAP is not loaded. The CDN script may have failed to download. Bundle GSAP locally in your project instead of using a CDN <script src>."
           );
         } else if (timelinesInfo.timelineKeys.length === 0) {
           diagnostics.push(
@@ -8075,10 +8080,10 @@ async function runProbeStage(input) {
       log.warn("Failed to gather browser diagnostics for zero-duration composition", {
         error: err instanceof Error ? err.message : String(err)
       });
-      diagnostics.push("(Could not gather browser diagnostics \u2014 page may have crashed)");
+      diagnostics.push("(Could not gather browser diagnostics. The page may have crashed.)");
     }
     const hint = diagnostics.length > 0 ? "\n\nDiagnostics:\n  - " + diagnostics.join("\n  - ") : "\n\nCheck that GSAP timelines are registered on window.__timelines.";
-    throw new Error("Composition duration is 0 \u2014 this would produce a black video." + hint);
+    throw new Error("Composition duration is 0, so this would produce a black video." + hint);
   }
   if (probeSession) {
     const failedRequests = probeSession.browserConsoleBuffer.filter(isActionableProbeFailure);
@@ -8159,6 +8164,7 @@ import {
   detectTransfer,
   extractAllVideoFrames,
   extractMediaMetadata as extractMediaMetadata3,
+  isVideoPastTimelineEnd,
   isHdrColorSpace as isHdrColorSpace2,
   resolveProjectRelativeSrc as resolveProjectRelativeSrc3,
   runVideoExtractionWithRetry,
@@ -8373,6 +8379,9 @@ async function runExtractVideosStage(input) {
   } = input;
   const stage2Start = Date.now();
   const extractionPolicy = resolveVideoExtractionPolicy();
+  composition.videos = composition.videos.filter(
+    (video) => !isVideoPastTimelineEnd(video, composition.duration)
+  );
   let frameLookup = null;
   let extractionResult = null;
   let failureToEnforce = null;
@@ -8459,7 +8468,8 @@ async function runExtractVideosStage(input) {
         timelineEnd: composition.duration,
         maxTransientRetries: extractionPolicy.maxTransientRetries,
         collectProbeFailures: extractionPolicy.failureMode === "enforce",
-        deferRangeExtraction
+        deferRangeExtraction,
+        contentKeyedDirs: [join16(compiledDir, REMOTE_MEDIA_SUBDIR)]
       },
       abortSignal,
       cfg,
@@ -11085,7 +11095,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       const madeProgress = captureAttemptMadeProgress(frameCount, remainingCount);
       if (!madeProgress) {
         options.log.warn(
-          "[Render] Capture attempt made no forward progress; composition is likely structurally broken \u2014 not retrying.",
+          "[Render] Capture attempt made no forward progress; composition is likely structurally broken, not retrying.",
           { attempt, frameCount, remainingCount, workers: currentWorkers }
         );
       }
@@ -11154,7 +11164,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       }
       if (!madeProgress) {
         options.log.warn(
-          "[Render] Capture attempt made no forward progress; composition is likely structurally broken \u2014 not retrying.",
+          "[Render] Capture attempt made no forward progress; composition is likely structurally broken, not retrying.",
           { attempt, frameCount, remainingCount, workers: currentWorkers }
         );
       }
@@ -11617,7 +11627,7 @@ async function executeRenderJob(job, projectDir, outputPath, progressSink, abort
   execution.defer("remove workDir", () => {
     if (job.config.debug) return;
     if (job.status === "complete" && process.env.KEEP_TEMP === "1") {
-      log.info("KEEP_TEMP=1 \u2014 leaving workDir on disk for inspection", { workDir });
+      log.info("KEEP_TEMP=1, leaving workDir on disk for inspection", { workDir });
       return;
     }
     rmSync9(workDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
@@ -11854,7 +11864,7 @@ async function executeRenderPipeline(input) {
       captureForceScreenshot = true;
       updateCaptureObservability({ forceScreenshot: captureForceScreenshot });
       log.info(
-        "[Render] Low-memory render profile active \u2014 screenshot capture, auto-worker calibration skipped" + (job.config.workers === void 0 ? ", pinned to 1 worker" : "") + ". Override with --no-low-memory-mode or PRODUCER_LOW_MEMORY_MODE=false.",
+        "[Render] Low-memory render profile active: screenshot capture, auto-worker calibration skipped" + (job.config.workers === void 0 ? ", pinned to 1 worker" : "") + ". Override with --no-low-memory-mode or PRODUCER_LOW_MEMORY_MODE=false.",
         { totalMemMb: getSystemTotalMb(), thresholdMb: LOW_MEMORY_TOTAL_MB_THRESHOLD }
       );
     }
@@ -12422,7 +12432,7 @@ async function executeRenderPipeline(input) {
       cfg.useDrawElement = false;
       deClampReason = workerCount > 1 ? "parallel" : "disk_path";
       log.info(
-        "[Render] Fast capture: default-on drawElement disabled for this render \u2014 " + (workerCount > 1 ? "parallel capture" : "the disk capture path") + " has no runtime self-verification. Set PRODUCER_EXPERIMENTAL_FAST_CAPTURE=true to override."
+        "[Render] Fast capture: default-on drawElement disabled for this render: " + (workerCount > 1 ? "parallel capture" : "the disk capture path") + " has no runtime self-verification. Set PRODUCER_EXPERIMENTAL_FAST_CAPTURE=true to override."
       );
       if (probeSession && probeSession.captureMode === "drawelement") {
         lastBrowserConsole = probeSession.browserConsoleBuffer;
@@ -12518,7 +12528,7 @@ async function executeRenderPipeline(input) {
       });
       updateCaptureObservability({ forceScreenshot: captureForceScreenshot });
       log.info(
-        `[Render] Page-side compositing enabled \u2014 bypassing Node-side layered shader-blend path. Engine will capture one ${needsAlpha ? "RGBA PNG" : "opaque RGB"} screenshot per output frame.`
+        `[Render] Page-side compositing enabled, bypassing Node-side layered shader-blend path. Engine will capture one ${needsAlpha ? "RGBA PNG" : "opaque RGB"} screenshot per output frame.`
       );
     }
     const useLayeredComposite = !usePageSideCompositingForTransitions && shouldUseLayeredComposite({
@@ -13015,7 +13025,7 @@ async function executeRenderPipeline(input) {
             cfg.useDrawElement = false;
             deClampReason = deClampReason ?? "disk_path";
             log.info(
-              "[Render] Fast capture: drawElement disabled for the disk fallback \u2014 streaming encoder spawn failed and the disk path has no runtime self-verification."
+              "[Render] Fast capture: drawElement disabled for the disk fallback: streaming encoder spawn failed and the disk path has no runtime self-verification."
             );
             if (probeSession && probeSession.captureMode === "drawelement") {
               lastBrowserConsole = probeSession.browserConsoleBuffer;
@@ -13633,10 +13643,10 @@ function validateJsonSafeValue(value, field) {
   walkVariables(value, field, /* @__PURE__ */ new WeakSet());
 }
 var LEAF_REJECTIONS = {
-  undefined: "undefined leaves are silently dropped by JSON.stringify \u2014 use null if you mean an absent value",
+  undefined: "undefined leaves are silently dropped by JSON.stringify. Use null if you mean an absent value",
   function: "functions are not JSON-serializable",
   symbol: "Symbols are not JSON-serializable",
-  bigint: "BigInt values throw at JSON.stringify \u2014 encode as a string if you need 64-bit integers"
+  bigint: "BigInt values throw at JSON.stringify. Encode as a string if you need 64-bit integers"
 };
 function walkVariables(value, path, seen) {
   const t = typeof value;
@@ -13657,7 +13667,7 @@ function walkVariables(value, path, seen) {
   if (seen.has(value)) {
     throw new InvalidConfigError(
       path,
-      "circular reference detected \u2014 JSON.stringify cannot serialize cycles"
+      "circular reference detected: JSON.stringify cannot serialize cycles"
     );
   }
   seen.add(value);
@@ -13997,7 +14007,7 @@ function validateOutputResolutionOverride(body) {
     return `Invalid outputResolution "${body.outputResolution}". Must be one of: landscape, portrait, landscape-4k, portrait-4k, square, square-4k (aliases: 1080p, 4k, \u2026).`;
   }
   if (normalized !== void 0 && (body.format === "webm" || body.format === "mov")) {
-    return `outputResolution is not supported with format "${body.format}" \u2014 the alpha (webm/mov) capture path can't supersample. Use format "mp4", or omit outputResolution to render at the composition's native dimensions.`;
+    return `outputResolution is not supported with format "${body.format}": the alpha (webm/mov) capture path can't supersample. Use format "mp4", or omit outputResolution to render at the composition's native dimensions.`;
   }
   return void 0;
 }

package/dist/services/htmlCompiler.d.ts

@@ -67,6 +67,7 @@ export declare function collectExternalAssets(html: string, projectDir: string):
     html: string;
     externalAssets: Map<string, string>;
 };
+export declare const REMOTE_MEDIA_SUBDIR = "_remote_media";
 /**
  * Download any remote `src` URLs on `<video>` / `<audio>` elements and their
  * `<source>` children into a local subdirectory of `downloadDir`, rewrite the

package/dist/services/render/stages/captureStreamingStage.d.ts

@@ -44,8 +44,9 @@ import type { ProducerLogger } from "../../../logger.js";
 import type { ProgressCallback, RenderJob } from "../../renderOrchestrator.js";
 import type { SdrStreamingCapturePlan } from "../capturePlan.js";
 export declare function resolveCaptureStallTimeoutMs(): number;
+type StalledSession = Pick<CaptureSession, "captureMode" | "captureStep">;
 export declare function raceAgainstStall<T>(promise: Promise<T>, deadlineMs: number, input: {
-    captureMode: CaptureSession["captureMode"];
+    session: StalledSession;
     frameIndex: number;
     totalFrames: number;
     stallTimeoutMs: number;
@@ -123,3 +124,4 @@ export type CaptureStreamingStageResult = {
     success: false;
 };
 export declare function runCaptureStreamingStage(input: CaptureStreamingStageInput): Promise<CaptureStreamingStageResult>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.145",
+  "version": "0.8.147",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "^25.2.1",
     "puppeteer-core": "^25.2.1",
-    "@hyperframes/core": "0.8.145",
-    "@hyperframes/engine": "0.8.145",
-    "@hyperframes/lint": "0.8.145",
-    "@hyperframes/parsers": "0.8.145",
-    "@hyperframes/studio-server": "0.8.145"
+    "@hyperframes/engine": "0.8.147",
+    "@hyperframes/core": "0.8.147",
+    "@hyperframes/lint": "0.8.147",
+    "@hyperframes/parsers": "0.8.147",
+    "@hyperframes/studio-server": "0.8.147"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
@@ -48,7 +48,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.11",
-    "@hyperframes/aws-lambda": "0.8.145"
+    "@hyperframes/aws-lambda": "0.8.147"
   },
   "engines": {
     "node": ">=22"