@aura3d/rendering 3.0.1 → 4.0.2

package/dist/environment/HdrEquirect.js

@@ -0,0 +1,205 @@
+/**
+ * Radiance `.hdr` (RGBE) equirectangular image decode + sampling (PRD-02 §6.2).
+ * Day-0 HDRI presets come from `fixtures/environment-corpus/hdri/*.hdr`;
+ * the bake command decodes them here, samples into cube faces, and prefilters.
+ * No binary assets are committed for the runtime — only this decoder and the
+ * baked KTX2 outputs.
+ */
+import { faceUvToDir } from "./workers/cpuPrefilter.js";
+export class HdrDecodeError extends Error {
+    reason;
+    constructor(reason) {
+        super(`ENV_HDR_DECODE ${reason}`);
+        this.reason = reason;
+        this.name = "HdrDecodeError";
+    }
+}
+// Browser-safe byte ops — this module is loaded through the dev-server source
+// chain, where Node's `Buffer` global does not exist (PRD-06 T5.x found the
+// route boot crashing here). `Buffer` inputs still work: Buffer is a
+// Uint8Array subclass, so the uint8 views below are equivalent.
+const HDR_MAGIC = [0x23, 0x3f]; // "#?"
+function indexOfByte(b, byte, from) {
+    for (let i = from; i < b.length; i += 1)
+        if (b[i] === byte)
+            return i;
+    return -1;
+}
+function latin1(b, start, end) {
+    let s = "";
+    for (let i = start; i < end; i += 1)
+        s += String.fromCharCode(b[i]);
+    return s;
+}
+/** Decode a Radiance RGBE `.hdr` file (flat or per-scanline RLE). */
+export function decodeHdrEquirect(buf) {
+    const b = buf;
+    if (b.length < 32 || b[0] !== HDR_MAGIC[0] || b[1] !== HDR_MAGIC[1]) {
+        throw new HdrDecodeError("ENV_HDR_MAGIC");
+    }
+    // Header: text lines until an empty line, then a resolution line " -Y h +X w".
+    let p = 0;
+    const readLine = () => {
+        const nl = indexOfByte(b, 0x0a, p);
+        if (nl < 0)
+            throw new HdrDecodeError("ENV_HDR_TRUNCATED_HEADER");
+        const line = latin1(b, p, nl);
+        p = nl + 1;
+        return line;
+    };
+    readLine(); // magic line
+    for (;;) {
+        const line = readLine();
+        if (line.length === 0)
+            break;
+    }
+    const res = readLine();
+    const m = /-Y\s+(\d+)\s+\+X\s+(\d+)/.exec(res);
+    if (!m)
+        throw new HdrDecodeError(`ENV_HDR_RESOLUTION ${res}`);
+    const height = Number(m[1]);
+    const width = Number(m[2]);
+    const data = new Float32Array(width * height * 3);
+    const rgbe = new Uint8Array(4);
+    const flatScanline = (y) => {
+        const base = p;
+        for (let x = 0; x < width; x += 1)
+            writeRgbe(data, width, height, y, x, b, base + x * 4);
+        p += width * 4;
+    };
+    const rleScanline = (y) => {
+        if (b[p + 2] !== width >> 8 || b[p + 3] !== (width & 0xff)) {
+            throw new HdrDecodeError("ENV_HDR_RLE_WIDTH");
+        }
+        p += 4;
+        const chan = new Uint8Array(width * 4);
+        let w = 0;
+        while (w < width * 4) {
+            const count = b[p];
+            p += 1;
+            if (count > 128) { // run
+                const c = count - 128;
+                const v = b[p];
+                p += 1;
+                for (let i = 0; i < c; i += 1)
+                    chan[w++] = v;
+            }
+            else {
+                for (let i = 0; i < count; i += 1)
+                    chan[w++] = b[p++];
+            }
+        }
+        for (let x = 0; x < width; x += 1) {
+            rgbe[0] = chan[x];
+            rgbe[1] = chan[width + x];
+            rgbe[2] = chan[width * 2 + x];
+            rgbe[3] = chan[width * 3 + x];
+            writeRgbe(data, width, height, y, x, rgbe, 0);
+        }
+    };
+    for (let y = 0; y < height; y += 1) {
+        if (width >= 8 && width <= 0x7fff && b[p] === 2 && b[p + 1] === 2)
+            rleScanline(y);
+        else
+            flatScanline(y);
+    }
+    return { width, height, data };
+}
+function writeRgbe(data, width, _h, y, x, src, off) {
+    const r = src[off], g = src[off + 1], bl = src[off + 2], e = src[off + 3];
+    const i = (y * width + x) * 3;
+    if (e === 0) {
+        data[i] = 0;
+        data[i + 1] = 0;
+        data[i + 2] = 0;
+        return;
+    }
+    // RGBE → linear exactly as three r185's HDRLoader (RGBEByteToRGBFloat:
+    // m · 2^(e−128) / 255). The previous `2^(e−136) / 256` divided by 256 twice,
+    // decoding every HDRI ~256× too dark (kloppenheim_06_puresky_1k peaked at
+    // 0.127 instead of ~32), which blacked out the C-09 HDRI probes.
+    const scale = Math.pow(2, e - 128) / 255;
+    data[i] = r * scale;
+    data[i + 1] = g * scale;
+    data[i + 2] = bl * scale;
+}
+/** Sample the equirect image along `dir` (bilinear). dir = normalized [x,y,z]. */
+/**
+ * #1153: an `rgba32f` Texture needs exactly width·height·4 floats (16 bytes
+ * per texel); `decodeHdrEquirect` yields RGB (3 floats). Expand with A = 1.
+ */
+export function hdrImageToRgba32f(img) {
+    const texels = img.width * img.height;
+    if (img.data.length !== texels * 3) {
+        throw new Error(`HDR_IMAGE_SIZE_MISMATCH: ${img.width}x${img.height} needs ${texels * 3} RGB floats, got ${img.data.length}`);
+    }
+    const out = new Float32Array(texels * 4);
+    for (let i = 0; i < texels; i += 1) {
+        out[i * 4] = img.data[i * 3];
+        out[i * 4 + 1] = img.data[i * 3 + 1];
+        out[i * 4 + 2] = img.data[i * 3 + 2];
+        out[i * 4 + 3] = 1;
+    }
+    return out;
+}
+/**
+ * Float pixels of an equirect texture as the RGB `HdrImage` the projection
+ * reads: RGBA (rgba32f/rgba16f-as-float, 4 floats/texel) is narrowed to RGB;
+ * RGB input passes through. Any other length is rejected.
+ */
+export function equirectRgbImage(width, height, data) {
+    const texels = width * height;
+    if (data.length === texels * 3)
+        return { width, height, data };
+    if (data.length !== texels * 4) {
+        throw new Error(`EQUIRECT_SIZE_MISMATCH: ${width}x${height} needs ${texels * 4} RGBA floats, got ${data.length}`);
+    }
+    const rgb = new Float32Array(texels * 3);
+    for (let i = 0; i < texels; i += 1) {
+        rgb[i * 3] = data[i * 4];
+        rgb[i * 3 + 1] = data[i * 4 + 1];
+        rgb[i * 3 + 2] = data[i * 4 + 2];
+    }
+    return { width, height, data: rgb };
+}
+export function sampleEquirect(img, dir) {
+    const [x, y, z] = dir;
+    const phi = Math.atan2(z, x); // [-π, π]
+    const theta = Math.acos(Math.min(1, Math.max(-1, y))); // [0, π]
+    const u = (phi / (2 * Math.PI)) + 0.5;
+    const v = theta / Math.PI;
+    const px = Math.min(img.width - 1, u * img.width - 0.5);
+    const py = Math.min(img.height - 1, v * img.height - 0.5);
+    const x0 = Math.max(0, Math.floor(px)), x1 = Math.min(img.width - 1, x0 + 1);
+    const y0 = Math.max(0, Math.floor(py)), y1 = Math.min(img.height - 1, y0 + 1);
+    const fx = px - x0, fy = py - y0;
+    const at = (xx, yy, c) => img.data[(yy * img.width + xx) * 3 + c];
+    const out = [0, 0, 0];
+    for (let c = 0; c < 3; c += 1) {
+        const a = at(x0, y0, c) * (1 - fx) + at(x1, y0, c) * fx;
+        const d = at(x0, y1, c) * (1 - fx) + at(x1, y1, c) * fx;
+        out[c] = a * (1 - fy) + d * fy;
+    }
+    return out;
+}
+/** Render an equirect image into 6 cube faces at `faceSize`. */
+export function equirectToCubeFaces(img, faceSize) {
+    const faces = [];
+    for (let f = 0; f < 6; f += 1) {
+        const face = new Float32Array(faceSize * faceSize * 4);
+        for (let y = 0; y < faceSize; y += 1) {
+            for (let x = 0; x < faceSize; x += 1) {
+                const dir = faceUvToDir(f, ((x + 0.5) / faceSize) * 2 - 1, ((y + 0.5) / faceSize) * 2 - 1);
+                const [r, g, b] = sampleEquirect(img, dir);
+                const i = (y * faceSize + x) * 4;
+                face[i] = r;
+                face[i + 1] = g;
+                face[i + 2] = b;
+                face[i + 3] = 1;
+            }
+        }
+        faces.push(face);
+    }
+    return faces;
+}
+//# sourceMappingURL=HdrEquirect.js.map

