@plasius/gpu-renderer 0.2.48 → 0.2.50

package/CHANGELOG.md

@@ -11,6 +11,38 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.2.50] - 2026-10-18
+
+- Fix fixed-wavefront dielectric queue overflow and concurrent per-path writes by selecting one probability-weighted continuation; preserve total internal reflection energy and avoid spurious metal refraction siblings.
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.2.49] - 2026-10-14
+
+- Opt-in progressive wavefront accumulation of linear radiance, sample-weighted history, explicit reset and camera/scene invalidation for still-frame inspection.
+
 - **Added**
   - (placeholder)
 
@@ -1202,3 +1234,5 @@ All notable changes to this project will be documented in this file.
 [0.2.46]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.46
 [0.2.47]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.47
 [0.2.48]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.48
+[0.2.49]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.49
+[0.2.50]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.50

package/README.md

@@ -231,9 +231,13 @@ console.log(plan.wavefront.queueLayout.strategy);
 Wavefront materials support authored `KHR_materials_*` factors and extension
 textures, bounded nested media, Beer-Lambert attenuation, and reference
 transport helpers for reflected/transmitted branching and spectral dispersion.
-GPU rays carry up to four nested media and enqueue at most two dielectric
-continuations per hit; deeper nesting and full spectral rendering remain
-bounded by those explicit limits.
+GPU rays carry up to four medium identifiers and enqueue one selected
+continuation per hit. Dielectric lobes are weighted by their selection
+probability; total internal reflection retains unit throughput. The standalone
+CPU reference helper can describe both branches, but the fixed GPU path never
+enqueues an untracked sibling into its tile-sized queue. Physically qualified
+nested media, rough dielectric transport and full spectral rendering remain
+separate work. See [the Amber correction](docs/amber-transport-correction.md).
 
 ```js
 import {
@@ -981,3 +985,9 @@ See [ADR-0036](docs/adrs/adr-0036-in-scene-material-inspection.md).
 ### Shared material-study runtime
 
 Production demo helpers and their regression tests now live in `@plasius/gpu-shared/material-study`. The renderer exposes `validateNativeSurfaceMaterials(materials)` so authoring and GPU creation use identical validation without allocation. See [ADR-0037](docs/adrs/adr-0037-shared-material-study-runtime.md).
+
+## Progressive still-frame refinement
+
+Create the wavefront renderer with `progressive: true` to retain linear radiance across frames. `samplesPerPixel` at creation is the maximum batch capacity; pass a smaller value to `renderOnce({ samplesPerPixel })` or `renderFrame({ samplesPerPixel })`. Submit batches serially. `renderFrame()` awaits completion by default; with `renderOnce()`, await `renderer.device.queue.onSubmittedWorkDone()` before reporting completed samples. `getSnapshot().accumulatedSamplesPerPixel` reports submitted history samples.
+
+Camera or scene updates reset history automatically; `resetAccumulation()` also discards it without reallocating. Do not call `updateCamera()` between refinement passes unless the view changed. Progressive mode uses independent frame seeds, overriding static-frame stable sample routing. Denoising is applied after accumulation. Leave `progressive` unset for the existing independent-frame path. See [ADR 0038](docs/adrs/adr-0038-progressive-linear-radiance.md) for memory costs and host rollout responsibilities.