@hyperframes/engine 0.8.173 → 0.8.174

package/dist/services/chunkEncoder.js

@@ -9,7 +9,7 @@ import { closeSync, copyFileSync, existsSync, ftruncateSync, mkdirSync, mkdtempS
 import { join, dirname, extname } from "path";
 import { DEFAULT_CONFIG } from "../config.js";
 import { getCachedGpuEncoder, getGpuEncoderName, buildVideoToolboxRateControlArgs, mapPresetForGpuEncoder, } from "../utils/gpuEncoder.js";
-import { getHdrEncoderColorParams } from "../utils/hdr.js";
+import { getHdrEncoderColorParams, hdrFrameTagsFilter } from "../utils/hdr.js";
 import { withEvenDimensionPad } from "../utils/evenDimensions.js";
 import { SDR_CAPTURE_TO_BT709_FILTER, SDR_RGB_TO_TAGGED_BT709_FILTER, } from "../utils/sdrCaptureColor.js";
 import { describeFfmpegFailure, ffmpegStatsReader, formatFfmpegError, isExternalFfmpegInterruption, runFfmpeg, } from "../utils/runFfmpeg.js";
@@ -325,8 +325,9 @@ export function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = nu
         }
         // Range conversion: Chrome's full-range capture → limited/TV range; SDR also
         // converts to the BT.709 matrix it is tagged with.
+        const hdrTags = options.hdr ? hdrFrameTagsFilter(options.hdr.transfer) : undefined;
         const sdrFilter = options.hdr ? undefined : SDR_CAPTURE_TO_BT709_FILTER;
-        const captureFilter = sdrFilter ?? "scale=in_range=pc:out_range=tv";
+        const captureFilter = sdrFilter ?? `scale=in_range=pc:out_range=tv,${hdrTags}`;
         if (gpuEncoder === "vaapi") {
             // vaapi already runs `format=nv12,hwupload`; the nv12 conversion aligns
             // odd dimensions before upload, so only prepend the colour conversion.
@@ -340,7 +341,7 @@ export function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = nu
             // encoder. They hit the same "height not divisible by 2" abort as
             // libx264 on an odd-sized 4:2:0 canvas, so pad odd dimensions up to even
             // on the software side before the encode.
-            const vf = withEvenDimensionPad(sdrFilter ?? "", pixelFormat, options.width, options.height);
+            const vf = withEvenDimensionPad(sdrFilter ?? hdrTags ?? "", pixelFormat, options.width, options.height);
             if (vf)
                 args.push("-vf", vf);
         }

package/dist/services/frameCapture.d.ts

