@gjsify/webgl 0.3.12 → 0.3.14

package/lib/esm/webgl2-rendering-context.js

@@ -1,1281 +1,1218 @@
-import Gwebgl from "@girs/gwebgl-0.1";
-import GdkPixbuf from "gi://GdkPixbuf?version=2.0";
+import { Uint8ArrayToVariant, arrayToUint8Array, checkObject, convertPixels, extractImageData, premultiplyAlpha, vertexCount } from "./utils.js";
+import { WebGLActiveInfo } from "./webgl-active-info.js";
+import { WebGLFramebuffer } from "./webgl-framebuffer.js";
+import { WebGLRenderbuffer } from "./webgl-renderbuffer.js";
+import { WebGLTexture } from "./webgl-texture.js";
 import { WebGLContextBase } from "./webgl-context-base.js";
 import { WebGLQuery } from "./webgl-query.js";
 import { WebGLSampler } from "./webgl-sampler.js";
 import { WebGLSync } from "./webgl-sync.js";
 import { WebGLTransformFeedback } from "./webgl-transform-feedback.js";
 import { WebGLVertexArrayObject } from "./webgl-vertex-array-object.js";
-import { WebGLActiveInfo } from "./webgl-active-info.js";
-import { WebGLTexture } from "./webgl-texture.js";
-import { WebGLRenderbuffer } from "./webgl-renderbuffer.js";
-import { WebGLFramebuffer } from "./webgl-framebuffer.js";
-import { Uint8ArrayToVariant, arrayToUint8Array, vertexCount, convertPixels, extractImageData, checkObject, premultiplyAlpha } from "./utils.js";
+import Gwebgl from "@girs/gwebgl-0.1";
+import GdkPixbuf from "gi://GdkPixbuf?version=2.0";
 import { warnNotImplemented } from "@gjsify/utils";