package/dist/environment/HdrEquirect.js.map

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

package/dist/environment/LightingSamplerBudget.d.ts

@@ -0,0 +1,20 @@
+/** Texture units each feature consumes (§6.10). */
+export declare const FEATURE_UNITS: Readonly<Record<string, number>>;
+/** Spelling used in program defines → feature name (§6.10 names). */
+export declare const FEATURE_DEFINES: Readonly<Record<string, string>>;
+export interface SamplerBudgetResult {
+    /** Feature names removed entirely (CCR-02-1 reportable). */
+    readonly droppedFeatures: readonly string[];
+    /** Total lighting sampler units after the plan. */
+    readonly lightingUnits: number;
+    readonly materialSamplers: number;
+    readonly limit: number;
+    /** Feature names still active after downgrade+drop. */
+    readonly activeFeatures: readonly string[];
+}
+/** Features that are always present when the lighting path runs. */
+export declare function presentFeatures(defines: Readonly<Record<string, unknown>>): string[];
+export declare function resolveLightingSamplerBudgetReal(defines: Readonly<Record<string, unknown>>, materialSamplerCount: number, options?: {
+    readonly maxTextureImageUnits?: number;
+}): SamplerBudgetResult;
+//# sourceMappingURL=LightingSamplerBudget.d.ts.map

