@flighthq/lighting 0.2.1-next.585.c7219b8 → 0.2.1-next.640.ec2ea9a

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './hemisphereLight';
 export * from './lightAnalysis';
 export * from './lightIntensity';
 export * from './pointLight';
+export * from './sceneForwardLights';
 export * from './sceneLights';
 export * from './spotLight';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export * from './hemisphereLight';
 export * from './lightAnalysis';
 export * from './lightIntensity';
 export * from './pointLight';
+export * from './sceneForwardLights';
 export * from './sceneLights';
 export * from './spotLight';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/lightAnalysis.d.ts

@@ -1,6 +1,7 @@
-import type { BoundingSphereLike, Light } from '@flighthq/types';
+import type { BoundingSphereLike, Light, PointLight, SpotLight } from '@flighthq/types';
+export declare function getLightContributionAtBoundingSphere(light: Readonly<PointLight | SpotLight>, bounds: Readonly<BoundingSphereLike>): number;
 export declare function getLightInfluenceBounds(out: BoundingSphereLike, light: Readonly<Light>): void;
 export declare function getLightLuminance(light: Readonly<Light>): number;
 export declare function hasLightInfluenceOnBounds(light: Readonly<Light>, bounds: Readonly<BoundingSphereLike>): boolean;
-export declare function isLightShadowCasting(light: Readonly<Light>): boolean;
+export declare function isLightCastingShadow(light: Readonly<Light>): boolean;
 //# sourceMappingURL=lightAnalysis.d.ts.map

