@plasius/gpu-renderer 0.2.42 → 0.2.44

package/CHANGELOG.md

@@ -18,11 +18,52 @@ All notable changes to this project will be documented in this file.
   - (placeholder)
 
 - **Fixed**
+  - Preserved hosted pull-request isolation, bounded validation runtime, and
+    disabled package-manager cache finalization on self-hosted main validation.
   - (placeholder)
 
 - **Security**
   - (placeholder)
 
+## [0.2.44] - 2026-08-31
+
+- **Added**
+  - Added an explicit consent-, flag-, and capability-gated helper that converts
+    coarse renderer health observations into the closed shared feedback
+    diagnostics packet for approved generator and GPU demo surfaces.
+
+- **Changed**
+  - Updated `@plasius/gpu-shared` to the protected-CD-published 1.1.1 release
+    that exposes the focused feedback-diagnostics contract, and revalidated
+    the renderer against the registry artifact.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.2.43] - 2026-08-31
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - Negotiated scene-derived `maxStorageBufferBindingSize` and, when required,
+    `maxBufferSize` before WebGPU device creation so large mesh/BVH scenes fail
+    early on unsupported adapters and render on adapters that expose sufficient
+    non-default limits.
+  - Corrected wavefront memory telemetry to match every persistent GPU buffer
+    descriptor exactly once, including placeholder records, combined BVH and
+    emissive metadata, mesh sources, and aligned frame/build config buffers,
+    while removing the nonexistent material-table allocation.
+
+- **Security**
+  - (placeholder)
+
 ## [0.2.42] - 2026-08-31
 
 - **Added**
@@ -69,11 +110,21 @@ All notable changes to this project will be documented in this file.
 
 - **Changed**
   - Updated internal GPU dependencies to their surviving clean lines and refreshed the esbuild resolution.
+  - Bound diagnostics to the focused shared-package subpath and canonical
+    contract-version export, and enabled complete declaration checking with the
+    published WebXR type definitions.
 
 - **Fixed**
-  - (placeholder)
+  - Removed a duplicate public mesh `extensions` declaration and replaced
+    unresolved ambient XR session references with the `@plasius/gpu-xr` state
+    contract.
 
 - **Security**
+  - Updated the development-tool dependency graph to the patched
+    `brace-expansion` release after the feedback release audit.
+  - Kept feedback diagnostics separate from general renderer snapshots and
+    excluded user-captured pixels, DOM, player data, URLs, filenames, exact
+    measurements, adapter identity and raw warnings from the output contract.
   - Added permanent fail-closed Zero-Three validation for manifests, source,
     locks, installed dependency graphs, declarations, bundles, npm tarballs,
     CycloneDX SBOMs, and active documentation, with digest-bound evidence
@@ -636,6 +687,9 @@ All notable changes to this project will be documented in this file.
     contract used by the wavefront display-quality renderer.
 
 - **Fixed**
+  - Clamped wavefront tile capacity against the depth-scaled path-vertex
+    storage binding so supported high-depth reference renders stay within
+    `maxStorageBufferBindingSize`.
   - Raised the bounded wavefront `maxDepth` ceiling to 32 so offline/reference
     renders can request 20-bounce paths without being clamped by renderer
     configuration.
@@ -663,6 +717,9 @@ All notable changes to this project will be documented in this file.
     corruption and stalled validation captures on higher-SPP frames.
 
 - **Changed**
+  - Raised the bounded wavefront `maxDepth` ceiling to 32 so offline/reference
+    renders can request 20-bounce paths without being clamped by renderer
+    configuration.
   - Changed internal wavefront frame batching and dispatch-diagnostics plumbing
     to live in a dedicated runtime helper module so scheduling concerns stay
     separated from shader and pipeline assembly.
@@ -1047,3 +1104,5 @@ All notable changes to this project will be documented in this file.
 [0.2.40]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.40
 [0.2.41]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.41
 [0.2.42]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.2.42
