@aura3d/rendering 3.0.1 → 4.0.2

package/dist/webgl2/Samplers.js

@@ -0,0 +1,179 @@
+// PR 0b-2 carve-out (CONTRACTS.md §3.3) — verbatim move from WebGL2Device.ts; 0 changed logic lines.
+import { RenderDeviceError } from "../RenderDevice.js";
+import { isCompressedTextureFormat, isFloatColorTextureFormat } from "../Texture.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { addressMode, magFilter, minFilter } from "./TextureFormats.js";
+import { rendererQrFlags } from "../renderer/FrameGraph.js";
+/** Mip levels the upload path will leave resident on the GPU (C-12 §semantics).
+ * `undefined` = mips are generated at upload (never "exactly one level"). */
+function textureResidentMipLevels(texture) {
+    if (!texture)
+        return undefined;
+    if (texture.dimension === "cube") {
+        return texture.cubeFaces[0]?.mipLevels.length ?? 0;
+    }
+    if (texture.mipLevels.length > 0)
+        return texture.mipLevels.length;
+    if (texture.source)
+        return undefined; // generateMipmap at upload
+    if (isCompressedTextureFormat(texture.format))
+        return texture.textureLevels.length;
+    // data/null-data 2D: float formats are pinned to level 0; the rest get
+    // generateMipmap on upload.
+    return isFloatColorTextureFormat(texture.format) ? 1 : undefined;
+}
+/** C-12: a texture with exactly one mip level downgrades `*-mipmap-*` to the
+ * matching non-mip filter so it never samples an incomplete texture. */
+function prd02EffectiveMinFilter(sampler, residentLevels) {
+    if (residentLevels !== 1)
+        return sampler.minFilter;
+    switch (sampler.minFilter) {
+        case "nearest-mipmap-nearest":
+        case "nearest-mipmap-linear":
+            return "nearest";
+        case "linear-mipmap-nearest":
+        case "linear-mipmap-linear":
+            return "linear";
+        default:
+            return sampler.minFilter;
+    }
+}
+function prd02SamplerEnabled() {
+    return rendererQrFlags().on("A3D_QR_LIGHTING");
+}
+export class WebGL2SamplerRegistry {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    activeTextureUnitIndex = -1;
+    samplerObjectCache = new Map();
+    textureSamplerParameterCache = new WeakMap();
+    textureUnitBindings = new Map();
+    uploadTextureUniform(location, binding, textureUnit, uniformType) {
+        const validation = binding.validate();
+        if (!validation.ok) {
+            throw new RenderDeviceError("Texture binding validation failed", "INVALID_TEXTURE_BINDING", {
+                diagnostics: validation.diagnostics,
+                name: binding.name
+            });
+        }
+        this.activateTextureUnit(textureUnit);
+        // `uniformType` arrives either as the GLSL type name (static shader
+        // reflection) or as a stringified GL enum (live getActiveUniform), e.g.
+        // "36289" for SAMPLER_2D_ARRAY, "36292"/"36293" for array/cube shadow,
+        // "36303"/"36311" for int/uint array samplers, "35682" for sampler2DShadow.
+        const declared = uniformType?.toLowerCase();
+        const dimension = declared === "sampler2darray" || declared === "isampler2darray" || declared === "usampler2darray" || declared === "36289" || declared === "36292" || declared === "36303" || declared === "36311"
+            ? "2d-array"
+            : declared === "samplercube" || declared === "isamplercube" || declared === "usamplercube" || declared === "samplercubeshadow" || declared === "35680" || declared === "36293"
+                ? "cube"
+                : declared === "sampler2dshadow" || declared === "sampler2d" || declared === "35682" || declared === "35678"
+                    ? "2d"
+                    : binding.texture?.dimension ?? (binding.name.toLowerCase().includes("cubemap") || binding.name.toLowerCase().includes("cube") ? "cube" : "2d");
+        // lane 06 Q-01-3: sampler2DArray uniforms bind to TEXTURE_2D_ARRAY units.
+        const target = dimension === "cube" ? this.host.gl.TEXTURE_CUBE_MAP : dimension === "2d-array" ? this.host.gl.TEXTURE_2D_ARRAY : this.host.gl.TEXTURE_2D;
+        const handle = binding.texture ? this.host.textureRegistry.getTextureHandle(binding.texture) : dimension === "cube" ? this.host.textureRegistry.getFallbackCubeTextureHandle() : dimension === "2d-array" ? this.host.textureRegistry.getFallbackTextureHandle() : this.host.textureRegistry.getFallbackTextureHandle();
+        if (binding.texture) {
+            const lowerName = binding.name.toLowerCase();
+            if (lowerName.includes("environment"))
+                this.host.counters.nativeEnvironmentBindings += 1;
+            if (lowerName.includes("shadow"))
+                this.host.counters.nativeShadowMapBindings += 1;
+        }
+        this.bindTextureForUnit(textureUnit, target, handle);
+        const samplerHandle = this.getSamplerHandle(binding.sampler, target, binding.texture ?? undefined);
+        this.host.stateCache.bindSampler(textureUnit, samplerHandle, () => this.host.gl.bindSampler(textureUnit, samplerHandle));
+        this.host.gl.uniform1i(location, textureUnit);
+    }
+    activateTextureUnit(textureUnit) {
+        if (this.activeTextureUnitIndex === textureUnit)
+            return;
+        this.host.stateCache.activeTexture(textureUnit, () => this.host.gl.activeTexture(this.host.gl.TEXTURE0 + textureUnit));
+        this.activeTextureUnitIndex = textureUnit;
+    }
+    bindTextureForUnit(textureUnit, target, handle) {
+        const key = `${textureUnit}:${target}`;
+        if (this.textureUnitBindings.get(key) === handle)
+            return;
+        this.host.stateCache.bindTexture(target, handle, () => this.host.gl.bindTexture(target, handle));
+        this.textureUnitBindings.set(key, handle);
+        this.host.counters.textureBindCount += 1;
+    }
+    setTextureParameterIfNeeded(handle, target, parameter, value) {
+        let parameters = this.textureSamplerParameterCache.get(handle);
+        if (!parameters) {
+            parameters = new Map();
+            this.textureSamplerParameterCache.set(handle, parameters);
+        }
+        if (parameters.get(parameter) === value)
+            return;
+        this.host.gl.texParameteri(target, parameter, value);
+        parameters.set(parameter, value);
+        this.host.counters.samplerParameterUploadCount += 1;
+    }
+    applySamplerAnisotropy(maxAnisotropy, target = this.host.gl.TEXTURE_2D) {
+        if (maxAnisotropy <= 1)
+            return;
+        if (!this.host.anisotropicFilteringExtension)
+            return;
+        this.host.gl.texParameterf(target, this.host.anisotropicFilteringExtension.TEXTURE_MAX_ANISOTROPY_EXT, Math.min(Math.max(1, maxAnisotropy), this.host.maxTextureAnisotropy));
+        this.host.counters.samplerAnisotropyUploadCount += 1;
+    }
+    getSamplerHandle(sampler, target, texture) {
+        const c12 = prd02SamplerEnabled();
+        const residentLevels = c12 ? textureResidentMipLevels(texture) : undefined;
+        const key = this.samplerKey(sampler, target, c12, residentLevels);
+        const cached = this.samplerObjectCache.get(key);
+        if (cached)
+            return cached;
+        const handle = this.host.gl.createSampler();
+        if (!handle) {
+            throw new RenderDeviceError("Failed to allocate WebGL sampler", "WEBGL_ALLOCATION_FAILED");
+        }
+        // C-12 (flag on): compare samplers force LINEAR so hardware PCF applies.
+        const compareOn = c12 && sampler.compare !== undefined;
+        const effectiveMin = c12
+            ? (compareOn ? "linear" : prd02EffectiveMinFilter(sampler, residentLevels))
+            : sampler.minFilter;
+        const effectiveMag = compareOn ? "linear" : sampler.magFilter;
+        this.host.gl.samplerParameteri(handle, this.host.gl.TEXTURE_MIN_FILTER, minFilter(this.host.gl, effectiveMin));
+        this.host.gl.samplerParameteri(handle, this.host.gl.TEXTURE_MAG_FILTER, magFilter(this.host.gl, effectiveMag));
+        const wrapSMode = c12 && sampler.mirror ? "mirror-repeat" : sampler.addressU;
+        const wrapTMode = c12 && sampler.mirror ? "mirror-repeat" : sampler.addressV;
+        this.host.gl.samplerParameteri(handle, this.host.gl.TEXTURE_WRAP_S, addressMode(this.host.gl, wrapSMode));
+        this.host.gl.samplerParameteri(handle, this.host.gl.TEXTURE_WRAP_T, addressMode(this.host.gl, wrapTMode));
+        this.host.counters.samplerParameterUploadCount += 4;
+        if (target === this.host.gl.TEXTURE_CUBE_MAP) {
+            const wrapRMode = c12 && sampler.mirror ? "mirror-repeat" : (c12 ? (sampler.addressW ?? sampler.addressV) : sampler.addressV);
+            this.host.gl.samplerParameteri(handle, this.host.gl.TEXTURE_WRAP_R, addressMode(this.host.gl, wrapRMode));
+            this.host.counters.samplerParameterUploadCount += 1;
+        }
+        if (compareOn) {
+            this.host.gl.samplerParameteri(handle, this.host.gl.TEXTURE_COMPARE_MODE, this.host.gl.COMPARE_REF_TO_TEXTURE);
+            this.host.gl.samplerParameteri(handle, this.host.gl.TEXTURE_COMPARE_FUNC, sampler.compare === "greater-equal" ? this.host.gl.GEQUAL : this.host.gl.LEQUAL);
+            this.host.counters.samplerParameterUploadCount += 2;
+        }
+        if (sampler.maxAnisotropy > 1 && this.host.anisotropicFilteringExtension) {
+            this.host.gl.samplerParameterf(handle, this.host.anisotropicFilteringExtension.TEXTURE_MAX_ANISOTROPY_EXT, Math.min(Math.max(1, sampler.maxAnisotropy), this.host.maxTextureAnisotropy));
+            this.host.counters.samplerAnisotropyUploadCount += 1;
+        }
+        this.samplerObjectCache.set(key, handle);
+        return handle;
+    }
+    samplerKey(sampler, target, c12 = prd02SamplerEnabled(), residentLevels) {
+        const key = [
+            sampler.minFilter,
+            sampler.magFilter,
+            sampler.addressU,
+            sampler.addressV,
+            sampler.maxAnisotropy,
+            target === this.host.gl.TEXTURE_CUBE_MAP ? "cube" : target === this.host.gl.TEXTURE_2D_ARRAY ? "2d-array" : "2d"
+        ];
+        if (c12) {
+            key.push(sampler.compare ?? "-", sampler.addressW ?? "-", sampler.mirror ? "m" : "-", residentLevels === 1 ? "1l" : "-");
+        }
+        return key.join("|");
+    }
+}
+//# sourceMappingURL=Samplers.js.map

