@aura3d/engine 2.0.4 → 3.0.0

package/dist/rendering/shadows/CascadeHysteresis.d.ts

@@ -0,0 +1,67 @@
+/**
+ * B1 cascade stabilization (muse3jsparity-PRD).
+ *
+ * Sits on top of the existing `selectForwardShadowMap` depth selection:
+ * hysteresis on cascade selection, a temporal shimmer metric, and
+ * per-cascade bias tables. Pure functions so the 60s moving-camera browser
+ * stress can assert the same math the renderer uses.
+ */
+export interface HysteresisCascadeSplit {
+    readonly index: number;
+    readonly near: number;
+    readonly far: number;
+}
+export interface CascadeHysteresisInput {
+    readonly depth: number;
+    readonly splits: readonly HysteresisCascadeSplit[];
+    /** Previously selected cascade index, or null on the first frame. */
+    readonly previousIndex: number | null;
+    /**
+     * Hysteresis band as a fraction of the current cascade depth span.
+     * The camera must travel this far past a boundary before the selection
+     * flips, which kills boundary flicker on long moving-camera paths.
+     */
+    readonly hysteresis?: number;
+}
+export declare function selectCascadeWithHysteresis(input: CascadeHysteresisInput): number;
+export interface ShimmerSample {
+    readonly cascadeIndex: number;
+    /** Receiver depth used for this frame's selection. */
+    readonly depth: number;
+}
+export interface ShimmerScore {
+    /** Fraction of frames where the cascade index changed (0 = rock solid). */
+    readonly flipRate: number;
+    /** Mean absolute depth delta per frame, normalized by scene depth range. */
+    readonly depthJitter: number;
+    /** Combined score in [0, 1]; the B1 long-path stress asserts this. */
+    readonly score: number;
+    readonly frames: number;
+}
+/**
+ * Temporal shimmer metric over a moving-camera sample window.
+ * flipRate captures cascade-boundary flicker; depthJitter captures the
+ * camera-path energy so the stress report proves the camera actually moved.
+ */
+export declare function computeShimmerScore(samples: readonly ShimmerSample[], sceneDepthRange: number): ShimmerScore;
+export interface CascadeBiasTableEntry {
+    readonly cascadeIndex: number;
+    readonly baseBias: number;
+    readonly slopeScale: number;
+    readonly texelSize: number;
+    /** Effective bias at normal incidence (grazing adds slope term). */
+    readonly effectiveBias: number;
+}
+/**
+ * Per-cascade bias tables: outer cascades cover more world per texel, so
+ * both the base bias and the slope scale grow with cascade index while the
+ * innermost cascade keeps the tightest values (contact-gap retention).
+ */
+export declare function createCascadeBiasTable(options: {
+    readonly cascadeCount: number;
+    readonly baseBias?: number;
+    readonly slopeScale?: number;
+    readonly texelSize?: number;
+    readonly growthPerCascade?: number;
+}): readonly CascadeBiasTableEntry[];
+//# sourceMappingURL=CascadeHysteresis.d.ts.map

package/dist/rendering/shadows/CascadeHysteresis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CascadeHysteresis.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/shadows/CascadeHysteresis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAuBjF;AAOD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,CAmB5G;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC,GAAG,SAAS,qBAAqB,EAAE,CAwBnC"}

package/dist/rendering/shadows/CascadeHysteresis.js

