@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/materials/features.d.ts

@@ -0,0 +1,47 @@
+/**
+ * materials/features.ts — PRD-04 C-02 ShaderFeatures (P3-3):
+ *   prd04.uvTransform   (fragment:pars, per-slot mat3, KHR_texture_transform)
+ *   prd04.tangentFrame  (vertex:world + fragment:normal)
+ *   prd04.debugView     (fragment:end, A3D_PRD04_DEBUG_VIEW_<NAME>)
+ * plus `uvTransformMatrix`, the spec-faithful CPU matrix builder.
+ *
+ * Registered from the rendering lane barrel; registry state only until the
+ * C-02 generator splices feature chunks.
+ */
+import { type ShaderFeature } from "../contracts/program.js";
+/**
+ * KHR_texture_transform matrix per PRD-04 §8.9: `T · R · S` with
+ * `R = [[c, s], [-s, c]]` — the spec's counter-clockwise UV rotation in
+ * glTF's top-left-origin UV space. Returned column-major (GLSL `mat3`
+ * constructor order, same layout as `THREE.Matrix3.elements`).
+ *
+ * For uniform scale the elements are numerically identical to three's
+ * `Matrix3.setUvTransform(ox, oy, s, s, r, 0, 0)`; for non-uniform scale with
+ * `r ≠ 0` they intentionally differ (three composes `S · R`, which bakes the
+ * rotation into the wrong axes — the README formula applies it in UV space).
+ */
+export declare function uvTransformMatrix(offset: readonly [number, number], rotation: number, scale: readonly [number, number]): Float32Array;
+/**
+ * `u_prd04DebugView` numeric channel selector (UniformValue has no string
+ * type): ids 1..15 emit `A3D_PRD04_DEBUG_VIEW_<NAME>`; ids 101..115 emit the
+ * `<NAME>EFFECTIVE` variant (the value the lobe receives, PRD-04 §8.10/P3-3).
+ */
+export declare const PRD04_DEBUG_VIEW_CHANNELS: readonly ["BASECOLOR", "NORMAL", "METALLIC", "ROUGHNESS", "EMISSIVE", "OCCLUSION", "ALPHA", "CLEARCOAT", "SHEENCOLOR", "IRIDESCENCE", "ANISOTROPY", "TRANSMISSION", "TANGENT", "UV0", "UV1"];
+export declare function prd04DebugViewDefineName(value: number): string | undefined;
+/**
+ * `prd04.alphaToCoverage` (P5-5): `a3d_prd04_alpha_a2c` splices at `fragment:alpha` for MASK
+ * materials that requested alpha-to-coverage (`renderState.alphaToCoverage`, set by
+ * `renderStateForGLTFMaterial` under the lane flag) and only when the tier's framebuffer
+ * carries MSAA samples — on a 0-sample tier the smoothing has nothing to write into and the
+ * plain MASK discard path keeps running.
+ */
+export declare const alphaToCoverageFeature: ShaderFeature;
+/**
+ * `prd04.rim` (#88, R-14-14 §8.10): view-dependent rim emission on lit generated
+ * programs. Selected iff the material carries `u_prd04RimStrength > 0`; the rim
+ * colour defaults to white and the falloff power to 3 when the material omits them.
+ */
+export declare const rimFeature: ShaderFeature;
+/** Registers the PRD-04 ShaderFeatures; idempotent. */
+export declare function registerPrd04ShaderFeatures(): void;
+//# sourceMappingURL=features.d.ts.map

package/dist/rendering/materials/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/materials/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAC;AAO9B;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,YAAY,CAad;AA4FD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,8LAI5B,CAAC;AAEX,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM1E;AAuED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAoBpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,aAoBxB,CAAC;AAMF,uDAAuD;AACvD,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}

package/dist/rendering/materials/features.js

