@aura3d/rendering 3.0.1 → 4.0.2

package/dist/passes/ContactShadowPass.js

@@ -0,0 +1,151 @@
+// PRD-02 §6.5 — `ContactShadowPass`: R8 screen-space visibility mask in the
+// C-01 `after-opaque` phase. Reads FRAME_RESOURCES.sceneDepthCopy when the
+// C-01 prepass is real; with the stub it renders its own camera-space depth
+// through PRD 02's DepthPass at half resolution. Ray-marches up to 16 steps
+// along the primary shadowed light's view-space direction over `length`
+// against linear depth with a `thickness` test and interleaved-gradient-noise
+// jitter. The mask is applied inside that light's V_l only (§6.1) through the
+// `a3d_prd02_contact_shadow` chunk — never to total colour.
+import { BaseRenderPass } from "../RenderPass.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { Sampler } from "../Sampler.js";
+import { CONTACT_SHADOW_CHUNK_GLSL } from "../shaders/chunks/contact_shadow.glsl.js";
+import { invertMat4, multiplyMat4 } from "@aura3d/scene";
+import { DepthPass } from "../DepthPass.js";
+import { VertexFormat } from "../VertexFormat.js";
+export const CONTACT_MASK_BLACKBOARD_KEY = "prd02.contactShadowMask";
+const MASK_LABEL = "a3d.prd02.contactShadowMask";
+const OWN_DEPTH_LABEL = "a3d.prd02.contactDepth";
+// GLSL ES 3.00: WebGL2Device.compileShader passes sources through verbatim,
+// so without `#version 300 es` the `in`/`out`/`layout` declarations fail to
+// compile and `lighting.contact` scenes never draw (02-S11, azure-gpu run
+// 38184694289: "WebGL shader compile failed" on prd02-contact-cube).
+const FULLSCREEN_VERT = /* glsl */ `#version 300 es
+// @aura3d-shader:prd02_contact_mask
+in vec2 a_position;
+out vec2 v_uv;
+void main() { v_uv = a_position * 0.5 + 0.5; gl_Position = vec4(a_position, 0.0, 1.0); }
+`;
+const MASK_FRAGMENT = /* glsl */ `#version 300 es
+// @aura3d-shader:prd02_contact_mask
+precision highp float;
+in vec2 v_uv;
+layout(location = 0) out vec4 o_vis;
+${CONTACT_SHADOW_CHUNK_GLSL}
+void main() { o_vis = vec4(a3d_contactShadow(v_uv)); }
+`;
+/** @internal Contact-mask program sources (GLSL validation in unit tests). */
+export const CONTACT_MASK_SHADER_SOURCES = { vertex: FULLSCREEN_VERT, fragment: MASK_FRAGMENT };
+export class ContactShadowPass extends BaseRenderPass {
+    input;
+    mask = null;
+    ownDepth = null;
+    program = null;
+    triBuffer = null;
+    depthPass;
+    lastMask = null;
+    lastDepthSource = "none";
+    executed = false;
+    constructor(input) {
+        super("prd02-contact-shadows", [MASK_LABEL], [MASK_LABEL]);
+        this.input = input;
+        if (!input.sceneDepth?.available && input.casters?.length) {
+            this.depthPass = new DepthPass({
+                casters: input.casters,
+                viewProjectionMatrix: multiplyMat4(input.camera.projectionMatrix, input.camera.viewMatrix),
+                ...(input.depthPassOptions ?? {}),
+            });
+        }
+        else {
+            this.depthPass = null;
+        }
+    }
+    maskTexture() { return this.lastMask; }
+    depthSource() { return this.lastDepthSource; }
+    passExecuted() { return this.executed; }
+    execute(context) {
+        const { device } = context;
+        const prevTarget = device.getRenderTarget?.() ?? null;
+        const w = Math.max(1, Math.floor(context.width / 2));
+        const h = Math.max(1, Math.floor(context.height / 2));
+        if (!this.mask || this.mask.width !== w || this.mask.height !== h) {
+            this.mask?.dispose();
+            this.mask = device.createRenderTarget({ width: w, height: h, format: "rgba8", label: MASK_LABEL });
+        }
+        let depthTex = null;
+        if (this.input.sceneDepth?.available && this.input.sceneDepth.texture) {
+            depthTex = this.input.sceneDepth.texture;
+            this.lastDepthSource = "scene";
+        }
+        else if (this.depthPass) {
+            if (!this.ownDepth || this.ownDepth.width !== w || this.ownDepth.height !== h) {
+                this.ownDepth?.dispose();
+                this.ownDepth = device.createRenderTarget({ width: w, height: h, format: "rgba8", depth: "texture", label: OWN_DEPTH_LABEL });
+            }
+            device.setRenderTarget(this.ownDepth);
+            device.clear([0, 0, 0, 0]);
+            this.depthPass.execute(context);
+            depthTex = this.ownDepth.depthTexture ?? null;
+            this.lastDepthSource = "self";
+        }
+        else {
+            this.lastDepthSource = "none";
+        }
+        this.lastMask = null;
+        this.executed = false;
+        if (!depthTex) {
+            device.setRenderTarget(this.mask);
+            device.clear([1, 1, 1, 1]);
+            this.lastMask = this.mask.colorTexture;
+            device.setRenderTarget(prevTarget);
+            return;
+        }
+        this.program ??= device.createShaderProgram({
+            label: "a3d_prd02_contact_mask",
+            marker: "@aura3d-shader:prd02_contact_mask",
+            vertex: FULLSCREEN_VERT,
+            fragment: MASK_FRAGMENT,
+        });
+        this.triBuffer ??= device.createBuffer("vertex", 24, new Float32Array([-1, -1, 3, -1, -1, 3]));
+        const o = this.input.options ?? {};
+        const steps = Math.min(16, Math.max(1, o.steps ?? 12));
+        const viewSun = normalize3(transformDirection(this.input.camera.viewMatrix, this.input.sunDirection));
+        device.setRenderTarget(this.mask);
+        device.draw({
+            label: "prd02-contact-shadow-mask",
+            topology: "triangles",
+            vertexBuffer: this.triBuffer,
+            vertexFormat: new VertexFormat([{ semantic: "position", components: 2, offset: 0 }], 8),
+            vertexCount: 3,
+            renderState: { depthTest: false, depthWrite: false, cullMode: "none", blend: false, depthCompare: "always" },
+            shader: this.program,
+            uniforms: new Map([
+                ["u_prd02ContactDepth", new TextureBinding({
+                        name: "u_prd02ContactDepth",
+                        texture: depthTex,
+                        sampler: new Sampler({ minFilter: "nearest", magFilter: "nearest", addressU: "clamp-to-edge", addressV: "clamp-to-edge" }),
+                    })],
+                ["u_prd02ContactInvProj", invertMat4(this.input.camera.projectionMatrix)],
+                ["u_prd02ContactProj", this.input.camera.projectionMatrix],
+                ["u_prd02ContactSun", viewSun],
+                ["u_prd02ContactParams", [o.length ?? 0.25, o.thickness ?? 0.05, steps, 0.9]],
+                ["u_prd02ContactNearFar", [this.input.camera.near, this.input.camera.far]],
+            ]),
+        });
+        this.lastMask = this.mask.colorTexture;
+        this.executed = true;
+        device.setRenderTarget(prevTarget);
+    }
+}
+function transformDirection(m, d) {
+    return [
+        m[0] * d[0] + m[4] * d[1] + m[8] * d[2],
+        m[1] * d[0] + m[5] * d[1] + m[9] * d[2],
+        m[2] * d[0] + m[6] * d[1] + m[10] * d[2],
+    ];
+}
+function normalize3(v) {
+    const l = Math.hypot(v[0], v[1], v[2]) || 1;
+    return [v[0] / l, v[1] / l, v[2] / l];
+}
+//# sourceMappingURL=ContactShadowPass.js.map