@@ -130,6 +130,7 @@ export interface CaptureSession {
     beginFrameIntervalMs: number;
     beginFrameHasDamageCount: number;
     beginFrameNoDamageCount: number;
+    beginFrameSeekPresented?: boolean;
     /** Optional producer config — when set, overrides module-level env var constants. */
     config?: Partial<EngineConfig>;
     /** True if running on SwiftShader (detected at init). Undefined before init. */

package/dist/services/frameCapture.js

@@ -2971,6 +2971,17 @@ async function captureFrameSurface(session, frameIndex, time, seekOptions, heldV
     let screenshotBuffer;
     if (session.captureMode === "beginframe") {
         const frameTimeTicks = session.beginFrameTimeTicks + frameIndex * session.beginFrameIntervalMs;
+        if (!session.beginFrameSeekPresented) {
+            // A session's first capture can return the frame composited during init instead of
+            // this seek, so display the seek once at a tick between the probe and this capture.
+            const client = await getCdpSession(page);
+            await client.send("HeadlessExperimental.beginFrame", {
+                frameTimeTicks: frameTimeTicks - session.beginFrameIntervalMs / 2,
+                interval: session.beginFrameIntervalMs,
+                noDisplayUpdates: false,
+            });
+            session.beginFrameSeekPresented = true;
+        }
         const result = await beginFrameCapture(page, options, frameTimeTicks, session.beginFrameIntervalMs);
         if (result.hasDamage)
             session.beginFrameHasDamageCount++;

package/dist/services/streamingEncoder.js

@@ -22,9 +22,9 @@ import { dirname } from "path";
 import { getCachedGpuEncoder, getGpuEncoderName, buildVideoToolboxRateControlArgs, mapPresetForGpuEncoder, } from "../utils/gpuEncoder.js";
 import { ffmpegStatsReader, formatFfmpegError, isExternalFfmpegInterruption, } from "../utils/runFfmpeg.js";
 import { getFfmpegBinary } from "../utils/ffmpegBinaries.js";
-import { getHdrEncoderColorParams } from "../utils/hdr.js";
+import { getHdrEncoderColorParams, hdrFrameTagsFilter } from "../utils/hdr.js";
 import { withEvenDimensionPad } from "../utils/evenDimensions.js";
-import { SDR_CAPTURE_TO_BT709_FILTER, SDR_RGB_TO_BT709_FILTER, SDR_RGB_TO_TAGGED_BT709_FILTER, } from "../utils/sdrCaptureColor.js";
+import { SDR_CAPTURE_TO_BT709_FILTER, SDR_RGB_TO_TAGGED_BT709_FILTER, } from "../utils/sdrCaptureColor.js";
 import { DEFAULT_CONFIG } from "../config.js";
 import { fpsToFfmpegArg, fpsToNumber } from "@hyperframes/core";
 import { appendVp9CpuUsedArg } from "./vp9Options.js";
@@ -248,26 +248,25 @@ export function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
         else {
             args.push("-colorspace:v", "bt709", "-color_primaries:v", "bt709", "-color_trc:v", "bt709", "-color_range", "tv");
         }
-        // Raw HDR input (from WebGPU pipeline) is already PQ-encoded, so only SDR gets a
-        // conversion: raw sRGB or Chrome's BT.601 JPEG screenshots to BT.709 limited range.
-        const sdrFilter = options.rawInputFormat
-            ? SDR_RGB_TO_BT709_FILTER
-            : SDR_CAPTURE_TO_BT709_FILTER;
-        if (options.rawInputFormat && options.hdr) {
-            // No filter needed — PQ data goes straight to encoder
-        }
-        else if (gpuEncoder === "vaapi") {
+        // Raw HDR input (from WebGPU pipeline) is already PQ-encoded and is only tagged; SDR is
+        // converted: raw sRGB or Chrome's BT.601 JPEG screenshots to tagged BT.709 limited range.
+        const frameFilter = options.rawInputFormat && options.hdr
+            ? hdrFrameTagsFilter(options.hdr.transfer)
+            : options.rawInputFormat
+                ? SDR_RGB_TO_TAGGED_BT709_FILTER
+                : SDR_CAPTURE_TO_BT709_FILTER;
+        if (gpuEncoder === "vaapi") {
             // vaapi already runs `format=nv12,hwupload`; the nv12 conversion aligns
             // odd dimensions before upload, so only prepend the colour conversion.
             const vfIdx = args.indexOf("-vf");
             if (vfIdx !== -1) {
-                args[vfIdx + 1] = `${sdrFilter},${args[vfIdx + 1]}`;
+                args[vfIdx + 1] = `${frameFilter},${args[vfIdx + 1]}`;
             }
         }
         else {
             // Pad odd dimensions up to even so 4:2:0 encoders (software and
             // nvenc/videotoolbox/qsv/amf) don't abort with "height not divisible by 2".
-            args.push("-vf", withEvenDimensionPad(sdrFilter, pixelFormat, options.width, options.height));
+            args.push("-vf", withEvenDimensionPad(frameFilter, pixelFormat, options.width, options.height));
         }
         // Fixed timescale for consistent A/V timing across platforms.
         args.push("-video_track_timescale", "90000");

package/dist/utils/hdr.d.ts

@@ -70,6 +70,7 @@ export interface HdrEncoderColorParams {
  * stream is rejected as SDR by most HDR-aware players and CDNs.
  */
 export declare function getHdrEncoderColorParams(transfer: HdrTransfer, mastering?: HdrMasteringMetadata): HdrEncoderColorParams;
+export declare function hdrFrameTagsFilter(transfer: HdrTransfer): string;
 export interface CompositionHdrInfo {
     hasHdr: boolean;
     dominantTransfer: HdrTransfer | null;

package/dist/utils/hdr.js

@@ -64,6 +64,10 @@ export function getHdrEncoderColorParams(transfer, mastering = DEFAULT_HDR10_MAS
         mastering,
     };
 }
+export function hdrFrameTagsFilter(transfer) {
+    const { colorPrimaries, colorTrc, colorspace } = getHdrEncoderColorParams(transfer);
+    return `setparams=color_primaries=${colorPrimaries}:color_trc=${colorTrc}:colorspace=${colorspace}:range=tv`;
+}
 export const HDR_AUTO_PROMOTION_PIPELINE = {
     colorSpace: "BT.2020",
     codec: "HEVC Main10",

package/dist/utils/sdrCaptureColor.d.ts

@@ -1,3 +1,3 @@
 export declare const SDR_RGB_TO_BT709_FILTER = "scale=out_color_matrix=bt709:out_range=tv:flags=neighbor";
-export declare const SDR_CAPTURE_TO_BT709_FILTER = "scale=in_color_matrix=bt601:in_range=pc:flags=neighbor+accurate_rnd,format=gbrp,scale=out_color_matrix=bt709:out_range=tv:flags=neighbor";
 export declare const SDR_RGB_TO_TAGGED_BT709_FILTER = "scale=out_color_matrix=bt709:out_range=tv:flags=neighbor,setparams=color_primaries=bt709:color_trc=bt709:colorspace=bt709:range=tv";
+export declare const SDR_CAPTURE_TO_BT709_FILTER = "scale=in_color_matrix=bt601:in_range=pc:flags=neighbor+accurate_rnd,format=gbrp,scale=out_color_matrix=bt709:out_range=tv:flags=neighbor,setparams=color_primaries=bt709:color_trc=bt709:colorspace=bt709:range=tv";

package/dist/utils/sdrCaptureColor.js

@@ -1,3 +1,3 @@
 export const SDR_RGB_TO_BT709_FILTER = "scale=out_color_matrix=bt709:out_range=tv:flags=neighbor";
-export const SDR_CAPTURE_TO_BT709_FILTER = `scale=in_color_matrix=bt601:in_range=pc:flags=neighbor+accurate_rnd,format=gbrp,${SDR_RGB_TO_BT709_FILTER}`;
 export const SDR_RGB_TO_TAGGED_BT709_FILTER = `${SDR_RGB_TO_BT709_FILTER},setparams=color_primaries=bt709:color_trc=bt709:colorspace=bt709:range=tv`;
+export const SDR_CAPTURE_TO_BT709_FILTER = `scale=in_color_matrix=bt601:in_range=pc:flags=neighbor+accurate_rnd,format=gbrp,${SDR_RGB_TO_TAGGED_BT709_FILTER}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.173",
+  "version": "0.8.174",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -50,8 +50,8 @@
     "linkedom": "^0.18.12",
     "puppeteer": "^25.8.0",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/parsers": "^0.8.173",
-    "@hyperframes/core": "^0.8.173"
+    "@hyperframes/core": "^0.8.174",
+    "@hyperframes/parsers": "^0.8.174"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",