@aura3d/rendering 3.0.1 → 4.0.2

package/dist/environment/EnvironmentCache.js

@@ -0,0 +1,205 @@
+/**
+ * EnvironmentCache (PRD-02 §6.2/§8.7): keyed by `(url|preset, tier)`,
+ * ref-counted. Probes released to 0 references stay resident for reuse until
+ * the LRU limit forces eviction (`dispose()` then runs).
+ *
+ * Resident limits (PRD §2216 / test contract): 3 normally; **2 on Medium when
+ * any resident probe is RGBA16F** (the default storage format — so Medium is
+ * effectively 2) and **always 2 on Ultra**. Neutral probes bypass the limit:
+ * they are the fallback floor and are never evicted.
+ *
+ * `acquire` is async (fetch + decode + prefilter). While it resolves, the
+ * caller keeps the previous probe bound (PRD §4: never a black frame).
+ */
+import { Texture } from "../Texture.js";
+import { isEnvironmentProbeFactoryPending } from "../contracts/environment.js";
+import { QUALITY_TIERS } from "../contracts/quality.js";
+import { decodeHdrEquirect, hdrImageToRgba32f } from "./HdrEquirect.js";
+import { readRgb9e5Cube } from "./Rgb9e5Cube.js";
+import { buildNeutralFloorProbe, buildProbeFromLevels } from "./probeBuild.js";
+const NEUTRAL_TAG = "__neutral__";
+function keyId(key) {
+    return `${key.url ?? `preset:${key.preset ?? NEUTRAL_TAG}`}@${key.tier}`;
+}
+/** Resident limit per PRD: Ultra → 2; Medium → 2 when an RGBA16F probe is resident; else 3. */
+export function environmentCacheLimit(tier, hasRgba16fResident) {
+    if (tier === "ultra")
+        return 2;
+    if (tier === "medium" && hasRgba16fResident)
+        return 2;
+    return 3;
+}
+export class EnvironmentCache {
+    device;
+    factory;
+    loader;
+    entries = new Map();
+    neutralEntries = new Map();
+    inFlight = new Map();
+    clock = 0;
+    constructor(device, factory, loader) {
+        this.device = device;
+        this.factory = factory;
+        this.loader = loader;
+    }
+    /**
+     * Acquire a probe. The loader defaults to `loadEnvironmentProbeKey` — preset
+     * names resolve to baked `aura-environments/<name>` manifests, `url` fetches
+     * an equirect HDR.
+     */
+    async acquire(key, loader) {
+        const id = keyId(key);
+        const live = this.entries.get(id);
+        if (live) {
+            live.refs += 1;
+            live.touched = ++this.clock;
+            return live.probe;
+        }
+        let promise = this.inFlight.get(id);
+        if (!promise) {
+            const load = loader ?? this.loader ?? defaultProbeLoader(this.factory);
+            promise = load(key).then((probe) => {
+                this.entries.set(id, { key: id, probe, refs: 1, touched: ++this.clock });
+                this.inFlight.delete(id);
+                this.evictOverLimit(key.tier);
+                return probe;
+            });
+            this.inFlight.set(id, promise);
+            // Avoid unhandled rejection on racing callers: a failed load removes itself.
+            promise.catch(() => this.inFlight.delete(id));
+        }
+        return promise;
+    }
+    /**
+     * Synchronous neutral floor (T0-25): an analytic constant probe matching the
+     * baked `neutral` preset's diffuse DC — never runs the CPU GGX prefilter on
+     * the main thread. Specular detail arrives via `acquire({preset:"neutral"})`.
+     */
+    neutral(tier) {
+        const existing = this.neutralEntries.get(tier);
+        if (existing) {
+            existing.refs += 1;
+            return existing.probe;
+        }
+        const probe = buildNeutralFloorProbe(QUALITY_TIERS[tier].environmentSize);
+        this.neutralEntries.set(tier, { key: NEUTRAL_TAG, probe, refs: 1, touched: ++this.clock });
+        return probe;
+    }
+    /** Decrement a probe's refcount; at 0 it becomes an eviction candidate. */
+    release(probe) {
+        for (const entry of [...this.entries.values(), ...this.neutralEntries.values()]) {
+            if (entry.probe === probe) {
+                entry.refs = Math.max(0, entry.refs - 1);
+                return;
+            }
+        }
+    }
+    refCount(probe) {
+        for (const entry of [...this.entries.values(), ...this.neutralEntries.values()]) {
+            if (entry.probe === probe)
+                return entry.refs;
+        }
+        return 0;
+    }
+    get residentCount() {
+        return this.entries.size;
+    }
+    /** Evict oldest zero-ref entries until within the tier limit. */
+    evictOverLimit(tier) {
+        const hasRgba16f = [...this.entries.values()].some((e) => e.probe.specularCube?.format === "rgba16f");
+        const limit = environmentCacheLimit(tier, hasRgba16f);
+        const evictable = [...this.entries.values()]
+            .filter((e) => e.refs === 0)
+            .sort((a, b) => a.touched - b.touched);
+        while (this.entries.size > limit && evictable.length > 0) {
+            const victim = evictable.shift();
+            this.entries.delete(victim.key);
+            victim.probe.dispose();
+        }
+    }
+    dispose() {
+        for (const e of this.entries.values())
+            e.probe.dispose();
+        for (const e of this.neutralEntries.values())
+            e.probe.dispose();
+        this.entries.clear();
+        this.neutralEntries.clear();
+        this.inFlight.clear();
+    }
+}
+async function fetchBytes(url) {
+    let res = await fetch(url);
+    if (!res.ok && !url.startsWith("/") && !/^https?:\/\//.test(url)) {
+        const rootRes = await fetch(`/${url}`);
+        if (rootRes.ok)
+            res = rootRes;
+    }
+    if (!res.ok)
+        throw new Error(`ENV_FETCH_FAILED:${url}:${res.status}`);
+    return new Uint8Array(await res.arrayBuffer());
+}
+/**
+ * Default key → probe loader. `preset` reads the day-0 baked bundles under
+ * `aura-environments/<name>/` (manifest + RGB9E5 specular cube + baked SH9 —
+ * already prefiltered, uploaded as RGBA16F until Q-06-1 native RGB9_E5 lands);
+ * `url` fetches an equirect .hdr and runs `factory.fromEquirect`.
+ *
+ * `factory` may be a getter, resolved when a load runs rather than when the
+ * loader is built, so a C-09 provider that registers after the scene compiles
+ * is still used. While the factory is the pending stub, an HDRI load rejects
+ * with `ENVIRONMENT_PROBE_PENDING:fromEquirect` before fetching anything; the
+ * caller keeps the neutral floor bound (see `bindPrd02EnvironmentProbe`).
+ */
+/**
+ * Face size for an HDRI probe: three r185's PMREM sizing (cube = equirect
+ * width / 4, so 256 for a 1k HDRI), capped by the tier's environment size and
+ * by 256 while the GGX prefilter is CPU-only on the main thread. A 1024 face
+ * at Ultra took seconds and delayed the first draw of HDRI scenes
+ * (lighting+compiler games: ~3 s → 8-9 s, run 38182457655).
+ */
+export function hdriProbeFaceSize(equirectWidth, tier) {
+    const target = Math.min(equirectWidth / 4, QUALITY_TIERS[tier]?.environmentSize ?? 256, 256);
+    return (target >= 256 ? 256 : 128);
+}
+/** Resolve after two animation frames (immediately where there is no rAF, e.g. Node tests). */
+function afterFirstFrames() {
+    const raf = globalThis.requestAnimationFrame;
+    if (typeof raf !== "function")
+        return Promise.resolve();
+    return new Promise((resolve) => raf(() => raf(() => resolve())));
+}
+export function defaultProbeLoader(factory) {
+    const resolveFactory = () => (typeof factory === "function" ? factory() : factory);
+    return async (key) => {
+        if (key.preset) {
+            const manifestBytes = await fetchBytes(`/aura-environments/${key.preset}.manifest.json`);
+            const manifest = JSON.parse(new TextDecoder().decode(manifestBytes));
+            const [ktx2, sh9Bytes] = await Promise.all([
+                fetchBytes(`/aura-environments/${manifest.specular}`),
+                fetchBytes(`/aura-environments/${manifest.sh9}`)
+            ]);
+            const cube = readRgb9e5Cube(ktx2);
+            const sh9 = new Float32Array(sh9Bytes.buffer.slice(sh9Bytes.byteOffset, sh9Bytes.byteOffset + sh9Bytes.byteLength));
+            const levels = cube.levels.map((faces, i) => ({ faceSize: Math.max(1, cube.faceSize >> i), faces }));
+            return buildProbeFromLevels(levels, manifest.faceSize, {
+                source: "preset",
+                sh9,
+                label: `env-preset-${key.preset}`
+            });
+        }
+        if (key.url) {
+            if (isEnvironmentProbeFactoryPending(resolveFactory()))
+                throw new Error("ENVIRONMENT_PROBE_PENDING:fromEquirect");
+            const bytes = await fetchBytes(key.url);
+            // The decode + CPU GGX prefilter run on the main thread: let the first
+            // frames (drawn with the neutral floor) present before the work starts.
+            await afterFirstFrames();
+            const image = decodeHdrEquirect(bytes);
+            // #1153: decode yields RGB; rgba32f needs 4 floats per texel.
+            const src = new Texture({ width: image.width, height: image.height, format: "rgba32f", data: hdrImageToRgba32f(image), label: `env-src-${key.url}` });
+            return resolveFactory().fromEquirect(src, { faceSize: hdriProbeFaceSize(image.width, key.tier) });
+        }
+        throw new Error("ENVIRONMENT_KEY_EMPTY: acquire() needs url or preset");
+    };
+}
+//# sourceMappingURL=EnvironmentCache.js.map