package/dist/passes/ContactShadowPass.js.map

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

package/dist/passes/Prd02ContactShadowsContributor.d.ts

@@ -0,0 +1,16 @@
+import type { FrameContributorContext, FrameContributor } from "../contracts/frameGraph.js";
+import { type ContactShadowOptions } from "./ContactShadowPass.js";
+export declare const CONTACT_SHADOWS_SUB_FLAG = "A3D_QR_LIGHTING_CONTACT";
+interface ContactShadowsDiagnostics {
+    readonly contactShadows: {
+        readonly passExecuted: boolean;
+        readonly depthSource: string;
+    };
+}
+/** Latest C-31 contact-shadow diagnostics (engine lane reads via rendering barrel). */
+export declare function prd02ContactShadowDiagnostics(): ContactShadowsDiagnostics;
+/** C-27 tier + opt-in + sub-flag resolution. Returns null when the pass must not run. */
+export declare function contactShadowRequest(ctx: FrameContributorContext): ContactShadowOptions | null;
+export declare function createPrd02ContactShadowsContributor(): FrameContributor;
+export {};
+//# sourceMappingURL=Prd02ContactShadowsContributor.d.ts.map

package/dist/passes/Prd02ContactShadowsContributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02ContactShadowsContributor.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/Prd02ContactShadowsContributor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAqB,KAAK,oBAAoB,EAA+B,MAAM,qBAAqB,CAAC;AAQhH,eAAO,MAAM,wBAAwB,4BAAmB,CAAC;AAEzD,UAAU,yBAAyB;IACjC,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3F;AAMD,uFAAuF;AACvF,wBAAgB,6BAA6B,IAAI,yBAAyB,CAEzE;AAiBD,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,GAAG,IAAI,CAe9F;AA6DD,wBAAgB,oCAAoC,IAAI,gBAAgB,CAcvE"}

