@gjsify/webgl 0.0.3 → 0.1.0

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

@@ -0,0 +1,591 @@
+import Gwebgl from "@girs/gwebgl-0.1";
+import { WebGLRenderingContext } from "./webgl-rendering-context.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 { Uint8ArrayToVariant, arrayToUint8Array, vertexCount } from "./utils.js";
+import { warnNotImplemented } from "@gjsify/utils";
+class WebGL2RenderingContext extends WebGLRenderingContext {
+  constructor(canvas, options = {}) {
+    super(canvas, options);
+    this._queries = {};
+    this._samplers = {};
+    this._transformFeedbacks = {};
+    this._vertexArrayObjects = {};
+    this._syncs = {};
+    this._native2 = new Gwebgl.WebGL2RenderingContext({});
+  }
+  _getGlslVersion(es) {
+    return es ? "300 es" : "130";
+  }
+  // ─── WebGL2 overrides for WebGL1 validation that's too strict ─────────
+  /** WebGL2 allows COLOR_ATTACHMENT1–15 as framebuffer attachment points. */
+  _validFramebufferAttachment(attachment) {
+    if (super._validFramebufferAttachment(attachment)) return true;
+    return attachment >= 36065 && attachment <= 36079;
+  }
+  /**
+   * Apply COLOR_ATTACHMENT1–15 to the native GL FBO when they have attachments.
+   * The base class only knows about CA0, DEPTH, STENCIL, DEPTH_STENCIL.
+   */
+  _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._native.framebufferTexture2D(this.FRAMEBUFFER, attachmentEnum, face, attachment._ | 0, level | 0);
+      } else if (attachment instanceof WebGLRenderbuffer) {
+        this._native.framebufferRenderbuffer(this.FRAMEBUFFER, attachmentEnum, this.RENDERBUFFER, attachment._ | 0);
+      } else {
+        this._native.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._native.bindBuffer(target, id);
+      return;
+    }
+    super.bindBuffer(target, buffer);
+  }
+  /** 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._native.bufferDataSizeOnly(target, dataOrSize, remappedUsage);
+      } else if (dataOrSize !== null && typeof dataOrSize === "object") {
+        const u8Data = arrayToUint8Array(dataOrSize);
+        this._native.bufferData(target, Uint8ArrayToVariant(u8Data), remappedUsage);
+      }
+      return;
+    }
+    super.bufferData(target, dataOrSize, remappedUsage);
+  }
+  /** 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._native.bindTexture(target, id);
+      if (texture) texture._binding = target;
+      return;
+    }
+    super.bindTexture(target, texture);
+  }
+  /** WebGL2 adds TEXTURE_3D/TEXTURE_2D_ARRAY targets and TEXTURE_WRAP_R pname. */
+  texParameteri(target, pname, param) {
+    if (target === 32879 || target === 35866) {
+      this._native.texParameteri(target, pname, param);
+      return;
+    }
+    if (pname === 32882) {
+      this._native.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.
+   */
+  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)) {
+      this._native.drawArrays(mode, first, rc);
+    }
+  }
+  // ─── 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);
+  }
+  texStorage3D(target, levels, internalformat, width, height, depth) {
+    this._native2.texStorage3D(target, levels, internalformat, width, height, depth);
+  }
+  framebufferTextureLayer(target, attachment, texture, level, layer) {
+    this._native2.framebufferTextureLayer(target, attachment, texture ? texture._ : 0, level, layer);
+  }
+  // ─── Instancing & Advanced Draw ───────────────────────────────────────
+  drawArraysInstanced(mode, first, count, instanceCount) {
+    this._native2.drawArraysInstanced(mode, first, count, instanceCount);
+  }
+  drawElementsInstanced(mode, count, type, offset, instanceCount) {
+    this._native2.drawElementsInstanced(mode, count, 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) {
+    this._native2.drawBuffers(Array.from(buffers));
+  }
+  drawRangeElements(mode, start, end, count, type, offset) {
+    this._native2.drawRangeElements(mode, start, end, count, type, offset);
+  }
+  blitFramebuffer(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter) {
+    this._native2.blitFramebuffer(srcX0, srcY0, srcX1, srcY1, dstX0, dstY0, dstX1, dstY1, mask, filter);
+  }
+  invalidateFramebuffer(target, attachments) {
+    this._native2.invalidateFramebuffer(target, Array.from(attachments));
+  }
+  invalidateSubFramebuffer(target, attachments, x, y, width, height) {
+    this._native2.invalidateSubFramebuffer(target, Array.from(attachments), x, y, width, height);
+  }
+  readBuffer(src) {
+    this._native2.readBuffer(src);
+  }
+  renderbufferStorageMultisample(target, samples, internalformat, width, height) {
+    this._native2.renderbufferStorageMultisample(target, samples, internalformat, width, height);
+  }
+  // ─── 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, Array.from(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, Array.from(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, Array.from(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, Array.from(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, Array.from(arr));
+  }
+  uniformMatrix3x2fv(location, transpose, data, _srcOffset, _srcLength) {
+    if (!location) return;
+    const arr = data instanceof Float32Array ? data : new Float32Array(data);
+    this._native2.uniformMatrix3x2fv(location._, transpose, Array.from(arr));
+  }
+  uniformMatrix2x4fv(location, transpose, data, _srcOffset, _srcLength) {
+    if (!location) return;
+    const arr = data instanceof Float32Array ? data : new Float32Array(data);
+    this._native2.uniformMatrix2x4fv(location._, transpose, Array.from(arr));
+  }
+  uniformMatrix4x2fv(location, transpose, data, _srcOffset, _srcLength) {
+    if (!location) return;
+    const arr = data instanceof Float32Array ? data : new Float32Array(data);
+    this._native2.uniformMatrix4x2fv(location._, transpose, Array.from(arr));
+  }
+  uniformMatrix3x4fv(location, transpose, data, _srcOffset, _srcLength) {
+    if (!location) return;
+    const arr = data instanceof Float32Array ? data : new Float32Array(data);
+    this._native2.uniformMatrix3x4fv(location._, transpose, Array.from(arr));
+  }
+  uniformMatrix4x3fv(location, transpose, data, _srcOffset, _srcLength) {
+    if (!location) return;
+    const arr = data instanceof Float32Array ? data : new Float32Array(data);
+    this._native2.uniformMatrix4x3fv(location._, transpose, Array.from(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._native.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 "";
+    }
+    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 36010:
+      // READ_FRAMEBUFFER_BINDING
+      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;
+  }
+}
+export {
+  WebGL2RenderingContext
+};