jest-environment-webgl-node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ben Houston
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# jest-environment-webgl-node
+
+Real, headless WebGL 1 and WebGL 2 inside Jest, with no browser. Powered by
+[`@onirenaud/node-webgl`](https://github.com/RenaudRohlinger/node-webgl) (Chrome's ANGLE, statically linked).
+
+The environment installs `window`, `document`, `HTMLCanvasElement`, `Image`, `requestAnimationFrame`,
+the `WebGL*` classes and a file-reading `fetch()` on the test's sandbox global, and removes them
+after the test file finishes. `document.createElement('canvas').getContext('webgl2')` returns a
+GPU-backed context, so three.js, regl, pixi and plain WebGL code run unchanged.
+
+## Install
+
+```sh
+pnpm add -D jest jest-environment-webgl-node
+```
+
+## Usage
+
+```js
+// jest.config.mjs
+export default {
+  testEnvironment: 'jest-environment-webgl-node',
+  testEnvironmentOptions: { backend: 'swiftshader', innerWidth: 800, innerHeight: 600 },
+};
+```
+
+```ts
+import * as THREE from 'three';
+import { expect, it } from '@jest/globals';
+
+it('renders', () => {
+  const canvas = document.createElement('canvas');
+  const renderer = new THREE.WebGLRenderer({ canvas });
+  renderer.setSize(64, 64, false);
+  renderer.render(new THREE.Scene(), new THREE.PerspectiveCamera());
+
+  const gl = renderer.getContext();
+  const pixels = new Uint8Array(4);
+  gl.readPixels(32, 32, 1, 1, gl.RGBA, gl.UNSIGNED_BYTE, pixels);
+  expect(pixels[3]).toBe(255);
+});
+```
+
+`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.
+
+Types for the installed globals: add `import 'jest-environment-webgl-node/globals';` to a `.d.ts`
+file your tsconfig includes.
+
+This package ships both an ESM and a CommonJS build, so `require('jest-environment-webgl-node')`
+works from a plain CommonJS test file. `NODE_OPTIONS=--experimental-vm-modules` is only needed when
+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.
+
+## Author
+
+Created by [Ben Houston](https://ben3d.ca) and sponsored by [Land of Assets](https://landofassets.com).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,54 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _onirenaud_node_webgl = require("@onirenaud/node-webgl");
+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 before = new Set(Object.getOwnPropertyNames(globalThis));
+	(0, _onirenaud_node_webgl.installDOM)(dom);
+	domNames = Object.getOwnPropertyNames(globalThis).filter((key) => !before.has(key));
+	return domNames;
+}
+var WebglEnvironment = class extends jest_environment_node.TestEnvironment {
+	added;
+	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);
+		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");
+		g.window = g;
+		g.self = g;
+		for (const target of [g.window, g.document]) {
+			target.addEventListener ??= () => {};
+			target.removeEventListener ??= () => {};
+		}
+	}
+	async teardown() {
+		const g = this.global;
+		for (const key of this.added) delete g[key];
+		await super.teardown();
+	}
+};
+//#endregion
+exports.default = WebglEnvironment;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"}

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+import { InitOptions, InstallDOMOptions } from "@onirenaud/node-webgl";
+import { TestEnvironment } from "jest-environment-node";
+//#region src/index.d.ts
+/** Set under `testEnvironmentOptions` in your Jest config. */
+export type WebglNodeOptions = InitOptions & InstallDOMOptions;
+type JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];
+type EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];
+export default class WebglEnvironment extends TestEnvironment {
+  private readonly added;
+  constructor(config: JestEnvironmentConfig, context: EnvironmentContext);
+  teardown(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +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"}

package/dist/index.d.mts

@@ -0,0 +1,14 @@
+import { InitOptions, InstallDOMOptions } from "@onirenaud/node-webgl";
+import { TestEnvironment } from "jest-environment-node";
+//#region src/index.d.ts
+/** Set under `testEnvironmentOptions` in your Jest config. */
+export type WebglNodeOptions = InitOptions & InstallDOMOptions;
+type JestEnvironmentConfig = ConstructorParameters<typeof TestEnvironment>[0];
+type EnvironmentContext = ConstructorParameters<typeof TestEnvironment>[1];
+export default class WebglEnvironment extends TestEnvironment {
+  private readonly added;
+  constructor(config: JestEnvironmentConfig, context: EnvironmentContext);
+  teardown(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +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"}

package/dist/index.mjs

@@ -0,0 +1,50 @@
+import { init, installDOM } 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 before = new Set(Object.getOwnPropertyNames(globalThis));
+	installDOM(dom);
+	domNames = Object.getOwnPropertyNames(globalThis).filter((key) => !before.has(key));
+	return domNames;
+}
+var WebglEnvironment = class extends TestEnvironment {
+	added;
+	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);
+		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");
+		g.window = g;
+		g.self = g;
+		for (const target of [g.window, g.document]) {
+			target.addEventListener ??= () => {};
+			target.removeEventListener ??= () => {};
+		}
+	}
+	async teardown() {
+		const g = this.global;
+		for (const key of this.added) delete g[key];
+		await super.teardown();
+	}
+};
+//#endregion
+export { WebglEnvironment as default };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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"}

package/globals.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Types for the globals `jest-environment-webgl-node` installs (node-webgl's `installDOM()`).
+ * Pull in with `import 'jest-environment-webgl-node/globals';` from a `.d.ts` your tsconfig includes.
+ */
+import type {
+  Canvas,
+  Image as NodeImage,
+  ImageBitmap as NodeImageBitmap,
+  ImageData as NodeImageData,
+  WebGL2RenderingContext as NodeWebGL2RenderingContext,
+  WebGLRenderingContext as NodeWebGLRenderingContext,
+  createImageBitmap as nodeCreateImageBitmap,
+} from '@onirenaud/node-webgl';
+
+type Listener = (type: string, listener: (event: unknown) => void, options?: unknown) => void;
+
+interface ShimDocument {
+  createElement(tag: 'canvas'): Canvas;
+  createElement(tag: 'img'): NodeImage;
+  createElement(tag: string): unknown;
+  createElementNS(namespace: string, tag: 'canvas'): Canvas;
+  createElementNS(namespace: string, tag: string): unknown;
+  addEventListener: Listener;
+  removeEventListener: Listener;
+}
+
+interface ShimWindow {
+  innerWidth: number;
+  innerHeight: number;
+  devicePixelRatio: number;
+  addEventListener: Listener;
+  removeEventListener: Listener;
+}
+
+declare global {
+  var window: ShimWindow & typeof globalThis;
+  var self: ShimWindow & typeof globalThis;
+  var document: ShimDocument;
+  var innerWidth: number;
+  var innerHeight: number;
+  var devicePixelRatio: number;
+  var HTMLCanvasElement: typeof Canvas;
+  var OffscreenCanvas: typeof Canvas;
+  var HTMLImageElement: typeof NodeImage;
+  var Image: typeof NodeImage;
+  var ImageData: typeof NodeImageData;
+  var ImageBitmap: typeof NodeImageBitmap;
+  var createImageBitmap: typeof nodeCreateImageBitmap;
+  var WebGLRenderingContext: typeof NodeWebGLRenderingContext;
+  var WebGL2RenderingContext: typeof NodeWebGL2RenderingContext;
+  function requestAnimationFrame(callback: (time: number) => void): number;
+  function cancelAnimationFrame(handle: number): void;
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "jest-environment-webgl-node",
+  "version": "0.1.0",
+  "description": "Jest environment that provides real headless WebGL 1/2 (ANGLE via @onirenaud/node-webgl) in Node",
+  "keywords": [
+    "headless",
+    "jest",
+    "jest-environment",
+    "testing",
+    "three.js",
+    "webgl",
+    "webgl2"
+  ],
+  "homepage": "https://github.com/bhouston/jest-gpu#readme",
+  "bugs": {
+    "url": "https://github.com/bhouston/jest-gpu/issues"
+  },
+  "license": "MIT",
+  "author": "Ben Houston <ben@ben3d.ca> (https://ben3d.ca)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bhouston/jest-gpu.git",
+    "directory": "packages/jest-environment-webgl-node"
+  },
+  "files": [
+    "globals.d.ts",
+    "dist/**/*.cjs",
+    "dist/**/*.cjs.map",
+    "dist/**/*.mjs",
+    "dist/**/*.mjs.map",
+    "dist/**/*.d.cts",
+    "dist/**/*.d.cts.map",
+    "dist/**/*.d.mts",
+    "dist/**/*.d.mts.map",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./globals": {
+      "types": "./globals.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "tsc": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@onirenaud/node-webgl": "^0.2.0"
+  },
+  "peerDependencies": {
+    "jest": ">=29 <31",
+    "jest-environment-node": ">=29 <31"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}