package/dist/environment/LightingSamplerBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightingSamplerBudget.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/LightingSamplerBudget.ts"],"names":[],"mappings":"AAYA,mDAAmD;AACnD,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB1D,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAe5D,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,mDAAmD;IACnD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,EAAE,CASpF;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC1C,oBAAoB,EAAE,MAAM,EAC5B,OAAO,GAAE;IAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,mBAAmB,CAiCrB"}

package/dist/environment/LightingSamplerBudget.js

@@ -0,0 +1,94 @@
+/**
+ * PRD-02 §6.10 — lighting sampler-unit budget.
+ * Lighting features share the fragment shader's 16 image units with the
+ * material's own samplers; this resolver downgrades then drops lighting
+ * features until the total fits. Deterministic: same inputs → same plan.
+ *
+ * Order (§6.10): first PCSS → Vogel (frees the 2 raw units pcss-raw costs),
+ * then LTC → Gauss-Legendre (frees ltc's 2 units), then the frozen
+ * LIGHTING_SAMPLER_DROP_ORDER.
+ */
+import { LIGHTING_SAMPLER_DROP_ORDER } from "../contracts/sampling.js";
+/** Texture units each feature consumes (§6.10). */
+export const FEATURE_UNITS = {
+    "env-cube": 1,
+    "dfg-lut": 1,
+    "cascade-compare": 1,
+    "pcss-raw": 2,
+    "local-shadow-atlas": 1,
+    "contact-shadow": 1,
+    "reflection-probe-2": 2,
+    "irradiance-volume": 3,
+    "ltc": 2,
+    "sh-texture": 1,
+    "cascade-3": 1,
+    "lobe:iridescence": 1,
+    "lobe:sheen": 1,
+    "lobe:anisotropy": 1,
+    "lobe:clearcoat": 1
+};
+/** Spelling used in program defines → feature name (§6.10 names). */
+export const FEATURE_DEFINES = {
+    A3D_ENV_CUBE: "env-cube",
+    A3D_DFG_LUT: "dfg-lut",
+    A3D_CASCADE_COMPARE: "cascade-compare",
+    A3D_SHADOW_PCSS: "pcss-raw",
+    A3D_LOCAL_SHADOW_ATLAS: "local-shadow-atlas",
+    A3D_CONTACT_SHADOW: "contact-shadow",
+    A3D_REFLECTION_PROBE_2: "reflection-probe-2",
+    A3D_IRRADIANCE_VOLUME: "irradiance-volume",
+    A3D_LTC: "ltc",
+    A3D_SH_TEXTURE: "sh-texture",
+    A3D_IRIDESCENCE: "lobe:iridescence",
+    A3D_SHEEN: "lobe:sheen",
+    A3D_ANISOTROPY: "lobe:anisotropy",
+    A3D_CLEARCOAT: "lobe:clearcoat"
+};
+/** Features that are always present when the lighting path runs. */
+export function presentFeatures(defines) {
+    const present = new Set(["env-cube", "dfg-lut"]);
+    for (const [define, feature] of Object.entries(FEATURE_DEFINES)) {
+        if (defines[define])
+            present.add(feature);
+    }
+    const cascadeCount = Number(defines.A3D_CASCADE_COUNT ?? 0);
+    if (cascadeCount > 2)
+        present.add("cascade-3");
+    if (cascadeCount > 0)
+        present.add("cascade-compare");
+    return [...present];
+}
+export function resolveLightingSamplerBudgetReal(defines, materialSamplerCount, options = {}) {
+    const limit = options.maxTextureImageUnits ?? 16;
+    const active = new Set(presentFeatures(defines));
+    const dropped = [];
+    const units = () => [...active].reduce((sum, f) => sum + (FEATURE_UNITS[f] ?? 1), 0);
+    const over = () => units() + materialSamplerCount > limit;
+    // Step 1: PCSS → Vogel frees the 2 raw units.
+    if (over() && active.has("pcss-raw")) {
+        active.delete("pcss-raw"); // cascade-compare remains — Vogel samples the compare map only
+        dropped.push("pcss-raw");
+    }
+    // Step 2: LTC → Gauss-Legendre 4-tap frees the ltc table units.
+    if (over() && active.has("ltc")) {
+        active.delete("ltc");
+        dropped.push("ltc");
+    }
+    // Step 3: frozen drop order.
+    for (const feature of LIGHTING_SAMPLER_DROP_ORDER) {
+        if (!over())
+            break;
+        if (active.has(feature)) {
+            active.delete(feature);
+            dropped.push(feature);
+        }
+    }
+    return {
+        droppedFeatures: dropped,
+        lightingUnits: units(),
+        materialSamplers: materialSamplerCount,
+        limit,
+        activeFeatures: [...active]
+    };
+}
+//# sourceMappingURL=LightingSamplerBudget.js.map

