@hyperframes/producer 0.8.147 → 0.8.149

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 {
@@ -15272,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 {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.147",
+  "version": "0.8.149",
   "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/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"
+    "@hyperframes/engine": "0.8.149",
+    "@hyperframes/core": "0.8.149",
+    "@hyperframes/lint": "0.8.149",
+    "@hyperframes/studio-server": "0.8.149",
+    "@hyperframes/parsers": "0.8.149"
   },
   "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.147"
+    "@hyperframes/aws-lambda": "0.8.149"
   },
   "engines": {
     "node": ">=22"