@codexo/exojs 0.8.4 → 0.10.0

package/dist/esm/rendering/gradient/Gradient.js

@@ -0,0 +1,114 @@
+import { clamp } from '../../math/utils.js';
+import { DataTexture } from '../texture/DataTexture.js';
+
+const sortedStopOffset = (left, right) => left.offset - right.offset;
+/**
+ * CPU-rasterized gradient base that can be converted into a {@link DataTexture}.
+ */
+class Gradient {
+    _stops;
+    _sample = new Float32Array(4);
+    constructor(stops) {
+        if (stops.length < 2) {
+            throw new Error('Gradient requires at least 2 color stops.');
+        }
+        this._stops = [...stops].map(stop => ({ offset: clamp(stop.offset, 0, 1), color: stop.color.clone() })).sort(sortedStopOffset);
+    }
+    get stops() {
+        return this._stops;
+    }
+    toTexture(width, height, options = {}) {
+        if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
+            throw new Error('Gradient.toTexture() width/height must be positive integers.');
+        }
+        if (options.format === 'rgba32f') {
+            return this._toRgba32fTexture(width, height, options);
+        }
+        return this._toRgba8Texture(width, height, options);
+    }
+    destroy() {
+        for (const stop of this._stops) {
+            stop.color.destroy();
+        }
+        this._stops = [];
+    }
+    /**
+     * Shared stop sampling logic ported from the legacy GLSL implementation.
+     */
+    sampleAt(t, out) {
+        const clamped = clamp(t, 0, 1);
+        const first = this._stops[0];
+        let previousOffset = first.offset;
+        let previousColor = first.color;
+        for (let i = 1; i < this._stops.length; i++) {
+            const current = this._stops[i];
+            if (clamped <= current.offset) {
+                const span = Math.max(current.offset - previousOffset, 0.000001);
+                const ratio = clamp((clamped - previousOffset) / span, 0, 1);
+                out[0] = previousColor.r / 255 + (current.color.r / 255 - previousColor.r / 255) * ratio;
+                out[1] = previousColor.g / 255 + (current.color.g / 255 - previousColor.g / 255) * ratio;
+                out[2] = previousColor.b / 255 + (current.color.b / 255 - previousColor.b / 255) * ratio;
+                out[3] = previousColor.a + (current.color.a - previousColor.a) * ratio;
+                return;
+            }
+            previousOffset = current.offset;
+            previousColor = current.color;
+        }
+        out[0] = previousColor.r / 255;
+        out[1] = previousColor.g / 255;
+        out[2] = previousColor.b / 255;
+        out[3] = previousColor.a;
+    }
+    _toRgba8Texture(width, height, options) {
+        const texture = new DataTexture({
+            width,
+            height,
+            format: 'rgba8',
+            samplerOptions: options.samplerOptions,
+        });
+        const buffer = texture.buffer;
+        let offset = 0;
+        for (let y = 0; y < height; y++) {
+            const v = height === 1 ? 0 : y / (height - 1);
+            for (let x = 0; x < width; x++) {
+                const u = width === 1 ? 0 : x / (width - 1);
+                this.sampleAt(this.resolveT(u, v), this._sample);
+                buffer[offset] = toUnorm8(this._sample[0]);
+                buffer[offset + 1] = toUnorm8(this._sample[1]);
+                buffer[offset + 2] = toUnorm8(this._sample[2]);
+                buffer[offset + 3] = toUnorm8(this._sample[3]);
+                offset += 4;
+            }
+        }
+        texture.commit();
+        return texture;
+    }
+    _toRgba32fTexture(width, height, options) {
+        const texture = new DataTexture({
+            width,
+            height,
+            format: 'rgba32f',
+            samplerOptions: options.samplerOptions,
+        });
+        const buffer = texture.buffer;
+        let offset = 0;
+        for (let y = 0; y < height; y++) {
+            const v = height === 1 ? 0 : y / (height - 1);
+            for (let x = 0; x < width; x++) {
+                const u = width === 1 ? 0 : x / (width - 1);
+                this.sampleAt(this.resolveT(u, v), this._sample);
+                buffer[offset] = this._sample[0];
+                buffer[offset + 1] = this._sample[1];
+                buffer[offset + 2] = this._sample[2];
+                buffer[offset + 3] = this._sample[3];
+                offset += 4;
+            }
+        }
+        texture.commit();
+        return texture;
+    }
+}
+const toUnorm8 = (value) => (clamp(value, 0, 1) * 255 + 0.5) | 0;
+
+export { Gradient };
+//# sourceMappingURL=Gradient.js.map