package/dist/passes/Prd02ContactShadowsContributor.js

@@ -0,0 +1,133 @@
+// PRD-02 §6.5 — `prd02.contactShadows` frame contributor (phase
+// `after-opaque`, lane flag `A3D_QR_LIGHTING`, feature sub-flag
+// `A3D_QR_LIGHTING_CONTACT`). Runs ContactShadowPass when the scene opted in
+// (`effects.contactShadows` → `source.shadow.prd02Contact`), when the tier
+// allows it (C-27 `shadow.contact`, Ultra only in the frozen table — Q-11-3
+// asks for Medium/High), or when the sub-flag forces it. Opt-in works at any
+// tier except Low. Publishes the mask on the blackboard for the shading side
+// and records `contactShadows.passExecuted` for C-31 diagnostics.
+import { BaseRenderPass } from "../RenderPass.js";
+import { ContactShadowPass, CONTACT_MASK_BLACKBOARD_KEY } from "./ContactShadowPass.js";
+import { collectShadowSystemLights } from "../shadows/Prd02ShadowsContributor.js";
+import { resolvePrd02ShadowCasterVariant, prd02DepthFeatures, registerPrd02DepthShader, prd02ShadowCasterEligible } from "../shadows/Prd02DepthShaderLibrary.js";
+import { createLeanCoreShaderLibrary } from "../ShaderLibraryCore.js";
+import { QUALITY_TIERS } from "../contracts/quality.js";
+import { prd02SubFlagOff, readPrd02KillSwitches, SUB_FLAG_CONTACT } from "./Prd02SubFlags.js";
+export const CONTACT_SHADOWS_SUB_FLAG = SUB_FLAG_CONTACT;
+let latestContactDiagnostics = {
+    contactShadows: { passExecuted: false, depthSource: "none" }
+};
+/** Latest C-31 contact-shadow diagnostics (engine lane reads via rendering barrel). */
+export function prd02ContactShadowDiagnostics() {
+    return latestContactDiagnostics;
+}
+/** `ctx.tier` is a settings object — recover its tier name (the ctx carries
+ *  the shared QUALITY_TIERS constants; fall back to shadow-shape matching). */
+function tierNameOf(ctx) {
+    for (const [name, settings] of Object.entries(QUALITY_TIERS)) {
+        if (settings === ctx.tier)
+            return name;
+    }
+    for (const [name, settings] of Object.entries(QUALITY_TIERS)) {
+        if (settings.shadow === ctx.tier.shadow ||
+            (settings.shadow.mapSize === ctx.tier.shadow.mapSize &&
+                settings.shadow.cascades === ctx.tier.shadow.cascades &&
+                settings.shadow.localShadowLights === ctx.tier.shadow.localShadowLights))
+            return name;
+    }
+    return null;
+}
+/** C-27 tier + opt-in + sub-flag resolution. Returns null when the pass must not run. */
+export function contactShadowRequest(ctx) {
+    // `A3D_QR_LIGHTING_CONTACT=off` or `?a3dLighting=contact=off` veto even
+    // Ultra/`effects.contactShadows` requests (§6.5 kill switch).
+    if (prd02SubFlagOff(ctx.flags, SUB_FLAG_CONTACT) || !readPrd02KillSwitches(ctx.source).contact)
+        return null;
+    const optIn = contactShadowOptIn(ctx);
+    if (ctx.flags.on(CONTACT_SHADOWS_SUB_FLAG)) {
+        return optIn ?? {};
+    }
+    if (optIn) {
+        // effects.contactShadows() forces on at any tier except Low (PRD-02 §6.5).
+        if (tierNameOf(ctx) === "low")
+            return null;
+        return optIn;
+    }
+    if (ctx.tier.shadow.contact)
+        return {};
+    return null;
+}
+/** The scene's `effects.contactShadows` opt-in rides `source.shadow` as an
+ *  additive member (same convention as `Prd02ShadowOptions.prd02Shadows`). */
+function contactShadowOptIn(ctx) {
+    const shadow = ctx.source.shadow;
+    if (!shadow || typeof shadow !== "object")
+        return null;
+    const opt = shadow.prd02Contact;
+    return opt ?? null;
+}
+// One lean depth library per device (registered with the prd02 depth shader).
+const contactDepthLibraries = new WeakMap();
+function depthLibraryFor(device) {
+    let lib = contactDepthLibraries.get(device);
+    if (!lib) {
+        lib = createLeanCoreShaderLibrary();
+        registerPrd02DepthShader(lib);
+        contactDepthLibraries.set(device, lib);
+    }
+    return lib;
+}
+class Prd02ContactShadowsRenderPass extends BaseRenderPass {
+    ctx;
+    pass;
+    constructor(ctx, request) {
+        super("prd02.contactShadows", [], []);
+        this.ctx = ctx;
+        const { sunDirection } = collectShadowSystemLights(ctx);
+        this.pass = new ContactShadowPass({
+            sunDirection: sunDirection ?? [0, -1, 0],
+            camera: ctx.camera ?? {
+                viewMatrix: new Float32Array(16).fill(0),
+                projectionMatrix: new Float32Array(16).fill(0),
+                near: 0.1,
+                far: 100
+            },
+            sceneDepth: ctx.sceneDepth,
+            casters: ctx.items.filter(prd02ShadowCasterEligible),
+            depthPassOptions: {
+                shaderLibrary: depthLibraryFor(ctx.device),
+                variantResolver: (item) => resolvePrd02ShadowCasterVariant(item, ctx.flags, ctx.tier, prd02DepthFeatures()),
+                depthVariantFeatures: prd02DepthFeatures()
+            },
+            options: request
+        });
+    }
+    execute(context) {
+        this.pass.execute(context);
+        this.ctx.blackboard.set(CONTACT_MASK_BLACKBOARD_KEY, this.pass.maskTexture());
+        latestContactDiagnostics = {
+            contactShadows: {
+                passExecuted: this.pass.passExecuted(),
+                depthSource: this.pass.depthSource()
+            }
+        };
+    }
+}
+export function createPrd02ContactShadowsContributor() {
+    prd02DepthFeatures();
+    return {
+        id: "prd02.contactShadows",
+        owner: "prd02",
+        flag: "A3D_QR_LIGHTING",
+        phases: ["after-opaque"],
+        passes: (phase, ctx) => {
+            if (phase !== "after-opaque")
+                return [];
+            const request = contactShadowRequest(ctx);
+            if (!request || !ctx.camera)
+                return [];
+            return [new Prd02ContactShadowsRenderPass(ctx, request)];
+        }
+    };
+}
+//# sourceMappingURL=Prd02ContactShadowsContributor.js.map

