@codexo/exojs 0.4.0 → 0.6.2

package/dist/esm/rendering/webgl2/{WebGl2ShaderRuntime.js → WebGl2ShaderProgram.js}

@@ -4,6 +4,7 @@ import { WebGl2ShaderBlock } from './WebGl2ShaderBlock.js';
 import { ShaderPrimitives } from '../types.js';
 import { webGl2PrimitiveArrayConstructors, webGl2PrimitiveByteSizeMapping } from './WebGl2ShaderMappings.js';
 
+const completionStatusEnumKhr = 0x91B1;
 const uniformUploadFunctions = {
     [ShaderPrimitives.Float]: (gl, location, value) => { gl.uniform1f(location, value[0]); },
     [ShaderPrimitives.FloatVec2]: (gl, location, value) => { gl.uniform2fv(location, value); },
@@ -22,22 +23,66 @@ const uniformUploadFunctions = {
     [ShaderPrimitives.FloatMat4]: (gl, location, value) => { gl.uniformMatrix4fv(location, false, value); },
     [ShaderPrimitives.Sampler2D]: (gl, location, value) => { gl.uniform1i(location, value[0]); },
 };
-function createWebGl2ShaderRuntime(gl) {
+function createWebGl2ShaderProgram(gl) {
     let program = null;
     let vertexShader = null;
     let fragmentShader = null;
+    let pendingShader = null;
     const managedUniforms = [];
     const uniformBlocks = [];
+    // Detect KHR_parallel_shader_compile. When present, the GL driver may
+    // compile shaders on a worker thread; we can poll completion via
+    // COMPLETION_STATUS_KHR without blocking. When absent, the very first
+    // call to gl.getShaderParameter(COMPILE_STATUS) blocks until the driver
+    // finishes compilation.
+    //
+    // Either way, this runtime defers the actual COMPILE_STATUS / LINK_STATUS
+    // queries (and the attribute/uniform extraction that depends on them)
+    // from initialize() to bind()/sync(). That way the driver gets the entire
+    // window between renderer setup and first draw to compile in the
+    // background. With the extension, that window is non-blocking; without
+    // it, the eventual blocking query is hopefully a no-op because the work
+    // already finished during asset loading or scene init.
+    const parallelExt = gl.getExtension('KHR_parallel_shader_compile');
+    const completionStatus = parallelExt?.COMPLETION_STATUS_KHR ?? completionStatusEnumKhr;
     function initialize(shader) {
         if (program) {
             return;
         }
+        // Issue compile + link without querying status. The driver may
+        // service these on a worker; we'll collect the result at first bind.
         vertexShader = compileShader(gl, gl.VERTEX_SHADER, shader.vertexSource);
         fragmentShader = compileShader(gl, gl.FRAGMENT_SHADER, shader.fragmentSource);
         program = linkProgram(gl, vertexShader, fragmentShader);
-        extractAttributes(gl, program, shader);
-        extractUniforms(gl, program, shader, managedUniforms);
+        pendingShader = shader;
+    }
+    function finalize() {
+        if (pendingShader === null || program === null || vertexShader === null || fragmentShader === null) {
+            return;
+        }
+        // With the KHR extension we can poll completion non-blockingly
+        // before the actual status queries (which would otherwise block).
+        // Without the extension we simply skip the poll and let the status
+        // query block on its own (today's behaviour).
+        if (parallelExt !== null) {
+            void gl.getProgramParameter(program, completionStatus);
+        }
+        if (!gl.getShaderParameter(vertexShader, gl.COMPILE_STATUS)) {
+            const log = gl.getShaderInfoLog(vertexShader);
+            throw new Error(`Vertex shader compilation failed: ${log}`);
+        }
+        if (!gl.getShaderParameter(fragmentShader, gl.COMPILE_STATUS)) {
+            const log = gl.getShaderInfoLog(fragmentShader);
+            throw new Error(`Fragment shader compilation failed: ${log}`);
+        }
+        if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+            const log = gl.getProgramInfoLog(program);
+            throw new Error(`Shader program linking failed: ${log}`);
+        }
+        extractAttributes(gl, program, pendingShader);
+        extractUniforms(gl, program, pendingShader, managedUniforms);
         extractUniformBlocks(gl, program, uniformBlocks);
+        pendingShader = null;
     }
     function syncUniforms() {
         for (const managed of managedUniforms) {
@@ -54,6 +99,7 @@ function createWebGl2ShaderRuntime(gl) {
         initialize,
         bind: (shader) => {
             initialize(shader);
+            finalize();
             gl.useProgram(program);
             syncUniforms();
         },
@@ -61,12 +107,13 @@ function createWebGl2ShaderRuntime(gl) {
             gl.useProgram(null);
         },
         sync: () => {
-            // Bind the program before syncing uniforms. WebGl2RenderManager
+            // Bind the program before syncing uniforms. WebGl2Backend
             // does not call bindShader() on the active renderer's shader
             // during normal draw flow, so sync() is the first entry point
             // that must establish program binding — otherwise uniform*
             // targets the wrong (or no) program and the subsequent draw
             // call fails with "no valid shader program in use".
+            finalize();
             gl.useProgram(program);
             syncUniforms();
         },
@@ -80,12 +127,17 @@ function createWebGl2ShaderRuntime(gl) {
             vertexShader = null;
             fragmentShader = null;
             program = null;
+            pendingShader = null;
             managedUniforms.length = 0;
             uniformBlocks.length = 0;
             shader.disconnect();
         },
     };
 }
+// compileShader / linkProgram intentionally do NOT query COMPILE_STATUS or
+// LINK_STATUS here — those queries block on driver completion. Status checks
+// happen in finalize() at first bind, after the driver has had time to
+// compile in the background (especially with KHR_parallel_shader_compile).
 function compileShader(gl, type, source) {
     const shader = gl.createShader(type);
     if (!shader) {
@@ -93,11 +145,6 @@ function compileShader(gl, type, source) {
     }
     gl.shaderSource(shader, source);
     gl.compileShader(shader);
-    if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
-        const log = gl.getShaderInfoLog(shader);
-        gl.deleteShader(shader);
-        throw new Error(`Shader compilation failed: ${log}`);
-    }
     return shader;
 }
 function linkProgram(gl, vertexShader, fragmentShader) {
@@ -108,13 +155,6 @@ function linkProgram(gl, vertexShader, fragmentShader) {
     gl.attachShader(program, vertexShader);
     gl.attachShader(program, fragmentShader);
     gl.linkProgram(program);
-    if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
-        const log = gl.getProgramInfoLog(program);
-        gl.detachShader(program, vertexShader);
-        gl.detachShader(program, fragmentShader);
-        gl.deleteProgram(program);
-        throw new Error(`Shader program linking failed: ${log}`);
-    }
     return program;
 }
 function extractAttributes(gl, program, shader) {
@@ -157,5 +197,5 @@ function extractUniformBlocks(gl, program, uniformBlocks) {
     }
 }
 
-export { createWebGl2ShaderRuntime };
-//# sourceMappingURL=WebGl2ShaderRuntime.js.map
+export { createWebGl2ShaderProgram };
+//# sourceMappingURL=WebGl2ShaderProgram.js.map

package/dist/esm/rendering/webgl2/WebGl2ShaderProgram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGl2ShaderProgram.js","sources":["../../../../../src/rendering/webgl2/WebGl2ShaderProgram.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/webgl2/WebGl2SpriteRenderer.d.ts

@@ -1,11 +1,30 @@
-import { WebGl2VertexArrayObject } from './WebGl2VertexArrayObject';
-import type { WebGl2RenderBuffer } from './WebGl2RenderBuffer';
+import { AbstractWebGl2Renderer } from './AbstractWebGl2Renderer';
 import type { Sprite } from '../sprite/Sprite';
-import { AbstractWebGl2BatchedRenderer } from './AbstractWebGl2BatchedRenderer';
-import type { View } from '../View';
-export declare class WebGl2SpriteRenderer extends AbstractWebGl2BatchedRenderer {
+import type { WebGl2Backend } from './WebGl2Backend';
+export declare class WebGl2SpriteRenderer extends AbstractWebGl2Renderer<Sprite> {
+    private readonly _shader;
+    private readonly _batchSize;
+    private readonly _instanceData;
+    private readonly _instanceFloat32;
+    private readonly _instanceUint32;
+    private readonly _activeTextures;
+    private readonly _textureSlots;
+    private _slotCount;
+    private _instanceCount;
+    private _currentBlendMode;
+    private _currentView;
+    private _currentViewId;
+    private _instanceBuffer;
+    private _vao;
+    private _connection;
     constructor(batchSize: number);
     render(sprite: Sprite): this;
-    protected createVao(gl: WebGL2RenderingContext, indexBuffer: WebGl2RenderBuffer, vertexBuffer: WebGl2RenderBuffer): WebGl2VertexArrayObject;
-    protected updateView(view: View): this;
+    flush(): void;
+    protected onConnect(backend: WebGl2Backend): void;
+    protected onDisconnect(): void;
+    destroy(): void;
+    private _resetSlots;
+    private _createConnection;
+    private _createBufferRuntime;
+    private _createVaoRuntime;
 }

package/dist/esm/rendering/webgl2/WebGl2SpriteRenderer.js

@@ -1,80 +1,278 @@
+import { AbstractWebGl2Renderer } from './AbstractWebGl2Renderer.js';
+import { Shader } from '../shader/Shader.js';
+import { createWebGl2ShaderProgram } from './WebGl2ShaderProgram.js';
+import { WebGl2RenderBuffer } from './WebGl2RenderBuffer.js';
 import { WebGl2VertexArrayObject } from './WebGl2VertexArrayObject.js';
-import { AbstractWebGl2BatchedRenderer } from './AbstractWebGl2BatchedRenderer.js';
+import { RenderingPrimitives, BufferTypes, BufferUsage } from '../types.js';
 import vertexSource from './glsl/sprite.vert.js';
 import fragmentSource from './glsl/sprite.frag.js';
 
-class WebGl2SpriteRenderer extends AbstractWebGl2BatchedRenderer {
+/**
+ * Instanced sprite renderer for WebGL2.
+ *
+ * Each batch issues a single `drawArraysInstanced(TRIANGLE_STRIP, 0, 4, N)`
+ * with no per-vertex buffer — `gl_VertexID` 0..3 selects which corner of
+ * the quad each invocation is computing. All per-sprite data lives in a
+ * single per-instance buffer (divisor = 1).
+ *
+ * Per-instance layout (56 bytes per sprite, 6 attributes):
+ * ```
+ *   localBounds    f32x4       (offset  0, 16 bytes)  — left, top, right, bottom
+ *   transformAB    f32x3       (offset 16, 12 bytes)  — first  row of 2D affine
+ *   transformCD    f32x3       (offset 28, 12 bytes)  — second row of 2D affine
+ *   uvBounds       u16x4 norm  (offset 40,  8 bytes)  — uMin, vMin, uMax, vMax
+ *   color          u8x4  norm  (offset 48,  4 bytes)  — RGBA tint
+ *   textureSlot    u32         (offset 52,  4 bytes)  — multi-texture slot
+ * ```
+ *
+ * vs. the previous per-vertex layout (80 bytes per quad), this saves
+ * roughly 30% bandwidth and ~75% of the CPU writes per sprite — the
+ * vertex shader expands one instance into four corners on the GPU
+ * instead of the CPU duplicating the same color/slot/transform across
+ * four vertex entries.
+ */
+const maxBatchTextures = 8;
+const instanceStrideBytes = 56;
+const wordsPerInstance = instanceStrideBytes / Uint32Array.BYTES_PER_ELEMENT;
+class WebGl2SpriteRenderer extends AbstractWebGl2Renderer {
+    _shader;
+    _batchSize;
+    _instanceData;
+    _instanceFloat32;
+    _instanceUint32;
+    _activeTextures = new Array(maxBatchTextures).fill(null);
+    _textureSlots = new Map();
+    _slotCount = 0;
+    _instanceCount = 0;
+    _currentBlendMode = null;
+    _currentView = null;
+    _currentViewId = -1;
+    _instanceBuffer = null;
+    _vao = null;
+    _connection = null;
     constructor(batchSize) {
-        /**
-         * 4 x 4 Attributes:
-         * 2 = position (x, y) +
-         * 1 = texCoord (packed uv) +
-         * 1 = color    (ARGB int)
-         */
-        super(batchSize, 16, vertexSource, fragmentSource);
+        super();
+        this._batchSize = batchSize;
+        this._shader = new Shader(vertexSource, fragmentSource);
+        this._instanceData = new ArrayBuffer(batchSize * instanceStrideBytes);
+        this._instanceFloat32 = new Float32Array(this._instanceData);
+        this._instanceUint32 = new Uint32Array(this._instanceData);
     }
     render(sprite) {
-        const { texture, blendMode, tint, vertices, texCoords } = sprite;
-        const batchFull = (this.batchIndex >= this.batchSize);
-        const textureChanged = (texture !== this.currentTexture);
-        const blendModeChanged = (blendMode !== this.currentBlendMode);
-        const flush = (batchFull || textureChanged || blendModeChanged);
-        const index = flush ? 0 : (this.batchIndex * this.attributeCount);
-        const float32View = this.float32View;
-        const uint32View = this.uint32View;
-        const runtime = this.getRuntime();
-        if (flush) {
+        const texture = sprite.texture;
+        if (texture === null) {
+            return this;
+        }
+        const backend = this.getBackend();
+        const blendMode = sprite.blendMode;
+        const batchFull = this._instanceCount >= this._batchSize;
+        const blendModeChanged = blendMode !== this._currentBlendMode;
+        const slotExhausted = !this._textureSlots.has(texture) && this._slotCount >= maxBatchTextures;
+        if (batchFull || blendModeChanged || slotExhausted) {
             this.flush();
-            if (textureChanged) {
-                this.currentTexture = texture;
-            }
             if (blendModeChanged) {
-                this.currentBlendMode = blendMode;
-                runtime.setBlendMode(blendMode);
+                this._currentBlendMode = blendMode;
+                backend.setBlendMode(blendMode);
             }
         }
-        if (textureChanged && texture) {
-            runtime.bindTexture(texture);
+        let slot = this._textureSlots.get(texture);
+        if (slot === undefined) {
+            slot = this._slotCount++;
+            this._textureSlots.set(texture, slot);
+            this._activeTextures[slot] = texture;
+            backend.bindTexture(texture, slot);
         }
-        // X / Y
-        float32View[index + 0] = vertices[0];
-        float32View[index + 1] = vertices[1];
-        // X / Y
-        float32View[index + 4] = vertices[2];
-        float32View[index + 5] = vertices[3];
-        // X / Y
-        float32View[index + 8] = vertices[4];
-        float32View[index + 9] = vertices[5];
-        // X / Y
-        float32View[index + 12] = vertices[6];
-        float32View[index + 13] = vertices[7];
-        // U / V
-        uint32View[index + 2] = texCoords[0];
-        uint32View[index + 6] = texCoords[1];
-        // U / V
-        uint32View[index + 10] = texCoords[2];
-        uint32View[index + 14] = texCoords[3];
-        // Tint
-        uint32View[index + 3]
-            = uint32View[index + 7]
-                = uint32View[index + 11]
-                    = uint32View[index + 15]
-                        = tint.toRgba();
-        this.batchIndex++;
+        const offset = this._instanceCount * wordsPerInstance;
+        const f32 = this._instanceFloat32;
+        const u32 = this._instanceUint32;
+        // localBounds: left, top, right, bottom (offset 0..3)
+        const bounds = sprite.getLocalBounds();
+        f32[offset + 0] = bounds.left;
+        f32[offset + 1] = bounds.top;
+        f32[offset + 2] = bounds.right;
+        f32[offset + 3] = bounds.bottom;
+        // transform rows (offset 4..6 = AB, 7..9 = CD)
+        const transform = sprite.getGlobalTransform();
+        f32[offset + 4] = transform.a;
+        f32[offset + 5] = transform.b;
+        f32[offset + 6] = transform.x;
+        f32[offset + 7] = transform.c;
+        f32[offset + 8] = transform.d;
+        f32[offset + 9] = transform.y;
+        // uvBounds at offset 10 — 8 bytes = 2 u32 slots, normalised u16x4.
+        // Pack (uMin, vMin, uMax, vMax) into two uint32s, with flipY swap
+        // applied at pack time so the shader can stay flip-agnostic.
+        const frame = sprite.textureFrame;
+        const texWidth = texture.width;
+        const texHeight = texture.height;
+        // Clamp to 16-bit unsigned range for normalisation.
+        const uMin = (frame.left / texWidth) * 0xFFFF & 0xFFFF;
+        const uMax = (frame.right / texWidth) * 0xFFFF & 0xFFFF;
+        const vMinRaw = (frame.top / texHeight) * 0xFFFF & 0xFFFF;
+        const vMaxRaw = (frame.bottom / texHeight) * 0xFFFF & 0xFFFF;
+        const vMin = texture.flipY ? vMaxRaw : vMinRaw;
+        const vMax = texture.flipY ? vMinRaw : vMaxRaw;
+        u32[offset + 10] = uMin | (vMin << 16);
+        u32[offset + 11] = uMax | (vMax << 16);
+        // color (u8x4 packed) at word 12
+        u32[offset + 12] = sprite.tint.toRgba();
+        // textureSlot (u32) at word 13
+        u32[offset + 13] = slot;
+        this._instanceCount++;
         return this;
     }
-    createVao(gl, indexBuffer, vertexBuffer) {
-        return new WebGl2VertexArrayObject()
-            .addIndex(indexBuffer)
-            .addAttribute(vertexBuffer, this.shader.getAttribute('a_position'), gl.FLOAT, false, this.attributeCount, 0)
-            .addAttribute(vertexBuffer, this.shader.getAttribute('a_texcoord'), gl.UNSIGNED_SHORT, true, this.attributeCount, 8)
-            .addAttribute(vertexBuffer, this.shader.getAttribute('a_color'), gl.UNSIGNED_BYTE, true, this.attributeCount, 12);
+    flush() {
+        const backend = this.getBackendOrNull();
+        const instanceBuffer = this._instanceBuffer;
+        const vao = this._vao;
+        if (this._instanceCount === 0 || backend === null || instanceBuffer === null || vao === null) {
+            this._resetSlots();
+            return;
+        }
+        const view = backend.view;
+        if (this._currentView !== view || this._currentViewId !== view.updateId) {
+            this._currentView = view;
+            this._currentViewId = view.updateId;
+            this._shader
+                .getUniform('u_projection')
+                .setValue(view.getTransform().toArray(false));
+        }
+        this._shader.sync();
+        backend.bindVertexArrayObject(vao);
+        instanceBuffer.upload(this._instanceFloat32.subarray(0, this._instanceCount * wordsPerInstance));
+        vao.drawInstanced(4, 0, this._instanceCount, RenderingPrimitives.TriangleStrip);
+        backend.stats.batches++;
+        backend.stats.drawCalls++;
+        this._instanceCount = 0;
+        this._resetSlots();
+    }
+    onConnect(backend) {
+        const gl = backend.context;
+        this._shader.connect(createWebGl2ShaderProgram(gl));
+        this._connection = this._createConnection(gl);
+        this._instanceBuffer = new WebGl2RenderBuffer(BufferTypes.ArrayBuffer, this._instanceData, BufferUsage.DynamicDraw)
+            .connect(this._createBufferRuntime(this._connection));
+        this._shader.sync();
+        this._vao = new WebGl2VertexArrayObject(RenderingPrimitives.TriangleStrip)
+            .addAttribute(this._instanceBuffer, this._shader.getAttribute('a_localBounds'), gl.FLOAT, false, instanceStrideBytes, 0, false, 1)
+            .addAttribute(this._instanceBuffer, this._shader.getAttribute('a_transformAB'), gl.FLOAT, false, instanceStrideBytes, 16, false, 1)
+            .addAttribute(this._instanceBuffer, this._shader.getAttribute('a_transformCD'), gl.FLOAT, false, instanceStrideBytes, 28, false, 1)
+            .addAttribute(this._instanceBuffer, this._shader.getAttribute('a_uvBounds'), gl.UNSIGNED_SHORT, true, instanceStrideBytes, 40, false, 1)
+            .addAttribute(this._instanceBuffer, this._shader.getAttribute('a_color'), gl.UNSIGNED_BYTE, true, instanceStrideBytes, 48, false, 1)
+            .addAttribute(this._instanceBuffer, this._shader.getAttribute('a_textureSlot'), gl.UNSIGNED_INT, false, instanceStrideBytes, 52, true, 1)
+            .connect(this._createVaoRuntime(this._connection));
+        // Pin the per-slot sampler uniforms to texture units 0..N-1.
+        const samplerUnit = new Int32Array(1);
+        for (let i = 0; i < maxBatchTextures; i++) {
+            samplerUnit[0] = i;
+            this._shader.getUniform(`u_texture${i}`).setValue(samplerUnit);
+        }
+    }
+    onDisconnect() {
+        this._shader.disconnect();
+        this._instanceBuffer?.destroy();
+        this._instanceBuffer = null;
+        this._vao?.destroy();
+        this._vao = null;
+        this._connection = null;
+        this._currentBlendMode = null;
+        this._currentView = null;
+        this._currentViewId = -1;
+        this._instanceCount = 0;
     }
-    updateView(view) {
-        this.shader
-            .getUniform('u_projection')
-            .setValue(view.getTransform().toArray(false));
-        return this;
+    destroy() {
+        this.disconnect();
+        this._shader.destroy();
+    }
+    _resetSlots() {
+        if (this._slotCount > 0) {
+            for (let i = 0; i < this._slotCount; i++) {
+                this._activeTextures[i] = null;
+            }
+            this._textureSlots.clear();
+            this._slotCount = 0;
+        }
+    }
+    _createConnection(gl) {
+        const vaoHandle = gl.createVertexArray();
+        if (vaoHandle === null) {
+            throw new Error('WebGl2SpriteRenderer: could not create vertex array object.');
+        }
+        return {
+            gl,
+            buffers: new Map(),
+            vaoHandle,
+        };
+    }
+    _createBufferRuntime(connection) {
+        const handle = connection.gl.createBuffer();
+        if (handle === null) {
+            throw new Error('WebGl2SpriteRenderer: could not create render buffer.');
+        }
+        return {
+            bind: (buffer) => {
+                connection.gl.bindBuffer(buffer.type, handle);
+            },
+            upload: (buffer, offset) => {
+                const gl = connection.gl;
+                const data = buffer.data;
+                const state = connection.buffers.get(buffer);
+                gl.bindBuffer(buffer.type, handle);
+                if (state && state.dataByteLength >= data.byteLength) {
+                    gl.bufferSubData(buffer.type, offset, data);
+                    state.dataByteLength = data.byteLength;
+                }
+                else {
+                    gl.bufferData(buffer.type, data, buffer.usage);
+                    connection.buffers.set(buffer, { handle, dataByteLength: data.byteLength });
+                }
+            },
+            destroy: (buffer) => {
+                connection.gl.deleteBuffer(handle);
+                connection.buffers.delete(buffer);
+                buffer.disconnect();
+            },
+        };
+    }
+    _createVaoRuntime(connection) {
+        let appliedVersion = -1;
+        return {
+            bind: (vao) => {
+                const gl = connection.gl;
+                gl.bindVertexArray(connection.vaoHandle);
+                if (appliedVersion !== vao.version) {
+                    let lastBuffer = null;
+                    for (const attribute of vao.attributes) {
+                        if (lastBuffer !== attribute.buffer) {
+                            attribute.buffer.bind();
+                            lastBuffer = attribute.buffer;
+                        }
+                        if (attribute.integer) {
+                            gl.vertexAttribIPointer(attribute.location, attribute.size, attribute.type, attribute.stride, attribute.start);
+                        }
+                        else {
+                            gl.vertexAttribPointer(attribute.location, attribute.size, attribute.type, attribute.normalized, attribute.stride, attribute.start);
+                        }
+                        gl.enableVertexAttribArray(attribute.location);
+                        gl.vertexAttribDivisor(attribute.location, attribute.divisor);
+                    }
+                    appliedVersion = vao.version;
+                }
+            },
+            unbind: () => {
+                connection.gl.bindVertexArray(null);
+            },
+            draw: (vao, size, start, type) => {
+                connection.gl.drawArrays(type, start, size);
+            },
+            drawInstanced: (_vao, count, start, instanceCount, type) => {
+                connection.gl.drawArraysInstanced(type, start, count, instanceCount);
+            },
+            destroy: (vao) => {
+                connection.gl.deleteVertexArray(connection.vaoHandle);
+                vao.disconnect();
+            },
+        };
     }
 }
 

package/dist/esm/rendering/webgl2/WebGl2SpriteRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebGl2SpriteRenderer.js","sources":["../../../../../src/rendering/webgl2/WebGl2SpriteRenderer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"WebGl2SpriteRenderer.js","sources":["../../../../../src/rendering/webgl2/WebGl2SpriteRenderer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/webgl2/WebGl2VertexArrayObject.d.ts

@@ -9,11 +9,33 @@ interface VaoAttribute {
     readonly normalized: boolean;
     readonly stride: number;
     readonly start: number;
+    /**
+     * When true, the attribute is bound via `vertexAttribIPointer` so the
+     * shader receives the raw integer value (not normalised, not converted
+     * to float). Used for `uint`/`ivec`-typed shader inputs such as a
+     * batched-sprite texture-slot index.
+     */
+    readonly integer: boolean;
+    /**
+     * Vertex-attribute divisor passed to `gl.vertexAttribDivisor`. Zero
+     * means per-vertex (the default). One means per-instance — the
+     * attribute advances once per drawArraysInstanced / drawElementsInstanced
+     * instance instead of once per vertex.
+     */
+    readonly divisor: number;
 }
 export interface WebGl2VertexArrayObjectRuntime {
     bind(vao: WebGl2VertexArrayObject): void;
     unbind(vao: WebGl2VertexArrayObject): void;
     draw(vao: WebGl2VertexArrayObject, size: number, start: number, type: RenderingPrimitives): void;
+    /**
+     * Instanced draw — `count` vertices/indices replicated `instanceCount`
+     * times. Per-vertex attributes (divisor 0) are shared across instances;
+     * per-instance attributes (divisor 1) advance once per instance.
+     * Optional: runtimes that don't drive instanced rendering can omit this
+     * and the VAO's `drawInstanced()` then no-ops via the optional-chain.
+     */
+    drawInstanced?(vao: WebGl2VertexArrayObject, count: number, start: number, instanceCount: number, type: RenderingPrimitives): void;
     destroy(vao: WebGl2VertexArrayObject): void;
 }
 export declare class WebGl2VertexArrayObject {
@@ -31,10 +53,11 @@ export declare class WebGl2VertexArrayObject {
     disconnect(): this;
     bind(): this;
     unbind(): this;
-    addAttribute(buffer: WebGl2RenderBuffer, attribute: ShaderAttribute, type?: number, normalized?: boolean, stride?: number, start?: number): this;
+    addAttribute(buffer: WebGl2RenderBuffer, attribute: ShaderAttribute, type?: number, normalized?: boolean, stride?: number, start?: number, integer?: boolean, divisor?: number): this;
     addIndex(buffer: WebGl2RenderBuffer): this;
     clear(): this;
     draw(size: number, start: number, type?: RenderingPrimitives): this;
+    drawInstanced(count: number, start: number, instanceCount: number, type?: RenderingPrimitives): this;
     destroy(): void;
 }
 export {};

package/dist/esm/rendering/webgl2/WebGl2VertexArrayObject.js

@@ -37,9 +37,9 @@ class WebGl2VertexArrayObject {
         this._runtime?.unbind(this);
         return this;
     }
-    addAttribute(buffer, attribute, type = ShaderPrimitives.Float, normalized = false, stride = 0, start = 0) {
+    addAttribute(buffer, attribute, type = ShaderPrimitives.Float, normalized = false, stride = 0, start = 0, integer = false, divisor = 0) {
         const { location, size } = attribute;
-        this._attributes.push({ buffer, location, size, type, normalized, stride, start });
+        this._attributes.push({ buffer, location, size, type, normalized, stride, start, integer, divisor });
         this._version++;
         return this;
     }
@@ -58,6 +58,10 @@ class WebGl2VertexArrayObject {
         this._runtime?.draw(this, size, start, type);
         return this;
     }
+    drawInstanced(count, start, instanceCount, type = this._drawMode) {
+        this._runtime?.drawInstanced?.(this, count, start, instanceCount, type);
+        return this;
+    }
     destroy() {
         this._runtime?.destroy(this);
         this._runtime = null;