@hyperframes/engine 0.9.0 → 0.9.2

package/dist/services/frameCapture.js

@@ -11,6 +11,7 @@ import { existsSync, mkdirSync, writeFileSync } from "fs";
 import { join } from "path";
 import { COMPOSITION_SOURCE_URL, MEDIA_RENDER_ID_ATTR, quantizeSeekTime, quantizeTimeToFrame, fpsToNumber, resolveAuthoredTimingWindow, AUTHORED_SOURCE_BEGIN, AUTHORED_SOURCE_END, RUNTIME_BOOTSTRAP_ATTR, SCENE_CALLBACK_ERROR_PREFIX, } from "@hyperframes/core";
 import { holdRenderFrameVideos } from "./renderFrameVideoHold.js";
+import { recordWebglContexts, releaseEndedWebglContexts } from "./webglRelease.js";
 import { asDrawElementCaptureFailure, DrawElementCaptureError } from "./drawElementCaptureError.js";
 import { encodePng } from "../utils/alphaBlit.js";
 import { DEFAULT_SAMPLES_PER_FRAME, MotionBlurAccumulator, SPATIAL_TWEEN_PROPERTIES, adaptiveSampleCount, motionBlurProbeTimes, motionBlurSampleTimes, motionBlurWindowIsStatic, probeDiffMagnitude, resolveMotionBlurPlan, } from "./motionBlur.js";
@@ -1004,6 +1005,7 @@ async function constructCaptureSession(input) {
         }
     });
     await installMediaPageHooks(page, options);
+    await page.evaluateOnNewDocument(recordWebglContexts);
     // Fast capture: record accelerated canvases (webgl/webgl2/webgpu) and force
     // preserveDrawingBuffer before any page script can create a context — their
     // paint records freeze at the first frame, so captureDrawElementFrame
@@ -2345,6 +2347,7 @@ async function prepareFrameForCapture(session, frameIndex, time, seekOptions, he
     const seekStart = Date.now();
     session.captureStep = "seeking the timeline";
     const hasPendingComposite = await seekPageTimeline(page, quantizedTime, seekOptions);
+    await releaseEndedWebglContexts(page, quantizedTime);
     session.captureStep = "decoding CSS background images";
     await decodeDynamicCssBackgroundImages(page);
     const seekMs = Date.now() - seekStart;

package/dist/services/webglRelease.d.ts

@@ -0,0 +1,5 @@
+import type { Page } from "puppeteer-core";
+/** Records each WebGL context a page creates. Register with page.evaluateOnNewDocument before navigation. */
+export declare function recordWebglContexts(): void;
+/** Releases the WebGL context of each canvas in a hidden clip whose runtime-resolved window ended by `time`. */
+export declare function releaseEndedWebglContexts(page: Page, time: number): Promise<number>;

package/dist/services/webglRelease.js

@@ -0,0 +1,39 @@
+/** Records each WebGL context a page creates. Register with page.evaluateOnNewDocument before navigation. */
+export function recordWebglContexts() {
+    const w = window;
+    w.__hf_gl_contexts = [];
+    const canvasProto = HTMLCanvasElement.prototype;
+    const orig = canvasProto.getContext;
+    canvasProto.getContext = function (type, attrs) {
+        const ctx = orig.call(this, type, attrs);
+        if (ctx && (type === "webgl" || type === "webgl2" || type === "experimental-webgl")) {
+            const list = w.__hf_gl_contexts ?? [];
+            if (!list.some((r) => r.ctx === ctx))
+                list.push({ canvas: this, ctx });
+            w.__hf_gl_contexts = list;
+        }
+        return ctx;
+    };
+}
+/** Releases the WebGL context of each canvas in a hidden clip whose runtime-resolved window ended by `time`. */
+export async function releaseEndedWebglContexts(page, time) {
+    return page.evaluate((t) => {
+        const clipWindow = window.__hf?.clipWindow;
+        if (!clipWindow)
+            return 0;
+        const hasEnded = (el) => {
+            for (let up = el; up; up = up.parentElement) {
+                const span = up.hasAttribute("data-hf-clip-hidden") ? clipWindow(up) : null;
+                if (span && Number.isFinite(span.end) && span.end <= t)
+                    return true;
+            }
+            return false;
+        };
+        const live = (window.__hf_gl_contexts ?? []).filter((r) => !r.lost && hasEnded(r.canvas));
+        for (const rec of live) {
+            rec.lost = true;
+            rec.ctx.getExtension("WEBGL_lose_context")?.loseContext();
+        }
+        return live.length;
+    }, time);
+}

package/dist/types.d.ts

@@ -123,6 +123,10 @@ export interface HfProtocol {
     media?: HfMediaElement[];
     /** Optional: shader transition metadata, populated by @hyperframes/shader-transitions */
     transitions?: HfTransitionMeta[];
+    clipWindow?(el: Element): {
+        start: number;
+        end: number;
+    } | null;
 }
 export interface CaptureOptions {
     width: number;

package/package.json

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