jest-environment-webgl-node 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [jest-environment-webgl-node-v0.1.2](https://github.com/bhouston/jest-gpu/compare/jest-environment-webgl-node-v0.1.1...jest-environment-webgl-node-v0.1.2) (2026-09-21)
+
+### Bug Fixes
+
+* **webgl:** detect backend conflicts against the initialized display ([e68573d](https://github.com/bhouston/jest-gpu/commit/e68573d1f5cd20e571d4e313ad244f6a8a41d513)), closes [#21](https://github.com/bhouston/jest-gpu/issues/21)

package/README.md

@@ -42,10 +42,20 @@ it('renders', () => {
 ```
 
 `testEnvironmentOptions` are those of node-webgl's `init()` (`backend`, `api`) and `installDOM()`
-(`baseDir`, `fetch`, `devicePixelRatio`, `innerWidth`, `innerHeight`, `frameInterval`). Because
-`installDOM()` writes to the host `globalThis` and is idempotent, only the **first** test file's
-options take effect for the underlying host install; every test file's sandbox still gets the
-same installed globals copied in.
+(`baseDir`, `fetch`, `devicePixelRatio`, `innerWidth`, `innerHeight`, `frameInterval`). Each test
+file receives a fresh document, DOM event state, viewport values, file-fetch base directory and
+animation-frame queue. Animation frames use Jest's sandbox timers, so `jest.useFakeTimers()` and
+`jest.advanceTimersByTime()` control them; pending frames are cancelled during environment
+teardown.
+
+File fetching is enabled by default. Relative paths resolve from that test file's `baseDir`
+(default: `process.cwd()`), while HTTP, data and blob URLs use Node's native `fetch`. Set
+`fetch: false` to use native fetch for every URL. The environment never replaces host globals.
+
+The native WebGL display itself is process-wide and is created by the first context in a worker, so
+set `backend` and `api` consistently across all projects that can share a Jest worker. The
+environment throws if an explicit `backend` or `api` disagrees with the display already initialized
+in that worker, including one initialized with platform defaults by a project that set no options.
 
 Types for the installed globals: add `import 'jest-environment-webgl-node/globals';` to a `.d.ts`
 file your tsconfig includes.
@@ -57,6 +67,12 @@ a test file itself imports an ESM-only library.
 On Linux CI install Mesa (`apt-get install libegl1 libgles2 libgl1-mesa-dri`) and set
 `LIBGL_ALWAYS_SOFTWARE=1`. macOS and Windows use prebuilt binaries.
 
+## Using Vitest?
+
+The equivalent package for Vitest is
+[`vitest-environment-webgl-node`](https://github.com/bhouston/vitest-gpu/tree/main/packages/vitest-environment-webgl-node)
+from [vitest-gpu](https://github.com/bhouston/vitest-gpu).
+
 ## Author
 
 Created by [Ben Houston](https://ben3d.ca) and sponsored by [Land of Assets](https://landofassets.com).

package/dist/index.cjs

@@ -2,48 +2,222 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+let node_url = require("node:url");
 let _onirenaud_node_webgl = require("@onirenaud/node-webgl");
+_onirenaud_node_webgl = __toESM(_onirenaud_node_webgl, 1);
 let jest_environment_node = require("jest-environment-node");
 //#region src/index.ts
-let domNames;
-function ensureHostDOM(options) {
-	if (domNames) return domNames;
-	const { backend, api, ...dom } = options;
-	if (backend || api) (0, _onirenaud_node_webgl.init)({
-		backend,
-		api
+const WEBGL_OPTION_NAMES = /* @__PURE__ */ new Set([
+	"api",
+	"backend",
+	"baseDir",
+	"devicePixelRatio",
+	"fetch",
+	"frameInterval",
+	"innerHeight",
+	"innerWidth"
+]);
+const MIME = {
+	".basis": "application/octet-stream",
+	".bin": "application/octet-stream",
+	".drc": "application/octet-stream",
+	".exr": "image/x-exr",
+	".fbx": "application/octet-stream",
+	".gif": "image/gif",
+	".glb": "model/gltf-binary",
+	".gltf": "model/gltf+json",
+	".hdr": "image/vnd.radiance",
+	".jpeg": "image/jpeg",
+	".jpg": "image/jpeg",
+	".js": "text/javascript",
+	".json": "application/json",
+	".ktx": "image/ktx",
+	".ktx2": "image/ktx2",
+	".mjs": "text/javascript",
+	".mtl": "text/plain",
+	".obj": "text/plain",
+	".png": "image/png",
+	".svg": "image/svg+xml",
+	".txt": "text/plain",
+	".wasm": "application/wasm",
+	".webp": "image/webp"
+};
+const DOM_NAMES = [
+	"window",
+	"self",
+	"HTMLCanvasElement",
+	"OffscreenCanvas",
+	"HTMLImageElement",
+	"Image",
+	"ImageData",
+	"ImageBitmap",
+	"createImageBitmap",
+	"FileReader",
+	"HTMLElement",
+	"Element",
+	"Node",
+	"devicePixelRatio",
+	"innerWidth",
+	"innerHeight",
+	"screen",
+	"requestAnimationFrame",
+	"cancelAnimationFrame",
+	"getComputedStyle",
+	"matchMedia",
+	"scrollTo",
+	"alert",
+	"location",
+	"document",
+	...Object.keys(_onirenaud_node_webgl).filter((name) => name.startsWith("WebGL"))
+];
+let initializedWith;
+/**
+* The native EGL display is process-wide and node-webgl's `init()` is a no-op once it exists (the first
+* context creates it lazily), so compare explicit options against the live display rather than only
+* against what this module itself initialized.
+*/
+function initialize({ api, backend }) {
+	if (!api && !backend) return;
+	if (initializedWith && initializedWith.api === api && initializedWith.backend === backend) return;
+	const display = _onirenaud_node_webgl.getDisplayInfo();
+	if (display && (backend && backend !== "default" && backend !== display.backend || api && api !== "auto" && api !== display.api)) throw new Error(`node-webgl is already initialized with ${JSON.stringify({
+		api: display.api,
+		backend: display.backend
+	})}; cannot switch this Jest worker to ${JSON.stringify({
+		api,
+		backend
+	})}`);
+	_onirenaud_node_webgl.init({
+		api,
+		backend
 	});
-	const before = new Set(Object.getOwnPropertyNames(globalThis));
-	(0, _onirenaud_node_webgl.installDOM)(dom);
-	domNames = Object.getOwnPropertyNames(globalThis).filter((key) => !before.has(key));
-	return domNames;
+	initializedWith = {
+		api,
+		backend
+	};
+}
+/** Capture a fresh node-webgl DOM while restoring every host descriptor after installation. */
+function createDOM(options) {
+	const before = Object.getOwnPropertyDescriptors(globalThis);
+	for (const name of DOM_NAMES) Reflect.deleteProperty(globalThis, name);
+	try {
+		_onirenaud_node_webgl.installDOM({
+			...options,
+			fetch: false
+		});
+		const after = Object.getOwnPropertyDescriptors(globalThis);
+		return new Map(DOM_NAMES.flatMap((name) => after[name] ? [[name, after[name]]] : []));
+	} finally {
+		for (const name of Object.getOwnPropertyNames(globalThis)) if (!(name in before)) Reflect.deleteProperty(globalThis, name);
+		Object.defineProperties(globalThis, before);
+	}
+}
+function environmentConfig(config) {
+	return {
+		...config,
+		projectConfig: {
+			...config.projectConfig,
+			testEnvironmentOptions: Object.fromEntries(Object.entries(config.projectConfig.testEnvironmentOptions).filter(([name]) => !WEBGL_OPTION_NAMES.has(name)))
+		}
+	};
+}
+function localFetch(baseDir, nativeFetch) {
+	return async (input, init) => {
+		const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+		if (/^(https?|data|blob):/i.test(url)) return nativeFetch(input, init);
+		const path = url.startsWith("file:") ? (0, node_url.fileURLToPath)(url) : (0, node_path.resolve)(baseDir, url.replace(/[?#].*$/, ""));
+		try {
+			const bytes = await (0, node_fs_promises.readFile)(path);
+			return new Response(bytes, {
+				status: 200,
+				headers: { "content-type": MIME[(0, node_path.extname)(path).toLowerCase()] ?? "application/octet-stream" }
+			});
+		} catch {
+			return new Response(null, {
+				status: 404,
+				statusText: "Not Found"
+			});
+		}
+	};
 }
 var WebglEnvironment = class extends jest_environment_node.TestEnvironment {
-	added;
+	added = [];
+	animationFrames = /* @__PURE__ */ new Map();
 	constructor(config, context) {
-		super(config, context);
-		const nativeAdded = !Object.getOwnPropertyNames(this.global).includes("_native");
-		if (nativeAdded) Object.defineProperty(this.global, "_native", {
-			value: void 0,
-			writable: true,
-			configurable: true,
-			enumerable: false
-		});
 		const options = config.projectConfig.testEnvironmentOptions;
-		const names = ensureHostDOM(options);
+		super(environmentConfig(config), context);
+		const { api, backend, ...domOptions } = options;
+		initialize({
+			api,
+			backend
+		});
 		const g = this.global;
-		this.added = names.filter((key) => !(key in g));
-		for (const key of this.added) g[key] = globalThis[key];
-		if (nativeAdded) this.added.push("_native");
+		if (!Object.getOwnPropertyNames(g).includes("_native")) {
+			Object.defineProperty(g, "_native", {
+				value: void 0,
+				writable: true,
+				configurable: true,
+				enumerable: false
+			});
+			this.added.push("_native");
+		}
+		for (const [name, descriptor] of createDOM(domOptions)) {
+			if (!(name in g)) this.added.push(name);
+			Object.defineProperty(g, name, descriptor);
+		}
 		g.window = g;
 		g.self = g;
-		for (const target of [g.window, g.document]) {
-			target.addEventListener ??= () => {};
-			target.removeEventListener ??= () => {};
-		}
+		g.document.defaultView = g;
+		const events = new EventTarget();
+		g.addEventListener = events.addEventListener.bind(events);
+		g.removeEventListener = events.removeEventListener.bind(events);
+		g.dispatchEvent = events.dispatchEvent.bind(events);
+		this.added.push("addEventListener", "removeEventListener", "dispatchEvent");
+		const interval = domOptions.frameInterval ?? 16;
+		g.requestAnimationFrame = (callback) => {
+			const id = g.setTimeout(() => {
+				this.animationFrames.delete(id);
+				callback(g.performance.now());
+			}, interval);
+			this.animationFrames.set(id, g.clearTimeout);
+			return id;
+		};
+		g.cancelAnimationFrame = (id) => {
+			const clear = this.animationFrames.get(id);
+			this.animationFrames.delete(id);
+			(clear ?? g.clearTimeout)(id);
+		};
+		const nativeFetch = globalThis.fetch.bind(globalThis);
+		g.fetch = domOptions.fetch === false ? nativeFetch : localFetch(domOptions.baseDir ?? process.cwd(), nativeFetch);
 	}
 	async teardown() {
 		const g = this.global;
+		for (const [id, clear] of this.animationFrames) clear(id);
+		this.animationFrames.clear();
 		for (const key of this.added) delete g[key];
 		await super.teardown();
 	}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["TestEnvironment"],"sources":["../src/index.ts"],"sourcesContent":["import { init, installDOM, type InitOptions, type InstallDOMOptions } from '@onirenaud/node-webgl';\nimport { TestEnvironment } from 'jest-environment-node';\n\n/** Set under `testEnvironmentOptions` in your Jest config. */\nexport type WebglNodeOptions = InitOptions & InstallDOMOptions;\n\n// Typed from TestEnvironment's own constructor rather than importing `@jest/environment`\n// directly: that package is only a transitive dependency (of jest-environment-node), not\n// resolvable from this package's own node_modules under pnpm's strict layout.\ntype JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];\ntype EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];\n\n// node-webgl's installDOM() writes to the HOST globalThis (not a target you pass in) and is\n// idempotent (it skips names already defined). So it can only usefully run once per process: on\n// the first WebglEnvironment constructed here, snapshot the host globals before/after the call and\n// remember which names it added. Every later environment (this test file or another one sharing\n// the worker) copies that same fixed list into its own sandbox global instead of calling\n// installDOM() again. This means only the FIRST test file's `testEnvironmentOptions` actually\n// affect the host install (backend/api selection, DOM option defaults); later test files'\n// options for those are ignored, matching how node-webgl itself behaves.\nlet domNames: readonly string[] | undefined;\n\nfunction ensureHostDOM(options: WebglNodeOptions): readonly string[] {\n  if (domNames) return domNames;\n  const { backend, api, ...dom } = options;\n  if (backend || api) init({ backend, api });\n  const before = new Set(Object.getOwnPropertyNames(globalThis));\n  installDOM(dom);\n  domNames = Object.getOwnPropertyNames(globalThis).filter((key) => !before.has(key));\n  return domNames;\n}\n\nexport default class WebglEnvironment extends TestEnvironment {\n  private readonly added: string[];\n\n  constructor(config: JestEnvironmentConfig, context: EnvironmentContext) {\n    super(config, context);\n    // @babylonjs/core defines a `_native` accessor on `self` at module load; on Jest's proxied\n    // sandbox global that defineProperty violates a proxy invariant, so pre-seed the property to\n    // satisfy Babylon's hasOwnProperty guard.\n    // `Object.hasOwn`/`in` report false negatives here: jest-environment-node's sandbox global is\n    // a Proxy over a vm context, and reads of freshly-added properties from outside the sandbox\n    // (as this constructor runs) don't go through the fast path those use. getOwnPropertyNames is\n    // unaffected, so use that instead.\n    const nativeAdded = !Object.getOwnPropertyNames(this.global).includes('_native');\n    if (nativeAdded) {\n      Object.defineProperty(this.global, '_native', {\n        value: undefined,\n        writable: true,\n        configurable: true,\n        enumerable: false,\n      });\n    }\n    // Jest always populates `testEnvironmentOptions` (defaulting to `{}`) by the time a real\n    // config reaches an environment; `super()` above already relies on that itself.\n    const options = config.projectConfig.testEnvironmentOptions as WebglNodeOptions;\n    const names = ensureHostDOM(options);\n    const g = this.global as unknown as Record<string, unknown>;\n    this.added = names.filter((key) => !(key in g));\n    for (const key of this.added) g[key] = (globalThis as unknown as Record<string, unknown>)[key];\n    if (nativeAdded) this.added.push('_native');\n    g.window = g;\n    g.self = g;\n    // node-webgl's window/document have no event methods; engines like Babylon.js register\n    // resize/blur listeners on them. installDOM() always installs both, so both are present here.\n    for (const target of [g.window, g.document] as Record<string, unknown>[]) {\n      target.addEventListener ??= () => {};\n      target.removeEventListener ??= () => {};\n    }\n  }\n\n  override async teardown(): Promise<void> {\n    const g = this.global as unknown as Record<string, unknown>;\n    for (const key of this.added) delete g[key];\n    await super.teardown();\n  }\n}\n"],"mappings":";;;;;;;AAoBA,IAAI;AAEJ,SAAS,cAAc,SAA8C;CACnE,IAAI,UAAU,OAAO;CACrB,MAAM,EAAE,SAAS,KAAK,GAAG,QAAQ;CACjC,IAAI,WAAW,KAAK,CAAA,GAAA,sBAAA,KAAA,CAAK;EAAE;EAAS;CAAI,CAAC;CACzC,MAAM,SAAS,IAAI,IAAI,OAAO,oBAAoB,UAAU,CAAC;CAC7D,CAAA,GAAA,sBAAA,WAAA,CAAW,GAAG;CACd,WAAW,OAAO,oBAAoB,UAAU,CAAC,CAAC,QAAQ,QAAQ,CAAC,OAAO,IAAI,GAAG,CAAC;CAClF,OAAO;AACT;AAEA,IAAqB,mBAArB,cAA8CA,sBAAAA,gBAAgB;CAC5D;CAEA,YAAY,QAA+B,SAA6B;EACtE,MAAM,QAAQ,OAAO;EAQrB,MAAM,cAAc,CAAC,OAAO,oBAAoB,KAAK,MAAM,CAAC,CAAC,SAAS,SAAS;EAC/E,IAAI,aACF,OAAO,eAAe,KAAK,QAAQ,WAAW;GAC5C,OAAO,KAAA;GACP,UAAU;GACV,cAAc;GACd,YAAY;EACd,CAAC;EAIH,MAAM,UAAU,OAAO,cAAc;EACrC,MAAM,QAAQ,cAAc,OAAO;EACnC,MAAM,IAAI,KAAK;EACf,KAAK,QAAQ,MAAM,QAAQ,QAAQ,EAAE,OAAO,EAAE;EAC9C,KAAK,MAAM,OAAO,KAAK,OAAO,EAAE,OAAQ,WAAkD;EAC1F,IAAI,aAAa,KAAK,MAAM,KAAK,SAAS;EAC1C,EAAE,SAAS;EACX,EAAE,OAAO;EAGT,KAAK,MAAM,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAgC;GACxE,OAAO,2BAA2B,CAAC;GACnC,OAAO,8BAA8B,CAAC;EACxC;CACF;CAEA,MAAe,WAA0B;EACvC,MAAM,IAAI,KAAK;EACf,KAAK,MAAM,OAAO,KAAK,OAAO,OAAO,EAAE;EACvC,MAAM,MAAM,SAAS;CACvB;AACF"}
+{"version":3,"file":"index.cjs","names":["nodeWebGL","fileURLToPath","resolvePath","readFile","extname","TestEnvironment"],"sources":["../src/index.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { extname, resolve as resolvePath } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport * as nodeWebGL from '@onirenaud/node-webgl';\nimport type { InitOptions, InstallDOMOptions } from '@onirenaud/node-webgl';\nimport { TestEnvironment } from 'jest-environment-node';\n\n/** Set under `testEnvironmentOptions` in your Jest config. */\nexport type WebglNodeOptions = InitOptions & InstallDOMOptions;\n\ntype JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];\ntype EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];\ntype Sandbox = Record<string, unknown>;\n\nconst WEBGL_OPTION_NAMES = new Set([\n  'api',\n  'backend',\n  'baseDir',\n  'devicePixelRatio',\n  'fetch',\n  'frameInterval',\n  'innerHeight',\n  'innerWidth',\n]);\n\nconst MIME: Record<string, string> = {\n  '.basis': 'application/octet-stream',\n  '.bin': 'application/octet-stream',\n  '.drc': 'application/octet-stream',\n  '.exr': 'image/x-exr',\n  '.fbx': 'application/octet-stream',\n  '.gif': 'image/gif',\n  '.glb': 'model/gltf-binary',\n  '.gltf': 'model/gltf+json',\n  '.hdr': 'image/vnd.radiance',\n  '.jpeg': 'image/jpeg',\n  '.jpg': 'image/jpeg',\n  '.js': 'text/javascript',\n  '.json': 'application/json',\n  '.ktx': 'image/ktx',\n  '.ktx2': 'image/ktx2',\n  '.mjs': 'text/javascript',\n  '.mtl': 'text/plain',\n  '.obj': 'text/plain',\n  '.png': 'image/png',\n  '.svg': 'image/svg+xml',\n  '.txt': 'text/plain',\n  '.wasm': 'application/wasm',\n  '.webp': 'image/webp',\n};\n\nconst DOM_NAMES = [\n  'window',\n  'self',\n  'HTMLCanvasElement',\n  'OffscreenCanvas',\n  'HTMLImageElement',\n  'Image',\n  'ImageData',\n  'ImageBitmap',\n  'createImageBitmap',\n  'FileReader',\n  'HTMLElement',\n  'Element',\n  'Node',\n  'devicePixelRatio',\n  'innerWidth',\n  'innerHeight',\n  'screen',\n  'requestAnimationFrame',\n  'cancelAnimationFrame',\n  'getComputedStyle',\n  'matchMedia',\n  'scrollTo',\n  'alert',\n  'location',\n  'document',\n  ...Object.keys(nodeWebGL).filter((name) => name.startsWith('WebGL')),\n] as const;\n\nlet initializedWith: InitOptions | undefined;\n\n/**\n * The native EGL display is process-wide and node-webgl's `init()` is a no-op once it exists (the first\n * context creates it lazily), so compare explicit options against the live display rather than only\n * against what this module itself initialized.\n */\nfunction initialize({ api, backend }: InitOptions): void {\n  if (!api && !backend) return;\n  if (initializedWith && initializedWith.api === api && initializedWith.backend === backend) return;\n  const display = nodeWebGL.getDisplayInfo();\n  const mismatch =\n    display &&\n    ((backend && backend !== 'default' && backend !== display.backend) ||\n      (api && api !== 'auto' && api !== display.api));\n  if (mismatch) {\n    throw new Error(\n      `node-webgl is already initialized with ${JSON.stringify({ api: display.api, backend: display.backend })}; ` +\n        `cannot switch this Jest worker to ${JSON.stringify({ api, backend })}`,\n    );\n  }\n  nodeWebGL.init({ api, backend });\n  initializedWith = { api, backend };\n}\n\n/** Capture a fresh node-webgl DOM while restoring every host descriptor after installation. */\nfunction createDOM(options: InstallDOMOptions): Map<string, PropertyDescriptor> {\n  const before = Object.getOwnPropertyDescriptors(globalThis);\n  for (const name of DOM_NAMES) Reflect.deleteProperty(globalThis, name);\n\n  try {\n    nodeWebGL.installDOM({ ...options, fetch: false });\n    const after = Object.getOwnPropertyDescriptors(globalThis);\n    return new Map(\n      DOM_NAMES.flatMap((name): [string, PropertyDescriptor][] => (after[name] ? [[name, after[name]]] : [])),\n    );\n  } finally {\n    for (const name of Object.getOwnPropertyNames(globalThis)) {\n      if (!(name in before)) Reflect.deleteProperty(globalThis, name);\n    }\n    Object.defineProperties(globalThis, before);\n  }\n}\n\nfunction environmentConfig(config: JestEnvironmentConfig): JestEnvironmentConfig {\n  return {\n    ...config,\n    projectConfig: {\n      ...config.projectConfig,\n      testEnvironmentOptions: Object.fromEntries(\n        Object.entries(config.projectConfig.testEnvironmentOptions).filter(([name]) => !WEBGL_OPTION_NAMES.has(name)),\n      ),\n    },\n  };\n}\n\nfunction localFetch(baseDir: string, nativeFetch: typeof fetch): typeof fetch {\n  return async (input: string | URL | Request, init?: RequestInit): Promise<Response> => {\n    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n    if (/^(https?|data|blob):/i.test(url)) return nativeFetch(input, init);\n    const path = url.startsWith('file:') ? fileURLToPath(url) : resolvePath(baseDir, url.replace(/[?#].*$/, ''));\n    try {\n      const bytes = await readFile(path);\n      return new Response(bytes, {\n        status: 200,\n        headers: { 'content-type': MIME[extname(path).toLowerCase()] ?? 'application/octet-stream' },\n      });\n    } catch {\n      return new Response(null, { status: 404, statusText: 'Not Found' });\n    }\n  };\n}\n\nexport default class WebglEnvironment extends TestEnvironment {\n  private readonly added: string[] = [];\n  private readonly animationFrames = new Map<ReturnType<typeof setTimeout>, typeof clearTimeout>();\n\n  constructor(config: JestEnvironmentConfig, context: EnvironmentContext) {\n    const options = config.projectConfig.testEnvironmentOptions as WebglNodeOptions;\n    super(environmentConfig(config), context);\n\n    const { api, backend, ...domOptions } = options;\n    initialize({ api, backend });\n\n    const g = this.global as unknown as Sandbox;\n    const nativeAdded = !Object.getOwnPropertyNames(g).includes('_native');\n    if (nativeAdded) {\n      Object.defineProperty(g, '_native', {\n        value: undefined,\n        writable: true,\n        configurable: true,\n        enumerable: false,\n      });\n      this.added.push('_native');\n    }\n\n    for (const [name, descriptor] of createDOM(domOptions)) {\n      if (!(name in g)) this.added.push(name);\n      Object.defineProperty(g, name, descriptor);\n    }\n\n    g.window = g;\n    g.self = g;\n    (g.document as Record<string, unknown>).defaultView = g;\n\n    const events = new EventTarget();\n    g.addEventListener = events.addEventListener.bind(events);\n    g.removeEventListener = events.removeEventListener.bind(events);\n    g.dispatchEvent = events.dispatchEvent.bind(events);\n    this.added.push('addEventListener', 'removeEventListener', 'dispatchEvent');\n\n    const interval = domOptions.frameInterval ?? 16;\n    g.requestAnimationFrame = (callback: (time: number) => void) => {\n      const id = (g.setTimeout as typeof setTimeout)(() => {\n        this.animationFrames.delete(id);\n        callback((g.performance as { now(): number }).now());\n      }, interval);\n      this.animationFrames.set(id, g.clearTimeout as typeof clearTimeout);\n      return id;\n    };\n    g.cancelAnimationFrame = (id: ReturnType<typeof setTimeout>) => {\n      const clear = this.animationFrames.get(id);\n      this.animationFrames.delete(id);\n      (clear ?? (g.clearTimeout as typeof clearTimeout))(id);\n    };\n\n    const nativeFetch = globalThis.fetch.bind(globalThis);\n    g.fetch = domOptions.fetch === false ? nativeFetch : localFetch(domOptions.baseDir ?? process.cwd(), nativeFetch);\n  }\n\n  override async teardown(): Promise<void> {\n    const g = this.global as unknown as Sandbox;\n    for (const [id, clear] of this.animationFrames) clear(id);\n    this.animationFrames.clear();\n    for (const key of this.added) delete g[key];\n    await super.teardown();\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -7,6 +7,7 @@ type JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];
 type EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];
 export default class WebglEnvironment extends TestEnvironment {
   private readonly added;
+  private readonly animationFrames;
   constructor(config: JestEnvironmentConfig, context: EnvironmentContext);
   teardown(): Promise<void>;
 }

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;YAIY,mBAAmB,cAAc;KAKxC,wBAAwB,6BAA6B;KACrD,qBAAqB,6BAA6B;qBAsBlC,yBAAyB;mBAC3B;EAEjB,YAAY,QAAQ,uBAAuB,SAAS;EAoCrC,YAAY"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;YAQY,mBAAmB,cAAc;KAExC,wBAAwB,6BAA6B;KACrD,qBAAqB,6BAA6B;qBA8IlC,yBAAyB;mBAC3B;mBACA;EAEjB,YAAY,QAAQ,uBAAuB,SAAS;EAqDrC,YAAY"}

package/dist/index.d.mts

@@ -7,6 +7,7 @@ type JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];
 type EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];
 export default class WebglEnvironment extends TestEnvironment {
   private readonly added;
+  private readonly animationFrames;
   constructor(config: JestEnvironmentConfig, context: EnvironmentContext);
   teardown(): Promise<void>;
 }

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;YAIY,mBAAmB,cAAc;KAKxC,wBAAwB,6BAA6B;KACrD,qBAAqB,6BAA6B;qBAsBlC,yBAAyB;mBAC3B;EAEjB,YAAY,QAAQ,uBAAuB,SAAS;EAoCrC,YAAY"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;YAQY,mBAAmB,cAAc;KAExC,wBAAwB,6BAA6B;KACrD,qBAAqB,6BAA6B;qBA8IlC,yBAAyB;mBAC3B;mBACA;EAEjB,YAAY,QAAQ,uBAAuB,SAAS;EAqDrC,YAAY"}

package/dist/index.mjs

@@ -1,45 +1,196 @@
-import { init, installDOM } from "@onirenaud/node-webgl";
+import { readFile } from "node:fs/promises";
+import { extname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import * as nodeWebGL from "@onirenaud/node-webgl";
 import { TestEnvironment } from "jest-environment-node";
 //#region src/index.ts
-let domNames;
-function ensureHostDOM(options) {
-	if (domNames) return domNames;
-	const { backend, api, ...dom } = options;
-	if (backend || api) init({
-		backend,
-		api
+const WEBGL_OPTION_NAMES = /* @__PURE__ */ new Set([
+	"api",
+	"backend",
+	"baseDir",
+	"devicePixelRatio",
+	"fetch",
+	"frameInterval",
+	"innerHeight",
+	"innerWidth"
+]);
+const MIME = {
+	".basis": "application/octet-stream",
+	".bin": "application/octet-stream",
+	".drc": "application/octet-stream",
+	".exr": "image/x-exr",
+	".fbx": "application/octet-stream",
+	".gif": "image/gif",
+	".glb": "model/gltf-binary",
+	".gltf": "model/gltf+json",
+	".hdr": "image/vnd.radiance",
+	".jpeg": "image/jpeg",
+	".jpg": "image/jpeg",
+	".js": "text/javascript",
+	".json": "application/json",
+	".ktx": "image/ktx",
+	".ktx2": "image/ktx2",
+	".mjs": "text/javascript",
+	".mtl": "text/plain",
+	".obj": "text/plain",
+	".png": "image/png",
+	".svg": "image/svg+xml",
+	".txt": "text/plain",
+	".wasm": "application/wasm",
+	".webp": "image/webp"
+};
+const DOM_NAMES = [
+	"window",
+	"self",
+	"HTMLCanvasElement",
+	"OffscreenCanvas",
+	"HTMLImageElement",
+	"Image",
+	"ImageData",
+	"ImageBitmap",
+	"createImageBitmap",
+	"FileReader",
+	"HTMLElement",
+	"Element",
+	"Node",
+	"devicePixelRatio",
+	"innerWidth",
+	"innerHeight",
+	"screen",
+	"requestAnimationFrame",
+	"cancelAnimationFrame",
+	"getComputedStyle",
+	"matchMedia",
+	"scrollTo",
+	"alert",
+	"location",
+	"document",
+	...Object.keys(nodeWebGL).filter((name) => name.startsWith("WebGL"))
+];
+let initializedWith;
+/**
+* The native EGL display is process-wide and node-webgl's `init()` is a no-op once it exists (the first
+* context creates it lazily), so compare explicit options against the live display rather than only
+* against what this module itself initialized.
+*/
+function initialize({ api, backend }) {
+	if (!api && !backend) return;
+	if (initializedWith && initializedWith.api === api && initializedWith.backend === backend) return;
+	const display = nodeWebGL.getDisplayInfo();
+	if (display && (backend && backend !== "default" && backend !== display.backend || api && api !== "auto" && api !== display.api)) throw new Error(`node-webgl is already initialized with ${JSON.stringify({
+		api: display.api,
+		backend: display.backend
+	})}; cannot switch this Jest worker to ${JSON.stringify({
+		api,
+		backend
+	})}`);
+	nodeWebGL.init({
+		api,
+		backend
 	});
-	const before = new Set(Object.getOwnPropertyNames(globalThis));
-	installDOM(dom);
-	domNames = Object.getOwnPropertyNames(globalThis).filter((key) => !before.has(key));
-	return domNames;
+	initializedWith = {
+		api,
+		backend
+	};
+}
+/** Capture a fresh node-webgl DOM while restoring every host descriptor after installation. */
+function createDOM(options) {
+	const before = Object.getOwnPropertyDescriptors(globalThis);
+	for (const name of DOM_NAMES) Reflect.deleteProperty(globalThis, name);
+	try {
+		nodeWebGL.installDOM({
+			...options,
+			fetch: false
+		});
+		const after = Object.getOwnPropertyDescriptors(globalThis);
+		return new Map(DOM_NAMES.flatMap((name) => after[name] ? [[name, after[name]]] : []));
+	} finally {
+		for (const name of Object.getOwnPropertyNames(globalThis)) if (!(name in before)) Reflect.deleteProperty(globalThis, name);
+		Object.defineProperties(globalThis, before);
+	}
+}
+function environmentConfig(config) {
+	return {
+		...config,
+		projectConfig: {
+			...config.projectConfig,
+			testEnvironmentOptions: Object.fromEntries(Object.entries(config.projectConfig.testEnvironmentOptions).filter(([name]) => !WEBGL_OPTION_NAMES.has(name)))
+		}
+	};
+}
+function localFetch(baseDir, nativeFetch) {
+	return async (input, init) => {
+		const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+		if (/^(https?|data|blob):/i.test(url)) return nativeFetch(input, init);
+		const path = url.startsWith("file:") ? fileURLToPath(url) : resolve(baseDir, url.replace(/[?#].*$/, ""));
+		try {
+			const bytes = await readFile(path);
+			return new Response(bytes, {
+				status: 200,
+				headers: { "content-type": MIME[extname(path).toLowerCase()] ?? "application/octet-stream" }
+			});
+		} catch {
+			return new Response(null, {
+				status: 404,
+				statusText: "Not Found"
+			});
+		}
+	};
 }
 var WebglEnvironment = class extends TestEnvironment {
-	added;
+	added = [];
+	animationFrames = /* @__PURE__ */ new Map();
 	constructor(config, context) {
-		super(config, context);
-		const nativeAdded = !Object.getOwnPropertyNames(this.global).includes("_native");
-		if (nativeAdded) Object.defineProperty(this.global, "_native", {
-			value: void 0,
-			writable: true,
-			configurable: true,
-			enumerable: false
-		});
 		const options = config.projectConfig.testEnvironmentOptions;
-		const names = ensureHostDOM(options);
+		super(environmentConfig(config), context);
+		const { api, backend, ...domOptions } = options;
+		initialize({
+			api,
+			backend
+		});
 		const g = this.global;
-		this.added = names.filter((key) => !(key in g));
-		for (const key of this.added) g[key] = globalThis[key];
-		if (nativeAdded) this.added.push("_native");
+		if (!Object.getOwnPropertyNames(g).includes("_native")) {
+			Object.defineProperty(g, "_native", {
+				value: void 0,
+				writable: true,
+				configurable: true,
+				enumerable: false
+			});
+			this.added.push("_native");
+		}
+		for (const [name, descriptor] of createDOM(domOptions)) {
+			if (!(name in g)) this.added.push(name);
+			Object.defineProperty(g, name, descriptor);
+		}
 		g.window = g;
 		g.self = g;
-		for (const target of [g.window, g.document]) {
-			target.addEventListener ??= () => {};
-			target.removeEventListener ??= () => {};
-		}
+		g.document.defaultView = g;
+		const events = new EventTarget();
+		g.addEventListener = events.addEventListener.bind(events);
+		g.removeEventListener = events.removeEventListener.bind(events);
+		g.dispatchEvent = events.dispatchEvent.bind(events);
+		this.added.push("addEventListener", "removeEventListener", "dispatchEvent");
+		const interval = domOptions.frameInterval ?? 16;
+		g.requestAnimationFrame = (callback) => {
+			const id = g.setTimeout(() => {
+				this.animationFrames.delete(id);
+				callback(g.performance.now());
+			}, interval);
+			this.animationFrames.set(id, g.clearTimeout);
+			return id;
+		};
+		g.cancelAnimationFrame = (id) => {
+			const clear = this.animationFrames.get(id);
+			this.animationFrames.delete(id);
+			(clear ?? g.clearTimeout)(id);
+		};
+		const nativeFetch = globalThis.fetch.bind(globalThis);
+		g.fetch = domOptions.fetch === false ? nativeFetch : localFetch(domOptions.baseDir ?? process.cwd(), nativeFetch);
 	}
 	async teardown() {
 		const g = this.global;
+		for (const [id, clear] of this.animationFrames) clear(id);
+		this.animationFrames.clear();
 		for (const key of this.added) delete g[key];
 		await super.teardown();
 	}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { init, installDOM, type InitOptions, type InstallDOMOptions } from '@onirenaud/node-webgl';\nimport { TestEnvironment } from 'jest-environment-node';\n\n/** Set under `testEnvironmentOptions` in your Jest config. */\nexport type WebglNodeOptions = InitOptions & InstallDOMOptions;\n\n// Typed from TestEnvironment's own constructor rather than importing `@jest/environment`\n// directly: that package is only a transitive dependency (of jest-environment-node), not\n// resolvable from this package's own node_modules under pnpm's strict layout.\ntype JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];\ntype EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];\n\n// node-webgl's installDOM() writes to the HOST globalThis (not a target you pass in) and is\n// idempotent (it skips names already defined). So it can only usefully run once per process: on\n// the first WebglEnvironment constructed here, snapshot the host globals before/after the call and\n// remember which names it added. Every later environment (this test file or another one sharing\n// the worker) copies that same fixed list into its own sandbox global instead of calling\n// installDOM() again. This means only the FIRST test file's `testEnvironmentOptions` actually\n// affect the host install (backend/api selection, DOM option defaults); later test files'\n// options for those are ignored, matching how node-webgl itself behaves.\nlet domNames: readonly string[] | undefined;\n\nfunction ensureHostDOM(options: WebglNodeOptions): readonly string[] {\n  if (domNames) return domNames;\n  const { backend, api, ...dom } = options;\n  if (backend || api) init({ backend, api });\n  const before = new Set(Object.getOwnPropertyNames(globalThis));\n  installDOM(dom);\n  domNames = Object.getOwnPropertyNames(globalThis).filter((key) => !before.has(key));\n  return domNames;\n}\n\nexport default class WebglEnvironment extends TestEnvironment {\n  private readonly added: string[];\n\n  constructor(config: JestEnvironmentConfig, context: EnvironmentContext) {\n    super(config, context);\n    // @babylonjs/core defines a `_native` accessor on `self` at module load; on Jest's proxied\n    // sandbox global that defineProperty violates a proxy invariant, so pre-seed the property to\n    // satisfy Babylon's hasOwnProperty guard.\n    // `Object.hasOwn`/`in` report false negatives here: jest-environment-node's sandbox global is\n    // a Proxy over a vm context, and reads of freshly-added properties from outside the sandbox\n    // (as this constructor runs) don't go through the fast path those use. getOwnPropertyNames is\n    // unaffected, so use that instead.\n    const nativeAdded = !Object.getOwnPropertyNames(this.global).includes('_native');\n    if (nativeAdded) {\n      Object.defineProperty(this.global, '_native', {\n        value: undefined,\n        writable: true,\n        configurable: true,\n        enumerable: false,\n      });\n    }\n    // Jest always populates `testEnvironmentOptions` (defaulting to `{}`) by the time a real\n    // config reaches an environment; `super()` above already relies on that itself.\n    const options = config.projectConfig.testEnvironmentOptions as WebglNodeOptions;\n    const names = ensureHostDOM(options);\n    const g = this.global as unknown as Record<string, unknown>;\n    this.added = names.filter((key) => !(key in g));\n    for (const key of this.added) g[key] = (globalThis as unknown as Record<string, unknown>)[key];\n    if (nativeAdded) this.added.push('_native');\n    g.window = g;\n    g.self = g;\n    // node-webgl's window/document have no event methods; engines like Babylon.js register\n    // resize/blur listeners on them. installDOM() always installs both, so both are present here.\n    for (const target of [g.window, g.document] as Record<string, unknown>[]) {\n      target.addEventListener ??= () => {};\n      target.removeEventListener ??= () => {};\n    }\n  }\n\n  override async teardown(): Promise<void> {\n    const g = this.global as unknown as Record<string, unknown>;\n    for (const key of this.added) delete g[key];\n    await super.teardown();\n  }\n}\n"],"mappings":";;;AAoBA,IAAI;AAEJ,SAAS,cAAc,SAA8C;CACnE,IAAI,UAAU,OAAO;CACrB,MAAM,EAAE,SAAS,KAAK,GAAG,QAAQ;CACjC,IAAI,WAAW,KAAK,KAAK;EAAE;EAAS;CAAI,CAAC;CACzC,MAAM,SAAS,IAAI,IAAI,OAAO,oBAAoB,UAAU,CAAC;CAC7D,WAAW,GAAG;CACd,WAAW,OAAO,oBAAoB,UAAU,CAAC,CAAC,QAAQ,QAAQ,CAAC,OAAO,IAAI,GAAG,CAAC;CAClF,OAAO;AACT;AAEA,IAAqB,mBAArB,cAA8C,gBAAgB;CAC5D;CAEA,YAAY,QAA+B,SAA6B;EACtE,MAAM,QAAQ,OAAO;EAQrB,MAAM,cAAc,CAAC,OAAO,oBAAoB,KAAK,MAAM,CAAC,CAAC,SAAS,SAAS;EAC/E,IAAI,aACF,OAAO,eAAe,KAAK,QAAQ,WAAW;GAC5C,OAAO,KAAA;GACP,UAAU;GACV,cAAc;GACd,YAAY;EACd,CAAC;EAIH,MAAM,UAAU,OAAO,cAAc;EACrC,MAAM,QAAQ,cAAc,OAAO;EACnC,MAAM,IAAI,KAAK;EACf,KAAK,QAAQ,MAAM,QAAQ,QAAQ,EAAE,OAAO,EAAE;EAC9C,KAAK,MAAM,OAAO,KAAK,OAAO,EAAE,OAAQ,WAAkD;EAC1F,IAAI,aAAa,KAAK,MAAM,KAAK,SAAS;EAC1C,EAAE,SAAS;EACX,EAAE,OAAO;EAGT,KAAK,MAAM,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAgC;GACxE,OAAO,2BAA2B,CAAC;GACnC,OAAO,8BAA8B,CAAC;EACxC;CACF;CAEA,MAAe,WAA0B;EACvC,MAAM,IAAI,KAAK;EACf,KAAK,MAAM,OAAO,KAAK,OAAO,OAAO,EAAE;EACvC,MAAM,MAAM,SAAS;CACvB;AACF"}
+{"version":3,"file":"index.mjs","names":["resolvePath"],"sources":["../src/index.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { extname, resolve as resolvePath } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport * as nodeWebGL from '@onirenaud/node-webgl';\nimport type { InitOptions, InstallDOMOptions } from '@onirenaud/node-webgl';\nimport { TestEnvironment } from 'jest-environment-node';\n\n/** Set under `testEnvironmentOptions` in your Jest config. */\nexport type WebglNodeOptions = InitOptions & InstallDOMOptions;\n\ntype JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];\ntype EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];\ntype Sandbox = Record<string, unknown>;\n\nconst WEBGL_OPTION_NAMES = new Set([\n  'api',\n  'backend',\n  'baseDir',\n  'devicePixelRatio',\n  'fetch',\n  'frameInterval',\n  'innerHeight',\n  'innerWidth',\n]);\n\nconst MIME: Record<string, string> = {\n  '.basis': 'application/octet-stream',\n  '.bin': 'application/octet-stream',\n  '.drc': 'application/octet-stream',\n  '.exr': 'image/x-exr',\n  '.fbx': 'application/octet-stream',\n  '.gif': 'image/gif',\n  '.glb': 'model/gltf-binary',\n  '.gltf': 'model/gltf+json',\n  '.hdr': 'image/vnd.radiance',\n  '.jpeg': 'image/jpeg',\n  '.jpg': 'image/jpeg',\n  '.js': 'text/javascript',\n  '.json': 'application/json',\n  '.ktx': 'image/ktx',\n  '.ktx2': 'image/ktx2',\n  '.mjs': 'text/javascript',\n  '.mtl': 'text/plain',\n  '.obj': 'text/plain',\n  '.png': 'image/png',\n  '.svg': 'image/svg+xml',\n  '.txt': 'text/plain',\n  '.wasm': 'application/wasm',\n  '.webp': 'image/webp',\n};\n\nconst DOM_NAMES = [\n  'window',\n  'self',\n  'HTMLCanvasElement',\n  'OffscreenCanvas',\n  'HTMLImageElement',\n  'Image',\n  'ImageData',\n  'ImageBitmap',\n  'createImageBitmap',\n  'FileReader',\n  'HTMLElement',\n  'Element',\n  'Node',\n  'devicePixelRatio',\n  'innerWidth',\n  'innerHeight',\n  'screen',\n  'requestAnimationFrame',\n  'cancelAnimationFrame',\n  'getComputedStyle',\n  'matchMedia',\n  'scrollTo',\n  'alert',\n  'location',\n  'document',\n  ...Object.keys(nodeWebGL).filter((name) => name.startsWith('WebGL')),\n] as const;\n\nlet initializedWith: InitOptions | undefined;\n\n/**\n * The native EGL display is process-wide and node-webgl's `init()` is a no-op once it exists (the first\n * context creates it lazily), so compare explicit options against the live display rather than only\n * against what this module itself initialized.\n */\nfunction initialize({ api, backend }: InitOptions): void {\n  if (!api && !backend) return;\n  if (initializedWith && initializedWith.api === api && initializedWith.backend === backend) return;\n  const display = nodeWebGL.getDisplayInfo();\n  const mismatch =\n    display &&\n    ((backend && backend !== 'default' && backend !== display.backend) ||\n      (api && api !== 'auto' && api !== display.api));\n  if (mismatch) {\n    throw new Error(\n      `node-webgl is already initialized with ${JSON.stringify({ api: display.api, backend: display.backend })}; ` +\n        `cannot switch this Jest worker to ${JSON.stringify({ api, backend })}`,\n    );\n  }\n  nodeWebGL.init({ api, backend });\n  initializedWith = { api, backend };\n}\n\n/** Capture a fresh node-webgl DOM while restoring every host descriptor after installation. */\nfunction createDOM(options: InstallDOMOptions): Map<string, PropertyDescriptor> {\n  const before = Object.getOwnPropertyDescriptors(globalThis);\n  for (const name of DOM_NAMES) Reflect.deleteProperty(globalThis, name);\n\n  try {\n    nodeWebGL.installDOM({ ...options, fetch: false });\n    const after = Object.getOwnPropertyDescriptors(globalThis);\n    return new Map(\n      DOM_NAMES.flatMap((name): [string, PropertyDescriptor][] => (after[name] ? [[name, after[name]]] : [])),\n    );\n  } finally {\n    for (const name of Object.getOwnPropertyNames(globalThis)) {\n      if (!(name in before)) Reflect.deleteProperty(globalThis, name);\n    }\n    Object.defineProperties(globalThis, before);\n  }\n}\n\nfunction environmentConfig(config: JestEnvironmentConfig): JestEnvironmentConfig {\n  return {\n    ...config,\n    projectConfig: {\n      ...config.projectConfig,\n      testEnvironmentOptions: Object.fromEntries(\n        Object.entries(config.projectConfig.testEnvironmentOptions).filter(([name]) => !WEBGL_OPTION_NAMES.has(name)),\n      ),\n    },\n  };\n}\n\nfunction localFetch(baseDir: string, nativeFetch: typeof fetch): typeof fetch {\n  return async (input: string | URL | Request, init?: RequestInit): Promise<Response> => {\n    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n    if (/^(https?|data|blob):/i.test(url)) return nativeFetch(input, init);\n    const path = url.startsWith('file:') ? fileURLToPath(url) : resolvePath(baseDir, url.replace(/[?#].*$/, ''));\n    try {\n      const bytes = await readFile(path);\n      return new Response(bytes, {\n        status: 200,\n        headers: { 'content-type': MIME[extname(path).toLowerCase()] ?? 'application/octet-stream' },\n      });\n    } catch {\n      return new Response(null, { status: 404, statusText: 'Not Found' });\n    }\n  };\n}\n\nexport default class WebglEnvironment extends TestEnvironment {\n  private readonly added: string[] = [];\n  private readonly animationFrames = new Map<ReturnType<typeof setTimeout>, typeof clearTimeout>();\n\n  constructor(config: JestEnvironmentConfig, context: EnvironmentContext) {\n    const options = config.projectConfig.testEnvironmentOptions as WebglNodeOptions;\n    super(environmentConfig(config), context);\n\n    const { api, backend, ...domOptions } = options;\n    initialize({ api, backend });\n\n    const g = this.global as unknown as Sandbox;\n    const nativeAdded = !Object.getOwnPropertyNames(g).includes('_native');\n    if (nativeAdded) {\n      Object.defineProperty(g, '_native', {\n        value: undefined,\n        writable: true,\n        configurable: true,\n        enumerable: false,\n      });\n      this.added.push('_native');\n    }\n\n    for (const [name, descriptor] of createDOM(domOptions)) {\n      if (!(name in g)) this.added.push(name);\n      Object.defineProperty(g, name, descriptor);\n    }\n\n    g.window = g;\n    g.self = g;\n    (g.document as Record<string, unknown>).defaultView = g;\n\n    const events = new EventTarget();\n    g.addEventListener = events.addEventListener.bind(events);\n    g.removeEventListener = events.removeEventListener.bind(events);\n    g.dispatchEvent = events.dispatchEvent.bind(events);\n    this.added.push('addEventListener', 'removeEventListener', 'dispatchEvent');\n\n    const interval = domOptions.frameInterval ?? 16;\n    g.requestAnimationFrame = (callback: (time: number) => void) => {\n      const id = (g.setTimeout as typeof setTimeout)(() => {\n        this.animationFrames.delete(id);\n        callback((g.performance as { now(): number }).now());\n      }, interval);\n      this.animationFrames.set(id, g.clearTimeout as typeof clearTimeout);\n      return id;\n    };\n    g.cancelAnimationFrame = (id: ReturnType<typeof setTimeout>) => {\n      const clear = this.animationFrames.get(id);\n      this.animationFrames.delete(id);\n      (clear ?? (g.clearTimeout as typeof clearTimeout))(id);\n    };\n\n    const nativeFetch = globalThis.fetch.bind(globalThis);\n    g.fetch = domOptions.fetch === false ? nativeFetch : localFetch(domOptions.baseDir ?? process.cwd(), nativeFetch);\n  }\n\n  override async teardown(): Promise<void> {\n    const g = this.global as unknown as Sandbox;\n    for (const [id, clear] of this.animationFrames) clear(id);\n    this.animationFrames.clear();\n    for (const key of this.added) delete g[key];\n    await super.teardown();\n  }\n}\n"],"mappings":"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"}

package/globals.d.ts

@@ -48,6 +48,6 @@ declare global {
   var createImageBitmap: typeof nodeCreateImageBitmap;
   var WebGLRenderingContext: typeof NodeWebGLRenderingContext;
   var WebGL2RenderingContext: typeof NodeWebGL2RenderingContext;
-  function requestAnimationFrame(callback: (time: number) => void): number;
-  function cancelAnimationFrame(handle: number): void;
+  function requestAnimationFrame(callback: (time: number) => void): ReturnType<typeof setTimeout>;
+  function cancelAnimationFrame(handle: ReturnType<typeof setTimeout>): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jest-environment-webgl-node",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Jest environment that provides real headless WebGL 1/2 (ANGLE via @onirenaud/node-webgl) in Node",
   "keywords": [
     "headless",