@luma.gl/webgl 8.6.0-alpha.5 → 9.0.0-alpha.10

package/dist/es5/context/context/{create-context.js → create-browser-context.js}

@@ -36,6 +36,18 @@ function createBrowserContext(canvas, props) {
   canvas.addEventListener('webglcontextcreationerror', onCreateError, false);
   var gl = null;
 
+  if (props.type === 'webgl2') {
+    props = _objectSpread(_objectSpread({}, props), {}, {
+      webgl1: false
+    });
+  }
+
+  if (props.type === 'webgl1') {
+    props = _objectSpread(_objectSpread({}, props), {}, {
+      webgl2: false
+    });
+  }
+
   if (props.webgl2) {
     gl = gl || canvas.getContext('webgl2', props);
   }
@@ -50,8 +62,22 @@ function createBrowserContext(canvas, props) {
     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);
+  if (props.onContextLost) {
+    var _props = props,
+        onContextLost = _props.onContextLost;
+    canvas.addEventListener('webglcontextlost', function (event) {
+      return onContextLost(event);
+    }, false);
+  }
+
+  if (props.onContextRestored) {
+    var _props2 = props,
+        onContextRestored = _props2.onContextRestored;
+    canvas.addEventListener('webglcontextrestored', function (event) {
+      return onContextRestored(event);
+    }, false);
+  }
+
   return gl;
 }
-//# sourceMappingURL=create-context.js.map
+//# sourceMappingURL=create-browser-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/context/context/create-browser-context.ts"],"names":["DEFAULT_CONTEXT_PROPS","webgl2","webgl1","powerPreference","onContextLost","console","error","onContextRestored","info","createBrowserContext","canvas","props","errorMessage","onCreateError","statusMessage","addEventListener","gl","type","getContext","removeEventListener","Error","event"],"mappings":";;;;;;;;;;;;;;;AAmCA,IAAMA,qBAAmC,GAAG;AAC1CC,EAAAA,MAAM,EAAE,IADkC;AAE1CC,EAAAA,MAAM,EAAE,IAFkC;AAG1CC,EAAAA,eAAe,EAAE,kBAHyB;AAI1CC,EAAAA,aAAa,EAAE;AAAA,WAAMC,OAAO,CAACC,KAAR,CAAc,oBAAd,CAAN;AAAA,GAJ2B;AAK1CC,EAAAA,iBAAiB,EAAE;AAAA,WAAMF,OAAO,CAACG,IAAR,CAAa,wBAAb,CAAN;AAAA;AALuB,CAA5C;;AAaQ,SAASC,oBAAT,CAA8BC,MAA9B,EAA2EC,KAA3E,EAAuH;AAC5HA,EAAAA,KAAK,mCAAOX,qBAAP,GAAiCW,KAAjC,CAAL;AAGD,MAAIC,YAAY,GAAG,IAAnB;;AACA,MAAMC,aAAa,GAAG,SAAhBA,aAAgB,CAACP,KAAD;AAAA,WAAYM,YAAY,GAAGN,KAAK,CAACQ,aAAN,IAAuBF,YAAlD;AAAA,GAAtB;;AACAF,EAAAA,MAAM,CAACK,gBAAP,CAAwB,2BAAxB,EAAqDF,aAArD,EAAoE,KAApE;AAGA,MAAIG,EAAgC,GAAG,IAAvC;;AAEA,MAAIL,KAAK,CAACM,IAAN,KAAe,QAAnB,EAA6B;AAC3BN,IAAAA,KAAK,mCAAOA,KAAP;AAAcT,MAAAA,MAAM,EAAE;AAAtB,MAAL;AACD;;AACD,MAAIS,KAAK,CAACM,IAAN,KAAe,QAAnB,EAA6B;AAC3BN,IAAAA,KAAK,mCAAOA,KAAP;AAAcV,MAAAA,MAAM,EAAE;AAAtB,MAAL;AACD;;AAGD,MAAIU,KAAK,CAACV,MAAV,EAAkB;AAChBe,IAAAA,EAAE,GAAGA,EAAE,IAAIN,MAAM,CAACQ,UAAP,CAAkB,QAAlB,EAA4BP,KAA5B,CAAX;AACD;;AACD,MAAIA,KAAK,CAACT,MAAV,EAAkB;AAChBc,IAAAA,EAAE,GAAGA,EAAE,IAAIN,MAAM,CAACQ,UAAP,CAAkB,OAAlB,EAA2BP,KAA3B,CAAX;AACD;;AAGDD,EAAAA,MAAM,CAACS,mBAAP,CAA2B,2BAA3B,EAAwDN,aAAxD,EAAuE,KAAvE;;AAEA,MAAI,CAACG,EAAL,EAAS;AACP,UAAM,IAAII,KAAJ,4BACgBT,KAAK,CAACV,MAAN,IAAgB,CAACU,KAAK,CAACT,MAAvB,GAAgC,QAAhC,GAA2C,OAD3D,uBAEFU,YAAY,IAAI,eAFd,EAAN;AAKD;;AAED,MAAID,KAAK,CAACP,aAAV,EAAyB;AAEvB,iBAAwBO,KAAxB;AAAA,QAAOP,aAAP,UAAOA,aAAP;AACAM,IAAAA,MAAM,CAACK,gBAAP,CAAwB,kBAAxB,EAA2C,UAACM,KAAD;AAAA,aAAkBjB,aAAa,CAACiB,KAAD,CAA/B;AAAA,KAA3C,EAAmF,KAAnF;AACD;;AACD,MAAIV,KAAK,CAACJ,iBAAV,EAA6B;AAE3B,kBAA4BI,KAA5B;AAAA,QAAOJ,iBAAP,WAAOA,iBAAP;AACAG,IAAAA,MAAM,CAACK,gBAAP,CAAwB,sBAAxB,EAAgD,UAACM,KAAD;AAAA,aAAkBd,iBAAiB,CAACc,KAAD,CAAnC;AAAA,KAAhD,EAA4F,KAA5F;AACD;;AAED,SAAOL,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*/\ntype ContextProps = {\n  type?: 'webgl' | 'webgl1' | 'webgl2' | string;\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: WebGLRenderingContext | null = null;\n\n  if (props.type === 'webgl2') {\n    props = {...props, webgl1: false};\n  }\n  if (props.type === 'webgl1') {\n    props = {...props, webgl2: false};\n  }\n\n  // Prefer webgl2 over webgl1 if both are acceptable\n  if (props.webgl2) {\n    gl = gl || canvas.getContext('webgl2', props) as WebGL2RenderingContext | null;\n  }\n  if (props.webgl1) {\n    gl = gl || canvas.getContext('webgl', props) as WebGLRenderingContext | null;\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  if (props.onContextLost) {\n    // Carefully extract and wrap callbacks to prevent addEventListener from rebinding them.\n    const {onContextLost} = props;\n    canvas.addEventListener('webglcontextlost',(event: Event) => onContextLost(event), false);\n  }\n  if (props.onContextRestored) {\n    // Carefully extract and wrap callbacks to prevent addEventListener from rebinding them.\n    const {onContextRestored} = props;\n    canvas.addEventListener('webglcontextrestored', (event: Event) => onContextRestored(event), false);\n  }\n\n  return gl;\n}\n\n/* TODO - can we call this asynchronously to catch the error events?\nexport async function createBrowserContextAsync(canvas: HTMLCanvasElement | OffscreenCanvas, props: ContextProps): Promise<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 const gl = createBrowserContext(canvas, props);\n\n // Give the listener a chance to fire\n await new Promise(resolve => setTimeout(resolve, 0));\n\n canvas.removeEventListener('webglcontextcreationerror', onCreateError, false);\n\n return gl;\n}\n*/\n"],"file":"create-browser-context.js"}

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