@@ -0,0 +1,282 @@
+/**
+ * materials/features.ts — PRD-04 C-02 ShaderFeatures (P3-3):
+ *   prd04.uvTransform   (fragment:pars, per-slot mat3, KHR_texture_transform)
+ *   prd04.tangentFrame  (vertex:world + fragment:normal)
+ *   prd04.debugView     (fragment:end, A3D_PRD04_DEBUG_VIEW_<NAME>)
+ * plus `uvTransformMatrix`, the spec-faithful CPU matrix builder.
+ *
+ * Registered from the rendering lane barrel; registry state only until the
+ * C-02 generator splices feature chunks.
+ */
+import { registerShaderFeature } from "../contracts/program.js";
+import { Material } from "../Material.js";
+import { MaterialInstance } from "../MaterialInstance.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { capturedTransmissionTarget } from "../forward/transmissionTargetStore.js";
+/**
+ * KHR_texture_transform matrix per PRD-04 §8.9: `T · R · S` with
+ * `R = [[c, s], [-s, c]]` — the spec's counter-clockwise UV rotation in
+ * glTF's top-left-origin UV space. Returned column-major (GLSL `mat3`
+ * constructor order, same layout as `THREE.Matrix3.elements`).
+ *
+ * For uniform scale the elements are numerically identical to three's
+ * `Matrix3.setUvTransform(ox, oy, s, s, r, 0, 0)`; for non-uniform scale with
+ * `r ≠ 0` they intentionally differ (three composes `S · R`, which bakes the
+ * rotation into the wrong axes — the README formula applies it in UV space).
+ */
+export function uvTransformMatrix(offset, rotation, scale) {
+    const c = Math.cos(rotation);
+    const s = Math.sin(rotation);
+    const [sx, sy] = scale;
+    // Matrix rows (column-vector apply M · uv):
+    //   [ c*sx,  s*sy, ox ]
+    //   [ -s*sx, c*sy, oy ]
+    //   [ 0,     0,    1  ]
+    return new Float32Array([
+        c * sx, -s * sx, 0,
+        s * sy, c * sy, 0,
+        offset[0], offset[1], 1
+    ]);
+}
+const FLAG = "A3D_QR_MATERIALS";
+const OWNER = "prd04";
+/** Slots that may carry u_<slot>UvTransform (PRD-04 §8.9). */
+const UV_TRANSFORM_SLOTS = [
+    "baseColor", "normal", "metallicRoughness", "occlusion", "emissive",
+    "clearcoat", "clearcoatRoughness", "clearcoatNormal",
+    "transmission", "diffuseTransmission", "diffuseTransmissionColor",
+    "volumeThickness", "specular", "specularColor",
+    "sheenColor", "sheenRoughness", "anisotropy",
+    "iridescence", "iridescenceThickness"
+];
+/**
+ * Resolve the base material's render state across `Material`/`MaterialInstance`. The return
+ * type admits C-04's `alphaToCoverage`, which `renderStateForGLTFMaterial` sets at runtime
+ * even though the material `RenderState` type predates it (see P5-5).
+ */
+function renderStateOf(material) {
+    if (material instanceof MaterialInstance)
+        return material.baseMaterial.renderState;
+    if (material instanceof Material)
+        return material.renderState;
+    return undefined;
+}
+/** u_<slot>UvTransform mat3 (Float32Array, 9) stored on the material, if any. */
+function transformParam(material, slot) {
+    const v = material?.getParameter(`u_${slot}UvTransform`);
+    return v instanceof Float32Array && v.length === 9 ? v : undefined;
+}
+const uvTransformFeature = {
+    id: "prd04.uvTransform",
+    owner: OWNER,
+    flag: FLAG,
+    hooks: ["fragment:pars"],
+    chunks: ["a3d_prd04_uv_transform"],
+    select(input) {
+        const material = input.item.material;
+        let mask = 0;
+        UV_TRANSFORM_SLOTS.forEach((slot, i) => {
+            if (transformParam(material, slot) !== undefined)
+                mask |= 1 << i;
+        });
+        return mask === 0 ? undefined : mask;
+    },
+    defines(value) {
+        return { A3D_PRD04_UV_TRANSFORM_MASK: typeof value === "number" ? value : 0 };
+    },
+    bindUniforms(_value, item, set) {
+        const material = item.material;
+        for (const slot of UV_TRANSFORM_SLOTS) {
+            const mat = transformParam(material, slot);
+            if (mat)
+                set(`u_${slot}UvTransform`, mat);
+        }
+    }
+};
+/** Materials needing the tangent frame carry at least one of these params. */
+const TANGENT_FRAME_PARAMS = [
+    "u_normalTextureEnabled",
+    "u_anisotropyTextureEnabled",
+    "u_clearcoatNormalTextureEnabled",
+    "u_prd04TangentFrame"
+];
+const tangentFrameFeature = {
+    id: "prd04.tangentFrame",
+    owner: OWNER,
+    flag: FLAG,
+    hooks: ["vertex:world", "fragment:normal"],
+    // T0-05 pars/call split: one call chunk per hook (index-mapped); both
+    // require a3d_prd04_tangent_frame_state → a3d_prd04_tangent_frame.
+    chunks: ["a3d_prd04_tangent_frame_vertex_call", "a3d_prd04_tangent_frame_call"],
+    select(input) {
+        const material = input.item.material;
+        if (!material)
+            return undefined;
+        for (const name of TANGENT_FRAME_PARAMS) {
+            const v = material.getParameter(name);
+            if (typeof v === "number" && v !== 0)
+                return true;
+        }
+        return undefined;
+    },
+    defines(value) {
+        // Chunk guards are `#ifdef`: emit the define only when active (a `0`
+        // value would still satisfy `#ifdef`).
+        return value === true ? { A3D_PRD04_TANGENT_FRAME: 1 } : {};
+    }
+};
+/**
+ * `u_prd04DebugView` numeric channel selector (UniformValue has no string
+ * type): ids 1..15 emit `A3D_PRD04_DEBUG_VIEW_<NAME>`; ids 101..115 emit the
+ * `<NAME>EFFECTIVE` variant (the value the lobe receives, PRD-04 §8.10/P3-3).
+ */
+export const PRD04_DEBUG_VIEW_CHANNELS = [
+    "BASECOLOR", "NORMAL", "METALLIC", "ROUGHNESS", "EMISSIVE", "OCCLUSION",
+    "ALPHA", "CLEARCOAT", "SHEENCOLOR", "IRIDESCENCE", "ANISOTROPY",
+    "TRANSMISSION", "TANGENT", "UV0", "UV1"
+];
+export function prd04DebugViewDefineName(value) {
+    if (!Number.isInteger(value) || value <= 0)
+        return undefined;
+    const effective = value > 100;
+    const index = (effective ? value - 100 : value) - 1;
+    const name = PRD04_DEBUG_VIEW_CHANNELS[index];
+    return name === undefined ? undefined : `A3D_PRD04_DEBUG_VIEW_${name}${effective ? "EFFECTIVE" : ""}`;
+}
+const debugViewFeature = {
+    id: "prd04.debugView",
+    owner: OWNER,
+    flag: FLAG,
+    hooks: ["fragment:end"],
+    chunks: ["a3d_prd04_debug_view_call"],
+    select(input) {
+        const material = input.item.material;
+        const v = material?.getParameter("u_prd04DebugView");
+        return typeof v === "number" && prd04DebugViewDefineName(v) !== undefined ? v : undefined;
+    },
+    defines(value) {
+        const name = typeof value === "number" ? prd04DebugViewDefineName(value) : undefined;
+        return name === undefined ? {} : { [name]: true };
+    }
+};
+/**
+ * `prd04.transmissionTarget` (P4-2): generated programs sample the lane
+ * capture for KHR_materials_transmission/volume. The texture itself is a
+ * frame resource — the C-01 path rebinds `a3d_prd04_transmissionSampler` per
+ * frame from the `prd04.transmissionTarget` blackboard entry; `bindUniforms`
+ * additionally forwards `u_prd04TransmissionTarget(Size)` material params so
+ * a captured target can be pinned on the material for tests. The legacy
+ * per-material `transmissionBackdropTexture` option is never read here.
+ */
+const transmissionTargetFeature = {
+    id: "prd04.transmissionTarget",
+    owner: OWNER,
+    flag: "A3D_QR_MATERIALS_TRANSMISSION",
+    // T0-05: declaration only — the refraction itself is the transmission
+    // lobe's `ibl` call (lobe_calls.glsl.ts). Previously `a3d_prd04_volume` was
+    // index-mapped to `fragment:indirect`, splicing function definitions into
+    // `main()` and replacing the default indirect body.
+    hooks: ["fragment:pars"],
+    chunks: ["a3d_prd04_transmission"],
+    select(input) {
+        const material = input.item.material;
+        if (!material)
+            return undefined;
+        for (const name of ["u_transmissionFactor", "u_diffuseTransmissionFactor", "u_volumeThicknessFactor"]) {
+            const v = material.getParameter(name);
+            if (typeof v === "number" && v > 0.001)
+                return true;
+        }
+        return undefined;
+    },
+    defines(value) {
+        // `a3d_prd04_transmission` / `a3d_prd04_volume` guard on A3D_TRANSMISSION.
+        return value === true ? { A3D_TRANSMISSION: 1 } : {};
+    },
+    bindUniforms(_value, item, set) {
+        // T0-05 review: bind the captured opaque-scene copy (the capture pass
+        // records it in transmissionTargetStore); a material-pinned target wins.
+        const material = item.material;
+        const captured = capturedTransmissionTarget();
+        const target = material?.getParameter("u_prd04TransmissionTarget");
+        if (target !== undefined) {
+            set("a3d_prd04_transmissionSampler", target);
+        }
+        else if (captured) {
+            set("a3d_prd04_transmissionSampler", new TextureBinding({ name: "a3d_prd04_transmissionSampler", texture: captured.texture, required: false }));
+        }
+        const size = material?.getParameter("u_prd04TransmissionTargetSize");
+        if (size !== undefined) {
+            set("a3d_prd04_transmissionSamplerSize", size);
+        }
+        else if (captured) {
+            set("a3d_prd04_transmissionSamplerSize", new Float32Array([captured.width, captured.height]));
+        }
+    }
+};
+/**
+ * `prd04.alphaToCoverage` (P5-5): `a3d_prd04_alpha_a2c` splices at `fragment:alpha` for MASK
+ * materials that requested alpha-to-coverage (`renderState.alphaToCoverage`, set by
+ * `renderStateForGLTFMaterial` under the lane flag) and only when the tier's framebuffer
+ * carries MSAA samples — on a 0-sample tier the smoothing has nothing to write into and the
+ * plain MASK discard path keeps running.
+ */
+export const alphaToCoverageFeature = {
+    id: "prd04.alphaToCoverage",
+    owner: OWNER,
+    flag: FLAG,
+    hooks: ["fragment:alpha"],
+    chunks: ["a3d_prd04_alpha_a2c_call"],
+    select(input) {
+        const material = input.item.material;
+        if (!material)
+            return undefined;
+        const cutoff = material.getParameter("u_alphaCutoff");
+        const maskMode = typeof cutoff === "number" && cutoff > 0;
+        return maskMode
+            && renderStateOf(material)?.alphaToCoverage === true
+            && (input.tier.msaaSamples ?? 0) > 0 ? true : undefined;
+    },
+    defines(value) {
+        // ALPHA_TO_COVERAGE also stops the generator's alpha chunk from applying a
+        // second hard cutoff after the smoothstep.
+        return value === true ? { A3D_PRD04_ALPHA_TO_COVERAGE: 1, ALPHA_TO_COVERAGE: 1 } : {};
+    }
+};
+/**
+ * `prd04.rim` (#88, R-14-14 §8.10): view-dependent rim emission on lit generated
+ * programs. Selected iff the material carries `u_prd04RimStrength > 0`; the rim
+ * colour defaults to white and the falloff power to 3 when the material omits them.
+ */
+export const rimFeature = {
+    id: "prd04.rim",
+    owner: OWNER,
+    flag: FLAG,
+    hooks: ["fragment:emissive"],
+    chunks: ["a3d_prd04_rim_call"],
+    select(input) {
+        const material = input.item.material;
+        const strength = material?.getParameter("u_prd04RimStrength");
+        return typeof strength === "number" && strength > 0 ? true : undefined;
+    },
+    defines(value) {
+        return value === true ? { A3D_PRD04_RIM: 1 } : {};
+    },
+    bindUniforms(_value, item, set) {
+        const material = item.material;
+        set("u_prd04RimStrength", material?.getParameter("u_prd04RimStrength") ?? 0);
+        set("u_prd04RimColor", material?.getParameter("u_prd04RimColor") ?? new Float32Array([1, 1, 1]));
+        set("u_prd04RimPower", material?.getParameter("u_prd04RimPower") ?? 3);
+    }
+};
+const FEATURES = [uvTransformFeature, tangentFrameFeature, debugViewFeature, transmissionTargetFeature, alphaToCoverageFeature, rimFeature];
+let registered = false;
+/** Registers the PRD-04 ShaderFeatures; idempotent. */
+export function registerPrd04ShaderFeatures() {
+    if (registered)
+        return;
+    for (const feature of FEATURES)
+        registerShaderFeature(feature);
+    registered = true;
+}
+//# sourceMappingURL=features.js.map