package/dist/environment/EnvironmentCache.js.map

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

package/dist/environment/EnvironmentProbeFactory.d.ts

@@ -0,0 +1,41 @@
+/**
+ * C-09 real EnvironmentProbeFactory (PRD-02 §6.2/§8.7): builds EnvironmentProbe
+ * objects — PMREM'd specular cube + 9-band SH + optional background texture —
+ * from equirect images, cube sources, GPU scene captures, or the analytic
+ * RoomEnvironmentScene (the always-available neutral floor).
+ *
+ * The GPU capture + prefilter chain lives in `GPUPMREMGenerator`; probe
+ * assembly lives in `probeBuild.ts` so neither direction creates an import
+ * cycle. `fromScene` needs float render targets
+ * (`device.probe.floatColorBuffer` / `halfFloatColorBuffer`); callers without
+ * them fall back to `neutral()` / prebaked data (PRD §R2).
+ */
+import type { RenderDevice } from "../RenderDevice.js";
+import type { Texture } from "../Texture.js";
+import type { EnvironmentCaptureRequest, EnvironmentProbe, EnvironmentProbeFactory } from "../contracts/environment.js";
+import { type AuraQualityTier } from "../contracts/quality.js";
+import { type Prd02ProbeBuildOptions } from "./probeBuild.js";
+export interface Prd02EnvironmentProbeFactoryOptions {
+    readonly prefilter?: Prd02ProbeBuildOptions["prefilter"];
+    readonly samples?: number;
+    /** Face size used for `fromScene`/`fromEquirect`/`fromCube` when the caller omits `faceSize`. */
+    readonly defaultFaceSize?: EnvironmentProbe["faceSize"];
+}
+export declare class Prd02EnvironmentProbeFactory implements EnvironmentProbeFactory {
+    private readonly options;
+    private readonly pmrem;
+    constructor(device: RenderDevice, options?: Prd02EnvironmentProbeFactoryOptions);
+    fromScene(req: EnvironmentCaptureRequest, o?: {
+        faceSize?: EnvironmentProbe["faceSize"];
+    }): EnvironmentProbe;
+    fromEquirect(src: Texture, o?: {
+        faceSize?: EnvironmentProbe["faceSize"];
+    }): EnvironmentProbe;
+    fromCube(src: Texture, o?: {
+        faceSize?: EnvironmentProbe["faceSize"];
+    }): EnvironmentProbe;
+    neutral(tier: AuraQualityTier): EnvironmentProbe;
+}
+/** Slot provider entry for `environmentProbeFactorySlot.provide(...)`. */
+export declare function createEnvironmentProbeFactory(device: RenderDevice): EnvironmentProbeFactory;
+//# sourceMappingURL=EnvironmentProbeFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentProbeFactory.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/EnvironmentProbeFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAuC,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEnG,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,eAAe,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CACzD;AAED,qBAAa,4BAA6B,YAAW,uBAAuB;IAKxE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAGxC,MAAM,EAAE,YAAY,EACH,OAAO,GAAE,mCAAwC;IASpE,SAAS,CAAC,GAAG,EAAE,yBAAyB,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,gBAAgB;IAS5G,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,gBAAgB;IAI7F,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;KAAE,GAAG,gBAAgB;IAIzF,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,gBAAgB;CASjD;AAED,0EAA0E;AAC1E,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,YAAY,GAAG,uBAAuB,CAE3F"}