package/dist/lightAnalysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lightAnalysis.d.ts","sourceRoot":"","sources":["../src/lightAnalysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAc,MAAM,iBAAiB,CAAC;AAe7E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAqC7F;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,MAAM,CAUhE;AAMD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,OAAO,CA0B/G;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAMpE"}
+{"version":3,"file":"lightAnalysis.d.ts","sourceRoot":"","sources":["../src/lightAnalysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAiBxF,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC,EACvC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACnC,MAAM,CA+BR;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAqC7F;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,MAAM,CAMhE;AAMD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,OAAO,CA0B/G;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAMpE"}

package/dist/lightAnalysis.js

@@ -1,4 +1,39 @@
+import { getColorLuminance } from '@flighthq/color';
 import { AmbientLightKind, AreaLightKind, DirectionalLightKind, EnvironmentKind, HemisphereLightKind, PointLightKind, SpotLightKind, } from '@flighthq/types';
+// Estimates the radiance contribution of one punctual light at a world-space bounding sphere.
+// Distance uses the nearest sphere surface (`centerDistance - radius`) so large objects receive
+// radius slack instead of being ranked only at their centre. The attenuation matches the forward
+// shaders: inverse-square falloff multiplied by the squared glTF/UE4 range window; spot lights also
+// apply the same smoothstep cone at the sphere centre. Multiplying by getLightLuminance makes the
+// result suitable for deterministic forward-budget ranking rather than material-specific shading.
+export function getLightContributionAtBoundingSphere(light, bounds) {
+    if (bounds.radius < 0)
+        return 0;
+    const centerDx = bounds.center.x - light.position.x;
+    const centerDy = bounds.center.y - light.position.y;
+    const centerDz = bounds.center.z - light.position.z;
+    const centerDistance = Math.hypot(centerDx, centerDy, centerDz);
+    const distance = Math.max(centerDistance - bounds.radius, 0);
+    const distanceSquared = distance * distance;
+    let window = 1;
+    if (light.range > 0) {
+        const factor = distanceSquared / (light.range * light.range);
+        const windowed = Math.max(0, Math.min(1, 1 - factor * factor));
+        window = windowed * windowed;
+    }
+    let contribution = (getLightLuminance(light) * window) / Math.max(distanceSquared, 1e-4);
+    if (light.kind === SpotLightKind) {
+        const spot = light;
+        const directionLength = Math.hypot(spot.direction.x, spot.direction.y, spot.direction.z);
+        const inverseRayLength = centerDistance > 0 ? 1 / centerDistance : 0;
+        const inverseDirectionLength = directionLength > 0 ? 1 / directionLength : 0;
+        const cosine = (spot.direction.x * centerDx + spot.direction.y * centerDy + spot.direction.z * centerDz) *
+            inverseRayLength *
+            inverseDirectionLength;
+        contribution *= smoothstep(spot.outerConeCos, spot.innerConeCos, centerDistance > 0 ? cosine : 1);
+    }
+    return contribution;
+}
 // Writes the world-space influence bounding sphere of a light into `out`. The sphere bounds the
 // region the light can illuminate. Lights with a finite `range` produce a sphere centered at
 // `position` with `radius = range`. Non-spatial lights (ambient, hemisphere, environment) and
@@ -39,21 +74,17 @@ export function getLightInfluenceBounds(out, light) {
     out.center.z = 0;
     out.radius = -1;
 }
-// Returns the perceptual luminance of a light's color × intensity. The luminance is computed
-// from the packed sRgb-albedo RGBA color using the standard ITU-R BT.709 coefficients, then
-// scaled by `intensity`. Useful for ranking lights by visual importance when prioritizing a
-// forward-light budget.
+// Returns the linear-light luminance of a light's color × intensity. Packed sRGB channels are
+// gamma-decoded through the shared color primitive before applying the Rec. 709 weights, matching
+// the radiance that packSceneLightBlock sends to the shader. Useful for ranking lights by their
+// rendered contribution when prioritizing a forward-light budget.
 export function getLightLuminance(light) {
     const colored = light;
     const color = colored.color;
     if (color === undefined)
         return 0;
-    const r = ((color >>> 24) & 0xff) / 255;
-    const g = ((color >>> 16) & 0xff) / 255;
-    const b = ((color >>> 8) & 0xff) / 255;
-    const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
     const intensity = colored.intensity ?? 1;
-    return luma * intensity;
+    return getColorLuminance(color) * intensity;
 }
 // Returns true when `light` could influence a point within `bounds`. Non-spatial lights (ambient,
 // hemisphere, directional, environment) and infinite-range lights always return true. For spatial
@@ -87,11 +118,17 @@ export function hasLightInfluenceOnBounds(light, bounds) {
 }
 // Returns true when the light is configured to cast shadows. Non-shadow-capable light types
 // (AmbientLight, HemisphereLight, Environment) always return false.
-export function isLightShadowCasting(light) {
+export function isLightCastingShadow(light) {
     const kind = light.kind;
     if (kind === AmbientLightKind || kind === HemisphereLightKind || kind === EnvironmentKind) {
         return false;
     }
     return light.castsShadow;
 }
+function smoothstep(edge0, edge1, value) {
+    if (edge0 === edge1)
+        return value < edge0 ? 0 : 1;
+    const t = Math.max(0, Math.min(1, (value - edge0) / (edge1 - edge0)));
+    return t * t * (3 - 2 * t);
+}
 //# sourceMappingURL=lightAnalysis.js.map

package/dist/lightAnalysis.js.map

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

package/dist/sceneForwardLights.d.ts

@@ -0,0 +1,3 @@
+import type { BoundingSphereLike, SceneForwardLightSelection, SceneLightsLike } from '@flighthq/types';
+export declare function selectSceneForwardLights(out: SceneForwardLightSelection, lights: Readonly<SceneLightsLike>, bounds: Readonly<BoundingSphereLike>): void;
+//# sourceMappingURL=sceneForwardLights.d.ts.map

package/dist/sceneForwardLights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneForwardLights.d.ts","sourceRoot":"","sources":["../src/sceneForwardLights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,0BAA0B,EAC1B,eAAe,EAEhB,MAAM,iBAAiB,CAAC;AAazB,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,0BAA0B,EAC/B,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EACjC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GACnC,IAAI,CAkCN"}

package/dist/sceneForwardLights.js

@@ -0,0 +1,72 @@
+import { MAX_FORWARD_LIGHTS } from '@flighthq/types';
+import { getLightContributionAtBoundingSphere } from './lightAnalysis';
+// Selects the strongest point and spot contributors for one object's forward-light budget. Each
+// family has its own MAX_FORWARD_LIGHTS budget, matching the shader's separate fixed arrays and
+// counts. Ranking uses descriptor-side shader-equivalent attenuation at `bounds`; equal scores
+// retain their family input order, making captures reproducible. Zero-contribution lights are
+// omitted.
+//
+// `out.point` and `out.spot` are reused mutable arrays. All inputs are read into fixed-size scratch
+// before either output array is changed, so `out` may alias `lights`.
+export function selectSceneForwardLights(out, lights, bounds) {
+    const points = lights.point;
+    const spots = lights.spot;
+    const pointCount = selectStrongestLights(points, bounds, scratchSelectedPointLights, scratchSelectedPointIndices, scratchSelectedPointScores);
+    const spotCount = selectStrongestLights(spots, bounds, scratchSelectedSpotLights, scratchSelectedSpotIndices, scratchSelectedSpotScores);
+    const outPoints = out.point;
+    const outSpots = out.spot;
+    const outIndices = out.indices;
+    outIndices.length = 0;
+    outPoints.length = 0;
+    outSpots.length = 0;
+    for (let i = 0; i < pointCount; i++) {
+        outIndices.push(scratchSelectedPointIndices[i]);
+        outPoints.push(scratchSelectedPointLights[i]);
+    }
+    for (let i = 0; i < spotCount; i++) {
+        // Bitwise complement makes every spot key negative and every point key non-negative, so two
+        // selections with the same family-local index cannot collide during block deduplication.
+        outIndices.push(~scratchSelectedSpotIndices[i]);
+        outSpots.push(scratchSelectedSpotLights[i]);
+    }
+}
+function selectStrongestLights(lights, bounds, selectedLights, selectedIndices, selectedScores) {
+    let selectedCount = 0;
+    if (lights === undefined)
+        return selectedCount;
+    for (let inputIndex = 0; inputIndex < lights.length; inputIndex++) {
+        const light = lights[inputIndex];
+        const score = getLightContributionAtBoundingSphere(light, bounds);
+        if (!(score > 0))
+            continue;
+        let insertAt = selectedCount;
+        while (insertAt > 0) {
+            const previous = insertAt - 1;
+            if (score < selectedScores[previous])
+                break;
+            if (score === selectedScores[previous] && inputIndex > selectedIndices[previous])
+                break;
+            insertAt--;
+        }
+        if (insertAt >= MAX_FORWARD_LIGHTS)
+            continue;
+        const nextCount = Math.min(selectedCount + 1, MAX_FORWARD_LIGHTS);
+        for (let i = nextCount - 1; i > insertAt; i--) {
+            selectedLights[i] = selectedLights[i - 1];
+            selectedIndices[i] = selectedIndices[i - 1];
+            selectedScores[i] = selectedScores[i - 1];
+        }
+        selectedLights[insertAt] = light;
+        selectedIndices[insertAt] = inputIndex;
+        selectedScores[insertAt] = score;
+        selectedCount = nextCount;
+    }
+    return selectedCount;
+}
+const scratchSelectedPointIndices = new Int32Array(MAX_FORWARD_LIGHTS);
+const scratchSelectedPointLights = new Array(MAX_FORWARD_LIGHTS);
+const scratchSelectedPointScores = new Float64Array(MAX_FORWARD_LIGHTS);
+const scratchSelectedSpotIndices = new Int32Array(MAX_FORWARD_LIGHTS);
+const scratchSelectedSpotLights = new Array(MAX_FORWARD_LIGHTS);
+const scratchSelectedSpotScores = new Float64Array(MAX_FORWARD_LIGHTS);
+//# sourceMappingURL=sceneForwardLights.js.map

package/dist/sceneForwardLights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneForwardLights.js","sourceRoot":"","sources":["../src/sceneForwardLights.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,oCAAoC,EAAE,MAAM,iBAAiB,CAAC;AAEvE,gGAAgG;AAChG,gGAAgG;AAChG,+FAA+F;AAC/F,8FAA8F;AAC9F,WAAW;AACX,EAAE;AACF,oGAAoG;AACpG,sEAAsE;AACtE,MAAM,UAAU,wBAAwB,CACtC,GAA+B,EAC/B,MAAiC,EACjC,MAAoC;IAEpC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,MAAM,UAAU,GAAG,qBAAqB,CACtC,MAAM,EACN,MAAM,EACN,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,CAC3B,CAAC;IACF,MAAM,SAAS,GAAG,qBAAqB,CACrC,KAAK,EACL,MAAM,EACN,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,CAC1B,CAAC;IAEF,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;IAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;IAC1B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/B,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IACrB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,UAAU,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,SAAS,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAyB,CAAC,CAAC;IACxE,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,4FAA4F;QAC5F,yFAAyF;QACzF,UAAU,CAAC,IAAI,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAwB,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA+D,EAC/D,MAAoC,EACpC,cAAkD,EAClD,eAA2B,EAC3B,cAA4B;IAE5B,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAE/C,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,oCAAoC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;YAAE,SAAS;QAE3B,IAAI,QAAQ,GAAG,aAAa,CAAC;QAC7B,OAAO,QAAQ,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC;gBAAE,MAAM;YAC5C,IAAI,KAAK,KAAK,cAAc,CAAC,QAAQ,CAAC,IAAI,UAAU,GAAG,eAAe,CAAC,QAAQ,CAAC;gBAAE,MAAM;YACxF,QAAQ,EAAE,CAAC;QACb,CAAC;QACD,IAAI,QAAQ,IAAI,kBAAkB;YAAE,SAAS;QAE7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAClE,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5C,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QACjC,eAAe,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;QACvC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QACjC,aAAa,GAAG,SAAS,CAAC;IAC5B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,2BAA2B,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACvE,MAAM,0BAA0B,GAAuC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;AACrG,MAAM,0BAA0B,GAAG,IAAI,YAAY,CAAC,kBAAkB,CAAC,CAAC;AACxE,MAAM,0BAA0B,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACtE,MAAM,yBAAyB,GAAuC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;AACpG,MAAM,yBAAyB,GAAG,IAAI,YAAY,CAAC,kBAAkB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/lighting",
-  "version": "0.2.1-next.585.c7219b8",
+  "version": "0.2.1-next.640.ec2ea9a",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -32,9 +32,10 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.2.1-next.585.c7219b8",
-    "@flighthq/geometry": "0.2.1-next.585.c7219b8",
-    "@flighthq/types": "0.2.1-next.585.c7219b8"
+    "@flighthq/color": "0.2.1-next.640.ec2ea9a",
+    "@flighthq/entity": "0.2.1-next.640.ec2ea9a",
+    "@flighthq/geometry": "0.2.1-next.640.ec2ea9a",
+    "@flighthq/types": "0.2.1-next.640.ec2ea9a"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/lightAnalysis.test.ts

@@ -6,14 +6,57 @@ import { createDirectionalLight } from './directionalLight';
 import { createEnvironment } from './environment';
 import { createHemisphereLight } from './hemisphereLight';
 import {
+  getLightContributionAtBoundingSphere,
   getLightInfluenceBounds,
   getLightLuminance,
   hasLightInfluenceOnBounds,
-  isLightShadowCasting,
+  isLightCastingShadow,
 } from './lightAnalysis';
 import { createPointLight } from './pointLight';
 import { createSpotLight } from './spotLight';
 
+describe('getLightContributionAtBoundingSphere', () => {
+  it('matches inverse-square attenuation for an infinite-range point light', () => {
+    const light = createPointLight({ intensity: 1, position: { x: 0, y: 0, z: 0 }, range: -1 });
+    const near = getLightContributionAtBoundingSphere(light, createBoundingSphere(2, 0, 0, 0));
+    const far = getLightContributionAtBoundingSphere(light, createBoundingSphere(4, 0, 0, 0));
+    expect(near / far).toBeCloseTo(4);
+  });
+
+  it('applies radius slack at the nearest sphere surface', () => {
+    const light = createPointLight({ position: { x: 0, y: 0, z: 0 }, range: -1 });
+    const point = getLightContributionAtBoundingSphere(light, createBoundingSphere(4, 0, 0, 0));
+    const sphere = getLightContributionAtBoundingSphere(light, createBoundingSphere(4, 0, 0, 2));
+    expect(sphere / point).toBeCloseTo(4);
+  });
+
+  it('applies the squared smooth range window and reaches zero at the range', () => {
+    const light = createPointLight({ position: { x: 0, y: 0, z: 0 }, range: 4 });
+    const inside = getLightContributionAtBoundingSphere(light, createBoundingSphere(2, 0, 0, 0));
+    const edge = getLightContributionAtBoundingSphere(light, createBoundingSphere(4, 0, 0, 0));
+    expect(inside).toBeGreaterThan(0);
+    expect(edge).toBe(0);
+  });
+
+  it('applies spot smoothstep cone attenuation', () => {
+    const light = createSpotLight({
+      direction: { x: 1, y: 0, z: 0 },
+      innerConeDegrees: 10,
+      outerConeDegrees: 30,
+      position: { x: 0, y: 0, z: 0 },
+      range: -1,
+    });
+    const inside = getLightContributionAtBoundingSphere(light, createBoundingSphere(4, 0, 0, 0));
+    const outside = getLightContributionAtBoundingSphere(light, createBoundingSphere(0, 4, 0, 0));
+    expect(inside).toBeGreaterThan(0);
+    expect(outside).toBe(0);
+  });
+
+  it('returns zero for empty bounds', () => {
+    expect(getLightContributionAtBoundingSphere(createPointLight(), createBoundingSphere(0, 0, 0, -1))).toBe(0);
+  });
+});
+
 describe('getLightInfluenceBounds', () => {
   it('returns sentinel radius (-1) for ambient lights', () => {
     const light = createAmbientLight();
@@ -95,6 +138,11 @@ describe('getLightLuminance', () => {
     expect(getLightLuminance(light)).toBeCloseTo(1, 4);
   });
 
+  it('gamma-decodes packed sRGB before computing luminance', () => {
+    const light = createAmbientLight({ color: 0x808080ff, intensity: 1 });
+    expect(getLightLuminance(light)).toBeCloseTo(0.21586, 5);
+  });
+
   it('scales luminance by intensity', () => {
     const a = createAmbientLight({ color: 0xffffffff, intensity: 2 });
     const b = createAmbientLight({ color: 0xffffffff, intensity: 4 });
@@ -148,41 +196,41 @@ describe('hasLightInfluenceOnBounds', () => {
   });
 });
 
-describe('isLightShadowCasting', () => {
+describe('isLightCastingShadow', () => {
   it('returns false for ambient lights', () => {
-    expect(isLightShadowCasting(createAmbientLight())).toBe(false);
+    expect(isLightCastingShadow(createAmbientLight())).toBe(false);
   });
 
   it('returns false for hemisphere lights', () => {
-    expect(isLightShadowCasting(createHemisphereLight())).toBe(false);
+    expect(isLightCastingShadow(createHemisphereLight())).toBe(false);
   });
 
   it('returns false for environment lights', () => {
-    expect(isLightShadowCasting(createEnvironment())).toBe(false);
+    expect(isLightCastingShadow(createEnvironment())).toBe(false);
   });
 
   it('returns false for directional lights with castsShadow: false', () => {
     const light = createDirectionalLight({ castsShadow: false });
-    expect(isLightShadowCasting(light)).toBe(false);
+    expect(isLightCastingShadow(light)).toBe(false);
   });
 
   it('returns true for directional lights with castsShadow: true', () => {
     const light = createDirectionalLight({ castsShadow: true });
-    expect(isLightShadowCasting(light)).toBe(true);
+    expect(isLightCastingShadow(light)).toBe(true);
   });
 
   it('returns true for point lights with castsShadow: true', () => {
     const light = createPointLight({ castsShadow: true });
-    expect(isLightShadowCasting(light)).toBe(true);
+    expect(isLightCastingShadow(light)).toBe(true);
   });
 
   it('returns true for spot lights with castsShadow: true', () => {
     const light = createSpotLight({ castsShadow: true });
-    expect(isLightShadowCasting(light)).toBe(true);
+    expect(isLightCastingShadow(light)).toBe(true);
   });
 
   it('returns true for area lights with castsShadow: true', () => {
     const light = createAreaLight({ castsShadow: true });
-    expect(isLightShadowCasting(light)).toBe(true);
+    expect(isLightCastingShadow(light)).toBe(true);
   });
 });

package/src/sceneForwardLights.test.ts

@@ -0,0 +1,120 @@
+import { createBoundingSphere } from '@flighthq/geometry';
+import type { SceneForwardLightSelection, SceneLightsLike } from '@flighthq/types';
+
+import { createPointLight } from './pointLight';
+import { selectSceneForwardLights } from './sceneForwardLights';
+import { createSpotLight } from './spotLight';
+
+function selection(): SceneForwardLightSelection {
+  return { indices: [], point: [], spot: [] };
+}
+
+function spotLights(xs: readonly number[]) {
+  return xs.map((x) =>
+    createSpotLight({
+      direction: { x: -1, y: 0, z: 0 },
+      innerConeDegrees: 45,
+      outerConeDegrees: 60,
+      position: { x, y: 0, z: 0 },
+      range: -1,
+    }),
+  );
+}
+
+describe('selectSceneForwardLights', () => {
+  it('keeps all three points and three spots when both families are within budget', () => {
+    const points = [8, 7, 6].map((x) => createPointLight({ position: { x, y: 0, z: 0 }, range: -1 }));
+    const spots = spotLights([5, 4, 3]);
+    const out = selection();
+    selectSceneForwardLights(
+      out,
+      { ambient: null, directional: null, point: points, spot: spots },
+      createBoundingSphere(0, 0, 0, 0),
+    );
+    expect(out.point).toHaveLength(3);
+    expect(out.spot).toHaveLength(3);
+    expect(new Set(out.point)).toEqual(new Set(points));
+    expect(new Set(out.spot)).toEqual(new Set(spots));
+  });
+
+  it('ranks the family cutoff by linear-light radiance instead of packed sRGB channels', () => {
+    const gray = Array.from({ length: 4 }, () =>
+      createPointLight({
+        color: 0x808080ff,
+        intensity: 1,
+        position: { x: 2, y: 0, z: 0 },
+        range: -1,
+      }),
+    );
+    const white = createPointLight({
+      color: 0xffffffff,
+      intensity: 0.3,
+      position: { x: 2, y: 0, z: 0 },
+      range: -1,
+    });
+    const out = selection();
+    selectSceneForwardLights(
+      out,
+      { ambient: null, directional: null, point: [...gray, white] },
+      createBoundingSphere(0, 0, 0, 0),
+    );
+    expect(out.point).toContain(white);
+    expect(out.point).toHaveLength(4);
+  });
+
+  it('selects the strongest four points and strongest four spots independently', () => {
+    const points = [8, 7, 6, 5, 4, 3].map((x) => createPointLight({ position: { x, y: 0, z: 0 }, range: -1 }));
+    const spots = spotLights([8, 7, 6, 5, 4, 3]);
+    const out = selection();
+    selectSceneForwardLights(
+      out,
+      { ambient: null, directional: null, point: points, spot: spots },
+      createBoundingSphere(0, 0, 0, 0),
+    );
+    expect(out.point).toEqual(points.slice(2).reverse());
+    expect(out.spot).toEqual(spots.slice(2).reverse());
+    expect(out.indices).toEqual([5, 4, 3, 2, ~5, ~4, ~3, ~2]);
+  });
+
+  it('uses stable input order to break equal-contribution ties', () => {
+    const points = Array.from({ length: 6 }, () => createPointLight({ position: { x: 2, y: 0, z: 0 }, range: -1 }));
+    const out = selection();
+    selectSceneForwardLights(
+      out,
+      { ambient: null, directional: null, point: points },
+      createBoundingSphere(0, 0, 0, 0),
+    );
+    expect(out.point).toEqual(points.slice(0, 4));
+    expect(out.indices).toEqual([0, 1, 2, 3]);
+  });
+
+  it('omits zero-contribution lights', () => {
+    const out = selection();
+    selectSceneForwardLights(
+      out,
+      {
+        ambient: null,
+        directional: null,
+        point: [createPointLight({ position: { x: 10, y: 0, z: 0 }, range: 2 })],
+      },
+      createBoundingSphere(0, 0, 0, 0),
+    );
+    expect(out.point).toHaveLength(0);
+    expect(out.indices).toHaveLength(0);
+  });
+
+  it('reads all inputs before writing an aliased output', () => {
+    const points = [
+      createPointLight({ position: { x: 4, y: 0, z: 0 }, range: -1 }),
+      createPointLight({ position: { x: 1, y: 0, z: 0 }, range: -1 }),
+    ];
+    const far = points[0];
+    const near = points[1];
+    const lights: SceneLightsLike = { ambient: null, directional: null, point: points, spot: [] };
+    const out = lights as SceneLightsLike & SceneForwardLightSelection;
+    out.indices = [];
+    selectSceneForwardLights(out, lights, createBoundingSphere(0, 0, 0, 0));
+    expect(out.point).toEqual([near, far]);
+    expect(out.indices).toEqual([1, 0]);
+  });
+});