@hyperframes/engine 0.8.216 → 0.8.218

package/dist/services/frameCapture.js

@@ -743,7 +743,7 @@ async function cssEffectRiskFrames(session, totalFrames) {
         if (!scan.reason || !scan.bounded)
             return null;
         const fps = fpsToNumber(session.options.fps);
-        const live = await scanCssEffectLiveFrames(scratch.page, fps, totalFrames, totalFrames * MAX_RISK_FRAME_FRACTION);
+        const live = await scanCssEffectLiveFrames(scratch.page, fps, totalFrames, totalFrames * MAX_RISK_FRAME_FRACTION, { onProgress: session.options.onEffectScanProgress });
         return live && withFramesAfterCallback(live, scan.callbackFrom, fps, totalFrames);
     }
     catch (error) {

package/dist/services/riskFrames.d.ts

@@ -14,11 +14,16 @@ export declare const RISK_RENDER_ADDED_BYTES = 1000000000;
 export declare const RISK_RENDER_HEADROOM_BYTES = 1500000000;
 /** Risk ranges closer than this many frames are joined, so capture never alternates modes. */
 export declare const RISK_RANGE_HYSTERESIS_FRAMES = 12;
+interface ScanOptions {
+    budgetMs?: number;
+    now?: () => number;
+    onProgress?: (scannedFrames: number, totalFrames: number) => void;
+}
 /**
  * Frames where a recorded effect element shows. Seeks the page forward, so use a throwaway one.
- * Null once more than `maxFrames` frames qualify.
+ * Null once more than `maxFrames` frames qualify, or once the whole scan would take over `budgetMs`.
  */
-export declare function scanCssEffectLiveFrames(page: Page, fps: number, totalFrames: number, maxFrames: number): Promise<Set<number> | null>;
+export declare function scanCssEffectLiveFrames(page: Page, fps: number, totalFrames: number, maxFrames: number, { budgetMs, now, onProgress }?: ScanOptions): Promise<Set<number> | null>;
 /**
  * The given frames with a one-frame margin, ranges closer than {@link RISK_RANGE_HYSTERESIS_FRAMES}
  * joined. Null when they cover more than {@link MAX_RISK_FRAME_FRACTION} of the render.
@@ -28,3 +33,4 @@ export declare function planRiskFrames(frames: Iterable<number>, totalFrames: nu
 export declare function withFramesAfterCallback(live: Set<number>, callbackFrom: number | null, fps: number, totalFrames: number): Set<number>;
 /** Whether the render fits: what it adds, scaled by output pixels, leaves the headroom. */
 export declare function riskSessionFits(availableMb: number, outputPixels: number): boolean;
+export {};

package/dist/services/riskFrames.js

@@ -5,6 +5,8 @@
 import { quantizeTimeToFrame } from "@hyperframes/core";
 /** Frames per page round trip while scanning; a scan is one in-page loop per chunk. */
 const SCAN_CHUNK_FRAMES = 240;
+/** Longest the scan may hold back the first frame; above it the whole render captures by screenshot. */
+const SCAN_BUDGET_MS = 120_000;
 /**
  * Above this share of risk frames the second browser and the switching cost outweigh the fast
  * frames, so the whole render captures by screenshot as it always has.
@@ -17,44 +19,52 @@ export const RISK_RENDER_HEADROOM_BYTES = 1_500_000_000;
 const PIXELS_1080P = 1920 * 1080;
 /** Risk ranges closer than this many frames are joined, so capture never alternates modes. */
 export const RISK_RANGE_HYSTERESIS_FRAMES = 12;
+async function scanChunk(page, times) {
+    return page.evaluate(async (ts) => {
+        const w = window;
+        const targets = w.__hfCssFxTargets ?? [];
+        // A hidden element still shows a descendant that sets `visibility: visible` itself.
+        const paints = (el) => getComputedStyle(el).visibility !== "hidden" ||
+            Array.from(el.querySelectorAll("*")).some((d) => getComputedStyle(d).visibility === "visible");
+        const shows = (el) => {
+            for (let n = el; n; n = n.parentElement) {
+                const cs = getComputedStyle(n);
+                if (cs.display === "none" || Number(cs.opacity) === 0)
+                    return false;
+            }
+            return paints(el);
+        };
+        const out = [];
+        for (let i = 0; i < ts.length; i++) {
+            w.__hf?.seek?.(ts[i]);
+            await w.__hfWaitForSeekCompletion?.();
+            if (targets.some(shows))
+                out.push(i);
+        }
+        return out;
+    }, times);
+}
 /**
  * Frames where a recorded effect element shows. Seeks the page forward, so use a throwaway one.
- * Null once more than `maxFrames` frames qualify.
+ * Null once more than `maxFrames` frames qualify, or once the whole scan would take over `budgetMs`.
  */
-export async function scanCssEffectLiveFrames(page, fps, totalFrames, maxFrames) {
+export async function scanCssEffectLiveFrames(page, fps, totalFrames, maxFrames, { budgetMs = SCAN_BUDGET_MS, now = () => performance.now(), onProgress } = {}) {
     const live = new Set();
-    for (let from = 0; from < totalFrames; from += SCAN_CHUNK_FRAMES) {
+    const started = now();
+    for (let from = 0; from < totalFrames && live.size <= maxFrames; from += SCAN_CHUNK_FRAMES) {
+        const to = Math.min(totalFrames, from + SCAN_CHUNK_FRAMES);
         const times = [];
-        for (let f = from; f < Math.min(totalFrames, from + SCAN_CHUNK_FRAMES); f++) {
+        for (let f = from; f < to; f++)
             times.push(quantizeTimeToFrame(f / fps, fps));
-        }
-        const hits = await page.evaluate(async (ts) => {
-            const w = window;
-            const targets = w.__hfCssFxTargets ?? [];
-            // A hidden element still shows a descendant that sets `visibility: visible` itself.
-            const paints = (el) => getComputedStyle(el).visibility !== "hidden" ||
-                Array.from(el.querySelectorAll("*")).some((d) => getComputedStyle(d).visibility === "visible");
-            const shows = (el) => {
-                for (let n = el; n; n = n.parentElement) {
-                    const cs = getComputedStyle(n);
-                    if (cs.display === "none" || Number(cs.opacity) === 0)
-                        return false;
-                }
-                return paints(el);
-            };
-            const out = [];
-            for (let i = 0; i < ts.length; i++) {
-                w.__hf?.seek?.(ts[i]);
-                await w.__hfWaitForSeekCompletion?.();
-                if (targets.some(shows))
-                    out.push(i);
-            }
-            return out;
-        }, times);
-        for (const i of hits)
+        for (const i of await scanChunk(page, times))
             live.add(from + i);
-        if (live.size > maxFrames)
-            break;
+        onProgress?.(to, totalFrames);
+        const projectedMs = ((now() - started) / to) * totalFrames;
+        if (to < totalFrames && projectedMs > budgetMs) {
+            console.error(`[engine] fast capture: the effect scan of ${totalFrames} frames would take ` +
+                `${Math.round(projectedMs / 1000)} s, over its ${budgetMs / 1000} s budget`);
+            return null;
+        }
     }
     return live.size > maxFrames ? null : live;
 }

package/dist/types.d.ts

@@ -227,6 +227,7 @@ export interface CaptureOptions {
      */
     deVerifySamples?: number;
     deFrameFallback?: boolean;
+    onEffectScanProgress?: (scannedFrames: number, totalFrames: number) => void;
 }
 export interface CaptureVideoMetadataHint {
     id: string;

package/package.json

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