@aura3d/engine 2.0.4 → 3.0.0

package/dist/react/index.js

@@ -1,22 +1,130 @@
-import { Children, createElement, isValidElement, useEffect, useMemo, useRef } from "react";
-import { camera, createAuraApp, effects, lights, model, scene } from "../engine/index.js";
+import { Children, Suspense, createContext, createElement, isValidElement, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { camera, createAuraApp, effects, environments, interactions, lights, model, scene } from "../engine/index.js";
+/**
+ * The mounted app, for `useAuraFrame` / `useAuraEvents`. Undefined until
+ * `AuraCanvas` mounts (and again after unmount). Components outside an
+ * `AuraCanvas` see undefined — they must handle that rather than assume an app.
+ */
+export const AuraAppContext = createContext(undefined);
+export function useAuraApp() {
+    return useContext(AuraAppContext);
+}
+let frameSubscriptionOrder = 0;
+/**
+ * Priority-ordered fan-out over one host `onFrame` subscription (V1).
+ *
+ * Lower `priority` runs first; ties keep subscription order. One host
+ * subscription is shared no matter how many components subscribe, and it is
+ * released when the last subscriber leaves — that release is the tested
+ * unmount-cleanup half of the U1 mount/unmount/listener-clean policy.
+ * Pure except for the host calls, so it is unit-testable with a fake host.
+ */
+export function createFrameScheduler(host) {
+    const entries = [];
+    let unsubscribe;
+    const dispatch = (frame) => {
+        const ordered = [...entries].sort((a, b) => a.priority - b.priority || a.order - b.order);
+        for (const entry of ordered)
+            entry.callback(frame);
+    };
+    return {
+        subscribe(callback, priority = 0) {
+            if (!Number.isFinite(priority))
+                throw new Error("Aura3D frame priority must be finite.");
+            const entry = { callback, priority, order: frameSubscriptionOrder++ };
+            entries.push(entry);
+            if (!unsubscribe)
+                unsubscribe = host.onFrame(dispatch);
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                const index = entries.indexOf(entry);
+                if (index !== -1)
+                    entries.splice(index, 1);
+                if (entries.length === 0 && unsubscribe) {
+                    unsubscribe();
+                    unsubscribe = undefined;
+                }
+            };
+        },
+        subscriberCount() {
+            return entries.length;
+        }
+    };
+}
+const schedulers = new WeakMap();
+function schedulerForApp(app) {
+    let scheduler = schedulers.get(app);
+    if (!scheduler) {
+        scheduler = createFrameScheduler(app);
+        schedulers.set(app, scheduler);
+    }
+    return scheduler;
+}
+export function useAuraFrame(callback, priority = 0) {
+    const app = useAuraApp();
+    const latest = useRef(callback);
+    latest.current = callback;
+    useEffect(() => {
+        if (!app)
+            return undefined;
+        return schedulerForApp(app).subscribe((frame) => latest.current(frame), priority);
+    }, [app, priority]);
+}
+/**
+ * Interaction nodes that engage the F4 picking stack for a target node.
+ * Add these to the scene alongside `AuraCanvas` event props: the props hear
+ * canvas-level DOM events, these nodes declare what the picking stack tracks.
+ */
+export function eventInteractionNodes(target) {
+    return [
+        interactions.pointer(target ? { target } : {}),
+        interactions.hover(target ? { target } : {})
+    ];
+}
 export function AuraCanvas(props) {
     const ref = useRef(null);
+    const [app, setApp] = useState(undefined);
     const builtScene = useMemo(() => buildSceneFromChildren(props.children), [props.children]);
+    const handlers = useMemo(() => ({
+        ...(props.onPointerDown ? { onPointerDown: props.onPointerDown } : {}),
+        ...(props.onPointerMove ? { onPointerMove: props.onPointerMove } : {}),
+        ...(props.onPointerUp ? { onPointerUp: props.onPointerUp } : {}),
+        ...(props.onHover ? { onHover: props.onHover } : {})
+    }), [props.onPointerDown, props.onPointerMove, props.onPointerUp, props.onHover]);
     useEffect(() => {
         if (!ref.current)
             return undefined;
-        const app = createAuraApp(ref.current, {
+        const canvas = ref.current;
+        const created = createAuraApp(canvas, {
             scene: builtScene,
             diagnostics: props.diagnostics,
             pixelRatio: props.pixelRatio,
             autoStart: props.autoStart,
             resize: props.resize
         });
-        props.onReady?.(app);
-        return () => app.dispose();
-    }, [builtScene, props.autoStart, props.diagnostics, props.onReady, props.pixelRatio, props.resize]);
-    return createElement("canvas", {
+        setApp(created);
+        props.onReady?.(created);
+        const pointerDown = (event) => handlers.onPointerDown?.(event);
+        const pointerMove = (event) => {
+            handlers.onPointerMove?.(event);
+            handlers.onHover?.(event);
+        };
+        const pointerUp = (event) => handlers.onPointerUp?.(event);
+        canvas.addEventListener("pointerdown", pointerDown);
+        canvas.addEventListener("pointermove", pointerMove);
+        canvas.addEventListener("pointerup", pointerUp);
+        return () => {
+            canvas.removeEventListener("pointerdown", pointerDown);
+            canvas.removeEventListener("pointermove", pointerMove);
+            canvas.removeEventListener("pointerup", pointerUp);
+            created.dispose();
+            setApp(undefined);
+        };
+    }, [builtScene, props.autoStart, props.diagnostics, props.onReady, props.pixelRatio, props.resize, handlers]);
+    return createElement(AuraAppContext.Provider, { value: app }, createElement("canvas", {
         ref,
         className: props.className,
         style: {
@@ -25,13 +133,15 @@ export function AuraCanvas(props) {
             display: "block",
             ...(props.style ?? {})
         }
-    });
+    }));
 }
 export function Scene(_props) {
     return null;
 }
-export function Model(_props) {
-    return null;
+export function Model(props) {
+    if (!props.suspendOnLoad || props.suspendOnLoad.length === 0)
+        return null;
+    return createElement(Suspense, { fallback: props.fallback ?? null }, createElement(ModelPreloader, { descriptors: props.suspendOnLoad, loader: props.loader }));
 }
 export function Camera(_props) {
     return null;
@@ -42,6 +152,137 @@ export function Lights(_props) {
 export function Effect(_props) {
     return null;
 }
+async function fetchPreload(descriptors) {
+    const settled = await Promise.allSettled(descriptors.map(async (descriptor) => {
+        const response = await fetch(descriptor.url);
+        if (!response.ok)
+            throw new Error(`HTTP ${response.status} for ${descriptor.url}`);
+        await response.arrayBuffer();
+        return descriptor.id;
+    }));
+    const loaded = [];
+    const failed = [];
+    settled.forEach((result, index) => {
+        const id = descriptors[index]?.id ?? `asset-${index}`;
+        if (result.status === "fulfilled")
+            loaded.push(result.value);
+        else
+            failed.push({ id, message: result.reason instanceof Error ? result.reason.message : String(result.reason) });
+    });
+    return { ok: failed.length === 0, loaded, failed };
+}
+/**
+ * Suspense-compatible asset boundary over typed-asset preload (V1).
+ *
+ * `read()` throws the in-flight promise while pending (so `<Suspense>`
+ * shows the fallback), throws the failure once failed (so an error boundary
+ * hears it — preload failures are never silent), and returns evidence when
+ * ready. Consecutive `preload()` calls share one flight. Not a second loader:
+ * the default warms the HTTP cache the engine loader then reads, and apps
+ * that own an `AssetPreloader` pass its `preloadAll` as `loader`.
+ */
+export function createAuraAssetResource(descriptors, loader = fetchPreload) {
+    if (descriptors.length === 0)
+        throw new Error("Aura3D asset preload requires at least one descriptor.");
+    const seen = new Set();
+    for (const descriptor of descriptors) {
+        if (!descriptor.id || !descriptor.url)
+            throw new Error("Aura3D asset descriptors require an id and a url.");
+        if (seen.has(descriptor.id))
+            throw new Error(`Duplicate Aura3D asset descriptor id "${descriptor.id}".`);
+        seen.add(descriptor.id);
+    }
+    let state;
+    const preload = () => {
+        if (state?.status === "ready")
+            return Promise.resolve(state.evidence);
+        if (state?.status === "pending")
+            return state.promise;
+        if (state?.status === "error")
+            return Promise.reject(state.error);
+        const promise = loader(descriptors).then((evidence) => {
+            state = { status: "ready", evidence };
+            return evidence;
+        }, (error) => {
+            state = { status: "error", error };
+            throw error;
+        });
+        state = { status: "pending", promise };
+        return promise;
+    };
+    return {
+        descriptors,
+        preload,
+        read() {
+            if (!state)
+                throw preload();
+            if (state.status === "pending")
+                throw state.promise;
+            if (state.status === "error")
+                throw state.error;
+            return state.evidence;
+        }
+    };
+}
+const resourceCache = new Map();
+function resourceKey(descriptors) {
+    return [...descriptors].map((d) => `${d.id}@${d.url}`).sort().join("|");
+}
+/** Shared resource per descriptor set, so sibling `<Model>`s preload once. */
+export function resourceForDescriptors(descriptors, loader) {
+    const key = resourceKey(descriptors);
+    let resource = resourceCache.get(key);
+    if (!resource) {
+        resource = createAuraAssetResource(descriptors, loader);
+        resourceCache.set(key, resource);
+    }
+    return resource;
+}
+/** Read preloaded asset evidence inside a `<Suspense>` boundary. Suspends while pending. */
+export function useAuraAsset(resource) {
+    return resource.read();
+}
+function ModelPreloader(props) {
+    useAuraAsset(resourceForDescriptors(props.descriptors, props.loader));
+    return null;
+}
+/** Camera-controls binding (F1/N2): orbit camera plus an orbit interaction node. */
+export function cameraControlsRecipe(options = {}) {
+    return (builder) => builder
+        .camera(camera.orbit(options.distance !== undefined ? { distance: options.distance } : {}))
+        .add(interactions.orbit(options.target ? { target: options.target } : {}));
+}
+/** Environment preset (M3/B3): one IBL environment node from the preset catalog. */
+export function environmentPresetRecipe(preset = "studio") {
+    return (builder) => builder.add(environments[preset]());
+}
+/** Transform gizmo (F4/O3): drag-vector plus hover-select on a target node. */
+export function transformGizmoRecipe(target) {
+    if (!target)
+        throw new Error("Aura3D transform gizmo recipe requires a target node name.");
+    return (builder) => builder.add(interactions.dragVector({ target })).add(interactions.hover({ target, selected: target }));
+}
+/**
+ * R3F → AuraCanvas mapping table (V1). Documents the manual mapping for
+ * importers; "R3F parity" wording is deliberately absent — these are the
+ * covered paths, not the whole library.
+ */
+export const R3F_TO_AURA_MIGRATION_TABLE = [
+    { r3f: "<Canvas>", aura: "<AuraCanvas>", notes: "Mounts createAuraApp; diagnostics/pixelRatio/autoStart/resize map directly." },
+    { r3f: "<mesh> / <primitive>", aura: "<Model asset={...}>", notes: "Typed asset refs only (assets.*); no raw GLB URLs or guessed IDs." },
+    { r3f: "<ambientLight> / <pointLight>", aura: "<Lights>", notes: "Studio preset plus ambient/directional/point declarations." },
+    { r3f: "<PerspectiveCamera> / OrbitControls", aura: "<Camera> + cameraControlsRecipe", notes: "Orbit/dolly/follow/perspective declarations; recipe adds the orbit interaction node." },
+    { r3f: "<EffectComposer> effects", aura: "<Effect>", notes: "Fog/bloom/rain declarations; no postprocess parity beyond the covered set." },
+    { r3f: "useFrame(callback)", aura: "useAuraFrame(callback, priority?)", notes: "Priority-ordered fan-out over app.onFrame; cleanup on unmount." },
+    { r3f: "useThree((s) => s.gl)", aura: "useAuraApp()", notes: "Returns the mounted AuraApp or undefined before mount." },
+    { r3f: "useLoader + <Suspense>", aura: "<Model suspendOnLoad fallback> + useAuraAsset", notes: "preloadAll semantics with per-record ok/failed evidence; failures throw to an error boundary." },
+    { r3f: "onPointerOver / onClick on meshes", aura: "AuraCanvas event props + eventInteractionNodes", notes: "Props hear canvas-level DOM events; picking stays declarative via interaction nodes." },
+    { r3f: "drei <OrbitControls>", aura: "cameraControlsRecipe", notes: "Tested recipe, not a drei port." },
+    { r3f: "drei <Environment>", aura: "environmentPresetRecipe", notes: "IBL preset catalog node; HDRI probe stays on environments.hdri." },
+    { r3f: "drei <TransformControls>", aura: "transformGizmoRecipe", notes: "Drag-vector plus hover-select recipe; editor gizmos stay in editor-runtime." }
+];
+/** Migration-table scope guard: the table maps covered paths, never claims R3F parity. */
+export const R3F_MIGRATION_NOT_PARITY = "This table maps idiomatic R3F to the covered AuraCanvas surface. It is not an R3F-parity claim.";
 export function buildSceneFromChildren(children) {
     let builder = scene();
     const sceneElement = findFirstElementOfType(children, Scene);

package/dist/react/index.js.map

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

package/dist/rendering/AtmosphereWetness.d.ts

@@ -0,0 +1,61 @@
+/**
+ * D3 wetness + lightning descriptors (PRD D3 box 2).
+ *
+ * Pure deterministic helpers driven by `createWeatherState`:
+ * - albedo darkening + roughness response for a wetness uniform in [0, 1],
+ * - puddle-mask sampling over `WeatherPuddlePatch` discs,
+ * - lightning-flash envelope for the thunderstorm light hook.
+ *
+ * The rendered wetness path applies these values to ordinary PBR material
+ * inputs (base color multiplied down, roughness scaled down); no new shader
+ * claim is made here.
+ */
+import { type WeatherPuddlePatch, type WeatherState, type WeatherType } from "./Weather.js";
+export interface WetnessMaterialResponse {
+    /** Wetness in [0, 1] taken from the weather state. */
+    readonly wetness: number;
+    /** Darkened base color hex. */
+    readonly albedoColor: string;
+    /** Roughness after the wet response (never above the dry input). */
+    readonly roughness: number;
+    /** Mean puddle-mask value over the sampled patches in [0, 1]. */
+    readonly puddleMask: number;
+}
+export interface LightningFlashSample {
+    readonly elapsedSeconds: number;
+    /** Flash intensity in [0, 1]; 0 unless the weather type is thunderstorm. */
+    readonly intensity: number;
+}
+export interface WetnessProbe {
+    readonly weather: WeatherState;
+    readonly response: WetnessMaterialResponse;
+    readonly flash: LightningFlashSample;
+}
+/**
+ * Describe the wet look for one ground material under a weather type.
+ * `dryColor` is a `#rrggbb` hex string; `dryRoughness` is in [0, 1].
+ */
+export declare function describeWetMaterial(options: {
+    readonly type?: WeatherType;
+    readonly dryColor?: string;
+    readonly dryRoughness?: number;
+    readonly elapsedSeconds?: number;
+    readonly seed?: number;
+}): WetnessProbe;
+/** Multiply a hex albedo toward dark by up to 45% at full wetness. */
+export declare function applyWetnessToColor(hex: string, wetness: number): string;
+/** Scale roughness down by up to 55% at full wetness (never increases). */
+export declare function applyWetnessToRoughness(dryRoughness: number, wetness: number): number;
+/** Smooth puddle-mask falloff over patch discs at a ground sample point. */
+export declare function samplePuddleMask(patches: readonly WeatherPuddlePatch[], x: number, z: number): number;
+/**
+ * Deterministic lightning-flash envelope. Non-thunderstorm types always
+ * return 0; thunderstorms return sparse sub-second spikes usable as a light
+ * intensity hook.
+ */
+export declare function sampleLightningFlash(options: {
+    readonly type: WeatherType;
+    readonly elapsedSeconds: number;
+    readonly seed?: number;
+}): LightningFlashSample;
+//# sourceMappingURL=AtmosphereWetness.d.ts.map

package/dist/rendering/AtmosphereWetness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AtmosphereWetness.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/AtmosphereWetness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAsB,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7G,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,YAAY,CAkBf;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrF;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQrG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,oBAAoB,CAUvB"}

package/dist/rendering/AtmosphereWetness.js

@@ -0,0 +1,99 @@
+/**
+ * D3 wetness + lightning descriptors (PRD D3 box 2).
+ *
+ * Pure deterministic helpers driven by `createWeatherState`:
+ * - albedo darkening + roughness response for a wetness uniform in [0, 1],
+ * - puddle-mask sampling over `WeatherPuddlePatch` discs,
+ * - lightning-flash envelope for the thunderstorm light hook.
+ *
+ * The rendered wetness path applies these values to ordinary PBR material
+ * inputs (base color multiplied down, roughness scaled down); no new shader
+ * claim is made here.
+ */
+import { createWeatherState } from "./Weather.js";
+/**
+ * Describe the wet look for one ground material under a weather type.
+ * `dryColor` is a `#rrggbb` hex string; `dryRoughness` is in [0, 1].
+ */
+export function describeWetMaterial(options) {
+    const type = options.type ?? "rain";
+    const dryColor = options.dryColor ?? "#5b6b4f";
+    const dryRoughness = clamp(options.dryRoughness ?? 0.9, 0, 1);
+    const elapsedSeconds = Math.max(0, options.elapsedSeconds ?? 1);
+    const seed = Math.floor(options.seed ?? 0xd3e7);
+    const weather = createWeatherState({ type, elapsedSeconds, seed });
+    const albedoColor = applyWetnessToColor(dryColor, weather.wetness);
+    const roughness = applyWetnessToRoughness(dryRoughness, weather.wetness);
+    const puddleMask = weather.puddlePatches.length === 0
+        ? 0
+        : Number((weather.puddlePatches.reduce((sum, patch) => sum + Math.min(1, patch.depth * 2), 0) /
+            weather.puddlePatches.length).toFixed(4));
+    return {
+        weather,
+        response: { wetness: weather.wetness, albedoColor, roughness, puddleMask },
+        flash: sampleLightningFlash({ type, elapsedSeconds, seed })
+    };
+}
+/** Multiply a hex albedo toward dark by up to 45% at full wetness. */
+export function applyWetnessToColor(hex, wetness) {
+    const wet = clamp(wetness, 0, 1);
+    const rgb = parseHex(hex);
+    const factor = 1 - 0.45 * wet;
+    return rgbToHex([rgb[0] * factor, rgb[1] * factor, rgb[2] * factor]);
+}
+/** Scale roughness down by up to 55% at full wetness (never increases). */
+export function applyWetnessToRoughness(dryRoughness, wetness) {
+    const wet = clamp(wetness, 0, 1);
+    return Number((clamp(dryRoughness, 0, 1) * (1 - 0.55 * wet)).toFixed(4));
+}
+/** Smooth puddle-mask falloff over patch discs at a ground sample point. */
+export function samplePuddleMask(patches, x, z) {
+    let mask = 0;
+    for (const patch of patches) {
+        const distance = Math.hypot(x - patch.x, z - patch.z);
+        const t = 1 - distance / Math.max(1e-6, patch.radius * 1.6);
+        if (t > 0)
+            mask = Math.max(mask, t * t * (3 - 2 * t));
+    }
+    return Number(clamp(mask, 0, 1).toFixed(4));
+}
+/**
+ * Deterministic lightning-flash envelope. Non-thunderstorm types always
+ * return 0; thunderstorms return sparse sub-second spikes usable as a light
+ * intensity hook.
+ */
+export function sampleLightningFlash(options) {
+    const elapsedSeconds = Math.max(0, options.elapsedSeconds);
+    if (options.type !== "thunderstorm")
+        return { elapsedSeconds, intensity: 0 };
+    const seed = Math.floor(options.seed ?? 0xd3e7);
+    const windowIndex = Math.floor(elapsedSeconds * 2);
+    const strike = seeded01(seed ^ (windowIndex * 0x9e3779b9)) > 0.62;
+    if (!strike)
+        return { elapsedSeconds, intensity: 0 };
+    const phase = elapsedSeconds * 2 - windowIndex;
+    const envelope = Math.exp(-phase * 9) * (0.55 + 0.45 * Math.sin(phase * 40));
+    return { elapsedSeconds, intensity: Number(clamp(envelope, 0, 1).toFixed(4)) };
+}
+function parseHex(hex) {
+    const match = /^#([0-9a-fA-F]{6})$/.exec(hex.trim());
+    if (!match?.[1])
+        throw new RangeError(`Wetness albedo must be a #rrggbb hex string, got "${hex}".`);
+    const value = match[1];
+    return [parseInt(value.slice(0, 2), 16), parseInt(value.slice(2, 4), 16), parseInt(value.slice(4, 6), 16)];
+}
+function rgbToHex(rgb) {
+    const toHex = (v) => Math.max(0, Math.min(255, Math.round(v))).toString(16).padStart(2, "0");
+    return `#${toHex(rgb[0])}${toHex(rgb[1])}${toHex(rgb[2])}`;
+}
+function seeded01(seed) {
+    let value = seed >>> 0;
+    value ^= value << 13;
+    value ^= value >>> 17;
+    value ^= value << 5;
+    return ((value >>> 0) % 10_000) / 10_000;
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=AtmosphereWetness.js.map

package/dist/rendering/AtmosphereWetness.js.map

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

package/dist/rendering/ClusteredForwardLighting.d.ts

@@ -2,6 +2,22 @@ import { type CollectedLight } from "./LightCollector.js";
 import { TextureBinding } from "./TextureBinding.js";
 export declare const CLUSTER_TILE_SIZE = 64;
 export declare const MAX_LIGHTS_PER_CLUSTER = 64;
+export type ClusteredForwardFallbackPolicy = "none" | "nearest-observer" | "input-order-no-observer";
+export interface ClusteredForwardLightingOptions {
+    /**
+     * World-space reference point for the nearest-N over-budget policy (normally
+     * the camera position). When omitted, over-budget clusters keep input order
+     * and the diagnostics record `input-order-no-observer` so the weaker policy
+     * is visible instead of silent.
+     */
+    readonly observerPosition?: readonly [number, number, number];
+    /**
+     * Warning sink for the over-budget fallback. A custom sink is always called
+     * when the fallback applies; the default `console.warn` is deduplicated per
+     * grid configuration so per-frame clustered builds do not spam the console.
+     */
+    readonly onWarning?: (message: string) => void;
+}
 export interface ClusteredForwardLightingDiagnostics {
     readonly source: "createClusteredForwardLighting";
     readonly mode: "screen-tile-texture-grid";
@@ -17,6 +33,12 @@ export interface ClusteredForwardLightingDiagnostics {
     readonly totalLightReferences: number;
     readonly culledLightCount: number;
     readonly droppedLightCount: number;
+    readonly overBudgetClusterCount: number;
+    readonly maxRequestedLightsInCluster: number;
+    readonly requestedPerCluster: readonly number[];
+    readonly indexedPerCluster: readonly number[];
+    readonly fallbackPolicy: ClusteredForwardFallbackPolicy;
+    readonly warnings: readonly string[];
 }
 export interface ClusteredForwardLightingResources {
     readonly lightData: TextureBinding;
@@ -24,5 +46,7 @@ export interface ClusteredForwardLightingResources {
     readonly diagnostics: ClusteredForwardLightingDiagnostics;
     dispose(): void;
 }
-export declare function createClusteredForwardLighting(lights: readonly CollectedLight[], viewportWidth: number, viewportHeight: number, viewProjectionMatrix?: Float32Array | readonly number[]): ClusteredForwardLightingResources;
+export declare function createClusteredForwardLighting(lights: readonly CollectedLight[], viewportWidth: number, viewportHeight: number, viewProjectionMatrix?: Float32Array | readonly number[], options?: ClusteredForwardLightingOptions): ClusteredForwardLightingResources;
+/** Clears the once-per-configuration warning memory (tests + device reset). */
+export declare function resetClusteredForwardLightingWarnings(): void;
 //# sourceMappingURL=ClusteredForwardLighting.d.ts.map

package/dist/rendering/ClusteredForwardLighting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClusteredForwardLighting.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ClusteredForwardLighting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,mCAAmC,CAAC;IAC1D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,oBAAoB,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,GACtD,iCAAiC,CAsGnC"}
+{"version":3,"file":"ClusteredForwardLighting.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ClusteredForwardLighting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,MAAM,8BAA8B,GAAG,MAAM,GAAG,kBAAkB,GAAG,yBAAyB,CAAC;AAErG,MAAM,WAAW,+BAA+B;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,mCAAmC,CAAC;IAC1D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,oBAAoB,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,EACvD,OAAO,GAAE,+BAAoC,GAC5C,iCAAiC,CAmJnC;AA2FD,+EAA+E;AAC/E,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D"}