+[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

package/README.md

@@ -8,19 +8,56 @@
 [![Security Policy](https://img.shields.io/badge/security%20policy-yes-orange.svg)](./SECURITY.md)
 [![Changelog](https://img.shields.io/badge/changelog-md-blue.svg)](./CHANGELOG.md)
 
-[![license](https://img.shields.io/github/license/Plasius-LTD/gpu-renderer)](./LICENSE)
-
 Framework-agnostic WebGPU renderer runtime for Plasius projects.
 This package is intended to replace Three.js-dependent render orchestration with
 an explicit WebGPU-first runtime that can be consumed from React, vanilla, or
 worker-driven app surfaces.
 
 The package targets Node.js 24, consumes the stable `@plasius/gpu-shared` 1.x
-runtime line (`^1.0.12`), and validates its development tooling against the
+runtime line (`^1.1.1`), and validates its development tooling against the
 current ESLint 10 and TypeScript 7 baselines.
 
 Apache-2.0. ESM + CJS builds.
 
+## Privacy-Safe Feedback Diagnostics
+
+Approved in-game viewers can explicitly convert a small set of current renderer
+health observations into the closed
+`@plasius/gpu-shared/feedback-diagnostics` packet:
+
+```js
+import { createFeedbackGameDiagnosticSnapshot } from "@plasius/gpu-renderer";
+
+const diagnostics = createFeedbackGameDiagnosticSnapshot({
+  featureEnabled,
+  capabilityGranted,
+  consentConfirmed: true,
+  surfaceId: "site.gpu-demo",
+  renderer: "webgpu",
+  backend: "worker",
+  viewportWidth: 1920,
+  viewportHeight: 1080,
+  frameRate: 59.9,
+  frameTimeMs: 16.7,
+  featureIds: ["renderer.frame-loop"],
+  counters: [{ code: "frame-drop", count: 2 }],
+  errorCodes: [],
+});
+```
+
+The helper returns `null` before reading renderer observations unless the
+remotely evaluated `feedback.game-diagnostics.enabled` flag, the
+`feedback.game-diagnostics.attach` capability, and explicit consent are all
+present. It derives trusted provenance and returns only coarse buckets and
+closed codes.
+
+This API is deliberately separate from general renderer snapshots. It accepts
+no canvas, user-captured pixels, DOM, player object, URL, filename,
+adapter/device detail, coordinate or raw warning, performs no automatic
+diagnostic capture or network/storage operation, and never registers
+`/player-system`. Disabling the flag preserves ordinary structured-only bug
+reporting.
+
 ## Install
 
 ```sh
@@ -429,6 +466,17 @@ without rebuilding scene buffers. `renderFrame(...)` also accepts an optional
 guarantees at least the minimum full-screen pass, and frame stats report both
 configured `samplesPerPixel` and actual `renderedSamplesPerPixel` so realtime
 callers can budget motion frames without overstating delivered quality.
+Before requesting a WebGPU device, the renderer derives the largest scene
+storage binding from the normalized scene, mesh, and BVH records. It requests
+the smallest sufficient `maxStorageBufferBindingSize` (and `maxBufferSize` only
+when the WebGPU default is also exceeded), preserves stricter caller limits,
+and rejects unsupported adapters before device creation. Default-sized scenes
+do not elevate either size limit. `config.memory` and snapshot memory telemetry
+describe the actual persistent GPU buffer descriptors: placeholder records,
+combined BVH/emissive storage, mesh source buffers, aligned frame/build uniform
+buffers, counters, and dispatch arguments are each counted exactly once;
+`materialTableBytes` is zero because material data is packed into mesh and
+triangle records rather than a standalone GPU buffer.
 For consumers that want to hand wavefront SPP adaptation to
 `@plasius/gpu-performance`, `createWavefrontAdaptiveSamplingLevels(...)` exposes
 a bounded low-to-high ladder of per-frame `samplesPerPixel`,