package/dist/esm/rendering/gradient/Gradient.js.map

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

package/dist/esm/rendering/gradient/LinearGradient.d.ts

@@ -0,0 +1,10 @@
+import { Gradient, type GradientStop } from './Gradient';
+/**
+ * Linear gradient in UV space projected from `start` to `end`.
+ */
+export declare class LinearGradient extends Gradient {
+    private readonly _start;
+    private readonly _end;
+    constructor(stops: readonly GradientStop[], start?: readonly [number, number], end?: readonly [number, number]);
+    protected resolveT(u: number, v: number): number;
+}

package/dist/esm/rendering/gradient/LinearGradient.js

@@ -0,0 +1,26 @@
+import { Gradient } from './Gradient.js';
+
+/**
+ * Linear gradient in UV space projected from `start` to `end`.
+ */
+class LinearGradient extends Gradient {
+    _start;
+    _end;
+    constructor(stops, start = [0, 0], end = [1, 0]) {
+        super(stops);
+        this._start = [start[0], start[1]];
+        this._end = [end[0], end[1]];
+    }
+    resolveT(u, v) {
+        const axisX = this._end[0] - this._start[0];
+        const axisY = this._end[1] - this._start[1];
+        const lengthSquared = axisX * axisX + axisY * axisY;
+        if (lengthSquared <= 0.000001) {
+            return 0;
+        }
+        return ((u - this._start[0]) * axisX + (v - this._start[1]) * axisY) / lengthSquared;
+    }
+}
+
+export { LinearGradient };
+//# sourceMappingURL=LinearGradient.js.map

package/dist/esm/rendering/gradient/LinearGradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinearGradient.js","sources":["../../../../../src/rendering/gradient/LinearGradient.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;AAEG;AACG,MAAO,cAAe,SAAQ,QAAQ,CAAA;AACzB,IAAA,MAAM;AACN,IAAA,IAAI;AAErB,IAAA,WAAA,CAAmB,KAA8B,EAAE,KAAA,GAAmC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAA,GAAiC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAA;QACnI,KAAK,CAAC,KAAK,CAAC;AAEZ,QAAA,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAClC,QAAA,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9B;IAEmB,QAAQ,CAAC,CAAS,EAAE,CAAS,EAAA;AAC9C,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3C,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK;AAEnD,QAAA,IAAI,aAAa,IAAI,QAAQ,EAAE;AAC7B,YAAA,OAAO,CAAC;QACV;AAEA,QAAA,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,aAAa;IACtF;AACD;;;;"}

package/dist/esm/rendering/gradient/RadialGradient.d.ts

@@ -0,0 +1,10 @@
+import { Gradient, type GradientStop } from './Gradient';
+/**
+ * Radial gradient in UV space around `center` with normalized radius.
+ */
+export declare class RadialGradient extends Gradient {
+    private readonly _center;
+    private readonly _radius;
+    constructor(stops: readonly GradientStop[], center?: readonly [number, number], radius?: number);
+    protected resolveT(u: number, v: number): number;
+}

package/dist/esm/rendering/gradient/RadialGradient.js

@@ -0,0 +1,25 @@
+import { Gradient } from './Gradient.js';
+
+/**
+ * Radial gradient in UV space around `center` with normalized radius.
+ */
+class RadialGradient extends Gradient {
+    _center;
+    _radius;
+    constructor(stops, center = [0.5, 0.5], radius = 0.5) {
+        super(stops);
+        this._center = [center[0], center[1]];
+        this._radius = Math.max(0, radius);
+    }
+    resolveT(u, v) {
+        if (this._radius <= 0.000001) {
+            return 1;
+        }
+        const dx = u - this._center[0];
+        const dy = v - this._center[1];
+        return Math.sqrt(dx * dx + dy * dy) / this._radius;
+    }
+}
+
+export { RadialGradient };
+//# sourceMappingURL=RadialGradient.js.map

