@plasius/gpu-lighting 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -20,6 +20,25 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 - **Security**
   - (placeholder)
 
+## [0.1.7] - 2026-03-13
+
+- **Added**
+  - Worker governance manifests and bundle loaders that align lighting jobs with
+    `gpu-worker`, `gpu-performance`, and `gpu-debug` integration contracts.
+  - ADR, TDR, and design documentation for worker-first lighting integration.
+  - DAG scheduler metadata for lighting manifests, including priorities and
+    inter-job dependencies per technique.
+
+- **Changed**
+  - README now documents lighting worker manifests, performance budget ladders,
+    DAG metadata, and debug metadata expectations for consumers.
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
 ## [0.1.6] - 2026-03-04
 
 - **Added**
@@ -103,3 +122,4 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 [0.1.1]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.1
 [0.1.2]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.2
 [0.1.6]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.6
+[0.1.7]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.7

package/README.md

@@ -31,6 +31,7 @@ npm install @plasius/gpu-lighting
 ```js
 import {
   loadLightingTechniqueJobs,
+  loadLightingTechniqueWorkerBundle,
   getLightingTechnique,
 } from "@plasius/gpu-lighting";
 import { assembleWorkerWgsl, loadWorkerWgsl } from "@plasius/gpu-worker";
@@ -46,6 +47,42 @@ const shaderCode = await assembleWorkerWgsl(workerWgsl, {
 console.log(getLightingTechnique("hybrid").description);
 ```
 
+## Usage (worker governance bundle)
+
+```js
+import {
+  getLightingProfileWorkerManifest,
+  loadLightingTechniqueWorkerBundle,
+} from "@plasius/gpu-lighting";
+
+const bundle = await loadLightingTechniqueWorkerBundle("hybrid");
+
+// WGSL for gpu-worker assembly
+console.log(bundle.preludeWgsl, bundle.jobs);
+
+// Contract-aligned metadata for gpu-performance and gpu-debug integrations
+console.log(bundle.workerManifest.jobs[0].performance.levels);
+console.log(bundle.workerManifest.jobs[0].debug);
+console.log(bundle.workerManifest.schedulerMode);
+console.log(bundle.workerManifest.jobs[0].worker.priority);
+console.log(bundle.workerManifest.jobs[0].worker.dependencies);
+
+const profileManifest = getLightingProfileWorkerManifest("realtime");
+console.log(profileManifest.jobs.map((job) => job.worker.jobType));
+```
+
+## DAG Scheduling
+
+Lighting worker manifests now publish `schedulerMode: "dag"` plus per-job
+`priority` and `dependencies` so downstream runtimes can preserve stage order.
+
+- `hybrid`: `directLighting` and `screenTrace` are roots; `radianceCache`,
+  `finalGather`, and `reflectionResolve` unlock as upstream work finishes.
+- `pathtracer`: `pathTrace -> accumulate -> denoise`
+- `volumetrics`: `volumetricShadow -> froxelIntegrate`
+- `hdri`: `irradianceConvolution` and `specularPrefilter` are roots; `brdfLut`
+  joins after both finish.
+
 ## Usage (profile planning)
 
 ```js
@@ -116,3 +153,5 @@ npm run pack:check
 - `src/techniques/volumetrics/*`: volumetric lighting WGSL modules.
 - `src/techniques/hdri/*`: HDRI/IBL precompute WGSL modules.
 - `docs/adrs/*`: architecture decisions for the lighting stack.
+- `docs/tdrs/*`: technical design records for worker manifests and debug hooks.
+- `docs/design/*`: integration guidance for worker budgets, DAG metadata, and debug instrumentation.