@hyperframes/engine 0.9.20 → 0.9.22

package/dist/services/browserManager.js

@@ -1002,7 +1002,7 @@ export async function assertWebGpuAdapterAvailable(page, requiresWebGpu, softwar
             return await Promise.race([
                 probe(),
                 new Promise((resolve) => {
-                    timer = setTimeout(() => {
+                    timer = (globalThis.window?.__HF_VIRTUAL_TIME__?.originalSetTimeout ?? setTimeout)(() => {
                         expired = true;
                         resolve(false);
                     }, timeoutMs);

package/dist/services/drawElementService.js

@@ -488,7 +488,7 @@ syncToPaintEvent = true) {
                 }
                 // Encode OUTSIDE the paint handler — heavy canvas work inside the
                 // paint event can stall the renderer.
-                setTimeout(() => {
+                (window.__HF_VIRTUAL_TIME__?.originalSetTimeout ?? setTimeout)(() => {
                     try {
                         resolveCapture(fmt === "png"
                             ? canvas.toDataURL("image/png")
@@ -520,7 +520,7 @@ syncToPaintEvent = true) {
             // throttled page), fall back to an unsynchronized draw after 250 ms —
             // worst case one-frame-stale content (the root's alpha may lag its
             // transform by that frame) rather than a hung render.
-            setTimeout(() => {
+            (window.__HF_VIRTUAL_TIME__?.originalSetTimeout ?? setTimeout)(() => {
                 canvas.removeEventListener("paint", onPaint);
                 drawAndEncode();
             }, 250);
@@ -870,7 +870,7 @@ export async function produceDrawElementFrame(page, width, height, quality = 80,
             // Sentinel dirty + requestPaint() — see __hfDeInvalidate in
             // injectDrawElementCanvas.
             usedRequestPaint = aw.__hfDeInvalidate?.() === true;
-            setTimeout(() => {
+            (window.__HF_VIRTUAL_TIME__?.originalSetTimeout ?? setTimeout)(() => {
                 canvas.removeEventListener("paint", onPaint);
                 drawAndKick();
             }, 250);
@@ -957,7 +957,7 @@ export async function produceDrawElementFrameBatch(page, times, width, height, q
             // Sentinel dirty + requestPaint() — see __hfDeInvalidate in
             // injectDrawElementCanvas.
             usedRequestPaint = aw.__hfDeInvalidate?.() === true;
-            setTimeout(settle, 250);
+            (window.__HF_VIRTUAL_TIME__?.originalSetTimeout ?? setTimeout)(settle, 250);
         });
         let prevBitmap = Promise.resolve();
         let prevBitmapIdx = -1;

package/dist/services/frameCapture.d.ts

@@ -418,7 +418,7 @@ export declare function formatConsoleDiagnostic(type: string, text: string, loca
     text: string;
     suppressHostLog: boolean;
 };
-export declare const HF_READY_DIAGNOSTIC_EXPR = "(async function() {\n  var hf = window.__hf;\n  var player = window.__player;\n  var renderReady = !!window.__renderReady;\n  var hasSeek = !!(hf && typeof hf.seek === \"function\");\n  var duration = hf ? hf.duration : -1;\n  var hasTimeline = !!(window.__timelines && Object.keys(window.__timelines).length > 0);\n  var root = document.querySelector(\"[data-composition-id]\");\n  var declaredDuration = root ? Number(root.getAttribute(\"data-duration\")) : -1;\n  var registry = (window.__hf && window.__hf.buildReady) || {};\n  var keys = Object.keys(registry);\n  // A microtask race mis-sorts a non-native thenable (extra adoption tick)\n  // and rejects the whole expression on a rejected entry. Settling each\n  // key onto its own record and waiting one macrotask avoids both.\n  var settled = {};\n  if (keys.length > 0) {\n    keys.forEach(function(key) {\n      Promise.resolve(registry[key]).then(\n        function() { settled[key] = \"resolved\"; },\n        function() { settled[key] = \"rejected\"; },\n      );\n    });\n    await new Promise(function(r) { setTimeout(r, 0); });\n  }\n  // A thenable resolving via its own setTimeout(0) can still misreport as\n  // pending here (macrotask registration order, not resolution order), a\n  // narrow case that self-corrects on the next ~1s diagnostic tick.\n  var pendingBuildReadyKeys = keys.filter(function(key) { return !settled[key]; });\n  var rejectedBuildReadyKeys = keys.filter(function(key) { return settled[key] === \"rejected\"; });\n  return {\n    renderReady: renderReady,\n    hasHf: !!hf,\n    hasSeek: hasSeek,\n    hasPlayer: !!player,\n    duration: duration,\n    hasTimeline: hasTimeline,\n    declaredDuration: declaredDuration,\n    pendingBuildReadyKeys: pendingBuildReadyKeys,\n    rejectedBuildReadyKeys: rejectedBuildReadyKeys,\n  };\n})()";
+export declare const HF_READY_DIAGNOSTIC_EXPR = "(async function() {\n  var hf = window.__hf;\n  var player = window.__player;\n  var renderReady = !!window.__renderReady;\n  var hasSeek = !!(hf && typeof hf.seek === \"function\");\n  var duration = hf ? hf.duration : -1;\n  var hasTimeline = !!(window.__timelines && Object.keys(window.__timelines).length > 0);\n  var root = document.querySelector(\"[data-composition-id]\");\n  var declaredDuration = root ? Number(root.getAttribute(\"data-duration\")) : -1;\n  var registry = (window.__hf && window.__hf.buildReady) || {};\n  var keys = Object.keys(registry);\n  // A microtask race mis-sorts a non-native thenable (extra adoption tick)\n  // and rejects the whole expression on a rejected entry. Settling each\n  // key onto its own record and waiting one macrotask avoids both.\n  var settled = {};\n  if (keys.length > 0) {\n    keys.forEach(function(key) {\n      Promise.resolve(registry[key]).then(\n        function() { settled[key] = \"resolved\"; },\n        function() { settled[key] = \"rejected\"; },\n      );\n    });\n    await new Promise(function(r) {\n      (window.__HF_VIRTUAL_TIME__ && window.__HF_VIRTUAL_TIME__.originalSetTimeout || setTimeout)(r, 0);\n    });\n  }\n  // A thenable resolving via its own setTimeout(0) can still misreport as\n  // pending here (macrotask registration order, not resolution order), a\n  // narrow case that self-corrects on the next ~1s diagnostic tick.\n  var pendingBuildReadyKeys = keys.filter(function(key) { return !settled[key]; });\n  var rejectedBuildReadyKeys = keys.filter(function(key) { return settled[key] === \"rejected\"; });\n  return {\n    renderReady: renderReady,\n    hasHf: !!hf,\n    hasSeek: hasSeek,\n    hasPlayer: !!player,\n    duration: duration,\n    hasTimeline: hasTimeline,\n    declaredDuration: declaredDuration,\n    pendingBuildReadyKeys: pendingBuildReadyKeys,\n    rejectedBuildReadyKeys: rejectedBuildReadyKeys,\n  };\n})()";
 export interface HfDiagnostic {
     renderReady: boolean;
     hasHf: boolean;

package/dist/services/frameCapture.js

@@ -163,7 +163,7 @@ export async function decodeDynamicCssBackgroundImages(page) {
                 image.src = url;
                 let timer;
                 const expired = new Promise((resolve) => {
-                    timer = setTimeout(() => resolve("late"), limitMs);
+                    timer = (window.__HF_VIRTUAL_TIME__?.originalSetTimeout ?? setTimeout)(() => resolve("late"), limitMs);
                 });
                 try {
                     const outcome = await Promise.race([
@@ -1208,7 +1208,9 @@ export const HF_READY_DIAGNOSTIC_EXPR = `(async function() {
         function() { settled[key] = "rejected"; },
       );
     });
-    await new Promise(function(r) { setTimeout(r, 0); });
+    await new Promise(function(r) {
+      (window.__HF_VIRTUAL_TIME__ && window.__HF_VIRTUAL_TIME__.originalSetTimeout || setTimeout)(r, 0);
+    });
   }
   // A thenable resolving via its own setTimeout(0) can still misreport as
   // pending here (macrotask registration order, not resolution order), a

package/dist/services/videoFrameExtractor.js

@@ -506,9 +506,20 @@ export function parseImageElements(html) {
     return images;
 }
 const firstFrameColourCache = new Map();
-/** A source's SPS transfers, so a PQ or SDR keyframe keeps an HLG one at 100 nits; null when the read failed. */
+/** A source's SPS transfers, read as the trace streams (a run keeps only stderr's tail); null when the read failed. */
 function readKeyframeTransfers(videoPath, codec) {
-    return inExtractionSlot(() => runFfmpeg([...urlInputArgs(videoPath), ...keyframeTransferArgs(videoPath, codec)])).then((result) => (result.success ? parseKeyframeTransfers(result.stderr) : null));
+    let traced = "";
+    let rest = "";
+    const onStderr = (chunk) => {
+        const lines = (rest + chunk).split("\n");
+        rest = lines.pop() ?? "";
+        for (const line of lines)
+            if (line.includes("transfer_characteristics"))
+                traced += `${line}\n`;
+    };
+    return inExtractionSlot(() => runFfmpeg([...urlInputArgs(videoPath), ...keyframeTransferArgs(videoPath, codec)], {
+        onStderr,
+    })).then((result) => (result.success ? parseKeyframeTransfers(traced + rest) : null));
 }
 /** The first shown frame's colour tags (see {@link firstFrameColourArgs}), probed once per source file. */
 function readFirstFrameColour(videoPath, codec) {

package/dist/types.d.ts

@@ -423,5 +423,8 @@ export interface CapturePerfSummary {
 declare global {
     interface Window {
         __hf?: HfProtocol;
+        __HF_VIRTUAL_TIME__?: {
+            originalSetTimeout?: typeof setTimeout;
+        };
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.9.20",
+  "version": "0.9.22",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -61,8 +61,8 @@
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
     "undici": "7.25.0",
-    "@hyperframes/parsers": "^0.9.20",
-    "@hyperframes/core": "^0.9.20"
+    "@hyperframes/core": "^0.9.22",
+    "@hyperframes/parsers": "^0.9.22"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",