@@ -0,0 +1,60 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.registerHeadlessGL = registerHeadlessGL;
+exports.isHeadlessGLRegistered = isHeadlessGLRegistered;
+exports.createHeadlessContext = createHeadlessContext;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+var ERR_HEADLESSGL_FAILED = 'Failed to create WebGL context in Node.js, headless gl returned null';
+var 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.";
+var CONTEXT_DEFAULTS = {
+  width: 1,
+  height: 1,
+  debug: true,
+  throwOnError: false
+};
+var headlessGL = null;
+
+function registerHeadlessGL(headlessgl) {
+  headlessGL = headlessgl;
+}
+
+function isHeadlessGLRegistered() {
+  return headlessGL !== null;
+}
+
+function createHeadlessContext(options) {
+  options = _objectSpread(_objectSpread({}, CONTEXT_DEFAULTS), options);
+  var _options = options,
+      width = _options.width,
+      height = _options.height,
+      webgl1 = _options.webgl1,
+      webgl2 = _options.webgl2;
+
+  if (webgl2 && !webgl1) {
+    throw new Error('headless-gl does not support WebGL2');
+  }
+
+  if (!headlessGL) {
+    throw new Error(ERR_HEADLESSGL_LOAD);
+  }
+
+  var gl = headlessGL(width, height, options);
+
+  if (!gl) {
+    throw new Error(ERR_HEADLESSGL_FAILED);
+  }
+
+  return gl;
+}
+//# sourceMappingURL=create-headless-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/context/context/create-headless-context.ts"],"names":["ERR_HEADLESSGL_FAILED","ERR_HEADLESSGL_LOAD","CONTEXT_DEFAULTS","width","height","debug","throwOnError","headlessGL","registerHeadlessGL","headlessgl","isHeadlessGLRegistered","createHeadlessContext","options","webgl1","webgl2","Error","gl"],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAMA,qBAAqB,GACzB,sEADF;AAGA,IAAMC,mBAAmB,gPAAzB;AAKA,IAAMC,gBAAgB,GAAG;AACvBC,EAAAA,KAAK,EAAE,CADgB;AAEvBC,EAAAA,MAAM,EAAE,CAFe;AAGvBC,EAAAA,KAAK,EAAE,IAHgB;AAIvBC,EAAAA,YAAY,EAAE;AAJS,CAAzB;AAUA,IAAIC,UAA6B,GAAG,IAApC;;AAGO,SAASC,kBAAT,CAA4BC,UAA5B,EAAoD;AACzDF,EAAAA,UAAU,GAAGE,UAAb;AACD;;AAGM,SAASC,sBAAT,GAA2C;AAChD,SAAOH,UAAU,KAAK,IAAtB;AACD;;AAGM,SAASI,qBAAT,CAA+BC,OAA/B,EAAqF;AAC1FA,EAAAA,OAAO,mCAAOV,gBAAP,GAA4BU,OAA5B,CAAP;AAEA,iBAAwCA,OAAxC;AAAA,MAAOT,KAAP,YAAOA,KAAP;AAAA,MAAcC,MAAd,YAAcA,MAAd;AAAA,MAAsBS,MAAtB,YAAsBA,MAAtB;AAAA,MAA8BC,MAA9B,YAA8BA,MAA9B;;AAEA,MAAIA,MAAM,IAAI,CAACD,MAAf,EAAuB;AACrB,UAAM,IAAIE,KAAJ,CAAU,qCAAV,CAAN;AACD;;AACD,MAAI,CAACR,UAAL,EAAiB;AACf,UAAM,IAAIQ,KAAJ,CAAUd,mBAAV,CAAN;AACD;;AACD,MAAMe,EAAE,GAAGT,UAAU,CAACJ,KAAD,EAAQC,MAAR,EAAgBQ,OAAhB,CAArB;;AACA,MAAI,CAACI,EAAL,EAAS;AACP,UAAM,IAAID,KAAJ,CAAUf,qBAAV,CAAN;AACD;;AACD,SAAOgB,EAAP;AACD","sourcesContent":["const 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 = {\n  width: 1,\n  height: 1,\n  debug: true,\n  throwOnError: false\n};\n\n/** Duck typing for the main headless gl export, a function to create contexts */\nexport type HeadlessGL = (width: number, height: number, options: Record<string, unknown>) => WebGLRenderingContext;\n\nlet headlessGL: HeadlessGL | null = null; \n\n/** By importing `gl` and registering it with this function, contexts can be created under Node.js */\nexport function registerHeadlessGL(headlessgl: HeadlessGL) {\n  headlessGL = headlessgl;\n}\n\n/** @returns true if headless gl is registered */\nexport function isHeadlessGLRegistered(): boolean {\n  return headlessGL !== null;\n}\n\n/** Create headless gl context (for running under Node.js) */\nexport function createHeadlessContext(options?: Record<string, any>): WebGLRenderingContext {\n  options = {...CONTEXT_DEFAULTS, ...options};\n\n  const {width, height, webgl1, webgl2} = options;\n\n  if (webgl2 && !webgl1) {\n    throw new Error('headless-gl does not support WebGL2');\n  }\n  if (!headlessGL) {\n    throw new Error(ERR_HEADLESSGL_LOAD);\n  }\n  const gl = headlessGL(width, height, options);\n  if (!gl) {\n    throw new Error(ERR_HEADLESSGL_FAILED);\n  }\n  return gl;\n}\n"],"file":"create-headless-context.js"}

package/dist/es5/context/context/device-pixels.js

