@luma.gl/webgl 9.0.0-alpha.35 → 9.0.0-alpha.36

package/dist/context/parameters/unified-parameter-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"unified-parameter-api.js","names":["GL_PARAMETER_DEFAULTS","GL_PARAMETER_SETTERS","GL_COMPOSITE_PARAMETER_SETTERS","GL_PARAMETER_GETTERS","WebGLDevice","setParameters","device","parameters","webglDevice","attach","gl","isObjectEmpty","compositeSetters","key","glConstant","Number","setter","cache","state","compositeSetter","getParameters","arguments","length","undefined","getter","getParameter","parameterKeys","Array","isArray","Object","keys","resetParameters","object"],"sources":["../../../src/context/parameters/unified-parameter-api.ts"],"sourcesContent":["// Provides a unified API for getting and setting any WebGL parameter\n// Also knows default values of all parameters, enabling fast cache initialization\n// Provides base functionality for the state caching.\nimport {Device} from '@luma.gl/core';\nimport type {GLParameters} from '@luma.gl/constants';\nimport {\n  GL_PARAMETER_DEFAULTS,\n  GL_PARAMETER_SETTERS,\n  GL_COMPOSITE_PARAMETER_SETTERS,\n  GL_PARAMETER_GETTERS\n} from './webgl-parameter-tables';\n\nimport {WebGLDevice} from '../../adapter/webgl-device';\n\nexport type {GLParameters};\n\n/**\n * Sets any GL parameter regardless of function (gl.blendMode, ...)\n *\n * @note requires a `cache` object to be set on the context (gl.state.cache)\n * This object is used to fill in any missing values for composite setter functions\n */\nexport function setParameters(\n  device: Device | WebGLRenderingContext,\n  parameters: GLParameters\n): void {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  if (isObjectEmpty(parameters)) {\n    return;\n  }\n\n  const compositeSetters = {};\n\n  // HANDLE PRIMITIVE SETTERS (and make note of any composite setters)\n\n  for (const key in parameters) {\n    const glConstant = Number(key);\n    const setter = GL_PARAMETER_SETTERS[key];\n    if (setter) {\n      // Composite setters should only be called once, so save them\n      if (typeof setter === 'string') {\n        compositeSetters[setter] = true;\n      } else {\n        // if (gl[glConstant] !== undefined) {\n        // TODO - added above check since this is being called on WebGL2 parameters in WebGL1...\n        // TODO - deep equal on values? only call setter if value has changed?\n        // NOTE - the setter will automatically update this.state\n        setter(gl, parameters[key], glConstant);\n      }\n    }\n  }\n\n  // HANDLE COMPOSITE SETTERS\n\n  // NOTE: any non-provided values needed by composite setters are filled in from state cache\n  // The cache parameter is automatically retrieved from the context\n  // This depends on `trackContextState`, which is technically a \"circular\" dependency.\n  // But it is too inconvenient to always require a cache parameter here.\n  // This is the ONLY external dependency in this module/\n  // @ts-expect-error\n  const cache = gl.state && gl.state.cache;\n  if (cache) {\n    for (const key in compositeSetters) {\n      // TODO - avoid calling composite setters if values have not changed.\n      const compositeSetter = GL_COMPOSITE_PARAMETER_SETTERS[key];\n      // Note - if `trackContextState` has been called,\n      // the setter will automatically update this.state.cache\n      compositeSetter(gl, parameters, cache);\n    }\n  }\n\n  // Add a log for the else case?\n}\n\n/**\n * Reads the entire WebGL state from a context\n\n  // default to querying all parameters\n\n  * @returns - a newly created map, with values keyed by GL parameters\n *\n * @note Copies the state from a context (gl.getParameter should not be overriden)\n * Reads the entire WebGL state from a context\n *\n * @note This can generates a huge amount of synchronous driver roundtrips and should be\n * considered a very slow operation, to be used only if/when a context already manipulated\n * by external code needs to be synchronized for the first time\n */\nexport function getParameters(\n  device: Device | WebGLRenderingContext,\n  parameters: keyof GLParameters | (keyof GLParameters)[] | GLParameters = GL_PARAMETER_DEFAULTS\n): GLParameters {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  // support both arrays of parameters and objects (keys represent parameters)\n\n  if (typeof parameters === 'number') {\n    // single GL enum\n    const key = parameters;\n    const getter = GL_PARAMETER_GETTERS[key];\n    return getter ? getter(gl, key) : gl.getParameter(key);\n  }\n\n  const parameterKeys = Array.isArray(parameters) ? parameters : Object.keys(parameters);\n\n  const state = {};\n  for (const key of parameterKeys) {\n    const getter = GL_PARAMETER_GETTERS[key];\n    state[key] = getter ? getter(gl, Number(key)) : gl.getParameter(Number(key));\n  }\n  return state;\n}\n\n/**\n * Reset all parameters to a (almost) pure context state\n * @note viewport and scissor will be set to the values in GL_PARAMETER_DEFAULTS,\n * NOT the canvas size dimensions, so they will have to be properly set after\n * calling this function.\n */\nexport function resetParameters(device: Device | WebGLRenderingContext): void {\n  setParameters(device, GL_PARAMETER_DEFAULTS);\n}\n\n// Helpers\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(object) {\n  // @ts-ignore dummy key variable\n  for (const key in object) {\n    return false;\n  }\n  return true;\n}\n"],"mappings":"SAMEA,qBAAqB,EACrBC,oBAAoB,EACpBC,8BAA8B,EAC9BC,oBAAoB;AAAA,SAGdC,WAAW;AAUnB,OAAO,SAASC,aAAaA,CAC3BC,MAAsC,EACtCC,UAAwB,EAClB;EACN,MAAMC,WAAW,GAAGJ,WAAW,CAACK,MAAM,CAACH,MAAM,CAAC;EAC9C,MAAMI,EAAE,GAAGF,WAAW,CAACE,EAAE;EAEzB,IAAIC,aAAa,CAACJ,UAAU,CAAC,EAAE;IAC7B;EACF;EAEA,MAAMK,gBAAgB,GAAG,CAAC,CAAC;EAI3B,KAAK,MAAMC,GAAG,IAAIN,UAAU,EAAE;IAC5B,MAAMO,UAAU,GAAGC,MAAM,CAACF,GAAG,CAAC;IAC9B,MAAMG,MAAM,GAAGf,oBAAoB,CAACY,GAAG,CAAC;IACxC,IAAIG,MAAM,EAAE;MAEV,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;QAC9BJ,gBAAgB,CAACI,MAAM,CAAC,GAAG,IAAI;MACjC,CAAC,MAAM;QAKLA,MAAM,CAACN,EAAE,EAAEH,UAAU,CAACM,GAAG,CAAC,EAAEC,UAAU,CAAC;MACzC;IACF;EACF;EAUA,MAAMG,KAAK,GAAGP,EAAE,CAACQ,KAAK,IAAIR,EAAE,CAACQ,KAAK,CAACD,KAAK;EACxC,IAAIA,KAAK,EAAE;IACT,KAAK,MAAMJ,GAAG,IAAID,gBAAgB,EAAE;MAElC,MAAMO,eAAe,GAAGjB,8BAA8B,CAACW,GAAG,CAAC;MAG3DM,eAAe,CAACT,EAAE,EAAEH,UAAU,EAAEU,KAAK,CAAC;IACxC;EACF;AAGF;AAgBA,OAAO,SAASG,aAAaA,CAC3Bd,MAAsC,EAExB;EAAA,IADdC,UAAsE,GAAAc,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGrB,qBAAqB;EAE9F,MAAMQ,WAAW,GAAGJ,WAAW,CAACK,MAAM,CAACH,MAAM,CAAC;EAC9C,MAAMI,EAAE,GAAGF,WAAW,CAACE,EAAE;EAIzB,IAAI,OAAOH,UAAU,KAAK,QAAQ,EAAE;IAElC,MAAMM,GAAG,GAAGN,UAAU;IACtB,MAAMiB,MAAM,GAAGrB,oBAAoB,CAACU,GAAG,CAAC;IACxC,OAAOW,MAAM,GAAGA,MAAM,CAACd,EAAE,EAAEG,GAAG,CAAC,GAAGH,EAAE,CAACe,YAAY,CAACZ,GAAG,CAAC;EACxD;EAEA,MAAMa,aAAa,GAAGC,KAAK,CAACC,OAAO,CAACrB,UAAU,CAAC,GAAGA,UAAU,GAAGsB,MAAM,CAACC,IAAI,CAACvB,UAAU,CAAC;EAEtF,MAAMW,KAAK,GAAG,CAAC,CAAC;EAChB,KAAK,MAAML,GAAG,IAAIa,aAAa,EAAE;IAC/B,MAAMF,MAAM,GAAGrB,oBAAoB,CAACU,GAAG,CAAC;IACxCK,KAAK,CAACL,GAAG,CAAC,GAAGW,MAAM,GAAGA,MAAM,CAACd,EAAE,EAAEK,MAAM,CAACF,GAAG,CAAC,CAAC,GAAGH,EAAE,CAACe,YAAY,CAACV,MAAM,CAACF,GAAG,CAAC,CAAC;EAC9E;EACA,OAAOK,KAAK;AACd;AAQA,OAAO,SAASa,eAAeA,CAACzB,MAAsC,EAAQ;EAC5ED,aAAa,CAACC,MAAM,EAAEN,qBAAqB,CAAC;AAC9C;AAKA,SAASW,aAAaA,CAACqB,MAAM,EAAE;EAE7B,KAAK,MAAMnB,GAAG,IAAImB,MAAM,EAAE;IACxB,OAAO,KAAK;EACd;EACA,OAAO,IAAI;AACb"}
+{"version":3,"file":"unified-parameter-api.js","names":["GL_PARAMETER_DEFAULTS","GL_PARAMETER_SETTERS","GL_COMPOSITE_PARAMETER_SETTERS","GL_PARAMETER_GETTERS","WebGLDevice","setGLParameters","device","parameters","webglDevice","attach","gl","isObjectEmpty","compositeSetters","key","glConstant","Number","setter","cache","state","compositeSetter","getGLParameters","arguments","length","undefined","getter","getParameter","parameterKeys","Array","isArray","Object","keys","resetGLParameters","object"],"sources":["../../../src/context/parameters/unified-parameter-api.ts"],"sourcesContent":["// Provides a unified API for getting and setting any WebGL parameter\n// Also knows default values of all parameters, enabling fast cache initialization\n// Provides base functionality for the state caching.\nimport {Device} from '@luma.gl/core';\nimport type {GLParameters} from '@luma.gl/constants';\nimport {\n  GL_PARAMETER_DEFAULTS,\n  GL_PARAMETER_SETTERS,\n  GL_COMPOSITE_PARAMETER_SETTERS,\n  GL_PARAMETER_GETTERS\n} from './webgl-parameter-tables';\n\nimport {WebGLDevice} from '../../adapter/webgl-device';\n\nexport type {GLParameters};\n\n/**\n * Sets any GL parameter regardless of function (gl.blendMode, ...)\n *\n * @note requires a `cache` object to be set on the context (gl.state.cache)\n * This object is used to fill in any missing values for composite setter functions\n */\nexport function setGLParameters(\n  device: Device | WebGLRenderingContext,\n  parameters: GLParameters\n): void {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  if (isObjectEmpty(parameters)) {\n    return;\n  }\n\n  const compositeSetters = {};\n\n  // HANDLE PRIMITIVE SETTERS (and make note of any composite setters)\n\n  for (const key in parameters) {\n    const glConstant = Number(key);\n    const setter = GL_PARAMETER_SETTERS[key];\n    if (setter) {\n      // Composite setters should only be called once, so save them\n      if (typeof setter === 'string') {\n        compositeSetters[setter] = true;\n      } else {\n        // if (gl[glConstant] !== undefined) {\n        // TODO - added above check since this is being called on WebGL2 parameters in WebGL1...\n        // TODO - deep equal on values? only call setter if value has changed?\n        // NOTE - the setter will automatically update this.state\n        setter(gl, parameters[key], glConstant);\n      }\n    }\n  }\n\n  // HANDLE COMPOSITE SETTERS\n\n  // NOTE: any non-provided values needed by composite setters are filled in from state cache\n  // The cache parameter is automatically retrieved from the context\n  // This depends on `trackContextState`, which is technically a \"circular\" dependency.\n  // But it is too inconvenient to always require a cache parameter here.\n  // This is the ONLY external dependency in this module/\n  // @ts-expect-error\n  const cache = gl.state && gl.state.cache;\n  if (cache) {\n    for (const key in compositeSetters) {\n      // TODO - avoid calling composite setters if values have not changed.\n      const compositeSetter = GL_COMPOSITE_PARAMETER_SETTERS[key];\n      // Note - if `trackContextState` has been called,\n      // the setter will automatically update this.state.cache\n      compositeSetter(gl, parameters, cache);\n    }\n  }\n\n  // Add a log for the else case?\n}\n\n/**\n * Reads the entire WebGL state from a context\n\n  // default to querying all parameters\n\n  * @returns - a newly created map, with values keyed by GL parameters\n *\n * @note Copies the state from a context (gl.getParameter should not be overriden)\n * Reads the entire WebGL state from a context\n *\n * @note This can generates a huge amount of synchronous driver roundtrips and should be\n * considered a very slow operation, to be used only if/when a context already manipulated\n * by external code needs to be synchronized for the first time\n */\nexport function getGLParameters(\n  device: Device | WebGLRenderingContext,\n  parameters: keyof GLParameters | (keyof GLParameters)[] | GLParameters = GL_PARAMETER_DEFAULTS\n): GLParameters {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  // support both arrays of parameters and objects (keys represent parameters)\n\n  if (typeof parameters === 'number') {\n    // single GL enum\n    const key = parameters;\n    const getter = GL_PARAMETER_GETTERS[key];\n    return getter ? getter(gl, key) : gl.getParameter(key);\n  }\n\n  const parameterKeys = Array.isArray(parameters) ? parameters : Object.keys(parameters);\n\n  const state = {};\n  for (const key of parameterKeys) {\n    const getter = GL_PARAMETER_GETTERS[key];\n    state[key] = getter ? getter(gl, Number(key)) : gl.getParameter(Number(key));\n  }\n  return state;\n}\n\n/**\n * Reset all parameters to a (almost) pure context state\n * @note viewport and scissor will be set to the values in GL_PARAMETER_DEFAULTS,\n * NOT the canvas size dimensions, so they will have to be properly set after\n * calling this function.\n */\nexport function resetGLParameters(device: Device | WebGLRenderingContext): void {\n  setGLParameters(device, GL_PARAMETER_DEFAULTS);\n}\n\n// Helpers\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(object) {\n  // @ts-ignore dummy key variable\n  for (const key in object) {\n    return false;\n  }\n  return true;\n}\n"],"mappings":"SAMEA,qBAAqB,EACrBC,oBAAoB,EACpBC,8BAA8B,EAC9BC,oBAAoB;AAAA,SAGdC,WAAW;AAUnB,OAAO,SAASC,eAAeA,CAC7BC,MAAsC,EACtCC,UAAwB,EAClB;EACN,MAAMC,WAAW,GAAGJ,WAAW,CAACK,MAAM,CAACH,MAAM,CAAC;EAC9C,MAAMI,EAAE,GAAGF,WAAW,CAACE,EAAE;EAEzB,IAAIC,aAAa,CAACJ,UAAU,CAAC,EAAE;IAC7B;EACF;EAEA,MAAMK,gBAAgB,GAAG,CAAC,CAAC;EAI3B,KAAK,MAAMC,GAAG,IAAIN,UAAU,EAAE;IAC5B,MAAMO,UAAU,GAAGC,MAAM,CAACF,GAAG,CAAC;IAC9B,MAAMG,MAAM,GAAGf,oBAAoB,CAACY,GAAG,CAAC;IACxC,IAAIG,MAAM,EAAE;MAEV,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;QAC9BJ,gBAAgB,CAACI,MAAM,CAAC,GAAG,IAAI;MACjC,CAAC,MAAM;QAKLA,MAAM,CAACN,EAAE,EAAEH,UAAU,CAACM,GAAG,CAAC,EAAEC,UAAU,CAAC;MACzC;IACF;EACF;EAUA,MAAMG,KAAK,GAAGP,EAAE,CAACQ,KAAK,IAAIR,EAAE,CAACQ,KAAK,CAACD,KAAK;EACxC,IAAIA,KAAK,EAAE;IACT,KAAK,MAAMJ,GAAG,IAAID,gBAAgB,EAAE;MAElC,MAAMO,eAAe,GAAGjB,8BAA8B,CAACW,GAAG,CAAC;MAG3DM,eAAe,CAACT,EAAE,EAAEH,UAAU,EAAEU,KAAK,CAAC;IACxC;EACF;AAGF;AAgBA,OAAO,SAASG,eAAeA,CAC7Bd,MAAsC,EAExB;EAAA,IADdC,UAAsE,GAAAc,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGrB,qBAAqB;EAE9F,MAAMQ,WAAW,GAAGJ,WAAW,CAACK,MAAM,CAACH,MAAM,CAAC;EAC9C,MAAMI,EAAE,GAAGF,WAAW,CAACE,EAAE;EAIzB,IAAI,OAAOH,UAAU,KAAK,QAAQ,EAAE;IAElC,MAAMM,GAAG,GAAGN,UAAU;IACtB,MAAMiB,MAAM,GAAGrB,oBAAoB,CAACU,GAAG,CAAC;IACxC,OAAOW,MAAM,GAAGA,MAAM,CAACd,EAAE,EAAEG,GAAG,CAAC,GAAGH,EAAE,CAACe,YAAY,CAACZ,GAAG,CAAC;EACxD;EAEA,MAAMa,aAAa,GAAGC,KAAK,CAACC,OAAO,CAACrB,UAAU,CAAC,GAAGA,UAAU,GAAGsB,MAAM,CAACC,IAAI,CAACvB,UAAU,CAAC;EAEtF,MAAMW,KAAK,GAAG,CAAC,CAAC;EAChB,KAAK,MAAML,GAAG,IAAIa,aAAa,EAAE;IAC/B,MAAMF,MAAM,GAAGrB,oBAAoB,CAACU,GAAG,CAAC;IACxCK,KAAK,CAACL,GAAG,CAAC,GAAGW,MAAM,GAAGA,MAAM,CAACd,EAAE,EAAEK,MAAM,CAACF,GAAG,CAAC,CAAC,GAAGH,EAAE,CAACe,YAAY,CAACV,MAAM,CAACF,GAAG,CAAC,CAAC;EAC9E;EACA,OAAOK,KAAK;AACd;AAQA,OAAO,SAASa,iBAAiBA,CAACzB,MAAsC,EAAQ;EAC9ED,eAAe,CAACC,MAAM,EAAEN,qBAAqB,CAAC;AAChD;AAKA,SAASW,aAAaA,CAACqB,MAAM,EAAE;EAE7B,KAAK,MAAMnB,GAAG,IAAImB,MAAM,EAAE;IACxB,OAAO,KAAK;EACd;EACA,OAAO,IAAI;AACb"}

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

