@luma.gl/test-utils 8.6.0-alpha.4 → 9.0.0-alpha.2

package/dist/check-type.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tests that an argument matches the type.
+ * @note fails during typescript type check, not during runtime.
+ */
+export declare function checkType<T>(value: T): void;
+//# sourceMappingURL=check-type.d.ts.map

package/dist/check-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-type.d.ts","sourceRoot":"","sources":["../src/check-type.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAG"}

package/dist/check-type.js

@@ -0,0 +1,3 @@
+export function checkType(value) {}
+;
+//# sourceMappingURL=check-type.js.map

package/dist/check-type.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/check-type.ts"],"names":["checkType","value"],"mappings":"AAKA,OAAO,SAASA,SAAT,CAAsBC,KAAtB,EAAsC,CAAE;AAAA","sourcesContent":["\n/**\n * Tests that an argument matches the type.\n * @note fails during typescript type check, not during runtime.\n */\nexport function checkType<T>(value: T): void {};\n"],"file":"check-type.js"}

package/dist/create-test-device.d.ts

@@ -1,5 +1,13 @@
-import { WebGLDevice, WebGLDeviceProps } from '@luma.gl/webgl';
-export declare function createTestDevice(props?: WebGLDeviceProps): WebGLDevice | null;
+import type { Device, DeviceProps } from '@luma.gl/api';
+import { WebGLDevice } from '@luma.gl/webgl';
+import { WebGPUDevice } from '@luma.gl/webgpu';
+export declare function createTestDevice(props?: DeviceProps): WebGLDevice | null;
 export declare const webgl1TestDevice: WebGLDevice;
 export declare const webgl2TestDevice: WebGLDevice;
+/** Only available after getTestDevices() has completed */
+export declare let webgpuTestDevice: WebGPUDevice;
+/** Synchronously get test devices (only WebGLDevices) */
+export declare function getWebGLTestDevices(): WebGLDevice[];
+/** Includes WebGPU device if available */
+export declare function getTestDevices(): Promise<Device[]>;
 //# sourceMappingURL=create-test-device.d.ts.map

package/dist/create-test-device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-test-device.d.ts","sourceRoot":"","sources":["../src/create-test-device.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAiB7D,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,gBAAqB,GAAG,WAAW,GAAG,IAAI,CASjF;AAED,eAAO,MAAM,gBAAgB,EAAE,WAA6D,CAAC;AAC7F,eAAO,MAAM,gBAAgB,EAAE,WAA6D,CAAC"}
+{"version":3,"file":"create-test-device.d.ts","sourceRoot":"","sources":["../src/create-test-device.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,MAAM,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAiB7C,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,WAAgB,GAAG,WAAW,GAAG,IAAI,CAU5E;AAED,eAAO,MAAM,gBAAgB,EAAE,WAAuF,CAAC;AACvH,eAAO,MAAM,gBAAgB,EAAE,WAAuF,CAAC;AACvH,0DAA0D;AAC1D,eAAO,IAAI,gBAAgB,EAAE,YAAY,CAAC;AAI1C,yDAAyD;AACzD,wBAAgB,mBAAmB,IAAI,WAAW,EAAE,CAEnD;AAED,0CAA0C;AAC1C,wBAAsB,cAAc,IAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAUzD"}

package/dist/create-test-device.js

@@ -1,4 +1,5 @@
 import { isBrowser } from 'probe.gl/env';
+import { luma } from '@luma.gl/api';
 import { WebGLDevice } from '@luma.gl/webgl';
 import { createHeadlessContext } from './create-headless-context';
 const ERR_HEADLESSGL_FAILED = 'Failed to create WebGL context in Node.js, headless gl returned null';
@@ -13,20 +14,42 @@ export function createTestDevice(props = {}) {
     const gl = !isBrowser() ? createHeadlessContext(props) : undefined;
     props = { ...CONTEXT_DEFAULTS,
       ...props,
-      gl
+      gl,
+      debug: true
     };
     return new WebGLDevice(props);
   } catch (error) {
-    console.error(error.message);
+    console.error("Failed to created device '".concat(props.id, "': ").concat(error.message));
     return null;
   }
 }
 export const webgl1TestDevice = createTestDevice({
+  id: 'webgl1-test-device',
   webgl1: true,
   webgl2: false
 });
 export const webgl2TestDevice = createTestDevice({
+  id: 'webgl2-test-device',
   webgl1: false,
   webgl2: true
 });
+export let webgpuTestDevice;
+let webgpuCreated = false;
+export function getWebGLTestDevices() {
+  return [webgl2TestDevice, webgl1TestDevice].filter(Boolean);
+}
+export async function getTestDevices() {
+  if (!webgpuCreated) {
+    webgpuCreated = true;
+
+    try {
+      webgpuTestDevice = await luma.createDevice({
+        id: 'webgpu-test-device',
+        type: 'webgpu'
+      });
+    } catch {}
+  }
+
+  return [webgpuTestDevice, webgl2TestDevice, webgl1TestDevice].filter(Boolean);
+}
 //# sourceMappingURL=create-test-device.js.map