package/dist/esm/rendering/gradient/RadialGradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadialGradient.js","sources":["../../../../../src/rendering/gradient/RadialGradient.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;AAEG;AACG,MAAO,cAAe,SAAQ,QAAQ,CAAA;AACzB,IAAA,OAAO;AACP,IAAA,OAAO;IAExB,WAAA,CAAmB,KAA8B,EAAE,MAAA,GAAoC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,EAAA;QAC7G,KAAK,CAAC,KAAK,CAAC;AAEZ,QAAA,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC;IACpC;IAEmB,QAAQ,CAAC,CAAS,EAAE,CAAS,EAAA;AAC9C,QAAA,IAAI,IAAI,CAAC,OAAO,IAAI,QAAQ,EAAE;AAC5B,YAAA,OAAO,CAAC;QACV;QAEA,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAE9B,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO;IACpD;AACD;;;;"}

package/dist/esm/rendering/index.d.ts

@@ -1,59 +1,103 @@
-export * from './CallbackRenderPass';
-export * from './Container';
-export * from './Drawable';
-export * from './filters/BlurFilter';
-export * from './filters/ColorFilter';
-export * from './filters/Filter';
-export * from './filters/LutFilter';
-export * from './filters/WebGl2ShaderFilter';
-export * from './filters/WebGpuShaderFilter';
-export * from './mesh/Mesh';
-export * from './mesh/MeshShader';
-export * from './primitives/Graphics';
-export * from './RenderBackend';
-export * from './RenderBackendType';
-export * from './Renderer';
-export * from './RendererRegistry';
-export * from './RenderNode';
-export * from './RenderPass';
-export * from './RenderStats';
-export * from './RenderTarget';
-export * from './RenderTargetPass';
-export * from './shader/Shader';
-export * from './shader/ShaderAttribute';
-export * from './shader/ShaderUniform';
-export * from './shader/upgradeFragmentShaderToGl300';
-export * from './sprite/AnimatedSprite';
-export * from './sprite/Sprite';
-export * from './sprite/Spritesheet';
-export * from './text/DynamicGlyphAtlas';
-export * from './text/Text';
-export * from './text/TextLayout';
-export * from './text/TextStyle';
-export * from './text/types';
-export * from './texture/DataTexture';
-export * from './texture/RenderTexture';
-export * from './texture/Sampler';
-export * from './texture/Texture';
-export * from './types';
-export * from './video/Video';
-export * from './View';
-export * from './webgl2/AbstractWebGl2BatchedRenderer';
-export * from './webgl2/AbstractWebGl2Renderer';
-export type { WebGl2Backend } from './webgl2/WebGl2Backend';
-export * from './webgl2/WebGl2Backend';
-export * from './webgl2/WebGl2MeshRenderer';
-export * from './webgl2/WebGl2ParticleRenderer';
-export * from './webgl2/WebGl2RenderBuffer';
-export * from './webgl2/WebGl2ShaderBlock';
-export * from './webgl2/WebGl2ShaderMappings';
-export * from './webgl2/WebGl2ShaderProgram';
-export * from './webgl2/WebGl2SpriteRenderer';
-export * from './webgl2/WebGl2VertexArrayObject';
-export * from './webgpu/AbstractWebGpuRenderer';
-export type { WebGpuBackend } from './webgpu/WebGpuBackend';
-export * from './webgpu/WebGpuBackend';
-export * from './webgpu/WebGpuBlendState';
-export * from './webgpu/WebGpuMeshRenderer';
-export * from './webgpu/WebGpuParticleRenderer';
-export * from './webgpu/WebGpuSpriteRenderer';
+export { CallbackRenderPass } from './CallbackRenderPass';
+export type { CameraOptions } from './Camera';
+export { Camera } from './Camera';
+export { Container } from './Container';
+export { Drawable } from './Drawable';
+export type { BlurFilterOptions } from './filters/BlurFilter';
+export { BlurFilter } from './filters/BlurFilter';
+export { ColorFilter } from './filters/ColorFilter';
+export { Filter } from './filters/Filter';
+export type { LutFilterOptions, LutMode } from './filters/LutFilter';
+export { LutFilter } from './filters/LutFilter';
+export type { ShaderFilterUniformValue, WebGl2ShaderFilterOptions } from './filters/WebGl2ShaderFilter';
+export { WebGl2ShaderFilter } from './filters/WebGl2ShaderFilter';
+export type { WebGpuShaderFilterOptions } from './filters/WebGpuShaderFilter';
+export { WebGpuShaderFilter } from './filters/WebGpuShaderFilter';
+export { Geometry } from './geometry/Geometry';
+export type { AttributeType, GeometryAttribute, GeometryOptions, GeometryUsage, Topology } from './geometry/GeometryAttribute';
+export type { GradientStop, GradientToTextureOptions } from './gradient/Gradient';
+export { Gradient } from './gradient/Gradient';
+export { LinearGradient } from './gradient/LinearGradient';
+export { RadialGradient } from './gradient/RadialGradient';
+export type { MaterialOptions, UniformValue } from './material/Material';
+export { Material } from './material/Material';
+export { MeshMaterial } from './material/MeshMaterial';
+export type { ShaderSourceOptions } from './material/ShaderSource';
+export { ShaderSource } from './material/ShaderSource';
+export { SpriteMaterial } from './material/SpriteMaterial';
+export type { MeshOptions } from './mesh/Mesh';
+export { Mesh } from './mesh/Mesh';
+export { Graphics } from './primitives/Graphics';
+export type { RenderBackend } from './RenderBackend';
+export { RenderBackendType } from './RenderBackendType';
+export type { DrawableConstructor, Renderer } from './Renderer';
+export { RendererRegistry } from './RendererRegistry';
+export type { RenderOptions, RenderToOptions } from './RenderingContext';
+export { RenderingContext } from './RenderingContext';
+export type { MaskSource } from './RenderNode';
+export { RenderNode } from './RenderNode';
+export type { RenderPass } from './RenderPass';
+export type { RenderStats } from './RenderStats';
+export { createRenderStats, resetRenderStats } from './RenderStats';
+export { RenderTarget } from './RenderTarget';
+export type { RenderTargetPassOptions } from './RenderTargetPass';
+export { RenderTargetPass } from './RenderTargetPass';
+export type { ShaderProgram } from './shader/Shader';
+export { Shader } from './shader/Shader';
+export { ShaderAttribute } from './shader/ShaderAttribute';
+export { ShaderUniform } from './shader/ShaderUniform';
+export { upgradeFragmentShaderToGl300 } from './shader/upgradeFragmentShaderToGl300';
+export type { AnimatedSpriteClipDefinition, AnimatedSpritePlayOptions } from './sprite/AnimatedSprite';
+export { AnimatedSprite } from './sprite/AnimatedSprite';
+export { Sprite, SpriteFlags } from './sprite/Sprite';
+export type { SpritesheetData, SpritesheetFrame } from './sprite/Spritesheet';
+export { Spritesheet } from './sprite/Spritesheet';
+export { AbstractText } from './text/AbstractText';
+export type { BitmapTextOptions } from './text/BitmapText';
+export { BitmapText, BmFontAdapter } from './text/BitmapText';
+export type { BmFontChar, BmFontData } from './text/BmFont';
+export { BmFont } from './text/BmFont';
+export type { AtlasMode } from './text/GlyphAtlas';
+export { AtlasPage, GlyphAtlas, SDF_RADIUS } from './text/GlyphAtlas';
+export { getDefaultGlyphAtlasPool, GlyphAtlasPool, resetDefaultGlyphAtlasPool } from './text/GlyphAtlasPool';
+export type { FontFormat, HTMLTextOptions } from './text/HTMLText';
+export { HTMLText } from './text/HTMLText';
+export type { LayoutOptions } from './text/LayoutOptions';
+export { Text } from './text/Text';
+export { buildTextPageQuads, layoutText, measureText } from './text/TextLayout';
+export type { FontFamily, FontRegistry, FontWeight, GradientAxis, StyleChangeHint, TextStyleOptions } from './text/TextStyle';
+export { TextStyle } from './text/TextStyle';
+export type { GlyphInfo, GlyphKey, GlyphPlacement, GlyphProvider, TextAlignment, TextLayoutStyle, TextPageQuads, TextSize } from './text/types';
+export type { DataTextureBuffer, DataTextureDirtyRegion, DataTextureFormat, DataTextureOptions } from './texture/DataTexture';
+export { DataTexture } from './texture/DataTexture';
+export { RenderTexture } from './texture/RenderTexture';
+export type { SamplerOptions } from './texture/Sampler';
+export { Sampler } from './texture/Sampler';
+export { Texture } from './texture/Texture';
+export { BlendModes, BufferTypes, BufferUsage, RenderingPrimitives, ScaleModes, ShaderPrimitives, WrapModes } from './types';
+export { Video } from './video/Video';
+export type { ViewFollowOptions, ViewFollowTarget, ViewShakeOptions } from './View';
+export { View, ViewFlags } from './View';
+export { AbstractWebGl2BatchedRenderer } from './webgl2/AbstractWebGl2BatchedRenderer';
+export { AbstractWebGl2Renderer } from './webgl2/AbstractWebGl2Renderer';
+export { WebGl2Backend } from './webgl2/WebGl2Backend';
+export { WebGl2MeshRenderer } from './webgl2/WebGl2MeshRenderer';
+export { WebGl2ParticleRenderer } from './webgl2/WebGl2ParticleRenderer';
+export type { WebGl2RenderBufferRuntime } from './webgl2/WebGl2RenderBuffer';
+export { WebGl2RenderBuffer } from './webgl2/WebGl2RenderBuffer';
+export { WebGl2ShaderBlock } from './webgl2/WebGl2ShaderBlock';
+export { webGl2PrimitiveArrayConstructors, webGl2PrimitiveByteSizeMapping, webGl2PrimitiveTypeNames } from './webgl2/WebGl2ShaderMappings';
+export { createWebGl2ShaderProgram } from './webgl2/WebGl2ShaderProgram';
+export { WebGl2SpriteRenderer } from './webgl2/WebGl2SpriteRenderer';
+export { WebGl2TextRenderer } from './webgl2/WebGl2TextRenderer';
+export type { WebGl2VertexArrayObjectRuntime } from './webgl2/WebGl2VertexArrayObject';
+export { WebGl2VertexArrayObject } from './webgl2/WebGl2VertexArrayObject';
+export { AbstractWebGpuRenderer } from './webgpu/AbstractWebGpuRenderer';
+export type { ComputeBinding } from './webgpu/compute';
+export { WebGpuComputePipeline, WebGpuStorageBuffer } from './webgpu/compute';
+export { WebGpuBackend } from './webgpu/WebGpuBackend';
+export { getWebGpuBlendState } from './webgpu/WebGpuBlendState';
+export { WebGpuMeshRenderer } from './webgpu/WebGpuMeshRenderer';
+export { WebGpuParticleRenderer } from './webgpu/WebGpuParticleRenderer';
+export { WebGpuSpriteRenderer } from './webgpu/WebGpuSpriteRenderer';
+export { WebGpuTextRenderer } from './webgpu/WebGpuTextRenderer';