package/dist/passes/Prd02ContactShadowsContributor.js.map

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

package/dist/passes/Prd02SubFlags.d.ts

@@ -0,0 +1,22 @@
+import type { QrFlags } from "../contracts/core.js";
+export declare const SUB_FLAG_CSM = "A3D_QR_LIGHTING_CSM";
+export declare const SUB_FLAG_PROBES = "A3D_QR_LIGHTING_PROBES";
+export declare const SUB_FLAG_CONTACT = "A3D_QR_LIGHTING_CONTACT";
+/** Explicitly disabled (`=0`, `-name`, `=off`) — distinct from unset. */
+export declare function prd02SubFlagOff(flags: QrFlags, name: string): boolean;
+/** Structural mirror of `Prd02LightingKillSwitches` (engine/compiler) —
+ *  rendering reads it off `source.shadow.prd02KillSwitches`. */
+export interface Prd02KillSwitchesLike {
+    readonly pmrem: "cpu" | null;
+    readonly atlas: boolean;
+    readonly shadowFilter: "legacy-grid" | null;
+    readonly shadows: boolean;
+    readonly background: boolean;
+    readonly csm: boolean;
+    readonly probes: boolean;
+    readonly contact: boolean;
+}
+/** `source.shadow.prd02KillSwitches` when present, else all-on defaults
+ *  (matches `readLightingKillSwitches` semantics for absent URLs). */
+export declare function readPrd02KillSwitches(source: unknown): Prd02KillSwitchesLike;
+//# sourceMappingURL=Prd02SubFlags.d.ts.map