package/dist/environment/EnvironmentProbeFactory.js

@@ -0,0 +1,52 @@
+/**
+ * C-09 real EnvironmentProbeFactory (PRD-02 §6.2/§8.7): builds EnvironmentProbe
+ * objects — PMREM'd specular cube + 9-band SH + optional background texture —
+ * from equirect images, cube sources, GPU scene captures, or the analytic
+ * RoomEnvironmentScene (the always-available neutral floor).
+ *
+ * The GPU capture + prefilter chain lives in `GPUPMREMGenerator`; probe
+ * assembly lives in `probeBuild.ts` so neither direction creates an import
+ * cycle. `fromScene` needs float render targets
+ * (`device.probe.floatColorBuffer` / `halfFloatColorBuffer`); callers without
+ * them fall back to `neutral()` / prebaked data (PRD §R2).
+ */
+import { QUALITY_TIERS } from "../contracts/quality.js";
+import { GPUPMREMGenerator } from "./GPUPMREMGenerator.js";
+import { buildProbeFromFaces, buildRoomFaces } from "./probeBuild.js";
+export class Prd02EnvironmentProbeFactory {
+    options;
+    pmrem;
+    constructor(device, options = {}) {
+        this.options = options;
+        this.pmrem = new GPUPMREMGenerator(device, {
+            faceSize: options.defaultFaceSize,
+            sampleCount: options.samples ?? undefined,
+            prefilter: options.prefilter
+        });
+    }
+    fromScene(req, o) {
+        // EnvironmentProbe.faceSize floor is 128; a 64-resolution request still
+        // captures at 128 so the returned probe satisfies the contract type.
+        return this.pmrem.fromScene((face, target, viewProjection) => req.renderFace(face, target, viewProjection), { faceSize: o?.faceSize ?? Math.max(128, req.resolution) });
+    }
+    fromEquirect(src, o) {
+        return this.pmrem.fromEquirect(src, { faceSize: o?.faceSize });
+    }
+    fromCube(src, o) {
+        return this.pmrem.fromCube(src, { faceSize: o?.faceSize });
+    }
+    neutral(tier) {
+        const faceSize = QUALITY_TIERS[tier].environmentSize;
+        return buildProbeFromFaces(buildRoomFaces(faceSize), faceSize, {
+            prefilter: this.options.prefilter,
+            samples: this.options.samples,
+            source: "neutral",
+            label: "env-neutral"
+        });
+    }
+}
+/** Slot provider entry for `environmentProbeFactorySlot.provide(...)`. */
+export function createEnvironmentProbeFactory(device) {
+    return new Prd02EnvironmentProbeFactory(device);
+}
+//# sourceMappingURL=EnvironmentProbeFactory.js.map

