@luma.gl/webgl 9.0.0-alpha.15 → 9.0.0-alpha.16

package/dist/classic/typed-array-utils.d.ts

@@ -1,6 +1,6 @@
 import { TypedArray } from '@luma.gl/api';
 import { GLType } from '../types/webgl';
-declare type TypedArrayConstructor = Float32ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor;
+type TypedArrayConstructor = Float32ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor;
 /**
  * Converts TYPED ARRAYS to corresponding GL constant
  * Used to auto deduce gl parameter types

package/dist/classic/typed-array-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-array-utils.d.ts","sourceRoot":"","sources":["../../src/classic/typed-array-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAExC,OAAO,EAAC,MAAM,EAAC,MAAM,gBAAgB,CAAA;AAIrC,aAAK,qBAAqB,GACtB,uBAAuB,GACvB,sBAAsB,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,4BAA4B,GAC5B,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,UAAU,GAAG,MAAM,CAuBvE;AAED;;;;;;GAMG;AAEH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,GAAG,EACX,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,qBAAqB,CAwBvB;AAED;;;;;GAKG;AACF,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IACjC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,GAAG,IAAI,CAgBP;AAGD,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;CACb,GAAG;IACF,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAaA"}
+{"version":3,"file":"typed-array-utils.d.ts","sourceRoot":"","sources":["../../src/classic/typed-array-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAExC,OAAO,EAAC,MAAM,EAAC,MAAM,gBAAgB,CAAA;AAIrC,KAAK,qBAAqB,GACtB,uBAAuB,GACvB,sBAAsB,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,4BAA4B,GAC5B,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,UAAU,GAAG,MAAM,CAuBvE;AAED;;;;;;GAMG;AAEH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,GAAG,EACX,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,qBAAqB,CAwBvB;AAED;;;;;GAKG;AACF,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IACjC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,GAAG,IAAI,CAgBP;AAGD,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;CACb,GAAG;IACF,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAaA"}

package/dist/classic/typed-array-utils.js

@@ -1,112 +1,102 @@
+// luma.gl, MIT license
 import GL from '@luma.gl/constants';
 const ERR_TYPE_DEDUCTION = 'Failed to deduce GL constant from typed array';
+/**
+ * Converts TYPED ARRAYS to corresponding GL constant
+ * Used to auto deduce gl parameter types
+ * @param {*} arrayOrType
+ * @returns
+ */
 export function getGLTypeFromTypedArray(arrayOrType) {
-  const type = ArrayBuffer.isView(arrayOrType) ? arrayOrType.constructor : arrayOrType;
-
-  switch (type) {
-    case Float32Array:
-      return GL.FLOAT;
-
-    case Uint16Array:
-      return GL.UNSIGNED_SHORT;
-
-    case Uint32Array:
-      return GL.UNSIGNED_INT;
-
-    case Uint8Array:
-      return GL.UNSIGNED_BYTE;
-
-    case Uint8ClampedArray:
-      return GL.UNSIGNED_BYTE;
-
-    case Int8Array:
-      return GL.BYTE;
-
-    case Int16Array:
-      return GL.SHORT;
-
-    case Int32Array:
-      return GL.INT;
-
-    default:
-      throw new Error(ERR_TYPE_DEDUCTION);
-  }
+    // If typed array, look up constructor
+    const type = ArrayBuffer.isView(arrayOrType) ? arrayOrType.constructor : arrayOrType;
+    switch (type) {
+        case Float32Array:
+            return GL.FLOAT;
+        case Uint16Array:
+            return GL.UNSIGNED_SHORT;
+        case Uint32Array:
+            return GL.UNSIGNED_INT;
+        case Uint8Array:
+            return GL.UNSIGNED_BYTE;
+        case Uint8ClampedArray:
+            return GL.UNSIGNED_BYTE;
+        case Int8Array:
+            return GL.BYTE;
+        case Int16Array:
+            return GL.SHORT;
+        case Int32Array:
+            return GL.INT;
+        default:
+            throw new Error(ERR_TYPE_DEDUCTION);
+    }
 }
