@plasius/gpu-lighting 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -20,19 +20,33 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 - **Security**
   - (placeholder)
 
-## [0.2.4] - 2026-06-14
+## [0.2.6] - 2026-06-16
 
 - **Added**
-  - (placeholder)
+  - Added concrete volumetric WGSL kernels for `volumetricShadow` and
+    `froxelIntegrate`, covering froxel shadow history plus scattering/extinction
+    integration for the published realtime and reference profiles.
+  - Added concrete HDRI/IBL WGSL kernels for `irradianceConvolution`,
+    `specularPrefilter`, and `brdfLut`.
+  - Added a renderer-aligned `wavefront` lighting technique with concrete
+    WGSL jobs for terminal radiance accumulation and continuation scattering.
+  - Added `createWavefrontLightingPlan()`,
+    `evaluateWavefrontTerminalRadiance()`, and
+    `evaluateWavefrontContinuationEvent()` so downstream packages and tests can
+    validate emissive-hit, environment-hit, miss-darkening, reflection,
+    refraction, and transparency behavior without reimplementing the contract.
 
 - **Changed**
-  - (placeholder)
+  - README now documents the delivered volumetrics and HDRI kernel scope with
+    technique-level descriptions instead of leaving those exported jobs implied.
+  - Eames capture helpers now resolve workspace roots correctly from both
+    ordinary repo checkouts and `git worktree` paths.
 
 - **Fixed**
-  - (placeholder)
-
-- **Security**
-  - (placeholder)
+  - Package tests now fail if any exported `hybrid`, `volumetrics`, or `hdri`
+    job regresses to placeholder text or an empty/no-op `process_job` body.
+  - Eames asset-path and capture-bridge tests are now worktree-safe instead of
+    assuming the package always lives under a literal `/gpu-lighting/` path.
 
 ## [0.2.2] - 2026-06-11
 
@@ -461,7 +475,7 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 [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.19]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.19
-[Unreleased]: https://github.com/Plasius-LTD/gpu-lighting/compare/v0.2.4...HEAD
+[Unreleased]: https://github.com/Plasius-LTD/gpu-lighting/compare/v0.2.6...HEAD
 [0.2.0]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.2.0
 [0.2.2]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.2.2
-[0.2.4]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.2.4
+[0.2.6]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.2.6

package/README.md

@@ -162,6 +162,43 @@ const profileManifest = getLightingProfileWorkerManifest("realtime");
 console.log(profileManifest.jobs.map((job) => job.worker.jobType));
 ```
 
+## Wavefront Lighting Contracts
+
+`@plasius/gpu-lighting` now also publishes a renderer-aligned `wavefront`
+technique for the first active-ray lighting slice. It keeps the queue layout,
+buffer contract names, and terminal-hit policy aligned with
+`@plasius/gpu-renderer` while owning the lighting-specific WGSL for terminal
+radiance accumulation and continuation scattering.
+
+```js
+import {
+  createWavefrontLightingPlan,
+  evaluateWavefrontTerminalRadiance,
+  loadLightingTechniqueWorkerBundle,
+} from "@plasius/gpu-lighting";
+
+const plan = createWavefrontLightingPlan({
+  maxDepth: 6,
+  queueCapacity: 4096,
+  explicitLightSampling: true,
+});
+
+const bundle = await loadLightingTechniqueWorkerBundle("wavefront");
+const emissive = evaluateWavefrontTerminalRadiance({
+  hitType: "emissive",
+  throughput: [0.5, 0.5, 0.5],
+  emission: [8, 6, 4],
+});
+
+console.log(plan.requiredRendererPassOrder);
+console.log(bundle.jobs.map((job) => job.label));
+console.log(emissive.radiance);
+```
+
+This slice keeps emissive hits, environment hits, and environment-miss dark
+fallbacks on the lighting package surface without reintroducing a depth-first
+shader dependency into the renderer-owned wavefront queue model.
+
 ## Distance-Banded Lighting
 
 ```js
@@ -325,6 +362,11 @@ The package now ships concrete WGSL contracts for:
 - `hybrid.screenTrace`: first-hit reflection tracing over the shared hybrid scene contracts
 - `hybrid.radianceCache`: irradiance history updates for cache-backed indirect reuse
 - `hybrid.finalGather`: cache + trace composition with temporal reuse for the hybrid GI path
+- `volumetrics.volumetricShadow`: slice-aware Beer-Lambert shadow history for fog and shafts
+- `volumetrics.froxelIntegrate`: froxel scattering/extinction integration with temporal stability
+- `hdri.irradianceConvolution`: cosine-weighted diffuse environment convolution
+- `hdri.specularPrefilter`: roughness-aware environment prefiltering for glossy IBL
+- `hdri.brdfLut`: split-sum BRDF LUT integration for image-based lighting
 - `pathtracer.pathTrace`: analytic scene tracing, bounce integration, and sky fallback
 - `pathtracer.accumulate`: progressive history resolve with reset handling
 - `pathtracer.denoise`: spatial-temporal bilateral filtering for reference previews
@@ -354,12 +396,12 @@ graph.
   - `accumulate`
   - `denoise`
 - `volumetrics`
-  - `froxelIntegrate`
-  - `volumetricShadow`
+  - `froxelIntegrate`: accumulates participating-media scattering/extinction per froxel
+  - `volumetricShadow`: resolves directional shadow transmittance history per froxel
 - `hdri`
-  - `irradianceConvolution`
-  - `specularPrefilter`
-  - `brdfLut`
+  - `irradianceConvolution`: builds diffuse irradiance from the environment source
+  - `specularPrefilter`: builds roughness-aware glossy environment mip data
+  - `brdfLut`: integrates the split-sum BRDF lookup surface for IBL
 
 ## Demo