package/dist/environment/EnvironmentProbeFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentProbeFactory.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/EnvironmentProbeFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,EAAE,aAAa,EAAwB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAA+B,MAAM,iBAAiB,CAAC;AASnG,MAAM,OAAO,4BAA4B;IAKpB;IAJF,KAAK,CAAoB;IAE1C,YACE,MAAoB,EACH,UAA+C,EAAE;QAAjD,YAAO,GAAP,OAAO,CAA0C;QAElE,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAC,MAAM,EAAE;YACzC,QAAQ,EAAE,OAAO,CAAC,eAAe;YACjC,WAAW,EAAG,OAAO,CAAC,OAA0C,IAAI,SAAS;YAC7E,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,GAA8B,EAAE,CAA+C;QACvF,wEAAwE;QACxE,qEAAqE;QACrE,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CACzB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAC9E,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAiC,EAAE,CAC3F,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,GAAY,EAAE,CAA+C;QACxE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,QAAQ,CAAC,GAAY,EAAE,CAA+C;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,IAAqB;QAC3B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC;QACrD,OAAO,mBAAmB,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE;YAC7D,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,aAAa;SACrB,CAAC,CAAC;IACL,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,UAAU,6BAA6B,CAAC,MAAoB;IAChE,OAAO,IAAI,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/dist/environment/GPUPMREMGenerator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * GPUPMREMGenerator (PRD-02 §8.7): capture six RGBA16F cube faces on the GPU
+ * (`renderFace` hook + `readFloatPixels`) and produce a PMREM `EnvironmentProbe`.
+ *
+ * The GGX prefilter itself runs through the injected `prefilter` seam — the
+ * default is the CPU implementation (`environment/workers/cpuPrefilter.ts`),
+ * which is also the Worker path. A native GPU FIS pass drops in through the
+ * same seam; `floatColorBuffer`/`halfFloatColorBuffer` probe fields gate the
+ * GPU capture (PRD §R2: callers without them use `neutral()` or prebakes).
+ */
+import { type RenderDevice, type RenderTarget } from "../RenderDevice.js";
+import type { Texture } from "../Texture.js";
+import type { EnvironmentProbe } from "../contracts/environment.js";
+import type { PrefilterCubeSource, PrefilterResult } from "./workers/cpuPrefilter.js";
+import { roughnessToLod, lodToRoughness } from "./workers/cpuPrefilter.js";
+export { roughnessToLod, lodToRoughness };
+export interface GPUPMREMOptions {
+    readonly faceSize?: EnvironmentProbe["faceSize"];
+    readonly sampleCount?: 16 | 32 | 64;
+    readonly minFaceSize?: 16;
+    readonly prefilter?: (source: PrefilterCubeSource, samples?: number) => PrefilterResult;
+}
+type FaceIndex = 0 | 1 | 2 | 3 | 4 | 5;
+export declare class GPUPMREMGenerator {
+    private readonly device;
+    private readonly options;
+    private disposed;
+    constructor(device: RenderDevice, options?: GPUPMREMOptions);
+    private buildOptions;
+    private assertAlive;
+    /** Equirectangular float texture (`data` = Float32 RGBA) → PMREM probe. */
+    fromEquirect(source: Texture, options?: GPUPMREMOptions): EnvironmentProbe;
+    /** Cube texture with Float32 mip-0 faces → PMREM probe. */
+    fromCube(source: Texture, options?: GPUPMREMOptions): EnvironmentProbe;
+    /**
+     * Render the scene into six RGBA16F faces through the caller's `renderFace`
+     * hook (2D targets while Q-01-5 cube render targets are open), then prefilter.
+     */
+    fromScene(renderFace: (face: FaceIndex, target: RenderTarget, viewProjection: Float32Array) => void, options?: GPUPMREMOptions & {
+        readonly position?: readonly [number, number, number];
+    }): EnvironmentProbe;
+    dispose(): void;
+}
+//# sourceMappingURL=GPUPMREMGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GPUPMREMGenerator.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/GPUPMREMGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAOpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACtF,OAAO,EAAoB,cAAc,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,eAAe,CAAC;CACzF;AAED,KAAK,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvC,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAS;gBAGN,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,eAAoB;IAGhD,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IAInB,2EAA2E;IAC3E,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB;IAiB1E,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,gBAAgB;IAkBtE;;;OAGG;IACH,SAAS,CACP,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,KAAK,IAAI,EACzF,OAAO,CAAC,EAAE,eAAe,GAAG;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GACpF,gBAAgB;IA4BnB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/environment/GPUPMREMGenerator.js

