@plasius/gpu-lighting 0.1.18 → 0.2.0

package/CHANGELOG.md

@@ -20,9 +20,36 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 - **Security**
   - (placeholder)
 
-## [0.1.18] - 2026-06-01
+## [0.2.0] - 2026-06-06
 
 - **Added**
+  - Added environment-light portal contracts to the reusable environment
+    lighting config so renderers can guide and gate sky/HDRI contribution
+    through room openings such as windows.
+  - Added grass-field, forest, warehouse, and cavern environment lighting
+    preset families with dawn, midday, dusk, and night variants plus normalized
+    light-source metadata for environment-miss inference.
+  - Added scene/time-of-day preset aliases so callers can request environments
+    with `scene` plus `timeOfDay` instead of only combined preset names.
+
+- **Changed**
+  - Pathtracer environment misses now resolve through non-null inferred
+    environment radiance, and emissive material hits contribute once before
+    terminating the active sample path.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.1.19] - 2026-06-03
+
+- **Added**
+  - Added `createEnvironmentLightingConfig(...)` and
+    `createWavefrontEnvironmentLightingOptions(...)` so renderers and demos can
+    consume lighting-owned environment presets without embedding local ambient
+    or sky constants.
   - Concrete hybrid realtime WGSL kernels for `directLighting`,
     `screenTrace`, `radianceCache`, and `finalGather`.
 
@@ -326,4 +353,6 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 [0.1.15]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.15
 [0.1.16]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.16
 [0.1.17]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.17
-[0.1.18]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.18
+[0.1.19]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.19
+[Unreleased]: https://github.com/Plasius-LTD/gpu-lighting/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.2.0

package/README.md

@@ -105,6 +105,71 @@ Band plans make near, mid, far, and horizon shadow sources explicit, keep RT
 shadow/reflection/GI participation independent, and publish temporal reuse plus
 update cadence expectations for downstream renderer and performance packages.
 
+## Environment Lighting Presets
+
+```js
+import {
+  createEnvironmentLightingConfig,
+  createWavefrontEnvironmentLightingOptions,
+} from "@plasius/gpu-lighting";
+
+const lighting = createEnvironmentLightingConfig({
+  scene: "forest",
+  timeOfDay: "dusk",
+  intensity: 1.05,
+  environmentPortals: [
+    {
+      id: "north-window",
+      position: [0, 1.2, -2.4],
+      normal: [0, 0, 1],
+      tangent: [1, 0, 0],
+      width: 1.8,
+      height: 1.1,
+      intensity: 1.4,
+    },
+  ],
+});
+
+const wavefrontLighting = createWavefrontEnvironmentLightingOptions({
+  preset: "cavern-night",
+});
+
+console.log(lighting.environmentLightSources.map((source) => source.kind));
+console.log(wavefrontLighting.environmentMissLighting.startingPoint);
+```
+
+`createEnvironmentLightingConfig(...)` owns the reusable sky/environment
+semantics: horizon and zenith colours, key-light direction, key-light colour,
+environment intensity, exposure, ambient residual colour, and optional
+environment-light portals.
+
+Preset families now cover:
+
+- `grass-field-{dawn,midday,dusk,night}`
+- `forest-{dawn,midday,dusk,night}`
+- `warehouse-{dawn,midday,dusk,night}`
+- `cavern-{dawn,midday,dusk,night}`
+
+Callers can pass the combined `preset` name directly or pass `scene` plus
+`timeOfDay`; scene-only aliases default to `midday`.
+
+Each preset publishes `scene`, `timeOfDay`, normalized
+`environmentLightSources`, a `dominantLightSource`, and
+`environmentMissLighting`. Source metadata includes source kind, role, direction,
+position, colour, intensity, radiance, luminance, reach, and angular radius.
+Renderers can use `environmentMissLighting` when a path ray misses scene
+geometry: the miss has an inferred source colour/brightness and a stable
+`startingPoint` of `environment-miss` instead of an unbounded null/negative sky
+sample. Emissive material hits remain explicit light-source hits and should not
+be double-counted by environment inference.
+
+Portals describe physical openings such as windows where outside radiance can
+enter an interior. They are normalized as rectangle apertures with position,
+normal, tangent, dimensions, colour, and radiance scale.
+`createWavefrontEnvironmentLightingOptions(...)` projects that contract into the
+current `@plasius/gpu-renderer` wavefront renderer options without making the
+renderer depend on this package directly.
+
 ## DAG Scheduling
 
 Lighting worker manifests now publish `schedulerMode: "dag"` plus per-job