@codexo/exojs 0.6.12 → 0.7.12

package/dist/esm/rendering/filters/BlurFilter.js.map

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

package/dist/esm/rendering/filters/ColorFilter.d.ts

@@ -2,6 +2,13 @@ import { Color } from '@/core/Color';
 import type { RenderTexture } from '@/rendering/texture/RenderTexture';
 import type { RenderBackend } from '@/rendering/RenderBackend';
 import { Filter } from './Filter';
+/**
+ * A {@link Filter} that multiplies the input texture by a solid {@link Color}.
+ *
+ * Useful for tinting, fade-to-black/white, flash effects, and
+ * colour-grading passes. The `color` property can be mutated at runtime
+ * without recreating the filter.
+ */
 export declare class ColorFilter extends Filter {
     private readonly _color;
     private readonly _sprite;

package/dist/esm/rendering/filters/ColorFilter.js

@@ -4,6 +4,13 @@ import { Sprite } from '../sprite/Sprite.js';
 import { RenderTargetPass } from '../RenderTargetPass.js';
 import { Filter } from './Filter.js';
 
+/**
+ * A {@link Filter} that multiplies the input texture by a solid {@link Color}.
+ *
+ * Useful for tinting, fade-to-black/white, flash effects, and
+ * colour-grading passes. The `color` property can be mutated at runtime
+ * without recreating the filter.
+ */
 class ColorFilter extends Filter {
     _color;
     _sprite = new Sprite(null);

package/dist/esm/rendering/filters/ColorFilter.js.map

@@ -1 +1 @@
-{"version":3,"file":"ColorFilter.js","sources":["../../../../../src/rendering/filters/ColorFilter.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAQM,MAAO,WAAY,SAAQ,MAAM,CAAA;AAElB,IAAA,MAAM;AACN,IAAA,OAAO,GAAW,IAAI,MAAM,CAAC,IAAI,CAAC;IAEnD,WAAA,CAAmB,KAAA,GAAe,KAAK,CAAC,KAAK,EAAA;AACzC,QAAA,KAAK,EAAE;AAEP,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE;IAC/B;AAEA,IAAA,IAAW,KAAK,GAAA;QACZ,OAAO,IAAI,CAAC,MAAM;IACtB;AAEO,IAAA,KAAK,CAAC,OAAsB,EAAE,KAAoB,EAAE,MAAqB,EAAA;AAC5E,QAAA,IAAI,CAAC;aACA,UAAU,CAAC,KAAK;AAChB,aAAA,YAAY,CAAC,UAAU,CAAC,MAAM;AAC9B,aAAA,OAAO,CAAC,IAAI,CAAC,MAAM;AACnB,aAAA,WAAW,CAAC,CAAC,EAAE,CAAC;aAChB,WAAW,CAAC,CAAC;AACb,aAAA,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;QAEnB,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;AAEnC,QAAA,OAAO,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAChC,MAAK;AACD,YAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AAChC,QAAA,CAAC,EACD;AACI,YAAA,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,KAAK,CAAC,gBAAgB;AACrC,SAAA,CACJ,CAAC;IACN;IAEO,OAAO,GAAA;AACV,QAAA,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;AACtB,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;IACzB;AACH;;;;"}
+{"version":3,"file":"ColorFilter.js","sources":["../../../../../src/rendering/filters/ColorFilter.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAQA;;;;;;AAMG;AACG,MAAO,WAAY,SAAQ,MAAM,CAAA;AAElB,IAAA,MAAM;AACN,IAAA,OAAO,GAAW,IAAI,MAAM,CAAC,IAAI,CAAC;IAEnD,WAAA,CAAmB,KAAA,GAAe,KAAK,CAAC,KAAK,EAAA;AACzC,QAAA,KAAK,EAAE;AAEP,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE;IAC/B;AAEA,IAAA,IAAW,KAAK,GAAA;QACZ,OAAO,IAAI,CAAC,MAAM;IACtB;AAEO,IAAA,KAAK,CAAC,OAAsB,EAAE,KAAoB,EAAE,MAAqB,EAAA;AAC5E,QAAA,IAAI,CAAC;aACA,UAAU,CAAC,KAAK;AAChB,aAAA,YAAY,CAAC,UAAU,CAAC,MAAM;AAC9B,aAAA,OAAO,CAAC,IAAI,CAAC,MAAM;AACnB,aAAA,WAAW,CAAC,CAAC,EAAE,CAAC;aAChB,WAAW,CAAC,CAAC;AACb,aAAA,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;QAEnB,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;AAEnC,QAAA,OAAO,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAChC,MAAK;AACD,YAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AAChC,QAAA,CAAC,EACD;AACI,YAAA,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,KAAK,CAAC,gBAAgB;AACrC,SAAA,CACJ,CAAC;IACN;IAEgB,OAAO,GAAA;AACnB,QAAA,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;AACtB,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;IACzB;AACH;;;;"}

package/dist/esm/rendering/filters/Filter.d.ts

@@ -1,5 +1,28 @@
 import type { RenderTexture } from '@/rendering/texture/RenderTexture';
 import type { RenderBackend } from '@/rendering/RenderBackend';
+/**
+ * Abstract base class for post-process filters applied to a drawable's
+ * render output.
+ *
+ * Filters are rendered into a temporary {@link RenderTexture} (the `output`)
+ * that is composited back onto the scene after all filters in the chain have
+ * been applied. Subclasses implement {@link apply} to run their shader pass.
+ * Stock implementations: {@link BlurFilter}, {@link ColorFilter}.
+ * User-supplied GLSL/WGSL shaders: {@link WebGl2ShaderFilter},
+ * {@link WebGpuShaderFilter}.
+ */
 export declare abstract class Filter {
+    /**
+     * Execute one filter pass: sample from `input`, write the result to
+     * `output`. Both textures are the same dimensions as the filtered drawable's
+     * bounding box.
+     */
     abstract apply(backend: RenderBackend, input: RenderTexture, output: RenderTexture): void;
+    /**
+     * Release any GPU-side resources held by this filter (uniform buffers,
+     * pipelines, intermediate textures). Default is a no-op for stateless
+     * filters; subclasses with state ({@link BlurFilter}, {@link ColorFilter})
+     * override.
+     */
+    destroy(): void;
 }

package/dist/esm/rendering/filters/Filter.js

@@ -1,4 +1,24 @@
+/**
+ * Abstract base class for post-process filters applied to a drawable's
+ * render output.
+ *
+ * Filters are rendered into a temporary {@link RenderTexture} (the `output`)
+ * that is composited back onto the scene after all filters in the chain have
+ * been applied. Subclasses implement {@link apply} to run their shader pass.
+ * Stock implementations: {@link BlurFilter}, {@link ColorFilter}.
+ * User-supplied GLSL/WGSL shaders: {@link WebGl2ShaderFilter},
+ * {@link WebGpuShaderFilter}.
+ */
 class Filter {
+    /**
+     * Release any GPU-side resources held by this filter (uniform buffers,
+     * pipelines, intermediate textures). Default is a no-op for stateless
+     * filters; subclasses with state ({@link BlurFilter}, {@link ColorFilter})
+     * override.
+     */
+    destroy() {
+        // no-op — subclasses with GPU state override
+    }
 }
 
 export { Filter };

package/dist/esm/rendering/filters/Filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Filter.js","sources":["../../../../../src/rendering/filters/Filter.ts"],"sourcesContent":[null],"names":[],"mappings":"MAGsB,MAAM,CAAA;AAM3B;;;;"}
+{"version":3,"file":"Filter.js","sources":["../../../../../src/rendering/filters/Filter.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;;;;;;;;;AAUG;MACmB,MAAM,CAAA;AAYxB;;;;;AAKG;IACI,OAAO,GAAA;;IAEd;AACH;;;;"}

package/dist/esm/rendering/filters/WebGl2ShaderFilter.d.ts

@@ -0,0 +1,114 @@
+import { Texture } from '@/rendering/texture/Texture';
+import type { RenderTexture } from '@/rendering/texture/RenderTexture';
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import { Filter } from './Filter';
+/**
+ * A scalar number, vector tuple, typed array, or texture. Both
+ * {@link WebGl2ShaderFilter} and {@link WebGpuShaderFilter} accept and
+ * marshal these value types.
+ */
+export type ShaderFilterUniformValue = number | readonly [number, number] | readonly [number, number, number] | readonly [number, number, number, number] | Float32Array | Int32Array | Texture | RenderTexture;
+export interface WebGl2ShaderFilterOptions {
+    /**
+     * GLSL fragment shader source. Required.
+     *
+     * The shader receives these auto-bound uniforms:
+     *   uniform sampler2D uTexture;     // the filter's input
+     *   uniform vec2 uResolution;        // output dimensions
+     *
+     * And these auto-bound varyings:
+     *   in vec2 vUv;                     // 0..1 across the quad
+     */
+    fragmentSource?: string;
+    /**
+     * GLSL vertex shader source. Optional; defaults to a pass-through
+     * fullscreen-quad shader.
+     */
+    vertexSource?: string;
+    /**
+     * Initial uniform values. Can be updated at runtime by writing
+     * to the `uniforms` property:
+     *
+     *   filter.uniforms.uTime = performance.now() / 1000;
+     */
+    uniforms?: Record<string, ShaderFilterUniformValue>;
+    /**
+     * Auto-upgrade legacy GLSL ES 1.00 fragment shader source to GLSL ES 3.00.
+     * Default `true` — accepts both Shadertoy/ISF/legacy shaders and modern
+     * 3.00 shaders interchangeably.
+     *
+     * Set to `false` if you want strict 3.00 input (will fail to compile if
+     * given 1.00-style code). Useful for CI/linting setups that want to catch
+     * legacy shader code as bugs.
+     *
+     * Note: only the fragment shader is upgraded. If you supply a 1.00-style
+     * vertex shader via `vertexSource`, you will get a compile error that
+     * must be fixed manually.
+     */
+    autoUpgrade?: boolean;
+}
+/**
+ * A high-level {@link Filter} subclass that renders the input texture
+ * through a user-provided GLSL fragment shader on the **WebGL2** backend.
+ *
+ * For the WebGPU backend use {@link WebGpuShaderFilter}.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * const filter = new WebGl2ShaderFilter({
+ *   fragmentSource: `
+ *     #version 300 es
+ *     precision mediump float;
+ *     uniform sampler2D uTexture;
+ *     uniform vec2 uResolution;
+ *     uniform float uTime;
+ *     in vec2 vUv;
+ *     out vec4 fragColor;
+ *     void main() {
+ *       fragColor = texture(uTexture, vUv);
+ *     }
+ *   `,
+ *   uniforms: { uTime: 0.0 },
+ * });
+ *
+ * // Update uniforms each frame:
+ * filter.uniforms.uTime = performance.now() / 1000;
+ * sprite.filters = [filter];
+ * ```
+ *
+ * ## Auto-bound uniforms
+ *
+ * The backend automatically sets `uTexture` (slot 0) and `uResolution`
+ * before each draw. User uniforms start at texture slot 1.
+ */
+export declare class WebGl2ShaderFilter extends Filter {
+    /**
+     * Mutable map of uniform values. Set values via property
+     * assignment; they are flushed to the GPU before each apply().
+     *
+     *   filter.uniforms.uTime = 1.234;
+     *   filter.uniforms.uColor = [1, 0.5, 0, 1];  // vec4
+     */
+    readonly uniforms: Record<string, ShaderFilterUniformValue>;
+    private readonly _fragmentSource;
+    private readonly _vertexSource;
+    private _shader;
+    private _connection;
+    constructor(options: WebGl2ShaderFilterOptions);
+    /**
+     * Execute the GLSL shader pass: compile the program on first call, bind
+     * uniforms, and render the input texture into `output`. Throws if the
+     * active backend is WebGPU — use {@link WebGpuShaderFilter} on WebGPU.
+     */
+    apply(backend: RenderBackend, input: RenderTexture, output: RenderTexture): void;
+    destroy(): void;
+    private _ensureConnected;
+    private _createVertexBuffer;
+    private _createVao;
+    /**
+     * Marshal a non-texture uniform value to a TypedArray suitable for
+     * {@link ShaderUniform#setValue}.
+     */
+    private _marshalValue;
+}

package/dist/esm/rendering/filters/WebGl2ShaderFilter.js

@@ -0,0 +1,273 @@
+import { Color } from '../../core/Color.js';
+import { Shader } from '../shader/Shader.js';
+import { RenderBackendType } from '../RenderBackendType.js';
+import { RenderTargetPass } from '../RenderTargetPass.js';
+import { RenderingPrimitives, BufferTypes, BufferUsage } from '../types.js';
+import { createWebGl2ShaderProgram } from '../webgl2/WebGl2ShaderProgram.js';
+import { WebGl2RenderBuffer } from '../webgl2/WebGl2RenderBuffer.js';
+import { WebGl2VertexArrayObject } from '../webgl2/WebGl2VertexArrayObject.js';
+import { Texture } from '../texture/Texture.js';
+import { upgradeFragmentShaderToGl300 } from '../shader/upgradeFragmentShaderToGl300.js';
+import { Filter } from './Filter.js';
+
+/**
+ * Default fullscreen-quad vertex shader. Positions are already in clip
+ * space (-1..1), so no projection matrix is needed.
+ */
+const defaultVertexSource = `#version 300 es
+in vec2 aPosition;
+in vec2 aUv;
+out vec2 vUv;
+void main() {
+    vUv = aUv;
+    gl_Position = vec4(aPosition, 0.0, 1.0);
+}
+`;
+/**
+ * Interleaved position+UV data for a fullscreen TRIANGLE_STRIP quad.
+ * Layout per vertex: [posX, posY, uvX, uvY]
+ *
+ * Vertices (clip-space positions, 0..1 UVs):
+ *   0: bottom-left  (-1, -1, 0, 0)
+ *   1: bottom-right ( 1, -1, 1, 0)
+ *   2: top-left     (-1,  1, 0, 1)
+ *   3: top-right    ( 1,  1, 1, 1)
+ */
+const quadVertices = new Float32Array([
+    -1, -1, 0, 0,
+    1, -1, 1, 0,
+    -1, 1, 0, 1,
+    1, 1, 1, 1,
+]);
+/** Bytes per vertex: 2 floats position + 2 floats UV = 16 bytes */
+const vertexStride = 16;
+/**
+ * A high-level {@link Filter} subclass that renders the input texture
+ * through a user-provided GLSL fragment shader on the **WebGL2** backend.
+ *
+ * For the WebGPU backend use {@link WebGpuShaderFilter}.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * const filter = new WebGl2ShaderFilter({
+ *   fragmentSource: `
+ *     #version 300 es
+ *     precision mediump float;
+ *     uniform sampler2D uTexture;
+ *     uniform vec2 uResolution;
+ *     uniform float uTime;
+ *     in vec2 vUv;
+ *     out vec4 fragColor;
+ *     void main() {
+ *       fragColor = texture(uTexture, vUv);
+ *     }
+ *   `,
+ *   uniforms: { uTime: 0.0 },
+ * });
+ *
+ * // Update uniforms each frame:
+ * filter.uniforms.uTime = performance.now() / 1000;
+ * sprite.filters = [filter];
+ * ```
+ *
+ * ## Auto-bound uniforms
+ *
+ * The backend automatically sets `uTexture` (slot 0) and `uResolution`
+ * before each draw. User uniforms start at texture slot 1.
+ */
+class WebGl2ShaderFilter extends Filter {
+    /**
+     * Mutable map of uniform values. Set values via property
+     * assignment; they are flushed to the GPU before each apply().
+     *
+     *   filter.uniforms.uTime = 1.234;
+     *   filter.uniforms.uColor = [1, 0.5, 0, 1];  // vec4
+     */
+    uniforms;
+    _fragmentSource;
+    _vertexSource;
+    _shader = null;
+    _connection = null;
+    constructor(options) {
+        super();
+        if (!options.fragmentSource) {
+            throw new Error('WebGl2ShaderFilter requires fragmentSource for the WebGL2 backend.');
+        }
+        const autoUpgrade = options.autoUpgrade !== false;
+        this._fragmentSource = autoUpgrade
+            ? upgradeFragmentShaderToGl300(options.fragmentSource)
+            : options.fragmentSource;
+        this._vertexSource = options.vertexSource ?? defaultVertexSource;
+        this.uniforms = { ...(options.uniforms ?? {}) };
+    }
+    /**
+     * Execute the GLSL shader pass: compile the program on first call, bind
+     * uniforms, and render the input texture into `output`. Throws if the
+     * active backend is WebGPU — use {@link WebGpuShaderFilter} on WebGPU.
+     */
+    apply(backend, input, output) {
+        if (backend.backendType === RenderBackendType.WebGpu) {
+            throw new Error('WebGl2ShaderFilter requires the WebGL2 backend. Use WebGpuShaderFilter on WebGPU.');
+        }
+        const gl2Backend = backend;
+        this._ensureConnected(gl2Backend);
+        const shader = this._shader;
+        backend.execute(new RenderTargetPass((b) => {
+            const gl2 = b;
+            // Bind shader (calls ShaderProgram.bind → gl.useProgram + sync dirty uniforms)
+            gl2.bindShader(shader);
+            // Auto-bind input texture to slot 0 (uTexture)
+            gl2.bindTexture(input, 0);
+            if (shader.uniforms.has('uTexture')) {
+                shader.getUniform('uTexture').setValue(new Int32Array([0]));
+            }
+            // Auto-bind uResolution
+            if (shader.uniforms.has('uResolution')) {
+                shader.getUniform('uResolution').setValue(new Float32Array([output.width, output.height]));
+            }
+            // Sync user uniforms — texture uniforms start at slot 1
+            let textureSlot = 1;
+            for (const [name, value] of Object.entries(this.uniforms)) {
+                if (!shader.uniforms.has(name)) {
+                    continue;
+                }
+                const uniform = shader.getUniform(name);
+                if (value instanceof Texture) {
+                    gl2.bindTexture(value, textureSlot);
+                    uniform.setValue(new Int32Array([textureSlot]));
+                    textureSlot++;
+                }
+                else {
+                    uniform.setValue(this._marshalValue(value));
+                }
+            }
+            // Flush dirty uniforms to the GPU
+            shader.sync();
+            // Draw the fullscreen quad
+            const connection = this._connection;
+            gl2.bindVertexArrayObject(connection.vao);
+            connection.vao.draw(4, 0, RenderingPrimitives.TriangleStrip);
+        }, {
+            target: output,
+            view: output.view,
+            clearColor: Color.transparentBlack,
+        }));
+    }
+    destroy() {
+        if (this._connection !== null) {
+            this._connection.vertexBuffer.destroy();
+            this._connection.vao.destroy();
+            this._connection = null;
+        }
+        if (this._shader !== null) {
+            this._shader.destroy();
+            this._shader = null;
+        }
+        for (const key of Object.keys(this.uniforms)) {
+            delete this.uniforms[key];
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    _ensureConnected(backend) {
+        if (this._shader !== null) {
+            return;
+        }
+        const gl = backend.context;
+        // Create and connect the shader
+        const shader = new Shader(this._vertexSource, this._fragmentSource);
+        shader.connect(createWebGl2ShaderProgram(gl));
+        // Force shader finalization so attributes are populated before VAO setup.
+        // sync() calls finalize() internally, which blocks until compilation is
+        // done and extracts attribute/uniform reflection data.
+        shader.sync();
+        // Build the fullscreen-quad vertex buffer (static, per-instance)
+        const vaoHandle = gl.createVertexArray();
+        if (vaoHandle === null) {
+            throw new Error('WebGl2ShaderFilter: could not create vertex array object.');
+        }
+        const vertexBuffer = this._createVertexBuffer(gl);
+        const vao = this._createVao(gl, vaoHandle, shader, vertexBuffer);
+        this._shader = shader;
+        this._connection = { gl, vertexBuffer, vao };
+    }
+    _createVertexBuffer(gl) {
+        const handle = gl.createBuffer();
+        if (handle === null) {
+            throw new Error('WebGl2ShaderFilter: could not create vertex buffer.');
+        }
+        const buffer = new WebGl2RenderBuffer(BufferTypes.ArrayBuffer, quadVertices, BufferUsage.StaticDraw);
+        buffer.connect({
+            bind: () => {
+                gl.bindBuffer(gl.ARRAY_BUFFER, handle);
+            },
+            upload: (buf, _offset) => {
+                gl.bindBuffer(gl.ARRAY_BUFFER, handle);
+                gl.bufferData(gl.ARRAY_BUFFER, buf.data, buf.usage);
+            },
+            destroy: (buf) => {
+                gl.deleteBuffer(handle);
+                buf.disconnect();
+            },
+        });
+        return buffer;
+    }
+    _createVao(gl, vaoHandle, shader, vertexBuffer) {
+        let appliedVersion = -1;
+        const vao = new WebGl2VertexArrayObject(RenderingPrimitives.TriangleStrip);
+        if (shader.attributes.has('aPosition')) {
+            vao.addAttribute(vertexBuffer, shader.getAttribute('aPosition'), gl.FLOAT, false, vertexStride, 0);
+        }
+        if (shader.attributes.has('aUv')) {
+            vao.addAttribute(vertexBuffer, shader.getAttribute('aUv'), gl.FLOAT, false, vertexStride, 8);
+        }
+        vao.connect({
+            bind: (v) => {
+                gl.bindVertexArray(vaoHandle);
+                if (appliedVersion !== v.version) {
+                    let lastBuffer = null;
+                    for (const attribute of v.attributes) {
+                        const buf = attribute.buffer;
+                        if (lastBuffer !== buf) {
+                            buf.bind();
+                            lastBuffer = buf;
+                        }
+                        gl.vertexAttribPointer(attribute.location, attribute.size, attribute.type, attribute.normalized, attribute.stride, attribute.start);
+                        gl.enableVertexAttribArray(attribute.location);
+                    }
+                    appliedVersion = v.version;
+                }
+            },
+            unbind: () => {
+                gl.bindVertexArray(null);
+            },
+            draw: (_v, size, start, type) => {
+                gl.drawArrays(type, start, size);
+            },
+            destroy: (v) => {
+                gl.deleteVertexArray(vaoHandle);
+                v.disconnect();
+            },
+        });
+        return vao;
+    }
+    /**
+     * Marshal a non-texture uniform value to a TypedArray suitable for
+     * {@link ShaderUniform#setValue}.
+     */
+    _marshalValue(value) {
+        if (value instanceof Float32Array || value instanceof Int32Array) {
+            return value;
+        }
+        if (typeof value === 'number') {
+            return new Float32Array([value]);
+        }
+        // readonly tuple [a, b], [a, b, c], or [a, b, c, d]
+        return new Float32Array(value);
+    }
+}
+
+export { WebGl2ShaderFilter };
+//# sourceMappingURL=WebGl2ShaderFilter.js.map

package/dist/esm/rendering/filters/WebGl2ShaderFilter.js.map

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

package/dist/esm/rendering/filters/WebGpuShaderFilter.d.ts

@@ -0,0 +1,116 @@
+import type { RenderTexture } from '@/rendering/texture/RenderTexture';
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import { Filter } from './Filter';
+import type { ShaderFilterUniformValue } from './WebGl2ShaderFilter';
+export type { ShaderFilterUniformValue };
+export interface WebGpuShaderFilterOptions {
+    /**
+     * WGSL source code for the fragment shader. Required.
+     *
+     * The shader receives these auto-bound entries via @group(0):
+     *   @group(0) @binding(0) var<uniform> uResolution: vec2<f32>;  // output dimensions
+     *   @group(0) @binding(1) var uTexture: texture_2d<f32>;
+     *   @group(0) @binding(2) var uSampler: sampler;
+     *
+     * User uniforms go in @group(1):
+     *   @group(1) @binding(0) var<uniform> uniforms: <UserUniformsStruct>;
+     *
+     * User uniforms are packed into a single uniform buffer with 16-byte
+     * alignment per member. Declare your WGSL struct to match this layout.
+     * Texture/RenderTexture uniforms are placed as separate bind group entries
+     * starting at @group(1) @binding(1).
+     */
+    fragmentSource: string;
+    /**
+     * WGSL source for the vertex shader. Optional; defaults to a fullscreen
+     * pass-through quad with a varying `vUv: vec2<f32>`.
+     */
+    vertexSource?: string;
+    /**
+     * Initial uniform values. Can be updated at runtime by writing
+     * to the `uniforms` property:
+     *
+     *   filter.uniforms.uTime = performance.now() / 1000;
+     */
+    uniforms?: Record<string, ShaderFilterUniformValue>;
+}
+/**
+ * A high-level {@link Filter} subclass that renders the input texture through
+ * a user-provided WGSL fragment shader on the **WebGPU** backend.
+ *
+ * For the WebGL2 backend use {@link WebGl2ShaderFilter}.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * const filter = new WebGpuShaderFilter({
+ *   fragmentSource: `
+ *     @group(0) @binding(0) var<uniform> uResolution: vec2<f32>;
+ *     @group(0) @binding(1) var uTexture: texture_2d<f32>;
+ *     @group(0) @binding(2) var uSampler: sampler;
+ *
+ *     @fragment
+ *     fn main(@location(0) vUv: vec2<f32>) -> @location(0) vec4<f32> {
+ *       return textureSample(uTexture, uSampler, vUv);
+ *     }
+ *   `,
+ *   uniforms: { uTime: 0.0 },
+ * });
+ *
+ * // Update uniforms each frame:
+ * filter.uniforms.uTime = performance.now() / 1000;
+ * sprite.filters = [filter];
+ * ```
+ *
+ * ## Auto-bound uniforms (group 0)
+ *
+ * - `@binding(0)` — `var<uniform> uResolution: vec2<f32>` (output dimensions)
+ * - `@binding(1)` — `var uTexture: texture_2d<f32>` (filter input)
+ * - `@binding(2)` — `var uSampler: sampler`
+ *
+ * ## User uniforms (group 1)
+ *
+ * All non-texture user uniforms are packed into a single uniform buffer at
+ * `@binding(0)`. Each member occupies a 16-byte aligned slot (conservative
+ * alignment). Declare your WGSL struct to match this layout.
+ *
+ * Texture/RenderTexture uniforms are bound as separate entries starting at
+ * `@binding(1)` (texture) and `@binding(N+1)` (sampler), in declaration order.
+ */
+export declare class WebGpuShaderFilter extends Filter {
+    /**
+     * Mutable map of uniform values. Set values via property assignment;
+     * they are flushed to the GPU before each apply().
+     *
+     *   filter.uniforms.uTime = 1.234;
+     *   filter.uniforms.uColor = [1, 0.5, 0, 1];  // vec4
+     */
+    readonly uniforms: Record<string, ShaderFilterUniformValue>;
+    private readonly _fragmentSource;
+    private readonly _vertexSource;
+    private _connection;
+    constructor(options: WebGpuShaderFilterOptions);
+    /**
+     * Execute the WGSL shader pass: flush uniforms, build bind groups, and
+     * render the input texture into `output`. Throws if the active backend is
+     * not WebGPU — use {@link WebGl2ShaderFilter} on WebGL2.
+     */
+    apply(backend: RenderBackend, input: RenderTexture, output: RenderTexture): void;
+    destroy(): void;
+    private _ensureConnected;
+    /**
+     * Build the GPUBindGroupLayout for group 1 (user uniforms).
+     *
+     * Layout:
+     *   binding 0 — uniform buffer (scalar/vector uniforms), if any scalar uniforms exist
+     *   binding 1, 3, 5, ... — texture entries (one per texture uniform, in order)
+     *   binding 2, 4, 6, ... — sampler entries (paired with textures)
+     */
+    private _buildUserBindGroupLayout;
+    /**
+     * Build and return the GPUBindGroup for group 1 on each frame.
+     * Marshals scalar uniforms into the user uniform buffer and assembles
+     * texture/sampler bind group entries.
+     */
+    private _buildUserBindGroup;
+}