@aura3d/rendering 3.0.0 → 4.0.0

package/dist/program/DFGLut.js

@@ -0,0 +1,58 @@
+/**
+ * 01-DFG: the renderer-owned r185 DFG LUT texture for generated programs.
+ *
+ * One `Texture` for the whole process, uploaded once per device by that
+ * device's texture cache. Every generated program that declares
+ * `u_dfgLut` (the lane-01 `brdf` chunk) gets it from
+ * `MaterialBinding.bindGenerated`. The legacy flag-off path keeps
+ * `createExternalParityBrdfLut` and its own `u_environmentBrdfLutTexture`.
+ *
+ * The data is three's RG16F array verbatim. The device has no RG16F upload
+ * format, so it is widened to RGBA16F: R and G are the r185 half floats
+ * unchanged, B = 0, A = 1. `a3dDFG` reads `.rg` only. Sampling matches three's
+ * DataTexture: linear min/mag, no mips, clamp-to-edge.
+ */
+import { Sampler } from "../Sampler.js";
+import { Texture } from "../Texture.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { DFG_LUT_RG16F, DFG_LUT_SIZE } from "./DFGLutData.js";
+/** Half-float bit patterns. */
+const HALF_ZERO = 0x0000;
+const HALF_ONE = 0x3c00;
+/** RG16F → RGBA16F (B = 0, A = 1); R/G bit-identical to r185 DFGLUTData. */
+export function dfgLutRgba16f() {
+    const texels = DFG_LUT_SIZE * DFG_LUT_SIZE;
+    const out = new Uint16Array(texels * 4);
+    for (let i = 0; i < texels; i++) {
+        out[i * 4] = DFG_LUT_RG16F[i * 2];
+        out[i * 4 + 1] = DFG_LUT_RG16F[i * 2 + 1];
+        out[i * 4 + 2] = HALF_ZERO;
+        out[i * 4 + 3] = HALF_ONE;
+    }
+    return out;
+}
+let texture;
+let binding;
+/** The shared DFG LUT texture (created on first use). */
+export function dfgLutTexture() {
+    texture ??= new Texture({
+        width: DFG_LUT_SIZE,
+        height: DFG_LUT_SIZE,
+        format: "rgba16f",
+        colorSpace: "linear",
+        data: dfgLutRgba16f(),
+        label: "a3d-dfg-lut-r185"
+    });
+    return texture;
+}
+/** `u_dfgLut` binding for generated programs. */
+export function dfgLutBinding() {
+    binding ??= new TextureBinding({
+        name: "u_dfgLut",
+        texture: dfgLutTexture(),
+        sampler: new Sampler({ minFilter: "linear", magFilter: "linear", addressU: "clamp-to-edge", addressV: "clamp-to-edge" }),
+        expectedColorSpace: "linear"
+    });
+    return binding;
+}
+//# sourceMappingURL=DFGLut.js.map

package/dist/program/DFGLut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DFGLut.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/DFGLut.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3D,+BAA+B;AAC/B,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,QAAQ,GAAG,MAAM,CAAC;AAExB,4EAA4E;AAC5E,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACnC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAE,CAAC;QAC3C,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;QAC3B,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,IAAI,OAA4B,CAAC;AACjC,IAAI,OAAmC,CAAC;AAExC,yDAAyD;AACzD,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,IAAI,OAAO,CAAC;QACtB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,QAAQ;QACpB,IAAI,EAAE,aAAa,EAAE;QACrB,KAAK,EAAE,kBAAkB;KAC1B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,IAAI,cAAc,CAAC;QAC7B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,aAAa,EAAE;QACxB,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;QACxH,kBAAkB,EAAE,QAAQ;KAC7B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/program/DFGLutData.d.ts

@@ -0,0 +1,35 @@
+/**
+ * r185 DFG LUT for image-based lighting (01-DFG, PRD-01 §8.3, CONTRACTS C-02).
+ *
+ * Copied verbatim from three.js r185
+ * `src/renderers/shaders/DFGLUTData.js` (16x16, 4096 samples per texel,
+ * RG16F: 2 half floats per texel = (scale, bias) of the split-sum DFG term).
+ * Generated programs sample it as `texture(u_dfgLut, vec2(roughness, dotNV)).rg`
+ * (`program/chunks/brdf.glsl.ts` `a3dDFG`), the same axis order as three.
+ *
+ * The MIT License
+ *
+ * Copyright © 2010-2026 three.js authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+export declare const DFG_LUT_SIZE = 16;
+/** Row-major, 2 half floats per texel: (scale, bias). Index = 2 * (y * 16 + x). */
+export declare const DFG_LUT_RG16F: Uint16Array;
+//# sourceMappingURL=DFGLutData.d.ts.map

package/dist/program/DFGLutData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DFGLutData.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/DFGLutData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,mFAAmF;AACnF,eAAO,MAAM,aAAa,EAAE,WAiB1B,CAAC"}