@@ -1,6 +1,6 @@
 import { assert } from '@luma.gl/core';
 import { GL_PARAMETER_DEFAULTS, GL_HOOKED_SETTERS, NON_CACHE_PARAMETERS } from "../parameters/webgl-parameter-tables.js";
-import { setParameters, getParameters } from "../parameters/unified-parameter-api.js";
+import { setGLParameters, getGLParameters } from "../parameters/unified-parameter-api.js";
 import { deepArrayEqual } from "./deep-array-equal.js";
 class GLState {
   constructor(gl) {
@@ -15,7 +15,7 @@ class GLState {
     this.cache = void 0;
     this.log = void 0;
     this.gl = gl;
-    this.cache = copyState ? getParameters(gl) : Object.assign({}, GL_PARAMETER_DEFAULTS);
+    this.cache = copyState ? getGLParameters(gl) : Object.assign({}, GL_PARAMETER_DEFAULTS);
     this.log = log;
     this._updateCache = this._updateCache.bind(this);
     Object.seal(this);
@@ -27,7 +27,7 @@ class GLState {
   pop() {
     assert(this.stateStack.length > 0);
     const oldValues = this.stateStack[this.stateStack.length - 1];
-    setParameters(this.gl, oldValues);
+    setGLParameters(this.gl, oldValues);
     this.stateStack.pop();
   }
   _updateCache(values) {

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

@@ -1 +1 @@
-{"version":3,"file":"track-context-state.js","names":["assert","GL_PARAMETER_DEFAULTS","GL_HOOKED_SETTERS","NON_CACHE_PARAMETERS","setParameters","getParameters","deepArrayEqual","GLState","constructor","gl","copyState","log","arguments","length","undefined","program","stateStack","enable","cache","Object","assign","_updateCache","bind","seal","push","values","pop","oldValues","valueChanged","oldValue","key","value","cached","getContextState","state","trackContextState","options","installProgramSpy","setter","installSetterSpy","installGetterOverride","glState","pushContextState","popContextState","functionName","originalGetterFunc","get","pname","has","defineProperty","configurable","originalSetterFunc","set","_len","params","Array","_key","originalUseProgram","useProgram","useProgramLuma","handle"],"sources":["../../../src/context/state-tracker/track-context-state.ts"],"sourcesContent":["// Support for listening to context state changes and intercepting state queries\n// NOTE: this system does not handle buffer bindings\nimport {assert} from '@luma.gl/core';\nimport {GL_PARAMETER_DEFAULTS, GL_HOOKED_SETTERS, NON_CACHE_PARAMETERS} from '../parameters/webgl-parameter-tables';\nimport {setParameters, getParameters} from '../parameters/unified-parameter-api';\nimport {deepArrayEqual} from './deep-array-equal';\n\n// HELPER CLASS - GLState\n\n/* eslint-disable no-shadow */\nclass GLState {\n  gl: WebGLRenderingContext;\n  program: unknown = null;\n  stateStack: object[] = [];\n  enable = true;\n  cache: Record<string, any>;\n  log;\n\n  constructor(\n    gl: WebGLRenderingContext,\n    {\n      copyState = false, // Copy cache from params (slow) or initialize from WebGL defaults (fast)\n      log = () => {} // Logging function, called when gl parameter change calls are actually issued\n    } = {}\n  ) {\n    this.gl = gl;\n    this.cache = copyState ? getParameters(gl) : Object.assign({}, GL_PARAMETER_DEFAULTS);\n    this.log = log;\n\n    this._updateCache = this._updateCache.bind(this);\n    Object.seal(this);\n  }\n\n  push(values = {}) {\n    this.stateStack.push({});\n  }\n\n  pop() {\n    assert(this.stateStack.length > 0);\n    // Use the saved values in the state stack to restore parameters\n    const oldValues = this.stateStack[this.stateStack.length - 1];\n    setParameters(this.gl, oldValues);\n    // Don't pop until we have reset parameters (to make sure other \"stack frames\" are not affected)\n    this.stateStack.pop();\n  }\n\n  /**\n  // interceptor for context set functions - update our cache and our stack\n  // values (Object) - the key values for this setter\n   * @param values\n   * @returns\n   */\n  _updateCache(values: {[key: number | string]: any}) {\n    let valueChanged = false;\n    let oldValue; // = undefined\n\n    const oldValues: {[key: number | string]: any} | null = this.stateStack.length > 0 ? this.stateStack[this.stateStack.length - 1] : null;\n\n    for (const key in values) {\n      assert(key !== undefined);\n      const value = values[key];\n      const cached = this.cache[key];\n      // Check that value hasn't already been shadowed\n      if (!deepArrayEqual(value, cached)) {\n        valueChanged = true;\n        oldValue = cached;\n\n        // First, save current value being shadowed\n        // If a state stack frame is active, save the current parameter values for pop\n        // but first check that value hasn't already been shadowed and saved\n        if (oldValues && !(key in oldValues)) {\n          oldValues[key] = cached;\n        }\n\n        // Save current value being shadowed\n        this.cache[key] = value;\n      }\n    }\n\n    return {valueChanged, oldValue};\n  }\n}\n\nfunction getContextState(gl: WebGLRenderingContext): GLState {\n  // @ts-expect-error\n  return gl.state as GLState;\n}\n\n// PUBLIC API\n\n/**\n * Initialize WebGL state caching on a context\n * can be called multiple times to enable/disable\n *\n * @note After calling this function, context state will be cached\n * gl.state.push() and gl.state.pop() will be available for saving,\n * temporarily modifying, and then restoring state.\n */\nexport function trackContextState(\n  gl: WebGLRenderingContext,\n  options?: {\n    enable?: boolean;\n    copyState?: boolean;\n    log?: any;\n  }\n): WebGLRenderingContext {\n  const {enable = true, copyState} = options;\n  assert(copyState !== undefined);\n  // @ts-expect-error\n  if (!gl.state) {\n    // @ts-ignore\n    // const {polyfillContext} = global_;\n    // if (polyfillContext) {\n    //   polyfillContext(gl);\n    // }\n\n    // Create a state cache\n    // @ts-expect-error\n    gl.state = new GLState(gl, {copyState});\n\n    installProgramSpy(gl);\n\n    // intercept all setter functions in the table\n    for (const key in GL_HOOKED_SETTERS) {\n      const setter = GL_HOOKED_SETTERS[key];\n      installSetterSpy(gl, key, setter);\n    }\n\n    // intercept all getter functions in the table\n    installGetterOverride(gl, 'getParameter');\n    installGetterOverride(gl, 'isEnabled');\n  }\n\n  const glState = getContextState(gl);\n  glState.enable = enable;\n\n  return gl;\n}\n\n/**\n * Saves current WebGL context state onto an internal per-context stack\n */\nexport function pushContextState(gl: WebGLRenderingContext): void {\n  let glState = getContextState(gl);\n  if (!glState) {\n    trackContextState(gl, {copyState: false});\n    glState = getContextState(gl);\n  }\n  glState.push();\n}\n\n\n/**\n * Restores previously saved WebGL context state\n */\nexport function popContextState(gl: WebGLRenderingContext): void {\n  const glState = getContextState(gl);\n  assert(glState);\n  glState.pop();\n}\n\n// HELPER FUNCTIONS - INSTALL GET/SET INTERCEPTORS (SPYS) ON THE CONTEXT\n\n/**\n// Overrides a WebGLRenderingContext state \"getter\" function\n// to return values directly from cache\n * @param gl\n * @param functionName\n */\nfunction installGetterOverride(gl: WebGLRenderingContext, functionName: string) {\n  // Get the original function from the WebGLRenderingContext\n  const originalGetterFunc = gl[functionName].bind(gl);\n\n  // Wrap it with a spy so that we can update our state cache when it gets called\n  gl[functionName] = function get(pname) {\n    if (pname === undefined || NON_CACHE_PARAMETERS.has(pname)) {\n      // Invalid or blacklisted parameter, do not cache\n      return originalGetterFunc(pname);\n    }\n\n    const glState = getContextState(gl);\n    if (!(pname in glState.cache)) {\n      // WebGL limits are not prepopulated in the cache, call the original getter when first queried.\n      glState.cache[pname] = originalGetterFunc(pname);\n    }\n\n    // Optionally call the original function to do a \"hard\" query from the WebGLRenderingContext\n    return glState.enable\n      ? // Call the getter the params so that it can e.g. serve from a cache\n      glState.cache[pname]\n      : // Optionally call the original function to do a \"hard\" query from the WebGLRenderingContext\n      originalGetterFunc(pname);\n  };\n\n  // Set the name of this anonymous function to help in debugging and profiling\n  Object.defineProperty(gl[functionName], 'name', {\n    value: `${functionName}-from-cache`,\n    configurable: false\n  });\n}\n\n/**\n// Overrides a WebGLRenderingContext state \"setter\" function\n// to call a setter spy before the actual setter. Allows us to keep a cache\n// updated with a copy of the WebGL context state.\n * @param gl\n * @param functionName\n * @param setter\n * @returns\n */\nfunction installSetterSpy(gl: WebGLRenderingContext, functionName: string, setter: Function) {\n  // Get the original function from the WebGLRenderingContext\n  if (!gl[functionName]) {\n    // This could happen if we try to intercept WebGL2 method on a WebGL1 context\n    return;\n  }\n\n  const originalSetterFunc = gl[functionName].bind(gl);\n\n  // Wrap it with a spy so that we can update our state cache when it gets called\n  gl[functionName] = function set(...params) {\n    // Update the value\n    // Call the setter with the state cache and the params so that it can store the parameters\n    const glState = getContextState(gl);\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    const {valueChanged, oldValue} = setter(glState._updateCache, ...params);\n\n    // Call the original WebGLRenderingContext func to make sure the context actually gets updated\n    if (valueChanged) {\n      originalSetterFunc(...params);\n    }\n\n    // Note: if the original function fails to set the value, our state cache will be bad\n    // No solution for this at the moment, but assuming that this is unlikely to be a real problem\n    // We could call the setter after the originalSetterFunc. Concern is that this would\n    // cause different behavior in debug mode, where originalSetterFunc can throw exceptions\n\n    return oldValue;\n  };\n\n  // Set the name of this anonymous function to help in debugging and profiling\n  Object.defineProperty(gl[functionName], 'name', {\n    value: `${functionName}-to-cache`,\n    configurable: false\n  });\n}\n\nfunction installProgramSpy(gl: WebGLRenderingContext): void {\n  const originalUseProgram = gl.useProgram.bind(gl);\n\n  gl.useProgram = function useProgramLuma(handle) {\n    const glState = getContextState(gl);\n    if (glState.program !== handle) {\n      originalUseProgram(handle);\n      glState.program = handle;\n    }\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"track-context-state.js","names":["assert","GL_PARAMETER_DEFAULTS","GL_HOOKED_SETTERS","NON_CACHE_PARAMETERS","setGLParameters","getGLParameters","deepArrayEqual","GLState","constructor","gl","copyState","log","arguments","length","undefined","program","stateStack","enable","cache","Object","assign","_updateCache","bind","seal","push","values","pop","oldValues","valueChanged","oldValue","key","value","cached","getContextState","state","trackContextState","options","installProgramSpy","setter","installSetterSpy","installGetterOverride","glState","pushContextState","popContextState","functionName","originalGetterFunc","get","pname","has","defineProperty","configurable","originalSetterFunc","set","_len","params","Array","_key","originalUseProgram","useProgram","useProgramLuma","handle"],"sources":["../../../src/context/state-tracker/track-context-state.ts"],"sourcesContent":["// Support for listening to context state changes and intercepting state queries\n// NOTE: this system does not handle buffer bindings\nimport {assert} from '@luma.gl/core';\nimport {GL_PARAMETER_DEFAULTS, GL_HOOKED_SETTERS, NON_CACHE_PARAMETERS} from '../parameters/webgl-parameter-tables';\nimport {setGLParameters, getGLParameters} from '../parameters/unified-parameter-api';\nimport {deepArrayEqual} from './deep-array-equal';\n\n// HELPER CLASS - GLState\n\n/* eslint-disable no-shadow */\nclass GLState {\n  gl: WebGLRenderingContext;\n  program: unknown = null;\n  stateStack: object[] = [];\n  enable = true;\n  cache: Record<string, any>;\n  log;\n\n  constructor(\n    gl: WebGLRenderingContext,\n    {\n      copyState = false, // Copy cache from params (slow) or initialize from WebGL defaults (fast)\n      log = () => {} // Logging function, called when gl parameter change calls are actually issued\n    } = {}\n  ) {\n    this.gl = gl;\n    this.cache = copyState ? getGLParameters(gl) : Object.assign({}, GL_PARAMETER_DEFAULTS);\n    this.log = log;\n\n    this._updateCache = this._updateCache.bind(this);\n    Object.seal(this);\n  }\n\n  push(values = {}) {\n    this.stateStack.push({});\n  }\n\n  pop() {\n    assert(this.stateStack.length > 0);\n    // Use the saved values in the state stack to restore parameters\n    const oldValues = this.stateStack[this.stateStack.length - 1];\n    setGLParameters(this.gl, oldValues);\n    // Don't pop until we have reset parameters (to make sure other \"stack frames\" are not affected)\n    this.stateStack.pop();\n  }\n\n  /**\n  // interceptor for context set functions - update our cache and our stack\n  // values (Object) - the key values for this setter\n   * @param values\n   * @returns\n   */\n  _updateCache(values: {[key: number | string]: any}) {\n    let valueChanged = false;\n    let oldValue; // = undefined\n\n    const oldValues: {[key: number | string]: any} | null = this.stateStack.length > 0 ? this.stateStack[this.stateStack.length - 1] : null;\n\n    for (const key in values) {\n      assert(key !== undefined);\n      const value = values[key];\n      const cached = this.cache[key];\n      // Check that value hasn't already been shadowed\n      if (!deepArrayEqual(value, cached)) {\n        valueChanged = true;\n        oldValue = cached;\n\n        // First, save current value being shadowed\n        // If a state stack frame is active, save the current parameter values for pop\n        // but first check that value hasn't already been shadowed and saved\n        if (oldValues && !(key in oldValues)) {\n          oldValues[key] = cached;\n        }\n\n        // Save current value being shadowed\n        this.cache[key] = value;\n      }\n    }\n\n    return {valueChanged, oldValue};\n  }\n}\n\nfunction getContextState(gl: WebGLRenderingContext): GLState {\n  // @ts-expect-error\n  return gl.state as GLState;\n}\n\n// PUBLIC API\n\n/**\n * Initialize WebGL state caching on a context\n * can be called multiple times to enable/disable\n *\n * @note After calling this function, context state will be cached\n * gl.state.push() and gl.state.pop() will be available for saving,\n * temporarily modifying, and then restoring state.\n */\nexport function trackContextState(\n  gl: WebGLRenderingContext,\n  options?: {\n    enable?: boolean;\n    copyState?: boolean;\n    log?: any;\n  }\n): WebGLRenderingContext {\n  const {enable = true, copyState} = options;\n  assert(copyState !== undefined);\n  // @ts-expect-error\n  if (!gl.state) {\n    // @ts-ignore\n    // const {polyfillContext} = global_;\n    // if (polyfillContext) {\n    //   polyfillContext(gl);\n    // }\n\n    // Create a state cache\n    // @ts-expect-error\n    gl.state = new GLState(gl, {copyState});\n\n    installProgramSpy(gl);\n\n    // intercept all setter functions in the table\n    for (const key in GL_HOOKED_SETTERS) {\n      const setter = GL_HOOKED_SETTERS[key];\n      installSetterSpy(gl, key, setter);\n    }\n\n    // intercept all getter functions in the table\n    installGetterOverride(gl, 'getParameter');\n    installGetterOverride(gl, 'isEnabled');\n  }\n\n  const glState = getContextState(gl);\n  glState.enable = enable;\n\n  return gl;\n}\n\n/**\n * Saves current WebGL context state onto an internal per-context stack\n */\nexport function pushContextState(gl: WebGLRenderingContext): void {\n  let glState = getContextState(gl);\n  if (!glState) {\n    trackContextState(gl, {copyState: false});\n    glState = getContextState(gl);\n  }\n  glState.push();\n}\n\n\n/**\n * Restores previously saved WebGL context state\n */\nexport function popContextState(gl: WebGLRenderingContext): void {\n  const glState = getContextState(gl);\n  assert(glState);\n  glState.pop();\n}\n\n// HELPER FUNCTIONS - INSTALL GET/SET INTERCEPTORS (SPYS) ON THE CONTEXT\n\n/**\n// Overrides a WebGLRenderingContext state \"getter\" function\n// to return values directly from cache\n * @param gl\n * @param functionName\n */\nfunction installGetterOverride(gl: WebGLRenderingContext, functionName: string) {\n  // Get the original function from the WebGLRenderingContext\n  const originalGetterFunc = gl[functionName].bind(gl);\n\n  // Wrap it with a spy so that we can update our state cache when it gets called\n  gl[functionName] = function get(pname) {\n    if (pname === undefined || NON_CACHE_PARAMETERS.has(pname)) {\n      // Invalid or blacklisted parameter, do not cache\n      return originalGetterFunc(pname);\n    }\n\n    const glState = getContextState(gl);\n    if (!(pname in glState.cache)) {\n      // WebGL limits are not prepopulated in the cache, call the original getter when first queried.\n      glState.cache[pname] = originalGetterFunc(pname);\n    }\n\n    // Optionally call the original function to do a \"hard\" query from the WebGLRenderingContext\n    return glState.enable\n      ? // Call the getter the params so that it can e.g. serve from a cache\n      glState.cache[pname]\n      : // Optionally call the original function to do a \"hard\" query from the WebGLRenderingContext\n      originalGetterFunc(pname);\n  };\n\n  // Set the name of this anonymous function to help in debugging and profiling\n  Object.defineProperty(gl[functionName], 'name', {\n    value: `${functionName}-from-cache`,\n    configurable: false\n  });\n}\n\n/**\n// Overrides a WebGLRenderingContext state \"setter\" function\n// to call a setter spy before the actual setter. Allows us to keep a cache\n// updated with a copy of the WebGL context state.\n * @param gl\n * @param functionName\n * @param setter\n * @returns\n */\nfunction installSetterSpy(gl: WebGLRenderingContext, functionName: string, setter: Function) {\n  // Get the original function from the WebGLRenderingContext\n  if (!gl[functionName]) {\n    // This could happen if we try to intercept WebGL2 method on a WebGL1 context\n    return;\n  }\n\n  const originalSetterFunc = gl[functionName].bind(gl);\n\n  // Wrap it with a spy so that we can update our state cache when it gets called\n  gl[functionName] = function set(...params) {\n    // Update the value\n    // Call the setter with the state cache and the params so that it can store the parameters\n    const glState = getContextState(gl);\n    // eslint-disable-next-line @typescript-eslint/unbound-method\n    const {valueChanged, oldValue} = setter(glState._updateCache, ...params);\n\n    // Call the original WebGLRenderingContext func to make sure the context actually gets updated\n    if (valueChanged) {\n      originalSetterFunc(...params);\n    }\n\n    // Note: if the original function fails to set the value, our state cache will be bad\n    // No solution for this at the moment, but assuming that this is unlikely to be a real problem\n    // We could call the setter after the originalSetterFunc. Concern is that this would\n    // cause different behavior in debug mode, where originalSetterFunc can throw exceptions\n\n    return oldValue;\n  };\n\n  // Set the name of this anonymous function to help in debugging and profiling\n  Object.defineProperty(gl[functionName], 'name', {\n    value: `${functionName}-to-cache`,\n    configurable: false\n  });\n}\n\nfunction installProgramSpy(gl: WebGLRenderingContext): void {\n  const originalUseProgram = gl.useProgram.bind(gl);\n\n  gl.useProgram = function useProgramLuma(handle) {\n    const glState = getContextState(gl);\n    if (glState.program !== handle) {\n      originalUseProgram(handle);\n      glState.program = handle;\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/context/state-tracker/with-parameters.d.ts

@@ -8,7 +8,7 @@ import { GLParameters } from '../parameters/unified-parameter-api';
  * - Restores parameters
  * - Returns the return value of the supplied function
  */
-export declare function withParameters(device: Device | WebGLRenderingContext, parameters: GLParameters & {
+export declare function withGLParameters(device: Device | WebGLRenderingContext, parameters: GLParameters & {
     nocatch?: boolean;
 }, func: any): any;
 //# sourceMappingURL=with-parameters.d.ts.map

package/dist/context/state-tracker/with-parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-parameters.d.ts","sourceRoot":"","sources":["../../../src/context/state-tracker/with-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAC,YAAY,EAAgB,MAAM,qCAAqC,CAAC;AAGhF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,UAAU,EAAE,YAAY,GAAG;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,CA+BrI"}
+{"version":3,"file":"with-parameters.d.ts","sourceRoot":"","sources":["../../../src/context/state-tracker/with-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAC,YAAY,EAAkB,MAAM,qCAAqC,CAAC;AAGlF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,UAAU,EAAE,YAAY,GAAG;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,CA+BvI"}

package/dist/context/state-tracker/with-parameters.js

@@ -1,7 +1,7 @@
 import { WebGLDevice } from "../../adapter/webgl-device.js";
-import { setParameters } from "../parameters/unified-parameter-api.js";
+import { setGLParameters } from "../parameters/unified-parameter-api.js";
 import { pushContextState, popContextState } from "./track-context-state.js";
-export function withParameters(device, parameters, func) {
+export function withGLParameters(device, parameters, func) {
   const webglDevice = WebGLDevice.attach(device);
   const gl = webglDevice.gl;
   if (isObjectEmpty(parameters)) {
@@ -11,7 +11,7 @@ export function withParameters(device, parameters, func) {
     nocatch = true
   } = parameters;
   pushContextState(gl);
-  setParameters(gl, parameters);
+  setGLParameters(gl, parameters);
   let value;
   if (nocatch) {
     value = func(gl);

package/dist/context/state-tracker/with-parameters.js.map

@@ -1 +1 @@
-{"version":3,"file":"with-parameters.js","names":["WebGLDevice","setParameters","pushContextState","popContextState","withParameters","device","parameters","func","webglDevice","attach","gl","isObjectEmpty","nocatch","value","object","key"],"sources":["../../../src/context/state-tracker/with-parameters.ts"],"sourcesContent":["import type {Device} from '@luma.gl/core';\nimport {WebGLDevice} from '../../adapter/webgl-device';\nimport {GLParameters, setParameters} from '../parameters/unified-parameter-api';\nimport {pushContextState, popContextState} from './track-context-state';\n\n/**\n * Execute a function with a set of temporary WebGL parameter overrides\n * - Saves current \"global\" WebGL context settings\n * - Sets the supplies WebGL context parameters,\n * - Executes supplied function\n * - Restores parameters\n * - Returns the return value of the supplied function\n */\nexport function withParameters(device: Device | WebGLRenderingContext, parameters: GLParameters & {nocatch?: boolean}, func: any): any {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  if (isObjectEmpty(parameters)) {\n    // Avoid setting state if no parameters provided. Just call and return\n    return func(device);\n  }\n\n  const {nocatch = true} = parameters;\n\n  pushContextState(gl);\n  setParameters(gl, parameters);\n\n  // Setup is done, call the function\n  let value;\n\n  if (nocatch) {\n    // Avoid try catch to minimize stack size impact for safe execution paths\n    value = func(gl);\n    popContextState(gl);\n  } else {\n    // Wrap in a try-catch to ensure that parameters are restored on exceptions\n    try {\n      value = func(gl);\n    } finally {\n      popContextState(gl);\n    }\n  }\n\n  return value;\n}\n\n// Helpers\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(object) {\n  // @ts-ignore - dummy key variable\n  for (const key in object) {\n    return false;\n  }\n  return true;\n}\n"],"mappings":"SACQA,WAAW;AAAA,SACGC,aAAa;AAAA,SAC3BC,gBAAgB,EAAEC,eAAe;AAUzC,OAAO,SAASC,cAAcA,CAACC,MAAsC,EAAEC,UAA8C,EAAEC,IAAS,EAAO;EACrI,MAAMC,WAAW,GAAGR,WAAW,CAACS,MAAM,CAACJ,MAAM,CAAC;EAC9C,MAAMK,EAAE,GAAGF,WAAW,CAACE,EAAE;EAEzB,IAAIC,aAAa,CAACL,UAAU,CAAC,EAAE;IAE7B,OAAOC,IAAI,CAACF,MAAM,CAAC;EACrB;EAEA,MAAM;IAACO,OAAO,GAAG;EAAI,CAAC,GAAGN,UAAU;EAEnCJ,gBAAgB,CAACQ,EAAE,CAAC;EACpBT,aAAa,CAACS,EAAE,EAAEJ,UAAU,CAAC;EAG7B,IAAIO,KAAK;EAET,IAAID,OAAO,EAAE;IAEXC,KAAK,GAAGN,IAAI,CAACG,EAAE,CAAC;IAChBP,eAAe,CAACO,EAAE,CAAC;EACrB,CAAC,MAAM;IAEL,IAAI;MACFG,KAAK,GAAGN,IAAI,CAACG,EAAE,CAAC;IAClB,CAAC,SAAS;MACRP,eAAe,CAACO,EAAE,CAAC;IACrB;EACF;EAEA,OAAOG,KAAK;AACd;AAKA,SAASF,aAAaA,CAACG,MAAM,EAAE;EAE7B,KAAK,MAAMC,GAAG,IAAID,MAAM,EAAE;IACxB,OAAO,KAAK;EACd;EACA,OAAO,IAAI;AACb"}
+{"version":3,"file":"with-parameters.js","names":["WebGLDevice","setGLParameters","pushContextState","popContextState","withGLParameters","device","parameters","func","webglDevice","attach","gl","isObjectEmpty","nocatch","value","object","key"],"sources":["../../../src/context/state-tracker/with-parameters.ts"],"sourcesContent":["import type {Device} from '@luma.gl/core';\nimport {WebGLDevice} from '../../adapter/webgl-device';\nimport {GLParameters, setGLParameters} from '../parameters/unified-parameter-api';\nimport {pushContextState, popContextState} from './track-context-state';\n\n/**\n * Execute a function with a set of temporary WebGL parameter overrides\n * - Saves current \"global\" WebGL context settings\n * - Sets the supplies WebGL context parameters,\n * - Executes supplied function\n * - Restores parameters\n * - Returns the return value of the supplied function\n */\nexport function withGLParameters(device: Device | WebGLRenderingContext, parameters: GLParameters & {nocatch?: boolean}, func: any): any {\n  const webglDevice = WebGLDevice.attach(device);\n  const gl = webglDevice.gl;\n\n  if (isObjectEmpty(parameters)) {\n    // Avoid setting state if no parameters provided. Just call and return\n    return func(device);\n  }\n\n  const {nocatch = true} = parameters;\n\n  pushContextState(gl);\n  setGLParameters(gl, parameters);\n\n  // Setup is done, call the function\n  let value;\n\n  if (nocatch) {\n    // Avoid try catch to minimize stack size impact for safe execution paths\n    value = func(gl);\n    popContextState(gl);\n  } else {\n    // Wrap in a try-catch to ensure that parameters are restored on exceptions\n    try {\n      value = func(gl);\n    } finally {\n      popContextState(gl);\n    }\n  }\n\n  return value;\n}\n\n// Helpers\n\n// Returns true if given object is empty, false otherwise.\nfunction isObjectEmpty(object) {\n  // @ts-ignore - dummy key variable\n  for (const key in object) {\n    return false;\n  }\n  return true;\n}\n"],"mappings":"SACQA,WAAW;AAAA,SACGC,eAAe;AAAA,SAC7BC,gBAAgB,EAAEC,eAAe;AAUzC,OAAO,SAASC,gBAAgBA,CAACC,MAAsC,EAAEC,UAA8C,EAAEC,IAAS,EAAO;EACvI,MAAMC,WAAW,GAAGR,WAAW,CAACS,MAAM,CAACJ,MAAM,CAAC;EAC9C,MAAMK,EAAE,GAAGF,WAAW,CAACE,EAAE;EAEzB,IAAIC,aAAa,CAACL,UAAU,CAAC,EAAE;IAE7B,OAAOC,IAAI,CAACF,MAAM,CAAC;EACrB;EAEA,MAAM;IAACO,OAAO,GAAG;EAAI,CAAC,GAAGN,UAAU;EAEnCJ,gBAAgB,CAACQ,EAAE,CAAC;EACpBT,eAAe,CAACS,EAAE,EAAEJ,UAAU,CAAC;EAG/B,IAAIO,KAAK;EAET,IAAID,OAAO,EAAE;IAEXC,KAAK,GAAGN,IAAI,CAACG,EAAE,CAAC;IAChBP,eAAe,CAACO,EAAE,CAAC;EACrB,CAAC,MAAM;IAEL,IAAI;MACFG,KAAK,GAAGN,IAAI,CAACG,EAAE,CAAC;IAClB,CAAC,SAAS;MACRP,eAAe,CAACO,EAAE,CAAC;IACrB;EACF;EAEA,OAAOG,KAAK;AACd;AAKA,SAASF,aAAaA,CAACG,MAAM,EAAE;EAE7B,KAAK,MAAMC,GAAG,IAAID,MAAM,EAAE;IACxB,OAAO,KAAK;EACd;EACA,OAAO,IAAI;AACb"}