package/dist/esm/rendering/material/Material.d.ts

@@ -0,0 +1,114 @@
+import type { RenderTexture } from '@/rendering/texture/RenderTexture';
+import type { SamplerOptions } from '@/rendering/texture/Sampler';
+import type { Texture } from '@/rendering/texture/Texture';
+import { BlendModes } from '@/rendering/types';
+import type { ShaderSource } from './ShaderSource';
+/**
+ * Value accepted by a material uniform. Scalars and small tuples
+ * auto-marshal to the appropriate `Float32Array`/`Int32Array` for the
+ * backend's uniform call. `Texture`/`RenderTexture` values are bound to
+ * texture slots starting at slot 1 — slot 0 is reserved for the drawable's
+ * own `texture`.
+ */
+export type UniformValue = number | readonly [number, number] | readonly [number, number, number] | readonly [number, number, number, number] | Float32Array | Int32Array | Texture | RenderTexture;
+/**
+ * Construction options shared by every {@link Material}.
+ *
+ * Only `shader` is required. Textures may be supplied either through the
+ * dedicated `textures` map or as texture-valued entries in `uniforms`;
+ * both are honoured by the bind-key derivation.
+ */
+export interface MaterialOptions {
+    /** GLSL/WGSL source pair backing this material. */
+    readonly shader: ShaderSource;
+    /** Initial uniform values; mutate per frame via {@link Material.uniforms}. */
+    readonly uniforms?: Record<string, UniformValue>;
+    /** Named texture bindings claimed in addition to the drawable's own texture. */
+    readonly textures?: Record<string, Texture | RenderTexture>;
+    /** Compositing blend mode; defaults to {@link BlendModes.Normal}. */
+    readonly blendMode?: BlendModes;
+    /**
+     * Backend-agnostic sampling state descriptor, or `null` to inherit the
+     * backend/texture default. Defaults to `null`.
+     */
+    readonly sampler?: SamplerOptions | null;
+}
+/**
+ * Describes the look of a renderable — shader, uniforms, textures, blend
+ * mode, and sampling state — independent of its geometry.
+ *
+ * A `Material` can be shared across many drawables; renderers cache
+ * compiled programs/pipelines keyed on {@link pipelineKey} and reuse
+ * bindings keyed on {@link bindKey}. Subclasses fix the {@link target}
+ * drawable class. Call {@link destroy} when the material is no longer
+ * needed to release the GPU resources cached on every backend it was used
+ * on.
+ *
+ * Both keys are derived live from the current material state, so they stay
+ * stable across repeated reads and change exactly when the relevant state
+ * changes — even when {@link uniforms}, {@link textures}, {@link blendMode},
+ * or {@link sampler} are mutated in place.
+ * @advanced
+ */
+export declare abstract class Material {
+    /** GLSL/WGSL source pair backing this material. */
+    readonly shader: ShaderSource;
+    /**
+     * Mutable user uniform values. Mutate between frames to drive animated
+     * effects; the renderer reads from this map every draw.
+     *
+     *   material.uniforms.u_time = performance.now() / 1000;
+     *   material.uniforms.u_color = [1, 0.5, 0, 1];
+     */
+    uniforms: Record<string, UniformValue>;
+    /** Named texture bindings claimed in addition to the drawable's own texture. */
+    textures: Record<string, Texture | RenderTexture>;
+    /** Compositing blend mode applied when drawing with this material. */
+    blendMode: BlendModes;
+    /** Backend-agnostic sampling state descriptor, or `null` for the default. */
+    sampler: SamplerOptions | null;
+    /** Which drawable class this material can serve; renderers check compatibility. */
+    abstract readonly target: 'mesh' | 'sprite';
+    private readonly _id;
+    private readonly _disposeCallbacks;
+    protected constructor(options: MaterialOptions);
+    /**
+     * Stable pipeline key: identical ⇒ same GPU pipeline/program can be used.
+     * Derived from shader identity, blend mode, and sampler state, and is
+     * independent of the owning material instance so identically configured
+     * materials share a pipeline. Drives grouping and the pipeline cache.
+     */
+    get pipelineKey(): number;
+    /**
+     * Stable bind key: identical ⇒ same bindings (textures unchanged). Derived
+     * from this material's identity and the identities of its bound textures.
+     * Changes when a texture is swapped; drives bind-group/slot reuse.
+     */
+    get bindKey(): number;
+    /**
+     * Set a uniform value. Equivalent to `material.uniforms[name] = value`,
+     * returned `this` for chaining.
+     */
+    setUniform(name: string, value: UniformValue): this;
+    /**
+     * Bind a named texture. Equivalent to `material.textures[name] = texture`,
+     * returned `this` for chaining.
+     */
+    setTexture(name: string, texture: Texture | RenderTexture): this;
+    /**
+     * Release GPU resources cached against this material on every backend
+     * that has compiled it. Safe to call multiple times. After destroy, the
+     * material can still be re-used — renderers recompile on next draw — but
+     * typical usage is to drop the reference.
+     */
+    destroy(): void;
+    /**
+     * Internal hook for renderers to register a per-material-instance cleanup
+     * callback (release compiled program, pipeline, or bind groups). The
+     * callback fires on {@link destroy}; renderers MUST also tolerate the
+     * material being garbage-collected without destroy ever being called.
+     *
+     * @internal
+     */
+    _onDispose(callback: () => void): void;
+}