package/dist/environment/LightingSamplerBudget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LightingSamplerBudget.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/LightingSamplerBudget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,mDAAmD;AACnD,MAAM,CAAC,MAAM,aAAa,GAAqC;IAC7D,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,CAAC;IACZ,iBAAiB,EAAE,CAAC;IACpB,UAAU,EAAE,CAAC;IACb,oBAAoB,EAAE,CAAC;IACvB,gBAAgB,EAAE,CAAC;IACnB,oBAAoB,EAAE,CAAC;IACvB,mBAAmB,EAAE,CAAC;IACtB,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;IACd,kBAAkB,EAAE,CAAC;IACrB,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,CAAC;CACpB,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAqC;IAC/D,YAAY,EAAE,UAAU;IACxB,WAAW,EAAE,SAAS;IACtB,mBAAmB,EAAE,iBAAiB;IACtC,eAAe,EAAE,UAAU;IAC3B,sBAAsB,EAAE,oBAAoB;IAC5C,kBAAkB,EAAE,gBAAgB;IACpC,sBAAsB,EAAE,oBAAoB;IAC5C,qBAAqB,EAAE,mBAAmB;IAC1C,OAAO,EAAE,KAAK;IACd,cAAc,EAAE,YAAY;IAC5B,eAAe,EAAE,kBAAkB;IACnC,SAAS,EAAE,YAAY;IACvB,cAAc,EAAE,iBAAiB;IACjC,aAAa,EAAE,gBAAgB;CAChC,CAAC;AAaF,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,OAA0C;IACxE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAChE,IAAI,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC;IAC5D,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAA0C,EAC1C,oBAA4B,EAC5B,UAAsD,EAAE;IAExD,MAAM,KAAK,GAAG,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,oBAAoB,GAAG,KAAK,CAAC;IAE1D,8CAA8C;IAC9C,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,+DAA+D;QAC1F,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IACD,gEAAgE;IAChE,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,6BAA6B;IAC7B,KAAK,MAAM,OAAO,IAAI,2BAA2B,EAAE,CAAC;QAClD,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM;QACnB,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO;QACL,eAAe,EAAE,OAAO;QACxB,aAAa,EAAE,KAAK,EAAE;QACtB,gBAAgB,EAAE,oBAAoB;QACtC,KAAK;QACL,cAAc,EAAE,CAAC,GAAG,MAAM,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/environment/Prd02BackgroundShaderLibrary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PRD-02 §8.7 `environmentBackground.frag` — flag-on background shader.
+ * Same contract as the lean ShaderLibraryCore program plus
+ * `u_environmentBackgroundLod`: `A3D_BG_EQUIRECT` (projection 1) samples the
+ * equirect at lod 0; cubemap projection samples `u_environmentBackgroundCubeTexture`
+ * at the blurred lod (`roughnessToLod(blurriness)` computed on CPU).
+ */
+import { ShaderLibrary } from "../ShaderLibraryCore.js";
+export declare function createPrd02EnvironmentBackgroundShaderLibrary(): ShaderLibrary;
+//# sourceMappingURL=Prd02BackgroundShaderLibrary.d.ts.map