+/**
+ * Converts GL constant to corresponding TYPED ARRAY
+ * Used to auto deduce gl parameter types
+ * @param {*} glType
+ * @param {*} param1
+ * @returns
+ */
+// eslint-disable-next-line complexity
 export function getTypedArrayFromGLType(glType, options) {
-  const {
-    clamped = true
-  } = options || {};
-
-  switch (glType) {
-    case GL.FLOAT:
-      return Float32Array;
-
-    case GL.UNSIGNED_SHORT:
-    case GL.UNSIGNED_SHORT_5_6_5:
-    case GL.UNSIGNED_SHORT_4_4_4_4:
-    case GL.UNSIGNED_SHORT_5_5_5_1:
-      return Uint16Array;
-
-    case GL.UNSIGNED_INT:
-      return Uint32Array;
-
-    case GL.UNSIGNED_BYTE:
-      return clamped ? Uint8ClampedArray : Uint8Array;
-
-    case GL.BYTE:
-      return Int8Array;
-
-    case GL.SHORT:
-      return Int16Array;
-
-    case GL.INT:
-      return Int32Array;
-
-    default:
-      throw new Error('Failed to deduce typed array type from GL constant');
-  }
+    const { clamped = true } = options || {};
+    // Sorted in some order of likelihood to reduce amount of comparisons
+    switch (glType) {
+        case GL.FLOAT:
+            return Float32Array;
+        case GL.UNSIGNED_SHORT:
+        case GL.UNSIGNED_SHORT_5_6_5:
+        case GL.UNSIGNED_SHORT_4_4_4_4:
+        case GL.UNSIGNED_SHORT_5_5_5_1:
+            return Uint16Array;
+        case GL.UNSIGNED_INT:
+            return Uint32Array;
+        case GL.UNSIGNED_BYTE:
+            return clamped ? Uint8ClampedArray : Uint8Array;
+        case GL.BYTE:
+            return Int8Array;
+        case GL.SHORT:
+            return Int16Array;
+        case GL.INT:
+            return Int32Array;
+        default:
+            throw new Error('Failed to deduce typed array type from GL constant');
+    }
 }