@@ -0,0 +1,98 @@
+/**
+ * GPUPMREMGenerator (PRD-02 §8.7): capture six RGBA16F cube faces on the GPU
+ * (`renderFace` hook + `readFloatPixels`) and produce a PMREM `EnvironmentProbe`.
+ *
+ * The GGX prefilter itself runs through the injected `prefilter` seam — the
+ * default is the CPU implementation (`environment/workers/cpuPrefilter.ts`),
+ * which is also the Worker path. A native GPU FIS pass drops in through the
+ * same seam; `floatColorBuffer`/`halfFloatColorBuffer` probe fields gate the
+ * GPU capture (PRD §R2: callers without them use `neutral()` or prebakes).
+ */
+import { RenderDeviceError } from "../RenderDevice.js";
+import { equirectRgbImage, equirectToCubeFaces } from "./HdrEquirect.js";
+import { buildProbeFromFaces, cubeFaceViewProjection } from "./probeBuild.js";
+import { prefilterCubeGGX, roughnessToLod, lodToRoughness } from "./workers/cpuPrefilter.js";
+export { roughnessToLod, lodToRoughness };
+export class GPUPMREMGenerator {
+    device;
+    options;
+    disposed = false;
+    constructor(device, options = {}) {
+        this.device = device;
+        this.options = options;
+    }
+    buildOptions(o) {
+        return {
+            prefilter: o?.prefilter ?? this.options.prefilter,
+            samples: o?.sampleCount ?? this.options.sampleCount
+        };
+    }
+    assertAlive() {
+        if (this.disposed)
+            throw new RenderDeviceError("GPUPMREMGenerator is disposed", "DISPOSED_RESOURCE");
+    }
+    /** Equirectangular float texture (`data` = Float32 RGBA) → PMREM probe. */
+    fromEquirect(source, options) {
+        this.assertAlive();
+        const faceSize = options?.faceSize ?? this.options.faceSize ?? 256;
+        if (!(source.data instanceof Float32Array)) {
+            throw new RenderDeviceError("fromEquirect requires a Texture carrying Float32 RGBA pixels (decode .hdr/.ktx2 first)", "ENVIRONMENT_EQUIRECT_SOURCE_UNSUPPORTED", { format: source.format, hasSource: source.source != null });
+        }
+        // #1153: the texture holds RGBA (rgba32f); the projection reads RGB.
+        const faces = equirectToCubeFaces(equirectRgbImage(source.width, source.height, source.data), faceSize);
+        return buildProbeFromFaces(faces, faceSize, {
+            ...this.buildOptions(options), source: "hdri", background: source, label: "env-equirect"
+        });
+    }
+    /** Cube texture with Float32 mip-0 faces → PMREM probe. */
+    fromCube(source, options) {
+        this.assertAlive();
+        const faceSize = options?.faceSize ?? this.options.faceSize ?? source.width;
+        if (source.dimension !== "cube" || source.cubeFaces.length !== 6) {
+            throw new RenderDeviceError("fromCube requires a cube Texture with 6 faces", "ENVIRONMENT_CUBE_SOURCE_INVALID");
+        }
+        const order = ["px", "nx", "py", "ny", "pz", "nz"];
+        const faces = [];
+        for (const name of order) {
+            const level = source.cubeFaces.find((cf) => cf.face === name)?.mipLevels[0];
+            if (!(level?.data instanceof Float32Array)) {
+                throw new RenderDeviceError("fromCube requires Float32 RGBA face pixels", "ENVIRONMENT_CUBE_SOURCE_UNSUPPORTED", { face: name });
+            }
+            faces.push(level.data);
+        }
+        return buildProbeFromFaces(faces, faceSize, { ...this.buildOptions(options), source: "hdri", label: "env-cube" });
+    }
+    /**
+     * Render the scene into six RGBA16F faces through the caller's `renderFace`
+     * hook (2D targets while Q-01-5 cube render targets are open), then prefilter.
+     */
+    fromScene(renderFace, options) {
+        this.assertAlive();
+        const probe = this.device.probe;
+        if (!probe?.floatColorBuffer && !probe?.halfFloatColorBuffer) {
+            throw new RenderDeviceError("Environment scene capture requires float color buffers (EXT_color_buffer_float); use neutral()/prebaked probes instead", "ENVIRONMENT_PROBE_GPU_UNAVAILABLE");
+        }
+        const size = options?.faceSize ?? this.options.faceSize ?? 128;
+        const faces = [];
+        for (let f = 0; f < 6; f += 1) {
+            const target = this.device.createRenderTarget({ width: size, height: size, format: "rgba16f", label: `env-capture-f${f}` });
+            const prevTarget = this.device.getRenderTarget?.() ?? null;
+            try {
+                this.device.setRenderTarget(target);
+                renderFace(f, target, cubeFaceViewProjection(f, options?.position));
+                faces.push(this.device.readFloatPixels(0, 0, size, size));
+            }
+            finally {
+                this.device.setRenderTarget(prevTarget);
+                target.dispose();
+            }
+        }
+        return buildProbeFromFaces(faces, size, {
+            ...this.buildOptions(options), source: "capture", label: "env-capture"
+        });
+    }
+    dispose() {
+        this.disposed = true;
+    }
+}
+//# sourceMappingURL=GPUPMREMGenerator.js.map