@@ -0,0 +1,104 @@
+/**
+ * B1 cascade stabilization (muse3jsparity-PRD).
+ *
+ * Sits on top of the existing `selectForwardShadowMap` depth selection:
+ * hysteresis on cascade selection, a temporal shimmer metric, and
+ * per-cascade bias tables. Pure functions so the 60s moving-camera browser
+ * stress can assert the same math the renderer uses.
+ */
+export function selectCascadeWithHysteresis(input) {
+    if (input.splits.length === 0)
+        throw new RangeError("Cascade hysteresis requires at least one split.");
+    if (!Number.isFinite(input.depth) || input.depth < 0) {
+        throw new RangeError("Cascade hysteresis depth must be finite and non-negative.");
+    }
+    const hysteresis = input.hysteresis ?? 0.08;
+    if (!Number.isFinite(hysteresis) || hysteresis < 0 || hysteresis > 0.5) {
+        throw new RangeError("Cascade hysteresis must be in [0, 0.5].");
+    }
+    const raw = rawCascadeIndex(input.depth, input.splits);
+    if (input.previousIndex === null)
+        return raw;
+    if (raw === input.previousIndex)
+        return raw;
+    const current = input.splits[input.previousIndex];
+    if (!current)
+        return raw;
+    const span = Math.max(current.far - current.near, 1e-6);
+    if (raw > input.previousIndex) {
+        // Moving outward: require depth to clear the far edge + band.
+        if (input.depth <= current.far + hysteresis * span)
+            return input.previousIndex;
+        return raw;
+    }
+    // Moving inward: require depth to clear the near edge - band.
+    if (input.depth >= current.near - hysteresis * span)
+        return input.previousIndex;
+    return raw;
+}
+function rawCascadeIndex(depth, splits) {
+    const hit = splits.find((split) => depth <= split.far);
+    return hit ? hit.index : splits[splits.length - 1].index;
+}
+/**
+ * Temporal shimmer metric over a moving-camera sample window.
+ * flipRate captures cascade-boundary flicker; depthJitter captures the
+ * camera-path energy so the stress report proves the camera actually moved.
+ */
+export function computeShimmerScore(samples, sceneDepthRange) {
+    if (samples.length < 2)
+        throw new RangeError("Shimmer scoring requires at least two samples.");
+    if (!Number.isFinite(sceneDepthRange) || sceneDepthRange <= 0) {
+        throw new RangeError("Shimmer sceneDepthRange must be finite and positive.");
+    }
+    let flips = 0;
+    let jitter = 0;
+    for (let i = 1; i < samples.length; i += 1) {
+        if (samples[i].cascadeIndex !== samples[i - 1].cascadeIndex)
+            flips += 1;
+        jitter += Math.abs(samples[i].depth - samples[i - 1].depth);
+    }
+    const frames = samples.length - 1;
+    const flipRate = Number((flips / frames).toFixed(6));
+    const depthJitter = Number((jitter / frames / sceneDepthRange).toFixed(6));
+    // A static camera legitimately scores 0 (no flicker without motion), so the
+    // B1 60s stress must drive a moving-camera path: depthJitter is reported
+    // alongside the score so reviewers can verify the path had energy.
+    const score = Number(Math.min(1, flipRate * (1 + depthJitter * 10)).toFixed(6));
+    return { flipRate, depthJitter, score, frames: samples.length };
+}
+/**
+ * Per-cascade bias tables: outer cascades cover more world per texel, so
+ * both the base bias and the slope scale grow with cascade index while the
+ * innermost cascade keeps the tightest values (contact-gap retention).
+ */
+export function createCascadeBiasTable(options) {
+    const cascadeCount = options.cascadeCount;
+    if (!Number.isInteger(cascadeCount) || cascadeCount <= 0 || cascadeCount > 8) {
+        throw new RangeError("Cascade bias table requires 1-8 cascades.");
+    }
+    const baseBias = options.baseBias ?? 0.001;
+    const slopeScale = options.slopeScale ?? 1;
+    const texelSize = options.texelSize ?? 1;
+    const growth = options.growthPerCascade ?? 0.35;
+    if (!Number.isFinite(baseBias) || baseBias < 0)
+        throw new RangeError("Cascade baseBias must be finite and non-negative.");
+    if (!Number.isFinite(slopeScale) || slopeScale < 0)
+        throw new RangeError("Cascade slopeScale must be finite and non-negative.");
+    if (!Number.isFinite(texelSize) || texelSize <= 0)
+        throw new RangeError("Cascade texelSize must be finite and positive.");
+    if (!Number.isFinite(growth) || growth < 0)
+        throw new RangeError("Cascade bias growth must be finite and non-negative.");
+    return Array.from({ length: cascadeCount }, (_, index) => {
+        const entryBase = Number((baseBias * (1 + growth * index)).toFixed(8));
+        const entrySlope = Number((slopeScale * (1 + growth * index)).toFixed(8));
+        return {
+            cascadeIndex: index,
+            baseBias: entryBase,
+            slopeScale: entrySlope,
+            texelSize,
+            effectiveBias: entryBase,
+        };
+    });
+}
+//# sourceMappingURL=CascadeHysteresis.js.map

