@plasius/gpu-renderer 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -23,6 +23,57 @@ All notable changes to this project will be documented in this file.
 - **Security**
   - (placeholder)
 
+## [0.1.8] - 2026-03-15
+
+- **Added**
+  - ADR, TDR, and test-first planning coverage for the ray-tracing-first
+    hybrid render graph and range-banded scene representations.
+  - Added `createRayTracingRenderPlan(...)` plus public render-stage,
+    representation-band, and acceleration-structure policy exports.
+  - Expanded renderer worker manifests with stable visual snapshot input
+    boundaries and RT-first render-planning metadata.
+  - Added tests covering stable snapshot ingestion, required denoise/temporal
+    stages, representation-band policies, and acceleration-structure classes.
+
+- **Changed**
+  - TDR-0003 now reflects the implemented RT-first render-planning helpers.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.1.7] - 2026-03-14
+
+- **Added**
+  - Added frame lifecycle hooks and frame-id generation support to
+    `createGpuRenderer(...)`.
+  - Added `createRendererDebugHooks(...)` for opt-in `@plasius/gpu-debug`
+    frame sampling tied to negotiated frame targets.
+  - Added ADR, TDR, and design docs for renderer frame hook integration.
+  - Added renderer worker profile and manifest exports for `realtime` and `xr`
+    DAG scheduling across `@plasius/gpu-worker` and
+    `@plasius/gpu-performance`.
+  - Added ADR, TDR, and design docs for renderer frame-stage DAG manifests.
+
+- **Changed**
+  - Clarified renderer guidance for adaptive frame targets and debug
+    instrumentation.
+  - Clarified that frame hooks cover correlation while worker manifests cover
+    renderer stage scheduling.
+  - Raised the minimum `@plasius/gpu-xr` dependency to `^0.1.7` so npm
+    installs resolve the published adaptive XR session helpers by default.
+  - Updated GitHub Actions workflows to run JavaScript actions on Node 24,
+    refreshed core workflow action versions, and switched Codecov uploads to
+    the Codecov CLI.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [0.1.6] - 2026-03-04
 
 - **Added**
@@ -81,3 +132,5 @@ All notable changes to this project will be documented in this file.
 [0.1.1]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.1
 [0.1.2]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.2
 [0.1.6]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.6
+[0.1.7]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.7
+[0.1.8]: https://github.com/Plasius-LTD/gpu-renderer/releases/tag/v0.1.8

package/README.md

@@ -37,6 +37,72 @@ renderer.resize(window.innerWidth, window.innerHeight);
 renderer.start();
 ```
 
+## Adaptive Frame Hooks
+
+`@plasius/gpu-renderer` now exposes frame lifecycle hooks so the app can pass
+negotiated frame targets from `@plasius/gpu-performance` and opt into renderer
+frame sampling for `@plasius/gpu-debug`.
+
+```js
+import { createGpuRenderer, createRendererDebugHooks } from "@plasius/gpu-renderer";
+
+const rendererDebugHooks = createRendererDebugHooks({
+  debugSession,
+  getTargetFrameTimeMs: () => governor.getSnapshot().targetFrameTimeMs,
+});
+
+const renderer = await createGpuRenderer({
+  canvas: "#scene",
+  frameIdFactory: ({ frame, xrActive }) => `scene.${xrActive ? "xr" : "flat"}.${frame}`,
+  ...rendererDebugHooks,
+});
+```
+
+## Worker DAG Manifests
+
+The renderer also publishes worker-facing frame-stage manifests so
+`@plasius/gpu-performance` and `@plasius/gpu-worker` can reason about renderer
+work as a multi-root DAG instead of a flat queue.
+
+```js
+import { getRendererWorkerManifest } from "@plasius/gpu-renderer";
+
+const realtimeManifest = getRendererWorkerManifest();
+const xrManifest = getRendererWorkerManifest("xr");
+
+console.log(realtimeManifest.jobs.map((job) => job.worker.jobType));
+console.log(xrManifest.jobs.find((job) => job.key === "lateLatch"));
+```
+
+- `realtime` publishes `acquire`, `visibility`, `mainEncode`, `postProcess`,
+  and `submit`.
+- `xr` publishes `acquire`, `visibility`, `lateLatch`, `mainEncode`, and
+  `submit`.
+- Jobs include queue class, priority, dependencies, adaptive budget levels, and
+  debug metadata such as allocation tags.
+
+## Ray-Tracing-First Planning
+
+The renderer now publishes a stable-snapshot render plan for the premium
+ray-tracing-first frame model.
+
+```js
+import { createRayTracingRenderPlan } from "@plasius/gpu-renderer";
+
+const plan = createRayTracingRenderPlan({
+  snapshotId: "visual-snapshot-42",
+});
+
+console.log(plan.inputBoundary);
+console.log(plan.renderStages.map((stage) => stage.key));
+console.log(plan.representationBands);
+```
+
+The plan makes the stable visual snapshot boundary explicit, publishes the
+required RT-first stage ordering, and exposes representation-band plus
+acceleration-structure update policy metadata for downstream lighting and
+performance packages.
+
 ## XR integration
 
 ```js
@@ -56,8 +122,18 @@ renderer.bindXrManager(xr, {
 
 - `supportsWebGpu(options)`
 - `createGpuRenderer(options)`
+- `createRendererDebugHooks(options)`
+- `getRendererWorkerProfile(name?)`
+- `getRendererWorkerManifest(name?)`
+- `createRayTracingRenderPlan(options)`
 - `bindRendererToXrManager(renderer, xrManager, options)`
 - `defaultRendererClearColor`
+- `rendererDebugOwner`
+- `rendererWorkerQueueClass`
+- `defaultRendererWorkerProfile`
+- `rendererWorkerProfiles`
+- `rendererWorkerProfileNames`
+- `rendererWorkerManifests`
 
 ## Demo
 
@@ -85,4 +161,6 @@ npm run pack:check
 - `src/index.js`: WebGPU renderer runtime and XR binding helper.
 - `src/index.d.ts`: public API typings.
 - `tests/package.test.js`: unit tests for renderer lifecycle behavior.
+- `docs/design/worker-manifest-integration.md`: renderer frame-stage DAG model.
 - `docs/adrs/*`: architecture decisions for renderer runtime design.
+- `docs/tdrs/*`: technical direction for frame hook integration.