package/dist/program/DFGLutData.js

@@ -0,0 +1,52 @@
+/**
+ * r185 DFG LUT for image-based lighting (01-DFG, PRD-01 §8.3, CONTRACTS C-02).
+ *
+ * Copied verbatim from three.js r185
+ * `src/renderers/shaders/DFGLUTData.js` (16x16, 4096 samples per texel,
+ * RG16F: 2 half floats per texel = (scale, bias) of the split-sum DFG term).
+ * Generated programs sample it as `texture(u_dfgLut, vec2(roughness, dotNV)).rg`
+ * (`program/chunks/brdf.glsl.ts` `a3dDFG`), the same axis order as three.
+ *
+ * The MIT License
+ *
+ * Copyright © 2010-2026 three.js authors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+export const DFG_LUT_SIZE = 16;
+/** Row-major, 2 half floats per texel: (scale, bias). Index = 2 * (y * 16 + x). */
+export const DFG_LUT_RG16F = new Uint16Array([
+    0x30b5, 0x3ad1, 0x314c, 0x3a4d, 0x33d2, 0x391c, 0x35ef, 0x3828, 0x37f3, 0x36a6, 0x38d1, 0x3539, 0x3979, 0x3410, 0x39f8, 0x3252, 0x3a53, 0x30f0, 0x3a94, 0x2fc9, 0x3abf, 0x2e35, 0x3ada, 0x2d05, 0x3ae8, 0x2c1f, 0x3aed, 0x2ae0, 0x3aea, 0x29d1, 0x3ae1, 0x28ff,
+    0x3638, 0x38e4, 0x364a, 0x38ce, 0x3699, 0x385e, 0x374e, 0x372c, 0x3839, 0x35a4, 0x38dc, 0x3462, 0x396e, 0x32c4, 0x39de, 0x3134, 0x3a2b, 0x3003, 0x3a59, 0x2e3a, 0x3a6d, 0x2ce1, 0x3a6e, 0x2bba, 0x3a5f, 0x2a33, 0x3a49, 0x290a, 0x3a2d, 0x2826, 0x3a0a, 0x26e8,
+    0x3894, 0x36d7, 0x3897, 0x36c9, 0x38a3, 0x3675, 0x38bc, 0x35ac, 0x38ee, 0x349c, 0x393e, 0x3332, 0x3997, 0x3186, 0x39e2, 0x3038, 0x3a13, 0x2e75, 0x3a29, 0x2cf5, 0x3a2d, 0x2bac, 0x3a21, 0x29ff, 0x3a04, 0x28bc, 0x39dc, 0x2790, 0x39ad, 0x261a, 0x3978, 0x24fa,
+    0x39ac, 0x34a8, 0x39ac, 0x34a3, 0x39ae, 0x3480, 0x39ae, 0x3423, 0x39b1, 0x330e, 0x39c2, 0x31a9, 0x39e0, 0x3063, 0x39fc, 0x2eb5, 0x3a0c, 0x2d1d, 0x3a14, 0x2bcf, 0x3a07, 0x29ff, 0x39e9, 0x28a3, 0x39be, 0x273c, 0x3989, 0x25b3, 0x394a, 0x2488, 0x3907, 0x2345,
+    0x3a77, 0x3223, 0x3a76, 0x321f, 0x3a73, 0x3204, 0x3a6a, 0x31b3, 0x3a58, 0x3114, 0x3a45, 0x303b, 0x3a34, 0x2eb6, 0x3a26, 0x2d31, 0x3a1e, 0x2bef, 0x3a0b, 0x2a0d, 0x39ec, 0x28a1, 0x39c0, 0x271b, 0x3987, 0x2580, 0x3944, 0x2449, 0x38fa, 0x22bd, 0x38ac, 0x2155,
+    0x3b07, 0x2fca, 0x3b06, 0x2fca, 0x3b00, 0x2fb8, 0x3af4, 0x2f7c, 0x3adb, 0x2eea, 0x3ab4, 0x2e00, 0x3a85, 0x2cec, 0x3a5e, 0x2bc5, 0x3a36, 0x2a00, 0x3a0d, 0x2899, 0x39dc, 0x2707, 0x39a0, 0x2562, 0x395a, 0x2424, 0x390b, 0x2268, 0x38b7, 0x20fd, 0x385f, 0x1fd1,
+    0x3b69, 0x2cb9, 0x3b68, 0x2cbb, 0x3b62, 0x2cbb, 0x3b56, 0x2cae, 0x3b3b, 0x2c78, 0x3b0d, 0x2c0a, 0x3acf, 0x2ae3, 0x3a92, 0x2998, 0x3a54, 0x2867, 0x3a17, 0x26d0, 0x39d3, 0x253c, 0x3989, 0x2402, 0x3935, 0x2226, 0x38dc, 0x20bd, 0x387d, 0x1f54, 0x381d, 0x1db3,
+    0x3ba9, 0x296b, 0x3ba8, 0x296f, 0x3ba3, 0x297b, 0x3b98, 0x2987, 0x3b7f, 0x2976, 0x3b4e, 0x2927, 0x3b0e, 0x2895, 0x3ac2, 0x27b7, 0x3a73, 0x263b, 0x3a23, 0x24e7, 0x39d0, 0x239b, 0x3976, 0x21d9, 0x3917, 0x207e, 0x38b2, 0x1ee7, 0x384b, 0x1d53, 0x37c7, 0x1c1e,
+    0x3bd2, 0x25cb, 0x3bd1, 0x25d3, 0x3bcd, 0x25f0, 0x3bc2, 0x261f, 0x3bad, 0x2645, 0x3b7d, 0x262d, 0x3b3e, 0x25c4, 0x3aec, 0x250f, 0x3a93, 0x243a, 0x3a32, 0x22ce, 0x39d0, 0x215b, 0x3969, 0x202a, 0x38fe, 0x1e6e, 0x388f, 0x1cf1, 0x381f, 0x1b9b, 0x3762, 0x19dd,
+    0x3be9, 0x21ab, 0x3be9, 0x21b7, 0x3be5, 0x21e5, 0x3bdd, 0x2241, 0x3bc9, 0x22a7, 0x3ba0, 0x22ec, 0x3b62, 0x22cd, 0x3b0f, 0x2247, 0x3aae, 0x2175, 0x3a44, 0x2088, 0x39d4, 0x1f49, 0x3960, 0x1dbe, 0x38e9, 0x1c77, 0x3870, 0x1ae8, 0x37f1, 0x1953, 0x3708, 0x181b,
+    0x3bf6, 0x1cea, 0x3bf6, 0x1cfb, 0x3bf3, 0x1d38, 0x3bec, 0x1dbd, 0x3bda, 0x1e7c, 0x3bb7, 0x1f25, 0x3b7d, 0x1f79, 0x3b2c, 0x1f4c, 0x3ac6, 0x1ea6, 0x3a55, 0x1dbb, 0x39da, 0x1cbd, 0x395a, 0x1b9d, 0x38d8, 0x1a00, 0x3855, 0x18ac, 0x37ab, 0x173c, 0x36b7, 0x1598,
+    0x3bfc, 0x1736, 0x3bfc, 0x1759, 0x3bf9, 0x17e7, 0x3bf4, 0x1896, 0x3be4, 0x1997, 0x3bc6, 0x1aa8, 0x3b91, 0x1b84, 0x3b43, 0x1bd2, 0x3ade, 0x1b8a, 0x3a65, 0x1acd, 0x39e2, 0x19d3, 0x3957, 0x18cd, 0x38ca, 0x17b3, 0x383e, 0x1613, 0x376d, 0x14bf, 0x366f, 0x135e,
+    0x3bff, 0x101b, 0x3bff, 0x1039, 0x3bfc, 0x10c8, 0x3bf9, 0x1226, 0x3bea, 0x1428, 0x3bcf, 0x1584, 0x3b9f, 0x16c5, 0x3b54, 0x179a, 0x3af0, 0x17ce, 0x3a76, 0x1771, 0x39ea, 0x16a4, 0x3956, 0x15a7, 0x38bf, 0x14a7, 0x3829, 0x1379, 0x3735, 0x11ea, 0x362d, 0x10a1,
+    0x3c00, 0x061b, 0x3c00, 0x066a, 0x3bfe, 0x081c, 0x3bfa, 0x0a4c, 0x3bed, 0x0d16, 0x3bd5, 0x0fb3, 0x3ba9, 0x114d, 0x3b63, 0x127c, 0x3b01, 0x132f, 0x3a85, 0x1344, 0x39f4, 0x12d2, 0x3957, 0x120d, 0x38b5, 0x1122, 0x3817, 0x103c, 0x3703, 0x0ed3, 0x35f0, 0x0d6d,
+    0x3c00, 0x007a, 0x3c00, 0x0089, 0x3bfe, 0x011d, 0x3bfb, 0x027c, 0x3bf0, 0x04fa, 0x3bda, 0x0881, 0x3bb1, 0x0acd, 0x3b6f, 0x0c97, 0x3b10, 0x0d7b, 0x3a93, 0x0df1, 0x39fe, 0x0def, 0x3959, 0x0d8a, 0x38af, 0x0ce9, 0x3808, 0x0c31, 0x36d5, 0x0af0, 0x35b9, 0x09a3,
+    0x3c00, 0x0000, 0x3c00, 0x0001, 0x3bff, 0x0015, 0x3bfb, 0x0059, 0x3bf2, 0x00fd, 0x3bdd, 0x01df, 0x3bb7, 0x031c, 0x3b79, 0x047c, 0x3b1d, 0x05d4, 0x3aa0, 0x06d5, 0x3a08, 0x075a, 0x395d, 0x075e, 0x38aa, 0x06f7, 0x37f4, 0x0648, 0x36ac, 0x0576, 0x3586, 0x049f
+]);
+//# sourceMappingURL=DFGLutData.js.map