-class WebGL2RenderingContext extends WebGLContextBase {
-  constructor(canvas, options = {}) {
-    super(canvas, options);
-    this._queries = {};
-    this._samplers = {};
-    this._transformFeedbacks = {};
-    this._vertexArrayObjects = {};
-    this._syncs = {};
-    this._activeReadFramebuffer = null;
-    this._activeDrawFramebuffer = null;
-    this._native2 = new Gwebgl.WebGL2RenderingContext({});
-    this._init();
-  }
-  get _gl() {
-    return this._native2;
-  }
-  _getGlslVersion(es) {
-    return es ? "300 es" : "130";
-  }
-  // ─── WebGL2 overrides for WebGL1 validation that's too strict ─────────
-  /**
-   * WebGL2 delegates framebuffer completeness to the native GL driver.
-   * Called by _framebufferOk() before draw calls and by _updateFramebufferAttachments.
-   * The base class version uses JS-side format whitelists that reject valid WebGL2 formats.
-   */
-  /** WebGL2 allows COLOR_ATTACHMENT1–15 as framebuffer attachment points. */
-  _validFramebufferAttachment(attachment) {
-    if (super._validFramebufferAttachment(attachment)) return true;
-    return attachment >= 36065 && attachment <= 36079;
-  }
-  static {
-    // ─── MRT: native COLOR_ATTACHMENT0–15 support ────────────────────────
-    this._WGL2_ALL_COLOR_ATTACHMENTS = [
-      36064,
-      36065,
-      36066,
-      36067,
-      36068,
-      36069,
-      36070,
-      36071,
-      36072,
-      36073,
-      36074,
-      36075,
-      36076,
-      36077,
-      36078,
-      36079
-    ];
-  }
-  _getColorAttachments() {
-    return WebGL2RenderingContext._WGL2_ALL_COLOR_ATTACHMENTS;
-  }
-  /**
-   * WebGL2 extends the base-class framebuffer completeness pre-check to
-   * accept WebGL2-specific formats that the WebGL1 whitelist rejects.
-   *
-   * NOTE: This is called by _updateFramebufferAttachments BEFORE the native
-   * GL attachments are set, so we must NOT query glCheckFramebufferStatus
-   * here (it would see an empty FBO and always return INCOMPLETE).
-   * Instead we extend the JS-side format whitelist to cover WebGL2 formats.
-   */
-  _preCheckFramebufferStatus(framebuffer) {
-    const attachments = framebuffer._attachments;
-    let bestWidth = 0;
-    let bestHeight = 0;
-    const allEnums = [
-      this.COLOR_ATTACHMENT0,
-      this.DEPTH_ATTACHMENT,
-      this.STENCIL_ATTACHMENT,
-      this.DEPTH_STENCIL_ATTACHMENT,
-      ...WebGL2RenderingContext._WGL2_ALL_COLOR_ATTACHMENTS
-    ];
-    for (const enumVal of allEnums) {
-      const attach = attachments[enumVal];
-      if (!attach) continue;
-      if (attach instanceof WebGLTexture) {
-        const level = framebuffer._attachmentLevel[enumVal] ?? 0;
-        const w = attach._levelWidth[level] ?? 0;
-        const h = attach._levelHeight[level] ?? 0;
-        if (w > 0 && h > 0) {
-          bestWidth = w;
-          bestHeight = h;
-          break;
-        }
-      } else if (attach instanceof WebGLRenderbuffer) {
-        if (attach._width > 0 && attach._height > 0) {
-          bestWidth = attach._width;
-          bestHeight = attach._height;
-          break;
-        }
-      }
-    }
-    if (bestWidth > 0 && bestHeight > 0) {
-      framebuffer._width = bestWidth;
-      framebuffer._height = bestHeight;
-      return this.FRAMEBUFFER_COMPLETE;
-    }
-    return this.FRAMEBUFFER_INCOMPLETE_ATTACHMENT;
-  }
-  /**
-   * WebGL2 completely replaces the base class framebuffer attachment flow.
-   *
-   * The base class flow is: (1) pre-check formats in JS → (2) set native
-   * attachments only if pre-check passes. This is wrong for WebGL2 because
-   * the JS pre-check uses WebGL1 format whitelists that reject valid WebGL2
-   * formats.
-   *
-   * WebGL2 flow: (1) always set native attachments first → (2) query native
-   * glCheckFramebufferStatus to determine completeness. This delegates all
-   * format validation to the native GL driver, matching browser behavior.
-   *
-   * Also handles COLOR_ATTACHMENT1–15 (WebGL2 MRT) that the base class
-   * doesn't know about.
-   */
-  /**
-   * Apply COLOR_ATTACHMENT1–15 to the native GL FBO (WebGL2 MRT).
-   * The base class handles CA0, DEPTH, STENCIL, DEPTH_STENCIL and calls
-   * _preCheckFramebufferStatus (which we override to query native GL).
-   */
-  _updateFramebufferAttachments(framebuffer) {
-    super._updateFramebufferAttachments(framebuffer);
-    if (!framebuffer) return;
-    for (let i = 1; i <= 15; i++) {
-      const attachmentEnum = 36064 + i;
-      if (!(attachmentEnum in framebuffer._attachments)) continue;
-      const attachment = framebuffer._attachments[attachmentEnum];
-      if (attachment instanceof WebGLTexture) {
-        const face = framebuffer._attachmentFace[attachmentEnum] || this.TEXTURE_2D;
-        const level = framebuffer._attachmentLevel[attachmentEnum] ?? 0;
-        this._gl.framebufferTexture2D(this.FRAMEBUFFER, attachmentEnum, face, attachment._ | 0, level | 0);
-      } else if (attachment instanceof WebGLRenderbuffer) {
-        this._gl.framebufferRenderbuffer(this.FRAMEBUFFER, attachmentEnum, this.RENDERBUFFER, attachment._ | 0);
-      } else {
-        this._gl.framebufferTexture2D(this.FRAMEBUFFER, attachmentEnum, this.TEXTURE_2D, 0, 0);
-      }
-    }
-  }
-  /** WebGL2 adds UNIFORM_BUFFER, TRANSFORM_FEEDBACK_BUFFER, etc. targets. */
-  bindBuffer(target, buffer) {
-    const isWebGL2Target = target === 35345 || target === 35982 || target === 36662 || target === 36663;
-    if (isWebGL2Target) {
-      const id = buffer ? buffer._ | 0 : 0;
-      this._gl.bindBuffer(target, id);
-      return;
-    }
-    super.bindBuffer(target, buffer);
-  }
-  /**
-   * WebGL2 adds READ_FRAMEBUFFER (0x8CA8) and DRAW_FRAMEBUFFER (0x8CA9) targets.
-   * The base class only accepts FRAMEBUFFER; this override handles the two new targets
-   * and keeps _activeReadFramebuffer / _activeDrawFramebuffer in sync.
-   */
-  bindFramebuffer(target, framebuffer) {
-    if (target === 36008 || target === 36009) {
-      if (!checkObject(framebuffer)) {
-        throw new TypeError("bindFramebuffer(GLenum, WebGLFramebuffer)");
-      }
-      if (framebuffer && framebuffer._pendingDelete) return;
-      if (framebuffer && !this._checkWrapper(framebuffer, WebGLFramebuffer)) return;
-      const id = framebuffer ? framebuffer._ | 0 : this._gtkFboId;
-      this._gl.bindFramebuffer(target, id);
-      if (target === 36008) {
-        const prev = this._activeReadFramebuffer;
-        if (prev !== framebuffer) {
-          if (prev) {
-            prev._refCount -= 1;
-            prev._checkDelete();
-          }
-          if (framebuffer) framebuffer._refCount += 1;
-        }
-        this._activeReadFramebuffer = framebuffer;
-      } else {
-        const prev = this._activeDrawFramebuffer;
-        if (prev !== framebuffer) {
-          if (prev) {
-            prev._refCount -= 1;
-            prev._checkDelete();
-          }
-          if (framebuffer) framebuffer._refCount += 1;
-        }
-        this._activeDrawFramebuffer = framebuffer;
-        this._activeFramebuffer = framebuffer;
-      }
-      return;
-    }
-    super.bindFramebuffer(this.FRAMEBUFFER, framebuffer);
-    this._activeReadFramebuffer = framebuffer;
-    this._activeDrawFramebuffer = framebuffer;
-  }
-  /** WebGL2 also unbinds from read/draw framebuffer slots when deleting. */
-  deleteFramebuffer(framebuffer) {
-    if (this._activeReadFramebuffer === framebuffer) {
-      this.bindFramebuffer(36008, null);
-    }
-    if (this._activeDrawFramebuffer === framebuffer) {
-      this.bindFramebuffer(36009, null);
-    }
-    super.deleteFramebuffer(framebuffer);
-  }
-  /** WebGL2 adds READ/COPY buffer usages and additional buffer targets. */
-  bufferData(target, dataOrSize, usage) {
-    const isWebGL2Target = target === 35345 || target === 35982 || target === 36662 || target === 36663;
-    const isReadOrCopy = usage === 35041 || usage === 35043 || usage === 35045 || usage === 35042 || usage === 35044 || usage === 35046;
-    const remappedUsage = isReadOrCopy ? this.STATIC_DRAW : usage;
-    if (isWebGL2Target) {
-      if (typeof dataOrSize === "number") {
-        if (dataOrSize >= 0) this._gl.bufferDataSizeOnly(target, dataOrSize, remappedUsage);
-      } else if (dataOrSize !== null && typeof dataOrSize === "object") {
-        const u8Data = arrayToUint8Array(dataOrSize);
-        this._gl.bufferData(target, Uint8ArrayToVariant(u8Data), remappedUsage);
-      }
-      return;
-    }
-    super.bufferData(target, dataOrSize, remappedUsage);
-  }
-  /** WebGL2 adds UNIFORM_BUFFER, TRANSFORM_FEEDBACK_BUFFER, COPY_READ/WRITE targets. */
-  bufferSubData(target, offset, data) {
-    const isWebGL2Target = target === 35345 || target === 35982 || target === 36662 || target === 36663;
-    if (isWebGL2Target) {
-      if (offset < 0) {
-        this.setError(this.INVALID_VALUE);
-        return;
-      }
-      if (!data) {
-        this.setError(this.INVALID_VALUE);
-        return;
-      }
-      const u8Data = arrayToUint8Array(data);
-      this._gl.bufferSubData(target, offset, Uint8ArrayToVariant(u8Data));
-      return;
-    }
-    super.bufferSubData(target, offset, data);
-  }
-  /** WebGL2 adds TEXTURE_3D and TEXTURE_2D_ARRAY target support. */
-  bindTexture(target, texture) {
-    if (target === 32879 || target === 35866) {
-      const id = texture ? texture._ | 0 : 0;
-      this._gl.bindTexture(target, id);
-      if (texture) texture._binding = target;
-      return;
-    }
-    super.bindTexture(target, texture);
-  }
-  /** WebGL2 adds TEXTURE_3D/TEXTURE_2D_ARRAY targets and many new pnames. */
-  texParameteri(target, pname, param) {
-    if (target === 32879 || target === 35866) {
-      this._gl.texParameteri(target, pname, param);
-      return;
-    }
-    const isWebGL2Pname = pname === 32882 || pname === 34892 || pname === 34893 || pname === 33084 || pname === 33085 || pname === 33083 || pname === 33082;
-    if (isWebGL2Pname) {
-      this._gl.texParameteri(target, pname, param);
-      return;
-    }
-    super.texParameteri(target, pname, param);
-  }
-  /**
-   * In WebGL2/GLES3 the attribute-0 requirement from WebGL1 does not apply.
-   * Override drawArrays to skip the attrib0 hack and call glDrawArrays directly.
-   */
-  /**
-   * In WebGL2/GLES3 the attribute-0 requirement from WebGL1 does not apply.
-   * Override drawArrays to skip the attrib0 hack and call glDrawArrays directly.
-   */
-  drawArrays(mode, first, count) {
-    if (first < 0 || count < 0) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    if (!this._checkStencilState()) return;
-    const rc = vertexCount(this, mode, count);
-    if (rc < 0) {
-      this.setError(this.INVALID_ENUM);
-      return;
-    }
-    if (!this._framebufferOk()) return;
-    if (count === 0) return;
-    if (!this._checkVertexAttribState(count + first - 1 >>> 0)) return;
-    this._native2.drawArrays(mode, first, rc);
-  }
-  /**
-   * In WebGL2, UNSIGNED_INT element indices are a core feature — no extension needed.
-   * Override drawElements to skip the oes_element_index_uint extension check.
-   */
-  drawElements(mode = 0, count = 0, type = 0, offset = 0) {
-    if (count < 0 || offset < 0) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    if (!this._checkStencilState()) return;
-    const elementBuffer = this._vertexObjectState._elementArrayBufferBinding;
-    if (!elementBuffer) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    let elementData = null;
-    let adjustedOffset = offset;
-    if (type === this.UNSIGNED_SHORT) {
-      if (adjustedOffset % 2) {
-        this.setError(this.INVALID_OPERATION);
-        return;
-      }
-      adjustedOffset >>= 1;
-      elementData = new Uint16Array(elementBuffer._elements.buffer);
-    } else if (type === this.UNSIGNED_INT) {
-      if (adjustedOffset % 4) {
-        this.setError(this.INVALID_OPERATION);
-        return;
-      }
-      adjustedOffset >>= 2;
-      elementData = new Uint32Array(elementBuffer._elements.buffer);
-    } else if (type === this.UNSIGNED_BYTE) {
-      elementData = elementBuffer._elements;
-    } else {
-      this.setError(this.INVALID_ENUM);
-      return;
-    }
-    let reducedCount = count;
-    switch (mode) {
-      case this.TRIANGLES:
-        if (count % 3) reducedCount -= count % 3;
-        break;
-      case this.LINES:
-        if (count % 2) reducedCount -= count % 2;
-        break;
-      case this.POINTS:
-        break;
-      case this.LINE_LOOP:
-      case this.LINE_STRIP:
-        if (count < 2) {
-          this.setError(this.INVALID_OPERATION);
-          return;
-        }
-        break;
-      case this.TRIANGLE_FAN:
-      case this.TRIANGLE_STRIP:
-        if (count < 3) {
-          this.setError(this.INVALID_OPERATION);
-          return;
-        }
-        break;
-      default:
-        this.setError(this.INVALID_ENUM);
-        return;
-    }
-    if (!this._framebufferOk()) return;
-    if (count === 0) return;
-    let maxIndex = 0;
-    for (let i = adjustedOffset; i < adjustedOffset + reducedCount; ++i) {
-      if (i < elementData.length && elementData[i] > maxIndex) maxIndex = elementData[i];
-    }
-    if (this._checkVertexAttribState(maxIndex)) {
-      this._native2.drawElements(mode, reducedCount, type, offset);
-    }
-  }
-  // ─── Vertex Array Objects ─────────────────────────────────────────────
-  createVertexArray() {
-    const id = this._native2.createVertexArray();
-    if (!id) return null;
-    const vao = new WebGLVertexArrayObject(id, this);
-    this._vertexArrayObjects[id] = vao;
-    return vao;
-  }
-  deleteVertexArray(vertexArray) {
-    if (!vertexArray || !(vertexArray instanceof WebGLVertexArrayObject)) return;
-    vertexArray._pendingDelete = true;
-    vertexArray._checkDelete();
-  }
-  isVertexArray(vertexArray) {
-    if (!vertexArray || !(vertexArray instanceof WebGLVertexArrayObject)) return false;
-    return this._native2.isVertexArray(vertexArray._);
-  }
-  bindVertexArray(array) {
-    if (array === null) {
-      this._native2.bindVertexArray(0);
-      this._vertexObjectState = this._defaultVertexObjectState;
-    } else if (array instanceof WebGLVertexArrayObject) {
-      this._native2.bindVertexArray(array._);
-      this._vertexObjectState = array._objectState;
-    } else {
-      this.setError(this.INVALID_OPERATION);
-    }
-  }
-  // ─── Query Objects ────────────────────────────────────────────────────
-  createQuery() {
-    const id = this._native2.createQuery();
-    if (!id) return null;
-    const query = new WebGLQuery(id, this);
-    this._queries[id] = query;
-    return query;
-  }
-  deleteQuery(query) {
-    if (!query || !(query instanceof WebGLQuery)) return;
-    query._pendingDelete = true;
-    query._checkDelete();
-  }
-  isQuery(query) {
-    if (!query || !(query instanceof WebGLQuery)) return false;
-    return this._native2.isQuery(query._);
-  }
-  beginQuery(target, query) {
-    if (!(query instanceof WebGLQuery)) return;
-    this._native2.beginQuery(target, query._);
-  }
-  endQuery(target) {
-    this._native2.endQuery(target);
-  }
-  getQuery(_target, _pname) {
-    warnNotImplemented("WebGL2RenderingContext.getQuery");
-    return null;
-  }
-  getQueryParameter(query, pname) {
-    if (!(query instanceof WebGLQuery)) return null;
-    return this._native2.getQueryParameter(query._, pname);
-  }
-  // ─── Sampler Objects ──────────────────────────────────────────────────
-  createSampler() {
-    const id = this._native2.createSampler();
-    if (!id) return null;
-    const sampler = new WebGLSampler(id, this);
-    this._samplers[id] = sampler;
-    return sampler;
-  }
-  deleteSampler(sampler) {
-    if (!sampler || !(sampler instanceof WebGLSampler)) return;
-    sampler._pendingDelete = true;
-    sampler._checkDelete();
-  }
-  isSampler(sampler) {
-    if (!sampler || !(sampler instanceof WebGLSampler)) return false;
-    return this._native2.isSampler(sampler._);
-  }
-  bindSampler(unit, sampler) {
-    this._native2.bindSampler(unit, sampler ? sampler._ : 0);
-  }
-  samplerParameteri(sampler, pname, param) {
-    if (!(sampler instanceof WebGLSampler)) return;
-    this._native2.samplerParameteri(sampler._, pname, param);
-  }
-  samplerParameterf(sampler, pname, param) {
-    if (!(sampler instanceof WebGLSampler)) return;
-    this._native2.samplerParameterf(sampler._, pname, param);
-  }
-  getSamplerParameter(sampler, pname) {
-    if (!(sampler instanceof WebGLSampler)) return null;
-    if (pname === 33082 || pname === 33083) {
-      return this._native2.getSamplerParameterf(sampler._, pname);
-    }
-    return this._native2.getSamplerParameteri(sampler._, pname);
-  }
-  // ─── Sync Objects ─────────────────────────────────────────────────────
-  fenceSync(condition, flags) {
-    const id = this._native2.fenceSync(condition, flags);
-    if (!id) return null;
-    const sync = new WebGLSync(id, this);
-    this._syncs[id] = sync;
-    return sync;
-  }
-  isSync(sync) {
-    if (!sync || !(sync instanceof WebGLSync)) return false;
-    return this._native2.isSync(sync._);
-  }
-  deleteSync(sync) {
-    if (!sync || !(sync instanceof WebGLSync)) return;
-    sync._pendingDelete = true;
-    sync._checkDelete();
-  }
-  clientWaitSync(sync, flags, timeout) {
-    if (!(sync instanceof WebGLSync)) return 37148;
-    return this._native2.clientWaitSync(sync._, flags, timeout);
-  }
-  waitSync(sync, flags, timeout) {
-    if (!(sync instanceof WebGLSync)) return;
-    this._native2.waitSync(sync._, flags, timeout);
-  }
-  getSyncParameter(sync, pname) {
-    if (!(sync instanceof WebGLSync)) return null;
-    return this._native2.getSyncParameter(sync._, pname);
-  }
-  // ─── Transform Feedback ───────────────────────────────────────────────
-  createTransformFeedback() {
-    const id = this._native2.createTransformFeedback();
-    if (!id) return null;
-    const tf = new WebGLTransformFeedback(id, this);
-    this._transformFeedbacks[id] = tf;
-    return tf;
-  }
-  deleteTransformFeedback(tf) {
-    if (!tf || !(tf instanceof WebGLTransformFeedback)) return;
-    tf._pendingDelete = true;
-    tf._checkDelete();
-  }
-  isTransformFeedback(tf) {
-    if (!tf || !(tf instanceof WebGLTransformFeedback)) return false;
-    return this._native2.isTransformFeedback(tf._);
-  }
-  bindTransformFeedback(target, tf) {
-    this._native2.bindTransformFeedback(target, tf ? tf._ : 0);
-  }
-  beginTransformFeedback(primitiveMode) {
-    this._native2.beginTransformFeedback(primitiveMode);
-  }
-  endTransformFeedback() {
-    this._native2.endTransformFeedback();
-  }
-  pauseTransformFeedback() {
-    this._native2.pauseTransformFeedback();
-  }
-  resumeTransformFeedback() {
-    this._native2.resumeTransformFeedback();
-  }
-  transformFeedbackVaryings(program, varyings, bufferMode) {
-    this._native2.transformFeedbackVaryings(program._, varyings, bufferMode);
-  }
-  getTransformFeedbackVarying(program, index) {
-    const result = this._native2.getTransformFeedbackVarying(program._, index).deepUnpack();
-    return new WebGLActiveInfo({ size: result.size, type: result.type, name: result.name });
-  }
-  // ─── Indexed Buffer Binding ───────────────────────────────────────────
-  bindBufferBase(target, index, buffer) {
-    this._native2.bindBufferBase(target, index, buffer ? buffer._ : 0);
-  }
-  bindBufferRange(target, index, buffer, offset, size) {
-    this._native2.bindBufferRange(target, index, buffer ? buffer._ : 0, offset, size);
-  }
-  copyBufferSubData(readTarget, writeTarget, readOffset, writeOffset, size) {
-    this._native2.copyBufferSubData(readTarget, writeTarget, readOffset, writeOffset, size);
-  }
-  getBufferSubData(target, srcByteOffset, dstBuffer, dstOffset, length) {
-    const byteLength = length !== void 0 ? length : dstBuffer.byteLength - (dstOffset ?? 0);
-    const data = this._native2.getBufferSubData(target, srcByteOffset, byteLength);
-    const dst = new Uint8Array(dstBuffer.buffer, dstBuffer.byteOffset + (dstOffset ?? 0) * (dstBuffer instanceof Uint8Array ? 1 : dstBuffer.BYTES_PER_ELEMENT ?? 1));
-    dst.set(data.subarray(0, dst.byteLength));
-  }
-  // ─── 3D Textures ──────────────────────────────────────────────────────
-  texImage3D(target, level, internalformat, width, height, depth, border, format, type, pixels) {
-    if (pixels === null) {
-      this._native2.texImage3DNull(target, level, internalformat, width, height, depth, border, format, type);
-    } else {
-      this._native2.texImage3D(target, level, internalformat, width, height, depth, border, format, type, Uint8ArrayToVariant(new Uint8Array(pixels.buffer, pixels.byteOffset, pixels.byteLength)));
-    }
-  }
-  texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, pixels) {
-    if (pixels === null) return;
-    this._native2.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, Uint8ArrayToVariant(new Uint8Array(pixels.buffer, pixels.byteOffset, pixels.byteLength)));
-  }
-  compressedTexImage3D(target, level, internalformat, width, height, depth, border, _imageSize, data) {
-    this._native2.compressedTexImage3D(target, level, internalformat, width, height, depth, border, Uint8ArrayToVariant(new Uint8Array(data.buffer, data.byteOffset, data.byteLength)));
-  }
-  compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, _imageSize, data) {
-    this._native2.compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, Uint8ArrayToVariant(new Uint8Array(data.buffer, data.byteOffset, data.byteLength)));
-  }
-  copyTexSubImage3D(target, level, xoffset, yoffset, zoffset, x, y, width, height) {
-    this._native2.copyTexSubImage3D(target, level, xoffset, yoffset, zoffset, x, y, width, height);
-  }
-  texStorage2D(target, levels, internalformat, width, height) {
-    this._native2.texStorage2D(target, levels, internalformat, width, height);
-    const texture = this._getTexImage(target);
-    if (texture) {
-      for (let lvl = 0; lvl < levels; lvl++) {
-        texture._levelWidth[lvl] = Math.max(1, width >> lvl);
-        texture._levelHeight[lvl] = Math.max(1, height >> lvl);
-      }
-      texture._format = this.RGBA;
-      texture._type = this.UNSIGNED_BYTE;
-    }
-  }
-  texStorage3D(target, levels, internalformat, width, height, depth) {
-    this._native2.texStorage3D(target, levels, internalformat, width, height, depth);
-  }
-  texImage2D(target = 0, level = 0, internalFormat = 0, formatOrWidth = 0, typeOrHeight = 0, sourceOrBorder = 0, _format = 0, type = 0, pixels) {
-    let width = 0;
-    let height = 0;
-    let format = 0;
-    let border = 0;
-    if (arguments.length === 6) {
-      type = typeOrHeight;
-      format = formatOrWidth;
-      if (sourceOrBorder instanceof GdkPixbuf.Pixbuf) {
-        const pixbuf = sourceOrBorder;
-        width = pixbuf.get_width();
-        height = pixbuf.get_height();
-        pixels = pixbuf.get_pixels();
-      } else {
-        const imageData = extractImageData(sourceOrBorder);
-        if (imageData == null) {
-          throw new TypeError("texImage2D(GLenum, GLint, GLenum, GLint, GLenum, GLenum, ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement)");
-        }
-        width = imageData.width;
-        height = imageData.height;
-        pixels = imageData.data;
-      }
-    } else if (arguments.length >= 9) {
-      width = formatOrWidth;
-      height = typeOrHeight;
-      border = sourceOrBorder;
-      format = _format;
-    }
-    const texture = this._getTexImage(target);
-    if (!texture) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    let data = convertPixels(pixels);
-    if (this._unpackPremultAlpha && data && format === this.RGBA) {
-      data = premultiplyAlpha(data);
-    }
-    if (this._unpackFlipY && data && width > 0 && height > 0) {
-      const pixelSize = this._computePixelSize(type, format);
-      if (pixelSize > 0) {
-        const rowStride = this._computeRowStride(width, pixelSize);
-        const flipped = new Uint8Array(data.length);
-        for (let row = 0; row < height; row++) {
-          const srcOffset = row * rowStride;
-          const dstOffset = (height - 1 - row) * rowStride;
-          flipped.set(data.subarray(srcOffset, srcOffset + rowStride), dstOffset);
-        }
-        data = flipped;
-      }
-    }
-    this._saveError();
-    this._gl.texImage2D(target, level, internalFormat, width, height, border, format, type, Uint8ArrayToVariant(data));
-    const error = this.getError();
-    this._restoreError(error);
-    if (error !== this.NO_ERROR) return;
-    texture._levelWidth[level] = width;
-    texture._levelHeight[level] = height;
-    texture._format = format;
-    texture._type = type;
-    const activeFramebuffer = this._activeFramebuffer;
-    if (activeFramebuffer) {
-      let needsUpdate = false;
-      const attachments = this._getAttachments();
-      for (let i = 0; i < attachments.length; ++i) {
-        if (activeFramebuffer._attachments[attachments[i]] === texture) {
-          needsUpdate = true;
-          break;
-        }
-      }
-      if (needsUpdate && this._activeFramebuffer) {
-        this._updateFramebufferAttachments(this._activeFramebuffer);
-      }
-    }
-  }
-  texSubImage2D(target = 0, level = 0, xoffset = 0, yoffset = 0, formatOrWidth = 0, typeOrHeight = 0, sourceOrFormat = 0, type = 0, pixels) {
-    let width = 0;
-    let height = 0;
-    let format = 0;
-    if (arguments.length === 7) {
-      type = typeOrHeight;
-      format = formatOrWidth;
-      if (sourceOrFormat instanceof GdkPixbuf.Pixbuf) {
-        const pixbuf = sourceOrFormat;
-        width = pixbuf.get_width();
-        height = pixbuf.get_height();
-        pixels = pixbuf.get_pixels();
-      } else {
-        const imageData = extractImageData(sourceOrFormat);
-        if (imageData == null) {
-          throw new TypeError("texSubImage2D(GLenum, GLint, GLint, GLint, GLenum, GLenum, ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement)");
-        }
-        width = imageData.width;
-        height = imageData.height;
-        pixels = imageData.data;
-      }
-    } else {
-      width = formatOrWidth;
-      height = typeOrHeight;
-      format = sourceOrFormat;
-    }
-    const texture = this._getTexImage(target);
-    if (!texture) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    let data = convertPixels(pixels);
-    if (!data) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    if (this._unpackPremultAlpha && data && format === this.RGBA) {
-      data = premultiplyAlpha(data);
-    }
-    if (this._unpackFlipY && data && width > 0 && height > 0) {
-      const pixelSize = this._computePixelSize(type, format);
-      if (pixelSize > 0) {
-        const rowStride = this._computeRowStride(width, pixelSize);
-        const flipped = new Uint8Array(data.length);
-        for (let row = 0; row < height; row++) {
-          const srcOffset = row * rowStride;
-          const dstOffset = (height - 1 - row) * rowStride;
-          flipped.set(data.subarray(srcOffset, srcOffset + rowStride), dstOffset);
-        }
-        data = flipped;
-      }
-    }
-    this._gl.texSubImage2D(target, level, xoffset, yoffset, width, height, format, type, Uint8ArrayToVariant(data));
-  }
-  framebufferTextureLayer(target, attachment, texture, level, layer) {
-    this._native2.framebufferTextureLayer(target, attachment, texture ? texture._ : 0, level, layer);
-  }
-  // ─── Instancing & Advanced Draw ───────────────────────────────────────
-  drawArraysInstanced(mode, first, count, instanceCount) {
-    if (first < 0 || count < 0 || instanceCount < 0) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    if (!this._checkStencilState()) return;
-    const rc = vertexCount(this, mode, count);
-    if (rc < 0) {
-      this.setError(this.INVALID_ENUM);
-      return;
-    }
-    if (!this._framebufferOk()) return;
-    if (count === 0 || instanceCount === 0) return;
-    if (!this._checkVertexAttribState(count + first - 1 >>> 0)) return;
-    if (globalThis.__GJSIFY_DEBUG_GL) {
-      const n = this.__drawInstCount = (this.__drawInstCount | 0) + 1;
-      if (n <= 5 || n % 100 === 0) console.log(`[WebGL] drawArraysInstanced #${n} count=${rc} instances=${instanceCount} fbo=${this._activeFramebuffer?._ ?? "_gtkFbo"}`);
-    }
-    this._native2.drawArraysInstanced(mode, first, rc, instanceCount);
-  }
-  drawElementsInstanced(mode, count, type, offset, instanceCount) {
-    if (count < 0 || offset < 0 || instanceCount < 0) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    if (!this._checkStencilState()) return;
-    const elementBuffer = this._vertexObjectState._elementArrayBufferBinding;
-    if (!elementBuffer) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    let elementData = null;
-    let adjustedOffset = offset;
-    if (type === this.UNSIGNED_SHORT) {
-      if (adjustedOffset % 2) {
-        this.setError(this.INVALID_OPERATION);
-        return;
-      }
-      adjustedOffset >>= 1;
-      elementData = new Uint16Array(elementBuffer._elements.buffer);
-    } else if (type === this.UNSIGNED_INT) {
-      if (adjustedOffset % 4) {
-        this.setError(this.INVALID_OPERATION);
-        return;
-      }
-      adjustedOffset >>= 2;
-      elementData = new Uint32Array(elementBuffer._elements.buffer);
-    } else if (type === this.UNSIGNED_BYTE) {
-      elementData = elementBuffer._elements;
-    } else {
-      this.setError(this.INVALID_ENUM);
-      return;
-    }
-    let reducedCount = count;
-    switch (mode) {
-      case this.TRIANGLES:
-        if (count % 3) reducedCount -= count % 3;
-        break;
-      case this.LINES:
-        if (count % 2) reducedCount -= count % 2;
-        break;
-      case this.POINTS:
-        break;
-      case this.LINE_LOOP:
-      case this.LINE_STRIP:
-        if (count < 2) {
-          this.setError(this.INVALID_OPERATION);
-          return;
-        }
-        break;
-      case this.TRIANGLE_FAN:
-      case this.TRIANGLE_STRIP:
-        if (count < 3) {
-          this.setError(this.INVALID_OPERATION);
-          return;
-        }
-        break;
-      default:
-        this.setError(this.INVALID_ENUM);
-        return;
-    }
-    if (!this._framebufferOk()) return;
-    if (reducedCount === 0 || instanceCount === 0) {
-      this._checkVertexAttribState(0);
-      return;
-    }
-    if (reducedCount + adjustedOffset >>> 0 > elementData.length) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    let maxIndex = 0;
-    for (let i = adjustedOffset; i < adjustedOffset + reducedCount; ++i) {
-      if (elementData[i] > maxIndex) maxIndex = elementData[i];
-    }
-    if (this._checkVertexAttribState(maxIndex)) {
-      this._native2.drawElementsInstanced(mode, reducedCount, type, offset, instanceCount);
-    }
-  }
-  vertexAttribDivisor(index, divisor) {
-    this._native2.vertexAttribDivisor(index, divisor);
-  }
-  vertexAttribIPointer(index, size, type, stride, offset) {
-    this._native2.vertexAttribIPointer(index, size, type, stride, offset);
-  }
-  drawBuffers(buffers) {
-    let hasBack = false;
-    for (let i = 0; i < buffers.length; i++) {
-      if (buffers[i] === 1029) {
-        hasBack = true;
-        break;
-      }
-    }
-    if (!hasBack) {
-      this._native2.drawBuffers(buffers);
-      return;
-    }
-    this._native2.drawBuffers(buffers.map((b) => b === 1029 ? this.COLOR_ATTACHMENT0 : b));
-  }
-  drawRangeElements(mode, start, end, count, type, offset) {
-    if (count < 0 || offset < 0) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    if (end < start) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    this.drawElements(mode, count, type, offset);
-  }
-  blitFramebuffer(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter) {
-    if (globalThis.__GJSIFY_DEBUG_GL) {
-      const errBefore = this._gl.getError();
-      if (errBefore !== 0) console.log(`[WebGL] blitFramebuffer PRE-ERROR 0x${errBefore.toString(16)}`);
-    }
-    this._native2.blitFramebuffer(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter);
-    if (globalThis.__GJSIFY_DEBUG_GL) {
-      const err = this._gl.getError();
-      const n = this.__blitCount = (this.__blitCount | 0) + 1;
-      if (n <= 5) console.log(`[WebGL] blitFramebuffer #${n} src=(${srcX0},${srcY0},${srcX1},${srcY1}) readFbo=${this._activeReadFramebuffer?._ ?? "_gtkFbo"} err=${err === 0 ? "OK" : "0x" + err.toString(16)}`);
-    }
-  }
-  // clearBuffer{fv,iv,uiv,fi} — WebGL2 methods for clearing specific
-  // framebuffer attachments. The native Vala binding does not expose the
-  // glClearBuffer* entry points yet, so we emulate the common cases via
-  // glClearColor/glClearDepth/glClearStencil + glClear. This is equivalent
-  // when the DRAW_FRAMEBUFFER has a single attachment per buffer type,
-  // which matches Excalibur's ExcaliburGraphicsContextWebGL.blitToScreen.
-  //
-  // Buffer target constants per WebGL2 spec (not on our class):
-  //   COLOR         = 0x1800
-  //   DEPTH         = 0x1801
-  //   STENCIL       = 0x1802
-  //   DEPTH_STENCIL = 0x84F9
-  clearBufferfv(buffer, drawbuffer, values, _srcOffset) {
-    const n2 = this._native2;
-    if (typeof n2.clearBufferfv === "function") {
-      n2.clearBufferfv(buffer, drawbuffer, Array.from(values));
-      return;
-    }
-    const v = values;
-    if (buffer === 6144) {
-      const prev = this.getParameter(this.COLOR_CLEAR_VALUE);
-      this.clearColor(v[0] ?? 0, v[1] ?? 0, v[2] ?? 0, v[3] ?? 0);
-      this.clear(this.COLOR_BUFFER_BIT);
-      if (prev) this.clearColor(prev[0], prev[1], prev[2], prev[3]);
-    } else if (buffer === 6145) {
-      const prev = this.getParameter(this.DEPTH_CLEAR_VALUE);
-      this.clearDepth(v[0] ?? 1);
-      this.clear(this.DEPTH_BUFFER_BIT);
-      if (prev !== null) this.clearDepth(prev);
-    }
-  }
-  clearBufferiv(buffer, drawbuffer, values, _srcOffset) {
-    const n2 = this._native2;
-    if (typeof n2.clearBufferiv === "function") {
-      n2.clearBufferiv(buffer, drawbuffer, Array.from(values));
-      return;
-    }
-    if (buffer === 6146) {
-      const v = values;
-      const prev = this.getParameter(this.STENCIL_CLEAR_VALUE);
-      this.clearStencil(v[0] ?? 0);
-      this.clear(this.STENCIL_BUFFER_BIT);
-      if (prev !== null) this.clearStencil(prev);
-    }
-  }
-  clearBufferuiv(buffer, drawbuffer, values, _srcOffset) {
-    const n2 = this._native2;
-    if (typeof n2.clearBufferuiv === "function") {
-      n2.clearBufferuiv(buffer, drawbuffer, Array.from(values));
-      return;
-    }
-    void buffer;
-    void drawbuffer;
-  }
-  clearBufferfi(buffer, drawbuffer, depth, stencil) {
-    const n2 = this._native2;
-    if (typeof n2.clearBufferfi === "function") {
-      n2.clearBufferfi(buffer, drawbuffer, depth, stencil);
-      return;
-    }
-    if (buffer === 34041) {
-      const prevDepth = this.getParameter(this.DEPTH_CLEAR_VALUE);
-      const prevStencil = this.getParameter(this.STENCIL_CLEAR_VALUE);
-      this.clearDepth(depth);
-      this.clearStencil(stencil);
-      this.clear(this.DEPTH_BUFFER_BIT | this.STENCIL_BUFFER_BIT);
-      if (prevDepth !== null) this.clearDepth(prevDepth);
-      if (prevStencil !== null) this.clearStencil(prevStencil);
-    }
-    void drawbuffer;
-  }
-  invalidateFramebuffer(target, attachments) {
-    this._native2.invalidateFramebuffer(target, attachments);
-  }
-  invalidateSubFramebuffer(target, attachments, x, y, width, height) {
-    this._native2.invalidateSubFramebuffer(target, attachments, x, y, width, height);
-  }
-  readBuffer(src) {
-    this._native2.readBuffer(src);
-  }
-  renderbufferStorageMultisample(target, samples, internalFormat, width, height) {
-    if (target !== this.RENDERBUFFER) {
-      this.setError(this.INVALID_ENUM);
-      return;
-    }
-    const renderbuffer = this._activeRenderbuffer;
-    if (!renderbuffer) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    this._saveError();
-    this._native2.renderbufferStorageMultisample(target, samples, internalFormat, width, height);
-    const error = this.getError();
-    this._restoreError(error);
-    if (error !== this.NO_ERROR) return;
-    renderbuffer._width = width;
-    renderbuffer._height = height;
-    renderbuffer._format = internalFormat;
-  }
-  // ─── Unsigned Integer Uniforms ────────────────────────────────────────
-  uniform1ui(location, v0) {
-    if (!location) return;
-    this._native2.uniform1ui(location._, v0);
-  }
-  uniform2ui(location, v0, v1) {
-    if (!location) return;
-    this._native2.uniform2ui(location._, v0, v1);
-  }
-  uniform3ui(location, v0, v1, v2) {
-    if (!location) return;
-    this._native2.uniform3ui(location._, v0, v1, v2);
-  }
-  uniform4ui(location, v0, v1, v2, v3) {
-    if (!location) return;
-    this._native2.uniform4ui(location._, v0, v1, v2, v3);
-  }
-  uniform1uiv(location, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
-    this._native2.uniform1uiv(location._, arr.length, arr);
-  }
-  uniform2uiv(location, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
-    this._native2.uniform2uiv(location._, arr.length / 2, arr);
-  }
-  uniform3uiv(location, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
-    this._native2.uniform3uiv(location._, arr.length / 3, arr);
-  }
-  uniform4uiv(location, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
-    this._native2.uniform4uiv(location._, arr.length / 4, arr);
-  }
-  // ─── Non-square Matrix Uniforms ───────────────────────────────────────
-  uniformMatrix2x3fv(location, transpose, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Float32Array ? data : new Float32Array(data);
-    this._native2.uniformMatrix2x3fv(location._, transpose, arr);
-  }
-  uniformMatrix3x2fv(location, transpose, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Float32Array ? data : new Float32Array(data);
-    this._native2.uniformMatrix3x2fv(location._, transpose, arr);
-  }
-  uniformMatrix2x4fv(location, transpose, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Float32Array ? data : new Float32Array(data);
-    this._native2.uniformMatrix2x4fv(location._, transpose, arr);
-  }
-  uniformMatrix4x2fv(location, transpose, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Float32Array ? data : new Float32Array(data);
-    this._native2.uniformMatrix4x2fv(location._, transpose, arr);
-  }
-  uniformMatrix3x4fv(location, transpose, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Float32Array ? data : new Float32Array(data);
-    this._native2.uniformMatrix3x4fv(location._, transpose, arr);
-  }
-  uniformMatrix4x3fv(location, transpose, data, _srcOffset, _srcLength) {
-    if (!location) return;
-    const arr = data instanceof Float32Array ? data : new Float32Array(data);
-    this._native2.uniformMatrix4x3fv(location._, transpose, arr);
-  }
-  // ─── getUniform — WebGL2 uint type support ────────────────────────────
-  /** WebGL1 getUniform falls to default:null for UNSIGNED_INT types. Handle them here. */
-  getUniform(program, location) {
-    const type = location?._activeInfo?.type;
-    const UINT = 5125, UVEC2 = 36294, UVEC3 = 36295, UVEC4 = 36296;
-    const isUintType = type === UINT || type === UVEC2 || type === UVEC3 || type === UVEC4;
-    if (!isUintType) return super.getUniform(program, location);
-    if (!program || !location) return null;
-    const data = this._gl.getUniformi(program._ | 0, location._ | 0);
-    if (!data) return null;
-    if (type === UINT) return data[0] >>> 0;
-    if (type === UVEC2) return new Uint32Array([data[0] >>> 0, data[1] >>> 0]);
-    if (type === UVEC3) return new Uint32Array([data[0] >>> 0, data[1] >>> 0, data[2] >>> 0]);
-    return new Uint32Array([data[0] >>> 0, data[1] >>> 0, data[2] >>> 0, data[3] >>> 0]);
-  }
-  // ─── Uniform Blocks ───────────────────────────────────────────────────
-  getUniformBlockIndex(program, uniformBlockName) {
-    return this._native2.getUniformBlockIndex(program._, uniformBlockName);
-  }
-  uniformBlockBinding(program, uniformBlockIndex, uniformBlockBinding) {
-    this._native2.uniformBlockBinding(program._, uniformBlockIndex, uniformBlockBinding);
-  }
-  getActiveUniformBlockName(program, uniformBlockIndex) {
-    const name = this._native2.getActiveUniformBlockName(program._, uniformBlockIndex);
-    return name.length > 0 ? name : null;
-  }
-  getActiveUniformBlockParameter(program, uniformBlockIndex, pname) {
-    return this._native2.getActiveUniformBlockParameter(program._, uniformBlockIndex, pname);
-  }
-  getActiveUniforms(program, uniformIndices, pname) {
-    const result = this._native2.getActiveUniforms(program._, uniformIndices, pname);
-    return result;
-  }
-  // ─── Program Queries ──────────────────────────────────────────────────
-  getFragDataLocation(program, name) {
-    return this._native2.getFragDataLocation(program._, name);
-  }
-  // ─── Indexed Parameter Queries ────────────────────────────────────────
-  getIndexedParameter(target, index) {
-    return this._native2.getIndexedParameteri(target, index);
-  }
-  getInternalformatParameter(target, internalformat, pname) {
-    return this._native2.getInternalformatParameter(target, internalformat, pname);
-  }
-  getParameter(pname) {
-    if (pname === 7938) return "WebGL 2.0";
-    if (pname === 35724) return "WebGL GLSL ES 3.00";
-    if (pname === 7939) {
-      warnNotImplemented("WebGL2RenderingContext.getParameter(GL_EXTENSIONS)");
-      return "";
-    }
-    if (pname === 36006) return this._activeDrawFramebuffer;
-    if (pname === 36010) return this._activeReadFramebuffer;
-    switch (pname) {
-      case 36183:
-      // MAX_SAMPLES
-      case 35071:
-      // MAX_ARRAY_TEXTURE_LAYERS
-      case 32883:
-      // MAX_3D_TEXTURE_SIZE
-      case 36063:
-      // MAX_COLOR_ATTACHMENTS
-      case 34852:
-      // MAX_DRAW_BUFFERS
-      case 36203:
-      // MAX_ELEMENT_INDEX
-      case 33001:
-      // MAX_ELEMENTS_INDICES
-      case 33e3:
-      // MAX_ELEMENTS_VERTICES
-      case 37157:
-      // MAX_FRAGMENT_INPUT_COMPONENTS
-      case 35373:
-      // MAX_FRAGMENT_UNIFORM_BLOCKS
-      case 35657:
-      // MAX_FRAGMENT_UNIFORM_COMPONENTS
-      case 35077:
-      // MAX_PROGRAM_TEXEL_OFFSET
-      case 35978:
-      // MAX_TRANSFORM_FEEDBACK_INTERLEAVED_COMPONENTS
-      case 35979:
-      // MAX_TRANSFORM_FEEDBACK_SEPARATE_ATTRIBS
-      case 35968:
-      // MAX_TRANSFORM_FEEDBACK_SEPARATE_COMPONENTS
-      case 35376:
-      // MAX_UNIFORM_BLOCK_SIZE
-      case 35375:
-      // MAX_UNIFORM_BUFFER_BINDINGS
-      case 35659:
-      // MAX_VARYING_COMPONENTS
-      case 37154:
-      // MAX_VERTEX_OUTPUT_COMPONENTS
-      case 35371:
-      // MAX_VERTEX_UNIFORM_BLOCKS
-      case 35658:
-      // MAX_VERTEX_UNIFORM_COMPONENTS
-      case 35379:
-      // MAX_COMBINED_FRAGMENT_UNIFORM_COMPONENTS
-      case 35374:
-      // MAX_COMBINED_UNIFORM_BLOCKS
-      case 35377:
-      // MAX_COMBINED_VERTEX_UNIFORM_COMPONENTS
-      case 35076:
-      // MIN_PROGRAM_TEXEL_OFFSET
-      case 3330:
-      // PACK_ROW_LENGTH
-      case 3332:
-      // PACK_SKIP_PIXELS
-      case 3331:
-      // PACK_SKIP_ROWS
-      case 35053:
-      // PIXEL_PACK_BUFFER_BINDING
-      case 35055:
-      // PIXEL_UNPACK_BUFFER_BINDING
-      case 3074:
-      // READ_BUFFER
-      case 32874:
-      // TEXTURE_BINDING_3D
-      case 35869:
-      // TEXTURE_BINDING_2D_ARRAY
-      case 36389:
-      // TRANSFORM_FEEDBACK_BINDING
-      case 35983:
-      // TRANSFORM_FEEDBACK_BUFFER_BINDING
-      case 35368:
-      // UNIFORM_BUFFER_BINDING
-      case 35380:
-      // UNIFORM_BUFFER_OFFSET_ALIGNMENT
-      case 32878:
-      // UNPACK_IMAGE_HEIGHT
-      case 3314:
-      // UNPACK_ROW_LENGTH
-      case 32877:
-      // UNPACK_SKIP_IMAGES
-      case 3316:
-      // UNPACK_SKIP_PIXELS
-      case 3315:
-      // UNPACK_SKIP_ROWS
-      case 34045:
-        return this._native2.getParameterx(pname)?.deepUnpack() | 0;
-      case 35977:
-      // RASTERIZER_DISCARD
-      case 36388:
-      // TRANSFORM_FEEDBACK_ACTIVE
-      case 36387:
-        return !!this._native2.getParameterx(pname)?.deepUnpack();
-    }
-    return super.getParameter(pname);
-  }
-  // ─── Misc ─────────────────────────────────────────────────────────────
-  getStringi(name, index) {
-    const s = this._native2.getStringi(name, index);
-    return s.length > 0 ? s : null;
-  }
-  // ─── WebGL2 overrides for format validation ────────────────────────────
-  /**
-   * WebGL2 supports ~30+ renderbuffer formats (R8, RG8, RGBA8, RGBA16F,
-   * DEPTH_COMPONENT24, DEPTH32F_STENCIL8, etc.). The WebGL1 base class
-   * only allows 7 formats. Delegate format validation to native GL.
-   */
-  renderbufferStorage(target, internalFormat, width, height) {
-    if (target !== this.RENDERBUFFER) {
-      this.setError(this.INVALID_ENUM);
-      return;
-    }
-    const renderbuffer = this._activeRenderbuffer;
-    if (!renderbuffer) {
-      this.setError(this.INVALID_OPERATION);
-      return;
-    }
-    if (width < 0 || height < 0) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    while (this._gl.getError() !== this.NO_ERROR) {
-    }
-    this._gl.renderbufferStorage(target, internalFormat, width, height);
-    if (this._gl.getError() !== this.NO_ERROR) return;
-    renderbuffer._width = width;
-    renderbuffer._height = height;
-    renderbuffer._format = internalFormat;
-    const activeFramebuffer = this._activeFramebuffer;
-    if (activeFramebuffer) {
-      const attachments = this._getAttachments();
-      let needsUpdate = false;
-      for (let i = 0; i < attachments.length; ++i) {
-        if (activeFramebuffer._attachments[attachments[i]] === renderbuffer) {
-          needsUpdate = true;
-          break;
-        }
-      }
-      if (needsUpdate) this._updateFramebufferAttachments(activeFramebuffer);
-    }
-  }
-  /**
-   * WebGL2 makes several WebGL1 extensions part of the core spec.
-   * EXT_color_buffer_float and EXT_color_buffer_half_float are always
-   * available in WebGL2 contexts. Append them if the base class didn't.
-   */
-  getSupportedExtensions() {
-    const exts = super.getSupportedExtensions();
-    const ensure = ["EXT_color_buffer_float", "EXT_color_buffer_half_float", "OES_texture_half_float"];
-    for (const ext of ensure) {
-      if (exts.indexOf(ext) === -1) exts.push(ext);
-    }
-    return exts;
-  }
-  /**
-   * WebGL2 allows reading pixels in many more format/type combinations
-   * than WebGL1's strict RGBA/UNSIGNED_BYTE. Delegate validation to native.
-   */
-  readPixels(x, y, width, height, format, type, pixels) {
-    if (!pixels) return;
-    if (width < 0 || height < 0) {
-      this.setError(this.INVALID_VALUE);
-      return;
-    }
-    if (!this._framebufferOk()) return;
-    const componentCount = format === 6408 || format === 32856 ? 4 : format === 6407 ? 3 : format === 33319 ? 2 : 1;
-    const bytesPerComponent = type === 5126 ? 4 : type === 5131 || type === 36193 ? 2 : type === 5125 || type === 5124 ? 4 : type === 5123 || type === 5122 ? 2 : 1;
-    const byteCount = width * height * componentCount * bytesPerComponent;
-    const pixelData = new Uint8Array(byteCount);
-    this._saveError();
-    const result = this._gl.readPixels(x, y, width, height, format, type, Uint8ArrayToVariant(pixelData));
-    const error = this.getError();
-    this._restoreError(error);
-    if (error !== this.NO_ERROR) return;
-    const src = result && result.length > 0 ? result : pixelData;
-    if (pixels instanceof Uint8Array) {
-      pixels.set(src);
-    } else if (pixels instanceof Float32Array) {
-      const floatView = new Float32Array(src.buffer, 0, pixels.length);
-      pixels.set(floatView);
-    }
-  }
-  // framebufferTexture2D: inherits from base class. WebGL2 allows level>0 for
-  // mipmap attachments, but Three.js only uses level=0. The base class level===0
-  // check is acceptable for now. If needed, override to skip level validation.
-  /**
-   * WebGL2 never blocks draw calls on JS-side framebuffer format checks.
-   * The native GL (Mesa/libepoxy) handles completeness and generates
-   * INVALID_FRAMEBUFFER_OPERATION for truly incomplete FBOs at draw time.
-   * This matches headless-gl's approach: _framebufferOk() always returns true.
-   *
-   * The base class rejects valid WebGL2 formats (RGBA16F/HALF_FLOAT, depth
-   * textures, WebGL2 renderbuffer formats) causing silent rendering failures
-   * for postprocessing effects and environment maps.
-   */
-  _framebufferOk() {
-    return true;
-  }
-}
-export {
-  WebGL2RenderingContext
+
+//#region src/ts/webgl2-rendering-context.ts
+var WebGL2RenderingContext = class WebGL2RenderingContext extends WebGLContextBase {
+	get _gl() {
+		return this._native2;
+	}
+	constructor(canvas, options = {}) {
+		super(canvas, options);
+		this._queries = {};
+		this._samplers = {};
+		this._transformFeedbacks = {};
+		this._vertexArrayObjects = {};
+		this._syncs = {};
+		this._activeReadFramebuffer = null;
+		this._activeDrawFramebuffer = null;
+		this._native2 = new Gwebgl.WebGL2RenderingContext({});
+		this._init();
+	}
+	_getGlslVersion(es) {
+		return es ? "300 es" : "130";
+	}
+	/**
+	* WebGL2 delegates framebuffer completeness to the native GL driver.
+	* Called by _framebufferOk() before draw calls and by _updateFramebufferAttachments.
+	* The base class version uses JS-side format whitelists that reject valid WebGL2 formats.
+	*/
+	/** WebGL2 allows COLOR_ATTACHMENT1–15 as framebuffer attachment points. */
+	_validFramebufferAttachment(attachment) {
+		if (super._validFramebufferAttachment(attachment)) return true;
+		return attachment >= 36065 && attachment <= 36079;
+	}
+	static {
+		this._WGL2_ALL_COLOR_ATTACHMENTS = [
+			36064,
+			36065,
+			36066,
+			36067,
+			36068,
+			36069,
+			36070,
+			36071,
+			36072,
+			36073,
+			36074,
+			36075,
+			36076,
+			36077,
+			36078,
+			36079
+		];
+	}
+	_getColorAttachments() {
+		return WebGL2RenderingContext._WGL2_ALL_COLOR_ATTACHMENTS;
+	}
+	/**
+	* WebGL2 extends the base-class framebuffer completeness pre-check to
+	* accept WebGL2-specific formats that the WebGL1 whitelist rejects.
+	*
+	* NOTE: This is called by _updateFramebufferAttachments BEFORE the native
+	* GL attachments are set, so we must NOT query glCheckFramebufferStatus
+	* here (it would see an empty FBO and always return INCOMPLETE).
+	* Instead we extend the JS-side format whitelist to cover WebGL2 formats.
+	*/
+	_preCheckFramebufferStatus(framebuffer) {
+		const attachments = framebuffer._attachments;
+		let bestWidth = 0;
+		let bestHeight = 0;
+		const allEnums = [
+			this.COLOR_ATTACHMENT0,
+			this.DEPTH_ATTACHMENT,
+			this.STENCIL_ATTACHMENT,
+			this.DEPTH_STENCIL_ATTACHMENT,
+			...WebGL2RenderingContext._WGL2_ALL_COLOR_ATTACHMENTS
+		];
+		for (const enumVal of allEnums) {
+			const attach = attachments[enumVal];
+			if (!attach) continue;
+			if (attach instanceof WebGLTexture) {
+				const level = framebuffer._attachmentLevel[enumVal] ?? 0;
+				const w = attach._levelWidth[level] ?? 0;
+				const h = attach._levelHeight[level] ?? 0;
+				if (w > 0 && h > 0) {
+					bestWidth = w;
+					bestHeight = h;
+					break;
+				}
+			} else if (attach instanceof WebGLRenderbuffer) {
+				if (attach._width > 0 && attach._height > 0) {
+					bestWidth = attach._width;
+					bestHeight = attach._height;
+					break;
+				}
+			}
+		}
+		if (bestWidth > 0 && bestHeight > 0) {
+			framebuffer._width = bestWidth;
+			framebuffer._height = bestHeight;
+			return this.FRAMEBUFFER_COMPLETE;
+		}
+		return this.FRAMEBUFFER_INCOMPLETE_ATTACHMENT;
+	}
+	/**
+	* WebGL2 completely replaces the base class framebuffer attachment flow.
+	*
+	* The base class flow is: (1) pre-check formats in JS → (2) set native
+	* attachments only if pre-check passes. This is wrong for WebGL2 because
+	* the JS pre-check uses WebGL1 format whitelists that reject valid WebGL2
+	* formats.
+	*
+	* WebGL2 flow: (1) always set native attachments first → (2) query native
+	* glCheckFramebufferStatus to determine completeness. This delegates all
+	* format validation to the native GL driver, matching browser behavior.
+	*
+	* Also handles COLOR_ATTACHMENT1–15 (WebGL2 MRT) that the base class
+	* doesn't know about.
+	*/
+	/**
+	* Apply COLOR_ATTACHMENT1–15 to the native GL FBO (WebGL2 MRT).
+	* The base class handles CA0, DEPTH, STENCIL, DEPTH_STENCIL and calls
+	* _preCheckFramebufferStatus (which we override to query native GL).
+	*/
+	_updateFramebufferAttachments(framebuffer) {
+		super._updateFramebufferAttachments(framebuffer);
+		if (!framebuffer) return;
+		for (let i = 1; i <= 15; i++) {
+			const attachmentEnum = 36064 + i;
+			if (!(attachmentEnum in framebuffer._attachments)) continue;
+			const attachment = framebuffer._attachments[attachmentEnum];
+			if (attachment instanceof WebGLTexture) {
+				const face = framebuffer._attachmentFace[attachmentEnum] || this.TEXTURE_2D;
+				const level = framebuffer._attachmentLevel[attachmentEnum] ?? 0;
+				this._gl.framebufferTexture2D(this.FRAMEBUFFER, attachmentEnum, face, attachment._ | 0, level | 0);
+			} else if (attachment instanceof WebGLRenderbuffer) {
+				this._gl.framebufferRenderbuffer(this.FRAMEBUFFER, attachmentEnum, this.RENDERBUFFER, attachment._ | 0);
+			} else {
+				this._gl.framebufferTexture2D(this.FRAMEBUFFER, attachmentEnum, this.TEXTURE_2D, 0, 0);
+			}
+		}
+	}
+	/** WebGL2 adds UNIFORM_BUFFER, TRANSFORM_FEEDBACK_BUFFER, etc. targets. */
+	bindBuffer(target, buffer) {
+		const isWebGL2Target = target === 35345 || target === 35982 || target === 36662 || target === 36663;
+		if (isWebGL2Target) {
+			const id = buffer ? buffer._ | 0 : 0;
+			this._gl.bindBuffer(target, id);
+			return;
+		}
+		super.bindBuffer(target, buffer);
+	}
+	/**
+	* WebGL2 adds READ_FRAMEBUFFER (0x8CA8) and DRAW_FRAMEBUFFER (0x8CA9) targets.
+	* The base class only accepts FRAMEBUFFER; this override handles the two new targets
+	* and keeps _activeReadFramebuffer / _activeDrawFramebuffer in sync.
+	*/
+	bindFramebuffer(target, framebuffer) {
+		if (target === 36008 || target === 36009) {
+			if (!checkObject(framebuffer)) {
+				throw new TypeError("bindFramebuffer(GLenum, WebGLFramebuffer)");
+			}
+			if (framebuffer && framebuffer._pendingDelete) return;
+			if (framebuffer && !this._checkWrapper(framebuffer, WebGLFramebuffer)) return;
+			const id = framebuffer ? framebuffer._ | 0 : this._gtkFboId;
+			this._gl.bindFramebuffer(target, id);
+			if (target === 36008) {
+				const prev = this._activeReadFramebuffer;
+				if (prev !== framebuffer) {
+					if (prev) {
+						prev._refCount -= 1;
+						prev._checkDelete();
+					}
+					if (framebuffer) framebuffer._refCount += 1;
+				}
+				this._activeReadFramebuffer = framebuffer;
+			} else {
+				const prev = this._activeDrawFramebuffer;
+				if (prev !== framebuffer) {
+					if (prev) {
+						prev._refCount -= 1;
+						prev._checkDelete();
+					}
+					if (framebuffer) framebuffer._refCount += 1;
+				}
+				this._activeDrawFramebuffer = framebuffer;
+				this._activeFramebuffer = framebuffer;
+			}
+			return;
+		}
+		super.bindFramebuffer(this.FRAMEBUFFER, framebuffer);
+		this._activeReadFramebuffer = framebuffer;
+		this._activeDrawFramebuffer = framebuffer;
+	}
+	/** WebGL2 also unbinds from read/draw framebuffer slots when deleting. */
+	deleteFramebuffer(framebuffer) {
+		if (this._activeReadFramebuffer === framebuffer) {
+			this.bindFramebuffer(36008, null);
+		}
+		if (this._activeDrawFramebuffer === framebuffer) {
+			this.bindFramebuffer(36009, null);
+		}
+		super.deleteFramebuffer(framebuffer);
+	}
+	/** WebGL2 adds READ/COPY buffer usages and additional buffer targets. */
+	bufferData(target, dataOrSize, usage) {
+		const isWebGL2Target = target === 35345 || target === 35982 || target === 36662 || target === 36663;
+		const isReadOrCopy = usage === 35041 || usage === 35043 || usage === 35045 || usage === 35042 || usage === 35044 || usage === 35046;
+		const remappedUsage = isReadOrCopy ? this.STATIC_DRAW : usage;
+		if (isWebGL2Target) {
+			if (typeof dataOrSize === "number") {
+				if (dataOrSize >= 0) this._gl.bufferDataSizeOnly(target, dataOrSize, remappedUsage);
+			} else if (dataOrSize !== null && typeof dataOrSize === "object") {
+				const u8Data = arrayToUint8Array(dataOrSize);
+				this._gl.bufferData(target, Uint8ArrayToVariant(u8Data), remappedUsage);
+			}
+			return;
+		}
+		super.bufferData(target, dataOrSize, remappedUsage);
+	}
+	/** WebGL2 adds UNIFORM_BUFFER, TRANSFORM_FEEDBACK_BUFFER, COPY_READ/WRITE targets. */
+	bufferSubData(target, offset, data) {
+		const isWebGL2Target = target === 35345 || target === 35982 || target === 36662 || target === 36663;
+		if (isWebGL2Target) {
+			if (offset < 0) {
+				this.setError(this.INVALID_VALUE);
+				return;
+			}
+			if (!data) {
+				this.setError(this.INVALID_VALUE);
+				return;
+			}
+			const u8Data = arrayToUint8Array(data);
+			this._gl.bufferSubData(target, offset, Uint8ArrayToVariant(u8Data));
+			return;
+		}
+		super.bufferSubData(target, offset, data);
+	}
+	/** WebGL2 adds TEXTURE_3D and TEXTURE_2D_ARRAY target support. */
+	bindTexture(target, texture) {
+		if (target === 32879 || target === 35866) {
+			const id = texture ? texture._ | 0 : 0;
+			this._gl.bindTexture(target, id);
+			if (texture) texture._binding = target;
+			return;
+		}
+		super.bindTexture(target, texture);
+	}
+	/** WebGL2 adds TEXTURE_3D/TEXTURE_2D_ARRAY targets and many new pnames. */
+	texParameteri(target, pname, param) {
+		if (target === 32879 || target === 35866) {
+			this._gl.texParameteri(target, pname, param);
+			return;
+		}
+		const isWebGL2Pname = pname === 32882 || pname === 34892 || pname === 34893 || pname === 33084 || pname === 33085 || pname === 33083 || pname === 33082;
+		if (isWebGL2Pname) {
+			this._gl.texParameteri(target, pname, param);
+			return;
+		}
+		super.texParameteri(target, pname, param);
+	}
+	/**
+	* In WebGL2/GLES3 the attribute-0 requirement from WebGL1 does not apply.
+	* Override drawArrays to skip the attrib0 hack and call glDrawArrays directly.
+	*/
+	/**
+	* In WebGL2/GLES3 the attribute-0 requirement from WebGL1 does not apply.
+	* Override drawArrays to skip the attrib0 hack and call glDrawArrays directly.
+	*/
+	drawArrays(mode, first, count) {
+		if (first < 0 || count < 0) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		if (!this._checkStencilState()) return;
+		const rc = vertexCount(this, mode, count);
+		if (rc < 0) {
+			this.setError(this.INVALID_ENUM);
+			return;
+		}
+		if (!this._framebufferOk()) return;
+		if (count === 0) return;
+		if (!this._checkVertexAttribState(count + first - 1 >>> 0)) return;
+		this._native2.drawArrays(mode, first, rc);
+	}
+	/**
+	* In WebGL2, UNSIGNED_INT element indices are a core feature — no extension needed.
+	* Override drawElements to skip the oes_element_index_uint extension check.
+	*/
+	drawElements(mode = 0, count = 0, type = 0, offset = 0) {
+		if (count < 0 || offset < 0) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		if (!this._checkStencilState()) return;
+		const elementBuffer = this._vertexObjectState._elementArrayBufferBinding;
+		if (!elementBuffer) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		let elementData = null;
+		let adjustedOffset = offset;
+		if (type === this.UNSIGNED_SHORT) {
+			if (adjustedOffset % 2) {
+				this.setError(this.INVALID_OPERATION);
+				return;
+			}
+			adjustedOffset >>= 1;
+			elementData = new Uint16Array(elementBuffer._elements.buffer);
+		} else if (type === this.UNSIGNED_INT) {
+			if (adjustedOffset % 4) {
+				this.setError(this.INVALID_OPERATION);
+				return;
+			}
+			adjustedOffset >>= 2;
+			elementData = new Uint32Array(elementBuffer._elements.buffer);
+		} else if (type === this.UNSIGNED_BYTE) {
+			elementData = elementBuffer._elements;
+		} else {
+			this.setError(this.INVALID_ENUM);
+			return;
+		}
+		let reducedCount = count;
+		switch (mode) {
+			case this.TRIANGLES:
+				if (count % 3) reducedCount -= count % 3;
+				break;
+			case this.LINES:
+				if (count % 2) reducedCount -= count % 2;
+				break;
+			case this.POINTS: break;
+			case this.LINE_LOOP:
+			case this.LINE_STRIP:
+				if (count < 2) {
+					this.setError(this.INVALID_OPERATION);
+					return;
+				}
+				break;
+			case this.TRIANGLE_FAN:
+			case this.TRIANGLE_STRIP:
+				if (count < 3) {
+					this.setError(this.INVALID_OPERATION);
+					return;
+				}
+				break;
+			default:
+				this.setError(this.INVALID_ENUM);
+				return;
+		}
+		if (!this._framebufferOk()) return;
+		if (count === 0) return;
+		let maxIndex = 0;
+		for (let i = adjustedOffset; i < adjustedOffset + reducedCount; ++i) {
+			if (i < elementData.length && elementData[i] > maxIndex) maxIndex = elementData[i];
+		}
+		if (this._checkVertexAttribState(maxIndex)) {
+			this._native2.drawElements(mode, reducedCount, type, offset);
+		}
+	}
+	createVertexArray() {
+		const id = this._native2.createVertexArray();
+		if (!id) return null;
+		const vao = new WebGLVertexArrayObject(id, this);
+		this._vertexArrayObjects[id] = vao;
+		return vao;
+	}
+	deleteVertexArray(vertexArray) {
+		if (!vertexArray || !(vertexArray instanceof WebGLVertexArrayObject)) return;
+		vertexArray._pendingDelete = true;
+		vertexArray._checkDelete();
+	}
+	isVertexArray(vertexArray) {
+		if (!vertexArray || !(vertexArray instanceof WebGLVertexArrayObject)) return false;
+		return this._native2.isVertexArray(vertexArray._);
+	}
+	bindVertexArray(array) {
+		if (array === null) {
+			this._native2.bindVertexArray(0);
+			this._vertexObjectState = this._defaultVertexObjectState;
+		} else if (array instanceof WebGLVertexArrayObject) {
+			this._native2.bindVertexArray(array._);
+			this._vertexObjectState = array._objectState;
+		} else {
+			this.setError(this.INVALID_OPERATION);
+		}
+	}
+	createQuery() {
+		const id = this._native2.createQuery();
+		if (!id) return null;
+		const query = new WebGLQuery(id, this);
+		this._queries[id] = query;
+		return query;
+	}
+	deleteQuery(query) {
+		if (!query || !(query instanceof WebGLQuery)) return;
+		query._pendingDelete = true;
+		query._checkDelete();
+	}
+	isQuery(query) {
+		if (!query || !(query instanceof WebGLQuery)) return false;
+		return this._native2.isQuery(query._);
+	}
+	beginQuery(target, query) {
+		if (!(query instanceof WebGLQuery)) return;
+		this._native2.beginQuery(target, query._);
+	}
+	endQuery(target) {
+		this._native2.endQuery(target);
+	}
+	getQuery(_target, _pname) {
+		warnNotImplemented("WebGL2RenderingContext.getQuery");
+		return null;
+	}
+	getQueryParameter(query, pname) {
+		if (!(query instanceof WebGLQuery)) return null;
+		return this._native2.getQueryParameter(query._, pname);
+	}
+	createSampler() {
+		const id = this._native2.createSampler();
+		if (!id) return null;
+		const sampler = new WebGLSampler(id, this);
+		this._samplers[id] = sampler;
+		return sampler;
+	}
+	deleteSampler(sampler) {
+		if (!sampler || !(sampler instanceof WebGLSampler)) return;
+		sampler._pendingDelete = true;
+		sampler._checkDelete();
+	}
+	isSampler(sampler) {
+		if (!sampler || !(sampler instanceof WebGLSampler)) return false;
+		return this._native2.isSampler(sampler._);
+	}
+	bindSampler(unit, sampler) {
+		this._native2.bindSampler(unit, sampler ? sampler._ : 0);
+	}
+	samplerParameteri(sampler, pname, param) {
+		if (!(sampler instanceof WebGLSampler)) return;
+		this._native2.samplerParameteri(sampler._, pname, param);
+	}
+	samplerParameterf(sampler, pname, param) {
+		if (!(sampler instanceof WebGLSampler)) return;
+		this._native2.samplerParameterf(sampler._, pname, param);
+	}
+	getSamplerParameter(sampler, pname) {
+		if (!(sampler instanceof WebGLSampler)) return null;
+		if (pname === 33082 || pname === 33083) {
+			return this._native2.getSamplerParameterf(sampler._, pname);
+		}
+		return this._native2.getSamplerParameteri(sampler._, pname);
+	}
+	fenceSync(condition, flags) {
+		const id = this._native2.fenceSync(condition, flags);
+		if (!id) return null;
+		const sync = new WebGLSync(id, this);
+		this._syncs[id] = sync;
+		return sync;
+	}
+	isSync(sync) {
+		if (!sync || !(sync instanceof WebGLSync)) return false;
+		return this._native2.isSync(sync._);
+	}
+	deleteSync(sync) {
+		if (!sync || !(sync instanceof WebGLSync)) return;
+		sync._pendingDelete = true;
+		sync._checkDelete();
+	}
+	clientWaitSync(sync, flags, timeout) {
+		if (!(sync instanceof WebGLSync)) return 37148;
+		return this._native2.clientWaitSync(sync._, flags, timeout);
+	}
+	waitSync(sync, flags, timeout) {
+		if (!(sync instanceof WebGLSync)) return;
+		this._native2.waitSync(sync._, flags, timeout);
+	}
+	getSyncParameter(sync, pname) {
+		if (!(sync instanceof WebGLSync)) return null;
+		return this._native2.getSyncParameter(sync._, pname);
+	}
+	createTransformFeedback() {
+		const id = this._native2.createTransformFeedback();
+		if (!id) return null;
+		const tf = new WebGLTransformFeedback(id, this);
+		this._transformFeedbacks[id] = tf;
+		return tf;
+	}
+	deleteTransformFeedback(tf) {
+		if (!tf || !(tf instanceof WebGLTransformFeedback)) return;
+		tf._pendingDelete = true;
+		tf._checkDelete();
+	}
+	isTransformFeedback(tf) {
+		if (!tf || !(tf instanceof WebGLTransformFeedback)) return false;
+		return this._native2.isTransformFeedback(tf._);
+	}
+	bindTransformFeedback(target, tf) {
+		this._native2.bindTransformFeedback(target, tf ? tf._ : 0);
+	}
+	beginTransformFeedback(primitiveMode) {
+		this._native2.beginTransformFeedback(primitiveMode);
+	}
+	endTransformFeedback() {
+		this._native2.endTransformFeedback();
+	}
+	pauseTransformFeedback() {
+		this._native2.pauseTransformFeedback();
+	}
+	resumeTransformFeedback() {
+		this._native2.resumeTransformFeedback();
+	}
+	transformFeedbackVaryings(program, varyings, bufferMode) {
+		this._native2.transformFeedbackVaryings(program._, varyings, bufferMode);
+	}
+	getTransformFeedbackVarying(program, index) {
+		const result = this._native2.getTransformFeedbackVarying(program._, index).deepUnpack();
+		return new WebGLActiveInfo({
+			size: result.size,
+			type: result.type,
+			name: result.name
+		});
+	}
+	bindBufferBase(target, index, buffer) {
+		this._native2.bindBufferBase(target, index, buffer ? buffer._ : 0);
+	}
+	bindBufferRange(target, index, buffer, offset, size) {
+		this._native2.bindBufferRange(target, index, buffer ? buffer._ : 0, offset, size);
+	}
+	copyBufferSubData(readTarget, writeTarget, readOffset, writeOffset, size) {
+		this._native2.copyBufferSubData(readTarget, writeTarget, readOffset, writeOffset, size);
+	}
+	getBufferSubData(target, srcByteOffset, dstBuffer, dstOffset, length) {
+		const byteLength = length !== undefined ? length : dstBuffer.byteLength - (dstOffset ?? 0);
+		const data = this._native2.getBufferSubData(target, srcByteOffset, byteLength);
+		const dst = new Uint8Array(dstBuffer.buffer, dstBuffer.byteOffset + (dstOffset ?? 0) * (dstBuffer instanceof Uint8Array ? 1 : dstBuffer.BYTES_PER_ELEMENT ?? 1));
+		dst.set(data.subarray(0, dst.byteLength));
+	}
+	texImage3D(target, level, internalformat, width, height, depth, border, format, type, pixels) {
+		if (pixels === null) {
+			this._native2.texImage3DNull(target, level, internalformat, width, height, depth, border, format, type);
+		} else {
+			this._native2.texImage3D(target, level, internalformat, width, height, depth, border, format, type, Uint8ArrayToVariant(new Uint8Array(pixels.buffer, pixels.byteOffset, pixels.byteLength)));
+		}
+	}
+	texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, pixels) {
+		if (pixels === null) return;
+		this._native2.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, Uint8ArrayToVariant(new Uint8Array(pixels.buffer, pixels.byteOffset, pixels.byteLength)));
+	}
+	compressedTexImage3D(target, level, internalformat, width, height, depth, border, _imageSize, data) {
+		this._native2.compressedTexImage3D(target, level, internalformat, width, height, depth, border, Uint8ArrayToVariant(new Uint8Array(data.buffer, data.byteOffset, data.byteLength)));
+	}
+	compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, _imageSize, data) {
+		this._native2.compressedTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, Uint8ArrayToVariant(new Uint8Array(data.buffer, data.byteOffset, data.byteLength)));
+	}
+	copyTexSubImage3D(target, level, xoffset, yoffset, zoffset, x, y, width, height) {
+		this._native2.copyTexSubImage3D(target, level, xoffset, yoffset, zoffset, x, y, width, height);
+	}
+	texStorage2D(target, levels, internalformat, width, height) {
+		this._native2.texStorage2D(target, levels, internalformat, width, height);
+		const texture = this._getTexImage(target);
+		if (texture) {
+			for (let lvl = 0; lvl < levels; lvl++) {
+				texture._levelWidth[lvl] = Math.max(1, width >> lvl);
+				texture._levelHeight[lvl] = Math.max(1, height >> lvl);
+			}
+			texture._format = this.RGBA;
+			texture._type = this.UNSIGNED_BYTE;
+		}
+	}
+	texStorage3D(target, levels, internalformat, width, height, depth) {
+		this._native2.texStorage3D(target, levels, internalformat, width, height, depth);
+	}
+	texImage2D(target = 0, level = 0, internalFormat = 0, formatOrWidth = 0, typeOrHeight = 0, sourceOrBorder = 0, _format = 0, type = 0, pixels) {
+		let width = 0;
+		let height = 0;
+		let format = 0;
+		let border = 0;
+		if (arguments.length === 6) {
+			type = typeOrHeight;
+			format = formatOrWidth;
+			if (sourceOrBorder instanceof GdkPixbuf.Pixbuf) {
+				const pixbuf = sourceOrBorder;
+				width = pixbuf.get_width();
+				height = pixbuf.get_height();
+				pixels = pixbuf.get_pixels();
+			} else {
+				const imageData = extractImageData(sourceOrBorder);
+				if (imageData == null) {
+					throw new TypeError("texImage2D(GLenum, GLint, GLenum, GLint, GLenum, GLenum, ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement)");
+				}
+				width = imageData.width;
+				height = imageData.height;
+				pixels = imageData.data;
+			}
+		} else if (arguments.length >= 9) {
+			width = formatOrWidth;
+			height = typeOrHeight;
+			border = sourceOrBorder;
+			format = _format;
+		}
+		const texture = this._getTexImage(target);
+		if (!texture) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		let data = convertPixels(pixels);
+		if (this._unpackPremultAlpha && data && format === this.RGBA) {
+			data = premultiplyAlpha(data);
+		}
+		if (this._unpackFlipY && data && width > 0 && height > 0) {
+			const pixelSize = this._computePixelSize(type, format);
+			if (pixelSize > 0) {
+				const rowStride = this._computeRowStride(width, pixelSize);
+				const flipped = new Uint8Array(data.length);
+				for (let row = 0; row < height; row++) {
+					const srcOffset = row * rowStride;
+					const dstOffset = (height - 1 - row) * rowStride;
+					flipped.set(data.subarray(srcOffset, srcOffset + rowStride), dstOffset);
+				}
+				data = flipped;
+			}
+		}
+		this._saveError();
+		this._gl.texImage2D(target, level, internalFormat, width, height, border, format, type, Uint8ArrayToVariant(data));
+		const error = this.getError();
+		this._restoreError(error);
+		if (error !== this.NO_ERROR) return;
+		texture._levelWidth[level] = width;
+		texture._levelHeight[level] = height;
+		texture._format = format;
+		texture._type = type;
+		const activeFramebuffer = this._activeFramebuffer;
+		if (activeFramebuffer) {
+			let needsUpdate = false;
+			const attachments = this._getAttachments();
+			for (let i = 0; i < attachments.length; ++i) {
+				if (activeFramebuffer._attachments[attachments[i]] === texture) {
+					needsUpdate = true;
+					break;
+				}
+			}
+			if (needsUpdate && this._activeFramebuffer) {
+				this._updateFramebufferAttachments(this._activeFramebuffer);
+			}
+		}
+	}
+	texSubImage2D(target = 0, level = 0, xoffset = 0, yoffset = 0, formatOrWidth = 0, typeOrHeight = 0, sourceOrFormat = 0, type = 0, pixels) {
+		let width = 0;
+		let height = 0;
+		let format = 0;
+		if (arguments.length === 7) {
+			type = typeOrHeight;
+			format = formatOrWidth;
+			if (sourceOrFormat instanceof GdkPixbuf.Pixbuf) {
+				const pixbuf = sourceOrFormat;
+				width = pixbuf.get_width();
+				height = pixbuf.get_height();
+				pixels = pixbuf.get_pixels();
+			} else {
+				const imageData = extractImageData(sourceOrFormat);
+				if (imageData == null) {
+					throw new TypeError("texSubImage2D(GLenum, GLint, GLint, GLint, GLenum, GLenum, ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement)");
+				}
+				width = imageData.width;
+				height = imageData.height;
+				pixels = imageData.data;
+			}
+		} else {
+			width = formatOrWidth;
+			height = typeOrHeight;
+			format = sourceOrFormat;
+		}
+		const texture = this._getTexImage(target);
+		if (!texture) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		let data = convertPixels(pixels);
+		if (!data) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		if (this._unpackPremultAlpha && data && format === this.RGBA) {
+			data = premultiplyAlpha(data);
+		}
+		if (this._unpackFlipY && data && width > 0 && height > 0) {
+			const pixelSize = this._computePixelSize(type, format);
+			if (pixelSize > 0) {
+				const rowStride = this._computeRowStride(width, pixelSize);
+				const flipped = new Uint8Array(data.length);
+				for (let row = 0; row < height; row++) {
+					const srcOffset = row * rowStride;
+					const dstOffset = (height - 1 - row) * rowStride;
+					flipped.set(data.subarray(srcOffset, srcOffset + rowStride), dstOffset);
+				}
+				data = flipped;
+			}
+		}
+		this._gl.texSubImage2D(target, level, xoffset, yoffset, width, height, format, type, Uint8ArrayToVariant(data));
+	}
+	framebufferTextureLayer(target, attachment, texture, level, layer) {
+		this._native2.framebufferTextureLayer(target, attachment, texture ? texture._ : 0, level, layer);
+	}
+	drawArraysInstanced(mode, first, count, instanceCount) {
+		if (first < 0 || count < 0 || instanceCount < 0) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		if (!this._checkStencilState()) return;
+		const rc = vertexCount(this, mode, count);
+		if (rc < 0) {
+			this.setError(this.INVALID_ENUM);
+			return;
+		}
+		if (!this._framebufferOk()) return;
+		if (count === 0 || instanceCount === 0) return;
+		if (!this._checkVertexAttribState(count + first - 1 >>> 0)) return;
+		if (globalThis.__GJSIFY_DEBUG_GL) {
+			const n = this.__drawInstCount = (this.__drawInstCount | 0) + 1;
+			if (n <= 5 || n % 100 === 0) console.log(`[WebGL] drawArraysInstanced #${n} count=${rc} instances=${instanceCount} fbo=${this._activeFramebuffer?._ ?? "_gtkFbo"}`);
+		}
+		this._native2.drawArraysInstanced(mode, first, rc, instanceCount);
+	}
+	drawElementsInstanced(mode, count, type, offset, instanceCount) {
+		if (count < 0 || offset < 0 || instanceCount < 0) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		if (!this._checkStencilState()) return;
+		const elementBuffer = this._vertexObjectState._elementArrayBufferBinding;
+		if (!elementBuffer) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		let elementData = null;
+		let adjustedOffset = offset;
+		if (type === this.UNSIGNED_SHORT) {
+			if (adjustedOffset % 2) {
+				this.setError(this.INVALID_OPERATION);
+				return;
+			}
+			adjustedOffset >>= 1;
+			elementData = new Uint16Array(elementBuffer._elements.buffer);
+		} else if (type === this.UNSIGNED_INT) {
+			if (adjustedOffset % 4) {
+				this.setError(this.INVALID_OPERATION);
+				return;
+			}
+			adjustedOffset >>= 2;
+			elementData = new Uint32Array(elementBuffer._elements.buffer);
+		} else if (type === this.UNSIGNED_BYTE) {
+			elementData = elementBuffer._elements;
+		} else {
+			this.setError(this.INVALID_ENUM);
+			return;
+		}
+		let reducedCount = count;
+		switch (mode) {
+			case this.TRIANGLES:
+				if (count % 3) reducedCount -= count % 3;
+				break;
+			case this.LINES:
+				if (count % 2) reducedCount -= count % 2;
+				break;
+			case this.POINTS: break;
+			case this.LINE_LOOP:
+			case this.LINE_STRIP:
+				if (count < 2) {
+					this.setError(this.INVALID_OPERATION);
+					return;
+				}
+				break;
+			case this.TRIANGLE_FAN:
+			case this.TRIANGLE_STRIP:
+				if (count < 3) {
+					this.setError(this.INVALID_OPERATION);
+					return;
+				}
+				break;
+			default:
+				this.setError(this.INVALID_ENUM);
+				return;
+		}
+		if (!this._framebufferOk()) return;
+		if (reducedCount === 0 || instanceCount === 0) {
+			this._checkVertexAttribState(0);
+			return;
+		}
+		if (reducedCount + adjustedOffset >>> 0 > elementData.length) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		let maxIndex = 0;
+		for (let i = adjustedOffset; i < adjustedOffset + reducedCount; ++i) {
+			if (elementData[i] > maxIndex) maxIndex = elementData[i];
+		}
+		if (this._checkVertexAttribState(maxIndex)) {
+			this._native2.drawElementsInstanced(mode, reducedCount, type, offset, instanceCount);
+		}
+	}
+	vertexAttribDivisor(index, divisor) {
+		this._native2.vertexAttribDivisor(index, divisor);
+	}
+	vertexAttribIPointer(index, size, type, stride, offset) {
+		this._native2.vertexAttribIPointer(index, size, type, stride, offset);
+	}
+	drawBuffers(buffers) {
+		let hasBack = false;
+		for (let i = 0; i < buffers.length; i++) {
+			if (buffers[i] === 1029) {
+				hasBack = true;
+				break;
+			}
+		}
+		if (!hasBack) {
+			this._native2.drawBuffers(buffers);
+			return;
+		}
+		this._native2.drawBuffers(buffers.map((b) => b === 1029 ? this.COLOR_ATTACHMENT0 : b));
+	}
+	drawRangeElements(mode, start, end, count, type, offset) {
+		if (count < 0 || offset < 0) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		if (end < start) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		this.drawElements(mode, count, type, offset);
+	}
+	blitFramebuffer(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter) {
+		if (globalThis.__GJSIFY_DEBUG_GL) {
+			const errBefore = this._gl.getError();
+			if (errBefore !== 0) console.log(`[WebGL] blitFramebuffer PRE-ERROR 0x${errBefore.toString(16)}`);
+		}
+		this._native2.blitFramebuffer(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter);
+		if (globalThis.__GJSIFY_DEBUG_GL) {
+			const err = this._gl.getError();
+			const n = this.__blitCount = (this.__blitCount | 0) + 1;
+			if (n <= 5) console.log(`[WebGL] blitFramebuffer #${n} src=(${srcX0},${srcY0},${srcX1},${srcY1}) readFbo=${this._activeReadFramebuffer?._ ?? "_gtkFbo"} err=${err === 0 ? "OK" : "0x" + err.toString(16)}`);
+		}
+	}
+	clearBufferfv(buffer, drawbuffer, values, _srcOffset) {
+		const n2 = this._native2;
+		if (typeof n2.clearBufferfv === "function") {
+			n2.clearBufferfv(buffer, drawbuffer, Array.from(values));
+			return;
+		}
+		const v = values;
+		if (buffer === 6144) {
+			const prev = this.getParameter(this.COLOR_CLEAR_VALUE);
+			this.clearColor(v[0] ?? 0, v[1] ?? 0, v[2] ?? 0, v[3] ?? 0);
+			this.clear(this.COLOR_BUFFER_BIT);
+			if (prev) this.clearColor(prev[0], prev[1], prev[2], prev[3]);
+		} else if (buffer === 6145) {
+			const prev = this.getParameter(this.DEPTH_CLEAR_VALUE);
+			this.clearDepth(v[0] ?? 1);
+			this.clear(this.DEPTH_BUFFER_BIT);
+			if (prev !== null) this.clearDepth(prev);
+		}
+	}
+	clearBufferiv(buffer, drawbuffer, values, _srcOffset) {
+		const n2 = this._native2;
+		if (typeof n2.clearBufferiv === "function") {
+			n2.clearBufferiv(buffer, drawbuffer, Array.from(values));
+			return;
+		}
+		if (buffer === 6146) {
+			const v = values;
+			const prev = this.getParameter(this.STENCIL_CLEAR_VALUE);
+			this.clearStencil(v[0] ?? 0);
+			this.clear(this.STENCIL_BUFFER_BIT);
+			if (prev !== null) this.clearStencil(prev);
+		}
+	}
+	clearBufferuiv(buffer, drawbuffer, values, _srcOffset) {
+		const n2 = this._native2;
+		if (typeof n2.clearBufferuiv === "function") {
+			n2.clearBufferuiv(buffer, drawbuffer, Array.from(values));
+			return;
+		}
+		void buffer;
+		void drawbuffer;
+	}
+	clearBufferfi(buffer, drawbuffer, depth, stencil) {
+		const n2 = this._native2;
+		if (typeof n2.clearBufferfi === "function") {
+			n2.clearBufferfi(buffer, drawbuffer, depth, stencil);
+			return;
+		}
+		if (buffer === 34041) {
+			const prevDepth = this.getParameter(this.DEPTH_CLEAR_VALUE);
+			const prevStencil = this.getParameter(this.STENCIL_CLEAR_VALUE);
+			this.clearDepth(depth);
+			this.clearStencil(stencil);
+			this.clear(this.DEPTH_BUFFER_BIT | this.STENCIL_BUFFER_BIT);
+			if (prevDepth !== null) this.clearDepth(prevDepth);
+			if (prevStencil !== null) this.clearStencil(prevStencil);
+		}
+		void drawbuffer;
+	}
+	invalidateFramebuffer(target, attachments) {
+		this._native2.invalidateFramebuffer(target, attachments);
+	}
+	invalidateSubFramebuffer(target, attachments, x, y, width, height) {
+		this._native2.invalidateSubFramebuffer(target, attachments, x, y, width, height);
+	}
+	readBuffer(src) {
+		this._native2.readBuffer(src);
+	}
+	renderbufferStorageMultisample(target, samples, internalFormat, width, height) {
+		if (target !== this.RENDERBUFFER) {
+			this.setError(this.INVALID_ENUM);
+			return;
+		}
+		const renderbuffer = this._activeRenderbuffer;
+		if (!renderbuffer) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		this._saveError();
+		this._native2.renderbufferStorageMultisample(target, samples, internalFormat, width, height);
+		const error = this.getError();
+		this._restoreError(error);
+		if (error !== this.NO_ERROR) return;
+		renderbuffer._width = width;
+		renderbuffer._height = height;
+		renderbuffer._format = internalFormat;
+	}
+	uniform1ui(location, v0) {
+		if (!location) return;
+		this._native2.uniform1ui(location._, v0);
+	}
+	uniform2ui(location, v0, v1) {
+		if (!location) return;
+		this._native2.uniform2ui(location._, v0, v1);
+	}
+	uniform3ui(location, v0, v1, v2) {
+		if (!location) return;
+		this._native2.uniform3ui(location._, v0, v1, v2);
+	}
+	uniform4ui(location, v0, v1, v2, v3) {
+		if (!location) return;
+		this._native2.uniform4ui(location._, v0, v1, v2, v3);
+	}
+	uniform1uiv(location, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
+		this._native2.uniform1uiv(location._, arr.length, arr);
+	}
+	uniform2uiv(location, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
+		this._native2.uniform2uiv(location._, arr.length / 2, arr);
+	}
+	uniform3uiv(location, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
+		this._native2.uniform3uiv(location._, arr.length / 3, arr);
+	}
+	uniform4uiv(location, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Uint32Array ? data : new Uint32Array(data);
+		this._native2.uniform4uiv(location._, arr.length / 4, arr);
+	}
+	uniformMatrix2x3fv(location, transpose, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Float32Array ? data : new Float32Array(data);
+		this._native2.uniformMatrix2x3fv(location._, transpose, arr);
+	}
+	uniformMatrix3x2fv(location, transpose, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Float32Array ? data : new Float32Array(data);
+		this._native2.uniformMatrix3x2fv(location._, transpose, arr);
+	}
+	uniformMatrix2x4fv(location, transpose, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Float32Array ? data : new Float32Array(data);
+		this._native2.uniformMatrix2x4fv(location._, transpose, arr);
+	}
+	uniformMatrix4x2fv(location, transpose, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Float32Array ? data : new Float32Array(data);
+		this._native2.uniformMatrix4x2fv(location._, transpose, arr);
+	}
+	uniformMatrix3x4fv(location, transpose, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Float32Array ? data : new Float32Array(data);
+		this._native2.uniformMatrix3x4fv(location._, transpose, arr);
+	}
+	uniformMatrix4x3fv(location, transpose, data, _srcOffset, _srcLength) {
+		if (!location) return;
+		const arr = data instanceof Float32Array ? data : new Float32Array(data);
+		this._native2.uniformMatrix4x3fv(location._, transpose, arr);
+	}
+	/** WebGL1 getUniform falls to default:null for UNSIGNED_INT types. Handle them here. */
+	getUniform(program, location) {
+		const type = location?._activeInfo?.type;
+		const UINT = 5125, UVEC2 = 36294, UVEC3 = 36295, UVEC4 = 36296;
+		const isUintType = type === UINT || type === UVEC2 || type === UVEC3 || type === UVEC4;
+		if (!isUintType) return super.getUniform(program, location);
+		if (!program || !location) return null;
+		const data = this._gl.getUniformi(program._ | 0, location._ | 0);
+		if (!data) return null;
+		if (type === UINT) return data[0] >>> 0;
+		if (type === UVEC2) return new Uint32Array([data[0] >>> 0, data[1] >>> 0]);
+		if (type === UVEC3) return new Uint32Array([
+			data[0] >>> 0,
+			data[1] >>> 0,
+			data[2] >>> 0
+		]);
+		return new Uint32Array([
+			data[0] >>> 0,
+			data[1] >>> 0,
+			data[2] >>> 0,
+			data[3] >>> 0
+		]);
+	}
+	getUniformBlockIndex(program, uniformBlockName) {
+		return this._native2.getUniformBlockIndex(program._, uniformBlockName);
+	}
+	uniformBlockBinding(program, uniformBlockIndex, uniformBlockBinding) {
+		this._native2.uniformBlockBinding(program._, uniformBlockIndex, uniformBlockBinding);
+	}
+	getActiveUniformBlockName(program, uniformBlockIndex) {
+		const name = this._native2.getActiveUniformBlockName(program._, uniformBlockIndex);
+		return name.length > 0 ? name : null;
+	}
+	getActiveUniformBlockParameter(program, uniformBlockIndex, pname) {
+		return this._native2.getActiveUniformBlockParameter(program._, uniformBlockIndex, pname);
+	}
+	getActiveUniforms(program, uniformIndices, pname) {
+		const result = this._native2.getActiveUniforms(program._, uniformIndices, pname);
+		return result;
+	}
+	getFragDataLocation(program, name) {
+		return this._native2.getFragDataLocation(program._, name);
+	}
+	getIndexedParameter(target, index) {
+		return this._native2.getIndexedParameteri(target, index);
+	}
+	getInternalformatParameter(target, internalformat, pname) {
+		return this._native2.getInternalformatParameter(target, internalformat, pname);
+	}
+	getParameter(pname) {
+		if (pname === 7938) return "WebGL 2.0";
+		if (pname === 35724) return "WebGL GLSL ES 3.00";
+		if (pname === 7939) {
+			warnNotImplemented("WebGL2RenderingContext.getParameter(GL_EXTENSIONS)");
+			return "";
+		}
+		if (pname === 36006) return this._activeDrawFramebuffer;
+		if (pname === 36010) return this._activeReadFramebuffer;
+		switch (pname) {
+			case 36183:
+			case 35071:
+			case 32883:
+			case 36063:
+			case 34852:
+			case 36203:
+			case 33001:
+			case 33e3:
+			case 37157:
+			case 35373:
+			case 35657:
+			case 35077:
+			case 35978:
+			case 35979:
+			case 35968:
+			case 35376:
+			case 35375:
+			case 35659:
+			case 37154:
+			case 35371:
+			case 35658:
+			case 35379:
+			case 35374:
+			case 35377:
+			case 35076:
+			case 3330:
+			case 3332:
+			case 3331:
+			case 35053:
+			case 35055:
+			case 3074:
+			case 32874:
+			case 35869:
+			case 36389:
+			case 35983:
+			case 35368:
+			case 35380:
+			case 32878:
+			case 3314:
+			case 32877:
+			case 3316:
+			case 3315:
+			case 34045: return this._native2.getParameterx(pname)?.deepUnpack() | 0;
+			case 35977:
+			case 36388:
+			case 36387: return !!this._native2.getParameterx(pname)?.deepUnpack();
+		}
+		return super.getParameter(pname);
+	}
+	getStringi(name, index) {
+		const s = this._native2.getStringi(name, index);
+		return s.length > 0 ? s : null;
+	}
+	/**
+	* WebGL2 supports ~30+ renderbuffer formats (R8, RG8, RGBA8, RGBA16F,
+	* DEPTH_COMPONENT24, DEPTH32F_STENCIL8, etc.). The WebGL1 base class
+	* only allows 7 formats. Delegate format validation to native GL.
+	*/
+	renderbufferStorage(target, internalFormat, width, height) {
+		if (target !== this.RENDERBUFFER) {
+			this.setError(this.INVALID_ENUM);
+			return;
+		}
+		const renderbuffer = this._activeRenderbuffer;
+		if (!renderbuffer) {
+			this.setError(this.INVALID_OPERATION);
+			return;
+		}
+		if (width < 0 || height < 0) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		while (this._gl.getError() !== this.NO_ERROR) {}
+		this._gl.renderbufferStorage(target, internalFormat, width, height);
+		if (this._gl.getError() !== this.NO_ERROR) return;
+		renderbuffer._width = width;
+		renderbuffer._height = height;
+		renderbuffer._format = internalFormat;
+		const activeFramebuffer = this._activeFramebuffer;
+		if (activeFramebuffer) {
+			const attachments = this._getAttachments();
+			let needsUpdate = false;
+			for (let i = 0; i < attachments.length; ++i) {
+				if (activeFramebuffer._attachments[attachments[i]] === renderbuffer) {
+					needsUpdate = true;
+					break;
+				}
+			}
+			if (needsUpdate) this._updateFramebufferAttachments(activeFramebuffer);
+		}
+	}
+	/**
+	* WebGL2 makes several WebGL1 extensions part of the core spec.
+	* EXT_color_buffer_float and EXT_color_buffer_half_float are always
+	* available in WebGL2 contexts. Append them if the base class didn't.
+	*/
+	getSupportedExtensions() {
+		const exts = super.getSupportedExtensions();
+		const ensure = [
+			"EXT_color_buffer_float",
+			"EXT_color_buffer_half_float",
+			"OES_texture_half_float"
+		];
+		for (const ext of ensure) {
+			if (exts.indexOf(ext) === -1) exts.push(ext);
+		}
+		return exts;
+	}
+	/**
+	* WebGL2 allows reading pixels in many more format/type combinations
+	* than WebGL1's strict RGBA/UNSIGNED_BYTE. Delegate validation to native.
+	*/
+	readPixels(x, y, width, height, format, type, pixels) {
+		if (!pixels) return;
+		if (width < 0 || height < 0) {
+			this.setError(this.INVALID_VALUE);
+			return;
+		}
+		if (!this._framebufferOk()) return;
+		const componentCount = format === 6408 || format === 32856 ? 4 : format === 6407 ? 3 : format === 33319 ? 2 : 1;
+		const bytesPerComponent = type === 5126 ? 4 : type === 5131 || type === 36193 ? 2 : type === 5125 || type === 5124 ? 4 : type === 5123 || type === 5122 ? 2 : 1;
+		const byteCount = width * height * componentCount * bytesPerComponent;
+		const pixelData = new Uint8Array(byteCount);
+		this._saveError();
+		const result = this._gl.readPixels(x, y, width, height, format, type, Uint8ArrayToVariant(pixelData));
+		const error = this.getError();
+		this._restoreError(error);
+		if (error !== this.NO_ERROR) return;
+		const src = result && result.length > 0 ? result : pixelData;
+		if (pixels instanceof Uint8Array) {
+			pixels.set(src);
+		} else if (pixels instanceof Float32Array) {
+			const floatView = new Float32Array(src.buffer, 0, pixels.length);
+			pixels.set(floatView);
+		}
+	}
+	/**
+	* WebGL2 never blocks draw calls on JS-side framebuffer format checks.
+	* The native GL (Mesa/libepoxy) handles completeness and generates
+	* INVALID_FRAMEBUFFER_OPERATION for truly incomplete FBOs at draw time.
+	* This matches headless-gl's approach: _framebufferOk() always returns true.
+	*
+	* The base class rejects valid WebGL2 formats (RGBA16F/HALF_FLOAT, depth
+	* textures, WebGL2 renderbuffer formats) causing silent rendering failures
+	* for postprocessing effects and environment maps.
+	*/
+	_framebufferOk() {
+		return true;
+	}
 };
+
+//#endregion
+export { WebGL2RenderingContext };