hyperframes 0.4.1 → 0.4.2

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.4.1" : "0.0.0-dev";
+    VERSION = true ? "0.4.2" : "0.0.0-dev";
   }
 });
 
@@ -20428,6 +20428,34 @@ function resolveHeadlessShellPath(config) {
   }
   return void 0;
 }
+function stripBeginFrameFlags(args) {
+  return args.filter((a) => !BEGINFRAME_ONLY_FLAGS.has(a));
+}
+async function probeBeginFrameSupport(browser) {
+  let page;
+  try {
+    page = await browser.newPage();
+    const client = await page.createCDPSession();
+    await client.send("HeadlessExperimental.enable");
+    const beginFrame = client.send("HeadlessExperimental.beginFrame", {
+      frameTimeTicks: 0,
+      interval: 33,
+      noDisplayUpdates: true
+    });
+    const timeout = new Promise(
+      (_2, reject) => setTimeout(() => reject(new Error("beginFrame probe timeout")), 2e3)
+    );
+    await Promise.race([beginFrame, timeout]);
+    await client.detach().catch(() => {
+    });
+    return true;
+  } catch {
+    return false;
+  } finally {
+    await page?.close().catch(() => {
+    });
+  }
+}
 async function acquireBrowser(chromeArgs, config) {
   const enablePool = config?.enableBrowserPool ?? DEFAULT_CONFIG2.enableBrowserPool;
   if (enablePool && pooledBrowser) {
@@ -20447,14 +20475,35 @@ async function acquireBrowser(chromeArgs, config) {
     executablePath = headlessShell ?? void 0;
   }
   const ppt = await getPuppeteer();
-  const browser = await ppt.launch({
+  const browserTimeout = config?.browserTimeout ?? DEFAULT_CONFIG2.browserTimeout;
+  const protocolTimeout = config?.protocolTimeout ?? DEFAULT_CONFIG2.protocolTimeout;
+  let browser = await ppt.launch({
     headless: true,
     args: chromeArgs,
     defaultViewport: null,
     executablePath,
-    timeout: config?.browserTimeout ?? DEFAULT_CONFIG2.browserTimeout,
-    protocolTimeout: config?.protocolTimeout ?? DEFAULT_CONFIG2.protocolTimeout
+    timeout: browserTimeout,
+    protocolTimeout
   });
+  if (captureMode === "beginframe") {
+    const supported = await probeBeginFrameSupport(browser).catch(() => true);
+    if (!supported) {
+      await browser.close().catch(() => {
+      });
+      console.warn(
+        "[BrowserManager] HeadlessExperimental.beginFrame unavailable in this Chromium build; falling back to screenshot mode."
+      );
+      captureMode = "screenshot";
+      browser = await ppt.launch({
+        headless: true,
+        args: stripBeginFrameFlags(chromeArgs),
+        defaultViewport: null,
+        executablePath,
+        timeout: browserTimeout,
+        protocolTimeout
+      });
+    }
+  }
   if (enablePool) {
     pooledBrowser = browser;
     pooledBrowserRefCount = 1;
@@ -20537,7 +20586,7 @@ function buildChromeArgs(options, config) {
   }
   return chromeArgs;
 }
-var _puppeteer, pooledBrowser, pooledBrowserRefCount, pooledCaptureMode, ENABLE_BROWSER_POOL;
+var _puppeteer, pooledBrowser, pooledBrowserRefCount, pooledCaptureMode, ENABLE_BROWSER_POOL, BEGINFRAME_ONLY_FLAGS;
 var init_browserManager = __esm({
   "../engine/src/services/browserManager.ts"() {
     "use strict";
@@ -20546,6 +20595,17 @@ var init_browserManager = __esm({
     pooledBrowserRefCount = 0;
     pooledCaptureMode = "screenshot";
     ENABLE_BROWSER_POOL = DEFAULT_CONFIG2.enableBrowserPool;
+    BEGINFRAME_ONLY_FLAGS = /* @__PURE__ */ new Set([
+      "--deterministic-mode",
+      "--enable-begin-frame-control",
+      "--disable-new-content-rendering-timeout",
+      "--run-all-compositor-stages-before-draw",
+      "--disable-threaded-animation",
+      "--disable-threaded-scrolling",
+      "--disable-checker-imaging",
+      "--disable-image-animation-resync",
+      "--enable-surface-synchronization"
+    ]);
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperframes",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "repository": {
     "type": "git",