@hyperframes/producer 0.8.146 → 0.8.148

package/dist/index.js

@@ -1893,7 +1893,8 @@ import {
   groupIntoLayers,
   blitRgb48leAffine,
   parseTransformMatrix,
-  convertTransfer
+  convertTransfer,
+  isVideoHiddenBeforeStreamStart
 } from "@hyperframes/engine";
 
 // src/services/render/hdrPerf.ts
@@ -2066,6 +2067,8 @@ function blitHdrVideoLayer(canvas, el, time, fps, hdrVideoFrameSources, hdrStart
     frameSource.loop
   );
   if (effectiveIndex === null) return;
+  const mediaTime = (frameSource.mediaStart ?? 0) + effectiveIndex / fps;
+  if (isVideoHiddenBeforeStreamStart(frameSource.videoStreamLeadSeconds, mediaTime)) return;
   const frameOffset = effectiveIndex * frameSource.frameSize;
   try {
     if (hdrPerf) hdrPerf.hdrVideoLayerBlits += 1;
@@ -2687,7 +2690,10 @@ async function extractHdrVideoFrames(args) {
       initialWindow,
       abortSignal
     );
-    extractionWindows.set(videoId, window2);
+    extractionWindows.set(videoId, {
+      window: window2,
+      videoStreamLeadSeconds: metadata.videoStreamLeadSeconds
+    });
     prep.hdrVideoStartTimes.set(videoId, window2.compositionStart);
     plannedVideos.push({
       durationSeconds: window2.durationSeconds,
@@ -2706,14 +2712,16 @@ async function extractHdrVideoFrames(args) {
   try {
     for (const [videoId, srcPath] of prep.hdrVideoSrcPaths) {
       const video = composition.videos.find((v) => v.id === videoId);
-      const window2 = extractionWindows.get(videoId);
-      if (!video || !window2) continue;
+      const planned = extractionWindows.get(videoId);
+      if (!video || !planned) continue;
+      const { window: window2 } = planned;
       mkdirSync2(framesDir, { recursive: true });
       const frameDir = mkdtempSync2(join7(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
       createdFrameDirs.add(frameDir);
       const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
       const rawPath = join7(frameDir, "frames.rgb48le");
-      const extractionStart = String(window2.extractionMediaStart ?? window2.mediaStart);
+      const extractionMediaStart = window2.extractionMediaStart ?? window2.mediaStart;
+      const extractionStart = String(extractionMediaStart);
       const ffmpegArgs = [];
       if (window2.finalFrameOnly) {
         ffmpegArgs.push("-i", srcPath, "-ss", extractionStart, "-frames:v", "1");
@@ -2773,7 +2781,9 @@ async function extractHdrVideoFrames(args) {
           frameSize,
           frameCount,
           scratch: Buffer.allocUnsafe(frameSize),
-          loop: video.loop
+          loop: video.loop,
+          mediaStart: extractionMediaStart,
+          videoStreamLeadSeconds: planned.videoStreamLeadSeconds
         });
         handedOff = true;
       } finally {
@@ -3360,12 +3370,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;
@@ -3383,12 +3394,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) {
@@ -3397,9 +3409,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
@@ -3527,7 +3539,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 () => {
@@ -3881,7 +3893,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);
@@ -3970,7 +3982,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
@@ -15270,6 +15282,7 @@ function readVideoMetadata(value, field) {
     // overwhelmingly common start-at-zero domain. Preserve that compatibility
     // while carrying non-zero edit-list/transport timestamps in new plans.
     videoStreamStartSeconds: record.videoStreamStartSeconds === void 0 ? 0 : readFiniteNumber(record.videoStreamStartSeconds, `${field}.videoStreamStartSeconds`),
+    videoStreamLeadSeconds: record.videoStreamLeadSeconds === void 0 ? 0 : readFiniteNumber(record.videoStreamLeadSeconds, `${field}.videoStreamLeadSeconds`),
     width: readPositiveInteger(record.width, `${field}.width`),
     height: readPositiveInteger(record.height, `${field}.height`),
     fps: readFiniteNumber(record.fps, `${field}.fps`),

package/dist/public-server.js

@@ -1912,7 +1912,8 @@ import {
   groupIntoLayers,
   blitRgb48leAffine,
   parseTransformMatrix,
-  convertTransfer
+  convertTransfer,
+  isVideoHiddenBeforeStreamStart
 } from "@hyperframes/engine";
 
 // src/services/render/hdrPerf.ts
@@ -2085,6 +2086,8 @@ function blitHdrVideoLayer(canvas, el, time, fps, hdrVideoFrameSources, hdrStart
     frameSource.loop
   );
   if (effectiveIndex === null) return;
+  const mediaTime = (frameSource.mediaStart ?? 0) + effectiveIndex / fps;
+  if (isVideoHiddenBeforeStreamStart(frameSource.videoStreamLeadSeconds, mediaTime)) return;
   const frameOffset = effectiveIndex * frameSource.frameSize;
   try {
     if (hdrPerf) hdrPerf.hdrVideoLayerBlits += 1;
@@ -2706,7 +2709,10 @@ async function extractHdrVideoFrames(args) {
       initialWindow,
       abortSignal
     );
-    extractionWindows.set(videoId, window2);
+    extractionWindows.set(videoId, {
+      window: window2,
+      videoStreamLeadSeconds: metadata.videoStreamLeadSeconds
+    });
     prep.hdrVideoStartTimes.set(videoId, window2.compositionStart);
     plannedVideos.push({
       durationSeconds: window2.durationSeconds,
@@ -2725,14 +2731,16 @@ async function extractHdrVideoFrames(args) {
   try {
     for (const [videoId, srcPath] of prep.hdrVideoSrcPaths) {
       const video = composition.videos.find((v) => v.id === videoId);
-      const window2 = extractionWindows.get(videoId);
-      if (!video || !window2) continue;
+      const planned = extractionWindows.get(videoId);
+      if (!video || !planned) continue;
+      const { window: window2 } = planned;
       mkdirSync2(framesDir, { recursive: true });
       const frameDir = mkdtempSync2(join7(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
       createdFrameDirs.add(frameDir);
       const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
       const rawPath = join7(frameDir, "frames.rgb48le");
-      const extractionStart = String(window2.extractionMediaStart ?? window2.mediaStart);
+      const extractionMediaStart = window2.extractionMediaStart ?? window2.mediaStart;
+      const extractionStart = String(extractionMediaStart);
       const ffmpegArgs = [];
       if (window2.finalFrameOnly) {
         ffmpegArgs.push("-i", srcPath, "-ss", extractionStart, "-frames:v", "1");
@@ -2792,7 +2800,9 @@ async function extractHdrVideoFrames(args) {
           frameSize,
           frameCount,
           scratch: Buffer.allocUnsafe(frameSize),
-          loop: video.loop
+          loop: video.loop,
+          mediaStart: extractionMediaStart,
+          videoStreamLeadSeconds: planned.videoStreamLeadSeconds
         });
         handedOff = true;
       } finally {
@@ -3379,12 +3389,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 +3413,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 +3428,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 +3558,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 +3912,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 +4001,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

package/dist/services/hdrCompositor.d.ts

@@ -43,6 +43,8 @@ export interface HdrVideoFrameSource {
     scratch: Buffer;
     /** The raw file contains one playable source cycle and must wrap at EOF. */
     loop?: boolean;
+    mediaStart?: number;
+    videoStreamLeadSeconds?: number;
 }
 export declare function closeHdrVideoFrameSource(source: HdrVideoFrameSource, log?: ProducerLogger): void;
 export declare function resolveHdrVideoFrameIndex(time: number, startTime: number, fps: number, frameCount: number, loop?: boolean): number | null;

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.146",
+  "version": "0.8.148",
   "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/lint": "0.8.146",
-    "@hyperframes/studio-server": "0.8.146",
-    "@hyperframes/core": "0.8.146",
-    "@hyperframes/parsers": "0.8.146",
-    "@hyperframes/engine": "0.8.146"
+    "@hyperframes/core": "0.8.148",
+    "@hyperframes/lint": "0.8.148",
+    "@hyperframes/studio-server": "0.8.148",
+    "@hyperframes/parsers": "0.8.148",
+    "@hyperframes/engine": "0.8.148"
   },
   "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.146"
+    "@hyperframes/aws-lambda": "0.8.148"
   },
   "engines": {
     "node": ">=22"