package/dist/program/DFGLutData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DFGLutData.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/DFGLutData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B,mFAAmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAgB,IAAI,WAAW,CAAC;IACxD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9P,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAC/P,CAAC,CAAC"}

package/dist/program/FeatureSelect.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `program/FeatureSelect.ts` (PRD-01 §6.4, C-02, T0-05) — per-draw
+ * `ShaderFeature.select` + `bindUniforms`, and the generated-path
+ * compatibility rule for registered features.
+ *
+ * Kept out of `MaterialFeatures.ts`: that module is imported by `Material.ts`,
+ * and a value import of `contracts/program` there closes an import cycle
+ * through `PBRMaterial`.
+ */
+import type { QrFlags } from "../contracts/core.js";
+import type { ProgramFeatures, ShaderFeature, ShaderFeatureSelectInput, ShaderHookPoint } from "../contracts/program.js";
+import type { RenderItem } from "../contracts/renderItem.js";
+import type { UniformValue } from "../RenderDevice.js";
+/** Hooks whose chunks are global-scope declarations (mirrors ProgramGenerator). */
+export declare const DECLARATION_HOOKS: ReadonlySet<ShaderHookPoint>;
+/** A call chunk is statements only: it may run inside `main()`. */
+export declare function isCallChunkGlsl(glsl: string): boolean;
+/**
+ * Why a registered feature cannot run on the generated (C-02) path, or
+ * undefined when it can. Body-hook chunks must be call chunks (unless the
+ * same feature also declares that chunk at a declaration hook), and a
+ * `vertex:deform` contributor must define `a3dDeform(...)`, which the
+ * generator calls canonically (C-18).
+ */
+export declare function featureGeneratorIncompatibility(feature: ShaderFeature): string | undefined;
+/**
+ * Every registered feature active under `input.flags` that can run on the
+ * generated path contributes its bit under its id when `select` returns a
+ * value. ForwardPass (draw key) and the Renderer warmup merge this into the
+ * forward record's `features`, so equal inputs give equal keys.
+ */
+export declare function selectShaderFeatureBits(input: ShaderFeatureSelectInput): Record<string, string | number | boolean>;
+/** Per-draw uniforms of the features a record selected, written through `set`. */
+export declare function bindShaderFeatureUniforms(features: ProgramFeatures["features"], flags: QrFlags, item: RenderItem, set: (name: string, value: UniformValue) => void): void;
+//# sourceMappingURL=FeatureSelect.d.ts.map

