@aura3d/engine 3.0.1 → 4.0.0

package/dist/rendering/production-runtime/renderProofs.js

@@ -0,0 +1,245 @@
+/**
+ * PRD-15 T2.6 — proof helpers moved verbatim out of `ProductionWebGL2Renderer.ts`
+ * before that wrapper file was deleted (0 changed logic lines). `analyzePixels`,
+ * `summarizeProductionWebGL2Proof` and `summarizeProductionProductionProof` keep
+ * their public identities here so existing imports through the
+ * `production-runtime` barrel resolve unchanged.
+ */
+import { Renderer } from "../Renderer.js";
+import { Texture } from "../Texture.js";
+import { bindTransmissionBackdropCapture, createTransmissionBackdropSource, createSceneColorMipLevels, normalizeTransmissionBackdropCapture } from "./TransmissionBackdropCapture.js";
+import { PRODUCTION_WEBGL2_REQUIRED_FEATURES, RUNTIME_PARITY_WEBGPU_REQUIRED_FEATURES } from "./ProductionRendererTypes.js";
+export function summarizeProductionWebGL2Proof(proof) {
+    const missing = PRODUCTION_WEBGL2_REQUIRED_FEATURES.filter((feature) => {
+        const state = proof.features.find((item) => item.id === feature)?.state;
+        return state !== "supported";
+    });
+    return {
+        pass: missing.length === 0 && proof.realWebGL2 && !proof.mockDevice && !proof.canvas2dProof && proof.diagnostics.drawCalls > 0 && proof.pixels.nonBlackPixels > 0,
+        missing,
+        drawCalls: proof.diagnostics.drawCalls,
+        liveTextures: proof.diagnostics.textures ?? 0,
+        textureBytes: proof.diagnostics.textureBytes ?? 0,
+        nonBlackPixels: proof.pixels.nonBlackPixels,
+        averageLuma: proof.pixels.averageLuma,
+        maxLuma: proof.pixels.maxLuma,
+        uniqueColorBuckets: proof.pixels.uniqueColorBuckets
+    };
+}
+export function summarizeProductionProductionProof(proof) {
+    const requiredFeatures = proof.backend === "webgpu"
+        ? RUNTIME_PARITY_WEBGPU_REQUIRED_FEATURES
+        : PRODUCTION_WEBGL2_REQUIRED_FEATURES;
+    const missing = requiredFeatures.filter((feature) => {
+        const state = proof.features.find((item) => item.id === feature)?.state;
+        return state !== "supported";
+    });
+    return {
+        pass: missing.length === 0 && !proof.mockDevice && !proof.canvas2dProof && proof.diagnostics.drawCalls > 0 && proof.pixels.nonBlackPixels > 0,
+        backend: proof.backend,
+        missing,
+        drawCalls: proof.diagnostics.drawCalls,
+        liveTextures: proof.diagnostics.textures ?? 0,
+        textureBytes: proof.diagnostics.textureBytes ?? 0,
+        nonBlackPixels: proof.pixels.nonBlackPixels,
+        averageLuma: proof.pixels.averageLuma,
+        maxLuma: proof.pixels.maxLuma,
+        uniqueColorBuckets: proof.pixels.uniqueColorBuckets
+    };
+}
+export function analyzePixels(pixels, width, height) {
+    let nonTransparentPixels = 0;
+    let nonBlackPixels = 0;
+    let lumaTotal = 0;
+    let maxLuma = 0;
+    const buckets = new Set();
+    for (let offset = 0; offset + 3 < pixels.length; offset += 4) {
+        const r = pixels[offset] ?? 0;
+        const g = pixels[offset + 1] ?? 0;
+        const b = pixels[offset + 2] ?? 0;
+        const a = pixels[offset + 3] ?? 0;
+        if (a > 0)
+            nonTransparentPixels += 1;
+        if (r + g + b > 12)
+            nonBlackPixels += 1;
+        const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+        lumaTotal += luma;
+        maxLuma = Math.max(maxLuma, luma);
+        buckets.add(((r >> 4) << 8) | ((g >> 4) << 4) | (b >> 4));
+    }
+    const centerOffset = ((Math.floor(height / 2) * width) + Math.floor(width / 2)) * 4;
+    return {
+        width,
+        height,
+        nonTransparentPixels,
+        nonBlackPixels,
+        averageLuma: pixels.length > 0 ? lumaTotal / (pixels.length / 4) : 0,
+        maxLuma,
+        uniqueColorBuckets: buckets.size,
+        centerPixel: [
+            pixels[centerOffset] ?? 0,
+            pixels[centerOffset + 1] ?? 0,
+            pixels[centerOffset + 2] ?? 0,
+            pixels[centerOffset + 3] ?? 0
+        ]
+    };
+}
+function createCurrentRoutesTimingAccumulator() {
+    const source = hasPerformanceNow() ? "performance-now" : "date-now";
+    const startedAt = readCurrentRoutesNow(source);
+    let renderMs = 0;
+    let readbackMs = 0;
+    let pixelAnalysisMs = 0;
+    let transmissionBackdropCaptureMs = 0;
+    let hasReadback = false;
+    let hasPixelAnalysis = false;
+    let hasTransmissionBackdropCapture = false;
+    const elapsed = (start) => Math.max(0, readCurrentRoutesNow(source) - start);
+    return {
+        now: () => readCurrentRoutesNow(source),
+        addRender(start) {
+            renderMs += elapsed(start);
+        },
+        addReadback(start) {
+            hasReadback = true;
+            readbackMs += elapsed(start);
+        },
+        addPixelAnalysis(start) {
+            hasPixelAnalysis = true;
+            pixelAnalysisMs += elapsed(start);
+        },
+        addTransmissionBackdropCapture(start) {
+            hasTransmissionBackdropCapture = true;
+            transmissionBackdropCaptureMs += elapsed(start);
+        },
+        snapshot() {
+            return {
+                source,
+                totalMs: elapsed(startedAt),
+                renderMs,
+                ...(hasReadback ? { readbackMs } : {}),
+                ...(hasPixelAnalysis ? { pixelAnalysisMs } : {}),
+                ...(hasTransmissionBackdropCapture ? { transmissionBackdropCaptureMs } : {})
+            };
+        }
+    };
+}
+function hasPerformanceNow() {
+    return typeof globalThis.performance?.now === "function";
+}
+function readCurrentRoutesNow(source) {
+    return source === "performance-now" ? globalThis.performance.now() : Date.now();
+}
+/**
+ * A production frame must contain real renderable content: at least one mesh
+ * primitive with a material, or contributor-drawn content (which brings its own
+ * geometry and program, so the mesh/material counts do not describe it).
+ */
+export function validateProductionRendererInput(input, content) {
+    const hasMeshes = input.metadata.primitiveCount > 0 && input.metadata.meshCount > 0;
+    const hasContributorContent = (content?.contributorDrawnNodes ?? 0) > 0;
+    if (!hasMeshes && !hasContributorContent) {
+        throw new Error("Production render path requires at least one real mesh primitive.");
+    }
+    if (hasMeshes && input.metadata.materialCount <= 0) {
+        throw new Error("Production render path requires at least one real material.");
+    }
+}
+export function rendererFeatureReport(renderer, diagnostics = renderer.getDiagnostics(), input, pixels) {
+    const capabilities = new Set(renderer.device.info.capabilities ?? []);
+    const feature = (id, state, detail) => ({ id, state, detail });
+    return [
+        feature("real-webgl2-context", renderer.device.kind === "webgl2" ? "supported" : "blocked", `backend=${renderer.device.kind}`),
+        feature("no-canvas2d-proof", "supported", "Render proof is produced by Renderer/WebGL2 and readPixels, not Canvas 2D drawing."),
+        feature("no-mock-device", renderer.device.kind === "mock" ? "blocked" : "supported", "Production renderer creation refuses mock backend creation."),
+        feature("imported-gltf-render-source", input && input.metadata.primitiveCount > 0 ? "supported" : "partial", input ? `${input.metadata.assetId}: ${input.metadata.primitiveCount} primitives` : "Awaiting imported asset render input."),
+        feature("pbr-materials", input && input.metadata.materialCount > 0 ? "supported" : "partial", input ? `${input.metadata.materialCount} glTF materials in render metadata` : "Awaiting imported asset metadata."),
+        feature("texture-upload-diagnostics", (diagnostics.textures ?? 0) > 0 ? "supported" : "partial", `${diagnostics.textures ?? 0} live textures, ${diagnostics.textureBytes ?? 0} bytes`),
+        feature("render-target-diagnostics", diagnostics.renderTargets !== undefined ? "supported" : "partial", `${diagnostics.renderTargets ?? 0} live render targets`),
+        feature("draw-call-diagnostics", diagnostics.drawCalls > 0 ? "supported" : "partial", `${diagnostics.drawCalls} draw calls in last frame`),
+        feature("pixel-readback", pixels && pixels.nonBlackPixels > 0 ? "supported" : "partial", pixels ? `${pixels.nonBlackPixels} non-black pixels` : "Awaiting frame readback."),
+        feature("hdr-ibl-ready", capabilities.has("hdr-image-based-lighting") ? "supported" : "partial", `capabilities=${[...capabilities].join(",")}`),
+        feature("anisotropic-texture-filtering", capabilities.has("anisotropic-texture-filtering") ? "supported" : "partial", "WebGL EXT_texture_filter_anisotropic for sharper angled PBR texture sampling."),
+        feature("scene-color-transmission-capture", input?.transmissionBackdropCapture ? "supported" : "partial", input?.transmissionBackdropCapture
+            ? "Renderer-owned first-pass scene-color readback is rebound as u_transmissionBackdropTexture for the final A3D transmission pass."
+            : "Transmission backdrop capture was not requested for this proof.")
+    ];
+}
+export function rendererInteractiveFeatureReport(renderer, diagnostics, input) {
+    return rendererFeatureReport(renderer, diagnostics, input).filter((feature) => feature.id !== "pixel-readback" && feature.id !== "scene-color-transmission-capture");
+}
+export function rendererShadowReport(renderer) {
+    return renderer.getShadowEvidence();
+}
+function rendererFrameSize(renderer, input) {
+    const canvas = renderer.device.canvas;
+    const width = input.viewport?.width ?? canvas?.width;
+    const height = input.viewport?.height ?? canvas?.height;
+    if (width === undefined || height === undefined) {
+        throw new Error("rendererProofCapture needs input.viewport when the render device exposes no canvas surface.");
+    }
+    return { width, height };
+}
+export function rendererProofCapture(renderer, input) {
+    validateProductionRendererInput(input);
+    const { width, height } = rendererFrameSize(renderer, input);
+    const timing = createCurrentRoutesTimingAccumulator();
+    let transmissionBackdropCapture;
+    let transmissionBackdropTexture;
+    const captureOptions = normalizeTransmissionBackdropCapture(input.transmissionBackdropCapture);
+    if (captureOptions) {
+        const backdrop = createTransmissionBackdropSource(input.source);
+        const captureStart = timing.now();
+        const captureRenderStart = timing.now();
+        renderer.render(backdrop.source, input.camera);
+        timing.addRender(captureRenderStart);
+        const captureReadbackStart = timing.now();
+        const scenePixels = renderer.device.readPixels(0, 0, width, height);
+        timing.addReadback(captureReadbackStart);
+        const mipLevels = createSceneColorMipLevels(scenePixels, width, height);
+        transmissionBackdropTexture = new Texture({
+            width,
+            height,
+            colorSpace: "srgb",
+            mipLevels,
+            label: "a3d-renderer-owned-scene-color-transmission-backdrop"
+        });
+        const materialBindings = bindTransmissionBackdropCapture(input.source, transmissionBackdropTexture, captureOptions);
+        transmissionBackdropCapture = {
+            mode: "renderer-owned-scene-color-readback",
+            width,
+            height,
+            byteLength: scenePixels.byteLength,
+            mipCount: mipLevels.length,
+            strength: captureOptions.strength,
+            refractionScale: captureOptions.refractionScale,
+            materialBindings,
+            excludedTransmissionItems: backdrop.excludedTransmissionItems
+        };
+        timing.addTransmissionBackdropCapture(captureStart);
+    }
+    const renderStart = timing.now();
+    const diagnostics = renderer.render(input.source, input.camera);
+    timing.addRender(renderStart);
+    const readbackStart = timing.now();
+    const pixelBytes = renderer.device.readPixels(0, 0, width, height);
+    timing.addReadback(readbackStart);
+    const analysisStart = timing.now();
+    const pixels = analyzePixels(pixelBytes, width, height);
+    timing.addPixelAnalysis(analysisStart);
+    transmissionBackdropTexture?.dispose();
+    const features = rendererFeatureReport(renderer, diagnostics, input, pixels);
+    return {
+        backend: renderer.device.kind,
+        realWebGL2: renderer.device.kind === "webgl2",
+        mockDevice: renderer.device.kind === "mock",
+        canvas2dProof: false,
+        importedAsset: input.metadata,
+        diagnostics,
+        features,
+        pixels,
+        timing: timing.snapshot(),
+        ...(transmissionBackdropCapture ? { transmissionBackdropCapture } : {})
+    };
+}
+//# sourceMappingURL=renderProofs.js.map

package/dist/rendering/production-runtime/renderProofs.js.map

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

package/dist/rendering/program/DFGLut.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 { Texture } from "../Texture.js";
+import { TextureBinding } from "../TextureBinding.js";
+/** RG16F → RGBA16F (B = 0, A = 1); R/G bit-identical to r185 DFGLUTData. */
+export declare function dfgLutRgba16f(): Uint16Array;
+/** The shared DFG LUT texture (created on first use). */
+export declare function dfgLutTexture(): Texture;
+/** `u_dfgLut` binding for generated programs. */
+export declare function dfgLutBinding(): TextureBinding;
+//# sourceMappingURL=DFGLut.d.ts.map

package/dist/rendering/program/DFGLut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DFGLut.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/program/DFGLut.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOnD,4EAA4E;AAC5E,wBAAgB,aAAa,IAAI,WAAW,CAU3C;AAKD,yDAAyD;AACzD,wBAAgB,aAAa,IAAI,OAAO,CAUvC;AAED,iDAAiD;AACjD,wBAAgB,aAAa,IAAI,cAAc,CAQ9C"}

package/dist/rendering/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/rendering/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/rendering/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/rendering/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/rendering/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/rendering/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/rendering/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/rendering/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/rendering/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/rendering/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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"}