@hyperframes/producer 0.8.212 → 0.8.213

package/dist/index.js

@@ -2439,7 +2439,7 @@ async function blitHdrVideoLayer(canvas, el, time, fps, hdrVideoFrameSources, hd
   );
   if (effectiveIndex === null) return;
   const mediaTime = (frameSource.mediaStart ?? 0) + effectiveIndex / fps;
-  if (isVideoHiddenBeforeStreamStart(frameSource.videoStreamLeadSeconds, mediaTime)) return;
+  if (isVideoHiddenBeforeStreamStart(frameSource.videoStartSeconds, mediaTime)) return;
   if (hdrPerf) hdrPerf.hdrVideoLayerBlits += 1;
   const lease = await frameSource.windows.lease(effectiveIndex);
   if (!lease) return;
@@ -2839,6 +2839,7 @@ import { join as join8 } from "node:path";
 import {
   decodePngToRgb48le,
   extractMediaMetadata as extractMediaMetadata2,
+  ffmpegSeekSeconds,
   getCgroupMemoryLimitMb,
   normalizeObjectFit,
   queryElementStacking,
@@ -2846,7 +2847,8 @@ import {
   resolveFinalFrameExtractionWindow,
   resolveProjectRelativeSrc,
   resolveVideoExtractionWindow,
-  runFfmpeg
+  runFfmpeg,
+  videoStartOnMediaTimeline
 } from "@hyperframes/engine";
 import { fpsToFfmpegArg, fpsToNumber as fpsToNumber3 } from "@hyperframes/core";
 
@@ -3170,10 +3172,7 @@ async function extractHdrVideoFrames(args) {
       initialWindow,
       abortSignal
     );
-    extractionWindows.set(videoId, {
-      window: window2,
-      videoStreamLeadSeconds: metadata.videoStreamLeadSeconds
-    });
+    extractionWindows.set(videoId, { window: window2, metadata });
     prep.hdrVideoStartTimes.set(videoId, window2.compositionStart);
     const frameSize = dims.width * dims.height * 6;
     const frames = window2.finalFrameOnly ? 1 : Math.ceil(window2.durationSeconds * fps);
@@ -3191,15 +3190,16 @@ async function extractHdrVideoFrames(args) {
       const video = composition.videos.find((v) => v.id === videoId);
       const planned = extractionWindows.get(videoId);
       if (!video || !planned) continue;
-      const { window: window2 } = planned;
+      const { window: window2, metadata } = planned;
       mkdirSync2(framesDir, { recursive: true });
       const frameDir = mkdtempSync2(join8(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
       createdFrameDirs.add(frameDir);
       const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
       const frameSize = dims.width * dims.height * 6;
       const extractionMediaStart = window2.extractionMediaStart ?? window2.mediaStart;
+      const ffmpegSeek = ffmpegSeekSeconds(metadata, extractionMediaStart);
       const scale = `scale=${dims.width}:${dims.height}:force_original_aspect_ratio=increase,crop=${dims.width}:${dims.height}`;
-      const firstTick = window2.finalFrameOnly ? 0 : await probeFirstTick(srcPath, extractionMediaStart, fps, runFfmpegImpl, abortSignal);
+      const firstTick = window2.finalFrameOnly ? 0 : await probeFirstTick(srcPath, ffmpegSeek, fps, runFfmpegImpl, abortSignal);
       const totalFrames = window2.finalFrameOnly ? 1 : Math.max(1, Math.ceil(window2.durationSeconds * fps - firstTick - 1e-9)) + Number(video.loop);
       const windowFrames = Math.min(totalFrames, hdrWindowFrames(frameSize, windowBytes));
       const windows = createHdrFrameWindows({
@@ -3212,10 +3212,19 @@ async function extractHdrVideoFrames(args) {
           const ffmpegArgs = window2.finalFrameOnly ? (
             // Decode before seeking for the one-frame path. Input-side seeking can
             // return zero frames for valid unindexed/negative-base transports.
-            ["-i", srcPath, "-ss", String(extractionMediaStart), "-frames:v", "1", "-vf", scale]
+            [
+              "-i",
+              srcPath,
+              "-ss",
+              String(Math.max(0, ffmpegSeek)),
+              "-frames:v",
+              "1",
+              "-vf",
+              scale
+            ]
           ) : hdrWindowFfmpegArgs({
             srcPath,
-            mediaStart: extractionMediaStart,
+            ffmpegSeek,
             fps,
             fpsArg: fpsToFfmpegArg(job.config.fps),
             firstTick,
@@ -3265,7 +3274,7 @@ async function extractHdrVideoFrames(args) {
         scratch: Buffer.allocUnsafe(frameSize),
         loop: video.loop,
         mediaStart: extractionMediaStart,
-        videoStreamLeadSeconds: planned.videoStreamLeadSeconds
+        videoStartSeconds: videoStartOnMediaTimeline(metadata)
       });
     }
     return { sources: out, estimatedBytes, releaseReservation };
@@ -3288,7 +3297,7 @@ function hdrWindowFfmpegArgs(a) {
   const filters = [`fps=${a.fpsArg}:start_time=${(a.firstTick / a.fps).toFixed(6)}`, a.scale];
   if (trim > 0) filters.push(`trim=start_frame=${trim}`);
   return [
-    ...["-ss", (a.mediaStart + seekFrame / a.fps).toFixed(6), "-i", a.srcPath],
+    ...["-ss", (a.ffmpegSeek + seekFrame / a.fps).toFixed(6), "-i", a.srcPath],
     ...["-vf", filters.join(","), "-frames:v", String(a.frames), "-fps_mode", "passthrough"]
   ];
 }
@@ -9165,6 +9174,7 @@ function validateNoGpuEncode(config) {
 function validateNoSystemFonts(compiledHtml) {
   const customProperties = collectFontFamilyCustomProperties(compiledHtml);
   for (const { surface, declaration } of iterateFontFamilyDeclarations(compiledHtml)) {
+    if (surface === "font") continue;
     const families = resolveFontFamilyDeclarationFamilies(declaration, customProperties);
     if (families.length === 0) continue;
     const primaryRaw = families[0];
@@ -15148,6 +15158,7 @@ function readVideoMetadata(value, field) {
     // 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`),
+    mediaTimeOffsetSeconds: record.mediaTimeOffsetSeconds === void 0 ? 0 : readFiniteNumber(record.mediaTimeOffsetSeconds, `${field}.mediaTimeOffsetSeconds`),
     width: readPositiveInteger(record.width, `${field}.width`),
     height: readPositiveInteger(record.height, `${field}.height`),
     fps: readFiniteNumber(record.fps, `${field}.fps`),

package/dist/public-server.js

@@ -2456,7 +2456,7 @@ async function blitHdrVideoLayer(canvas, el, time, fps, hdrVideoFrameSources, hd
   );
   if (effectiveIndex === null) return;
   const mediaTime = (frameSource.mediaStart ?? 0) + effectiveIndex / fps;
-  if (isVideoHiddenBeforeStreamStart(frameSource.videoStreamLeadSeconds, mediaTime)) return;
+  if (isVideoHiddenBeforeStreamStart(frameSource.videoStartSeconds, mediaTime)) return;
   if (hdrPerf) hdrPerf.hdrVideoLayerBlits += 1;
   const lease = await frameSource.windows.lease(effectiveIndex);
   if (!lease) return;
@@ -2856,6 +2856,7 @@ import { join as join8 } from "node:path";
 import {
   decodePngToRgb48le,
   extractMediaMetadata as extractMediaMetadata2,
+  ffmpegSeekSeconds,
   getCgroupMemoryLimitMb,
   normalizeObjectFit,
   queryElementStacking,
@@ -2863,7 +2864,8 @@ import {
   resolveFinalFrameExtractionWindow,
   resolveProjectRelativeSrc,
   resolveVideoExtractionWindow,
-  runFfmpeg
+  runFfmpeg,
+  videoStartOnMediaTimeline
 } from "@hyperframes/engine";
 import { fpsToFfmpegArg, fpsToNumber as fpsToNumber3 } from "@hyperframes/core";
 
@@ -3187,10 +3189,7 @@ async function extractHdrVideoFrames(args) {
       initialWindow,
       abortSignal
     );
-    extractionWindows.set(videoId, {
-      window: window2,
-      videoStreamLeadSeconds: metadata.videoStreamLeadSeconds
-    });
+    extractionWindows.set(videoId, { window: window2, metadata });
     prep.hdrVideoStartTimes.set(videoId, window2.compositionStart);
     const frameSize = dims.width * dims.height * 6;
     const frames = window2.finalFrameOnly ? 1 : Math.ceil(window2.durationSeconds * fps);
@@ -3208,15 +3207,16 @@ async function extractHdrVideoFrames(args) {
       const video = composition.videos.find((v) => v.id === videoId);
       const planned = extractionWindows.get(videoId);
       if (!video || !planned) continue;
-      const { window: window2 } = planned;
+      const { window: window2, metadata } = planned;
       mkdirSync2(framesDir, { recursive: true });
       const frameDir = mkdtempSync2(join8(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
       createdFrameDirs.add(frameDir);
       const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
       const frameSize = dims.width * dims.height * 6;
       const extractionMediaStart = window2.extractionMediaStart ?? window2.mediaStart;
+      const ffmpegSeek = ffmpegSeekSeconds(metadata, extractionMediaStart);
       const scale = `scale=${dims.width}:${dims.height}:force_original_aspect_ratio=increase,crop=${dims.width}:${dims.height}`;
-      const firstTick = window2.finalFrameOnly ? 0 : await probeFirstTick(srcPath, extractionMediaStart, fps, runFfmpegImpl, abortSignal);
+      const firstTick = window2.finalFrameOnly ? 0 : await probeFirstTick(srcPath, ffmpegSeek, fps, runFfmpegImpl, abortSignal);
       const totalFrames = window2.finalFrameOnly ? 1 : Math.max(1, Math.ceil(window2.durationSeconds * fps - firstTick - 1e-9)) + Number(video.loop);
       const windowFrames = Math.min(totalFrames, hdrWindowFrames(frameSize, windowBytes));
       const windows = createHdrFrameWindows({
@@ -3229,10 +3229,19 @@ async function extractHdrVideoFrames(args) {
           const ffmpegArgs = window2.finalFrameOnly ? (
             // Decode before seeking for the one-frame path. Input-side seeking can
             // return zero frames for valid unindexed/negative-base transports.
-            ["-i", srcPath, "-ss", String(extractionMediaStart), "-frames:v", "1", "-vf", scale]
+            [
+              "-i",
+              srcPath,
+              "-ss",
+              String(Math.max(0, ffmpegSeek)),
+              "-frames:v",
+              "1",
+              "-vf",
+              scale
+            ]
           ) : hdrWindowFfmpegArgs({
             srcPath,
-            mediaStart: extractionMediaStart,
+            ffmpegSeek,
             fps,
             fpsArg: fpsToFfmpegArg(job.config.fps),
             firstTick,
@@ -3282,7 +3291,7 @@ async function extractHdrVideoFrames(args) {
         scratch: Buffer.allocUnsafe(frameSize),
         loop: video.loop,
         mediaStart: extractionMediaStart,
-        videoStreamLeadSeconds: planned.videoStreamLeadSeconds
+        videoStartSeconds: videoStartOnMediaTimeline(metadata)
       });
     }
     return { sources: out, estimatedBytes, releaseReservation };
@@ -3305,7 +3314,7 @@ function hdrWindowFfmpegArgs(a) {
   const filters = [`fps=${a.fpsArg}:start_time=${(a.firstTick / a.fps).toFixed(6)}`, a.scale];
   if (trim > 0) filters.push(`trim=start_frame=${trim}`);
   return [
-    ...["-ss", (a.mediaStart + seekFrame / a.fps).toFixed(6), "-i", a.srcPath],
+    ...["-ss", (a.ffmpegSeek + seekFrame / a.fps).toFixed(6), "-i", a.srcPath],
     ...["-vf", filters.join(","), "-frames:v", String(a.frames), "-fps_mode", "passthrough"]
   ];
 }

package/dist/services/hdrCompositor.d.ts

@@ -44,7 +44,7 @@ export interface HdrVideoFrameSource {
     /** The playable range is one source cycle and must wrap at its end. */
     loop?: boolean;
     mediaStart?: number;
-    videoStreamLeadSeconds?: number;
+    videoStartSeconds?: 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.212",
+  "version": "0.8.213",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
-    "@hyperframes/engine": "0.8.212",
-    "@hyperframes/lint": "0.8.212",
-    "@hyperframes/parsers": "0.8.212",
-    "@hyperframes/studio-server": "0.8.212",
-    "@hyperframes/core": "0.8.212"
+    "@hyperframes/engine": "0.8.213",
+    "@hyperframes/lint": "0.8.213",
+    "@hyperframes/core": "0.8.213",
+    "@hyperframes/parsers": "0.8.213",
+    "@hyperframes/studio-server": "0.8.213"
   },
   "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.212"
+    "@hyperframes/aws-lambda": "0.8.213"
   },
   "engines": {
     "node": ">=22"