package/dist/esm/rendering/material/Material.js

@@ -0,0 +1,111 @@
+import { BlendModes } from '../types.js';
+import { derivePipelineKey, deriveBindKey } from './MaterialKey.js';
+
+let nextMaterialId = 1;
+/**
+ * Describes the look of a renderable — shader, uniforms, textures, blend
+ * mode, and sampling state — independent of its geometry.
+ *
+ * A `Material` can be shared across many drawables; renderers cache
+ * compiled programs/pipelines keyed on {@link pipelineKey} and reuse
+ * bindings keyed on {@link bindKey}. Subclasses fix the {@link target}
+ * drawable class. Call {@link destroy} when the material is no longer
+ * needed to release the GPU resources cached on every backend it was used
+ * on.
+ *
+ * Both keys are derived live from the current material state, so they stay
+ * stable across repeated reads and change exactly when the relevant state
+ * changes — even when {@link uniforms}, {@link textures}, {@link blendMode},
+ * or {@link sampler} are mutated in place.
+ * @advanced
+ */
+class Material {
+    /** GLSL/WGSL source pair backing this material. */
+    shader;
+    /**
+     * Mutable user uniform values. Mutate between frames to drive animated
+     * effects; the renderer reads from this map every draw.
+     *
+     *   material.uniforms.u_time = performance.now() / 1000;
+     *   material.uniforms.u_color = [1, 0.5, 0, 1];
+     */
+    uniforms;
+    /** Named texture bindings claimed in addition to the drawable's own texture. */
+    textures;
+    /** Compositing blend mode applied when drawing with this material. */
+    blendMode;
+    /** Backend-agnostic sampling state descriptor, or `null` for the default. */
+    sampler;
+    _id;
+    _disposeCallbacks = new Set();
+    constructor(options) {
+        if (options.shader === undefined || options.shader === null) {
+            throw new Error('Material requires a `shader` ShaderSource.');
+        }
+        this.shader = options.shader;
+        this.uniforms = { ...(options.uniforms ?? {}) };
+        this.textures = { ...(options.textures ?? {}) };
+        this.blendMode = options.blendMode ?? BlendModes.Normal;
+        this.sampler = options.sampler ?? null;
+        this._id = nextMaterialId++;
+    }
+    /**
+     * Stable pipeline key: identical ⇒ same GPU pipeline/program can be used.
+     * Derived from shader identity, blend mode, and sampler state, and is
+     * independent of the owning material instance so identically configured
+     * materials share a pipeline. Drives grouping and the pipeline cache.
+     */
+    get pipelineKey() {
+        return derivePipelineKey(this.shader.id, this.blendMode, this.sampler);
+    }
+    /**
+     * Stable bind key: identical ⇒ same bindings (textures unchanged). Derived
+     * from this material's identity and the identities of its bound textures.
+     * Changes when a texture is swapped; drives bind-group/slot reuse.
+     */
+    get bindKey() {
+        return deriveBindKey(this._id, this.uniforms, this.textures);
+    }
+    /**
+     * Set a uniform value. Equivalent to `material.uniforms[name] = value`,
+     * returned `this` for chaining.
+     */
+    setUniform(name, value) {
+        this.uniforms[name] = value;
+        return this;
+    }
+    /**
+     * Bind a named texture. Equivalent to `material.textures[name] = texture`,
+     * returned `this` for chaining.
+     */
+    setTexture(name, texture) {
+        this.textures[name] = texture;
+        return this;
+    }
+    /**
+     * Release GPU resources cached against this material on every backend
+     * that has compiled it. Safe to call multiple times. After destroy, the
+     * material can still be re-used — renderers recompile on next draw — but
+     * typical usage is to drop the reference.
+     */
+    destroy() {
+        for (const callback of this._disposeCallbacks) {
+            callback();
+        }
+        this._disposeCallbacks.clear();
+    }
+    /**
+     * Internal hook for renderers to register a per-material-instance cleanup
+     * callback (release compiled program, pipeline, or bind groups). The
+     * callback fires on {@link destroy}; renderers MUST also tolerate the
+     * material being garbage-collected without destroy ever being called.
+     *
+     * @internal
+     */
+    _onDispose(callback) {
+        this._disposeCallbacks.add(callback);
+    }
+}
+
+export { Material };
+//# sourceMappingURL=Material.js.map

