@plasius/gpu-renderer 0.1.14 → 0.2.0

package/CHANGELOG.md

@@ -23,6 +23,22 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
+## [0.2.0] - 2026-06-05
+
+- **Added**
+  - Added deterministic wavefront reference helpers for primary-ray creation,
+    triangle-hit evaluation, nearest-hit selection, and environment-miss
+    fallback alongside regression tests for task-level acceptance coverage.
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [0.1.14] - 2026-06-04
 
 - **Added**
@@ -57,10 +73,15 @@ All notable changes to this project will be documented in this file.
     tail so active diffuse rays sample finite mesh light geometry more often
     without adding a ninth trace storage buffer or separate direct-light/shadow
     accumulation path.
+  - Added WebGPU environment-light portal records so rooms and studio interiors
+    can guide and gate sky/HDRI contribution through openings such as windows.
 
 - **Changed**
   - Wavefront environment misses now evaluate a direction-aware sky/key-light
     environment payload instead of only using a flat environment colour.
+  - Wavefront environment misses now respect `environmentPortalMode`; in
+    `guide-and-gate` mode, misses outside configured portals fall back to the
+    ambient residual instead of receiving full sky radiance.
   - Display-quality wavefront configuration now uses GPU-built mesh
     acceleration; CPU-built mesh acceleration is treated as debug-only.
   - Replaced the one-thread BVH internal-node build kernel with bottom-up
@@ -78,11 +99,17 @@ All notable changes to this project will be documented in this file.
     preview output.
   - Wavefront primary-ray jitter and bounce sampling now use mixed
     pixel/sample/bounce/frame seeds to reduce row-correlated low-sample noise.
+  - Wavefront frames now reuse a static GPU-built mesh BVH after the first
+    acceleration build and batch tile/sample tracing, tile output, optional
+    denoise, and presentation into one frame command submission.
 
 - **Fixed**
   - Fixed primary-ray jitter seeding to use absolute screen pixel ids instead
     of tile-local pixel ids, preventing repeated sampling patterns across
     tiles.
+  - Fixed environment portal WGSL reserved-word usage and now request the
+    required 9-storage-buffer trace limit from capable WebGPU adapters before
+    creating the mesh-BVH trace pipeline.
   - Fixed the WebGPU hit-buffer stride to match the WGSL `HitRecord` layout
     and added a continuation-queue capacity guard, preventing tile-row
     corruption in mesh BVH wavefront renders.
@@ -262,3 +289,4 @@ All notable changes to this project will be documented in this file.
 [0.1.11]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.11
 [0.1.12]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.12
 [0.1.14]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.14
+[0.2.0]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.0

package/README.md

@@ -200,6 +200,19 @@ weight so finite light guidance does not over-expose low-sample renders before
 full material PDFs/MIS are implemented. High-energy samples are clamped in
 linear radiance space to keep low-sample preview output stable while production
 sampling, temporal accumulation, and better material PDFs are hardened.
+For static mesh scenes, the GPU acceleration build is submitted once and then
+reused by subsequent frames. Per-frame tracing writes one dynamic uniform slot
+per tile/sample or post-process pass and batches tile tracing, tile output,
+optional denoise, and presentation into a single command submission. WebGPU
+still preserves ordering between dependent bounce passes, but the renderer no
+longer forces one CPU queue submission per tile/sample.
+Environment-light portals can additionally guide and gate sky/HDRI contribution
+through rectangular openings such as windows. `environmentPortalMode: "guide"`
+biases diffuse continuation rays toward configured openings, while
+`"guide-and-gate"` requires an environment miss to pass through a portal before
+it receives sky radiance; misses outside a portal fall back to the ambient
+residual. This keeps interior rooms from treating the whole sky as visible from
+every bounce.
 Texture sampling, dynamic TLAS updates, higher-grade LBVH/SAH construction,
 runtime execution behind the `@plasius/gpu-worker` lock-free queue, and broader
 material lookup remain follow-up work.
@@ -229,6 +242,9 @@ renderer.bindXrManager(xr, {
 - `createRayTracingRenderPlan(options)`
 - `createWavefrontPathTracingComputeRenderer(options)`
 - `createWavefrontPathTracingComputeConfig(options)`
+- `createWavefrontReferenceRay(config, options?)`
+- `intersectWavefrontReferenceTriangle(ray, triangle, options?)`
+- `traceWavefrontReferenceTriangles(config, ray, triangles, options?)`
 - `normalizeWavefrontMesh(input)`
 - `createWavefrontGpuMeshSource(meshes)`
 - `createWavefrontBvhSortStages(itemCount)`
@@ -247,6 +263,11 @@ renderer.bindXrManager(xr, {
 - `rendererWorkerProfileNames`
 - `rendererWorkerManifests`
 
+The reference helpers mirror the renderer WGSL camera and triangle-hit math in
+deterministic JavaScript so tests and downstream tooling can validate primary
+ray generation, barycentrics, nearest-hit selection, and environment misses
+without standing up a WebGPU device.
+
 ## Demo
 
 Run the demo server from the repo root: