@hyperframes/engine 0.8.193 → 0.8.195

package/dist/index.d.ts

@@ -50,7 +50,7 @@ export { parseVideoElements, parseImageElements, extractVideoFramesRange, extrac
 export { directorySizeBytes, gcExtractionCache } from "./services/extractionCache.js";
 export { resolveReferencedStart, resolveReferencedDuration, type RefResolverEl, type RefResolverDoc, } from "./services/referenceResolver.js";
 export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
-export { MIXED_AUDIO_FILENAME, parseAudioElements, parseMasterFxChain, processCompositionAudio, } from "./services/audioMixer.js";
+export { MIXED_AUDIO_FILENAME, parseAudioElements, parseMasterFxChain, processCompositionAudio, videoAudioId, } from "./services/audioMixer.js";
 export { audioFailureDiagnostics } from "./services/audioFailureDiagnostic.js";
 export { cloneCaptureWarning, cloneCaptureWarnings } from "./services/captureWarning.js";
 export type { AudioElement, AudioFailureReason, AudioFailureStage, AudioProcessingFailure, AudioFailureDiagnostic, AudioSubprocessEvidence, AudioTrack, AudioVolumeKeyframe, MixResult, } from "./services/audioMixer.types.js";

package/dist/index.js

@@ -54,7 +54,7 @@ export { parseVideoElements, parseImageElements, extractVideoFramesRange, extrac
 export { directorySizeBytes, gcExtractionCache } from "./services/extractionCache.js";
 export { resolveReferencedStart, resolveReferencedDuration, } from "./services/referenceResolver.js";
 export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
-export { MIXED_AUDIO_FILENAME, parseAudioElements, parseMasterFxChain, processCompositionAudio, } from "./services/audioMixer.js";
+export { MIXED_AUDIO_FILENAME, parseAudioElements, parseMasterFxChain, processCompositionAudio, videoAudioId, } from "./services/audioMixer.js";
 export { audioFailureDiagnostics } from "./services/audioFailureDiagnostic.js";
 export { cloneCaptureWarning, cloneCaptureWarnings } from "./services/captureWarning.js";
 // ── Parallel rendering ─────────────────────────────────────────────────────────

package/dist/services/audioMixer.d.ts

@@ -30,6 +30,7 @@ export declare function volumeLaneKeyframes(automation: {
  * itself has no parsed element to carry it.
  */
 export declare function parseMasterFxChain(html: string): string | undefined;
+export declare function videoAudioId(videoId: string): string;
 export declare function parseAudioElements(html: string): AudioElement[];
 /** Tracks per ffmpeg graph; a larger mix is summed in stages, so there is no cap on the total. */
 export declare const MAX_MIX_INPUTS = 96;

package/dist/services/audioMixer.js

@@ -420,6 +420,9 @@ export function volumeLaneKeyframes(automation, trackStart, duration, gain, gain
 export function parseMasterFxChain(html) {
     return readMasterFxChain(parseHTML(unwrapTemplate(html)).document);
 }
+export function videoAudioId(videoId) {
+    return `${videoId}-audio`;
+}
 export function parseAudioElements(html) {
     const elements = [];
     const { document } = parseHTML(unwrapTemplate(html));
@@ -504,7 +507,7 @@ export function parseAudioElements(html) {
             continue;
         if (isKnownInactiveTimelineWindow(el, resolveStart(el)))
             continue;
-        elements.push(build(el, `${id}-audio`, src, "video", true));
+        elements.push(build(el, videoAudioId(id), src, "video", true));
     }
     return elements;
 }

package/dist/services/browserManager.js

@@ -5,6 +5,7 @@
  * Manages Puppeteer browser lifecycle: Chrome executable resolution,
  * launch args, pooled browser acquisition/release.
  */
+import { withHyperframesBrowserMarker } from "@hyperframes/core/browser-marker";
 import { scanHtmlOpeningTags } from "@hyperframes/parsers/html-attribute-spans";
 import { execSync } from "child_process";
 import { existsSync, readdirSync, statSync } from "fs";
@@ -55,7 +56,7 @@ async function probeHardwareWebGlInfo(ppt, options) {
         const launchOptions = {
             ...sigintLaunchOptions(),
             headless: true,
-            args: options.args,
+            args: withHyperframesBrowserMarker(options.args),
             defaultViewport: { width: 64, height: 64 },
             executablePath: options.executablePath,
             env: options.env,
@@ -463,6 +464,25 @@ function envWithoutWaylandDisplay() {
     const { WAYLAND_DISPLAY: _wslg, ...env } = process.env;
     return env;
 }
+// ANGLE and Dawn load SwiftShader via VK_ICD_FILENAMES, which these override or filter:
+// https://github.com/KhronosGroup/Vulkan-Loader/blob/main/docs/LoaderDriverInterface.md
+const VULKAN_VARS_THAT_OVERRIDE_SWIFTSHADER = [
+    "VK_DRIVER_FILES",
+    "VK_LOADER_DRIVERS_SELECT",
+    "VK_LOADER_DRIVERS_DISABLE",
+];
+function launchEnv(fingerprint) {
+    if (fingerprint.withoutWaylandDisplay)
+        return envWithoutWaylandDisplay();
+    const swiftShader = fingerprint.args.some((arg) => arg === "--use-angle=swiftshader" || arg === "--use-vulkan=swiftshader");
+    const overriding = VULKAN_VARS_THAT_OVERRIDE_SWIFTSHADER.filter((name) => name in process.env);
+    if (!swiftShader || overriding.length === 0)
+        return undefined;
+    const env = { ...process.env };
+    for (const name of overriding)
+        delete env[name];
+    return env;
+}
 /** True when a `resolvedMode` render must launch without WAYLAND_DISPLAY to reach the GPU. */
 export async function captureWithoutWaylandDisplay(resolvedMode) {
     if (resolvedMode !== "hardware")
@@ -630,14 +650,14 @@ export async function acquireBrowser(chromeArgs, config) {
 // fallow-ignore-next-line complexity
 async function launchBrowser(fingerprint) {
     const ppt = await getPuppeteer();
-    const env = fingerprint.withoutWaylandDisplay ? envWithoutWaylandDisplay() : undefined;
+    const env = launchEnv(fingerprint);
     let captureMode = fingerprint.requestedCaptureMode;
     let browser;
     try {
         browser = await ppt.launch({
             ...sigintLaunchOptions(),
             headless: true,
-            args: [...fingerprint.args],
+            args: withHyperframesBrowserMarker(fingerprint.args),
             defaultViewport: null,
             executablePath: fingerprint.executablePath,
             env,
@@ -662,7 +682,7 @@ async function launchBrowser(fingerprint) {
                 browser = await ppt.launch({
                     ...sigintLaunchOptions(),
                     headless: true,
-                    args: stripBeginFrameFlags([...fingerprint.args]),
+                    args: withHyperframesBrowserMarker(stripBeginFrameFlags([...fingerprint.args])),
                     defaultViewport: null,
                     executablePath: fingerprint.executablePath,
                     env,

package/dist/services/chunkEncoder.js

@@ -7,7 +7,7 @@
  */
 import { frameSequencePath } from "./extractedFrameIndex.js";
 import { closeSync, copyFileSync, existsSync, ftruncateSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, statSync, writeFileSync, writeSync, } from "fs";
-import { join, dirname, extname } from "path";
+import { join, dirname, extname, resolve } from "path";
 import { DEFAULT_CONFIG } from "../config.js";
 import { getCachedGpuEncoder, getGpuEncoderName, buildVideoToolboxRateControlArgs, mapPresetForGpuEncoder, } from "../utils/gpuEncoder.js";
 import { getHdrEncoderColorParams, hdrFrameTagsFilter } from "../utils/hdr.js";
@@ -460,7 +460,7 @@ let concatListSeq = 0;
 function writeConcatList(dir, inputPaths) {
     concatListSeq += 1;
     const listPath = join(dir, `concat-list-${process.pid}-${concatListSeq}.txt`);
-    const body = inputPaths.map((p) => `file '${p.replace(/'/g, "'\\''")}'`).join("\n");
+    const body = inputPaths.map((p) => `file '${resolve(p).replace(/'/g, "'\\''")}'`).join("\n");
     writeFileSync(listPath, body, "utf-8");
     return listPath;
 }

package/dist/services/hdrCapture.js

@@ -18,6 +18,7 @@
  *
  * Performance: ~6 fps at 1080x1920 via base64 transfer.
  */
+import { withHyperframesBrowserMarker } from "@hyperframes/core/browser-marker";
 import { resolveFullChromePath, sigintLaunchOptions } from "./browserManager.js";
 // ── PQ (SMPTE 2084) OETF ─────────────────────────────────────────────────────
 const PQ_M1 = 0.1593017578125;
@@ -183,7 +184,7 @@ export async function launchHdrBrowser(width, height) {
         ...sigintLaunchOptions(),
         headless: false,
         executablePath: chromePath,
-        args: buildHdrChromeArgs(width, height),
+        args: withHyperframesBrowserMarker(buildHdrChromeArgs(width, height)),
     });
     const page = await browser.newPage();
     await page.setViewport({ width, height });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.193",
+  "version": "0.8.195",
   "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/core": "^0.8.193",
-    "@hyperframes/parsers": "^0.8.193"
+    "@hyperframes/parsers": "^0.8.195",
+    "@hyperframes/core": "^0.8.195"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",