@plasius/gpu-world-generator 0.0.10 → 0.0.12

package/README.md

@@ -59,6 +59,52 @@ const { levelSpec, cells, terrain } = generateTemperateMixedForest({
 import terrainWgsl from "@plasius/gpu-world-generator/terrain.wgsl?raw";
 ```
 
+## Worker DAG Manifests
+
+`@plasius/gpu-world-generator` now publishes worker-first generation manifests
+so chunk and voxel work can be scheduled as a multi-root DAG instead of a flat
+queue.
+
+```js
+import { getWorldGeneratorWorkerManifest } from "@plasius/gpu-world-generator";
+
+const streaming = getWorldGeneratorWorkerManifest();
+const bake = getWorldGeneratorWorkerManifest("bake");
+
+console.log(streaming.jobs.map((job) => job.worker.jobType));
+console.log(bake.jobs.find((job) => job.key === "assetSerialize"));
+```
+
+- `streaming` models runtime chunk generation and mesh materialization.
+- `bake` extends the DAG with asset serialization for background/offline output.
+- Jobs include queue class, priority, dependencies, adaptive budget ladders, and
+  debug allocation tags for integration with `@plasius/gpu-performance` and
+  `@plasius/gpu-debug`.
+
+## Render Representation Plans
+
+`@plasius/gpu-world-generator` now also publishes explicit chunk
+representation-tier plans so renderer and worker packages can coordinate near,
+mid, far, and horizon outputs without guessing from distance alone.
+
+```js
+import { createWorldGeneratorRepresentationPlan } from "@plasius/gpu-world-generator";
+
+const plan = createWorldGeneratorRepresentationPlan({
+  chunkId: "hex-12-9",
+  profile: "streaming",
+  gameplayImportance: "critical",
+});
+
+console.log(plan.bands);
+console.log(plan.representations.find((entry) => entry.output === "rtProxy"));
+```
+
+Each plan exposes raster-facing and RT-facing outputs separately, plus refresh
+cadence, shadow relevance, chunk-identity preservation, and scheduling metadata
+that downstream renderer and worker packages can prioritize by band and
+importance.
+
 ## Demo
 The WebGPU mixed-forest demo lives in `demo/`. Run it with:
 
@@ -81,3 +127,5 @@ npm run pack:check
 ## Notes
 - For Vite/Pnpm setups, raw WGSL import is the most reliable.
 - See `docs/plan.md` for hierarchy and biome rules.
+- See `docs/design/worker-manifest-integration.md` for the chunk/voxel DAG
+  contract.