package/dist/passes/Prd02SubFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02SubFlags.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/Prd02SubFlags.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,sBAAsB,CAAC;AAEjE,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAClD,eAAO,MAAM,eAAe,2BAA2B,CAAC;AACxD,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrE;AAID;gEACgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAOD;sEACsE;AACtE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,qBAAqB,CAI5E"}

package/dist/passes/Prd02SubFlags.js

@@ -0,0 +1,32 @@
+// PRD-02 §6.5 real sub-flags under `A3D_QR_LIGHTING` (bool — `QrFlagName`
+// template `A3D_QR_<AREA>_<SUB>`). `?a3dLighting=` URL kill switches
+// (`pmrem=cpu`, `atlas=off`, `shadowFilter=legacy-grid`, `shadows=off`,
+// `background=off`, plus `csm/probes/contact` aliases) are NOT flags — they
+// are parsed in `compiler/lights.ts` and arrive on
+// `source.shadow.prd02KillSwitches`.
+//
+// `flags.on(name)` cannot distinguish "unset" from "set false" — and both
+// matter here: `A3D_QR_LIGHTING_CONTACT` explicit-on is an opt-in (forces
+// the pass on non-Ultra tiers), explicit-off vetoes a tier/opt-in request,
+// unset defers to C-27/`effects.contactShadows`. `prd02SubFlagOff` reads the
+// raw value so "off" and "absent" stay distinct.
+export const SUB_FLAG_CSM = "A3D_QR_LIGHTING_CSM"; // off = single fitted map
+export const SUB_FLAG_PROBES = "A3D_QR_LIGHTING_PROBES"; // off = prd02.probes off
+export const SUB_FLAG_CONTACT = "A3D_QR_LIGHTING_CONTACT"; // off = veto; on = opt-in
+/** Explicitly disabled (`=0`, `-name`, `=off`) — distinct from unset. */
+export function prd02SubFlagOff(flags, name) {
+    const v = (flags.values ?? {})[name];
+    return v === false || v === "0" || v === "off";
+}
+const ALL_ON = {
+    pmrem: null, atlas: true, shadowFilter: null,
+    shadows: true, background: true, csm: true, probes: true, contact: true
+};
+/** `source.shadow.prd02KillSwitches` when present, else all-on defaults
+ *  (matches `readLightingKillSwitches` semantics for absent URLs). */
+export function readPrd02KillSwitches(source) {
+    const shadow = source?.shadow;
+    const ks = shadow?.prd02KillSwitches;
+    return ks && typeof ks === "object" ? { ...ALL_ON, ...ks } : ALL_ON;
+}
+//# sourceMappingURL=Prd02SubFlags.js.map

package/dist/passes/Prd02SubFlags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02SubFlags.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/passes/Prd02SubFlags.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,wEAAwE;AACxE,4EAA4E;AAC5E,mDAAmD;AACnD,qCAAqC;AACrC,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,iDAAiD;AAIjD,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,CAAC,CAAS,0BAA0B;AACrF,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC,CAAG,yBAAyB;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,CAAC,0BAA0B;AAErF,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,IAAY;IAC1D,MAAM,CAAC,GAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAuD,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;AACjD,CAAC;AAiBD,MAAM,MAAM,GAA0B;IACpC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI;IAC5C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI;CACxE,CAAC;AAEF;sEACsE;AACtE,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,MAAM,MAAM,GAAI,MAAsC,EAAE,MAAM,CAAC;IAC/D,MAAM,EAAE,GAAI,MAAiD,EAAE,iBAAiB,CAAC;IACjF,OAAO,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAI,EAAqC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1G,CAAC"}

