@luma.gl/webgl 8.5.8 → 8.6.0-alpha.2

package/dist/{esm/classes/resource.js → classes/webgl-resource.js}

@@ -1,35 +1,51 @@
-import { isWebGL2, assertWebGLContext } from '@luma.gl/gltools';
-import { lumaStats } from '../init';
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+import { Resource, assert, uid, stubRemovedMethods } from '@luma.gl/api';
+import { isWebGL2, assertWebGLContext } from '../context/context/webgl-checks';
 import { getKey, getKeyValue } from '../webgl-utils/constants-to-keys';
-import { assert } from '../utils/assert';
-import { uid } from '../utils/utils';
-import { stubRemovedMethods } from '../utils/stub-methods';
+import WebGLDevice from '../device/webgl-device';
 const ERR_RESOURCE_METHOD_UNDEFINED = 'Resource subclass must define virtual methods';
-export default class Resource {
-  constructor(gl, opts = {}) {
+export default class WebGLResource extends Resource {
+  constructor(device, props, defaultProps) {
+    super(device, props, defaultProps);
+
+    _defineProperty(this, "id", void 0);
+
+    _defineProperty(this, "userData", void 0);
+
+    _defineProperty(this, "device", void 0);
+
+    _defineProperty(this, "gl", void 0);
+
+    _defineProperty(this, "gl2", void 0);
+
+    _defineProperty(this, "_handle", void 0);
+
+    _defineProperty(this, "_bound", false);
+
+    _defineProperty(this, "byteLength", 0);
+
+    this.device = WebGLDevice.attach(device);
+    const gl = this.device.gl;
     assertWebGLContext(gl);
     const {
       id,
       userData = {}
-    } = opts;
+    } = props || {};
     this.gl = gl;
     this.gl2 = gl;
     this.id = id || uid(this.constructor.name);
     this.userData = userData;
-    this._bound = false;
-    this._handle = opts.handle;
+    this._handle = props === null || props === void 0 ? void 0 : props.handle;
 
     if (this._handle === undefined) {
       this._handle = this._createHandle();
     }
 
     this.byteLength = 0;
-
-    this._addStats();
   }
 
   toString() {
-    return `${this.constructor.name}(${this.id})`;
+    return "".concat(this.constructor.name, "(").concat(this.id, ")");
   }
 
   get handle() {
@@ -42,7 +58,7 @@ export default class Resource {
     const children = this._handle && this._deleteHandle(this._handle);
 
     if (this._handle) {
-      this._removeStats();
+      this.removeStats();
     }
 
     this._handle = null;
@@ -82,7 +98,7 @@ export default class Resource {
     this.bind(null);
   }
 
-  getParameter(pname, opts = {}) {
+  getParameter(pname, props = {}) {
     pname = getKeyValue(this.gl, pname);
     assert(pname);
     const parameters = this.constructor.PARAMETERS || {};
@@ -100,7 +116,7 @@ export default class Resource {
       }
     }
 
-    return this._getParameter(pname, opts);
+    return this._getParameter(pname, props);
   }
 
   getParameters(options = {}) {
@@ -166,7 +182,7 @@ export default class Resource {
     return stubRemovedMethods(this, className, version, methodNames);
   }
 
-  initialize(opts) {}
+  initialize(props) {}
 
   _createHandle() {
     throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
@@ -184,7 +200,7 @@ export default class Resource {
     throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
   }
 
-  _getParameter(pname, opts) {
+  _getParameter(pname, props) {
     throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
   }
 
@@ -192,38 +208,5 @@ export default class Resource {
     throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);
   }
 
-  _context() {
-    this.gl.luma = this.gl.luma || {};
-    return this.gl.luma;
-  }
-
-  _addStats() {
-    const name = this.constructor.name;
-    const stats = lumaStats.get('Resource Counts');
-    stats.get('Resources Created').incrementCount();
-    stats.get(`${name}s Created`).incrementCount();
-    stats.get(`${name}s Active`).incrementCount();
-  }
-
-  _removeStats() {
-    const name = this.constructor.name;
-    const stats = lumaStats.get('Resource Counts');
-    stats.get(`${name}s Active`).decrementCount();
-  }
-
-  _trackAllocatedMemory(bytes, name = this.constructor.name) {
-    const stats = lumaStats.get('Memory Usage');
-    stats.get('GPU Memory').addCount(bytes);
-    stats.get(`${name} Memory`).addCount(bytes);
-    this.byteLength = bytes;
-  }
-
-  _trackDeallocatedMemory(name = this.constructor.name) {
-    const stats = lumaStats.get('Memory Usage');
-    stats.get('GPU Memory').subtractCount(this.byteLength);
-    stats.get(`${name} Memory`).subtractCount(this.byteLength);
-    this.byteLength = 0;
-  }
-
 }
-//# sourceMappingURL=resource.js.map
+//# sourceMappingURL=webgl-resource.js.map

package/dist/classes/webgl-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/classes/webgl-resource.ts"],"names":["Resource","assert","uid","stubRemovedMethods","isWebGL2","assertWebGLContext","getKey","getKeyValue","WebGLDevice","ERR_RESOURCE_METHOD_UNDEFINED","WebGLResource","constructor","device","props","defaultProps","attach","gl","id","userData","gl2","name","_handle","handle","undefined","_createHandle","byteLength","toString","delete","deleteChildren","children","_deleteHandle","removeStats","filter","Boolean","forEach","child","bind","funcOrHandle","_bindHandle","value","_bound","unbind","getParameter","pname","parameters","PARAMETERS","parameter","isWebgl2","parameterAvailable","getExtension","extension","webgl1Default","webgl1","webgl2Default","webgl2","defaultValue","_getParameter","getParameters","options","keys","values","parameterKeys","Object","key","type","setParameter","Error","_setParameter","setParameters","className","version","methodNames","initialize","_getOptsFromHandle"],"mappings":"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","sourcesContent":["// luma.gl, MIT license\nimport {Resource, assert, uid, stubRemovedMethods} from '@luma.gl/api';\nimport type {Device} from '@luma.gl/api';\nexport type {ResourceProps} from '@luma.gl/api';\nimport {isWebGL2, assertWebGLContext} from '../context/context/webgl-checks';\nimport {getKey, getKeyValue} from '../webgl-utils/constants-to-keys';\nimport WebGLDevice from '../device/webgl-device';\n\nconst ERR_RESOURCE_METHOD_UNDEFINED = 'Resource subclass must define virtual methods';\n\n/**\n * Base class for WebGL object wrappers\n */\n export default class WebGLResource<Props> extends Resource<Props> {\n  id: string;\n  userData: any;\n  readonly device: WebGLDevice;\n  readonly gl: WebGLRenderingContext;\n  readonly gl2: WebGL2RenderingContext;\n  private _handle: any;\n\n  private _bound = false;\n  // Only meaningful for resources that allocate GPU memory\n  byteLength = 0;\n\n  constructor(device: Device, props: Props, defaultProps: Required<Props>) {\n    super(device, props, defaultProps);\n\n    this.device = WebGLDevice.attach(device);\n    const gl = this.device.gl;\n\n    assertWebGLContext(gl);\n\n    // extends \n    // @ts-expect-error\n    const {id, userData = {}} = props || {};\n    this.gl = gl;\n    this.gl2 = gl as WebGL2RenderingContext;\n    this.id = id || uid(this.constructor.name);\n    this.userData = userData;\n\n    // Set the handle\n    // If handle was provided, use it, otherwise create a new handle\n\n    // TODO - Stores the handle with context loss information\n    // this.glCount = glGetContextLossCount(this.gl);\n\n    // Default VertexArray needs to be created with null handle, so compare against undefined\n    // @ts-expect-error\n    this._handle = props?.handle;\n    if (this._handle === undefined) {\n      this._handle = this._createHandle();\n    }\n\n    this.byteLength = 0;\n  }\n\n  toString(): string {\n    return `${this.constructor.name}(${this.id})`;\n  }\n\n  get handle() {\n    // TODO - Add context loss handling\n    // Will regenerate and reinitialize the handle if necessary\n    // const glCount = glGetContextLossCount(this.gl);\n    // if (this.glCount !== glCount) {\n    //   this._handle = this._createHandle(this.props);\n    //   this._glCount = glCount;\n    //   // Reinitialize object\n    //   this.initialize(this.props);\n    // }\n    return this._handle;\n  }\n\n  delete({deleteChildren = false} = {}) {\n    // Delete this object, and get refs to any children\n    // @ts-expect-error\n    const children = this._handle && this._deleteHandle(this._handle);\n    if (this._handle) {\n      this.removeStats();\n    }\n    this._handle = null;\n\n    // Optionally, recursively delete the children\n    // @ts-expect-error\n    if (children && deleteChildren) {\n      // @ts-expect-error\n      children.filter(Boolean).forEach((child) => child.delete());\n    }\n\n    return this;\n  }\n\n  bind(funcOrHandle = this.handle) {\n    if (typeof funcOrHandle !== 'function') {\n      this._bindHandle(funcOrHandle);\n      return this;\n    }\n\n    let value;\n\n    if (!this._bound) {\n      this._bindHandle(this.handle);\n      this._bound = true;\n\n      value = funcOrHandle();\n\n      this._bound = false;\n      this._bindHandle(null);\n    } else {\n      value = funcOrHandle();\n    }\n\n    return value;\n  }\n\n  unbind() {\n    this.bind(null);\n  }\n\n  /**\n   * Query a Resource parameter\n   *\n   * @param name\n   * @return param\n   */\n  getParameter(pname: number, props = {}): any {\n    pname = getKeyValue(this.gl, pname);\n    assert(pname);\n\n    // @ts-expect-error\n    const parameters = this.constructor.PARAMETERS || {};\n\n    // Use parameter definitions to handle unsupported parameters\n    const parameter = parameters[pname];\n    if (parameter) {\n      const isWebgl2 = isWebGL2(this.gl);\n\n      // Check if we can query for this parameter\n      const parameterAvailable =\n        (!('webgl2' in parameter) || isWebgl2) &&\n        (!('extension' in parameter) || this.gl.getExtension(parameter.extension));\n\n      if (!parameterAvailable) {\n        const webgl1Default = parameter.webgl1;\n        const webgl2Default = 'webgl2' in parameter ? parameter.webgl2 : parameter.webgl1;\n        const defaultValue = isWebgl2 ? webgl2Default : webgl1Default;\n        return defaultValue;\n      }\n    }\n\n    // If unknown parameter - Could be a valid parameter not covered by PARAMS\n    // Attempt to query for it and let WebGL report errors\n    return this._getParameter(pname, props);\n  }\n\n  // Many resources support a getParameter call -\n  // getParameters will get all parameters - slow but useful for debugging\n  // eslint-disable-next-line complexity\n  getParameters(options: {parameters?, keys?} = {}) {\n    const {parameters, keys} = options;\n\n    // Get parameter definitions for this Resource\n    // @ts-expect-error\n    const PARAMETERS = this.constructor.PARAMETERS || {};\n\n    const isWebgl2 = isWebGL2(this.gl);\n\n    const values = {};\n\n    // Query all parameters if no list provided\n    const parameterKeys = parameters || Object.keys(PARAMETERS);\n\n    // WEBGL limits\n    for (const pname of parameterKeys) {\n      const parameter = PARAMETERS[pname];\n\n      // Check if this parameter is available on this platform\n      const parameterAvailable =\n        parameter &&\n        (!('webgl2' in parameter) || isWebgl2) &&\n        (!('extension' in parameter) || this.gl.getExtension(parameter.extension));\n\n      if (parameterAvailable) {\n        const key = keys ? getKey(this.gl, pname) : pname;\n        values[key] = this.getParameter(pname, options);\n        if (keys && parameter.type === 'GLenum') {\n          values[key] = getKey(this.gl, values[key]);\n        }\n      }\n    }\n\n    return values;\n  }\n\n  /**\n   * Update a Resource setting\n   *\n   * @todo - cache parameter to avoid issuing WebGL calls?\n   *\n   * @param {string} pname - parameter (GL constant, value or key)\n   * @param {GLint|GLfloat|GLenum} value\n   * @return {Resource} returns self to enable chaining\n   */\n  setParameter(pname, value) {\n    pname = getKeyValue(this.gl, pname);\n    assert(pname);\n\n    // @ts-expect-error\n    const parameters = this.constructor.PARAMETERS || {};\n\n    const parameter = parameters[pname];\n    if (parameter) {\n      const isWebgl2 = isWebGL2(this.gl);\n\n      // Check if this parameter is available on this platform\n      const parameterAvailable =\n        (!('webgl2' in parameter) || isWebgl2) &&\n        (!('extension' in parameter) || this.gl.getExtension(parameter.extension));\n\n      if (!parameterAvailable) {\n        throw new Error('Parameter not available on this platform');\n      }\n\n      // Handle string keys\n      if (parameter.type === 'GLenum') {\n        // @ts-expect-error\n        value = getKeyValue(value);\n      }\n    }\n\n    // If unknown parameter - Could be a valid parameter not covered by PARAMS\n    // attempt to set it and let WebGL report errors\n    this._setParameter(pname, value);\n    return this;\n  }\n\n  /*\n   * Batch update resource parameters\n   * Assumes the subclass supports a setParameter call\n   */\n  setParameters(parameters) {\n    for (const pname in parameters) {\n      this.setParameter(pname, parameters[pname]);\n    }\n    return this;\n  }\n\n  // Install stubs for removed methods\n  stubRemovedMethods(className, version, methodNames) {\n    return stubRemovedMethods(this, className, version, methodNames);\n  }\n\n  // PUBLIC VIRTUAL METHODS\n  initialize(props) {}\n\n  // PROTECTED METHODS - These must be overridden by subclass\n  _createHandle() {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _deleteHandle() {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _bindHandle(handle) {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _getOptsFromHandle() {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _getParameter(pname, props): number {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  _setParameter(pname, value) {\n    throw new Error(ERR_RESOURCE_METHOD_UNDEFINED);\n  }\n\n  // PRIVATE METHODS\n\n  /*\n  _addStats() {\n    const name = this.constructor.name;\n    const stats = lumaStats.get('Resource Counts');\n\n    stats.get('Resources Created').incrementCount();\n    stats.get(`${name}s Created`).incrementCount();\n    stats.get(`${name}s Active`).incrementCount();\n  }\n\n  _removeStats() {\n    const name = this.constructor.name;\n    const stats = lumaStats.get('Resource Counts');\n\n    stats.get(`${name}s Active`).decrementCount();\n  }\n\n  trackAllocatedMemory(bytes, name = this.constructor.name) {\n    const stats = lumaStats.get('Memory Usage');\n\n    stats.get('GPU Memory').addCount(bytes);\n    stats.get(`${name} Memory`).addCount(bytes);\n    this.byteLength = bytes;\n  }\n\n  trackDeallocatedMemory(name = this.constructor.name) {\n    const stats = lumaStats.get('Memory Usage');\n\n    stats.get('GPU Memory').subtractCount(this.byteLength);\n    stats.get(`${name} Memory`).subtractCount(this.byteLength);\n    this.byteLength = 0;\n  }\n  */\n}\n"],"file":"webgl-resource.js"}

package/dist/classes/webgl-shader.d.ts

@@ -0,0 +1,53 @@
+import { Shader as ShaderAPI, ShaderProps } from '@luma.gl/api';
+import GL from '@luma.gl/constants';
+import { CompilerMessage } from '@luma.gl/shadertools';
+import WebGLDevice from '../device/webgl-device';
+export type { ShaderProps };
+export declare class WEBGLShader extends ShaderAPI {
+    readonly device: WebGLDevice;
+    readonly gl: WebGLRenderingContext;
+    readonly handle: WebGLShader;
+    readonly stage: 'vertex' | 'fragment';
+    constructor(gl: WebGLRenderingContext, props: ShaderProps);
+    destroy(): void;
+    compilationInfo(): Promise<readonly CompilerMessage[]>;
+    _compile(source: any): void;
+}
+/**
+ * Encapsulates the compiled or linked Shaders that execute portions of the WebGL Pipeline
+ * For now this is an internal class
+ */
+export declare class Shader extends WEBGLShader {
+    shaderType: GL.FRAGMENT_SHADER | GL.VERTEX_SHADER;
+    source: string;
+    static getTypeName(shaderType: any): 'vertex-shader' | 'fragment-shader' | 'unknown';
+    constructor(gl: WebGLRenderingContext, props: Omit<ShaderProps, 'stage'>);
+    initialize(props: ShaderProps): this;
+    getParameter(pname: number): any;
+    toString(): string;
+    getName(): string;
+    getSource(): string;
+    /** Debug method - Returns translated source if available */
+    getTranslatedSource(): string;
+    _getOptsFromHandle(): {
+        type: any;
+        source: string;
+    };
+}
+/**
+ * Encapsulates the compiled or linked Shaders that execute portions of the WebGL Pipeline
+ * @deprecated Use `device.createShader({stage: 'vertex', ...})`
+ */
+export declare class VertexShader extends Shader {
+    constructor(gl: WebGLRenderingContext, props: Omit<ShaderProps, 'stage'> | string);
+    _createHandle(): WebGLShader;
+}
+/**
+ * Encapsulates the compiled or linked Shaders that execute portions of the WebGL Pipeline
+ * @deprecated Use `device.createShader({stage: 'fragment', ...})`
+ */
+export declare class FragmentShader extends Shader {
+    constructor(gl: WebGLRenderingContext, props: Omit<ShaderProps, 'stage'> | string);
+    _createHandle(): WebGLShader;
+}
+//# sourceMappingURL=webgl-shader.d.ts.map

package/dist/classes/webgl-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl-shader.d.ts","sourceRoot":"","sources":["../../src/classes/webgl-shader.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,MAAM,IAAI,SAAS,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpC,OAAO,EAAgB,eAAe,EAAoB,MAAM,sBAAsB,CAAC;AAGvF,OAAO,WAAW,MAAM,wBAAwB,CAAC;AAKjD,YAAY,EAAC,WAAW,EAAC,CAAC;AAE1B,qBAAa,WAAY,SAAQ,SAAS;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAAC;gBAE1B,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW;IAkBzD,OAAO,IAAI,IAAI;IAST,eAAe,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAM5D,QAAQ,CAAC,MAAM,KAAA;CAqBhB;AAED;;;GAGG;AACH,qBAAa,MAAO,SAAQ,WAAW;IACrC,UAAU,EAAE,EAAE,CAAC,eAAe,GAAG,EAAE,CAAC,aAAa,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,GAAG,eAAe,GAAG,iBAAiB,GAAG,SAAS;gBAYxE,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAgBxE,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAWpC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;IAIhC,QAAQ,IAAI,MAAM;IAIlB,OAAO,IAAI,MAAM;IAIjB,SAAS,IAAI,MAAM;IAInB,4DAA4D;IAC5D,mBAAmB,IAAI,MAAM;IAS7B,kBAAkB;;;;CAMnB;AAED;;;GAGG;AACF,qBAAa,YAAa,SAAQ,MAAM;gBAC3B,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM;IAKjF,aAAa;CAGd;AAED;;;GAGG;AACF,qBAAa,cAAe,SAAQ,MAAM;gBAC7B,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM;IAKjF,aAAa;CAGd"}

package/dist/classes/webgl-shader.js

@@ -0,0 +1,193 @@
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+import { log, assert, uid, Shader as ShaderAPI } from '@luma.gl/api';
+import GL from '@luma.gl/constants';
+import { getShaderInfo, formatCompilerLog } from '@luma.gl/shadertools';
+import { assertWebGLContext } from '../context/context/webgl-checks';
+import { parseShaderCompilerLog } from '../webgl-utils/parse-shader-compiler-log';
+import WebGLDevice from '../device/webgl-device';
+const ERR_SOURCE = 'Shader: GLSL source code must be a JavaScript string';
+export class WEBGLShader extends ShaderAPI {
+  constructor(gl, props) {
+    super(WebGLDevice.attach(gl), {
+      id: getShaderIdFromProps(props),
+      ...props
+    });
+
+    _defineProperty(this, "device", void 0);
+
+    _defineProperty(this, "gl", void 0);
+
+    _defineProperty(this, "handle", void 0);
+
+    _defineProperty(this, "stage", void 0);
+
+    this.device = WebGLDevice.attach(gl);
+    this.gl = gl;
+
+    switch (this.props.stage) {
+      case 'vertex':
+        this.handle = this.props.handle || this.gl.createShader(GL.VERTEX_SHADER);
+        break;
+
+      case 'fragment':
+        this.handle = this.props.handle || this.gl.createShader(GL.FRAGMENT_SHADER);
+        break;
+
+      default:
+        throw new Error(this.props.stage);
+    }
+
+    this.stage = this.props.stage;
+
+    this._compile(props.source);
+  }
+
+  destroy() {
+    if (this.handle) {
+      this.removeStats();
+      this.gl.deleteShader(this.handle);
+      this.handle = null;
+    }
+  }
+
+  async compilationInfo() {
+    const log = this.gl.getShaderInfoLog(this.handle);
+    return parseShaderCompilerLog(log);
+  }
+
+  _compile(source) {
+    if (!source.startsWith('#version ')) {
+      source = "#version 100\n".concat(source);
+    }
+
+    this.gl.shaderSource(this.handle, source);
+    this.gl.compileShader(this.handle);
+    const compileStatus = this.gl.getShaderParameter(this.handle, GL.COMPILE_STATUS);
+
+    if (!compileStatus) {
+      const shaderLog = this.gl.getShaderInfoLog(this.handle);
+      const messages = parseShaderCompilerLog(shaderLog).filter(message => message.type === 'error');
+      const formattedLog = formatCompilerLog(messages, source);
+      const shaderName = getShaderInfo(source).name;
+      const shaderDescription = "".concat(this.stage, " shader ").concat(shaderName);
+      log.error("GLSL compilation errors in ".concat(shaderName, "\n").concat(formattedLog))();
+      throw new Error("GLSL compilation errors in ".concat(shaderName));
+    }
+  }
+
+}
+export class Shader extends WEBGLShader {
+  static getTypeName(shaderType) {
+    switch (shaderType) {
+      case GL.VERTEX_SHADER:
+        return 'vertex-shader';
+
+      case GL.FRAGMENT_SHADER:
+        return 'fragment-shader';
+
+      default:
+        assert(false);
+        return 'unknown';
+    }
+  }
+
+  constructor(gl, props) {
+    assertWebGLContext(gl);
+    assert(typeof props.source === 'string', ERR_SOURCE);
+    super(gl, { ...props,
+      id: getShaderIdFromProps(props),
+      stage: props.shaderType === GL.VERTEX_SHADER ? 'vertex' : 'fragment'
+    });
+
+    _defineProperty(this, "shaderType", void 0);
+
+    _defineProperty(this, "source", void 0);
+
+    this.shaderType = props.shaderType;
+    this.source = props.source;
+    const shaderName = getShaderInfo(props.source).name;
+
+    if (shaderName) {
+      this.id = uid(shaderName);
+    }
+  }
+
+  initialize(props) {
+    this._compile(props.source);
+
+    const shaderName = getShaderInfo(props.source).name;
+
+    if (shaderName) {
+      this.id = uid(shaderName);
+    }
+
+    return this;
+  }
+
+  getParameter(pname) {
+    return this.gl.getShaderParameter(this.handle, pname);
+  }
+
+  toString() {
+    return "".concat(Shader.getTypeName(this.shaderType), ":").concat(this.id);
+  }
+
+  getName() {
+    return getShaderInfo(this.source).name || 'unnamed-shader';
+  }
+
+  getSource() {
+    return this.gl.getShaderSource(this.handle);
+  }
+
+  getTranslatedSource() {
+    const extension = this.gl.getExtension('WEBGL_debug_shaders');
+    return extension ? extension.getTranslatedShaderSource(this.handle) : 'No translated source available. WEBGL_debug_shaders not implemented';
+  }
+
+  _getOptsFromHandle() {
+    return {
+      type: this.getParameter(GL.SHADER_TYPE),
+      source: this.getSource()
+    };
+  }
+
+}
+export class VertexShader extends Shader {
+  constructor(gl, props) {
+    super(gl, getShaderProps(props, GL.VERTEX_SHADER));
+  }
+
+  _createHandle() {
+    return this.gl.createShader(GL.VERTEX_SHADER);
+  }
+
+}
+export class FragmentShader extends Shader {
+  constructor(gl, props) {
+    super(gl, getShaderProps(props, GL.FRAGMENT_SHADER));
+  }
+
+  _createHandle() {
+    return this.gl.createShader(GL.FRAGMENT_SHADER);
+  }
+
+}
+
+function getShaderProps(props, shaderType) {
+  if (typeof props === 'string') {
+    return {
+      source: props,
+      shaderType
+    };
+  }
+
+  return { ...props,
+    shaderType
+  };
+}
+
+function getShaderIdFromProps(props) {
+  return getShaderInfo(props.source).name || props.id || uid("unnamed ".concat(props.stage || Shader.getTypeName(props.shaderType)));
+}
+//# sourceMappingURL=webgl-shader.js.map

package/dist/classes/webgl-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/classes/webgl-shader.ts"],"names":["log","assert","uid","Shader","ShaderAPI","GL","getShaderInfo","formatCompilerLog","assertWebGLContext","parseShaderCompilerLog","WebGLDevice","ERR_SOURCE","WEBGLShader","constructor","gl","props","attach","id","getShaderIdFromProps","device","stage","handle","createShader","VERTEX_SHADER","FRAGMENT_SHADER","Error","_compile","source","destroy","removeStats","deleteShader","compilationInfo","getShaderInfoLog","startsWith","shaderSource","compileShader","compileStatus","getShaderParameter","COMPILE_STATUS","shaderLog","messages","filter","message","type","formattedLog","shaderName","name","shaderDescription","error","getTypeName","shaderType","initialize","getParameter","pname","toString","getName","getSource","getShaderSource","getTranslatedSource","extension","getExtension","getTranslatedShaderSource","_getOptsFromHandle","SHADER_TYPE","VertexShader","getShaderProps","_createHandle","FragmentShader"],"mappings":";AACA,SAAQA,GAAR,EAAaC,MAAb,EAAqBC,GAArB,EAA0BC,MAAM,IAAIC,SAApC,QAAiE,cAAjE;AACA,OAAOC,EAAP,MAAe,oBAAf;AACA,SAAQC,aAAR,EAAwCC,iBAAxC,QAAgE,sBAAhE;AACA,SAAQC,kBAAR,QAAiC,iCAAjC;AACA,SAAQC,sBAAR,QAAqC,0CAArC;AACA,OAAOC,WAAP,MAAwB,wBAAxB;AAEA,MAAMC,UAAU,GAAG,sDAAnB;AAKA,OAAO,MAAMC,WAAN,SAA0BR,SAA1B,CAAoC;AAOzCS,EAAAA,WAAW,CAACC,EAAD,EAA4BC,KAA5B,EAAgD;AACzD,UAAML,WAAW,CAACM,MAAZ,CAAmBF,EAAnB,CAAN,EAA8B;AAACG,MAAAA,EAAE,EAAEC,oBAAoB,CAACH,KAAD,CAAzB;AAAkC,SAAGA;AAArC,KAA9B;;AADyD;;AAAA;;AAAA;;AAAA;;AAEzD,SAAKI,MAAL,GAAcT,WAAW,CAACM,MAAZ,CAAmBF,EAAnB,CAAd;AACA,SAAKA,EAAL,GAAUA,EAAV;;AACA,YAAQ,KAAKC,KAAL,CAAWK,KAAnB;AACE,WAAK,QAAL;AACE,aAAKC,MAAL,GAAc,KAAKN,KAAL,CAAWM,MAAX,IAAqB,KAAKP,EAAL,CAAQQ,YAAR,CAAqBjB,EAAE,CAACkB,aAAxB,CAAnC;AACA;;AACF,WAAK,UAAL;AACE,aAAKF,MAAL,GAAc,KAAKN,KAAL,CAAWM,MAAX,IAAqB,KAAKP,EAAL,CAAQQ,YAAR,CAAqBjB,EAAE,CAACmB,eAAxB,CAAnC;AACA;;AACF;AACE,cAAM,IAAIC,KAAJ,CAAU,KAAKV,KAAL,CAAWK,KAArB,CAAN;AARJ;;AAUA,SAAKA,KAAL,GAAa,KAAKL,KAAL,CAAWK,KAAxB;;AACA,SAAKM,QAAL,CAAcX,KAAK,CAACY,MAApB;AACD;;AAEDC,EAAAA,OAAO,GAAS;AACd,QAAI,KAAKP,MAAT,EAAiB;AACf,WAAKQ,WAAL;AACA,WAAKf,EAAL,CAAQgB,YAAR,CAAqB,KAAKT,MAA1B;AAEA,WAAKA,MAAL,GAAc,IAAd;AACD;AACF;;AAEoB,QAAfU,eAAe,GAAwC;AAC3D,UAAM/B,GAAG,GAAG,KAAKc,EAAL,CAAQkB,gBAAR,CAAyB,KAAKX,MAA9B,CAAZ;AACA,WAAOZ,sBAAsB,CAACT,GAAD,CAA7B;AACD;;AAGD0B,EAAAA,QAAQ,CAACC,MAAD,EAAS;AACf,QAAI,CAACA,MAAM,CAACM,UAAP,CAAkB,WAAlB,CAAL,EAAqC;AACnCN,MAAAA,MAAM,2BAAoBA,MAApB,CAAN;AACD;;AACD,SAAKb,EAAL,CAAQoB,YAAR,CAAqB,KAAKb,MAA1B,EAAkCM,MAAlC;AACA,SAAKb,EAAL,CAAQqB,aAAR,CAAsB,KAAKd,MAA3B;AAKA,UAAMe,aAAa,GAAG,KAAKtB,EAAL,CAAQuB,kBAAR,CAA2B,KAAKhB,MAAhC,EAAwChB,EAAE,CAACiC,cAA3C,CAAtB;;AACA,QAAI,CAACF,aAAL,EAAoB;AAClB,YAAMG,SAAS,GAAG,KAAKzB,EAAL,CAAQkB,gBAAR,CAAyB,KAAKX,MAA9B,CAAlB;AACA,YAAMmB,QAAQ,GAAG/B,sBAAsB,CAAC8B,SAAD,CAAtB,CAAkCE,MAAlC,CAAyCC,OAAO,IAAIA,OAAO,CAACC,IAAR,KAAiB,OAArE,CAAjB;AACA,YAAMC,YAAY,GAAGrC,iBAAiB,CAACiC,QAAD,EAAWb,MAAX,CAAtC;AACA,YAAMkB,UAAkB,GAAGvC,aAAa,CAACqB,MAAD,CAAb,CAAsBmB,IAAjD;AACA,YAAMC,iBAAiB,aAAM,KAAK3B,KAAX,qBAA2ByB,UAA3B,CAAvB;AACA7C,MAAAA,GAAG,CAACgD,KAAJ,sCAAwCH,UAAxC,eAAuDD,YAAvD;AACA,YAAM,IAAInB,KAAJ,sCAAwCoB,UAAxC,EAAN;AACD;AACF;;AA5DwC;AAmE3C,OAAO,MAAM1C,MAAN,SAAqBS,WAArB,CAAiC;AAIpB,SAAXqC,WAAW,CAACC,UAAD,EAAmE;AACnF,YAAQA,UAAR;AACE,WAAK7C,EAAE,CAACkB,aAAR;AACE,eAAO,eAAP;;AACF,WAAKlB,EAAE,CAACmB,eAAR;AACE,eAAO,iBAAP;;AACF;AACEvB,QAAAA,MAAM,CAAC,KAAD,CAAN;AACA,eAAO,SAAP;AAPJ;AASD;;AAEDY,EAAAA,WAAW,CAACC,EAAD,EAA4BC,KAA5B,EAA+D;AACxEP,IAAAA,kBAAkB,CAACM,EAAD,CAAlB;AACAb,IAAAA,MAAM,CAAC,OAAOc,KAAK,CAACY,MAAb,KAAwB,QAAzB,EAAmChB,UAAnC,CAAN;AAGA,UAAMG,EAAN,EAAU,EAAC,GAAGC,KAAJ;AAAWE,MAAAA,EAAE,EAAEC,oBAAoB,CAACH,KAAD,CAAnC;AAA4CK,MAAAA,KAAK,EAAEL,KAAK,CAACmC,UAAN,KAAqB7C,EAAE,CAACkB,aAAxB,GAAwC,QAAxC,GAAmD;AAAtG,KAAV;;AALwE;;AAAA;;AAOxE,SAAK2B,UAAL,GAAkBnC,KAAK,CAACmC,UAAxB;AACA,SAAKvB,MAAL,GAAcZ,KAAK,CAACY,MAApB;AAEA,UAAMkB,UAAU,GAAGvC,aAAa,CAACS,KAAK,CAACY,MAAP,CAAb,CAA4BmB,IAA/C;;AACA,QAAID,UAAJ,EAAgB;AACd,WAAK5B,EAAL,GAAUf,GAAG,CAAC2C,UAAD,CAAb;AACD;AACF;;AAEDM,EAAAA,UAAU,CAACpC,KAAD,EAA2B;AACnC,SAAKW,QAAL,CAAcX,KAAK,CAACY,MAApB;;AACA,UAAMkB,UAAU,GAAGvC,aAAa,CAACS,KAAK,CAACY,MAAP,CAAb,CAA4BmB,IAA/C;;AACA,QAAID,UAAJ,EAAgB;AACd,WAAK5B,EAAL,GAAUf,GAAG,CAAC2C,UAAD,CAAb;AACD;;AACD,WAAO,IAAP;AACD;;AAIDO,EAAAA,YAAY,CAACC,KAAD,EAAqB;AAC/B,WAAO,KAAKvC,EAAL,CAAQuB,kBAAR,CAA2B,KAAKhB,MAAhC,EAAwCgC,KAAxC,CAAP;AACD;;AAEDC,EAAAA,QAAQ,GAAW;AACjB,qBAAUnD,MAAM,CAAC8C,WAAP,CAAmB,KAAKC,UAAxB,CAAV,cAAiD,KAAKjC,EAAtD;AACD;;AAEDsC,EAAAA,OAAO,GAAW;AAChB,WAAOjD,aAAa,CAAC,KAAKqB,MAAN,CAAb,CAA2BmB,IAA3B,IAAmC,gBAA1C;AACD;;AAEDU,EAAAA,SAAS,GAAW;AAClB,WAAO,KAAK1C,EAAL,CAAQ2C,eAAR,CAAwB,KAAKpC,MAA7B,CAAP;AACD;;AAGDqC,EAAAA,mBAAmB,GAAW;AAC5B,UAAMC,SAAS,GAAG,KAAK7C,EAAL,CAAQ8C,YAAR,CAAqB,qBAArB,CAAlB;AACA,WAAOD,SAAS,GACZA,SAAS,CAACE,yBAAV,CAAoC,KAAKxC,MAAzC,CADY,GAEZ,qEAFJ;AAGD;;AAIDyC,EAAAA,kBAAkB,GAAG;AACnB,WAAO;AACLnB,MAAAA,IAAI,EAAE,KAAKS,YAAL,CAAkB/C,EAAE,CAAC0D,WAArB,CADD;AAELpC,MAAAA,MAAM,EAAE,KAAK6B,SAAL;AAFH,KAAP;AAID;;AA1EqC;AAiFvC,OAAO,MAAMQ,YAAN,SAA2B7D,MAA3B,CAAkC;AACxCU,EAAAA,WAAW,CAACC,EAAD,EAA4BC,KAA5B,EAAwE;AACjF,UAAMD,EAAN,EAAUmD,cAAc,CAAClD,KAAD,EAAQV,EAAE,CAACkB,aAAX,CAAxB;AACD;;AAGD2C,EAAAA,aAAa,GAAG;AACd,WAAO,KAAKpD,EAAL,CAAQQ,YAAR,CAAqBjB,EAAE,CAACkB,aAAxB,CAAP;AACD;;AARuC;AAezC,OAAO,MAAM4C,cAAN,SAA6BhE,MAA7B,CAAoC;AAC1CU,EAAAA,WAAW,CAACC,EAAD,EAA4BC,KAA5B,EAAwE;AACjF,UAAMD,EAAN,EAAUmD,cAAc,CAAClD,KAAD,EAAQV,EAAE,CAACmB,eAAX,CAAxB;AACD;;AAGD0C,EAAAA,aAAa,GAAG;AACd,WAAO,KAAKpD,EAAL,CAAQQ,YAAR,CAAqBjB,EAAE,CAACmB,eAAxB,CAAP;AACD;;AARyC;;AAa5C,SAASyC,cAAT,CAAwBlD,KAAxB,EAAoEmC,UAApE,EAAmJ;AACjJ,MAAI,OAAOnC,KAAP,KAAiB,QAArB,EAA+B;AAC7B,WAAO;AAACY,MAAAA,MAAM,EAAEZ,KAAT;AAAgBmC,MAAAA;AAAhB,KAAP;AACD;;AACD,SAAO,EAAC,GAAGnC,KAAJ;AAAWmC,IAAAA;AAAX,GAAP;AACD;;AAGD,SAAShC,oBAAT,CAA8BH,KAA9B,EAA0D;AACxD,SAAOT,aAAa,CAACS,KAAK,CAACY,MAAP,CAAb,CAA4BmB,IAA5B,IACL/B,KAAK,CAACE,EADD,IAELf,GAAG,mBAAYa,KAAK,CAACK,KAAN,IAAejB,MAAM,CAAC8C,WAAP,CAAmBlC,KAAK,CAACmC,UAAzB,CAA3B,EAFL;AAGD","sourcesContent":["// luma.gl, MIT license\nimport {log, assert, uid, Shader as ShaderAPI, ShaderProps} from '@luma.gl/api';\nimport GL from '@luma.gl/constants';\nimport {getShaderInfo, CompilerMessage, formatCompilerLog} from '@luma.gl/shadertools';\nimport {assertWebGLContext} from '../context/context/webgl-checks';\nimport {parseShaderCompilerLog} from '../webgl-utils/parse-shader-compiler-log';\nimport WebGLDevice from '../device/webgl-device';\n\nconst ERR_SOURCE = 'Shader: GLSL source code must be a JavaScript string';\n\n\nexport type {ShaderProps};\n\nexport class WEBGLShader extends ShaderAPI {\n  readonly device: WebGLDevice;\n  readonly gl: WebGLRenderingContext;\n  readonly handle: WebGLShader;\n\n  readonly stage: 'vertex' | 'fragment';\n\n  constructor(gl: WebGLRenderingContext, props: ShaderProps) {\n    super(WebGLDevice.attach(gl), {id: getShaderIdFromProps(props), ...props});\n    this.device = WebGLDevice.attach(gl);\n    this.gl = gl;\n    switch (this.props.stage) {\n      case 'vertex':\n        this.handle = this.props.handle || this.gl.createShader(GL.VERTEX_SHADER);\n        break;\n      case 'fragment':\n        this.handle = this.props.handle || this.gl.createShader(GL.FRAGMENT_SHADER);\n        break;\n      default:\n        throw new Error(this.props.stage);\n    }\n    this.stage = this.props.stage;\n    this._compile(props.source);\n  }\n\n  destroy(): void {\n    if (this.handle) {\n      this.removeStats();\n      this.gl.deleteShader(this.handle);\n      // @ts-expect-error\n      this.handle = null;\n    }\n  }  \n  \n  async compilationInfo(): Promise<readonly CompilerMessage[]> {\n    const log = this.gl.getShaderInfoLog(this.handle);\n    return parseShaderCompilerLog(log);\n  }\n\n  // PRIVATE METHODS\n  _compile(source) {\n    if (!source.startsWith('#version ')) {\n      source = `#version 100\\n${source}`;\n    }\n    this.gl.shaderSource(this.handle, source);\n    this.gl.compileShader(this.handle);\n\n    // TODO - For performance reasons, avoid checking shader compilation errors on production?\n    // TODO - Load log even when no error reported, to catch warnings?\n    // https://gamedev.stackexchange.com/questions/30429/how-to-detect-glsl-warnings\n    const compileStatus = this.gl.getShaderParameter(this.handle, GL.COMPILE_STATUS);\n    if (!compileStatus) {\n      const shaderLog = this.gl.getShaderInfoLog(this.handle);\n      const messages = parseShaderCompilerLog(shaderLog).filter(message => message.type === 'error');\n      const formattedLog = formatCompilerLog(messages, source);\n      const shaderName: string = getShaderInfo(source).name;\n      const shaderDescription = `${this.stage} shader ${shaderName}`;\n      log.error(`GLSL compilation errors in ${shaderName}\\n${formattedLog}`)();\n      throw new Error(`GLSL compilation errors in ${shaderName}`);\n    }\n  }\n}\n \n/**\n * Encapsulates the compiled or linked Shaders that execute portions of the WebGL Pipeline\n * For now this is an internal class\n */\nexport class Shader extends WEBGLShader {\n  shaderType: GL.FRAGMENT_SHADER | GL.VERTEX_SHADER;\n  source: string;\n\n  static getTypeName(shaderType: any): 'vertex-shader' | 'fragment-shader' | 'unknown' {\n    switch (shaderType) {\n      case GL.VERTEX_SHADER:\n        return 'vertex-shader';\n      case GL.FRAGMENT_SHADER:\n        return 'fragment-shader';\n      default:\n        assert(false);\n        return 'unknown';\n    }\n  }\n\n  constructor(gl: WebGLRenderingContext, props: Omit<ShaderProps, 'stage'>) {\n    assertWebGLContext(gl);\n    assert(typeof props.source === 'string', ERR_SOURCE);\n\n    // @ts-expect-error\n    super(gl, {...props, id: getShaderIdFromProps(props), stage: props.shaderType === GL.VERTEX_SHADER ? 'vertex' : 'fragment'});\n\n    this.shaderType = props.shaderType;\n    this.source = props.source;\n\n    const shaderName = getShaderInfo(props.source).name;\n    if (shaderName) {\n      this.id = uid(shaderName);\n    }\n  }\n\n  initialize(props: ShaderProps): this {\n    this._compile(props.source);\n    const shaderName = getShaderInfo(props.source).name;\n    if (shaderName) {\n      this.id = uid(shaderName);\n    }\n    return this;\n  }\n\n  // Accessors\n\n  getParameter(pname: number): any {\n    return this.gl.getShaderParameter(this.handle, pname);\n  }\n\n  toString(): string {\n    return `${Shader.getTypeName(this.shaderType)}:${this.id}`;\n  }\n\n  getName(): string {\n    return getShaderInfo(this.source).name || 'unnamed-shader';\n  }\n\n  getSource(): string {\n    return this.gl.getShaderSource(this.handle);\n  }\n\n  /** Debug method - Returns translated source if available */\n  getTranslatedSource(): string {\n    const extension = this.gl.getExtension('WEBGL_debug_shaders');\n    return extension\n      ? extension.getTranslatedShaderSource(this.handle)\n      : 'No translated source available. WEBGL_debug_shaders not implemented';\n  }\n\n  // PRIVATE METHODS\n\n  _getOptsFromHandle() {\n    return {\n      type: this.getParameter(GL.SHADER_TYPE),\n      source: this.getSource()\n    };\n  }\n}\n\n/**\n * Encapsulates the compiled or linked Shaders that execute portions of the WebGL Pipeline\n * @deprecated Use `device.createShader({stage: 'vertex', ...})`\n */\n export class VertexShader extends Shader {\n  constructor(gl: WebGLRenderingContext, props: Omit<ShaderProps, 'stage'> | string) {\n    super(gl, getShaderProps(props, GL.VERTEX_SHADER));\n  }\n\n  // PRIVATE METHODS\n  _createHandle() {\n    return this.gl.createShader(GL.VERTEX_SHADER);\n  }\n}\n\n/**\n * Encapsulates the compiled or linked Shaders that execute portions of the WebGL Pipeline\n * @deprecated Use `device.createShader({stage: 'fragment', ...})`\n */\n export class FragmentShader extends Shader {\n  constructor(gl: WebGLRenderingContext, props: Omit<ShaderProps, 'stage'> | string) {\n    super(gl, getShaderProps(props, GL.FRAGMENT_SHADER));\n  }\n\n  // PRIVATE METHODS\n  _createHandle() {\n    return this.gl.createShader(GL.FRAGMENT_SHADER);\n  }\n}\n\n// HELPERS\n\nfunction getShaderProps(props: Omit<ShaderProps, 'stage'> | string, shaderType: GL.VERTEX_SHADER | GL.FRAGMENT_SHADER): Omit<ShaderProps, 'stage'> {\n  if (typeof props === 'string') {\n    return {source: props, shaderType};\n  }\n  return {...props, shaderType};\n}\n\n/** Deduce an id, from shader source, or supplied id, or shader type */\nfunction getShaderIdFromProps(props: ShaderProps): string {\n  return getShaderInfo(props.source).name ||\n    props.id ||\n    uid(`unnamed ${props.stage || Shader.getTypeName(props.shaderType)}`);\n}\n"],"file":"webgl-shader.js"}

package/dist/context/context/context-state.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stores luma.gl specific state associated with a context
+ */
+export interface ContextState {
+    _canvasSizeInfo: {
+        clientWidth: number;
+        clientHeight: number;
+        devicePixelRatio: number;
+    };
+    _polyfilled: boolean;
+    _extensions: Record<string, any>;
+}
+/**
+ * Gets luma.gl specific state from a context
+ * @returns context state
+ */
+export declare function getContextState(gl: WebGLRenderingContext): ContextState;
+//# sourceMappingURL=context-state.d.ts.map

package/dist/context/context/context-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-state.d.ts","sourceRoot":"","sources":["../../../src/context/context/context-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,qBAAqB,GAAG,YAAY,CAqBvE"}

package/dist/context/context/context-state.js

@@ -0,0 +1,26 @@
+export function getContextState(gl) {
+  const {
+    device,
+    luma
+  } = gl;
+
+  if (device) {
+    return device;
+  }
+
+  if (!luma) {
+    const contextState = {
+      _canvasSizeInfo: {
+        clientWidth: 0,
+        clientHeight: 0,
+        devicePixelRatio: 1
+      },
+      _polyfilled: false,
+      _extensions: {}
+    };
+    gl.luma = contextState;
+  }
+
+  return gl.luma;
+}
+//# sourceMappingURL=context-state.js.map

package/dist/context/context/context-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/context/context/context-state.ts"],"names":["getContextState","gl","device","luma","contextState","_canvasSizeInfo","clientWidth","clientHeight","devicePixelRatio","_polyfilled","_extensions"],"mappings":"AAiBA,OAAO,SAASA,eAAT,CAAyBC,EAAzB,EAAkE;AAEvE,QAAM;AAACC,IAAAA,MAAD;AAASC,IAAAA;AAAT,MAAiBF,EAAvB;;AACA,MAAIC,MAAJ,EAAY;AACV,WAAOA,MAAP;AACD;;AACD,MAAI,CAACC,IAAL,EAAW;AACT,UAAMC,YAA0B,GAAG;AACjCC,MAAAA,eAAe,EAAE;AACfC,QAAAA,WAAW,EAAE,CADE;AAEfC,QAAAA,YAAY,EAAE,CAFC;AAGfC,QAAAA,gBAAgB,EAAE;AAHH,OADgB;AAMjCC,MAAAA,WAAW,EAAE,KANoB;AAOjCC,MAAAA,WAAW,EAAE;AAPoB,KAAnC;AAUAT,IAAAA,EAAE,CAACE,IAAH,GAAUC,YAAV;AACD;;AAED,SAAOH,EAAE,CAACE,IAAV;AACD","sourcesContent":["/**\n * Stores luma.gl specific state associated with a context\n */\nexport interface ContextState {\n  _canvasSizeInfo: {\n    clientWidth: number;\n    clientHeight: number;\n    devicePixelRatio: number;\n  };\n  _polyfilled: boolean;\n  _extensions: Record<string, any>;\n}\n\n/**\n * Gets luma.gl specific state from a context\n * @returns context state\n */\nexport function getContextState(gl: WebGLRenderingContext): ContextState {\n  // @ts-expect-error\n  const {device, luma} = gl;\n  if (device) {\n    return device as ContextState;\n  }\n  if (!luma) {\n    const contextState: ContextState = {\n      _canvasSizeInfo: {\n        clientWidth: 0,\n        clientHeight: 0,\n        devicePixelRatio: 1,\n      },\n      _polyfilled: false,\n      _extensions: {}\n    };\n    // @ts-expect-error\n    gl.luma = contextState;\n  }\n  // @ts-expect-error\n  return gl.luma;\n}\n"],"file":"context-state.js"}

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

@@ -0,0 +1,40 @@
+/// <reference types="offscreencanvas" />
+/**
+ * ContextProps
+* @param webgl2 Set to false to not create a WebGL2 context (force webgl1)
+* @param webgl1 set to false to not create a WebGL1 context (fail if webgl2 not available)
+* @param onContextLost
+* @param onContextRestored
+*
+* BROWSER CONTEXT PARAMETERS
+* @param debug Instrument context (at the expense of performance).
+* @param alpha Default render target has an alpha buffer.
+* @param depth Default render target has a depth buffer of at least 16 bits.
+* @param stencil Default render target has a stencil buffer of at least 8 bits.
+* @param antialias Boolean that indicates whether or not to perform anti-aliasing.
+* @param premultipliedAlpha Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.
+* @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 = {
+    webgl1?: boolean;
+    webgl2?: boolean;
+    onContextLost?: (event: Event) => void;
+    onContextRestored?: (event: Event) => void;
+    alpha?: boolean;
+    desynchronized?: boolean;
+    antialias?: boolean;
+    depth?: boolean;
+    failIfMajorPerformanceCaveat?: boolean;
+    powerPreference?: 'default' | 'high-performance' | 'low-power';
+    premultipliedAlpha?: boolean;
+    preserveDrawingBuffer?: boolean;
+};
+/**
+ * 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 declare function createBrowserContext(canvas: HTMLCanvasElement | OffscreenCanvas, props: ContextProps): WebGLRenderingContext;
+export {};
+//# sourceMappingURL=create-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-context.d.ts","sourceRoot":"","sources":["../../../src/context/context/create-context.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;EAgBE;AAEF,aAAK,YAAY,GAAG;IAClB,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,CAkC7H"}

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

@@ -0,0 +1,37 @@
+const DEFAULT_CONTEXT_PROPS = {
+  webgl2: true,
+  webgl1: true,
+  powerPreference: 'high-performance',
+  onContextLost: () => console.error('WebGL context lost'),
+  onContextRestored: () => console.info('WebGL context restored')
+};
+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.webgl2) {
+    gl = gl || canvas.getContext('webgl2', props);
+  }
+
+  if (props.webgl1) {
+    gl = gl || canvas.getContext('webgl', props);
+  }
+
+  canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);
+
+  if (!gl) {
+    throw new Error("Failed to create ".concat(props.webgl2 && !props.webgl1 ? 'WebGL2' : 'WebGL', " context: ").concat(errorMessage || 'Unknown error'));
+  }
+
+  canvas.addEventListener('webglcontextlost', props.onContextLost, false);
+  canvas.addEventListener('webglcontextrestored', props.onContextRestored, false);
+  return gl;
+}
+//# sourceMappingURL=create-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/context/context/create-context.ts"],"names":["DEFAULT_CONTEXT_PROPS","webgl2","webgl1","powerPreference","onContextLost","console","error","onContextRestored","info","createBrowserContext","canvas","props","errorMessage","onCreateError","statusMessage","addEventListener","gl","getContext","removeEventListener","Error"],"mappings":"AAmCA,MAAMA,qBAAmC,GAAG;AAC1CC,EAAAA,MAAM,EAAE,IADkC;AAE1CC,EAAAA,MAAM,EAAE,IAFkC;AAG1CC,EAAAA,eAAe,EAAE,kBAHyB;AAI1CC,EAAAA,aAAa,EAAE,MAAMC,OAAO,CAACC,KAAR,CAAc,oBAAd,CAJqB;AAK1CC,EAAAA,iBAAiB,EAAE,MAAMF,OAAO,CAACG,IAAR,CAAa,wBAAb;AALiB,CAA5C;AAaC,OAAO,SAASC,oBAAT,CAA8BC,MAA9B,EAA2EC,KAA3E,EAAuH;AAC5HA,EAAAA,KAAK,GAAG,EAAC,GAAGX,qBAAJ;AAA2B,OAAGW;AAA9B,GAAR;AAGD,MAAIC,YAAY,GAAG,IAAnB;;AACA,QAAMC,aAAa,GAAIP,KAAD,IAAYM,YAAY,GAAGN,KAAK,CAACQ,aAAN,IAAuBF,YAAxE;;AACAF,EAAAA,MAAM,CAACK,gBAAP,CAAwB,2BAAxB,EAAqDF,aAArD,EAAoE,KAApE;AAGA,MAAIG,EAAE,GAAG,IAAT;;AAGA,MAAIL,KAAK,CAACV,MAAV,EAAkB;AAChBe,IAAAA,EAAE,GAAGA,EAAE,IAAIN,MAAM,CAACO,UAAP,CAAkB,QAAlB,EAA4BN,KAA5B,CAAX;AACD;;AACD,MAAIA,KAAK,CAACT,MAAV,EAAkB;AAChBc,IAAAA,EAAE,GAAGA,EAAE,IAAIN,MAAM,CAACO,UAAP,CAAkB,OAAlB,EAA2BN,KAA3B,CAAX;AACD;;AAGDD,EAAAA,MAAM,CAACQ,mBAAP,CAA2B,2BAA3B,EAAwDL,aAAxD,EAAuE,KAAvE;;AAEA,MAAI,CAACG,EAAL,EAAS;AACP,UAAM,IAAIG,KAAJ,4BACgBR,KAAK,CAACV,MAAN,IAAgB,CAACU,KAAK,CAACT,MAAvB,GAAgC,QAAhC,GAA2C,OAD3D,uBAEFU,YAAY,IAAI,eAFd,EAAN;AAKD;;AAEDF,EAAAA,MAAM,CAACK,gBAAP,CAAwB,kBAAxB,EAA4CJ,KAAK,CAACP,aAAlD,EAAiE,KAAjE;AACAM,EAAAA,MAAM,CAACK,gBAAP,CAAwB,sBAAxB,EAAgDJ,KAAK,CAACJ,iBAAtD,EAAyE,KAAzE;AAEA,SAAOS,EAAP;AACD","sourcesContent":["// luma.gl, MIT license\n\n/**\n * ContextProps\n* @param webgl2 Set to false to not create a WebGL2 context (force webgl1)\n* @param webgl1 set to false to not create a WebGL1 context (fail if webgl2 not available)\n* @param onContextLost\n* @param onContextRestored\n*\n* BROWSER CONTEXT PARAMETERS\n* @param debug Instrument context (at the expense of performance).\n* @param alpha Default render target has an alpha buffer.\n* @param depth Default render target has a depth buffer of at least 16 bits.\n* @param stencil Default render target has a stencil buffer of at least 8 bits.\n* @param antialias Boolean that indicates whether or not to perform anti-aliasing.\n* @param premultipliedAlpha Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.\n* @param preserveDrawingBuffer Default render target buffers will not be automatically cleared and will preserve their values until cleared or overwritten\n* @param failIfMajorPerformanceCaveat Do not create if the system performance is low.\n*/\n\ntype ContextProps = {\n  webgl1?: boolean;\n  webgl2?: boolean;\n  onContextLost?: (event: Event) => void;\n  onContextRestored?: (event: Event) => void;\n  alpha?: boolean; // indicates if the canvas contains an alpha buffer.\n  desynchronized?: boolean; // hints the user agent to reduce the latency by desynchronizing the canvas paint cycle from the event loop\n  antialias?: boolean; // indicates whether or not to perform anti-aliasing.\n  depth?: boolean; // indicates that the drawing buffer has a depth buffer of at least 16 bits.\n  failIfMajorPerformanceCaveat?: boolean, // indicates if a context will be created if the system performance is low or if no hardware GPU is available.\n  powerPreference?: 'default' |  'high-performance' | 'low-power',\n  premultipliedAlpha?: boolean, // page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.\n  preserveDrawingBuffer?: boolean // buffers will not be cleared and will preserve their values until cleared or overwritten by the author.\n};\n\nconst DEFAULT_CONTEXT_PROPS: ContextProps = {\n  webgl2: true, // Attempt to create a WebGL2 context\n  webgl1: true, // Attempt to create a WebGL1 context (false to fail if webgl2 not available)\n  powerPreference: 'high-performance', // After all, most apps are using WebGL for performance reasons\n  onContextLost: () => console.error('WebGL context lost'),\n  onContextRestored: () => console.info('WebGL context restored'),\n};\n\n/**\n * Create a WebGL context for a canvas\n * Note calling this multiple time on the same canvas does return the same context\n* @param canvas A canvas element or offscreen canvas\n */\n export function createBrowserContext(canvas: HTMLCanvasElement | OffscreenCanvas, props: ContextProps): WebGLRenderingContext {\n   props = {...DEFAULT_CONTEXT_PROPS, ...props};\n\n  // Try to extract any extra information about why context creation failed\n  let errorMessage = null;\n  const onCreateError = (error) => (errorMessage = error.statusMessage || errorMessage);\n  canvas.addEventListener('webglcontextcreationerror', onCreateError, false);\n\n  // Create the desired context\n  let gl = null;\n\n  // Prefer webgl2 over webgl1 if both are acceptable\n  if (props.webgl2) {\n    gl = gl || canvas.getContext('webgl2', props);\n  }\n  if (props.webgl1) {\n    gl = gl || canvas.getContext('webgl', props);\n  }\n\n  // TODO are we removing this listener before giving it a chance to fire?\n  canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);\n\n  if (!gl) {\n    throw new Error(\n      `Failed to create ${props.webgl2 && !props.webgl1 ? 'WebGL2' : 'WebGL'} context: ${\n        errorMessage || 'Unknown error'\n      }`\n    );\n  }\n\n  canvas.addEventListener('webglcontextlost', props.onContextLost, false);\n  canvas.addEventListener('webglcontextrestored', props.onContextRestored, false);\n\n  return gl;\n}\n"],"file":"create-context.js"}

package/dist/context/context/device-pixels.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Returns multiplier need to convert CSS size to Device size
+ */
+export declare function cssToDeviceRatio(gl: WebGLRenderingContext): number;
+/**
+ * Maps CSS pixel position to device pixel position
+ */
+export declare function cssToDevicePixels(gl: WebGLRenderingContext, cssPixel: number[], yInvert?: boolean): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * Calulates device pixel ratio, used during context creation
+ *
+ * @param useDevicePixels - boolean or a number
+ * @return - device pixel ratio
+ */
+export declare function getDevicePixelRatio(useDevicePixels: boolean | number): number;
+export declare function setDevicePixelRatio(gl: any, devicePixelRatio: any, options?: {
+    width?: number;
+    height?: number;
+}): void;
+//# sourceMappingURL=device-pixels.d.ts.map

package/dist/context/context/device-pixels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-pixels.d.ts","sourceRoot":"","sources":["../../../src/context/context/device-pixels.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAWlE;AAED;;GAEG;AACF,wBAAgB,iBAAiB,CAChC,EAAE,EAAE,qBAAqB,EACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,OAAc,GACtB;IACD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAKA;AAED;;;;;GAKG;AACF,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAO9E;AAGD,wBAAgB,mBAAmB,CAAC,EAAE,KAAA,EAAE,gBAAgB,KAAA,EAAE,OAAO,GAAE;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,QA4CxG"}