package/dist/create-test-device.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/create-test-device.ts"],"names":["isBrowser","WebGLDevice","createHeadlessContext","ERR_HEADLESSGL_FAILED","ERR_HEADLESSGL_LOAD","CONTEXT_DEFAULTS","width","height","debug","createTestDevice","props","gl","undefined","error","console","message","webgl1TestDevice","webgl1","webgl2","webgl2TestDevice"],"mappings":"AAAA,SAAQA,SAAR,QAAwB,cAAxB;AACA,SAAQC,WAAR,QAA4C,gBAA5C;AACA,SAAQC,qBAAR,QAAoC,2BAApC;AAEA,MAAMC,qBAAqB,GACzB,sEADF;AAGA,MAAMC,mBAAmB,gPAAzB;AAKA,MAAMC,gBAA2C,GAAG;AAClDC,EAAAA,KAAK,EAAE,CAD2C;AAElDC,EAAAA,MAAM,EAAE,CAF0C;AAGlDC,EAAAA,KAAK,EAAE;AAH2C,CAApD;AAMA,OAAO,SAASC,gBAAT,CAA0BC,KAAuB,GAAG,EAApD,EAA4E;AACjF,MAAI;AACF,UAAMC,EAAE,GAAG,CAACX,SAAS,EAAV,GAAeE,qBAAqB,CAACQ,KAAD,CAApC,GAA8CE,SAAzD;AACAF,IAAAA,KAAK,GAAG,EAAC,GAAGL,gBAAJ;AAAsB,SAAGK,KAAzB;AAAgCC,MAAAA;AAAhC,KAAR;AACA,WAAO,IAAIV,WAAJ,CAAgBS,KAAhB,CAAP;AACD,GAJD,CAIE,OAAOG,KAAP,EAAc;AACdC,IAAAA,OAAO,CAACD,KAAR,CAAcA,KAAK,CAACE,OAApB;AACA,WAAO,IAAP;AACD;AACF;AAED,OAAO,MAAMC,gBAA6B,GAAGP,gBAAgB,CAAC;AAACQ,EAAAA,MAAM,EAAE,IAAT;AAAeC,EAAAA,MAAM,EAAE;AAAvB,CAAD,CAAtD;AACP,OAAO,MAAMC,gBAA6B,GAAGV,gBAAgB,CAAC;AAACQ,EAAAA,MAAM,EAAE,KAAT;AAAgBC,EAAAA,MAAM,EAAE;AAAxB,CAAD,CAAtD","sourcesContent":["import {isBrowser} from 'probe.gl/env';\nimport {WebGLDevice, WebGLDeviceProps} from '@luma.gl/webgl';\nimport {createHeadlessContext} from './create-headless-context';\n\nconst ERR_HEADLESSGL_FAILED =\n  'Failed to create WebGL context in Node.js, headless gl returned null';\n\nconst ERR_HEADLESSGL_LOAD = `\\\n  luma.gl: loaded under Node.js without headless gl installed, meaning that WebGL \\\n  contexts can not be created. This may not be an error. For example, this is a \\\n  typical configuration for isorender applications running on the server.`;\n\nconst CONTEXT_DEFAULTS: Partial<WebGLDeviceProps> = {\n  width: 1,\n  height: 1,\n  debug: true\n};\n\nexport function createTestDevice(props: WebGLDeviceProps = {}): WebGLDevice | null {\n  try {\n    const gl = !isBrowser() ? createHeadlessContext(props) : undefined;\n    props = {...CONTEXT_DEFAULTS, ...props, gl};\n    return new WebGLDevice(props);\n  } catch (error) {\n    console.error(error.message);\n    return null;\n  }\n}\n\nexport const webgl1TestDevice: WebGLDevice = createTestDevice({webgl1: true, webgl2: false});\nexport const webgl2TestDevice: WebGLDevice = createTestDevice({webgl1: false, webgl2: true});\n"],"file":"create-test-device.js"}
+{"version":3,"sources":["../src/create-test-device.ts"],"names":["isBrowser","luma","WebGLDevice","createHeadlessContext","ERR_HEADLESSGL_FAILED","ERR_HEADLESSGL_LOAD","CONTEXT_DEFAULTS","width","height","debug","createTestDevice","props","gl","undefined","error","console","id","message","webgl1TestDevice","webgl1","webgl2","webgl2TestDevice","webgpuTestDevice","webgpuCreated","getWebGLTestDevices","filter","Boolean","getTestDevices","createDevice","type"],"mappings":"AAAA,SAAQA,SAAR,QAAwB,cAAxB;AAEA,SAAQC,IAAR,QAAmB,cAAnB;AACA,SAAQC,WAAR,QAA0B,gBAA1B;AAEA,SAAQC,qBAAR,QAAoC,2BAApC;AAEA,MAAMC,qBAAqB,GACzB,sEADF;AAGA,MAAMC,mBAAmB,gPAAzB;AAKA,MAAMC,gBAAsC,GAAG;AAC7CC,EAAAA,KAAK,EAAE,CADsC;AAE7CC,EAAAA,MAAM,EAAE,CAFqC;AAG7CC,EAAAA,KAAK,EAAE;AAHsC,CAA/C;AAMA,OAAO,SAASC,gBAAT,CAA0BC,KAAkB,GAAG,EAA/C,EAAuE;AAC5E,MAAI;AACF,UAAMC,EAAE,GAAG,CAACZ,SAAS,EAAV,GAAeG,qBAAqB,CAACQ,KAAD,CAApC,GAA8CE,SAAzD;AACAF,IAAAA,KAAK,GAAG,EAAC,GAAGL,gBAAJ;AAAsB,SAAGK,KAAzB;AAAgCC,MAAAA,EAAhC;AAAoCH,MAAAA,KAAK,EAAE;AAA3C,KAAR;AAEA,WAAO,IAAIP,WAAJ,CAAgBS,KAAhB,CAAP;AACD,GALD,CAKE,OAAOG,KAAP,EAAc;AACdC,IAAAA,OAAO,CAACD,KAAR,qCAA2CH,KAAK,CAACK,EAAjD,gBAAyDF,KAAK,CAACG,OAA/D;AACA,WAAO,IAAP;AACD;AACF;AAED,OAAO,MAAMC,gBAA6B,GAAGR,gBAAgB,CAAC;AAACM,EAAAA,EAAE,EAAE,oBAAL;AAA2BG,EAAAA,MAAM,EAAE,IAAnC;AAAyCC,EAAAA,MAAM,EAAE;AAAjD,CAAD,CAAtD;AACP,OAAO,MAAMC,gBAA6B,GAAGX,gBAAgB,CAAC;AAACM,EAAAA,EAAE,EAAE,oBAAL;AAA2BG,EAAAA,MAAM,EAAE,KAAnC;AAA0CC,EAAAA,MAAM,EAAE;AAAlD,CAAD,CAAtD;AAEP,OAAO,IAAIE,gBAAJ;AAEP,IAAIC,aAAa,GAAG,KAApB;AAGA,OAAO,SAASC,mBAAT,GAA8C;AACnD,SAAO,CAACH,gBAAD,EAAmBH,gBAAnB,EAAqCO,MAArC,CAA4CC,OAA5C,CAAP;AACD;AAGD,OAAO,eAAeC,cAAf,GAAoD;AACzD,MAAI,CAACJ,aAAL,EAAoB;AAClBA,IAAAA,aAAa,GAAG,IAAhB;;AACA,QAAI;AACFD,MAAAA,gBAAgB,GAAG,MAAMrB,IAAI,CAAC2B,YAAL,CAAkB;AAACZ,QAAAA,EAAE,EAAE,oBAAL;AAA2Ba,QAAAA,IAAI,EAAE;AAAjC,OAAlB,CAAzB;AACD,KAFD,CAEE,MAAM,CAEP;AACF;;AACD,SAAO,CAACP,gBAAD,EAAmBD,gBAAnB,EAAqCH,gBAArC,EAAuDO,MAAvD,CAA8DC,OAA9D,CAAP;AACD","sourcesContent":["import {isBrowser} from 'probe.gl/env';\nimport type {Device, DeviceProps} from '@luma.gl/api';\nimport {luma} from '@luma.gl/api';\nimport {WebGLDevice} from '@luma.gl/webgl';\nimport {WebGPUDevice} from '@luma.gl/webgpu';\nimport {createHeadlessContext} from './create-headless-context';\n\nconst ERR_HEADLESSGL_FAILED =\n  'Failed to create WebGL context in Node.js, headless gl returned null';\n\nconst ERR_HEADLESSGL_LOAD = `\\\n  luma.gl: loaded under Node.js without headless gl installed, meaning that WebGL \\\n  contexts can not be created. This may not be an error. For example, this is a \\\n  typical configuration for isorender applications running on the server.`;\n\nconst CONTEXT_DEFAULTS: Partial<DeviceProps> = {\n  width: 1,\n  height: 1,\n  debug: true\n};\n\nexport function createTestDevice(props: DeviceProps = {}): WebGLDevice | null {\n  try {\n    const gl = !isBrowser() ? createHeadlessContext(props) : undefined;\n    props = {...CONTEXT_DEFAULTS, ...props, gl, debug: true};\n    // We dont use luma.createDevice since this tests current expect this context to be created synchronously\n    return new WebGLDevice(props);\n  } catch (error) {\n    console.error(`Failed to created device '${props.id}': ${error.message}`);\n    return null;\n  }\n}\n\nexport const webgl1TestDevice: WebGLDevice = createTestDevice({id: 'webgl1-test-device', webgl1: true, webgl2: false});\nexport const webgl2TestDevice: WebGLDevice = createTestDevice({id: 'webgl2-test-device', webgl1: false, webgl2: true});\n/** Only available after getTestDevices() has completed */\nexport let webgpuTestDevice: WebGPUDevice;\n\nlet webgpuCreated = false;\n\n/** Synchronously get test devices (only WebGLDevices) */\nexport function getWebGLTestDevices(): WebGLDevice[] {\n  return [webgl2TestDevice, webgl1TestDevice].filter(Boolean);\n}\n\n/** Includes WebGPU device if available */\nexport async function getTestDevices() : Promise<Device[]> {\n  if (!webgpuCreated) {\n    webgpuCreated = true;\n    try {\n      webgpuTestDevice = await luma.createDevice({id: 'webgpu-test-device', type: 'webgpu'}) as WebGPUDevice;\n    } catch {\n      // ignore (assume WebGPU was not available)\n    }\n  }\n  return [webgpuTestDevice, webgl2TestDevice, webgl1TestDevice].filter(Boolean);\n}\n"],"file":"create-test-device.js"}