package/dist/rendering/materials/features.js.map

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

package/dist/rendering/materials/lobes.d.ts

@@ -0,0 +1,3 @@
+/** Registers all PRD-04 lobes; idempotent (lane barrel + tests may both call). */
+export declare function registerPrd04MaterialLobes(): void;
+//# sourceMappingURL=lobes.d.ts.map

package/dist/rendering/materials/lobes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lobes.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/materials/lobes.ts"],"names":[],"mappings":"AA4PA,kFAAkF;AAClF,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD"}

package/dist/rendering/materials/lobes.js

@@ -0,0 +1,225 @@
+/**
+ * materials/lobes.ts — C-03 `registerMaterialLobe` calls for the eleven PRD-04
+ * lobes (P3-2). Registration is registry state only (owner "prd04", flag
+ * `A3D_QR_MATERIALS`); lobes take render effect once the C-02 generator is
+ * real. `bind()` writes the same `u_*` uniform names the production runtime
+ * already uses (`GLTFRenderResources`), so the overrides/inspect seam reads
+ * generated-path values identically.
+ *
+ * `MaterialLobeInput.parameters` keys are glTF factor names
+ * (`clearcoatFactor`, `iridescenceIor`, …) as produced by
+ * `physicalMaterialLobeInput()`; `textures` keys are `PhysicalMapSlot` names.
+ */
+import { registerMaterialLobe } from "../contracts/materialLobes.js";
+import { TextureBinding } from "../TextureBinding.js";
+const FLAG = "A3D_QR_MATERIALS";
+/** Generator-owned map slots (u_*Map samplers), never rebound by a lobe. */
+const CORE_SLOTS = new Set(["baseColor", "normal", "metallicRoughness", "occlusion", "emissive"]);
+const OWNER = "prd04";
+const num = (p, key, fallback = 0) => typeof p[key] === "number" ? p[key] : fallback;
+const vec3 = (p, key, fallback) => Array.isArray(p[key]) ? p[key] : fallback;
+const tex = (t, slot) => t[slot];
+/** Slots actually bound, intersected with the lobe's sampler slots. */
+const boundSlots = (t, slots) => slots.filter((slot) => t[slot] !== undefined);
+/**
+ * T0-05 pars/call split (shaders/physical/lobe_calls.glsl.ts): `pars` is a
+ * global-scope declaration chunk, `fragment` a call chunk spliced at
+ * `fragment:material`, `ibl` a call chunk appended to `fragment:indirect`.
+ * Previously `fragment` named the function chunk itself, which the generator
+ * spliced inside `main()` (function definitions there do not compile).
+ */
+function lobe(entry) {
+    return {
+        id: entry.id,
+        owner: OWNER,
+        flag: FLAG,
+        ...(entry.order !== undefined ? { order: entry.order } : {}),
+        glTFExtension: entry.glTFExtension,
+        chunks: entry.chunks,
+        samplerSlots: entry.samplerSlots,
+        feature(material) {
+            return entry.active(material.parameters, material.textures)
+                ? {
+                    lobe: entry.id,
+                    maps: boundSlots(material.textures, entry.samplerSlots),
+                    bits: entry.bits?.(material.parameters, material.textures) ?? {}
+                }
+                : undefined;
+        },
+        bind(material, set) {
+            entry.bind(material.parameters, (u, v) => set(u, v));
+            // 04-LOBES: bound lobe textures go to the sampler the pars chunk declares
+            // (`u_<slot>Texture`, the glTF parameter name). Core map slots are the
+            // generator's own samplers and are never rebound here.
+            for (const slot of entry.samplerSlots) {
+                const texture = tex(material.textures, slot);
+                if (!texture || CORE_SLOTS.has(slot))
+                    continue;
+                const name = `u_${slot}Texture`;
+                set(name, new TextureBinding({ name, texture, required: false }));
+            }
+        }
+    };
+}
+const LOBES = [
+    lobe({
+        id: "ior",
+        glTFExtension: "KHR_materials_ior",
+        chunks: { pars: "a3d_prd04_specular_ior", fragment: "a3d_prd04_specular_ior_call" },
+        samplerSlots: [],
+        active: (p) => num(p, "ior", 1.5) !== 1.5 ||
+            num(p, "specularFactor") > 0 ||
+            num(p, "transmissionFactor") > 0 ||
+            num(p, "clearcoatFactor") > 0,
+        bits: (p) => ({ ior: num(p, "ior", 1.5) }),
+        bind: (p, set) => set("u_ior", num(p, "ior", 1.5))
+    }),
+    lobe({
+        id: "specular",
+        glTFExtension: "KHR_materials_specular",
+        chunks: { pars: "a3d_prd04_specular_ior", fragment: "a3d_prd04_specular_ior_call" },
+        samplerSlots: ["specular", "specularColor"],
+        active: (p, t) => p.specularFactor !== undefined ||
+            tex(t, "specular") !== undefined ||
+            tex(t, "specularColor") !== undefined,
+        bits: (p, t) => ({
+            specularMap: tex(t, "specular") !== undefined,
+            specularColorMap: tex(t, "specularColor") !== undefined
+        }),
+        bind: (p, set) => {
+            set("u_specularFactor", num(p, "specularFactor", 1));
+            set("u_specularColorFactor", vec3(p, "specularColorFactor", [1, 1, 1]));
+        }
+    }),
+    lobe({
+        id: "clearcoat",
+        order: 30,
+        glTFExtension: "KHR_materials_clearcoat",
+        chunks: { pars: "a3d_prd04_clearcoat_pars", fragment: "a3d_prd04_clearcoat_call", ibl: "a3d_prd04_clearcoat_ibl_call", direct: "a3d_prd04_clearcoat_direct_call" },
+        samplerSlots: ["clearcoat", "clearcoatRoughness", "clearcoatNormal"],
+        active: (p, t) => num(p, "clearcoatFactor") > 0 ||
+            tex(t, "clearcoat") !== undefined ||
+            tex(t, "clearcoatRoughness") !== undefined ||
+            tex(t, "clearcoatNormal") !== undefined,
+        bits: (p, t) => ({
+            map: tex(t, "clearcoat") !== undefined,
+            roughnessMap: tex(t, "clearcoatRoughness") !== undefined,
+            normalMap: tex(t, "clearcoatNormal") !== undefined
+        }),
+        bind: (p, set) => {
+            set("u_clearcoatFactor", num(p, "clearcoatFactor"));
+            set("u_clearcoatRoughnessFactor", num(p, "clearcoatRoughnessFactor"));
+            set("u_clearcoatNormalScale", num(p, "clearcoatNormalScale", 1));
+        }
+    }),
+    lobe({
+        id: "sheen",
+        order: 20,
+        glTFExtension: "KHR_materials_sheen",
+        chunks: { pars: "a3d_prd04_sheen_pars", fragment: "a3d_prd04_sheen_call", ibl: "a3d_prd04_sheen_ibl_call", direct: "a3d_prd04_sheen_direct_call" },
+        samplerSlots: ["sheenColor", "sheenRoughness"],
+        active: (p, t) => p.sheenColorFactor !== undefined ||
+            tex(t, "sheenColor") !== undefined ||
+            tex(t, "sheenRoughness") !== undefined,
+        bits: (p, t) => ({
+            colorMap: tex(t, "sheenColor") !== undefined,
+            roughnessMap: tex(t, "sheenRoughness") !== undefined
+        }),
+        bind: (p, set) => {
+            set("u_sheenColorFactor", vec3(p, "sheenColorFactor", [0, 0, 0]));
+            set("u_sheenRoughnessFactor", num(p, "sheenRoughnessFactor"));
+        }
+    }),
+    lobe({
+        id: "iridescence",
+        order: 5,
+        glTFExtension: "KHR_materials_iridescence",
+        chunks: { pars: "a3d_prd04_iridescence_pars", fragment: "a3d_prd04_iridescence_call", ibl: "a3d_prd04_iridescence_ibl_call", direct: "a3d_prd04_iridescence_direct_call" },
+        samplerSlots: ["iridescence", "iridescenceThickness"],
+        active: (p, t) => num(p, "iridescenceFactor") > 0 ||
+            tex(t, "iridescence") !== undefined,
+        bits: (p, t) => ({
+            map: tex(t, "iridescence") !== undefined,
+            thicknessMap: tex(t, "iridescenceThickness") !== undefined
+            // `film` is seeded by physicalFeatureSet from ctx.tier (Low → Schlick).
+        }),
+        bind: (p, set) => {
+            set("u_iridescenceFactor", num(p, "iridescenceFactor"));
+            set("u_iridescenceIor", num(p, "iridescenceIor", 1.3));
+            set("u_iridescenceThicknessMinimum", num(p, "iridescenceThicknessMinimum", 100));
+            set("u_iridescenceThicknessMaximum", num(p, "iridescenceThicknessMaximum", 400));
+        }
+    }),
+    lobe({
+        id: "anisotropy",
+        order: 5,
+        glTFExtension: "KHR_materials_anisotropy",
+        chunks: { pars: "a3d_prd04_anisotropy_pars", fragment: "a3d_prd04_anisotropy_call", ibl: "a3d_prd04_anisotropy_ibl_call", direct: "a3d_prd04_anisotropy_direct_call" },
+        samplerSlots: ["anisotropy"],
+        active: (p, t) => num(p, "anisotropyStrength") > 0 || tex(t, "anisotropy") !== undefined,
+        bits: (p, t) => ({ map: tex(t, "anisotropy") !== undefined }),
+        bind: (p, set) => {
+            set("u_anisotropyStrength", num(p, "anisotropyStrength"));
+            set("u_anisotropyRotation", num(p, "anisotropyRotation"));
+        }
+    }),
+    lobe({
+        id: "transmission",
+        order: 10,
+        glTFExtension: "KHR_materials_transmission",
+        chunks: { pars: "a3d_prd04_transmission_pars", fragment: "a3d_prd04_transmission_call", ibl: "a3d_prd04_transmission_ibl_call" },
+        samplerSlots: ["transmission"],
+        active: (p, t) => num(p, "transmissionFactor") > 0 || tex(t, "transmission") !== undefined,
+        bits: (p, t) => ({ map: tex(t, "transmission") !== undefined }),
+        bind: (p, set) => set("u_transmissionFactor", num(p, "transmissionFactor"))
+    }),
+    lobe({
+        id: "volume",
+        glTFExtension: "KHR_materials_volume",
+        chunks: { pars: "a3d_prd04_volume_pars", fragment: "a3d_prd04_volume_call" },
+        samplerSlots: ["volumeThickness"],
+        active: (p, t) => p.volumeThicknessFactor !== undefined || tex(t, "volumeThickness") !== undefined,
+        bits: (p, t) => ({ thicknessMap: tex(t, "volumeThickness") !== undefined }),
+        bind: (p, set) => {
+            set("u_volumeThicknessFactor", num(p, "volumeThicknessFactor"));
+            set("u_volumeAttenuationDistance", num(p, "volumeAttenuationDistance", Number.POSITIVE_INFINITY));
+            set("u_volumeAttenuationColor", vec3(p, "volumeAttenuationColor", [1, 1, 1]));
+        }
+    }),
+    lobe({
+        id: "dispersion",
+        glTFExtension: "KHR_materials_dispersion",
+        chunks: { pars: "a3d_prd04_dispersion_pars", fragment: "a3d_prd04_dispersion_call" },
+        samplerSlots: [],
+        active: (p) => num(p, "dispersion") > 0,
+        bind: (p, set) => set("u_dispersion", num(p, "dispersion"))
+    }),
+    lobe({
+        id: "emissive-strength",
+        glTFExtension: "KHR_materials_emissive_strength",
+        chunks: { pars: "a3d_prd04_emissive_strength", fragment: "a3d_prd04_emissive_strength_call" },
+        samplerSlots: ["emissive"],
+        active: (p) => num(p, "emissiveStrength", 1) !== 1 ||
+            vec3(p, "emissiveFactor", [0, 0, 0]).some((v) => v !== 0),
+        bits: (p, t) => ({ map: tex(t, "emissive") !== undefined }),
+        bind: (p, set) => set("u_emissiveStrength", num(p, "emissiveStrength", 1))
+    }),
+    lobe({
+        id: "unlit",
+        glTFExtension: "KHR_materials_unlit",
+        chunks: { pars: "a3d_prd04_unlit", fragment: "a3d_prd04_unlit_call" },
+        samplerSlots: ["baseColor", "emissive"],
+        active: (p) => p.unlit === true,
+        bind: () => { }
+    })
+];
+let registered = false;
+/** Registers all PRD-04 lobes; idempotent (lane barrel + tests may both call). */
+export function registerPrd04MaterialLobes() {
+    if (registered)
+        return;
+    for (const entry of LOBES)
+        registerMaterialLobe(entry);
+    registered = true;
+}
+//# sourceMappingURL=lobes.js.map