package/dist/performance/BVH.d.ts

@@ -1,3 +1,49 @@
+import type { StaticSpatialBounds as BatchBounds, StaticSpatialItem as BatchSpatialItem } from "../SceneOptimization.js";
 export { buildStaticBoundsBvh, queryStaticBoundsBvh, raycastStaticBoundsBvh, updateStaticBoundsBvh } from "../SceneOptimization.js";
 export type { StaticBoundsBvh, StaticBoundsBvhBuildDiagnostics, StaticBoundsBvhNode, StaticBoundsBvhQueryOptions, StaticBoundsBvhQueryResult, StaticBoundsBvhRaycastHit, StaticBoundsBvhRaycastResult, StaticBoundsBvhTraversalDiagnostics, StaticSpatialBounds, StaticSpatialItem } from "../SceneOptimization.js";
+/**
+ * #181: a merged-bounds cull hint for one PRD 11 BatchPlan group — the union
+ * of its members' bounds. Members listed here skip their own BVH nodes and
+ * are culled once, as a group.
+ */
+export interface BatchCullHint<T = unknown> {
+    readonly id: string;
+    readonly bounds: BatchBounds;
+    readonly memberIds: readonly string[];
+    readonly members?: readonly T[];
+}
+/** Union of `bounds` (the merged bounds a BatchPlan group is culled against). */
+export declare function mergeBatchBounds(bounds: readonly BatchBounds[]): BatchBounds;
+/** Drop BatchPlan members from the per-item BVH input; their group hint culls them instead. */
+export declare function excludeBatchedBvhItems<T>(items: readonly BatchSpatialItem<T>[], hints: readonly BatchCullHint[]): BatchSpatialItem<T>[];
+/**
+ * Cull each group once against its merged bounds: `isVisible` runs one test
+ * per hint (not per member). Returns the visible member ids and the number
+ * of bounds tests issued.
+ */
+export declare function cullBatchHints(hints: readonly BatchCullHint[], isVisible: (bounds: BatchBounds) => boolean): {
+    readonly visibleMemberIds: readonly string[];
+    readonly visibleHints: readonly string[];
+    readonly tests: number;
+};
+import type { StaticBoundsBvh, StaticSpatialItem } from "../SceneOptimization.js";
+type Vec3Tuple = readonly [number, number, number];
+/** #215 (Q-11-2 from PRD-08): result of `sphereSweep`. */
+export interface BvhSphereSweepResult<T = unknown> {
+    readonly hit: boolean;
+    /** Distance travelled by the sphere centre from `from` to first contact; `Infinity` on a miss. */
+    readonly distance: number;
+    /** Id of the BVH leaf node holding the hit item; `-1` on a miss. */
+    readonly nodeId: number;
+    readonly item: StaticSpatialItem<T> | null;
+    /** Sphere centre at first contact; `null` on a miss. */
+    readonly point: Vec3Tuple | null;
+}
+/**
+ * #215: sweep a sphere from `from` to `to` through a static-bounds BVH and
+ * return the first item it touches. A sphere already touching an item at
+ * `from` hits at distance 0. Traversal visits children nearest-first and
+ * prunes nodes whose grown-box entry is beyond the best hit.
+ */
+export declare function sphereSweep<T = unknown>(bvh: StaticBoundsBvh<T>, from: Vec3Tuple, to: Vec3Tuple, radius: number): BvhSphereSweepResult<T>;
 //# sourceMappingURL=BVH.d.ts.map

package/dist/performance/BVH.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BVH.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/BVH.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,mCAAmC,EACnC,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"BVH.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/performance/BVH.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,WAAW,EAAE,iBAAiB,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,mCAAmC,EACnC,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;CACjC;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAW5E;AAED,+FAA+F;AAC/F,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAIvI;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAW/N;AAED,OAAO,KAAK,EAAE,eAAe,EAA4C,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzH,KAAK,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3C,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAClC;AAgHD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACrC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EACvB,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,GACb,oBAAoB,CAAC,CAAC,CAAC,CA2CzB"}