package/dist/webgl2/Samplers.js.map

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

package/dist/webgl2/TextureFormats.d.ts

@@ -0,0 +1,48 @@
+import type { TextureMagFilter, TextureMinFilter } from "../Sampler.js";
+import { Texture, type TextureCompressedFormat, type TextureCubeFace } from "../Texture.js";
+export declare function cubeFaceTarget(gl: WebGL2RenderingContext, face: TextureCubeFace): GLenum;
+export declare function rgba8TextureInternalFormat(gl: WebGL2RenderingContext, texture: Texture): GLenum;
+export declare function textureUploadFormat(gl: WebGL2RenderingContext, texture: Texture): {
+    readonly internalFormat: GLenum;
+    readonly format: GLenum;
+    readonly type: GLenum;
+};
+/**
+ * Internalformat for `texStorage2D`/`texStorage3D` — the storage APIs require
+ * a *sized* internalformat, so linear `rgba8` must resolve to `RGBA8` (the
+ * `texImage2D` path keeps the unsized `RGBA` accepted by the spec).
+ */
+export declare function textureStorageInternalFormat(gl: WebGL2RenderingContext, texture: Texture): GLenum;
+export declare function resolveRenderTargetFormat(gl: WebGL2RenderingContext, format: "rgba8" | "rgba16f" | "rgba32f"): {
+    readonly internalFormat: GLenum;
+    readonly type: GLenum;
+};
+export declare function resolveCompressedTextureFormat(gl: WebGL2RenderingContext, format: TextureCompressedFormat): {
+    readonly internalFormat: GLenum;
+} | null;
+/**
+ * C-16 real: map a `TextureCompressedFormat` + colour space to a WebGL2
+ * internal-format enum, `null` when the backing extension is absent.
+ *   bc1/bc3 → WEBGL_compressed_texture_s3tc (sRGB needs _s3tc_srgb too)
+ *   bc7     → EXT_texture_compression_bptc
+ *   astc    → WEBGL_compressed_texture_astc
+ *   etc2    → core WebGL2 (the WEBGL_compressed_texture_etc gate only matters
+ *             on non-core contexts; on WebGL2 the formats are guaranteed)
+ */
+export declare function resolveCompressedTextureFormatReal(format: TextureCompressedFormat, colorSpace: "srgb" | "linear", gl: WebGL2RenderingContext): number | null;
+/**
+ * C-16 §7.4 probe: which compressed-texture families this context can consume.
+ * `etc2` is a WebGL2-core guarantee; the other four map 1:1 onto their
+ * WebGL extension objects (S3TC sRGB lives in its own extension).
+ */
+export declare function probeCompressedTextureCapabilities(gl: WebGL2RenderingContext): {
+    readonly astc: boolean;
+    readonly bptc: boolean;
+    readonly etc2: boolean;
+    readonly s3tc: boolean;
+    readonly s3tcSrgb: boolean;
+};
+export declare function magFilter(gl: WebGL2RenderingContext, filter: TextureMagFilter): GLenum;
+export declare function minFilter(gl: WebGL2RenderingContext, filter: TextureMinFilter): GLenum;
+export declare function addressMode(gl: WebGL2RenderingContext, mode: "clamp-to-edge" | "repeat" | "mirror-repeat"): GLenum;
+//# sourceMappingURL=TextureFormats.d.ts.map