package/dist/index.d.ts

@@ -1,6 +1,10 @@
+export type { TestRunnerTestCase } from './test-runner';
+export type { SnapshotTestRunnerTestCase } from './snapshot-test-runner';
 export { default as SnapshotTestRunner } from './snapshot-test-runner';
 export { default as PerformanceTestRunner } from './performance-test-runner';
 export { createHeadlessContext } from './create-headless-context';
 export { createTestContext } from './create-test-context';
-export { createTestDevice, webgl1TestDevice, webgl2TestDevice } from './create-test-device';
+export { createTestDevice, webgl1TestDevice, webgl2TestDevice, webgpuTestDevice } from './create-test-device';
+export { getTestDevices, getWebGLTestDevices } from './create-test-device';
+export { checkType } from './check-type';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AACtD,YAAY,EAAC,0BAA0B,EAAC,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAC,OAAO,IAAI,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAC,qBAAqB,EAAC,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EAAC,cAAc,EAAE,mBAAmB,EAAC,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -2,5 +2,7 @@ export { default as SnapshotTestRunner } from './snapshot-test-runner';
 export { default as PerformanceTestRunner } from './performance-test-runner';
 export { createHeadlessContext } from './create-headless-context';
 export { createTestContext } from './create-test-context';
-export { createTestDevice, webgl1TestDevice, webgl2TestDevice } from './create-test-device';
+export { createTestDevice, webgl1TestDevice, webgl2TestDevice, webgpuTestDevice } from './create-test-device';
+export { getTestDevices, getWebGLTestDevices } from './create-test-device';
+export { checkType } from './check-type';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["default","SnapshotTestRunner","PerformanceTestRunner","createHeadlessContext","createTestContext","createTestDevice","webgl1TestDevice","webgl2TestDevice"],"mappings":"AAAA,SAAQA,OAAO,IAAIC,kBAAnB,QAA4C,wBAA5C;AACA,SAAQD,OAAO,IAAIE,qBAAnB,QAA+C,2BAA/C;AACA,SAAQC,qBAAR,QAAoC,2BAApC;AACA,SAAQC,iBAAR,QAAgC,uBAAhC;AACA,SAAQC,gBAAR,EAA0BC,gBAA1B,EAA4CC,gBAA5C,QAAmE,sBAAnE","sourcesContent":["export {default as SnapshotTestRunner} from './snapshot-test-runner';\nexport {default as PerformanceTestRunner} from './performance-test-runner';\nexport {createHeadlessContext} from './create-headless-context';\nexport {createTestContext} from './create-test-context';\nexport {createTestDevice, webgl1TestDevice, webgl2TestDevice} from './create-test-device';\n"],"file":"index.js"}
+{"version":3,"sources":["../src/index.ts"],"names":["default","SnapshotTestRunner","PerformanceTestRunner","createHeadlessContext","createTestContext","createTestDevice","webgl1TestDevice","webgl2TestDevice","webgpuTestDevice","getTestDevices","getWebGLTestDevices","checkType"],"mappings":"AAGA,SAAQA,OAAO,IAAIC,kBAAnB,QAA4C,wBAA5C;AACA,SAAQD,OAAO,IAAIE,qBAAnB,QAA+C,2BAA/C;AACA,SAAQC,qBAAR,QAAoC,2BAApC;AACA,SAAQC,iBAAR,QAAgC,uBAAhC;AACA,SAAQC,gBAAR,EAA0BC,gBAA1B,EAA4CC,gBAA5C,EAA8DC,gBAA9D,QAAqF,sBAArF;AACA,SAAQC,cAAR,EAAwBC,mBAAxB,QAAkD,sBAAlD;AAEA,SAAQC,SAAR,QAAwB,cAAxB","sourcesContent":["export type {TestRunnerTestCase} from './test-runner';\nexport type {SnapshotTestRunnerTestCase} from './snapshot-test-runner';\n\nexport {default as SnapshotTestRunner} from './snapshot-test-runner';\nexport {default as PerformanceTestRunner} from './performance-test-runner';\nexport {createHeadlessContext} from './create-headless-context';\nexport {createTestContext} from './create-test-context';\nexport {createTestDevice, webgl1TestDevice, webgl2TestDevice, webgpuTestDevice} from './create-test-device';\nexport {getTestDevices, getWebGLTestDevices} from './create-test-device';\n\nexport {checkType} from './check-type';\n"],"file":"index.js"}

package/dist/snapshot-test-runner.d.ts

