@plasius/gpu-renderer 0.2.45 → 0.2.47

package/CHANGELOG.md

@@ -23,6 +23,42 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
+## [0.2.47] - 2026-10-09
+
+- **Added**
+  - Added `createCanonicalWavefrontMeshInputs` to adapt decoded canonical model
+    geometry, material factors, and texture samples to Wavefront renderer inputs.
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **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 +1163,5 @@ 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
+[0.2.47]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.47

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
@@ -93,6 +129,41 @@ renderer.resize(window.innerWidth, window.innerHeight);
 renderer.start();
 ```
 
+## Canonical model ingestion
+
+`createCanonicalWavefrontMeshInputs` adapts decoded primitive geometry and image
+samples from the canonical model pipeline to the renderer's existing
+`WavefrontMeshInput` shape. It maps canonical material factors and standard
+texture bindings, preserves supported material extension data, and rejects
+missing primitive, material, or decoded texture references. It accepts triangle
+primitives; parsing, resource fetching, image decoding, and other topologies stay
+in the upstream conversion layer. Metallic-roughness and unlit workflows are
+supported; workflows without an existing Wavefront mapping fail explicitly.
+
+```js
+import { createCanonicalWavefrontMeshInputs } from "@plasius/gpu-renderer";
+
+const meshes = createCanonicalWavefrontMeshInputs({
+  document: canonicalDocument,
+  geometry: decodedPrimitives.map(({ primitiveId, positions, indices, normals, texcoords }) => ({
+    primitiveId,
+    positions,
+    indices,
+    normals,
+    texcoords,
+  })),
+  // ReadonlyMap<canonical texture id, decoded RGBA sample>
+  textures: decodedTextureSamples,
+});
+```
+
+The canonical document uses types from `@plasius/gpu-model-core`. Geometry is
+already renderer-ready, normals may be omitted to retain the renderer's existing
+fallback, and texture samples are keyed by canonical texture ID. The consuming
+surface remains responsible for evaluating the remote
+`gpu.model.conversion.enabled` flag: when disabled or rolled back, keep the
+existing rendering path active.
+
 ## Adaptive Frame Hooks
 
 `@plasius/gpu-renderer` now exposes frame lifecycle hooks so the app can pass