package/dist/esm/rendering/material/Material.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Material.js","sources":["../../../../../src/rendering/material/Material.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAoDA,IAAI,cAAc,GAAG,CAAC;AAEtB;;;;;;;;;;;;;;;;AAgBG;MACmB,QAAQ,CAAA;;AAEZ,IAAA,MAAM;AAEtB;;;;;;AAMG;AACI,IAAA,QAAQ;;AAGR,IAAA,QAAQ;;AAGR,IAAA,SAAS;;AAGT,IAAA,OAAO;AAKG,IAAA,GAAG;AACH,IAAA,iBAAiB,GAAG,IAAI,GAAG,EAAc;AAE1D,IAAA,WAAA,CAAsB,OAAwB,EAAA;AAC5C,QAAA,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE;AAC3D,YAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC;QAC/D;AAEA,QAAA,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAC5B,QAAA,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE;AAC/C,QAAA,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE;QAC/C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,MAAM;QACvD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI;AACtC,QAAA,IAAI,CAAC,GAAG,GAAG,cAAc,EAAE;IAC7B;AAEA;;;;;AAKG;AACH,IAAA,IAAW,WAAW,GAAA;AACpB,QAAA,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;IACxE;AAEA;;;;AAIG;AACH,IAAA,IAAW,OAAO,GAAA;AAChB,QAAA,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;IAC9D;AAEA;;;AAGG;IACI,UAAU,CAAC,IAAY,EAAE,KAAmB,EAAA;AACjD,QAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK;AAE3B,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;IACI,UAAU,CAAC,IAAY,EAAE,OAAgC,EAAA;AAC9D,QAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO;AAE7B,QAAA,OAAO,IAAI;IACb;AAEA;;;;;AAKG;IACI,OAAO,GAAA;AACZ,QAAA,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,iBAAiB,EAAE;AAC7C,YAAA,QAAQ,EAAE;QACZ;AAEA,QAAA,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE;IAChC;AAEA;;;;;;;AAOG;AACI,IAAA,UAAU,CAAC,QAAoB,EAAA;AACpC,QAAA,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtC;AACD;;;;"}

package/dist/esm/rendering/material/MaterialKey.d.ts

@@ -0,0 +1,18 @@
+import type { RenderTexture } from '@/rendering/texture/RenderTexture';
+import type { SamplerOptions } from '@/rendering/texture/Sampler';
+import type { Texture } from '@/rendering/texture/Texture';
+import type { BlendModes } from '@/rendering/types';
+import type { UniformValue } from './Material';
+/**
+ * Pipeline key from shader identity, blend mode, and sampler state.
+ * @internal
+ */
+export declare const derivePipelineKey: (shaderId: number, blendMode: BlendModes, sampler: SamplerOptions | null) => number;
+/**
+ * Bind key from material identity and the identities of every bound
+ * texture, whether declared in the `textures` map or carried as a
+ * texture-valued uniform. Texture entries are sorted before joining so the
+ * descriptor is independent of insertion order.
+ * @internal
+ */
+export declare const deriveBindKey: (materialId: number, uniforms: Record<string, UniformValue>, textures: Record<string, Texture | RenderTexture>) => number;