@plasius/gpu-renderer 0.2.45 → 0.2.46

package/CHANGELOG.md

@@ -23,6 +23,27 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
+## [0.2.46] - 2026-09-29
+
+- Add native showcase surface drawing with filtered shadows, HDR planar water
+  reflections, analytic waves, four-sample antialiasing and bounded resource ownership.
+- Add an optional multipass `encodeFrame` hook to the existing renderer lifecycle.
+
+- **Added**
+  - Internal reflected adaptive budget/count metadata, optional bounded classifier
+    and packed-history buffers, and lazy allocation admission with a 128 MiB cap.
+    This is infrastructure only; per-pixel dispatch and site controls remain pending.
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [0.2.45] - 2026-09-07
 
 - **Added**
@@ -1127,3 +1148,4 @@ All notable changes to this project will be documented in this file.
 [0.2.43]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.43
 [0.2.44]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.44
 [0.2.45]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.45
+[0.2.46]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.46

package/README.md

@@ -1,5 +1,26 @@
 # @plasius/gpu-renderer
 
+## Native animated showcase surfaces
+
+`createNativeSceneRenderer({ canvas })` draws interleaved world-space triangles
+with depth testing, four-sample antialiasing, filtered directional shadows and
+animated water with a planar reflection. Call `render({ vertices, camera, time,
+wakes })` from the caller's animation loop and `destroy()` on teardown. Each vertex
+has twelve floats: position XYZ, normal XYZ, linear colour RGB, roughness,
+metalness, and procedural detail kind (0 plain, 1 wood, 2 mineral/cloth, 3 terrain).
+`camera` supplies `eye`, `target` and optional vertical `fov`. At most four wakes
+contain `[x, z, headingRadians]`; water can be disabled with `water: false`.
+
+The input limit defaults to 300,000 vertices. Colour/depth targets are reused and
+render dimensions are capped at 3840 per axis and a 1080p pixel budget. Snapshots identify `webgpu-raster`
+and count submitted frames; they do not claim ray tracing, GPU completion or
+photorealism. Native initialization failures reject; device loss changes
+`available` and calls `onUnavailable`. The existing wavefront APIs are unchanged.
+
+Enable only through the consumer's remote `gpu-demo.scene-fidelity.enabled`
+decision and existing access capability. See [design](docs/design/native-showcase-surfaces.md)
+and [ADR-0030](docs/adrs/adr-0030-native-showcase-surfaces.md) for rollout and limits.
+
 [![npm version](https://img.shields.io/npm/v/@plasius/gpu-renderer.svg)](https://www.npmjs.com/package/@plasius/gpu-renderer)
 [![Build Status](https://img.shields.io/github/actions/workflow/status/Plasius-LTD/gpu-renderer/ci.yml?branch=main&label=build&style=flat)](https://github.com/Plasius-LTD/gpu-renderer/actions/workflows/ci.yml)
 [![coverage](https://img.shields.io/codecov/c/github/Plasius-LTD/gpu-renderer)](https://codecov.io/gh/Plasius-LTD/gpu-renderer)
@@ -58,6 +79,21 @@ diagnostic capture or network/storage operation, and never registers
 `/player-system`. Disabling the flag preserves ordinary structured-only bug
 reporting.
 
+## Adaptive per-pixel implementation status
+
+Per-pixel adaptive rendering is not yet exposed by the public renderer API.
+The internal [metadata foundation](docs/design/adaptive-metadata.md) now provides
+reflected requested/completed count storage and lazy, bounded allocation.
+`@plasius/gpu-shader` validates the final initialization WGSL in development;
+the reflector does not enter browser bundles. The normal `npm test` suite checks
+generated byte constants, count packing, allocation admission and cleanup.
+
+The fixed renderer and its whole-frame budget adjustment are unchanged. Actual
+completed-count normalization, compact primary scheduling, foveation and shared
+integration must land before a site comparison can claim per-pixel adaptation.
+No image-quality, performance or net-memory-saving claim follows from the
+metadata-only WebGPU execution fixture. See [ADR 0029](docs/adrs/adr-0029-reflected-adaptive-metadata-admission.md).
+
 ## Install
 
 ```sh