+/**
+ * Flip rows (can be used on arrays returned from `Framebuffer.readPixels`)
+ * https: *stackoverflow.com/questions/41969562/
+ * how-can-i-flip-the-result-of-webglrenderingcontext-readpixels
+ * @param {*} param0
+ */
 export function flipRows(options) {
-  const {
-    data,
-    width,
-    height,
-    bytesPerPixel = 4,
-    temp
-  } = options;
-  const bytesPerRow = width * bytesPerPixel;
-  const tempBuffer = temp || new Uint8Array(bytesPerRow);
-
-  for (let y = 0; y < height / 2; ++y) {
-    const topOffset = y * bytesPerRow;
-    const bottomOffset = (height - y - 1) * bytesPerRow;
-    tempBuffer.set(data.subarray(topOffset, topOffset + bytesPerRow));
-    data.copyWithin(topOffset, bottomOffset, bottomOffset + bytesPerRow);
-    data.set(tempBuffer, bottomOffset);
-  }
+    const { data, width, height, bytesPerPixel = 4, temp } = options;
+    const bytesPerRow = width * bytesPerPixel;
+    // make a temp buffer to hold one row
+    const tempBuffer = temp || new Uint8Array(bytesPerRow);
+    for (let y = 0; y < height / 2; ++y) {
+        const topOffset = y * bytesPerRow;
+        const bottomOffset = (height - y - 1) * bytesPerRow;
+        // make copy of a row on the top half
+        tempBuffer.set(data.subarray(topOffset, topOffset + bytesPerRow));
+        // copy a row from the bottom half to the top
+        data.copyWithin(topOffset, bottomOffset, bottomOffset + bytesPerRow);
+        // copy the copy of the top half row to the bottom half
+        data.set(tempBuffer, bottomOffset);
+    }
 }
 export function scalePixels(options) {
-  const {
-    data,
-    width,
-    height
-  } = options;
-  const newWidth = Math.round(width / 2);
-  const newHeight = Math.round(height / 2);
-  const newData = new Uint8Array(newWidth * newHeight * 4);
-
-  for (let y = 0; y < newHeight; y++) {
-    for (let x = 0; x < newWidth; x++) {
-      for (let c = 0; c < 4; c++) {
-        newData[(y * newWidth + x) * 4 + c] = data[(y * 2 * width + x * 2) * 4 + c];
-      }
+    const { data, width, height } = options;
+    const newWidth = Math.round(width / 2);
+    const newHeight = Math.round(height / 2);
+    const newData = new Uint8Array(newWidth * newHeight * 4);
+    for (let y = 0; y < newHeight; y++) {
+        for (let x = 0; x < newWidth; x++) {
+            for (let c = 0; c < 4; c++) {
+                newData[(y * newWidth + x) * 4 + c] = data[(y * 2 * width + x * 2) * 4 + c];
+            }
+        }
     }
-  }
-
-  return {
-    data: newData,
-    width: newWidth,
-    height: newHeight
-  };
+    return { data: newData, width: newWidth, height: newHeight };
 }
-//# sourceMappingURL=typed-array-utils.js.map

package/dist/context/context/create-browser-context.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="offscreencanvas" />
 /**
  * ContextProps
 * @param webgl2 Set to false to not create a WebGL2 context (force webgl1)
@@ -16,7 +15,7 @@
 * @param preserveDrawingBuffer Default render target buffers will not be automatically cleared and will preserve their values until cleared or overwritten
 * @param failIfMajorPerformanceCaveat Do not create if the system performance is low.
 */
-declare type ContextProps = {
+type ContextProps = {
     type?: 'webgl' | 'webgl1' | 'webgl2' | string;
     webgl1?: boolean;
     webgl2?: boolean;

package/dist/context/context/create-browser-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-browser-context.d.ts","sourceRoot":"","sources":["../../../src/context/context/create-browser-context.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;EAgBE;AACF,aAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,eAAe,CAAC,EAAE,SAAS,GAAI,kBAAkB,GAAG,WAAW,CAAC;IAChE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAC;AAUF;;;;GAIG;AACF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,qBAAqB,CAiD7H"}
+{"version":3,"file":"create-browser-context.d.ts","sourceRoot":"","sources":["../../../src/context/context/create-browser-context.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;EAgBE;AACF,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,eAAe,CAAC,EAAE,SAAS,GAAI,kBAAkB,GAAG,WAAW,CAAC;IAChE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAC;AAUF;;;;GAIG;AACF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,qBAAqB,CAiD7H"}

package/dist/context/context/create-browser-context.js

@@ -1,61 +1,70 @@
+// luma.gl, MIT license
 const DEFAULT_CONTEXT_PROPS = {
-  webgl2: true,
-  webgl1: true,
-  powerPreference: 'high-performance',
-  onContextLost: () => console.error('WebGL context lost'),
-  onContextRestored: () => console.info('WebGL context restored')
+    webgl2: true,
+    webgl1: true,
+    powerPreference: 'high-performance',
+    onContextLost: () => console.error('WebGL context lost'),
+    onContextRestored: () => console.info('WebGL context restored'),
 };
+/**
+ * Create a WebGL context for a canvas
+ * Note calling this multiple time on the same canvas does return the same context
+* @param canvas A canvas element or offscreen canvas
+ */
 export function createBrowserContext(canvas, props) {
-  props = { ...DEFAULT_CONTEXT_PROPS,
-    ...props
-  };
-  let errorMessage = null;
-
-  const onCreateError = error => errorMessage = error.statusMessage || errorMessage;
-
-  canvas.addEventListener('webglcontextcreationerror', onCreateError, false);
-  let gl = null;
-
-  if (props.type === 'webgl2') {
-    props = { ...props,
-      webgl1: false
-    };
-  }
-
-  if (props.type === 'webgl1') {
-    props = { ...props,
-      webgl2: false
-    };
-  }
-
-  if (props.webgl2) {
-    gl = gl || canvas.getContext('webgl2', props);
-  }
-
-  if (props.webgl1) {
-    gl = gl || canvas.getContext('webgl', props);
-  }
+    props = { ...DEFAULT_CONTEXT_PROPS, ...props };
+    // Try to extract any extra information about why context creation failed
+    let errorMessage = null;
+    const onCreateError = (error) => (errorMessage = error.statusMessage || errorMessage);
+    canvas.addEventListener('webglcontextcreationerror', onCreateError, false);
+    // Create the desired context
+    let gl = null;
+    if (props.type === 'webgl2') {
+        props = { ...props, webgl1: false };
+    }
+    if (props.type === 'webgl1') {
+        props = { ...props, webgl2: false };
+    }
+    // Prefer webgl2 over webgl1 if both are acceptable
+    if (props.webgl2) {
+        gl = gl || canvas.getContext('webgl2', props);
+    }
+    if (props.webgl1) {
+        gl = gl || canvas.getContext('webgl', props);
+    }
+    // TODO are we removing this listener before giving it a chance to fire?
+    canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);
+    if (!gl) {
+        throw new Error(`Failed to create ${props.webgl2 && !props.webgl1 ? 'WebGL2' : 'WebGL'} context: ${errorMessage || 'Unknown error'}`);
+    }
+    if (props.onContextLost) {
+        // Carefully extract and wrap callbacks to prevent addEventListener from rebinding them.
+        const { onContextLost } = props;
+        canvas.addEventListener('webglcontextlost', (event) => onContextLost(event), false);
+    }
+    if (props.onContextRestored) {
+        // Carefully extract and wrap callbacks to prevent addEventListener from rebinding them.
+        const { onContextRestored } = props;
+        canvas.addEventListener('webglcontextrestored', (event) => onContextRestored(event), false);
+    }
+    return gl;
+}
+/* TODO - can we call this asynchronously to catch the error events?
+export async function createBrowserContextAsync(canvas: HTMLCanvasElement | OffscreenCanvas, props: ContextProps): Promise<WebGLRenderingContext> {
+  props = {...DEFAULT_CONTEXT_PROPS, ...props};
 
-  canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);
+ // Try to extract any extra information about why context creation failed
+ let errorMessage = null;
+ const onCreateError = (error) => (errorMessage = error.statusMessage || errorMessage);
+ canvas.addEventListener('webglcontextcreationerror', onCreateError, false);
 
-  if (!gl) {
-    throw new Error("Failed to create ".concat(props.webgl2 && !props.webgl1 ? 'WebGL2' : 'WebGL', " context: ").concat(errorMessage || 'Unknown error'));
-  }
+ const gl = createBrowserContext(canvas, props);
 
-  if (props.onContextLost) {
-    const {
-      onContextLost
-    } = props;
-    canvas.addEventListener('webglcontextlost', event => onContextLost(event), false);
-  }
+ // Give the listener a chance to fire
+ await new Promise(resolve => setTimeout(resolve, 0));
 
-  if (props.onContextRestored) {
-    const {
-      onContextRestored
-    } = props;
-    canvas.addEventListener('webglcontextrestored', event => onContextRestored(event), false);
-  }
+ canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);
 
-  return gl;
+ return gl;
 }
-//# sourceMappingURL=create-browser-context.js.map
+*/

package/dist/context/context/create-headless-context.d.ts

@@ -1,5 +1,5 @@
 /** Duck typing for the main headless gl export, a function to create contexts */
-export declare type HeadlessGL = (width: number, height: number, options: Record<string, unknown>) => WebGLRenderingContext;
+export type HeadlessGL = (width: number, height: number, options: Record<string, unknown>) => WebGLRenderingContext;
 /** By importing `gl` and registering it with this function, contexts can be created under Node.js */
 export declare function registerHeadlessGL(headlessgl: HeadlessGL): void;
 /** @returns true if headless gl is registered */

package/dist/context/context/create-headless-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-headless-context.d.ts","sourceRoot":"","sources":["../../../src/context/context/create-headless-context.ts"],"names":[],"mappings":"AAeA,iFAAiF;AACjF,oBAAY,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,qBAAqB,CAAC;AAIpH,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,QAExD;AAED,iDAAiD;AACjD,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAgB1F"}
+{"version":3,"file":"create-headless-context.d.ts","sourceRoot":"","sources":["../../../src/context/context/create-headless-context.ts"],"names":[],"mappings":"AAeA,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,qBAAqB,CAAC;AAIpH,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,QAExD;AAED,iDAAiD;AACjD,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAgB1F"}

package/dist/context/context/create-headless-context.js

@@ -1,43 +1,36 @@
 const ERR_HEADLESSGL_FAILED = 'Failed to create WebGL context in Node.js, headless gl returned null';
-const ERR_HEADLESSGL_LOAD = "  luma.gl: loaded under Node.js without headless gl installed, meaning that WebGL   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 ERR_HEADLESSGL_LOAD = `\
+  luma.gl: loaded under Node.js without headless gl installed, meaning that WebGL \
+  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 = {
-  width: 1,
-  height: 1,
-  debug: true,
-  throwOnError: false
+    width: 1,
+    height: 1,
+    debug: true,
+    throwOnError: false
 };
 let headlessGL = null;
+/** By importing `gl` and registering it with this function, contexts can be created under Node.js */
 export function registerHeadlessGL(headlessgl) {
-  headlessGL = headlessgl;
+    headlessGL = headlessgl;
 }
+/** @returns true if headless gl is registered */
 export function isHeadlessGLRegistered() {
-  return headlessGL !== null;
+    return headlessGL !== null;
 }
+/** Create headless gl context (for running under Node.js) */
 export function createHeadlessContext(options) {
-  options = { ...CONTEXT_DEFAULTS,
-    ...options
-  };
-  const {
-    width,
-    height,
-    webgl1,
-    webgl2
-  } = options;
-
-  if (webgl2 && !webgl1) {
-    throw new Error('headless-gl does not support WebGL2');
-  }
-
-  if (!headlessGL) {
-    throw new Error(ERR_HEADLESSGL_LOAD);
-  }
-
-  const gl = headlessGL(width, height, options);
-
-  if (!gl) {
-    throw new Error(ERR_HEADLESSGL_FAILED);
-  }
-
-  return gl;
+    options = { ...CONTEXT_DEFAULTS, ...options };
+    const { width, height, webgl1, webgl2 } = options;
+    if (webgl2 && !webgl1) {
+        throw new Error('headless-gl does not support WebGL2');
+    }
+    if (!headlessGL) {
+        throw new Error(ERR_HEADLESSGL_LOAD);
+    }
+    const gl = headlessGL(width, height, options);
+    if (!gl) {
+        throw new Error(ERR_HEADLESSGL_FAILED);
+    }
+    return gl;
 }
-//# sourceMappingURL=create-headless-context.js.map

package/dist/context/context/webgl-checks.js

@@ -1,34 +1,39 @@
+// luma.gl, MIT license
 import { assert } from '@luma.gl/api';
 const ERR_CONTEXT = 'Invalid WebGLRenderingContext';
 export const ERR_WEBGL = ERR_CONTEXT;
 export const ERR_WEBGL2 = 'Requires WebGL2';
+/** Check if supplied parameter is a WebGLRenderingContext */
 export function isWebGL(gl) {
-  if (typeof WebGLRenderingContext !== 'undefined' && gl instanceof WebGLRenderingContext) {
-    return true;
-  }
-
-  if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {
-    return true;
-  }
-
-  return Boolean(gl && Number.isFinite(gl._version));
+    if (typeof WebGLRenderingContext !== 'undefined' && gl instanceof WebGLRenderingContext) {
+        return true;
+    }
+    if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {
+        return true;
+    }
+    // Look for debug contexts, headless gl etc
+    return Boolean(gl && Number.isFinite(gl._version));
 }
+/** Check if supplied parameter is a WebGL2RenderingContext */
 export function isWebGL2(gl) {
-  if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {
-    return true;
-  }
-
-  return Boolean(gl && gl._version === 2);
+    if (typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext) {
+        return true;
+    }
+    // Look for debug contexts, headless gl etc
+    return Boolean(gl && gl._version === 2);
 }
+/** Returns a properly typed WebGL2RenderingContext from a WebGL1 context, or null */
 export function getWebGL2Context(gl) {
-  return isWebGL2(gl) ? gl : null;
+    // @ts-expect-error
+    return isWebGL2(gl) ? gl : null;
 }
+/** Throw if supplied parameter is not a WebGLRenderingContext, otherwise return properly typed value */
 export function assertWebGLContext(gl) {
-  assert(isWebGL(gl), ERR_CONTEXT);
-  return gl;
+    assert(isWebGL(gl), ERR_CONTEXT);
+    return gl;
 }
+/** Throw if supplied parameter is not a WebGL2RenderingContext, otherwise return properly typed value */
 export function assertWebGL2Context(gl) {
-  assert(isWebGL2(gl), ERR_WEBGL2);
-  return gl;
+    assert(isWebGL2(gl), ERR_WEBGL2);
+    return gl;
 }
-//# sourceMappingURL=webgl-checks.js.map

package/dist/context/debug/spector.d.ts

@@ -1,6 +1,5 @@
-/// <reference types="offscreencanvas" />
 /** Spector debug initialization options */
-declare type SpectorProps = {
+type SpectorProps = {
     /** Canvas to monitor */
     canvas?: HTMLCanvasElement | OffscreenCanvas;
     /** Whether debug is enabled. Auto-detected if ommitted */

package/dist/context/debug/spector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spector.d.ts","sourceRoot":"","sources":["../../../src/context/debug/spector.ts"],"names":[],"mappings":";AAGA,2CAA2C;AAC3C,aAAK,YAAY,GAAG;IAClB,wBAAwB;IACxB,MAAM,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAC7C,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACrC,CAAC;AAaF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,OAAO,EAAE,GAAG,CAAC;CAClB;AAED,sDAAsD;AACtD,wBAAsB,aAAa,CAAC,KAAK,CAAC,EAAE,YAAY,iBAQvD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,YAAY,OAoDvD"}
+{"version":3,"file":"spector.d.ts","sourceRoot":"","sources":["../../../src/context/debug/spector.ts"],"names":[],"mappings":"AAGA,2CAA2C;AAC3C,KAAK,YAAY,GAAG;IAClB,wBAAwB;IACxB,MAAM,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAC7C,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACrC,CAAC;AAaF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,OAAO,EAAE,GAAG,CAAC;CAClB;AAED,sDAAsD;AACtD,wBAAsB,aAAa,CAAC,KAAK,CAAC,EAAE,YAAY,iBAQvD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,YAAY,OAoDvD"}