package/dist/rendering/materials/lobes.js.map

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

package/dist/rendering/output/HdrTarget.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `output/HdrTarget.ts` (PRD-01 §6.4/§8.4, C-05) — the linear-HDR scene target
+ * under `A3D_QR_CORE_OUTPUT`: color attachment 0 is the probed HDR format
+ * (`rgba16f` when the `hdr-render-targets` capability exists; the
+ * `r11f_g11f_b10f` middle rung of the contract probe is not representable by
+ * `RenderTargetDescriptor.colorAttachments`, so the probe collapses to
+ * `rgba16f`/`rgba8`), depth as a sampleable `depthTexture`, optional MSAA
+ * `sampleCount`, and — when `backgroundCoverage` is on — a second `rgba8`
+ * attachment at location 1 written by generated programs (`outCoverage`).
+ * The target is resized lazily to the render-scale dimensions.
+ */
+import type { RenderDevice, RenderTarget } from "../RenderDevice.js";
+export interface HdrTargetOptions {
+    readonly width: number;
+    readonly height: number;
+    /** `true` allocates the BACKGROUND_COVERAGE MRT attachment (location 1, rgba8). */
+    readonly coverage?: boolean;
+    /** MSAA sample count (1 = no multisample). Clamped to the device limit by the device. */
+    readonly sampleCount?: number;
+}
+export declare function createHdrTarget(device: RenderDevice, options: HdrTargetOptions): RenderTarget;
+/**
+ * Cached-per-call-site helper: returns `current` unchanged when it already
+ * matches the requested size/options, else disposes and recreates it.
+ */
+export declare function ensureHdrTarget(device: RenderDevice, current: RenderTarget | null, options: HdrTargetOptions): RenderTarget;
+//# sourceMappingURL=HdrTarget.d.ts.map

package/dist/rendering/output/HdrTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HdrTarget.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/output/HdrTarget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGlE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAc7F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,OAAO,EAAE,gBAAgB,GACxB,YAAY,CAed"}