package/dist/environment/GPUPMREMGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GPUPMREMGenerator.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/GPUPMREMGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAwC,MAAM,oBAAoB,CAAC;AAG7F,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAW1C,MAAM,OAAO,iBAAiB;IAIT;IACA;IAJX,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACmB,MAAoB,EACpB,UAA2B,EAAE;QAD7B,WAAM,GAAN,MAAM,CAAc;QACpB,YAAO,GAAP,OAAO,CAAsB;IAC7C,CAAC;IAEI,YAAY,CAAC,CAAmB;QACtC,OAAO;YACL,SAAS,EAAE,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS;YACjD,OAAO,EAAE,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW;SACpD,CAAC;IACJ,CAAC;IAEO,WAAW;QACjB,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,iBAAiB,CAAC,+BAA+B,EAAE,mBAAmB,CAAC,CAAC;IACvG,CAAC;IAED,2EAA2E;IAC3E,YAAY,CAAC,MAAe,EAAE,OAAyB;QACrD,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;QACnE,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,YAAY,YAAY,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,iBAAiB,CACzB,wFAAwF,EACxF,yCAAyC,EACzC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAC5D,CAAC;QACJ,CAAC;QACD,qEAAqE;QACrE,MAAM,KAAK,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QACxG,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE;YAC1C,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc;SACzF,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,QAAQ,CAAC,MAAe,EAAE,OAAyB;QACjD,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAK,MAAM,CAAC,KAAsC,CAAC;QAC9G,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,iBAAiB,CAAC,+CAA+C,EAAE,iCAAiC,CAAC,CAAC;QAClH,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;QAC5D,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;YAC5E,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,YAAY,YAAY,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,iBAAiB,CAAC,4CAA4C,EAAE,qCAAqC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACnI,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACpH,CAAC;IAED;;;OAGG;IACH,SAAS,CACP,UAAyF,EACzF,OAAqF;QAErF,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,gBAAgB,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,CAAC;YAC7D,MAAM,IAAI,iBAAiB,CACzB,wHAAwH,EACxH,mCAAmC,CACpC,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;QAC/D,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5H,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;YAC3D,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBACpC,UAAU,CAAC,CAAc,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAc,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAC9F,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC5D,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;gBACxC,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,mBAAmB,CAAC,KAAK,EAAE,IAAoC,EAAE;YACtE,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa;SACvE,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/environment/HdrEquirect.d.ts

@@ -0,0 +1,28 @@
+export interface HdrImage {
+    readonly width: number;
+    readonly height: number;
+    /** RGB float pixels, row-major, [y][x][rgb]. */
+    readonly data: Float32Array;
+}
+export declare class HdrDecodeError extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/** Decode a Radiance RGBE `.hdr` file (flat or per-scanline RLE). */
+export declare function decodeHdrEquirect(buf: Uint8Array): HdrImage;
+/** 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 declare function hdrImageToRgba32f(img: HdrImage): Float32Array;
+/**
+ * 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 declare function equirectRgbImage(width: number, height: number, data: Float32Array): HdrImage;
+export declare function sampleEquirect(img: HdrImage, dir: readonly [number, number, number]): [number, number, number];
+/** Render an equirect image into 6 cube faces at `faceSize`. */
+export declare function equirectToCubeFaces(img: HdrImage, faceSize: number): Float32Array[];
+//# sourceMappingURL=HdrEquirect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HdrEquirect.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/HdrEquirect.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,cAAe,SAAQ,KAAK;aACX,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI3C;AAmBD,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CA4D3D;AAgBD,kFAAkF;AAClF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY,CAa7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAa5F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAmB9G;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAenF"}