@plasius/gpu-lighting 0.1.6 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +39 -0
- package/README.md +39 -0
- package/dist/index.cjs +710 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +702 -1
- package/dist/index.js.map +1 -1
- package/package.json +5 -2
- package/src/index.js +720 -0
package/CHANGELOG.md
CHANGED
|
@@ -20,6 +20,43 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
|
|
|
20
20
|
- **Security**
|
|
21
21
|
- (placeholder)
|
|
22
22
|
|
|
23
|
+
## [0.1.8] - 2026-03-14
|
|
24
|
+
|
|
25
|
+
- **Added**
|
|
26
|
+
- (placeholder)
|
|
27
|
+
|
|
28
|
+
- **Changed**
|
|
29
|
+
- Raised the minimum `@plasius/gpu-worker` dependency to `^0.1.10` so npm
|
|
30
|
+
installs resolve the published DAG-ready worker runtime by default.
|
|
31
|
+
- Updated GitHub Actions workflows to run JavaScript actions on Node 24,
|
|
32
|
+
refreshed core workflow action versions, and switched Codecov uploads to
|
|
33
|
+
the Codecov CLI.
|
|
34
|
+
|
|
35
|
+
- **Fixed**
|
|
36
|
+
- (placeholder)
|
|
37
|
+
|
|
38
|
+
- **Security**
|
|
39
|
+
- (placeholder)
|
|
40
|
+
|
|
41
|
+
## [0.1.7] - 2026-03-13
|
|
42
|
+
|
|
43
|
+
- **Added**
|
|
44
|
+
- Worker governance manifests and bundle loaders that align lighting jobs with
|
|
45
|
+
`gpu-worker`, `gpu-performance`, and `gpu-debug` integration contracts.
|
|
46
|
+
- ADR, TDR, and design documentation for worker-first lighting integration.
|
|
47
|
+
- DAG scheduler metadata for lighting manifests, including priorities and
|
|
48
|
+
inter-job dependencies per technique.
|
|
49
|
+
|
|
50
|
+
- **Changed**
|
|
51
|
+
- README now documents lighting worker manifests, performance budget ladders,
|
|
52
|
+
DAG metadata, and debug metadata expectations for consumers.
|
|
53
|
+
|
|
54
|
+
- **Fixed**
|
|
55
|
+
- (placeholder)
|
|
56
|
+
|
|
57
|
+
- **Security**
|
|
58
|
+
- (placeholder)
|
|
59
|
+
|
|
23
60
|
## [0.1.6] - 2026-03-04
|
|
24
61
|
|
|
25
62
|
- **Added**
|
|
@@ -103,3 +140,5 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
|
|
|
103
140
|
[0.1.1]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.1
|
|
104
141
|
[0.1.2]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.2
|
|
105
142
|
[0.1.6]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.6
|
|
143
|
+
[0.1.7]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.7
|
|
144
|
+
[0.1.8]: https://github.com/Plasius-LTD/gpu-lighting/releases/tag/v0.1.8
|
package/README.md
CHANGED
|
@@ -31,6 +31,7 @@ npm install @plasius/gpu-lighting
|
|
|
31
31
|
```js
|
|
32
32
|
import {
|
|
33
33
|
loadLightingTechniqueJobs,
|
|
34
|
+
loadLightingTechniqueWorkerBundle,
|
|
34
35
|
getLightingTechnique,
|
|
35
36
|
} from "@plasius/gpu-lighting";
|
|
36
37
|
import { assembleWorkerWgsl, loadWorkerWgsl } from "@plasius/gpu-worker";
|
|
@@ -46,6 +47,42 @@ const shaderCode = await assembleWorkerWgsl(workerWgsl, {
|
|
|
46
47
|
console.log(getLightingTechnique("hybrid").description);
|
|
47
48
|
```
|
|
48
49
|
|
|
50
|
+
## Usage (worker governance bundle)
|
|
51
|
+
|
|
52
|
+
```js
|
|
53
|
+
import {
|
|
54
|
+
getLightingProfileWorkerManifest,
|
|
55
|
+
loadLightingTechniqueWorkerBundle,
|
|
56
|
+
} from "@plasius/gpu-lighting";
|
|
57
|
+
|
|
58
|
+
const bundle = await loadLightingTechniqueWorkerBundle("hybrid");
|
|
59
|
+
|
|
60
|
+
// WGSL for gpu-worker assembly
|
|
61
|
+
console.log(bundle.preludeWgsl, bundle.jobs);
|
|
62
|
+
|
|
63
|
+
// Contract-aligned metadata for gpu-performance and gpu-debug integrations
|
|
64
|
+
console.log(bundle.workerManifest.jobs[0].performance.levels);
|
|
65
|
+
console.log(bundle.workerManifest.jobs[0].debug);
|
|
66
|
+
console.log(bundle.workerManifest.schedulerMode);
|
|
67
|
+
console.log(bundle.workerManifest.jobs[0].worker.priority);
|
|
68
|
+
console.log(bundle.workerManifest.jobs[0].worker.dependencies);
|
|
69
|
+
|
|
70
|
+
const profileManifest = getLightingProfileWorkerManifest("realtime");
|
|
71
|
+
console.log(profileManifest.jobs.map((job) => job.worker.jobType));
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## DAG Scheduling
|
|
75
|
+
|
|
76
|
+
Lighting worker manifests now publish `schedulerMode: "dag"` plus per-job
|
|
77
|
+
`priority` and `dependencies` so downstream runtimes can preserve stage order.
|
|
78
|
+
|
|
79
|
+
- `hybrid`: `directLighting` and `screenTrace` are roots; `radianceCache`,
|
|
80
|
+
`finalGather`, and `reflectionResolve` unlock as upstream work finishes.
|
|
81
|
+
- `pathtracer`: `pathTrace -> accumulate -> denoise`
|
|
82
|
+
- `volumetrics`: `volumetricShadow -> froxelIntegrate`
|
|
83
|
+
- `hdri`: `irradianceConvolution` and `specularPrefilter` are roots; `brdfLut`
|
|
84
|
+
joins after both finish.
|
|
85
|
+
|
|
49
86
|
## Usage (profile planning)
|
|
50
87
|
|
|
51
88
|
```js
|
|
@@ -116,3 +153,5 @@ npm run pack:check
|
|
|
116
153
|
- `src/techniques/volumetrics/*`: volumetric lighting WGSL modules.
|
|
117
154
|
- `src/techniques/hdri/*`: HDRI/IBL precompute WGSL modules.
|
|
118
155
|
- `docs/adrs/*`: architecture decisions for the lighting stack.
|
|
156
|
+
- `docs/tdrs/*`: technical design records for worker manifests and debug hooks.
|
|
157
|
+
- `docs/design/*`: integration guidance for worker budgets, DAG metadata, and debug instrumentation.
|