@@ -43,15 +43,21 @@ function getDevicePixelRatio(useDevicePixels) {
 
 function setDevicePixelRatio(gl, devicePixelRatio) {
   var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-  var clientWidth = 'width' in options ? options.width : gl.canvas.clientWidth;
-  var clientHeight = 'height' in options ? options.height : gl.canvas.clientHeight;
+
+  if (!(gl.canvas instanceof HTMLCanvasElement)) {
+    return;
+  }
+
+  var canvas = gl.canvas;
+  var clientWidth = 'width' in options ? options.width : canvas.clientWidth;
+  var clientHeight = 'height' in options ? options.height : canvas.clientHeight;
 
   if (!clientWidth || !clientHeight) {
     _api.log.log(1, 'Canvas clientWidth/clientHeight is 0')();
 
     devicePixelRatio = 1;
-    clientWidth = gl.canvas.width || 1;
-    clientHeight = gl.canvas.height || 1;
+    clientWidth = canvas.width || 1;
+    clientHeight = canvas.height || 1;
   }
 
   var contextState = (0, _contextState.getContextState)(gl);
@@ -61,15 +67,15 @@ function setDevicePixelRatio(gl, devicePixelRatio) {
     var clampedPixelRatio = devicePixelRatio;
     var canvasWidth = Math.floor(clientWidth * clampedPixelRatio);
     var canvasHeight = Math.floor(clientHeight * clampedPixelRatio);
-    gl.canvas.width = canvasWidth;
-    gl.canvas.height = canvasHeight;
+    canvas.width = canvasWidth;
+    canvas.height = canvasHeight;
 
     if (gl.drawingBufferWidth !== canvasWidth || gl.drawingBufferHeight !== canvasHeight) {
       _api.log.warn("Device pixel ratio clamped")();
 
       clampedPixelRatio = Math.min(gl.drawingBufferWidth / clientWidth, gl.drawingBufferHeight / clientHeight);
-      gl.canvas.width = Math.floor(clientWidth * clampedPixelRatio);
-      gl.canvas.height = Math.floor(clientHeight * clampedPixelRatio);
+      canvas.width = Math.floor(clientWidth * clampedPixelRatio);
+      canvas.height = Math.floor(clientHeight * clampedPixelRatio);
     }
 
     Object.assign(contextState._canvasSizeInfo, {

package/dist/es5/context/context/device-pixels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/context/context/device-pixels.ts"],"names":["cssToDeviceRatio","gl","state","canvas","clientWidth","_canvasSizeInfo","drawingBufferWidth","cssToDevicePixels","cssPixel","yInvert","ratio","width","height","drawingBufferHeight","scalePixels","getDevicePixelRatio","useDevicePixels","windowRatio","window","devicePixelRatio","Number","isFinite","setDevicePixelRatio","options","clientHeight","log","contextState","cachedSize","clampedPixelRatio","canvasWidth","Math","floor","canvasHeight","warn","min","Object","assign","pixel","x","scaleX","y","scaleY","t","xHigh","yHigh","max","r","round"],"mappings":"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","sourcesContent":["import {log} from '@luma.gl/api';\nimport {getContextState} from './context-state';\n\n/**\n * Returns multiplier need to convert CSS size to Device size\n */\nexport function cssToDeviceRatio(gl: WebGLRenderingContext): number {\n  const state = getContextState(gl);\n\n  if (gl.canvas && state) {\n    // For headless gl we might have used custom width and height\n    // hence use cached clientWidth\n    const {clientWidth} = state._canvasSizeInfo;\n    return clientWidth ? gl.drawingBufferWidth / clientWidth : 1;\n  }\n  // use default device pixel ratio\n  return 1;\n}\n\n/**\n * Maps CSS pixel position to device pixel position\n */\n export function cssToDevicePixels(\n  gl: WebGLRenderingContext,\n  cssPixel: number[],\n  yInvert: boolean = true\n): {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n} {\n  const ratio = cssToDeviceRatio(gl);\n  const width = gl.drawingBufferWidth;\n  const height = gl.drawingBufferHeight;\n  return scalePixels(cssPixel, ratio, width, height, yInvert);\n}\n\n/**\n * Calulates device pixel ratio, used during context creation\n *\n * @param useDevicePixels - boolean or a number\n * @return - device pixel ratio\n */\n export function getDevicePixelRatio(useDevicePixels: boolean | number): number {\n  const windowRatio = typeof window === 'undefined' ? 1 : window.devicePixelRatio || 1;\n  if (Number.isFinite(useDevicePixels)) {\n    // @ts-expect-error Can no longer be boolean after previous line\n    return useDevicePixels <= 0 ? 1 : useDevicePixels;\n  }\n  return useDevicePixels ? windowRatio : 1;\n}\n\n// use devicePixelRatio to set canvas width and height\nexport function setDevicePixelRatio(gl, devicePixelRatio, options: {width?: number, height?: number} = {}) {\n  // NOTE: if options.width and options.height not used remove in v8\n  let clientWidth = 'width' in options ? options.width : gl.canvas.clientWidth;\n  let clientHeight = 'height' in options ? options.height : gl.canvas.clientHeight;\n\n  if (!clientWidth || !clientHeight) {\n    log.log(1, 'Canvas clientWidth/clientHeight is 0')();\n    // by forcing devicePixel ratio to 1, we do not scale gl.canvas.width and height in each frame.\n    devicePixelRatio = 1;\n    clientWidth = gl.canvas.width || 1;\n    clientHeight = gl.canvas.height || 1;\n  }\n\n  const contextState = getContextState(gl);\n  const cachedSize = contextState._canvasSizeInfo;\n  // Check if canvas needs to be resized\n  if (\n    cachedSize.clientWidth !== clientWidth ||\n    cachedSize.clientHeight !== clientHeight ||\n    cachedSize.devicePixelRatio !== devicePixelRatio\n  ) {\n    let clampedPixelRatio = devicePixelRatio;\n\n    const canvasWidth = Math.floor(clientWidth * clampedPixelRatio);\n    const canvasHeight = Math.floor(clientHeight * clampedPixelRatio);\n    gl.canvas.width = canvasWidth;\n    gl.canvas.height = canvasHeight;\n\n    // Note: when devicePixelRatio is too high, it is possible we might hit system limit for\n    // drawing buffer width and hight, in those cases they get clamped and resulting aspect ration may not be maintained\n    // for those cases, reduce devicePixelRatio.\n    if (gl.drawingBufferWidth !== canvasWidth || gl.drawingBufferHeight !== canvasHeight) {\n      log.warn(`Device pixel ratio clamped`)();\n      clampedPixelRatio = Math.min(\n        gl.drawingBufferWidth / clientWidth,\n        gl.drawingBufferHeight / clientHeight\n      );\n\n      gl.canvas.width = Math.floor(clientWidth * clampedPixelRatio);\n      gl.canvas.height = Math.floor(clientHeight * clampedPixelRatio);\n    }\n\n    Object.assign(contextState._canvasSizeInfo, {clientWidth, clientHeight, devicePixelRatio});\n  }\n}\n\n\n// PRIVATE\n\nfunction scalePixels(pixel, ratio, width, height, yInvert) {\n  const x = scaleX(pixel[0], ratio, width);\n  let y = scaleY(pixel[1], ratio, height, yInvert);\n\n  // Find boundaries of next pixel to provide valid range of device pixel locaitons\n\n  let t = scaleX(pixel[0] + 1, ratio, width);\n  // If next pixel's position is clamped to boundary, use it as is, otherwise subtract 1 for current pixel boundary\n  const xHigh = t === width - 1 ? t : t - 1;\n\n  t = scaleY(pixel[1] + 1, ratio, height, yInvert);\n  let yHigh;\n  if (yInvert) {\n    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range\n    t = t === 0 ? t : t + 1;\n    // swap y and yHigh\n    yHigh = y;\n    y = t;\n  } else {\n    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range\n    yHigh = t === height - 1 ? t : t - 1;\n    // y remains same\n  }\n  return {\n    x,\n    y,\n    // when ratio < 1, current css pixel and next css pixel may point to same device pixel, set width/height to 1 in those cases.\n    width: Math.max(xHigh - x + 1, 1),\n    height: Math.max(yHigh - y + 1, 1)\n  };\n}\n\nfunction scaleX(x, ratio, width) {\n  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit\n  const r = Math.min(Math.round(x * ratio), width - 1);\n  return r;\n}\n\nfunction scaleY(y, ratio, height, yInvert) {\n  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit\n  return yInvert\n    ? Math.max(0, height - 1 - Math.round(y * ratio))\n    : Math.min(Math.round(y * ratio), height - 1);\n}\n"],"file":"device-pixels.js"}
+{"version":3,"sources":["../../../../src/context/context/device-pixels.ts"],"names":["cssToDeviceRatio","gl","state","canvas","clientWidth","_canvasSizeInfo","drawingBufferWidth","cssToDevicePixels","cssPixel","yInvert","ratio","width","height","drawingBufferHeight","scalePixels","getDevicePixelRatio","useDevicePixels","windowRatio","window","devicePixelRatio","Number","isFinite","setDevicePixelRatio","options","HTMLCanvasElement","clientHeight","log","contextState","cachedSize","clampedPixelRatio","canvasWidth","Math","floor","canvasHeight","warn","min","Object","assign","pixel","x","scaleX","y","scaleY","t","xHigh","yHigh","max","r","round"],"mappings":";;;;;;;;;;AAAA;;AACA;;AAKO,SAASA,gBAAT,CAA0BC,EAA1B,EAA6D;AAClE,MAAMC,KAAK,GAAG,mCAAgBD,EAAhB,CAAd;;AAEA,MAAIA,EAAE,CAACE,MAAH,IAAaD,KAAjB,EAAwB;AAGtB,QAAOE,WAAP,GAAsBF,KAAK,CAACG,eAA5B,CAAOD,WAAP;AACA,WAAOA,WAAW,GAAGH,EAAE,CAACK,kBAAH,GAAwBF,WAA3B,GAAyC,CAA3D;AACD;;AAED,SAAO,CAAP;AACD;;AAKO,SAASG,iBAAT,CACNN,EADM,EAENO,QAFM,EASN;AAAA,MANAC,OAMA,uEANmB,IAMnB;AACA,MAAMC,KAAK,GAAGV,gBAAgB,CAACC,EAAD,CAA9B;AACA,MAAMU,KAAK,GAAGV,EAAE,CAACK,kBAAjB;AACA,MAAMM,MAAM,GAAGX,EAAE,CAACY,mBAAlB;AACA,SAAOC,WAAW,CAACN,QAAD,EAAWE,KAAX,EAAkBC,KAAlB,EAAyBC,MAAzB,EAAiCH,OAAjC,CAAlB;AACD;;AAQO,SAASM,mBAAT,CAA6BC,eAA7B,EAAwE;AAC9E,MAAMC,WAAW,GAAG,OAAOC,MAAP,KAAkB,WAAlB,GAAgC,CAAhC,GAAoCA,MAAM,CAACC,gBAAP,IAA2B,CAAnF;;AACA,MAAIC,MAAM,CAACC,QAAP,CAAgBL,eAAhB,CAAJ,EAAsC;AAEpC,WAAOA,eAAe,IAAI,CAAnB,GAAuB,CAAvB,GAA2BA,eAAlC;AACD;;AACD,SAAOA,eAAe,GAAGC,WAAH,GAAiB,CAAvC;AACD;;AAGM,SAASK,mBAAT,CAA6BrB,EAA7B,EAAwDkB,gBAAxD,EAAmI;AAAA,MAAjDI,OAAiD,uEAAJ,EAAI;;AACxI,MAAI,EAAEtB,EAAE,CAACE,MAAH,YAAqBqB,iBAAvB,CAAJ,EAA+C;AAC7C;AACD;;AAED,MAAMrB,MAAyB,GAAGF,EAAE,CAACE,MAArC;AAGA,MAAIC,WAAW,GAAG,WAAWmB,OAAX,GAAqBA,OAAO,CAACZ,KAA7B,GAAqCR,MAAM,CAACC,WAA9D;AACA,MAAIqB,YAAY,GAAG,YAAYF,OAAZ,GAAsBA,OAAO,CAACX,MAA9B,GAAuCT,MAAM,CAACsB,YAAjE;;AAEA,MAAI,CAACrB,WAAD,IAAgB,CAACqB,YAArB,EAAmC;AACjCC,aAAIA,GAAJ,CAAQ,CAAR,EAAW,sCAAX;;AAEAP,IAAAA,gBAAgB,GAAG,CAAnB;AACAf,IAAAA,WAAW,GAAGD,MAAM,CAACQ,KAAP,IAAgB,CAA9B;AACAc,IAAAA,YAAY,GAAGtB,MAAM,CAACS,MAAP,IAAiB,CAAhC;AACD;;AAED,MAAMe,YAAY,GAAG,mCAAgB1B,EAAhB,CAArB;AACA,MAAM2B,UAAU,GAAGD,YAAY,CAACtB,eAAhC;;AAEA,MACEuB,UAAU,CAACxB,WAAX,KAA2BA,WAA3B,IACAwB,UAAU,CAACH,YAAX,KAA4BA,YAD5B,IAEAG,UAAU,CAACT,gBAAX,KAAgCA,gBAHlC,EAIE;AACA,QAAIU,iBAAiB,GAAGV,gBAAxB;AAEA,QAAMW,WAAW,GAAGC,IAAI,CAACC,KAAL,CAAW5B,WAAW,GAAGyB,iBAAzB,CAApB;AACA,QAAMI,YAAY,GAAGF,IAAI,CAACC,KAAL,CAAWP,YAAY,GAAGI,iBAA1B,CAArB;AACA1B,IAAAA,MAAM,CAACQ,KAAP,GAAemB,WAAf;AACA3B,IAAAA,MAAM,CAACS,MAAP,GAAgBqB,YAAhB;;AAKA,QAAIhC,EAAE,CAACK,kBAAH,KAA0BwB,WAA1B,IAAyC7B,EAAE,CAACY,mBAAH,KAA2BoB,YAAxE,EAAsF;AACpFP,eAAIQ,IAAJ;;AACAL,MAAAA,iBAAiB,GAAGE,IAAI,CAACI,GAAL,CAClBlC,EAAE,CAACK,kBAAH,GAAwBF,WADN,EAElBH,EAAE,CAACY,mBAAH,GAAyBY,YAFP,CAApB;AAKAtB,MAAAA,MAAM,CAACQ,KAAP,GAAeoB,IAAI,CAACC,KAAL,CAAW5B,WAAW,GAAGyB,iBAAzB,CAAf;AACA1B,MAAAA,MAAM,CAACS,MAAP,GAAgBmB,IAAI,CAACC,KAAL,CAAWP,YAAY,GAAGI,iBAA1B,CAAhB;AACD;;AAEDO,IAAAA,MAAM,CAACC,MAAP,CAAcV,YAAY,CAACtB,eAA3B,EAA4C;AAACD,MAAAA,WAAW,EAAXA,WAAD;AAAcqB,MAAAA,YAAY,EAAZA,YAAd;AAA4BN,MAAAA,gBAAgB,EAAhBA;AAA5B,KAA5C;AACD;AACF;;AAKD,SAASL,WAAT,CAAqBwB,KAArB,EAAsC5B,KAAtC,EAAqDC,KAArD,EAAoEC,MAApE,EAAoFH,OAApF,EAKE;AACA,MAAM8B,CAAC,GAAGC,MAAM,CAACF,KAAK,CAAC,CAAD,CAAN,EAAW5B,KAAX,EAAkBC,KAAlB,CAAhB;AACA,MAAI8B,CAAC,GAAGC,MAAM,CAACJ,KAAK,CAAC,CAAD,CAAN,EAAW5B,KAAX,EAAkBE,MAAlB,EAA0BH,OAA1B,CAAd;AAIA,MAAIkC,CAAC,GAAGH,MAAM,CAACF,KAAK,CAAC,CAAD,CAAL,GAAW,CAAZ,EAAe5B,KAAf,EAAsBC,KAAtB,CAAd;AAEA,MAAMiC,KAAK,GAAGD,CAAC,KAAKhC,KAAK,GAAG,CAAd,GAAkBgC,CAAlB,GAAsBA,CAAC,GAAG,CAAxC;AAEAA,EAAAA,CAAC,GAAGD,MAAM,CAACJ,KAAK,CAAC,CAAD,CAAL,GAAW,CAAZ,EAAe5B,KAAf,EAAsBE,MAAtB,EAA8BH,OAA9B,CAAV;AACA,MAAIoC,KAAJ;;AACA,MAAIpC,OAAJ,EAAa;AAEXkC,IAAAA,CAAC,GAAGA,CAAC,KAAK,CAAN,GAAUA,CAAV,GAAcA,CAAC,GAAG,CAAtB;AAEAE,IAAAA,KAAK,GAAGJ,CAAR;AACAA,IAAAA,CAAC,GAAGE,CAAJ;AACD,GAND,MAMO;AAELE,IAAAA,KAAK,GAAGF,CAAC,KAAK/B,MAAM,GAAG,CAAf,GAAmB+B,CAAnB,GAAuBA,CAAC,GAAG,CAAnC;AAED;;AACD,SAAO;AACLJ,IAAAA,CAAC,EAADA,CADK;AAELE,IAAAA,CAAC,EAADA,CAFK;AAIL9B,IAAAA,KAAK,EAAEoB,IAAI,CAACe,GAAL,CAASF,KAAK,GAAGL,CAAR,GAAY,CAArB,EAAwB,CAAxB,CAJF;AAKL3B,IAAAA,MAAM,EAAEmB,IAAI,CAACe,GAAL,CAASD,KAAK,GAAGJ,CAAR,GAAY,CAArB,EAAwB,CAAxB;AALH,GAAP;AAOD;;AAED,SAASD,MAAT,CAAgBD,CAAhB,EAA2B7B,KAA3B,EAA0CC,KAA1C,EAAiE;AAE/D,MAAMoC,CAAC,GAAGhB,IAAI,CAACI,GAAL,CAASJ,IAAI,CAACiB,KAAL,CAAWT,CAAC,GAAG7B,KAAf,CAAT,EAAgCC,KAAK,GAAG,CAAxC,CAAV;AACA,SAAOoC,CAAP;AACD;;AAED,SAASL,MAAT,CAAgBD,CAAhB,EAA2B/B,KAA3B,EAA0CE,MAA1C,EAA0DH,OAA1D,EAAoF;AAElF,SAAOA,OAAO,GACVsB,IAAI,CAACe,GAAL,CAAS,CAAT,EAAYlC,MAAM,GAAG,CAAT,GAAamB,IAAI,CAACiB,KAAL,CAAWP,CAAC,GAAG/B,KAAf,CAAzB,CADU,GAEVqB,IAAI,CAACI,GAAL,CAASJ,IAAI,CAACiB,KAAL,CAAWP,CAAC,GAAG/B,KAAf,CAAT,EAAgCE,MAAM,GAAG,CAAzC,CAFJ;AAGD","sourcesContent":["import {log} from '@luma.gl/api';\nimport {getContextState} from './context-state';\n\n/**\n * Returns multiplier need to convert CSS size to Device size\n */\nexport function cssToDeviceRatio(gl: WebGLRenderingContext): number {\n  const state = getContextState(gl);\n\n  if (gl.canvas && state) {\n    // For headless gl we might have used custom width and height\n    // hence use cached clientWidth\n    const {clientWidth} = state._canvasSizeInfo;\n    return clientWidth ? gl.drawingBufferWidth / clientWidth : 1;\n  }\n  // use default device pixel ratio\n  return 1;\n}\n\n/**\n * Maps CSS pixel position to device pixel position\n */\n export function cssToDevicePixels(\n  gl: WebGLRenderingContext,\n  cssPixel: number[],\n  yInvert: boolean = true\n): {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n} {\n  const ratio = cssToDeviceRatio(gl);\n  const width = gl.drawingBufferWidth;\n  const height = gl.drawingBufferHeight;\n  return scalePixels(cssPixel, ratio, width, height, yInvert);\n}\n\n/**\n * Calulates device pixel ratio, used during context creation\n *\n * @param useDevicePixels - boolean or a number\n * @return - device pixel ratio\n */\n export function getDevicePixelRatio(useDevicePixels: boolean | number): number {\n  const windowRatio = typeof window === 'undefined' ? 1 : window.devicePixelRatio || 1;\n  if (Number.isFinite(useDevicePixels)) {\n    // @ts-expect-error Can no longer be boolean after previous line\n    return useDevicePixels <= 0 ? 1 : useDevicePixels;\n  }\n  return useDevicePixels ? windowRatio : 1;\n}\n\n// use devicePixelRatio to set canvas width and height\nexport function setDevicePixelRatio(gl: WebGLRenderingContext, devicePixelRatio: number, options: {width?: number, height?: number} = {}) {\n  if (!(gl.canvas instanceof HTMLCanvasElement)) {\n    return;\n  }\n\n  const canvas: HTMLCanvasElement = gl.canvas;\n\n  // NOTE: if options.width and options.height not used remove in v8\n  let clientWidth = 'width' in options ? options.width : canvas.clientWidth;\n  let clientHeight = 'height' in options ? options.height : canvas.clientHeight;\n\n  if (!clientWidth || !clientHeight) {\n    log.log(1, 'Canvas clientWidth/clientHeight is 0')();\n    // by forcing devicePixel ratio to 1, we do not scale canvas.width and height in each frame.\n    devicePixelRatio = 1;\n    clientWidth = canvas.width || 1;\n    clientHeight = canvas.height || 1;\n  }\n\n  const contextState = getContextState(gl);\n  const cachedSize = contextState._canvasSizeInfo;\n  // Check if canvas needs to be resized\n  if (\n    cachedSize.clientWidth !== clientWidth ||\n    cachedSize.clientHeight !== clientHeight ||\n    cachedSize.devicePixelRatio !== devicePixelRatio\n  ) {\n    let clampedPixelRatio = devicePixelRatio;\n\n    const canvasWidth = Math.floor(clientWidth * clampedPixelRatio);\n    const canvasHeight = Math.floor(clientHeight * clampedPixelRatio);\n    canvas.width = canvasWidth;\n    canvas.height = canvasHeight;\n\n    // Note: when devicePixelRatio is too high, it is possible we might hit system limit for\n    // drawing buffer width and hight, in those cases they get clamped and resulting aspect ration may not be maintained\n    // for those cases, reduce devicePixelRatio.\n    if (gl.drawingBufferWidth !== canvasWidth || gl.drawingBufferHeight !== canvasHeight) {\n      log.warn(`Device pixel ratio clamped`)();\n      clampedPixelRatio = Math.min(\n        gl.drawingBufferWidth / clientWidth,\n        gl.drawingBufferHeight / clientHeight\n      );\n\n      canvas.width = Math.floor(clientWidth * clampedPixelRatio);\n      canvas.height = Math.floor(clientHeight * clampedPixelRatio);\n    }\n\n    Object.assign(contextState._canvasSizeInfo, {clientWidth, clientHeight, devicePixelRatio});\n  }\n}\n\n\n// PRIVATE\n\nfunction scalePixels(pixel: number[], ratio: number, width: number, height: number, yInvert: boolean): {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n} {\n  const x = scaleX(pixel[0], ratio, width);\n  let y = scaleY(pixel[1], ratio, height, yInvert);\n\n  // Find boundaries of next pixel to provide valid range of device pixel locaitons\n\n  let t = scaleX(pixel[0] + 1, ratio, width);\n  // If next pixel's position is clamped to boundary, use it as is, otherwise subtract 1 for current pixel boundary\n  const xHigh = t === width - 1 ? t : t - 1;\n\n  t = scaleY(pixel[1] + 1, ratio, height, yInvert);\n  let yHigh;\n  if (yInvert) {\n    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range\n    t = t === 0 ? t : t + 1;\n    // swap y and yHigh\n    yHigh = y;\n    y = t;\n  } else {\n    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range\n    yHigh = t === height - 1 ? t : t - 1;\n    // y remains same\n  }\n  return {\n    x,\n    y,\n    // when ratio < 1, current css pixel and next css pixel may point to same device pixel, set width/height to 1 in those cases.\n    width: Math.max(xHigh - x + 1, 1),\n    height: Math.max(yHigh - y + 1, 1)\n  };\n}\n\nfunction scaleX(x: number, ratio: number, width: number): number {\n  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit\n  const r = Math.min(Math.round(x * ratio), width - 1);\n  return r;\n}\n\nfunction scaleY(y: number, ratio: number, height: number, yInvert: boolean): number {\n  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit\n  return yInvert\n    ? Math.max(0, height - 1 - Math.round(y * ratio))\n    : Math.min(Math.round(y * ratio), height - 1);\n}\n"],"file":"device-pixels.js"}

package/dist/es5/context/debug/spector.js

@@ -0,0 +1,133 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.loadSpectorJS = loadSpectorJS;
+exports.initializeSpectorJS = initializeSpectorJS;
+
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+
+var _api = require("@luma.gl/api");
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+var DEFAULT_SPECTOR_PROPS = {
+  spector: _api.log.get('spector') || _api.log.get('inspect')
+};
+var SPECTOR_CDN_URL = 'https://spectorcdn.babylonjs.com/spector.bundle.js';
+var LOG_LEVEL = 1;
+var spector = null;
+var initialized = false;
+
+function loadSpectorJS(_x) {
+  return _loadSpectorJS.apply(this, arguments);
+}
+
+function _loadSpectorJS() {
+  _loadSpectorJS = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee(props) {
+    return _regenerator.default.wrap(function _callee$(_context) {
+      while (1) {
+        switch (_context.prev = _context.next) {
+          case 0:
+            if (globalThis.SPECTOR) {
+              _context.next = 9;
+              break;
+            }
+
+            _context.prev = 1;
+            _context.next = 4;
+            return (0, _api.loadScript)(SPECTOR_CDN_URL);
+
+          case 4:
+            _context.next = 9;
+            break;
+
+          case 6:
+            _context.prev = 6;
+            _context.t0 = _context["catch"](1);
+
+            _api.log.warn(String(_context.t0));
+
+          case 9:
+          case "end":
+            return _context.stop();
+        }
+      }
+    }, _callee, null, [[1, 6]]);
+  }));
+  return _loadSpectorJS.apply(this, arguments);
+}
+
+function initializeSpectorJS(props) {
+  var _props, _props2;
+
+  props = _objectSpread(_objectSpread({}, DEFAULT_SPECTOR_PROPS), props);
+
+  if (!((_props = props) !== null && _props !== void 0 && _props.spector)) {
+    return null;
+  }
+
+  if (!spector && globalThis.SPECTOR) {
+    _api.log.probe(LOG_LEVEL, "SPECTOR found and initialized")();
+
+    spector = new globalThis.SPECTOR.Spector();
+
+    if (globalThis.luma) {
+      globalThis.luma.spector = spector;
+    }
+  }
+
+  if (!spector) {
+    return null;
+  }
+
+  if (!initialized) {
+    var _spector, _spector2;
+
+    initialized = true;
+    spector.spyCanvases();
+    (_spector = spector) === null || _spector === void 0 ? void 0 : _spector.onCaptureStarted.add(function (capture) {
+      return _api.log.info("Spector capture started:", capture)();
+    });
+    (_spector2 = spector) === null || _spector2 === void 0 ? void 0 : _spector2.onCapture.add(function (capture) {
+      var _spector3, _spector4, _spector5;
+
+      _api.log.info("Spector capture complete:", capture)();
+
+      (_spector3 = spector) === null || _spector3 === void 0 ? void 0 : _spector3.getResultUI();
+      (_spector4 = spector) === null || _spector4 === void 0 ? void 0 : _spector4.resultView.display();
+      (_spector5 = spector) === null || _spector5 === void 0 ? void 0 : _spector5.resultView.addCapture(capture);
+    });
+  }
+
+  if ((_props2 = props) !== null && _props2 !== void 0 && _props2.canvas) {
+    var _spector6, _props3;
+
+    if (typeof props.spector === 'string' && props.spector !== props.canvas.id) {
+      return spector;
+    }
+
+    (_spector6 = spector) === null || _spector6 === void 0 ? void 0 : _spector6.startCapture((_props3 = props) === null || _props3 === void 0 ? void 0 : _props3.canvas, 500);
+    new Promise(function (resolve) {
+      return setTimeout(resolve, 2000);
+    }).then(function (_) {
+      var _spector7;
+
+      _api.log.info("Spector capture stopped after 2 seconds")();
+
+      (_spector7 = spector) === null || _spector7 === void 0 ? void 0 : _spector7.stopCapture();
+    });
+  }
+
+  return spector;
+}
+//# sourceMappingURL=spector.js.map

package/dist/es5/context/debug/spector.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/context/debug/spector.ts"],"names":["DEFAULT_SPECTOR_PROPS","spector","log","get","SPECTOR_CDN_URL","LOG_LEVEL","initialized","loadSpectorJS","props","globalThis","SPECTOR","warn","String","initializeSpectorJS","probe","Spector","luma","spyCanvases","onCaptureStarted","add","capture","info","onCapture","getResultUI","resultView","display","addCapture","canvas","id","startCapture","Promise","resolve","setTimeout","then","_","stopCapture"],"mappings":";;;;;;;;;;;;;;;;AACA;;;;;;AAYA,IAAMA,qBAAmC,GAAG;AAC1CC,EAAAA,OAAO,EAAEC,SAAIC,GAAJ,CAAQ,SAAR,KAAsBD,SAAIC,GAAJ,CAAQ,SAAR;AADW,CAA5C;AAKA,IAAMC,eAAe,GAAG,oDAAxB;AACA,IAAMC,SAAS,GAAG,CAAlB;AAEA,IAAIJ,OAAY,GAAG,IAAnB;AACA,IAAIK,WAAoB,GAAG,KAA3B;;SAOsBC,a;;;;;6EAAf,iBAA6BC,KAA7B;AAAA;AAAA;AAAA;AAAA;AAAA,gBACAC,UAAU,CAACC,OADX;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA,mBAGK,qBAAWN,eAAX,CAHL;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAKDF,qBAAIS,IAAJ,CAASC,MAAM,aAAf;;AALC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,G;;;;AAUA,SAASC,mBAAT,CAA6BL,KAA7B,EAAmD;AAAA;;AACxDA,EAAAA,KAAK,mCAAOR,qBAAP,GAAiCQ,KAAjC,CAAL;;AACA,MAAI,YAACA,KAAD,mCAAC,OAAOP,OAAR,CAAJ,EAAqB;AACnB,WAAO,IAAP;AACD;;AAED,MAAI,CAACA,OAAD,IAAYQ,UAAU,CAACC,OAA3B,EAAoC;AAClCR,aAAIY,KAAJ,CAAUT,SAAV,EAAqB,+BAArB;;AACAJ,IAAAA,OAAO,GAAG,IAAIQ,UAAU,CAACC,OAAX,CAAmBK,OAAvB,EAAV;;AACA,QAAIN,UAAU,CAACO,IAAf,EAAqB;AACnBP,MAAAA,UAAU,CAACO,IAAX,CAAgBf,OAAhB,GAA0BA,OAA1B;AACD;AACF;;AAED,MAAI,CAACA,OAAL,EAAc;AACZ,WAAO,IAAP;AACD;;AAED,MAAI,CAACK,WAAL,EAAkB;AAAA;;AAChBA,IAAAA,WAAW,GAAG,IAAd;AAGAL,IAAAA,OAAO,CAACgB,WAAR;AAEA,gBAAAhB,OAAO,UAAP,4CAASiB,gBAAT,CAA0BC,GAA1B,CAA8B,UAACC,OAAD;AAAA,aAAsBlB,SAAImB,IAAJ,6BAAqCD,OAArC,GAAtB;AAAA,KAA9B;AACA,iBAAAnB,OAAO,UAAP,8CAASqB,SAAT,CAAmBH,GAAnB,CAAuB,UAACC,OAAD,EAAsB;AAAA;;AAC3ClB,eAAImB,IAAJ,8BAAsCD,OAAtC;;AAGA,mBAAAnB,OAAO,UAAP,8CAASsB,WAAT;AACA,mBAAAtB,OAAO,UAAP,8CAASuB,UAAT,CAAoBC,OAApB;AACA,mBAAAxB,OAAO,UAAP,8CAASuB,UAAT,CAAoBE,UAApB,CAA+BN,OAA/B;AACD,KAPD;AAQD;;AAED,iBAAIZ,KAAJ,oCAAI,QAAOmB,MAAX,EAAmB;AAAA;;AAEjB,QAAI,OAAOnB,KAAK,CAACP,OAAb,KAAyB,QAAzB,IAAqCO,KAAK,CAACP,OAAN,KAAkBO,KAAK,CAACmB,MAAN,CAAaC,EAAxE,EAA4E;AAC1E,aAAO3B,OAAP;AACD;;AAID,iBAAAA,OAAO,UAAP,8CAAS4B,YAAT,YAAsBrB,KAAtB,4CAAsB,QAAOmB,MAA7B,EAAqC,GAArC;AACA,QAAIG,OAAJ,CAAY,UAAAC,OAAO;AAAA,aAAIC,UAAU,CAACD,OAAD,EAAU,IAAV,CAAd;AAAA,KAAnB,EAAkDE,IAAlD,CAAuD,UAAAC,CAAC,EAAI;AAAA;;AAC1DhC,eAAImB,IAAJ;;AACA,mBAAApB,OAAO,UAAP,8CAASkC,WAAT;AAED,KAJD;AAKD;;AAED,SAAOlC,OAAP;AACD","sourcesContent":["// luma.gl, MIT license\nimport {log, loadScript} from '@luma.gl/api';\n\n/** Spector debug initialization options */\ntype SpectorProps = {\n  /** Canvas to monitor */\n  canvas?: HTMLCanvasElement | OffscreenCanvas;\n  /** Whether debug is enabled. Auto-detected if ommitted */\n  debug?: boolean;\n  /** Whether spector is disabled */\n  spector?: boolean | string | object;\n};\n\nconst DEFAULT_SPECTOR_PROPS: SpectorProps = {\n  spector: log.get('spector') || log.get('inspect')\n};\n\n// https://github.com/BabylonJS/Spector.js#basic-usage\nconst SPECTOR_CDN_URL = 'https://spectorcdn.babylonjs.com/spector.bundle.js';\nconst LOG_LEVEL = 1;\n\nlet spector: any = null;\nlet initialized: boolean = false;\n\ndeclare global {\n  var SPECTOR: any;\n}\n\n/** Loads spector from CDN if not already installed */\nexport async function loadSpectorJS(props?: SpectorProps) {\n  if (!globalThis.SPECTOR) {\n    try {\n      await loadScript(SPECTOR_CDN_URL);\n    } catch(error) {\n      log.warn(String(error))\n    }\n  }\n}\n\nexport function initializeSpectorJS(props?: SpectorProps) {\n  props = {...DEFAULT_SPECTOR_PROPS, ...props};\n  if (!props?.spector) {\n    return null;\n  }\n\n  if (!spector && globalThis.SPECTOR) {\n    log.probe(LOG_LEVEL, \"SPECTOR found and initialized\")();\n    spector = new globalThis.SPECTOR.Spector();\n    if (globalThis.luma) {\n      globalThis.luma.spector = spector;\n    }\n  }\n\n  if (!spector) {\n    return null;\n  }\n\n  if (!initialized) {\n    initialized = true;\n\n    // enables recording some extra information merged in the capture like texture memory sizes and formats\n    spector.spyCanvases();\n    // A callback when results are ready\n    spector?.onCaptureStarted.add((capture: unknown) => log.info(`Spector capture started:`, capture)());\n    spector?.onCapture.add((capture: unknown) => {\n      log.info(`Spector capture complete:`, capture)();\n      // Use undocumented Spector API to open the UI with our capture\n      // See https://github.com/BabylonJS/Spector.js/blob/767ad1195a25b85a85c381f400eb50a979239eca/src/spector.ts#L124\n      spector?.getResultUI()\n      spector?.resultView.display();\n      spector?.resultView.addCapture(capture)\n    });\n  }\n\n  if (props?.canvas) {\n    // @ts-expect-error If spector is specified as a canvas id, only monitor that canvas\n    if (typeof props.spector === 'string' && props.spector !== props.canvas.id) {\n      return spector;\n    }\n\n    // capture startup\n    // spector?.captureCanvas(props?.canvas);\n    spector?.startCapture(props?.canvas, 500); // 500 commands\n    new Promise(resolve => setTimeout(resolve, 2000)).then(_ => {\n      log.info(`Spector capture stopped after 2 seconds`)();\n      spector?.stopCapture();\n      // spector?.displayUI();\n    });\n  }\n\n  return spector;\n}\n"],"file":"spector.js"}

package/dist/es5/context/debug/webgl-developer-tools.js

@@ -0,0 +1,198 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.loadWebGLDeveloperTools = loadWebGLDeveloperTools;
+exports.makeDebugContext = makeDebugContext;
+
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+
+var _api = require("@luma.gl/api/");
+
+var _constants = _interopRequireDefault(require("@luma.gl/constants"));
+
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+var WEBGL_DEBUG_CDN_URL = 'https://unpkg.com/webgl-debug@2.0.1/index.js';
+var DEFAULT_DEBUG_CONTEXT_PROPS = {
+  debug: true,
+  throwOnError: false,
+  break: [],
+  webgl2: false
+};
+
+function getContextData(gl) {
+  gl.luma = gl.luma || {};
+  return gl.luma;
+}
+
+function loadWebGLDeveloperTools() {
+  return _loadWebGLDeveloperTools.apply(this, arguments);
+}
+
+function _loadWebGLDeveloperTools() {
+  _loadWebGLDeveloperTools = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee() {
+    return _regenerator.default.wrap(function _callee$(_context) {
+      while (1) {
+        switch (_context.prev = _context.next) {
+          case 0:
+            if (globalThis.WebGLDebugUtils) {
+              _context.next = 5;
+              break;
+            }
+
+            globalThis.global = globalThis.global || globalThis;
+            globalThis.global.module = {};
+            _context.next = 5;
+            return (0, _api.loadScript)(WEBGL_DEBUG_CDN_URL);
+
+          case 5:
+          case "end":
+            return _context.stop();
+        }
+      }
+    }, _callee);
+  }));
+  return _loadWebGLDeveloperTools.apply(this, arguments);
+}
+
+function makeDebugContext(gl) {
+  var props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+
+  if (!gl) {
+    return null;
+  }
+
+  return props.debug ? getDebugContext(gl, props) : getRealContext(gl);
+}
+
+function getRealContext(gl) {
+  var data = getContextData(gl);
+  return data.realContext ? data.realContext : gl;
+}
+
+function getDebugContext(gl, props) {
+  if (!globalThis.WebGLDebugUtils) {
+    _api.log.warn('webgl-debug not loaded')();
+
+    return gl;
+  }
+
+  var data = getContextData(gl);
+
+  if (data.debugContext) {
+    return data.debugContext;
+  }
+
+  globalThis.WebGLDebugUtils.init(_objectSpread(_objectSpread({}, _constants.default), gl));
+  var glDebug = globalThis.WebGLDebugUtils.makeDebugContext(gl, onGLError.bind(null, props), onValidateGLFunc.bind(null, props));
+
+  for (var key in _constants.default) {
+    if (!(key in glDebug) && typeof _constants.default[key] === 'number') {
+      glDebug[key] = _constants.default[key];
+    }
+  }
+
+  var WebGLDebugContext = function WebGLDebugContext() {
+    (0, _classCallCheck2.default)(this, WebGLDebugContext);
+  };
+
+  Object.setPrototypeOf(glDebug, Object.getPrototypeOf(gl));
+  Object.setPrototypeOf(WebGLDebugContext, glDebug);
+  var debugContext = Object.create(WebGLDebugContext);
+  data.realContext = gl;
+  data.debugContext = debugContext;
+  debugContext.debug = true;
+  return debugContext;
+}
+
+function getFunctionString(functionName, functionArgs) {
+  functionArgs = Array.from(functionArgs).map(function (arg) {
+    return arg === undefined ? 'undefined' : arg;
+  });
+  var args = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, functionArgs);
+  args = "".concat(args.slice(0, 100)).concat(args.length > 100 ? '...' : '');
+  return "gl.".concat(functionName, "(").concat(args, ")");
+}
+
+function onGLError(props, err, functionName, args) {
+  args = Array.from(args).map(function (arg) {
+    return arg === undefined ? 'undefined' : arg;
+  });
+  var errorMessage = globalThis.WebGLDebugUtils.glEnumToString(err);
+  var functionArgs = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, args);
+  var glName = props.webgl2 ? 'gl2' : 'gl1';
+  var message = "".concat(errorMessage, " in ").concat(glName, ".").concat(functionName, "(").concat(functionArgs, ")");
+
+  _api.log.error(message)();
+
+  debugger;
+
+  if (props.throwOnError) {
+    throw new Error(message);
+  }
+}
+
+function onValidateGLFunc(props, functionName, functionArgs) {
+  var functionString = '';
+
+  if (_api.log.level >= 1) {
+    functionString = getFunctionString(functionName, functionArgs);
+
+    _api.log.log(1, functionString)();
+  }
+
+  if (props.break) {
+    functionString = functionString || getFunctionString(functionName, functionArgs);
+    var isBreakpoint = props.break && props.break.every(function (breakOn) {
+      return functionString.indexOf(breakOn) !== -1;
+    });
+
+    if (isBreakpoint) {
+      debugger;
+    }
+  }
+
+  var _iterator = _createForOfIteratorHelper(functionArgs),
+      _step;
+
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var arg = _step.value;
+
+      if (arg === undefined) {
+        functionString = functionString || getFunctionString(functionName, functionArgs);
+
+        if (props.throwOnError) {
+          throw new Error("Undefined argument: ".concat(functionString));
+        } else {
+          _api.log.error("Undefined argument: ".concat(functionString))();
+
+          debugger;
+        }
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+}
+//# sourceMappingURL=webgl-developer-tools.js.map

package/dist/es5/context/debug/webgl-developer-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/context/debug/webgl-developer-tools.ts"],"names":["WEBGL_DEBUG_CDN_URL","DEFAULT_DEBUG_CONTEXT_PROPS","debug","throwOnError","break","webgl2","getContextData","gl","luma","loadWebGLDeveloperTools","globalThis","WebGLDebugUtils","global","module","makeDebugContext","props","getDebugContext","getRealContext","data","realContext","log","warn","debugContext","init","GL","glDebug","onGLError","bind","onValidateGLFunc","key","WebGLDebugContext","Object","setPrototypeOf","getPrototypeOf","create","getFunctionString","functionName","functionArgs","Array","from","map","arg","undefined","args","glFunctionArgsToString","slice","length","err","errorMessage","glEnumToString","glName","message","error","Error","functionString","level","isBreakpoint","every","breakOn","indexOf"],"mappings":"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","sourcesContent":["// luma.gl, MIT license\nimport {log, loadScript} from '@luma.gl/api/';\nimport GL from '@luma.gl/constants';\n\nconst WEBGL_DEBUG_CDN_URL = 'https://unpkg.com/webgl-debug@2.0.1/index.js';\n\ntype DebugContextProps = {\n  debug?: boolean;\n  throwOnError?: boolean;\n  break?: string[];\n  webgl2?: boolean;\n};\n\nconst DEFAULT_DEBUG_CONTEXT_PROPS: Required<DebugContextProps> = {\n  debug: true,\n  throwOnError: false,\n  break: [],\n  webgl2: false,\n}\n\n// Helper to get shared context data\nfunction getContextData(gl: any) {\n  gl.luma = gl.luma || {};\n  return gl.luma;\n}\n\ndeclare global {\n  var WebGLDebugUtils: any;\n}\n\n/**\n * Loads Khronos WebGLDeveloperTools from CDN if not already installed \n * const WebGLDebugUtils = require('webgl-debug');\n * @see https://github.com/KhronosGroup/WebGLDeveloperTools\n * @see https://github.com/vorg/webgl-debug\n */\nexport async function loadWebGLDeveloperTools(): Promise<void> {\n  if (!globalThis.WebGLDebugUtils) {\n    // @ts-expect-error Developer tools expects global to be set\n    globalThis.global = globalThis.global || globalThis;\n    // @ts-expect-error Developer tools expects global to be set\n    globalThis.global.module = {};\n    await loadScript(WEBGL_DEBUG_CDN_URL);\n  }\n}\n\n// Returns (a potentially new) context with debug instrumentation turned off or on.\n// Note that this actually returns a new context\nexport function makeDebugContext(gl: WebGLRenderingContext, props: DebugContextProps = {}): WebGLRenderingContext | null {\n  // Return null to ensure we don't try to create a context in this case (TODO what case is that?)\n  if (!gl) {\n    return null;\n  }\n\n  return props.debug ? getDebugContext(gl, props) : getRealContext(gl);\n}\n\n// Returns the real context from either of the real/debug contexts\nfunction getRealContext(gl: WebGLRenderingContext): WebGLRenderingContext {\n  const data = getContextData(gl);\n  // If the context has a realContext member, it is a debug context so return the realContext\n  return data.realContext ? data.realContext : gl;\n}\n\n// Returns the debug context from either of the real/debug contexts\nfunction getDebugContext(gl: WebGLRenderingContext, props: DebugContextProps): WebGLRenderingContext {\n  if (!globalThis.WebGLDebugUtils) {\n    log.warn('webgl-debug not loaded')();\n    return gl;\n  }\n\n  const data = getContextData(gl);\n\n  // If this already has a debug context, return it.\n  if (data.debugContext) {\n    return data.debugContext;\n  }\n\n  // Create a new debug context\n  globalThis.WebGLDebugUtils.init({...GL, ...gl});\n  const glDebug = globalThis.WebGLDebugUtils.makeDebugContext(\n    gl,\n    onGLError.bind(null, props),\n    onValidateGLFunc.bind(null, props)\n  );\n\n  // Make sure we have all WebGL2 and extension constants (todo dynamic import to circumvent minification?)\n  for (const key in GL) {\n    if (!(key in glDebug) && typeof GL[key] === 'number') {\n      glDebug[key] = GL[key];\n    }\n  }\n  \n  // Ensure we have a clean prototype on the instrumented object\n  // Note: setPrototypeOf does come with perf warnings, but we already take a bigger perf reduction\n  // by synchronizing the WebGL errors after each WebGL call.\n  class WebGLDebugContext {}\n  Object.setPrototypeOf(glDebug, Object.getPrototypeOf(gl));\n  Object.setPrototypeOf(WebGLDebugContext, glDebug);\n  const debugContext = Object.create(WebGLDebugContext);\n  // Store the debug context\n  data.realContext = gl;\n  data.debugContext = debugContext;\n  debugContext.debug = true;\n\n  // Return it\n  return debugContext;\n}\n\n// DEBUG TRACING\n\nfunction getFunctionString(functionName: string, functionArgs): string {\n  // Cover bug in webgl-debug-tools\n  functionArgs = Array.from(functionArgs).map(arg => arg === undefined ? 'undefined' : arg);\n  let args = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, functionArgs);\n  args = `${args.slice(0, 100)}${args.length > 100 ? '...' : ''}`;\n  return `gl.${functionName}(${args})`;\n}\n\nfunction onGLError(props: DebugContextProps, err, functionName: string, args: any[]): void {\n  // Cover bug in webgl-debug-tools\n  args = Array.from(args).map(arg => arg === undefined ? 'undefined' : arg);\n  const errorMessage = globalThis.WebGLDebugUtils.glEnumToString(err);\n  const functionArgs = globalThis.WebGLDebugUtils.glFunctionArgsToString(functionName, args);\n  const glName = props.webgl2 ? 'gl2' : 'gl1';\n  const message = `${errorMessage} in ${glName}.${functionName}(${functionArgs})`;\n  log.error(message)();\n  debugger; // eslint-disable-line\n  if (props.throwOnError) {\n    throw new Error(message);\n  }\n}\n\n// Don't generate function string until it is needed\nfunction onValidateGLFunc(props: DebugContextProps, functionName: string, functionArgs: any[]): void {\n  let functionString: string = '';\n  if (log.level >= 1) {\n    functionString = getFunctionString(functionName, functionArgs);\n    log.log(1, functionString)();\n  }\n\n  if (props.break) {\n    functionString = functionString || getFunctionString(functionName, functionArgs);\n    const isBreakpoint =\n      props.break && props.break.every((breakOn: string) => functionString.indexOf(breakOn) !== -1);\n    if (isBreakpoint) {\n      debugger; // eslint-disable-line\n    }\n  }\n\n  for (const arg of functionArgs) {\n    if (arg === undefined) {\n      functionString = functionString || getFunctionString(functionName, functionArgs);\n      if (props.throwOnError) {\n        throw new Error(`Undefined argument: ${functionString}`);\n      } else {\n        log.error(`Undefined argument: ${functionString}`)();\n        debugger; // eslint-disable-line\n      }\n    }\n  }\n}\n"],"file":"webgl-developer-tools.js"}