package/dist/environment/Prd02BackgroundShaderLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02BackgroundShaderLibrary.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/Prd02BackgroundShaderLibrary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,wBAAgB,6CAA6C,IAAI,aAAa,CAwF7E"}

package/dist/environment/Prd02BackgroundShaderLibrary.js

@@ -0,0 +1,100 @@
+/**
+ * PRD-02 §8.7 `environmentBackground.frag` — flag-on background shader.
+ * Same contract as the lean ShaderLibraryCore program plus
+ * `u_environmentBackgroundLod`: `A3D_BG_EQUIRECT` (projection 1) samples the
+ * equirect at lod 0; cubemap projection samples `u_environmentBackgroundCubeTexture`
+ * at the blurred lod (`roughnessToLod(blurriness)` computed on CPU).
+ */
+import { ShaderLibrary } from "../ShaderLibraryCore.js";
+import { DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER, DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME } from "../ShaderLibraryCore.js";
+import { SHADER_CHUNKS, validateShaderChunks } from "../ShaderChunks.js";
+export function createPrd02EnvironmentBackgroundShaderLibrary() {
+    const library = new ShaderLibrary();
+    validateShaderChunks();
+    for (const chunk of SHADER_CHUNKS) {
+        library.registerChunk(chunk.name, chunk.source);
+    }
+    library.register({
+        name: DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME,
+        marker: DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER,
+        vertex: `#version 300 es
+// ${DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER}
+precision highp float;
+layout(location = 0) in vec3 a_position;
+out vec2 v_backgroundNdc;
+void main() {
+  v_backgroundNdc = a_position.xy;
+  gl_Position = vec4(a_position.xy, 1.0, 1.0);
+}
+`,
+        fragment: `#version 300 es
+// ${DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER}
+precision highp float;
+uniform sampler2D u_environmentBackgroundTexture;
+uniform samplerCube u_environmentBackgroundCubeTexture;
+uniform float u_environmentBackgroundProjection;
+uniform float u_environmentBackgroundRotation;
+uniform float u_environmentBackgroundIntensity;
+uniform float u_environmentBackgroundEncoding;
+uniform float u_environmentBackgroundLod;
+uniform float u_outputColorSpace;
+uniform mat4 u_environmentBackgroundInverseViewProjection;
+in vec2 v_backgroundNdc;
+out vec4 outColor;
+vec2 a3dBackgroundEquirectUv(vec3 direction) {
+  vec3 d = normalize(direction);
+  float u = atan(d.z, d.x) / 6.28318530718 + 0.5;
+  float v = acos(clamp(d.y, -1.0, 1.0)) / 3.14159265359;
+  return vec2(fract(u), clamp(v, 0.0, 1.0));
+}
+vec3 a3dRotateBackgroundDirection(vec3 direction, float rotation) {
+  float angle = rotation * 6.28318530718;
+  float c = cos(angle);
+  float s = sin(angle);
+  vec3 d = normalize(direction);
+  return normalize(vec3(c * d.x - s * d.z, d.y, s * d.x + c * d.z));
+}
+vec3 a3dBackgroundDirectionFromNdc(vec2 ndc) {
+  vec4 nearPoint = u_environmentBackgroundInverseViewProjection * vec4(ndc, -1.0, 1.0);
+  vec4 farPoint = u_environmentBackgroundInverseViewProjection * vec4(ndc, 1.0, 1.0);
+  vec3 nearWorld = nearPoint.xyz / max(nearPoint.w, 0.00001);
+  vec3 farWorld = farPoint.xyz / max(farPoint.w, 0.00001);
+  return normalize(farWorld - nearWorld);
+}
+vec3 a3dBackgroundDecodeRgbe(vec4 encodedSample) {
+  float exponent = encodedSample.a * 255.0;
+  float scale = exponent <= 0.0 ? 0.0 : exp2(exponent - 128.0) * (255.0 / 256.0);
+  return max(encodedSample.rgb * scale, vec3(0.0));
+}
+vec3 a3dBackgroundDecode(vec4 encodedSample) {
+  if (u_environmentBackgroundEncoding > 1.5) return a3dBackgroundDecodeRgbe(encodedSample);
+  return max(encodedSample.rgb, vec3(0.0));
+}
+vec3 a3dBackgroundEncodeLinearToSrgb(vec3 linear) {
+  vec3 clamped = max(linear, vec3(0.0));
+  vec3 low = clamped * 12.92;
+  vec3 high = 1.055 * pow(clamped, vec3(1.0 / 2.4)) - 0.055;
+  return mix(low, high, step(vec3(0.0031308), clamped));
+}
+vec3 a3dBackgroundEncodeOutput(vec3 linearColor) {
+  vec3 color = max(linearColor, vec3(0.0));
+  vec3 filmic = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3(0.0), vec3(1.0));
+  vec3 srgb = a3dBackgroundEncodeLinearToSrgb(filmic);
+  return mix(color, srgb, step(0.5, u_outputColorSpace));
+}
+void main() {
+  vec3 direction = a3dRotateBackgroundDirection(a3dBackgroundDirectionFromNdc(v_backgroundNdc), u_environmentBackgroundRotation);
+  vec4 encodedSample = vec4(0.0, 0.0, 0.0, 1.0);
+  if (u_environmentBackgroundProjection > 1.5) {
+    encodedSample = textureLod(u_environmentBackgroundCubeTexture, direction, u_environmentBackgroundLod);
+  } else {
+    encodedSample = textureLod(u_environmentBackgroundTexture, a3dBackgroundEquirectUv(direction), 0.0);
+  }
+  vec3 color = a3dBackgroundDecode(encodedSample) * max(u_environmentBackgroundIntensity, 0.0);
+  outColor = vec4(a3dBackgroundEncodeOutput(color), 1.0);
+}
+`
+    });
+    return library;
+}
+//# sourceMappingURL=Prd02BackgroundShaderLibrary.js.map