package/dist/rendering/shadows/CascadeHysteresis.js.map

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

package/dist/rendering/shadows/ContactShadows.d.ts

@@ -34,4 +34,56 @@ export interface ExternalParityContactShadowPlan {
 }
 export declare function createExternalParityContactShadow(options: ExternalParityContactShadowOptions): ExternalParityContactShadow;
 export declare function createExternalParityContactShadowPlan(options: ExternalParityContactShadowPlanOptions): ExternalParityContactShadowPlan;
+export type ContactOccluderKind = "capsule" | "plane";
+export interface ContactOccluder {
+    readonly id: string;
+    readonly kind: ContactOccluderKind;
+    /** Capsule segment endpoints (world) for "capsule"; ignored for "plane". */
+    readonly segmentA?: readonly [number, number, number];
+    readonly segmentB?: readonly [number, number, number];
+    /** Capsule radius in world units. */
+    readonly radius?: number;
+    /** Plane normal (world, normalized by the resolver) for "plane". */
+    readonly planeNormal?: readonly [number, number, number];
+    /** Plane offset along the normal for "plane". */
+    readonly planeOffset?: number;
+}
+export interface ContactReceiverSample {
+    readonly objectId: string;
+    readonly receiverPosition: readonly [number, number, number];
+    readonly receiverNormal: readonly [number, number, number];
+}
+export interface ContactDarkeningSample {
+    readonly objectId: string;
+    /** Mean occlusion in [0, 1]; 0 = untouched, 1 = fully grounded. */
+    readonly contactDarkening: number;
+    /** Bent normal (world) approximating blocked-hemisphere leakage. */
+    readonly bentNormal: readonly [number, number, number];
+    /** Contact radius used for this receiver (depth-hardened). */
+    readonly radius: number;
+}
+export interface ContactTelemetryFrame {
+    readonly frame: number;
+    readonly samples: readonly ContactDarkeningSample[];
+    /** Max |darkening| delta vs the previous frame (frame-stability proof). */
+    readonly maxFrameDelta: number;
+}
+/**
+ * Depth-aware contact radius: the contact hardens (shrinks) as the
+ * caster-to-receiver distance grows, so distant pairs fade instead of
+ * smearing.
+ */
+export declare function resolveDepthAwareContactRadius(baseRadius: number, casterDistance: number, falloffDistance: number): number;
+/**
+ * Analytic contact darkening for one receiver against capsule/plane
+ * occluders. Deterministic in its inputs: identical frames produce
+ * identical telemetry (frame-stable by construction).
+ */
+export declare function resolveContactDarkening(receiver: ContactReceiverSample, occluders: readonly ContactOccluder[], options?: {
+    readonly baseRadius?: number;
+    readonly falloffDistance?: number;
+    readonly opacity?: number;
+}): ContactDarkeningSample;
+/** Frame telemetry with max per-object delta vs the previous frame. */
+export declare function createContactTelemetryFrame(frame: number, samples: readonly ContactDarkeningSample[], previous: ContactTelemetryFrame | null): ContactTelemetryFrame;
 //# sourceMappingURL=ContactShadows.d.ts.map

package/dist/rendering/shadows/ContactShadows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactShadows.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/shadows/ContactShadows.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sCAAuC,SAAQ,kCAAkC;IAChG,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,gCAAgC,EAAE,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,2BAA2B,EAAE,SAAS,MAAM,EAAE,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,kCAAkC,GAAG,2BAA2B,CAc1H;AAED,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,sCAAsC,GAAG,+BAA+B,CA+BtI"}
+{"version":3,"file":"ContactShadows.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/shadows/ContactShadows.ts"],"names":[],"mappings":"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"}