package/dist/program/FeatureSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureSelect.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/FeatureSelect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEtH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,eAAe,CAA+E,CAAC;AAM3I,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAkB1F;AAkBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAQlH;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,EACrC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,GAC/C,IAAI,CAKN"}

package/dist/program/FeatureSelect.js

@@ -0,0 +1,88 @@
+/**
+ * `program/FeatureSelect.ts` (PRD-01 §6.4, C-02, T0-05) — per-draw
+ * `ShaderFeature.select` + `bindUniforms`, and the generated-path
+ * compatibility rule for registered features.
+ *
+ * Kept out of `MaterialFeatures.ts`: that module is imported by `Material.ts`,
+ * and a value import of `contracts/program` there closes an import cycle
+ * through `PBRMaterial`.
+ */
+import { shaderChunk, shaderFeaturesFor } from "../contracts/program.js";
+/** Hooks whose chunks are global-scope declarations (mirrors ProgramGenerator). */
+export const DECLARATION_HOOKS = new Set(["vertex:pars", "vertex:deform", "fragment:pars"]);
+const TOP_LEVEL_UNIFORM = /^\s*uniform\s/m;
+const FUNCTION_DEFINITION = /^\s*(?:void|float|int|uint|bool|[iu]?vec[234]|mat[234](?:x[234])?|[A-Z]\w*)\s+\w+\s*\([^;{]*\)\s*\{/m;
+const STRUCT_DEFINITION = /^\s*struct\s+\w+\s*\{/m;
+/** A call chunk is statements only: it may run inside `main()`. */
+export function isCallChunkGlsl(glsl) {
+    return !TOP_LEVEL_UNIFORM.test(glsl) && !FUNCTION_DEFINITION.test(glsl) && !STRUCT_DEFINITION.test(glsl);
+}
+/**
+ * Why a registered feature cannot run on the generated (C-02) path, or
+ * undefined when it can. Body-hook chunks must be call chunks (unless the
+ * same feature also declares that chunk at a declaration hook), and a
+ * `vertex:deform` contributor must define `a3dDeform(...)`, which the
+ * generator calls canonically (C-18).
+ */
+export function featureGeneratorIncompatibility(feature) {
+    const chunkAt = (i) => feature.chunks[Math.min(i, feature.chunks.length - 1)];
+    for (let i = 0; i < feature.hooks.length; i++) {
+        const hook = feature.hooks[i];
+        const name = chunkAt(i);
+        if (name === undefined)
+            continue;
+        const chunk = shaderChunk(name);
+        if (!chunk)
+            return `chunk ${name} is not registered`;
+        if (hook === "vertex:deform" && !/\bvoid\s+a3dDeform\s*\(/.test(chunk.glsl)) {
+            return `vertex:deform chunk ${name} does not define a3dDeform()`;
+        }
+        if (DECLARATION_HOOKS.has(hook))
+            continue;
+        const declaredElsewhere = feature.hooks.some((h, j) => DECLARATION_HOOKS.has(h) && chunkAt(j) === name);
+        if (!declaredElsewhere && !isCallChunkGlsl(chunk.glsl)) {
+            return `${hook} chunk ${name} has global declarations (needs a pars/call split)`;
+        }
+    }
+    return undefined;
+}
+const verdicts = new WeakMap();
+const warned = new Set();
+function generatorReady(feature) {
+    let verdict = verdicts.get(feature);
+    if (verdict === undefined) {
+        verdict = featureGeneratorIncompatibility(feature) ?? null;
+        verdicts.set(feature, verdict);
+    }
+    if (verdict !== null && !warned.has(feature.id)) {
+        warned.add(feature.id);
+        console.warn(`[prd01] ShaderFeature "${feature.id}" (${feature.owner}) is skipped on the generated-program path: ${verdict}`);
+    }
+    return verdict === null;
+}
+/**
+ * Every registered feature active under `input.flags` that can run on the
+ * generated path contributes its bit under its id when `select` returns a
+ * value. ForwardPass (draw key) and the Renderer warmup merge this into the
+ * forward record's `features`, so equal inputs give equal keys.
+ */
+export function selectShaderFeatureBits(input) {
+    const bits = {};
+    for (const feature of shaderFeaturesFor(input.flags)) {
+        if (!generatorReady(feature))
+            continue;
+        const value = feature.select(input);
+        if (value !== undefined)
+            bits[feature.id] = value;
+    }
+    return bits;
+}
+/** Per-draw uniforms of the features a record selected, written through `set`. */
+export function bindShaderFeatureUniforms(features, flags, item, set) {
+    for (const feature of shaderFeaturesFor(flags)) {
+        const value = features[feature.id];
+        if (value !== undefined)
+            feature.bindUniforms?.(value, item, set);
+    }
+}
+//# sourceMappingURL=FeatureSelect.js.map

package/dist/program/FeatureSelect.js.map

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

package/dist/program/MaterialFeatures.d.ts

@@ -0,0 +1,66 @@
+/**
+ * `program/MaterialFeatures.ts` (PRD-01 §15 Phase-3) — material → C-02 record.
+ *
+ * `defaultProgramFeatures(material, ctx)` derives the record every allow-listed
+ * material produces from its parameters, so `Material.programFeatures(ctx)`
+ * has a real default instead of a per-subclass override:
+ *   lighting    — `lit` for PBR-family shaderKeys, `unlit` otherwise
+ *   maps        — `u_<slot>Texture` TextureBinding with a texture bound;
+ *                 `u_<slot>TextureTexCoord` selects uvSet; a bound transform
+ *                 sets `transform`
+ *   alphaMode   — `blend`/`blendMode!=="opaque"` → "blend",
+ *                 `u_alphaCutoff > 0` → "mask", else "opaque"
+ *   doubleSided — `renderState.cullMode === "none"`
+ *   vertexColors/instancing/skinning/morph — from `requiredAttributes`
+ *   extensions  — extension factor params > 0 → `MaterialExtensionFeature`s
+ *                 (lobe chunks come from `materialLobes(flags)`; an unregistered
+ *                 extension records `extension-lobe-pending` at generate time)
+ *
+ * Allow-list: materials outside `ALLOWLIST_PROGRAM_SHADERS` keep `shaderKey`
+ * (the ForwardPass flag-off path). `materialFeatureWarning` returns the
+ * "nearest superset" note for an allow-listed shader with unrecognized state.
+ */
+import type { Material } from "../Material.js";
+import type { ProgramFeatures } from "../contracts/program.js";
+import type { MaterialFeatureContext } from "../contracts/materialLobes.js";
+type FeatureRecord = Omit<ProgramFeatures, "lights" | "shadows" | "environment" | "fog" | "pass" | "target" | "backgroundCoverage">;
+/** Shader keys the generated-program path covers (the §15 allow-list). */
+export declare const ALLOWLIST_PROGRAM_SHADERS: ReadonlySet<string>;
+export declare function defaultProgramFeatures(material: Material, ctx: MaterialFeatureContext): FeatureRecord;
+/** Geometry attribute presence test, by shader name (`a_uv`, `a_joints`, …). */
+export type GeometryAttributeTest = (shaderName: string) => boolean;
+/** True when the geometry carries a full skin (joints + weights). */
+export declare function geometryHasSkin(has: GeometryAttributeTest): boolean;
+/**
+ * #867 (games): the program's feature set follows the geometry, as in
+ * three.js. A primitive or procedural mesh with no `a_uv` cannot sample
+ * uv-set-0 maps (they and the extension lobe maps are dropped); no `a_uv1`
+ * drops uv-set-1 maps; no `a_color` drops vertex colors; no joints/weights
+ * drops skinning segments from `prd06.deform` (morph is texture-driven and
+ * untouched). Normal maps need only uv: the generated program never reads `a_tangent`
+ * (derivative TBN when the geometry has none). Returns `record` itself when
+ * nothing is dropped, so program keys stay stable for complete geometry.
+ */
+export declare function featuresForGeometry<T extends FeatureRecord>(record: T, has: GeometryAttributeTest): T;
+/** Allow-listed shader → covered by the generated path. */
+export declare function materialUsesGeneratedProgram(material: Material): boolean;
+/**
+ * Draw-time route. `core` (A3D_QR_CORE generator): every allow-listed material
+ * is generated. `lobes` (PRD-04 `qrMaterialsLobeProgramsOn`): only
+ * allow-listed materials whose record carries an r185 lobe extension are —
+ * otherwise those lobes never reach the GPU under `materials` alone.
+ */
+export declare function materialRoutesToGeneratedProgram(material: Material, route: {
+    readonly core: boolean;
+    readonly lobes: boolean;
+}, ctx: MaterialFeatureContext): boolean;
+/**
+ * §15: "nearest superset" warning when an allow-listed material carries state
+ * the feature derivation cannot see. A `shaderVariant` override is the one
+ * such state today (variants are legacy-library axes the generator does not
+ * model) — the feature record describes the base shader, which is a superset
+ * of nothing; warn so the silent-widening rule is observable.
+ */
+export declare function materialFeatureWarning(material: Material): string | null;
+export {};
+//# sourceMappingURL=MaterialFeatures.d.ts.map

package/dist/program/MaterialFeatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterialFeatures.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/MaterialFeatures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAA4B,eAAe,EAAsB,MAAM,sBAAsB,CAAC;AAC1G,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGzE,KAAK,aAAa,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,oBAAoB,CAAC,CAAC;AA+CpI,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAUxD,CAAC;AAkBH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,sBAAsB,GAAG,aAAa,CA8CrG;AAED,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;AAEpE,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,qBAAqB,GAAG,CAAC,CA+CrG;AAED,2DAA2D;AAC3D,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EAC1D,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAMxE"}

package/dist/program/MaterialFeatures.js

@@ -0,0 +1,242 @@
+/**
+ * `program/MaterialFeatures.ts` (PRD-01 §15 Phase-3) — material → C-02 record.
+ *
+ * `defaultProgramFeatures(material, ctx)` derives the record every allow-listed
+ * material produces from its parameters, so `Material.programFeatures(ctx)`
+ * has a real default instead of a per-subclass override:
+ *   lighting    — `lit` for PBR-family shaderKeys, `unlit` otherwise
+ *   maps        — `u_<slot>Texture` TextureBinding with a texture bound;
+ *                 `u_<slot>TextureTexCoord` selects uvSet; a bound transform
+ *                 sets `transform`
+ *   alphaMode   — `blend`/`blendMode!=="opaque"` → "blend",
+ *                 `u_alphaCutoff > 0` → "mask", else "opaque"
+ *   doubleSided — `renderState.cullMode === "none"`
+ *   vertexColors/instancing/skinning/morph — from `requiredAttributes`
+ *   extensions  — extension factor params > 0 → `MaterialExtensionFeature`s
+ *                 (lobe chunks come from `materialLobes(flags)`; an unregistered
+ *                 extension records `extension-lobe-pending` at generate time)
+ *
+ * Allow-list: materials outside `ALLOWLIST_PROGRAM_SHADERS` keep `shaderKey`
+ * (the ForwardPass flag-off path). `materialFeatureWarning` returns the
+ * "nearest superset" note for an allow-listed shader with unrecognized state.
+ */
+import { isTextureBinding } from "../TextureBinding.js";
+// Lit iff the shader key names a PBR or skinned-lit program ("unlit" must not match).
+const LIT_SHADER_MARKERS = /pbr|skinned-lit/i;
+/** Texture parameter → maps slot. */
+const MAP_PARAMS = [
+    ["u_baseColorTexture", "baseColor"],
+    ["u_normalTexture", "normal"],
+    ["u_metallicRoughnessTexture", "metallicRoughness"],
+    ["u_occlusionTexture", "occlusion"],
+    ["u_emissiveTexture", "emissive"]
+];
+/** Extension factor parameter → glTF extension id (C-03). */
+const EXTENSION_PARAMS = [
+    ["u_clearcoatFactor", "KHR_materials_clearcoat"],
+    ["u_anisotropyStrength", "KHR_materials_anisotropy"],
+    ["u_iridescenceFactor", "KHR_materials_iridescence"],
+    ["u_transmissionFactor", "KHR_materials_transmission"],
+    ["u_volumeThicknessFactor", "KHR_materials_volume"],
+    ["u_diffuseTransmissionFactor", "KHR_materials_diffuse_transmission"],
+    ["u_dispersion", "KHR_materials_dispersion"]
+];
+const SPECIAL_EXTENSIONS = ["KHR_materials_sheen", "KHR_materials_ior", "KHR_materials_specular", "KHR_materials_emissive_strength"];
+/** Extensions whose presence test is not a plain `param > 0`. */
+function specialExtensionPresent(material, glTF) {
+    const num = (n) => (typeof material.getParameter(n) === "number" ? material.getParameter(n) : undefined);
+    switch (glTF) {
+        case "KHR_materials_sheen": {
+            const color = material.getParameter("u_sheenColorFactor");
+            const anyColor = (Array.isArray(color) || color instanceof Float32Array) && [...color].some((c) => c > 0);
+            return anyColor === true || (num("u_sheenRoughnessFactor") ?? 0) > 0;
+        }
+        case "KHR_materials_ior":
+            return (num("u_ior") ?? 1.5) !== 1.5;
+        case "KHR_materials_specular":
+            return (num("u_specularFactor") ?? 1) < 1;
+        case "KHR_materials_emissive_strength":
+            return (num("u_emissiveStrength") ?? 1) > 1;
+        default:
+            return false;
+    }
+}
+/** Shader keys the generated-program path covers (the §15 allow-list). */
+export const ALLOWLIST_PROGRAM_SHADERS = new Set([
+    "aura3d/pbr-direct",
+    "aura3d/instanced-pbr",
+    "aura3d/pbr-textured",
+    "aura3d/pbr-normal-map",
+    "aura3d/skinned-lit",
+    "aura3d/skinned-lit-8",
+    "aura3d/unlit",
+    "aura3d/textured-unlit",
+    "aura3d/instanced-unlit"
+]);
+function paramNumber(material, name) {
+    const v = material.getParameter(name);
+    return typeof v === "number" ? v : undefined;
+}
+function mapSlot(material, param) {
+    const binding = material.getParameter(param);
+    if (!isTextureBinding(binding) || binding.texture === undefined)
+        return undefined;
+    const texCoord = paramNumber(material, `${param}TexCoord`);
+    const transform = material.getParameter(`${param}Transform`);
+    const hasTransform = transform !== undefined &&
+        !(Array.isArray(transform) && transform.length >= 8 && transform.every((v, i) => v === (i % 4 === 0 || i === 4 ? 1 : 0)));
+    return { uvSet: texCoord === 1 ? 1 : 0, transform: hasTransform };
+}
+export function defaultProgramFeatures(material, ctx) {
+    const maps = {};
+    for (const [param, slot] of MAP_PARAMS) {
+        const feature = mapSlot(material, param);
+        if (feature)
+            maps[slot] = feature;
+    }
+    const extensions = [];
+    const push = (glTF) => {
+        if (!extensions.some((e) => e.lobe === glTF))
+            extensions.push({ lobe: glTF, maps: [], bits: {} });
+    };
+    for (const [param, glTF] of EXTENSION_PARAMS) {
+        const value = paramNumber(material, param);
+        if (value !== undefined && value > 0)
+            push(glTF);
+    }
+    for (const glTF of SPECIAL_EXTENSIONS) {
+        if (specialExtensionPresent(material, glTF))
+            push(glTF);
+    }
+    const attrs = new Set(material.requiredAttributes);
+    const skinned = attrs.has("a_joints");
+    const instanced = attrs.has("a_instanceMatrix0") || attrs.has("a_instanceMatrix") || /instanced/i.test(material.shaderKey);
+    const alphaCutoff = paramNumber(material, "u_alphaCutoff") ?? 0;
+    const transparent = material.renderState.blend === true || (material.renderState.blendMode !== undefined && material.renderState.blendMode !== "opaque");
+    const features = {};
+    if (skinned)
+        features["prd06.deform"] = true;
+    void ctx;
+    return {
+        lighting: LIT_SHADER_MARKERS.test(material.shaderKey) ? "lit" : "unlit",
+        maps,
+        extensions,
+        alphaMode: transparent ? "blend" : alphaCutoff > 0 ? "mask" : "opaque",
+        doubleSided: material.renderState.cullMode === "none",
+        vertexColors: attrs.has("a_color"),
+        flatShading: paramNumber(material, "u_flatShading") === 1,
+        // PRD-01 §8.3: Lambert by default (glTF / three.js); Burley is opt-in
+        // (`u_diffuseModel = 1` → DIFFUSE_BURLEY). 01-GENTEST / C-02 + C-03.
+        diffuseModel: paramNumber(material, "u_diffuseModel") === 1 ? "burley" : "lambert",
+        specularAntialiasing: paramNumber(material, "u_specularAntialiasing") !== 0,
+        skinning: skinned ? { influences: attrs.has("a_joints1") ? 8 : 4, palette: "uniform" } : undefined,
+        morph: attrs.has("a_morphTarget") ? { targetBucket: 4, normals: attrs.has("a_morphNormal"), tangents: attrs.has("a_morphTangent") } : undefined,
+        instancing: instanced ? { color: attrs.has("a_instanceColor") } : undefined,
+        features
+    };
+}
+/** True when the geometry carries a full skin (joints + weights). */
+export function geometryHasSkin(has) {
+    return has("a_joints") && has("a_weights");
+}
+/**
+ * #867 (games): the program's feature set follows the geometry, as in
+ * three.js. A primitive or procedural mesh with no `a_uv` cannot sample
+ * uv-set-0 maps (they and the extension lobe maps are dropped); no `a_uv1`
+ * drops uv-set-1 maps; no `a_color` drops vertex colors; no joints/weights
+ * drops skinning segments from `prd06.deform` (morph is texture-driven and
+ * untouched). Normal maps need only uv: the generated program never reads `a_tangent`
+ * (derivative TBN when the geometry has none). Returns `record` itself when
+ * nothing is dropped, so program keys stay stable for complete geometry.
+ */
+export function featuresForGeometry(record, has) {
+    const uv0 = has("a_uv");
+    const uv1 = has("a_uv1");
+    const skin = geometryHasSkin(has);
+    let changed = false;
+    const maps = {};
+    for (const [slot, feature] of Object.entries(record.maps)) {
+        if (!feature)
+            continue;
+        if ((feature.uvSet === 1 ? uv1 : uv0))
+            maps[slot] = feature;
+        else
+            changed = true;
+    }
+    const extensions = uv0
+        ? record.extensions
+        : record.extensions.map((ext) => {
+            if (ext.maps.length === 0)
+                return ext;
+            changed = true;
+            return { ...ext, maps: [] };
+        });
+    const vertexColors = record.vertexColors && has("a_color");
+    if (vertexColors !== record.vertexColors)
+        changed = true;
+    const extraSkin = skin && has("a_joints1") && has("a_weights1");
+    const skinning = skin
+        ? record.skinning?.influences === 8 && !extraSkin
+            ? { ...record.skinning, influences: 4 }
+            : record.skinning
+        : undefined;
+    if (skinning !== record.skinning)
+        changed = true;
+    let features = record.features;
+    const deform = features["prd06.deform"];
+    if (deform !== undefined) {
+        // Selection may combine skinning and texture-driven morphs. Dropping the
+        // whole feature for a geometry without joint attributes freezes morphs.
+        const masked = typeof deform === "string"
+            ? deform.split("|").flatMap((part) => {
+                if (part === "skin4" || part === "skin8")
+                    return skin ? [part === "skin8" && !extraSkin ? "skin4" : part] : [];
+                return [part];
+            }).join("|") || undefined
+            : skin ? deform : undefined;
+        if (masked !== deform) {
+            features = { ...features };
+            if (masked === undefined)
+                delete features["prd06.deform"];
+            else
+                features = { ...features, "prd06.deform": masked };
+            changed = true;
+        }
+    }
+    if (!changed)
+        return record;
+    return { ...record, maps, extensions, vertexColors, skinning, features };
+}
+/** Allow-listed shader → covered by the generated path. */
+export function materialUsesGeneratedProgram(material) {
+    return ALLOWLIST_PROGRAM_SHADERS.has(material.shaderKey);
+}
+/**
+ * Draw-time route. `core` (A3D_QR_CORE generator): every allow-listed material
+ * is generated. `lobes` (PRD-04 `qrMaterialsLobeProgramsOn`): only
+ * allow-listed materials whose record carries an r185 lobe extension are —
+ * otherwise those lobes never reach the GPU under `materials` alone.
+ */
+export function materialRoutesToGeneratedProgram(material, route, ctx) {
+    if (!materialUsesGeneratedProgram(material))
+        return false;
+    if (route.core)
+        return true;
+    return route.lobes && material.programFeatures(ctx).extensions.length > 0;
+}
+/**
+ * §15: "nearest superset" warning when an allow-listed material carries state
+ * the feature derivation cannot see. A `shaderVariant` override is the one
+ * such state today (variants are legacy-library axes the generator does not
+ * model) — the feature record describes the base shader, which is a superset
+ * of nothing; warn so the silent-widening rule is observable.
+ */
+export function materialFeatureWarning(material) {
+    if (!materialUsesGeneratedProgram(material))
+        return null;
+    if (material.shaderVariant !== undefined) {
+        return `material "${material.name}" (${material.shaderKey}) sets shaderVariant "${material.shaderVariant}" — the generated-program path does not model variants; the base feature record (a strict superset's complement) is used`;
+    }
+    return null;
+}
+//# sourceMappingURL=MaterialFeatures.js.map