package/dist/environment/Prd02BackgroundShaderLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02BackgroundShaderLibrary.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/Prd02BackgroundShaderLibrary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,4CAA4C,EAC5C,0CAA0C,EAC3C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,MAAM,UAAU,6CAA6C;IAC3D,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;IACpC,oBAAoB,EAAE,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,QAAQ,CAAC;QACf,IAAI,EAAE,0CAA0C;QAChD,MAAM,EAAE,4CAA4C;QACpD,MAAM,EAAE;KACP,4CAA4C;;;;;;;;CAQhD;QACG,QAAQ,EAAE;KACT,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEhD;KACE,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/environment/Rgb9e5Cube.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PRD-02 §7.1 — RGB9E5 cube decoder for baked environment probes.
+ * Reads a KTX2 container holding an uncompressed VK_FORMAT_E5B9G9R9_UFLOAT_PACK32
+ * cube (6 faces, square, mip chain) into per-level Float32 RGBA texels.
+ */
+export declare const KTX2_MAGIC: Uint8Array<ArrayBuffer>;
+export declare const VK_FORMAT_E5B9G9R9_UFLOAT_PACK32 = 142;
+export declare const KTX2_HEADER_BYTES = 68;
+export type Rgb9e5CubeErrorReason = "ENV_KTX2_TRUNCATED" | "ENV_KTX2_MAGIC" | "ENV_KTX2_FORMAT" | "ENV_KTX2_TYPESIZE" | "ENV_KTX2_SUPERCOMPRESSED" | "ENV_KTX2_FACES" | "ENV_KTX2_3D" | "ENV_KTX2_LAYERS" | "ENV_KTX2_NONSQUARE" | "ENV_KTX2_LEVELS" | "ENV_KTX2_LEVELSIZE";
+export declare class Rgb9e5CubeError extends Error {
+    readonly reason: Rgb9e5CubeErrorReason;
+    constructor(reason: Rgb9e5CubeErrorReason, message: string);
+}
+export interface Rgb9e5Cube {
+    readonly faceSize: number;
+    readonly mipCount: number;
+    /** levels[m][face] → Float32Array of faceSize_m² × 4 (RGBA). */
+    readonly levels: readonly (readonly Float32Array[])[];
+}
+export declare function readRgb9e5Cube(bytes: Uint8Array): Rgb9e5Cube;
+/** Decode a packed RGB9E5 texel: 9-bit mantissas, shared 5-bit exponent, bias 15 → value = mantissa·2^(e−24). */
+export declare function unpackRgb9e5(packed: number): [number, number, number];
+/** Encode RGB to a packed RGB9E5 texel (shared 5-bit biased exponent; mantissa = c·2^(24−e)). */
+export declare function packRgb9e5(r: number, g: number, b: number): number;
+//# sourceMappingURL=Rgb9e5Cube.d.ts.map