package/dist/rendering/shadows/ContactShadows.js

@@ -65,4 +65,126 @@ function finite(value, label) {
 function clamp(value, min, max) {
     return Math.min(max, Math.max(min, value));
 }
+/**
+ * Depth-aware contact radius: the contact hardens (shrinks) as the
+ * caster-to-receiver distance grows, so distant pairs fade instead of
+ * smearing.
+ */
+export function resolveDepthAwareContactRadius(baseRadius, casterDistance, falloffDistance) {
+    if (!Number.isFinite(baseRadius) || baseRadius <= 0)
+        throw new RangeError("Contact baseRadius must be finite and positive.");
+    if (!Number.isFinite(casterDistance) || casterDistance < 0)
+        throw new RangeError("Contact casterDistance must be finite and non-negative.");
+    if (!Number.isFinite(falloffDistance) || falloffDistance <= 0)
+        throw new RangeError("Contact falloffDistance must be finite and positive.");
+    const t = clamp(casterDistance / falloffDistance, 0, 1);
+    return Number((baseRadius * (1 - 0.65 * t)).toFixed(4));
+}
+function distancePointToSegment(point, a, b) {
+    const ab = [b[0] - a[0], b[1] - a[1], b[2] - a[2]];
+    const lengthSquared = ab[0] * ab[0] + ab[1] * ab[1] + ab[2] * ab[2];
+    if (lengthSquared <= 1e-12) {
+        return Math.hypot(point[0] - a[0], point[1] - a[1], point[2] - a[2]);
+    }
+    const t = clamp(((point[0] - a[0]) * ab[0] + (point[1] - a[1]) * ab[1] + (point[2] - a[2]) * ab[2]) / lengthSquared, 0, 1);
+    return Math.hypot(point[0] - (a[0] + ab[0] * t), point[1] - (a[1] + ab[1] * t), point[2] - (a[2] + ab[2] * t));
+}
+/**
+ * Analytic contact darkening for one receiver against capsule/plane
+ * occluders. Deterministic in its inputs: identical frames produce
+ * identical telemetry (frame-stable by construction).
+ */
+export function resolveContactDarkening(receiver, occluders, options = {}) {
+    if (!receiver.objectId.trim())
+        throw new Error("Contact receiver objectId is required.");
+    const baseRadius = options.baseRadius ?? 0.5;
+    const falloffDistance = options.falloffDistance ?? 2;
+    const opacity = clamp(options.opacity ?? 0.55, 0, 1);
+    let occlusion = 0;
+    let bentX = 0;
+    let bentY = 0;
+    let bentZ = 0;
+    let nearestDistance = Number.POSITIVE_INFINITY;
+    for (const occluder of occluders) {
+        if (occluder.kind === "capsule") {
+            if (!occluder.segmentA || !occluder.segmentB)
+                throw new Error(`Contact capsule occluder ${occluder.id} requires segmentA/segmentB.`);
+            const radius = occluder.radius ?? 0.25;
+            if (!Number.isFinite(radius) || radius <= 0)
+                throw new RangeError(`Contact capsule occluder ${occluder.id} radius must be positive.`);
+            const distance = distancePointToSegment(receiver.receiverPosition, occluder.segmentA, occluder.segmentB);
+            nearestDistance = Math.min(nearestDistance, distance);
+            const hardened = resolveDepthAwareContactRadius(baseRadius, distance, falloffDistance);
+            const local = clamp(1 - Math.max(0, distance - radius) / Math.max(hardened, 1e-6), 0, 1);
+            occlusion = Math.max(occlusion, local);
+            const away = distance <= 1e-9
+                ? [0, 1, 0]
+                : [
+                    (receiver.receiverPosition[0] - occluder.segmentA[0]) / distance,
+                    (receiver.receiverPosition[1] - occluder.segmentA[1]) / distance,
+                    (receiver.receiverPosition[2] - occluder.segmentA[2]) / distance,
+                ];
+            bentX += away[0] * local;
+            bentY += away[1] * local;
+            bentZ += away[2] * local;
+        }
+        else if (occluder.kind === "plane") {
+            if (!occluder.planeNormal)
+                throw new Error(`Contact plane occluder ${occluder.id} requires planeNormal.`);
+            const normalLength = Math.hypot(occluder.planeNormal[0], occluder.planeNormal[1], occluder.planeNormal[2]);
+            if (!Number.isFinite(normalLength) || normalLength <= 0)
+                throw new RangeError(`Contact plane occluder ${occluder.id} normal must be non-zero.`);
+            const normal = [
+                occluder.planeNormal[0] / normalLength,
+                occluder.planeNormal[1] / normalLength,
+                occluder.planeNormal[2] / normalLength,
+            ];
+            const offset = occluder.planeOffset ?? 0;
+            const distance = Math.abs(receiver.receiverPosition[0] * normal[0] + receiver.receiverPosition[1] * normal[1] + receiver.receiverPosition[2] * normal[2] - offset);
+            nearestDistance = Math.min(nearestDistance, distance);
+            const hardened = resolveDepthAwareContactRadius(baseRadius, distance, falloffDistance);
+            const local = clamp(1 - distance / Math.max(hardened, 1e-6), 0, 1);
+            occlusion = Math.max(occlusion, local);
+            bentX += normal[0] * local;
+            bentY += normal[1] * local;
+            bentZ += normal[2] * local;
+        }
+        else {
+            throw new Error(`Unsupported contact occluder kind: ${String(occluder.kind)}`);
+        }
+    }
+    const normal = receiver.receiverNormal;
+    const bentLength = Math.hypot(normal[0] + bentX * 0.5, normal[1] + bentY * 0.5, normal[2] + bentZ * 0.5);
+    const bentNormal = bentLength <= 1e-9
+        ? [normal[0], normal[1], normal[2]]
+        : [
+            Number(((normal[0] + bentX * 0.5) / bentLength).toFixed(6)),
+            Number(((normal[1] + bentY * 0.5) / bentLength).toFixed(6)),
+            Number(((normal[2] + bentZ * 0.5) / bentLength).toFixed(6)),
+        ];
+    const radius = occluders.length === 0 || !Number.isFinite(nearestDistance)
+        ? baseRadius
+        : resolveDepthAwareContactRadius(baseRadius, nearestDistance, falloffDistance);
+    return {
+        objectId: receiver.objectId,
+        contactDarkening: Number((clamp(occlusion, 0, 1) * opacity).toFixed(4)),
+        bentNormal,
+        radius,
+    };
+}
+/** Frame telemetry with max per-object delta vs the previous frame. */
+export function createContactTelemetryFrame(frame, samples, previous) {
+    if (!Number.isInteger(frame) || frame < 0)
+        throw new RangeError("Contact telemetry frame must be a non-negative integer.");
+    let maxFrameDelta = 0;
+    if (previous) {
+        const prior = new Map(previous.samples.map((sample) => [sample.objectId, sample.contactDarkening]));
+        for (const sample of samples) {
+            const before = prior.get(sample.objectId);
+            if (before !== undefined)
+                maxFrameDelta = Math.max(maxFrameDelta, Math.abs(sample.contactDarkening - before));
+        }
+    }
+    return { frame, samples, maxFrameDelta: Number(maxFrameDelta.toFixed(6)) };
+}
 //# sourceMappingURL=ContactShadows.js.map

package/dist/rendering/shadows/ContactShadows.js.map

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

package/dist/rendering/shadows/SpotShadowMaps.d.ts

@@ -0,0 +1,77 @@
+import type { TextureBinding } from "../TextureBinding.js";
+import { type ShadowFilterKernel } from "../ShadowMap.js";
+/**
+ * B1 spot shadow path (muse3jsparity-PRD).
+ *
+ * Perspective spot shadows were the missing member of the shadow family:
+ * directional CSM + point-cube uniforms already exist in ForwardPass, but
+ * zero `spot` matches existed there. This module owns the spot side:
+ * options, perspective projection math, projective-UV evaluation, a CPU
+ * PCF reference mirror (fixed inputs -> expected factor, so refactors
+ * cannot silently regress the math), and atlas sizing tiers.
+ *
+ * The GLSL sampling reuses the shared PCF/Poisson kernel tables from
+ * ShadowMap.ts (same policy as the point cube path); slope-scaled bias
+ * reuses `computeShadowDepthBias`.
+ */
+export interface ForwardSpotShadowMapOptions {
+    readonly texture: TextureBinding;
+    /** World-space position of the spot light. */
+    readonly lightPosition: readonly [number, number, number];
+    /** Normalized world-space direction of the spot cone axis. */
+    readonly lightDirection: readonly [number, number, number];
+    /** Outer cone half-angle in radians, within (0, PI/2). */
+    readonly angle: number;
+    /** Penumbra blend in [0, 1] (matches CollectedLight.penumbra). */
+    readonly penumbra: number;
+    /** Shadow camera far plane (range). Must be positive. */
+    readonly range: number;
+    /** Perspective spot shadow matrix (projection * view), 16 numbers. */
+    readonly shadowMatrix: Float32Array | readonly number[];
+    readonly strength?: number;
+    readonly bias?: number;
+    readonly slopeBias?: number;
+    readonly texelSize?: readonly [number, number];
+    readonly filterKernel?: ShadowFilterKernel;
+}
+export interface SpotShadowProjection {
+    /** Vertical field of view in radians (2 * angle). */
+    readonly fovY: number;
+    readonly near: number;
+    readonly far: number;
+    /** Column-major perspective matrix entries (16 numbers). */
+    readonly projectionMatrix: readonly number[];
+}
+export interface SpotShadowAtlasTier {
+    readonly resolution: number;
+    readonly reason: string;
+}
+export declare function createSpotShadowProjection(angle: number, range: number, near?: number): SpotShadowProjection;
+/**
+ * Projective UV + linear depth of a world position in spot shadow space.
+ * Returns null when the position is behind the light or outside the cone.
+ */
+export declare function projectSpotShadowUv(worldPosition: readonly [number, number, number], lightPosition: readonly [number, number, number], lightDirection: readonly [number, number, number], angle: number, shadowMatrix: Float32Array | readonly number[]): {
+    readonly u: number;
+    readonly v: number;
+    readonly depth: number;
+} | null;
+export interface SpotShadowFactorInput {
+    /** Sampled occluder depths, one per PCF tap, in [0, 1]. */
+    readonly tapDepths: readonly number[];
+    readonly receiverDepth: number;
+    readonly normalDotLight: number;
+    readonly baseBias?: number;
+    readonly slopeScale?: number;
+    readonly texelSize?: number;
+    readonly strength?: number;
+}
+/**
+ * CPU mirror of the spot PCF compare: hardens the point-cube path's shared
+ * bias tables (computeShadowDepthBias) and averages lit taps.
+ */
+export declare function resolveSpotShadowFactor(input: SpotShadowFactorInput): number;
+/** Atlas resolution tier for a spot light: wider cones cost more texels. */
+export declare function selectSpotShadowAtlasTier(angle: number): SpotShadowAtlasTier;
+export declare function defaultSpotShadowKernel(): ShadowFilterKernel;
+//# sourceMappingURL=SpotShadowMaps.d.ts.map

package/dist/rendering/shadows/SpotShadowMaps.d.ts.map

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

package/dist/rendering/shadows/SpotShadowMaps.js

@@ -0,0 +1,106 @@
+import { computeShadowDepthBias, createShadowFilterKernel, } from "../ShadowMap.js";
+const DEFAULT_SPOT_SHADOW_KERNEL = createShadowFilterKernel({ filter: "pcf", pcfRadius: 1, pcfSamples: 9 });
+export function createSpotShadowProjection(angle, range, near = 0.1) {
+    if (!Number.isFinite(angle) || angle <= 0 || angle >= Math.PI / 2) {
+        throw new RangeError("Spot shadow angle must be within (0, PI / 2).");
+    }
+    if (!Number.isFinite(range) || range <= 0) {
+        throw new RangeError("Spot shadow range must be finite and positive.");
+    }
+    if (!Number.isFinite(near) || near <= 0 || near >= range) {
+        throw new RangeError("Spot shadow near plane must be finite, positive, and below range.");
+    }
+    const fovY = angle * 2;
+    const f = 1 / Math.tan(fovY / 2);
+    const projectionMatrix = [
+        f, 0, 0, 0,
+        0, f, 0, 0,
+        0, 0, (range + near) / (near - range), -1,
+        0, 0, (2 * range * near) / (near - range), 0,
+    ];
+    return { fovY, near, far: range, projectionMatrix };
+}
+/**
+ * Projective UV + linear depth of a world position in spot shadow space.
+ * Returns null when the position is behind the light or outside the cone.
+ */
+export function projectSpotShadowUv(worldPosition, lightPosition, lightDirection, angle, shadowMatrix) {
+    if (shadowMatrix.length < 16)
+        throw new RangeError("Spot shadow matrix must hold 16 numbers.");
+    const dirLength = Math.hypot(lightDirection[0], lightDirection[1], lightDirection[2]);
+    if (!Number.isFinite(dirLength) || dirLength <= 0)
+        throw new RangeError("Spot light direction must be a non-zero finite vector.");
+    const axis = [
+        lightDirection[0] / dirLength,
+        lightDirection[1] / dirLength,
+        lightDirection[2] / dirLength,
+    ];
+    const toFragment = [
+        worldPosition[0] - lightPosition[0],
+        worldPosition[1] - lightPosition[1],
+        worldPosition[2] - lightPosition[2],
+    ];
+    const alongAxis = toFragment[0] * axis[0] + toFragment[1] * axis[1] + toFragment[2] * axis[2];
+    if (!Number.isFinite(alongAxis) || alongAxis <= 0)
+        return null;
+    const cosOuter = Math.cos(angle);
+    const distance = Math.hypot(toFragment[0], toFragment[1], toFragment[2]);
+    if (alongAxis / Math.max(distance, 1e-9) < cosOuter)
+        return null;
+    const m = shadowMatrix;
+    const x = worldPosition[0];
+    const y = worldPosition[1];
+    const z = worldPosition[2];
+    const w = m[3] * x + m[7] * y + m[11] * z + m[15];
+    if (!Number.isFinite(w) || Math.abs(w) <= 1e-9)
+        return null;
+    const clipX = (m[0] * x + m[4] * y + m[8] * z + m[12]) / w;
+    const clipY = (m[1] * x + m[5] * y + m[9] * z + m[13]) / w;
+    const clipZ = (m[2] * x + m[6] * y + m[10] * z + m[14]) / w;
+    if (clipX < -1 || clipX > 1 || clipY < -1 || clipY > 1)
+        return null;
+    return { u: clipX * 0.5 + 0.5, v: clipY * 0.5 + 0.5, depth: clipZ * 0.5 + 0.5 };
+}
+/**
+ * CPU mirror of the spot PCF compare: hardens the point-cube path's shared
+ * bias tables (computeShadowDepthBias) and averages lit taps.
+ */
+export function resolveSpotShadowFactor(input) {
+    if (input.tapDepths.length === 0)
+        throw new RangeError("Spot shadow PCF requires at least one tap.");
+    const strength = input.strength ?? 1;
+    if (!Number.isFinite(strength) || strength < 0 || strength > 1) {
+        throw new RangeError("Spot shadow strength must be in [0, 1].");
+    }
+    const bias = computeShadowDepthBias({
+        baseBias: input.baseBias ?? 0.001,
+        slopeScale: input.slopeScale ?? 1,
+        normalDotLight: input.normalDotLight,
+        texelSize: input.texelSize ?? 1,
+    });
+    let lit = 0;
+    for (const tap of input.tapDepths) {
+        if (!Number.isFinite(tap))
+            throw new RangeError("Spot shadow tap depths must be finite.");
+        if (input.receiverDepth - bias <= tap)
+            lit += 1;
+    }
+    const litFraction = lit / input.tapDepths.length;
+    return Number((1 - strength * (1 - litFraction)).toFixed(6));
+}
+/** Atlas resolution tier for a spot light: wider cones cost more texels. */
+export function selectSpotShadowAtlasTier(angle) {
+    if (!Number.isFinite(angle) || angle <= 0 || angle >= Math.PI / 2) {
+        throw new RangeError("Spot shadow angle must be within (0, PI / 2).");
+    }
+    const degrees = (angle * 180) / Math.PI;
+    if (degrees <= 20)
+        return { resolution: 512, reason: "narrow cone (<=20deg half-angle) fits a 512 tile" };
+    if (degrees <= 40)
+        return { resolution: 1024, reason: "medium cone (<=40deg half-angle) needs a 1024 tile" };
+    return { resolution: 2048, reason: "wide cone (>40deg half-angle) needs a 2048 tile" };
+}
+export function defaultSpotShadowKernel() {
+    return DEFAULT_SPOT_SHADOW_KERNEL;
+}
+//# sourceMappingURL=SpotShadowMaps.js.map

package/dist/rendering/shadows/SpotShadowMaps.js.map

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

package/dist/rendering/webgpu/WebGPUPostProcess.d.ts

@@ -1,3 +1,5 @@
 export { runWebGPURenderToTextureProof } from "../WebGPURenderToTextureProof.js";
 export type { WebGPURenderToTextureProof, WebGPURenderToTextureProofOptions } from "../WebGPURenderToTextureProof.js";
+export { defaultWebGPUBloomWeights, normalizeWebGPUColorGradeOptions, normalizeWebGPUBloomOptions, normalizeWebGPUBloomQuality, webgpuBloomCompositeFragment, webgpuBlurFragment, webgpuBrightExtractFragment, webgpuColorGradeFragment, webgpuFxaaFragment, webgpuSoftKneeWeight, WEBGPU_BLOOM_MAX_MIPS, WEBGPU_BLOOM_QUALITY_TABLE, WEBGPU_POST_VERTEX_WGSL } from "./WebGPUPostShaders.js";
+export type { NormalizedWebGPUColorGrade, NormalizedWebGPUBloom, WebGPUBloomDiagnostics, WebGPUBloomOptions, WebGPUBloomQuality, WebGPUColorGradeOptions, WebGPUCompositeParams, WebGPUFxaaOptions } from "./WebGPUPostShaders.js";
 //# sourceMappingURL=WebGPUPostProcess.d.ts.map

package/dist/rendering/webgpu/WebGPUPostProcess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGPUPostProcess.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgpu/WebGPUPostProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"WebGPUPostProcess.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgpu/WebGPUPostProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,YAAY,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC;AACnH,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC"}

package/dist/rendering/webgpu/WebGPUPostProcess.js

@@ -1,2 +1,3 @@
 export { runWebGPURenderToTextureProof } from "../WebGPURenderToTextureProof.js";
+export { defaultWebGPUBloomWeights, normalizeWebGPUColorGradeOptions, normalizeWebGPUBloomOptions, normalizeWebGPUBloomQuality, webgpuBloomCompositeFragment, webgpuBlurFragment, webgpuBrightExtractFragment, webgpuColorGradeFragment, webgpuFxaaFragment, webgpuSoftKneeWeight, WEBGPU_BLOOM_MAX_MIPS, WEBGPU_BLOOM_QUALITY_TABLE, WEBGPU_POST_VERTEX_WGSL } from "./WebGPUPostShaders.js";
 //# sourceMappingURL=WebGPUPostProcess.js.map