@@ -1,4 +1,9 @@
-import TestRunner, { TestRunnerOptions } from './test-runner';
+import TestRunner, { TestRunnerOptions, TestRunnerTestCase } from './test-runner';
+/** A snapshot test case */
+export declare type SnapshotTestRunnerTestCase = TestRunnerTestCase & {
+    /** URL to golden image */
+    goldenImage: string;
+};
 export default class SnapshotTestRunner extends TestRunner {
     private isDiffing;
     constructor(props: TestRunnerOptions);

package/dist/snapshot-test-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-test-runner.d.ts","sourceRoot":"","sources":["../src/snapshot-test-runner.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAI5D,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,UAAU;IACxD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,KAAK,EAAE,iBAAiB;IAOpC,YAAY,CAAC,QAAQ,KAAA;IAOrB,YAAY;IAKZ,MAAM,CAAC,QAAQ,KAAA;CAiChB"}
+{"version":3,"file":"snapshot-test-runner.d.ts","sourceRoot":"","sources":["../src/snapshot-test-runner.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAC,iBAAiB,EAAE,kBAAkB,EAAC,MAAM,eAAe,CAAC;AAGhF,2BAA2B;AAC3B,oBAAY,0BAA0B,GAAG,kBAAkB,GAAG;IAC5D,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,UAAU;IACxD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,KAAK,EAAE,iBAAiB;IAOpC,YAAY,CAAC,QAAQ,KAAA;IAOrB,YAAY;IAKZ,MAAM,CAAC,QAAQ,KAAA;CAiChB"}

package/dist/snapshot-test-runner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/snapshot-test-runner.ts"],"names":["TestRunner","getBoundingBoxInPage","SnapshotTestRunner","constructor","props","testOptions","imageDiffOptions","initTestCase","testCase","goldenImage","Error","name","shouldRender","isDiffing","assert","diffOptions","Object","assign","region","_animationProps","canvas","window","browserTestDriver_captureAndDiffScreen","then","result","success","_pass","_fail","_next"],"mappings":";AAAA,OAAOA,UAAP,MAA4C,eAA5C;AACA,SAAQC,oBAAR,QAAmC,SAAnC;AAGA,eAAe,MAAMC,kBAAN,SAAiCF,UAAjC,CAA4C;AAGzDG,EAAAA,WAAW,CAACC,KAAD,EAA2B;AACpC,UAAMA,KAAN;;AADoC,uCAFT,KAES;;AAIpC,SAAKC,WAAL,CAAiBC,gBAAjB,GAAoC,EAApC;AACD;;AAEDC,EAAAA,YAAY,CAACC,QAAD,EAAW;AACrB,UAAMD,YAAN,CAAmBC,QAAnB;;AACA,QAAI,CAACA,QAAQ,CAACC,WAAd,EAA2B;AACzB,YAAM,IAAIC,KAAJ,qBAAuBF,QAAQ,CAACG,IAAhC,iCAAN;AACD;AACF;;AAEDC,EAAAA,YAAY,GAAG;AAEb,WAAO,CAAC,KAAKC,SAAb;AACD;;AAEDC,EAAAA,MAAM,CAACN,QAAD,EAAW;AACf,QAAI,KAAKK,SAAT,EAAoB;AAElB;AACD;;AACD,SAAKA,SAAL,GAAiB,IAAjB;AAEA,UAAME,WAAW,GAAGC,MAAM,CAACC,MAAP,CAClB,EADkB,EAGlB,KAAKZ,WAAL,CAAiBC,gBAHC,EAIlBE,QAAQ,CAACF,gBAJS,EAKlB;AACEG,MAAAA,WAAW,EAAED,QAAQ,CAACC,WADxB;AAGES,MAAAA,MAAM,EAAEjB,oBAAoB,CAAC,KAAKkB,eAAL,CAAqBC,MAAtB;AAH9B,KALkB,CAApB;AAcAC,IAAAA,MAAM,CAACC,sCAAP,CAA8CP,WAA9C,EAA2DQ,IAA3D,CAAiEC,MAAD,IAAY;AAE1E,UAAIA,MAAM,CAACC,OAAX,EAAoB;AAClB,aAAKC,KAAL,CAAWF,MAAX;AACD,OAFD,MAEO;AACL,aAAKG,KAAL,CAAWH,MAAX;AACD;;AAED,WAAKX,SAAL,GAAiB,KAAjB;;AACA,WAAKe,KAAL;AACD,KAVD;AAWD;;AAtDwD","sourcesContent":["import TestRunner, {TestRunnerOptions} from './test-runner';\nimport {getBoundingBoxInPage} from './utils';\n\n\nexport default class SnapshotTestRunner extends TestRunner {\n  private isDiffing: boolean = false;\n\n  constructor(props: TestRunnerOptions) {\n    super(props);\n\n    // @ts-expect-error\n    this.testOptions.imageDiffOptions = {};\n  }\n\n  initTestCase(testCase) {\n    super.initTestCase(testCase);\n    if (!testCase.goldenImage) {\n      throw new Error(`Test case ${testCase.name} does not have golden image`);\n    }\n  }\n\n  shouldRender() {\n    // wait for the current diffing to finish\n    return !this.isDiffing;\n  }\n\n  assert(testCase) {\n    if (this.isDiffing) {\n      // Already performing diffing\n      return;\n    }\n    this.isDiffing = true;\n\n    const diffOptions = Object.assign(\n      {},\n      // @ts-expect-error\n      this.testOptions.imageDiffOptions,\n      testCase.imageDiffOptions,\n      {\n        goldenImage: testCase.goldenImage,\n        // @ts-expect-error\n        region: getBoundingBoxInPage(this._animationProps.canvas)\n      }\n    );\n\n    // Take screenshot and compare\n    // @ts-expect-error\n    window.browserTestDriver_captureAndDiffScreen(diffOptions).then((result) => {\n      // invoke user callback\n      if (result.success) {\n        this._pass(result);\n      } else {\n        this._fail(result);\n      }\n\n      this.isDiffing = false;\n      this._next();\n    });\n  }\n}\n"],"file":"snapshot-test-runner.js"}
+{"version":3,"sources":["../src/snapshot-test-runner.ts"],"names":["TestRunner","getBoundingBoxInPage","SnapshotTestRunner","constructor","props","testOptions","imageDiffOptions","initTestCase","testCase","goldenImage","Error","name","shouldRender","isDiffing","assert","diffOptions","Object","assign","region","_animationProps","canvas","window","browserTestDriver_captureAndDiffScreen","then","result","success","_pass","_fail","_next"],"mappings":";AAAA,OAAOA,UAAP,MAAgE,eAAhE;AACA,SAAQC,oBAAR,QAAmC,SAAnC;AAQA,eAAe,MAAMC,kBAAN,SAAiCF,UAAjC,CAA4C;AAGzDG,EAAAA,WAAW,CAACC,KAAD,EAA2B;AACpC,UAAMA,KAAN;;AADoC,uCAFT,KAES;;AAIpC,SAAKC,WAAL,CAAiBC,gBAAjB,GAAoC,EAApC;AACD;;AAEDC,EAAAA,YAAY,CAACC,QAAD,EAAW;AACrB,UAAMD,YAAN,CAAmBC,QAAnB;;AACA,QAAI,CAACA,QAAQ,CAACC,WAAd,EAA2B;AACzB,YAAM,IAAIC,KAAJ,qBAAuBF,QAAQ,CAACG,IAAhC,iCAAN;AACD;AACF;;AAEDC,EAAAA,YAAY,GAAG;AAEb,WAAO,CAAC,KAAKC,SAAb;AACD;;AAEDC,EAAAA,MAAM,CAACN,QAAD,EAAW;AACf,QAAI,KAAKK,SAAT,EAAoB;AAElB;AACD;;AACD,SAAKA,SAAL,GAAiB,IAAjB;AAEA,UAAME,WAAW,GAAGC,MAAM,CAACC,MAAP,CAClB,EADkB,EAGlB,KAAKZ,WAAL,CAAiBC,gBAHC,EAIlBE,QAAQ,CAACF,gBAJS,EAKlB;AACEG,MAAAA,WAAW,EAAED,QAAQ,CAACC,WADxB;AAGES,MAAAA,MAAM,EAAEjB,oBAAoB,CAAC,KAAKkB,eAAL,CAAqBC,MAAtB;AAH9B,KALkB,CAApB;AAcAC,IAAAA,MAAM,CAACC,sCAAP,CAA8CP,WAA9C,EAA2DQ,IAA3D,CAAiEC,MAAD,IAAY;AAE1E,UAAIA,MAAM,CAACC,OAAX,EAAoB;AAClB,aAAKC,KAAL,CAAWF,MAAX;AACD,OAFD,MAEO;AACL,aAAKG,KAAL,CAAWH,MAAX;AACD;;AAED,WAAKX,SAAL,GAAiB,KAAjB;;AACA,WAAKe,KAAL;AACD,KAVD;AAWD;;AAtDwD","sourcesContent":["import TestRunner, {TestRunnerOptions, TestRunnerTestCase} from './test-runner';\nimport {getBoundingBoxInPage} from './utils';\n\n/** A snapshot test case */\nexport type SnapshotTestRunnerTestCase = TestRunnerTestCase & {\n  /** URL to golden image */\n  goldenImage: string;\n}\n\nexport default class SnapshotTestRunner extends TestRunner {\n  private isDiffing: boolean = false;\n\n  constructor(props: TestRunnerOptions) {\n    super(props);\n\n    // @ts-expect-error\n    this.testOptions.imageDiffOptions = {};\n  }\n\n  initTestCase(testCase) {\n    super.initTestCase(testCase);\n    if (!testCase.goldenImage) {\n      throw new Error(`Test case ${testCase.name} does not have golden image`);\n    }\n  }\n\n  shouldRender() {\n    // wait for the current diffing to finish\n    return !this.isDiffing;\n  }\n\n  assert(testCase) {\n    if (this.isDiffing) {\n      // Already performing diffing\n      return;\n    }\n    this.isDiffing = true;\n\n    const diffOptions = Object.assign(\n      {},\n      // @ts-expect-error\n      this.testOptions.imageDiffOptions,\n      testCase.imageDiffOptions,\n      {\n        goldenImage: testCase.goldenImage,\n        // @ts-expect-error\n        region: getBoundingBoxInPage(this._animationProps.canvas)\n      }\n    );\n\n    // Take screenshot and compare\n    // @ts-expect-error\n    window.browserTestDriver_captureAndDiffScreen(diffOptions).then((result) => {\n      // invoke user callback\n      if (result.success) {\n        this._pass(result);\n      } else {\n        this._fail(result);\n      }\n\n      this.isDiffing = false;\n      this._next();\n    });\n  }\n}\n"],"file":"snapshot-test-runner.js"}

package/dist/test-runner.d.ts

@@ -1,15 +1,23 @@
+/** Describes a test case */
 export declare type TestRunnerTestCase = {
+    /** Name of the test case (for logging) */
     name: string;
+    /** Initialize the test case. Can return a promise */
     onInitialize: any;
+    /** Perform rendering */
     onRender: any;
+    /** Clean up after the test case */
     onFinalize: any;
 };
+/** Options for a TestRunner */
 export declare type TestRunnerOptions = {
     onTestStart?: any;
     onTestPass?: any;
     onTestFail?: any;
+    /** milliseconds to wait for each test case before aborting */
     timeout?: number;
 };
+/** Runs an array of test cases */
 export default class TestRunner {
     props: any;
     isRunning: boolean;
@@ -17,6 +25,7 @@ export default class TestRunner {
     readonly _animationProps: object;
     private _testCases;
     private _testCaseData;
+    isHeadless: boolean;
     /**
      * props
      *   AnimationLoop props

package/dist/test-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../src/test-runner.ts"],"names":[],"mappings":"AAKA,oBAAY,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,GAAG,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,GAAG,CAAC;CACjB,CAAC;AAWF,oBAAY,iBAAiB,GAAG;IAE9B,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,UAAU,CAAC,EAAE,GAAG,CAAC;IAGjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,KAAK,MAAC;IACN,SAAS,UAAS;IAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAM;IACtC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,aAAa,CAAQ;IAE7B;;;OAGG;gBACS,KAAK,KAAK;IAStB;;OAEG;IACH;;OAEG;IACF,GAAG,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAU1C;;OAEG;IACJ,GAAG,CAAC,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxC,YAAY,CAAC,QAAQ,KAAA;IAYrB,YAAY,CAAC,cAAc,KAAA;IAI3B,MAAM,CAAC,QAAQ,KAAA;IAOf,KAAK,CAAC,MAAM,KAAA;IAKZ,KAAK,CAAC,MAAM,KAAA;IAKZ,KAAK;IAML,SAAS,CAAC,cAAc,KAAA;IAqCxB,aAAa;CAqDd"}
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../src/test-runner.ts"],"names":[],"mappings":"AAKA,4BAA4B;AAC5B,oBAAY,kBAAkB,GAAG;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,YAAY,EAAE,GAAG,CAAC;IAClB,wBAAwB;IACxB,QAAQ,EAAE,GAAG,CAAC;IACd,mCAAmC;IACnC,UAAU,EAAE,GAAG,CAAC;CACjB,CAAC;AAWF,+BAA+B;AAC/B,oBAAY,iBAAiB,GAAG;IAE9B,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,UAAU,CAAC,EAAE,GAAG,CAAC;IAEjB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,kCAAkC;AAClC,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,KAAK,MAAC;IACN,SAAS,UAAS;IAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAA6B;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAM;IACtC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,aAAa,CAAQ;IAG7B,UAAU,EAAE,OAAO,CAAgD;IAEnE;;;OAGG;gBACS,KAAK,KAAK;IAItB;;OAEG;IACH;;OAEG;IACF,GAAG,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAU1C;;OAEG;IACJ,GAAG,CAAC,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxC,YAAY,CAAC,QAAQ,KAAA;IAYrB,YAAY,CAAC,cAAc,KAAA;IAI3B,MAAM,CAAC,QAAQ,KAAA;IAOf,KAAK,CAAC,MAAM,KAAA;IAKZ,KAAK,CAAC,MAAM,KAAA;IAKZ,KAAK;IAML,SAAS,CAAC,cAAc,KAAA;IAqCxB,aAAa;CAqDd"}

package/dist/test-runner.js

@@ -24,7 +24,8 @@ export default class TestRunner {
 
     _defineProperty(this, "isRunning", false);
 
-    _defineProperty(this, "testOptions", void 0);
+    _defineProperty(this, "testOptions", { ...DEFAULT_TEST_OPTIONS
+    });
 
     _defineProperty(this, "_animationProps", {});
 
@@ -32,9 +33,9 @@ export default class TestRunner {
 
     _defineProperty(this, "_testCaseData", null);
 
+    _defineProperty(this, "isHeadless", Boolean(window.browserTestDriver_isHeadless));
+
     this.props = props;
-    this.isHeadless = Boolean(window.browserTestDriver_isHeadless);
-    this.testOptions = Object.assign({}, DEFAULT_TEST_OPTIONS);
   }
 
   add(testCases) {

package/dist/test-runner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/test-runner.ts"],"names":["AnimationLoop","pushContextState","popContextState","noop","DEFAULT_TEST_CASE","name","onInitialize","onRender","done","onFinalize","DEFAULT_TEST_OPTIONS","onTestStart","testCase","console","log","onTestPass","onTestFail","timeout","TestRunner","constructor","props","isHeadless","Boolean","window","browserTestDriver_isHeadless","testOptions","Object","assign","add","testCases","Array","isArray","_testCases","push","run","options","Promise","resolve","_animationLoop","_onRender","bind","isRunning","start","isDiffing","_currentTestCase","catch","error","_fail","message","initTestCase","animationLoop","key","shouldRender","animationProps","assert","_pass","_next","result","_nextTestCase","_animationProps","stop","isDone","testCaseAnimationProps","_testCaseData","startTime","_currentTestCaseStartTime","time","tick","_currentTestCaseStartTick","value","delete","gl","shift","then","userData"],"mappings":"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","sourcesContent":["// @ts-nocheck TODO remove\n/* eslint-disable no-console */\nimport {AnimationLoop} from '@luma.gl/core';\nimport {pushContextState, popContextState} from '@luma.gl/webgl';\n\nexport type TestRunnerTestCase = {\n  name: string;\n  onInitialize: any;\n  onRender: any;\n  onFinalize: any;\n};\n\nfunction noop() {}\n\nconst DEFAULT_TEST_CASE: TestRunnerTestCase = {\n  name: 'Unnamed test',\n  onInitialize: noop,\n  onRender: ({done}) => done(),\n  onFinalize: noop\n};\n\nexport type TestRunnerOptions = {\n  // test lifecycle callback\n  onTestStart?: any;\n  onTestPass?: any;\n  onTestFail?: any;\n\n  // milliseconds to wait for each test case before aborting\n  timeout?: number;\n};\n\nconst DEFAULT_TEST_OPTIONS: Required<TestRunnerOptions> = {\n  // test lifecycle callback\n  onTestStart: (testCase) => console.log(`# ${testCase.name}`),\n  onTestPass: (testCase) => console.log(`ok ${testCase.name} passed`),\n  onTestFail: (testCase) => console.log(`not ok ${testCase.name} failed`),\n\n  // milliseconds to wait for each test case before aborting\n  timeout: 2000\n};\n\nexport default class TestRunner {\n  props;\n  isRunning = false;\n  readonly testOptions: object;\n  readonly _animationProps: object = {};\n  private _testCases: TestRunnerTestCase[] = [];\n  private _testCaseData = null;\n\n  /**\n   * props\n   *   AnimationLoop props\n   */\n  constructor(props = {}) {\n    this.props = props;\n\n    // @ts-expect-error\n    this.isHeadless = Boolean(window.browserTestDriver_isHeadless);\n\n    this.testOptions = Object.assign({}, DEFAULT_TEST_OPTIONS);\n  }\n\n  /**\n   * Add testCase(s)\n   */\n  /**\n   * Add testCase(s)\n   */\n   add(testCases: TestRunnerTestCase[]): this {\n    if (!Array.isArray(testCases)) {\n      testCases = [testCases];\n    }\n    for (const testCase of testCases) {\n      this._testCases.push(testCase);\n    }\n    return this;\n  }\n\n   /**\n    * Returns a promise that resolves when all the test cases are done\n    */\n  run(options: object = {}): Promise<void>  {\n    Object.assign(this.testOptions, options);\n\n    return new Promise<void>(resolve => {\n      this._animationLoop = new AnimationLoop(\n        // @ts-expect-error TODO\n        Object.assign({}, this.props, {\n          onRender: this._onRender.bind(this),\n          onFinalize: () => {\n            this.isRunning = false;\n            resolve();\n          }\n        })\n      );\n      this._animationLoop.start(this.props);\n\n      this.isRunning = true;\n      this.isDiffing = false;\n      this._currentTestCase = null;\n    }).catch((error) => {\n      this._fail({error: error.message});\n    });\n  }\n\n  /* Lifecycle methods for subclassing */\n\n  initTestCase(testCase) {\n    const {animationLoop} = testCase;\n    if (animationLoop) {\n      testCase.onInitialize = animationLoop.onInitialize.bind(animationLoop);\n      testCase.onRender = animationLoop.onRender.bind(animationLoop);\n      testCase.onFinalize = animationLoop.onFinalize.bind(animationLoop);\n    }\n    for (const key in DEFAULT_TEST_CASE) {\n      testCase[key] = testCase[key] || DEFAULT_TEST_CASE[key];\n    }\n  }\n\n  shouldRender(animationProps) {\n    return true;\n  }\n\n  assert(testCase) {\n    this._pass(testCase);\n    this._next();\n  }\n\n  /* Utilities */\n\n  _pass(result) {\n    // @ts-expect-error\n    this.testOptions.onTestPass(this._currentTestCase, result);\n  }\n\n  _fail(result) {\n    // @ts-expect-error\n    this.testOptions.onTestFail(this._currentTestCase, result);\n  }\n\n  _next() {\n    this._nextTestCase();\n  }\n\n  /* Private methods */\n\n  _onRender(animationProps) {\n    this._animationProps = animationProps;\n\n    const testCase = this._currentTestCase || this._nextTestCase();\n    if (!testCase) {\n      // all test cases are done\n      this._animationLoop.stop();\n      return;\n    }\n\n    let isDone = false;\n    const testCaseAnimationProps = Object.assign({}, animationProps, this._testCaseData, {\n      // tick/time starts from 0 for each test case\n      startTime: this._currentTestCaseStartTime,\n      time: animationProps.time - this._currentTestCaseStartTime,\n      tick: animationProps.tick - this._currentTestCaseStartTick,\n      // called by the test case when it is done rendering and ready for capture and diff\n      done: () => {\n        isDone = true;\n      }\n    });\n\n    if (this._testCaseData && this.shouldRender(testCaseAnimationProps)) {\n      // test case is initialized, render frame\n      testCase.onRender(testCaseAnimationProps);\n    }\n\n    const timeout = testCase.timeout || this.testOptions.timeout;\n    if (timeout && testCaseAnimationProps.time > timeout) {\n      isDone = true;\n    }\n\n    if (isDone) {\n      this.assert(testCase);\n    }\n  }\n\n  _nextTestCase() {\n    const animationProps = this._animationProps;\n\n    // finalize the current test case\n    if (this._testCaseData) {\n      for (const key in this._testCaseData) {\n        const value = this._testCaseData[key];\n        if (value && value.delete) {\n          value.delete();\n        }\n      }\n      this._currentTestCase.onFinalize(Object.assign({}, animationProps, this._testCaseData));\n\n      // reset WebGL context\n      popContextState(animationProps.gl);\n\n      this._currentTestCase = null;\n      this._testCaseData = null;\n    }\n\n    // get the next test case\n    const testCase = this._testCases.shift();\n    if (testCase) {\n      // start new test case\n      this._currentTestCase = testCase;\n      this._currentTestCaseStartTime = animationProps.time;\n      this._currentTestCaseStartTick = animationProps.tick;\n      this.initTestCase(testCase);\n\n      // initialize test case\n\n      // save WebGL context\n      pushContextState(animationProps.gl);\n\n      // aligned with the behavior of AnimationLoop.onInitialized\n      // onInitialized could return a plain object or a promise\n      Promise.resolve(\n        testCase.onInitialize(\n          Object.assign({}, animationProps, {\n            // tick/time starts from 0 for each test case\n            startTime: animationProps.time,\n            time: 0,\n            tick: 0\n          })\n        )\n      ).then((userData) => {\n        this._testCaseData = userData || {};\n      });\n      // invoke user callback\n      this.testOptions.onTestStart(testCase);\n    }\n    return testCase;\n  }\n}\n"],"file":"test-runner.js"}
+{"version":3,"sources":["../src/test-runner.ts"],"names":["AnimationLoop","pushContextState","popContextState","noop","DEFAULT_TEST_CASE","name","onInitialize","onRender","done","onFinalize","DEFAULT_TEST_OPTIONS","onTestStart","testCase","console","log","onTestPass","onTestFail","timeout","TestRunner","constructor","props","Boolean","window","browserTestDriver_isHeadless","add","testCases","Array","isArray","_testCases","push","run","options","Object","assign","testOptions","Promise","resolve","_animationLoop","_onRender","bind","isRunning","start","isDiffing","_currentTestCase","catch","error","_fail","message","initTestCase","animationLoop","key","shouldRender","animationProps","assert","_pass","_next","result","_nextTestCase","_animationProps","stop","isDone","testCaseAnimationProps","_testCaseData","startTime","_currentTestCaseStartTime","time","tick","_currentTestCaseStartTick","value","delete","gl","shift","then","userData"],"mappings":"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","sourcesContent":["// @ts-nocheck TODO remove\n/* eslint-disable no-console */\nimport {AnimationLoop} from '@luma.gl/core';\nimport {pushContextState, popContextState} from '@luma.gl/webgl';\n\n/** Describes a test case */\nexport type TestRunnerTestCase = {\n  /** Name of the test case (for logging) */\n  name: string;\n  /** Initialize the test case. Can return a promise */\n  onInitialize: any;\n  /** Perform rendering */\n  onRender: any;\n  /** Clean up after the test case */\n  onFinalize: any;\n};\n\nfunction noop() {}\n\nconst DEFAULT_TEST_CASE: TestRunnerTestCase = {\n  name: 'Unnamed test',\n  onInitialize: noop,\n  onRender: ({done}) => done(),\n  onFinalize: noop\n};\n\n/** Options for a TestRunner */\nexport type TestRunnerOptions = {\n  // test lifecycle callback\n  onTestStart?: any;\n  onTestPass?: any;\n  onTestFail?: any;\n\n  /** milliseconds to wait for each test case before aborting */\n  timeout?: number;\n};\n\nconst DEFAULT_TEST_OPTIONS: Required<TestRunnerOptions> = {\n  // test lifecycle callback\n  onTestStart: (testCase) => console.log(`# ${testCase.name}`),\n  onTestPass: (testCase) => console.log(`ok ${testCase.name} passed`),\n  onTestFail: (testCase) => console.log(`not ok ${testCase.name} failed`),\n\n  // milliseconds to wait for each test case before aborting\n  timeout: 2000\n};\n\n/** Runs an array of test cases */\nexport default class TestRunner {\n  props;\n  isRunning = false;\n  readonly testOptions: object = {...DEFAULT_TEST_OPTIONS};\n  readonly _animationProps: object = {};\n  private _testCases: TestRunnerTestCase[] = [];\n  private _testCaseData = null;\n\n  // @ts-expect-error\n  isHeadless: boolean = Boolean(window.browserTestDriver_isHeadless);\n\n  /**\n   * props\n   *   AnimationLoop props\n   */\n  constructor(props = {}) {\n    this.props = props;\n  }\n\n  /**\n   * Add testCase(s)\n   */\n  /**\n   * Add testCase(s)\n   */\n   add(testCases: TestRunnerTestCase[]): this {\n    if (!Array.isArray(testCases)) {\n      testCases = [testCases];\n    }\n    for (const testCase of testCases) {\n      this._testCases.push(testCase);\n    }\n    return this;\n  }\n\n   /**\n    * Returns a promise that resolves when all the test cases are done\n    */\n  run(options: object = {}): Promise<void>  {\n    Object.assign(this.testOptions, options);\n\n    return new Promise<void>(resolve => {\n      this._animationLoop = new AnimationLoop(\n        // @ts-expect-error TODO\n        Object.assign({}, this.props, {\n          onRender: this._onRender.bind(this),\n          onFinalize: () => {\n            this.isRunning = false;\n            resolve();\n          }\n        })\n      );\n      this._animationLoop.start(this.props);\n\n      this.isRunning = true;\n      this.isDiffing = false;\n      this._currentTestCase = null;\n    }).catch((error) => {\n      this._fail({error: error.message});\n    });\n  }\n\n  /* Lifecycle methods for subclassing */\n\n  initTestCase(testCase) {\n    const {animationLoop} = testCase;\n    if (animationLoop) {\n      testCase.onInitialize = animationLoop.onInitialize.bind(animationLoop);\n      testCase.onRender = animationLoop.onRender.bind(animationLoop);\n      testCase.onFinalize = animationLoop.onFinalize.bind(animationLoop);\n    }\n    for (const key in DEFAULT_TEST_CASE) {\n      testCase[key] = testCase[key] || DEFAULT_TEST_CASE[key];\n    }\n  }\n\n  shouldRender(animationProps) {\n    return true;\n  }\n\n  assert(testCase) {\n    this._pass(testCase);\n    this._next();\n  }\n\n  /* Utilities */\n\n  _pass(result) {\n    // @ts-expect-error\n    this.testOptions.onTestPass(this._currentTestCase, result);\n  }\n\n  _fail(result) {\n    // @ts-expect-error\n    this.testOptions.onTestFail(this._currentTestCase, result);\n  }\n\n  _next() {\n    this._nextTestCase();\n  }\n\n  /* Private methods */\n\n  _onRender(animationProps) {\n    this._animationProps = animationProps;\n\n    const testCase = this._currentTestCase || this._nextTestCase();\n    if (!testCase) {\n      // all test cases are done\n      this._animationLoop.stop();\n      return;\n    }\n\n    let isDone = false;\n    const testCaseAnimationProps = Object.assign({}, animationProps, this._testCaseData, {\n      // tick/time starts from 0 for each test case\n      startTime: this._currentTestCaseStartTime,\n      time: animationProps.time - this._currentTestCaseStartTime,\n      tick: animationProps.tick - this._currentTestCaseStartTick,\n      // called by the test case when it is done rendering and ready for capture and diff\n      done: () => {\n        isDone = true;\n      }\n    });\n\n    if (this._testCaseData && this.shouldRender(testCaseAnimationProps)) {\n      // test case is initialized, render frame\n      testCase.onRender(testCaseAnimationProps);\n    }\n\n    const timeout = testCase.timeout || this.testOptions.timeout;\n    if (timeout && testCaseAnimationProps.time > timeout) {\n      isDone = true;\n    }\n\n    if (isDone) {\n      this.assert(testCase);\n    }\n  }\n\n  _nextTestCase() {\n    const animationProps = this._animationProps;\n\n    // finalize the current test case\n    if (this._testCaseData) {\n      for (const key in this._testCaseData) {\n        const value = this._testCaseData[key];\n        if (value && value.delete) {\n          value.delete();\n        }\n      }\n      this._currentTestCase.onFinalize(Object.assign({}, animationProps, this._testCaseData));\n\n      // reset WebGL context\n      popContextState(animationProps.gl);\n\n      this._currentTestCase = null;\n      this._testCaseData = null;\n    }\n\n    // get the next test case\n    const testCase = this._testCases.shift();\n    if (testCase) {\n      // start new test case\n      this._currentTestCase = testCase;\n      this._currentTestCaseStartTime = animationProps.time;\n      this._currentTestCaseStartTick = animationProps.tick;\n      this.initTestCase(testCase);\n\n      // initialize test case\n\n      // save WebGL context\n      pushContextState(animationProps.gl);\n\n      // aligned with the behavior of AnimationLoop.onInitialized\n      // onInitialized could return a plain object or a promise\n      Promise.resolve(\n        testCase.onInitialize(\n          Object.assign({}, animationProps, {\n            // tick/time starts from 0 for each test case\n            startTime: animationProps.time,\n            time: 0,\n            tick: 0\n          })\n        )\n      ).then((userData) => {\n        this._testCaseData = userData || {};\n      });\n      // invoke user callback\n      this.testOptions.onTestStart(testCase);\n    }\n    return testCase;\n  }\n}\n"],"file":"test-runner.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luma.gl/test-utils",
-  "version": "8.6.0-alpha.4",
+  "version": "9.0.0-alpha.2",
   "description": "Automated WebGL testing utilities with Puppeteer and image diffing",
   "license": "MIT",
   "publishConfig": {
@@ -35,9 +35,8 @@
   },
   "peerDependencies": {
     "@luma.gl/core": "8.6.0-alpha.1",
-    "@luma.gl/debug": "8.6.0-alpha.1",
     "@luma.gl/webgl": "8.6.0-alpha.1",
     "@probe.gl/test-utils": "^3.5.0"
   },
-  "gitHead": "c1c84f1bcaa6e6ff4f1e96f5d294baf8ce39846c"
+  "gitHead": "81e93840f31f0e32f86dfea6b576acf2c2d9caec"
 }

package/src/check-type.ts

@@ -0,0 +1,6 @@
+
+/**
+ * Tests that an argument matches the type.
+ * @note fails during typescript type check, not during runtime.
+ */
+export function checkType<T>(value: T): void {};

package/src/create-test-device.ts

@@ -1,5 +1,8 @@
 import {isBrowser} from 'probe.gl/env';
-import {WebGLDevice, WebGLDeviceProps} from '@luma.gl/webgl';
+import type {Device, DeviceProps} from '@luma.gl/api';
+import {luma} from '@luma.gl/api';
+import {WebGLDevice} from '@luma.gl/webgl';
+import {WebGPUDevice} from '@luma.gl/webgpu';
 import {createHeadlessContext} from './create-headless-context';
 
 const ERR_HEADLESSGL_FAILED =
@@ -10,22 +13,45 @@ const ERR_HEADLESSGL_LOAD = `\
   contexts can not be created. This may not be an error. For example, this is a \
   typical configuration for isorender applications running on the server.`;
 
-const CONTEXT_DEFAULTS: Partial<WebGLDeviceProps> = {
+const CONTEXT_DEFAULTS: Partial<DeviceProps> = {
   width: 1,
   height: 1,
   debug: true
 };
 
-export function createTestDevice(props: WebGLDeviceProps = {}): WebGLDevice | null {
+export function createTestDevice(props: DeviceProps = {}): WebGLDevice | null {
   try {
     const gl = !isBrowser() ? createHeadlessContext(props) : undefined;
-    props = {...CONTEXT_DEFAULTS, ...props, gl};
+    props = {...CONTEXT_DEFAULTS, ...props, gl, debug: true};
+    // We dont use luma.createDevice since this tests current expect this context to be created synchronously
     return new WebGLDevice(props);
   } catch (error) {
-    console.error(error.message);
+    console.error(`Failed to created device '${props.id}': ${error.message}`);
     return null;
   }
 }
 
-export const webgl1TestDevice: WebGLDevice = createTestDevice({webgl1: true, webgl2: false});
-export const webgl2TestDevice: WebGLDevice = createTestDevice({webgl1: false, webgl2: true});
+export const webgl1TestDevice: WebGLDevice = createTestDevice({id: 'webgl1-test-device', webgl1: true, webgl2: false});
+export const webgl2TestDevice: WebGLDevice = createTestDevice({id: 'webgl2-test-device', webgl1: false, webgl2: true});
+/** Only available after getTestDevices() has completed */
+export let webgpuTestDevice: WebGPUDevice;
+
+let webgpuCreated = false;
+
+/** Synchronously get test devices (only WebGLDevices) */
+export function getWebGLTestDevices(): WebGLDevice[] {
+  return [webgl2TestDevice, webgl1TestDevice].filter(Boolean);
+}
+
+/** Includes WebGPU device if available */
+export async function getTestDevices() : Promise<Device[]> {
+  if (!webgpuCreated) {
+    webgpuCreated = true;
+    try {
+      webgpuTestDevice = await luma.createDevice({id: 'webgpu-test-device', type: 'webgpu'}) as WebGPUDevice;
+    } catch {
+      // ignore (assume WebGPU was not available)
+    }
+  }
+  return [webgpuTestDevice, webgl2TestDevice, webgl1TestDevice].filter(Boolean);
+}

package/src/index.ts

@@ -1,5 +1,11 @@
+export type {TestRunnerTestCase} from './test-runner';
+export type {SnapshotTestRunnerTestCase} from './snapshot-test-runner';
+
 export {default as SnapshotTestRunner} from './snapshot-test-runner';
 export {default as PerformanceTestRunner} from './performance-test-runner';
 export {createHeadlessContext} from './create-headless-context';
 export {createTestContext} from './create-test-context';
-export {createTestDevice, webgl1TestDevice, webgl2TestDevice} from './create-test-device';
+export {createTestDevice, webgl1TestDevice, webgl2TestDevice, webgpuTestDevice} from './create-test-device';
+export {getTestDevices, getWebGLTestDevices} from './create-test-device';
+
+export {checkType} from './check-type';

package/src/snapshot-test-runner.ts

@@ -1,6 +1,11 @@
-import TestRunner, {TestRunnerOptions} from './test-runner';
+import TestRunner, {TestRunnerOptions, TestRunnerTestCase} from './test-runner';
 import {getBoundingBoxInPage} from './utils';
 
+/** A snapshot test case */
+export type SnapshotTestRunnerTestCase = TestRunnerTestCase & {
+  /** URL to golden image */
+  goldenImage: string;
+}
 
 export default class SnapshotTestRunner extends TestRunner {
   private isDiffing: boolean = false;

package/src/test-runner.ts

@@ -3,10 +3,15 @@
 import {AnimationLoop} from '@luma.gl/core';
 import {pushContextState, popContextState} from '@luma.gl/webgl';
 
+/** Describes a test case */
 export type TestRunnerTestCase = {
+  /** Name of the test case (for logging) */
   name: string;
+  /** Initialize the test case. Can return a promise */
   onInitialize: any;
+  /** Perform rendering */
   onRender: any;
+  /** Clean up after the test case */
   onFinalize: any;
 };
 
@@ -19,13 +24,14 @@ const DEFAULT_TEST_CASE: TestRunnerTestCase = {
   onFinalize: noop
 };
 
+/** Options for a TestRunner */
 export type TestRunnerOptions = {
   // test lifecycle callback
   onTestStart?: any;
   onTestPass?: any;
   onTestFail?: any;
 
-  // milliseconds to wait for each test case before aborting
+  /** milliseconds to wait for each test case before aborting */
   timeout?: number;
 };
 
@@ -39,25 +45,24 @@ const DEFAULT_TEST_OPTIONS: Required<TestRunnerOptions> = {
   timeout: 2000
 };
 
+/** Runs an array of test cases */
 export default class TestRunner {
   props;
   isRunning = false;
-  readonly testOptions: object;
+  readonly testOptions: object = {...DEFAULT_TEST_OPTIONS};
   readonly _animationProps: object = {};
   private _testCases: TestRunnerTestCase[] = [];
   private _testCaseData = null;
 
+  // @ts-expect-error
+  isHeadless: boolean = Boolean(window.browserTestDriver_isHeadless);
+
   /**
    * props
    *   AnimationLoop props
    */
   constructor(props = {}) {
     this.props = props;
-
-    // @ts-expect-error
-    this.isHeadless = Boolean(window.browserTestDriver_isHeadless);
-
-    this.testOptions = Object.assign({}, DEFAULT_TEST_OPTIONS);
   }
 
   /**