package/dist/environment/Rgb9e5Cube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rgb9e5Cube.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/Rgb9e5Cube.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,UAAU,yBAA2F,CAAC;AACnH,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,MAAM,qBAAqB,GAC7B,oBAAoB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GACjF,0BAA0B,GAAG,gBAAgB,GAAG,aAAa,GAC7D,iBAAiB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAExF,qBAAa,eAAgB,SAAQ,KAAK;aACZ,MAAM,EAAE,qBAAqB;gBAA7B,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM;CAI3E;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,CAAC;CACvD;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAuD5D;AAED,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAIrE;AAED,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOlE"}

package/dist/environment/Rgb9e5Cube.js

@@ -0,0 +1,103 @@
+/**
+ * PRD-02 §7.1 — RGB9E5 cube decoder for baked environment probes.
+ * Reads a KTX2 container holding an uncompressed VK_FORMAT_E5B9G9R9_UFLOAT_PACK32
+ * cube (6 faces, square, mip chain) into per-level Float32 RGBA texels.
+ */
+export const KTX2_MAGIC = new Uint8Array([0xab, 0x4b, 0x54, 0x58, 0x20, 0x32, 0x30, 0xbb, 0x0d, 0x0a, 0x1a, 0x0a]);
+export const VK_FORMAT_E5B9G9R9_UFLOAT_PACK32 = 142;
+export const KTX2_HEADER_BYTES = 68;
+export class Rgb9e5CubeError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(`${reason}: ${message}`);
+        this.reason = reason;
+        this.name = "Rgb9e5CubeError";
+    }
+}
+const align4 = (n) => (n + 3) & ~3;
+export function readRgb9e5Cube(bytes) {
+    if (bytes.byteLength < KTX2_HEADER_BYTES)
+        throw new Rgb9e5CubeError("ENV_KTX2_TRUNCATED", `need ${KTX2_HEADER_BYTES} header bytes, got ${bytes.byteLength}`);
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    for (let i = 0; i < 12; i += 1) {
+        if (bytes[i] !== KTX2_MAGIC[i])
+            throw new Rgb9e5CubeError("ENV_KTX2_MAGIC", "bad KTX2 identifier");
+    }
+    const vkFormat = view.getUint32(12, true);
+    if (vkFormat !== VK_FORMAT_E5B9G9R9_UFLOAT_PACK32)
+        throw new Rgb9e5CubeError("ENV_KTX2_FORMAT", `vkFormat ${vkFormat}, expected ${VK_FORMAT_E5B9G9R9_UFLOAT_PACK32}`);
+    const typeSize = view.getUint32(16, true);
+    if (typeSize !== 4)
+        throw new Rgb9e5CubeError("ENV_KTX2_TYPESIZE", `typeSize ${typeSize}, expected 4`);
+    const pixelWidth = view.getUint32(20, true);
+    const pixelHeight = view.getUint32(24, true);
+    const pixelDepth = view.getUint32(28, true);
+    const layerCount = view.getUint32(32, true);
+    const faceCount = view.getUint32(36, true);
+    const levelCount = view.getUint32(40, true);
+    const supercompression = view.getUint32(44, true);
+    const dfdOff = view.getUint32(48, true);
+    const dfdLen = view.getUint32(52, true);
+    const kvdOff = view.getUint32(56, true);
+    const kvdLen = view.getUint32(60, true);
+    if (supercompression !== 0)
+        throw new Rgb9e5CubeError("ENV_KTX2_SUPERCOMPRESSED", `supercompression ${supercompression} unsupported`);
+    if (faceCount !== 6)
+        throw new Rgb9e5CubeError("ENV_KTX2_FACES", `faceCount ${faceCount}, expected 6`);
+    if (pixelDepth !== 0)
+        throw new Rgb9e5CubeError("ENV_KTX2_3D", "3D textures unsupported");
+    if (layerCount !== 0)
+        throw new Rgb9e5CubeError("ENV_KTX2_LAYERS", "array layers unsupported");
+    if (pixelWidth !== pixelHeight)
+        throw new Rgb9e5CubeError("ENV_KTX2_NONSQUARE", `${pixelWidth}x${pixelHeight}`);
+    if (levelCount === 0)
+        throw new Rgb9e5CubeError("ENV_KTX2_LEVELS", "no mip levels");
+    const indexOff = align4(Math.max(KTX2_HEADER_BYTES, dfdOff + dfdLen, kvdOff + kvdLen));
+    const indexBytes = levelCount * 24;
+    if (bytes.byteLength < indexOff + indexBytes)
+        throw new Rgb9e5CubeError("ENV_KTX2_TRUNCATED", "level index truncated");
+    const levels = [];
+    for (let level = 0; level < levelCount; level += 1) {
+        const levelOffset = Number(view.getBigUint64(indexOff + level * 24, true));
+        const levelLength = Number(view.getBigUint64(indexOff + level * 24 + 8, true));
+        const size = Math.max(1, pixelWidth >> level);
+        const expected = 6 * size * size * 4; // 6 faces × texels × 4-byte RGB9E5
+        if (levelLength !== expected)
+            throw new Rgb9e5CubeError("ENV_KTX2_LEVELSIZE", `level ${level}: ${levelLength} bytes, expected ${expected}`);
+        if (levelOffset + levelLength > bytes.byteLength)
+            throw new Rgb9e5CubeError("ENV_KTX2_TRUNCATED", `level ${level} data truncated`);
+        const levelFaces = [];
+        const faceBytes = size * size * 4;
+        for (let face = 0; face < 6; face += 1) {
+            const start = levelOffset + face * faceBytes;
+            const packed = new Uint32Array(bytes.buffer, bytes.byteOffset + start, size * size);
+            const rgba = new Float32Array(size * size * 4);
+            for (let t = 0; t < packed.length; t += 1) {
+                const [r, g, b] = unpackRgb9e5(packed[t]);
+                rgba[t * 4] = r;
+                rgba[t * 4 + 1] = g;
+                rgba[t * 4 + 2] = b;
+                rgba[t * 4 + 3] = 1;
+            }
+            levelFaces.push(rgba);
+        }
+        levels.push(levelFaces);
+    }
+    return { faceSize: pixelWidth, mipCount: levelCount, levels };
+}
+/** Decode a packed RGB9E5 texel: 9-bit mantissas, shared 5-bit exponent, bias 15 → value = mantissa·2^(e−24). */
+export function unpackRgb9e5(packed) {
+    const e = ((packed >>> 27) & 0x1f) - 15 - 9;
+    const scale = Math.pow(2, e);
+    return [(packed & 0x1ff) * scale, ((packed >>> 9) & 0x1ff) * scale, ((packed >>> 18) & 0x1ff) * scale];
+}
+/** Encode RGB to a packed RGB9E5 texel (shared 5-bit biased exponent; mantissa = c·2^(24−e)). */
+export function packRgb9e5(r, g, b) {
+    const maxC = Math.max(r, g, b, 1e-10);
+    // smallest e with maxC·2^(24−e) ≤ 511
+    const e = Math.max(0, Math.min(31, Math.ceil(Math.log2(maxC)) + 15));
+    const invScale = Math.pow(2, 24 - e);
+    const enc = (c) => Math.min(0x1ff, Math.max(0, Math.round(c * invScale)));
+    return (e << 27) | (enc(b) << 18) | (enc(g) << 9) | enc(r);
+}
+//# sourceMappingURL=Rgb9e5Cube.js.map

package/dist/environment/Rgb9e5Cube.js.map

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