package/dist/webgl2/TextureFormats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureFormats.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgl2/TextureFormats.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,KAAK,uBAAuB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzF,wBAAgB,cAAc,CAAC,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAStF;AAEH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7F;AAEH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqBnK;AAEH;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAKjG;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG;IAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAWvK;AAEH,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,uBAAuB,GAAG;IAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBpJ;AAeH;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,uBAAuB,EAC/B,UAAU,EAAE,MAAM,GAAG,QAAQ,EAC7B,EAAE,EAAE,sBAAsB,GACzB,MAAM,GAAG,IAAI,CAsCf;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,sBAAsB,GAAG;IAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAQA;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAEpF;AAEH,wBAAgB,SAAS,CAAC,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAepF;AAEH,wBAAgB,WAAW,CAAC,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,eAAe,GAAG,MAAM,CAIhH"}

package/dist/webgl2/TextureFormats.js

@@ -0,0 +1,185 @@
+// PR 0b-2 carve-out (CONTRACTS.md §3.3) — verbatim move from WebGL2Device.ts; 0 changed logic lines.
+import { RenderDeviceError } from "../RenderDevice.js";
+import { Texture } from "../Texture.js";
+export function cubeFaceTarget(gl, face) {
+    switch (face) {
+        case "px": return gl.TEXTURE_CUBE_MAP_POSITIVE_X;
+        case "nx": return gl.TEXTURE_CUBE_MAP_NEGATIVE_X;
+        case "py": return gl.TEXTURE_CUBE_MAP_POSITIVE_Y;
+        case "ny": return gl.TEXTURE_CUBE_MAP_NEGATIVE_Y;
+        case "pz": return gl.TEXTURE_CUBE_MAP_POSITIVE_Z;
+        case "nz": return gl.TEXTURE_CUBE_MAP_NEGATIVE_Z;
+    }
+}
+export function rgba8TextureInternalFormat(gl, texture) {
+    return texture.colorSpace === "srgb" ? gl.SRGB8_ALPHA8 : gl.RGBA;
+}
+export function textureUploadFormat(gl, texture) {
+    if (texture.format === "rgba8") {
+        return { internalFormat: rgba8TextureInternalFormat(gl, texture), format: gl.RGBA, type: gl.UNSIGNED_BYTE };
+    }
+    if (texture.colorSpace === "srgb") {
+        throw new RenderDeviceError("Floating-point texture uploads must use linear colorSpace", "UNSUPPORTED_TEXTURE_FORMAT", {
+            label: texture.label,
+            format: texture.format,
+            colorSpace: texture.colorSpace
+        });
+    }
+    if (texture.format === "rgba16f") {
+        return { internalFormat: gl.RGBA16F, format: gl.RGBA, type: gl.HALF_FLOAT };
+    }
+    if (texture.format === "rgba32f") {
+        return { internalFormat: gl.RGBA32F, format: gl.RGBA, type: gl.FLOAT };
+    }
+    throw new RenderDeviceError("Unsupported texture upload format", "UNSUPPORTED_TEXTURE_FORMAT", {
+        label: texture.label,
+        format: texture.format
+    });
+}
+/**
+ * Internalformat for `texStorage2D`/`texStorage3D` — the storage APIs require
+ * a *sized* internalformat, so linear `rgba8` must resolve to `RGBA8` (the
+ * `texImage2D` path keeps the unsized `RGBA` accepted by the spec).
+ */
+export function textureStorageInternalFormat(gl, texture) {
+    if (texture.format === "rgba8") {
+        return texture.colorSpace === "srgb" ? gl.SRGB8_ALPHA8 : gl.RGBA8;
+    }
+    return textureUploadFormat(gl, texture).internalFormat;
+}
+export function resolveRenderTargetFormat(gl, format) {
+    if (format === "rgba8") {
+        return { internalFormat: gl.RGBA, type: gl.UNSIGNED_BYTE };
+    }
+    if (!gl.getExtension("EXT_color_buffer_float")) {
+        throw new RenderDeviceError("Floating-point color render targets require EXT_color_buffer_float", "HDR_RENDER_TARGET_UNSUPPORTED", { format });
+    }
+    if (format === "rgba16f") {
+        return { internalFormat: gl.RGBA16F, type: gl.HALF_FLOAT };
+    }
+    return { internalFormat: gl.RGBA32F, type: gl.FLOAT };
+}
+export function resolveCompressedTextureFormat(gl, format) {
+    switch (format) {
+        case "bc1-rgba-unorm": {
+            const extension = gl.getExtension("WEBGL_compressed_texture_s3tc");
+            return extension ? { internalFormat: extension.COMPRESSED_RGBA_S3TC_DXT1_EXT } : null;
+        }
+        case "bc3-rgba-unorm": {
+            const extension = gl.getExtension("WEBGL_compressed_texture_s3tc");
+            return extension ? { internalFormat: extension.COMPRESSED_RGBA_S3TC_DXT5_EXT } : null;
+        }
+        case "etc2-rgba8unorm":
+            return { internalFormat: 0x9278 };
+        case "astc-4x4-rgba-unorm": {
+            const extension = gl.getExtension("WEBGL_compressed_texture_astc");
+            return extension ? { internalFormat: extension.COMPRESSED_RGBA_ASTC_4x4_KHR } : null;
+        }
+        default:
+            throw new Error(`UNSUPPORTED_COMPRESSED_FORMAT:${format}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// C-16 real implementation (PRD-05 Phase 1) — `resolveCompressedTextureFormatSlot`
+// provider. Adds the bc7/etc2-rgb8unorm members plus the sRGB internal-format
+// variants (sRGB × the DXT/ASTC/BPTC extension's sRGB constants); flag-off the
+// slot keeps serving the () => null stub so `resolveCompressedTextureFormat`
+// above is untouched.
+// ---------------------------------------------------------------------------
+const GL_COMPRESSED_RGB8_ETC2 = 0x9274;
+const GL_COMPRESSED_SRGB8_ETC2 = 0x9275;
+const GL_COMPRESSED_RGBA8_ETC2_EAC = 0x9278;
+const GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC = 0x9279;
+/**
+ * C-16 real: map a `TextureCompressedFormat` + colour space to a WebGL2
+ * internal-format enum, `null` when the backing extension is absent.
+ *   bc1/bc3 → WEBGL_compressed_texture_s3tc (sRGB needs _s3tc_srgb too)
+ *   bc7     → EXT_texture_compression_bptc
+ *   astc    → WEBGL_compressed_texture_astc
+ *   etc2    → core WebGL2 (the WEBGL_compressed_texture_etc gate only matters
+ *             on non-core contexts; on WebGL2 the formats are guaranteed)
+ */
+export function resolveCompressedTextureFormatReal(format, colorSpace, gl) {
+    const srgb = colorSpace === "srgb";
+    switch (format) {
+        case "bc1-rgba-unorm": {
+            const s3tc = gl.getExtension("WEBGL_compressed_texture_s3tc");
+            if (!s3tc)
+                return null;
+            if (srgb) {
+                const s3tcSrgb = gl.getExtension("WEBGL_compressed_texture_s3tc_srgb");
+                return s3tcSrgb ? s3tcSrgb.COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT : null;
+            }
+            return s3tc.COMPRESSED_RGBA_S3TC_DXT1_EXT;
+        }
+        case "bc3-rgba-unorm": {
+            const s3tc = gl.getExtension("WEBGL_compressed_texture_s3tc");
+            if (!s3tc)
+                return null;
+            if (srgb) {
+                const s3tcSrgb = gl.getExtension("WEBGL_compressed_texture_s3tc_srgb");
+                return s3tcSrgb ? s3tcSrgb.COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT : null;
+            }
+            return s3tc.COMPRESSED_RGBA_S3TC_DXT5_EXT;
+        }
+        case "bc7-rgba-unorm": {
+            const bptc = gl.getExtension("EXT_texture_compression_bptc");
+            if (!bptc)
+                return null;
+            return srgb ? bptc.COMPRESSED_SRGB_ALPHA_BPTC_UNORM_EXT : bptc.COMPRESSED_RGBA_BPTC_UNORM_EXT;
+        }
+        case "astc-4x4-rgba-unorm": {
+            const astc = gl.getExtension("WEBGL_compressed_texture_astc");
+            if (!astc)
+                return null;
+            return srgb ? astc.COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR : astc.COMPRESSED_RGBA_ASTC_4x4_KHR;
+        }
+        case "etc2-rgba8unorm":
+            return srgb ? GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC : GL_COMPRESSED_RGBA8_ETC2_EAC;
+        case "etc2-rgb8unorm":
+            return srgb ? GL_COMPRESSED_SRGB8_ETC2 : GL_COMPRESSED_RGB8_ETC2;
+        default:
+            throw new Error(`UNSUPPORTED_COMPRESSED_FORMAT:${String(format)}`);
+    }
+}
+/**
+ * C-16 §7.4 probe: which compressed-texture families this context can consume.
+ * `etc2` is a WebGL2-core guarantee; the other four map 1:1 onto their
+ * WebGL extension objects (S3TC sRGB lives in its own extension).
+ */
+export function probeCompressedTextureCapabilities(gl) {
+    return {
+        astc: gl.getExtension("WEBGL_compressed_texture_astc") !== null,
+        bptc: gl.getExtension("EXT_texture_compression_bptc") !== null,
+        etc2: true,
+        s3tc: gl.getExtension("WEBGL_compressed_texture_s3tc") !== null,
+        s3tcSrgb: gl.getExtension("WEBGL_compressed_texture_s3tc_srgb") !== null
+    };
+}
+export function magFilter(gl, filter) {
+    return filter === "nearest" ? gl.NEAREST : gl.LINEAR;
+}
+export function minFilter(gl, filter) {
+    switch (filter) {
+        case "nearest":
+            return gl.NEAREST;
+        case "linear":
+            return gl.LINEAR;
+        case "nearest-mipmap-nearest":
+            return gl.NEAREST_MIPMAP_NEAREST;
+        case "linear-mipmap-nearest":
+            return gl.LINEAR_MIPMAP_NEAREST;
+        case "nearest-mipmap-linear":
+            return gl.NEAREST_MIPMAP_LINEAR;
+        case "linear-mipmap-linear":
+            return gl.LINEAR_MIPMAP_LINEAR;
+    }
+}
+export function addressMode(gl, mode) {
+    if (mode === "repeat")
+        return gl.REPEAT;
+    if (mode === "mirror-repeat")
+        return gl.MIRRORED_REPEAT;
+    return gl.CLAMP_TO_EDGE;
+}
+//# sourceMappingURL=TextureFormats.js.map

package/dist/webgl2/TextureFormats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureFormats.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgl2/TextureFormats.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAErG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAsD,MAAM,YAAY,CAAC;AAEzF,MAAM,UAAU,cAAc,CAAC,EAA0B,EAAE,IAAqB;IAC5E,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC;QACjD,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC;QACjD,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC;QACjD,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC;QACjD,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC;QACjD,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,2BAA2B,CAAC;IACnD,CAAC;AACH,CAAC;AAEH,MAAM,UAAU,0BAA0B,CAAC,EAA0B,EAAE,OAAgB;IACnF,OAAO,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;AACnE,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,EAA0B,EAAE,OAAgB;IAC5E,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,cAAc,EAAE,0BAA0B,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC;IAC9G,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,iBAAiB,CAAC,2DAA2D,EAAE,4BAA4B,EAAE;YACrH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;IACzE,CAAC;IACD,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,EAAE,4BAA4B,EAAE;QAC7F,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,EAA0B,EAAE,OAAgB;IACvF,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;IACpE,CAAC;IACD,OAAO,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,cAAc,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,EAA0B,EAAE,MAAuC;IACzG,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,iBAAiB,CAAC,oEAAoE,EAAE,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjJ,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;AACxD,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAAC,EAA0B,EAAE,MAA+B;IACtG,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,CAAC;QACD,KAAK,iBAAiB;YACpB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;QACpC,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACvF,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAEH,8EAA8E;AAC9E,mFAAmF;AACnF,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAC7E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAC5C,MAAM,mCAAmC,GAAG,MAAM,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAA+B,EAC/B,UAA6B,EAC7B,EAA0B;IAE1B,MAAM,IAAI,GAAG,UAAU,KAAK,MAAM,CAAC;IACnC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,oCAAoC,CAAC,CAAC;gBACvE,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxE,CAAC;YACD,OAAO,IAAI,CAAC,6BAA6B,CAAC;QAC5C,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,oCAAoC,CAAC,CAAC;gBACvE,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxE,CAAC;YACD,OAAO,IAAI,CAAC,6BAA6B,CAAC;QAC5C,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,8BAA8B,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC;QAChG,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC;QAC9F,CAAC;QACD,KAAK,iBAAiB;YACpB,OAAO,IAAI,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,4BAA4B,CAAC;QACnF,KAAK,gBAAgB;YACnB,OAAO,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,uBAAuB,CAAC;QACnE;YACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAAC,EAA0B;IAO3E,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,KAAK,IAAI;QAC/D,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,8BAA8B,CAAC,KAAK,IAAI;QAC9D,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,+BAA+B,CAAC,KAAK,IAAI;QAC/D,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,oCAAoC,CAAC,KAAK,IAAI;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAA0B,EAAE,MAAwB;IAC1E,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;AACvD,CAAC;AAEH,MAAM,UAAU,SAAS,CAAC,EAA0B,EAAE,MAAwB;IAC1E,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,EAAE,CAAC,OAAO,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC,MAAM,CAAC;QACnB,KAAK,wBAAwB;YAC3B,OAAO,EAAE,CAAC,sBAAsB,CAAC;QACnC,KAAK,uBAAuB;YAC1B,OAAO,EAAE,CAAC,qBAAqB,CAAC;QAClC,KAAK,uBAAuB;YAC1B,OAAO,EAAE,CAAC,qBAAqB,CAAC;QAClC,KAAK,sBAAsB;YACzB,OAAO,EAAE,CAAC,oBAAoB,CAAC;IACnC,CAAC;AACH,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,EAA0B,EAAE,IAAkD;IACtG,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC;IACxC,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,EAAE,CAAC,eAAe,CAAC;IACxD,OAAO,EAAE,CAAC,aAAa,CAAC;AAC1B,CAAC"}

package/dist/webgl2/TextureUpload.d.ts

@@ -0,0 +1,38 @@
+import { Texture, type TexturePixelData } from "../Texture.js";
+import type { WebGL2DeviceHost } from "./DeviceHost.js";
+export declare class WebGL2TextureRegistry {
+    readonly host: WebGL2DeviceHost;
+    constructor(host: WebGL2DeviceHost);
+    fallbackCubeTexture: WebGLTexture | null;
+    fallbackTexture: WebGLTexture | null;
+    textureUploadModes: Map<Texture, "rgba8" | "rgba16f" | "rgba32f" | "cube" | "fallback" | "compressed" | "depth-render-target">;
+    textures: Map<Texture, WebGLTexture>;
+    /**
+     * C-18: `Texture.revision` at the last successful upload. A mismatch means
+     * `texture.update()` produced new pixels and the handle needs a sub-image
+     * upload rather than a rebind.
+     */
+    private readonly textureUploadRevisions;
+    getFallbackTextureHandle(): WebGLTexture;
+    getFallbackCubeTextureHandle(): WebGLTexture;
+    getTextureHandle(texture: Texture): WebGLTexture;
+    /**
+     * C-18 (T0.10a): re-upload changed texture content on the existing handle.
+     * Dynamic textures (immutable `texStorage2D` storage) use `texSubImage2D` for
+     * the pending region or the whole level-0 image; `2d-array` textures use
+     * `texSubImage3D` per written layer. Non-dynamic textures are re-uploaded via
+     * a whole-image `texImage2D` (correct but reallocating — the C-18 stub
+     * semantic; palette/morph textures are always `dynamic`).
+     */
+    private uploadTextureRevision;
+    uploadCubeTexture(texture: Texture, handle: WebGLTexture): void;
+    uploadRgba8FallbackTexture(texture: Texture, fallbackLevels: readonly {
+        readonly width: number;
+        readonly height: number;
+        readonly data: TexturePixelData;
+    }[]): void;
+    /** `currentTextureDisposeEpoch()` at the last full sweep (-1 = never swept). */
+    private sweptDisposeEpoch;
+    releaseDisposedTextureHandles(): void;
+}
+//# sourceMappingURL=TextureUpload.d.ts.map

package/dist/webgl2/TextureUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureUpload.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgl2/TextureUpload.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAmG,KAAK,gBAAgB,EAA4B,MAAM,YAAY,CAAC;AAKvL,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,qBAAa,qBAAqB;IACpB,QAAQ,CAAC,IAAI,EAAE,gBAAgB;gBAAtB,IAAI,EAAE,gBAAgB;IAE3C,mBAAmB,EAAE,YAAY,GAAG,IAAI,CAAQ;IAEhD,eAAe,EAAE,YAAY,GAAG,IAAI,CAAQ;IAE5C,kBAAkB,6GAAoH;IAEtI,QAAQ,6BAAoC;IAE5C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA8B;IAErE,wBAAwB,IAAI,YAAY;IAmBxC,4BAA4B,IAAI,YAAY;IAuB5C,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IA4MhD;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IA4E7B,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA2B/D,0BAA0B,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,EAAE,GAAG,IAAI;IAmBnK,gFAAgF;IAChF,OAAO,CAAC,iBAAiB,CAAM;IAE/B,6BAA6B,IAAI,IAAI;CAetC"}