@plasius/gpu-world-generator 0.0.11 → 0.0.13

package/dist/index.d.cts

@@ -449,6 +449,44 @@ type WorldGeneratorWorkerProfileName = "streaming" | "bake";
 type WorldGeneratorWorkerDomain = "geometry" | "textures" | "custom";
 type WorldGeneratorWorkerAuthority = "visual" | "non-authoritative-simulation" | "authoritative";
 type WorldGeneratorWorkerImportance = "medium" | "high" | "critical";
+type WorldGeneratorRepresentationBand = "near" | "mid" | "far" | "horizon";
+type WorldGeneratorRepresentationOutput = "liveGeometry" | "simplifiedGeometry" | "rtProxy" | "mergedProxy" | "horizonShell";
+type WorldGeneratorRepresentationRtParticipation = "full" | "selective" | "proxy" | "disabled";
+type WorldGeneratorRepresentationShadowRelevance = "ray-traced-primary" | "selective-raster" | "proxy-caster" | "baked-impression";
+interface WorldGeneratorRepresentationCadence {
+    readonly kind: "per-frame" | "interval";
+    readonly divisor: number;
+}
+interface WorldGeneratorRepresentationDescriptor {
+    readonly id: string;
+    readonly chunkId: string;
+    readonly profile: WorldGeneratorWorkerProfileName;
+    readonly band: WorldGeneratorRepresentationBand;
+    readonly output: WorldGeneratorRepresentationOutput;
+    readonly rasterMode: "full-live" | "simplified-live" | "proxy" | "not-rendered" | "horizon-shell";
+    readonly rtParticipation: WorldGeneratorRepresentationRtParticipation;
+    readonly shadowRelevance: WorldGeneratorRepresentationShadowRelevance;
+    readonly refreshCadence: WorldGeneratorRepresentationCadence;
+    readonly preservesChunkIdentity: boolean;
+    readonly sourceChunkIds: readonly string[];
+    readonly sourceJobKeys: readonly string[];
+    readonly suggestedAllocationIds: readonly string[];
+    readonly scheduling: Readonly<{
+        owner: "renderer";
+        queueClass: typeof worldGeneratorWorkerQueueClass;
+        priorityHint: number;
+        gameplayImportance: WorldGeneratorWorkerImportance;
+        representationBand: WorldGeneratorRepresentationBand;
+    }>;
+}
+interface WorldGeneratorRepresentationPlan {
+    readonly schemaVersion: 1;
+    readonly owner: typeof worldGeneratorDebugOwner;
+    readonly profile: WorldGeneratorWorkerProfileName;
+    readonly chunkId: string;
+    readonly representations: readonly WorldGeneratorRepresentationDescriptor[];
+    readonly bands: readonly WorldGeneratorRepresentationBand[];
+}
 interface WorldGeneratorWorkerBudgetLevelConfig {
     maxDispatchesPerFrame: number;
     maxJobsPerDispatch: number;
@@ -512,10 +550,17 @@ interface WorldGeneratorWorkerManifest {
 declare const worldGeneratorDebugOwner = "world-generator";
 declare const worldGeneratorWorkerQueueClass = "voxel";
 declare const defaultWorldGeneratorWorkerProfile = "streaming";
+declare const worldGeneratorRepresentationBands: readonly WorldGeneratorRepresentationBand[];
+declare const worldGeneratorRepresentationOutputs: readonly WorldGeneratorRepresentationOutput[];
 declare const worldGeneratorWorkerProfiles: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerProfile>>;
 declare const worldGeneratorWorkerProfileNames: readonly WorldGeneratorWorkerProfileName[];
 declare const worldGeneratorWorkerManifests: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerManifest>>;
 declare function getWorldGeneratorWorkerProfile(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerProfile;
 declare function getWorldGeneratorWorkerManifest(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerManifest;
+declare function createWorldGeneratorRepresentationPlan(options: {
+    profile?: WorldGeneratorWorkerProfileName;
+    chunkId: string;
+    gameplayImportance?: WorldGeneratorWorkerImportance;
+}): WorldGeneratorRepresentationPlan;
 
-export { DEFAULT_TILE_SIZE_WORLD, FIELD_DOWNWARD_MAX, FIELD_UPWARD_MIN, FRACTAL_ASSET_VERSION, FRACTAL_SAMPLE_STRIDE, type FieldParams, type FieldSample, type FractalAsset, type FractalAssetPayload, type FractalMandelSettings, type FractalPrepassRunOptions, type FractalPrepassRunner, type HexCell, type HexLevelSpec, MacroBiome, type MacroBiomeId, MacroBiomeLabel, type MeshBuilder, type MeshBuilderOptions, type MeshGeomorph, MicroFeature, type MicroFeatureId, MicroFeatureLabel, type MixedForestLayer, type MixedForestOptions, type PerfMonitor, type PerfMonitorOptions, type PerfMonitorUpdate, SlopeBand, type SlopeBandId, SlopeBandLabel, SurfaceCover, type SurfaceCoverId, SurfaceCoverLabel, TILE_ASSET_VERSION, TerrainBiome, type TerrainBiomeId, TerrainBiomeLabel, type TerrainCell, type TerrainParams, type TileAsset, type TileAssetPayload, type TileBakeOutput, type TileBakeWriter, TileCache, type TileCacheEntry, type TileCacheOptions, type TileCacheStatus, type TileGenerator, type TileKey, type Vec3, type WorldGeneratorWorkerAuthority, type WorldGeneratorWorkerBudgetLevel, type WorldGeneratorWorkerBudgetLevelConfig, type WorldGeneratorWorkerDomain, type WorldGeneratorWorkerImportance, type WorldGeneratorWorkerManifest, type WorldGeneratorWorkerManifestJob, type WorldGeneratorWorkerProfile, type WorldGeneratorWorkerProfileName, type WorldGeneratorWorkerQueueClass, assetMatches, axialToWorld, bakeTileAsset, buildHexLevels, classifySlopeBand, computeNormal, createFractalPrepassRunner, createMeshBuilder, createPerfMonitor, defaultFieldParams, defaultFractalMandelSettings, defaultWorldGeneratorWorkerProfile, encodeTerrainParams, fieldWgslUrl, fractalPrepassWgslUrl, generateHexGrid, generateTemperateMixedForest, getWorldGeneratorWorkerManifest, getWorldGeneratorWorkerProfile, hexAreaFromSide, hexSideFromArea, loadFieldWgsl, loadFractalPrepassWgsl, loadTerrainWgsl, normalize, normalizeTileKey, packHexCells, parseFractalAsset, parseTileAssetBinary, parseTileAssetJson, resolveTileSizeWorld, sampleFieldStack, serializeFractalAsset, serializeTileAssetBinary, serializeTileAssetBinaryFromJson, serializeTileAssetJson, serializeTileAssetJsonFromBinary, shade, terrainWgslUrl, tileAssetFileStem, tileBoundsWorld, tileKeyFromWorldPosition, tileKeyToString, unpackTerrain, validateTileAssetPayload, worldGeneratorDebugOwner, worldGeneratorWorkerManifests, worldGeneratorWorkerProfileNames, worldGeneratorWorkerProfiles, worldGeneratorWorkerQueueClass };
+export { DEFAULT_TILE_SIZE_WORLD, FIELD_DOWNWARD_MAX, FIELD_UPWARD_MIN, FRACTAL_ASSET_VERSION, FRACTAL_SAMPLE_STRIDE, type FieldParams, type FieldSample, type FractalAsset, type FractalAssetPayload, type FractalMandelSettings, type FractalPrepassRunOptions, type FractalPrepassRunner, type HexCell, type HexLevelSpec, MacroBiome, type MacroBiomeId, MacroBiomeLabel, type MeshBuilder, type MeshBuilderOptions, type MeshGeomorph, MicroFeature, type MicroFeatureId, MicroFeatureLabel, type MixedForestLayer, type MixedForestOptions, type PerfMonitor, type PerfMonitorOptions, type PerfMonitorUpdate, SlopeBand, type SlopeBandId, SlopeBandLabel, SurfaceCover, type SurfaceCoverId, SurfaceCoverLabel, TILE_ASSET_VERSION, TerrainBiome, type TerrainBiomeId, TerrainBiomeLabel, type TerrainCell, type TerrainParams, type TileAsset, type TileAssetPayload, type TileBakeOutput, type TileBakeWriter, TileCache, type TileCacheEntry, type TileCacheOptions, type TileCacheStatus, type TileGenerator, type TileKey, type Vec3, type WorldGeneratorRepresentationBand, type WorldGeneratorRepresentationCadence, type WorldGeneratorRepresentationDescriptor, type WorldGeneratorRepresentationOutput, type WorldGeneratorRepresentationPlan, type WorldGeneratorRepresentationRtParticipation, type WorldGeneratorRepresentationShadowRelevance, type WorldGeneratorWorkerAuthority, type WorldGeneratorWorkerBudgetLevel, type WorldGeneratorWorkerBudgetLevelConfig, type WorldGeneratorWorkerDomain, type WorldGeneratorWorkerImportance, type WorldGeneratorWorkerManifest, type WorldGeneratorWorkerManifestJob, type WorldGeneratorWorkerProfile, type WorldGeneratorWorkerProfileName, type WorldGeneratorWorkerQueueClass, assetMatches, axialToWorld, bakeTileAsset, buildHexLevels, classifySlopeBand, computeNormal, createFractalPrepassRunner, createMeshBuilder, createPerfMonitor, createWorldGeneratorRepresentationPlan, defaultFieldParams, defaultFractalMandelSettings, defaultWorldGeneratorWorkerProfile, encodeTerrainParams, fieldWgslUrl, fractalPrepassWgslUrl, generateHexGrid, generateTemperateMixedForest, getWorldGeneratorWorkerManifest, getWorldGeneratorWorkerProfile, hexAreaFromSide, hexSideFromArea, loadFieldWgsl, loadFractalPrepassWgsl, loadTerrainWgsl, normalize, normalizeTileKey, packHexCells, parseFractalAsset, parseTileAssetBinary, parseTileAssetJson, resolveTileSizeWorld, sampleFieldStack, serializeFractalAsset, serializeTileAssetBinary, serializeTileAssetBinaryFromJson, serializeTileAssetJson, serializeTileAssetJsonFromBinary, shade, terrainWgslUrl, tileAssetFileStem, tileBoundsWorld, tileKeyFromWorldPosition, tileKeyToString, unpackTerrain, validateTileAssetPayload, worldGeneratorDebugOwner, worldGeneratorRepresentationBands, worldGeneratorRepresentationOutputs, worldGeneratorWorkerManifests, worldGeneratorWorkerProfileNames, worldGeneratorWorkerProfiles, worldGeneratorWorkerQueueClass };

package/dist/index.d.ts

@@ -449,6 +449,44 @@ type WorldGeneratorWorkerProfileName = "streaming" | "bake";
 type WorldGeneratorWorkerDomain = "geometry" | "textures" | "custom";
 type WorldGeneratorWorkerAuthority = "visual" | "non-authoritative-simulation" | "authoritative";
 type WorldGeneratorWorkerImportance = "medium" | "high" | "critical";
+type WorldGeneratorRepresentationBand = "near" | "mid" | "far" | "horizon";
+type WorldGeneratorRepresentationOutput = "liveGeometry" | "simplifiedGeometry" | "rtProxy" | "mergedProxy" | "horizonShell";
+type WorldGeneratorRepresentationRtParticipation = "full" | "selective" | "proxy" | "disabled";
+type WorldGeneratorRepresentationShadowRelevance = "ray-traced-primary" | "selective-raster" | "proxy-caster" | "baked-impression";
+interface WorldGeneratorRepresentationCadence {
+    readonly kind: "per-frame" | "interval";
+    readonly divisor: number;
+}
+interface WorldGeneratorRepresentationDescriptor {
+    readonly id: string;
+    readonly chunkId: string;
+    readonly profile: WorldGeneratorWorkerProfileName;
+    readonly band: WorldGeneratorRepresentationBand;
+    readonly output: WorldGeneratorRepresentationOutput;
+    readonly rasterMode: "full-live" | "simplified-live" | "proxy" | "not-rendered" | "horizon-shell";
+    readonly rtParticipation: WorldGeneratorRepresentationRtParticipation;
+    readonly shadowRelevance: WorldGeneratorRepresentationShadowRelevance;
+    readonly refreshCadence: WorldGeneratorRepresentationCadence;
+    readonly preservesChunkIdentity: boolean;
+    readonly sourceChunkIds: readonly string[];
+    readonly sourceJobKeys: readonly string[];
+    readonly suggestedAllocationIds: readonly string[];
+    readonly scheduling: Readonly<{
+        owner: "renderer";
+        queueClass: typeof worldGeneratorWorkerQueueClass;
+        priorityHint: number;
+        gameplayImportance: WorldGeneratorWorkerImportance;
+        representationBand: WorldGeneratorRepresentationBand;
+    }>;
+}
+interface WorldGeneratorRepresentationPlan {
+    readonly schemaVersion: 1;
+    readonly owner: typeof worldGeneratorDebugOwner;
+    readonly profile: WorldGeneratorWorkerProfileName;
+    readonly chunkId: string;
+    readonly representations: readonly WorldGeneratorRepresentationDescriptor[];
+    readonly bands: readonly WorldGeneratorRepresentationBand[];
+}
 interface WorldGeneratorWorkerBudgetLevelConfig {
     maxDispatchesPerFrame: number;
     maxJobsPerDispatch: number;
@@ -512,10 +550,17 @@ interface WorldGeneratorWorkerManifest {
 declare const worldGeneratorDebugOwner = "world-generator";
 declare const worldGeneratorWorkerQueueClass = "voxel";
 declare const defaultWorldGeneratorWorkerProfile = "streaming";
+declare const worldGeneratorRepresentationBands: readonly WorldGeneratorRepresentationBand[];
+declare const worldGeneratorRepresentationOutputs: readonly WorldGeneratorRepresentationOutput[];
 declare const worldGeneratorWorkerProfiles: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerProfile>>;
 declare const worldGeneratorWorkerProfileNames: readonly WorldGeneratorWorkerProfileName[];
 declare const worldGeneratorWorkerManifests: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerManifest>>;
 declare function getWorldGeneratorWorkerProfile(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerProfile;
 declare function getWorldGeneratorWorkerManifest(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerManifest;
+declare function createWorldGeneratorRepresentationPlan(options: {
+    profile?: WorldGeneratorWorkerProfileName;
+    chunkId: string;
+    gameplayImportance?: WorldGeneratorWorkerImportance;
+}): WorldGeneratorRepresentationPlan;
 
-export { DEFAULT_TILE_SIZE_WORLD, FIELD_DOWNWARD_MAX, FIELD_UPWARD_MIN, FRACTAL_ASSET_VERSION, FRACTAL_SAMPLE_STRIDE, type FieldParams, type FieldSample, type FractalAsset, type FractalAssetPayload, type FractalMandelSettings, type FractalPrepassRunOptions, type FractalPrepassRunner, type HexCell, type HexLevelSpec, MacroBiome, type MacroBiomeId, MacroBiomeLabel, type MeshBuilder, type MeshBuilderOptions, type MeshGeomorph, MicroFeature, type MicroFeatureId, MicroFeatureLabel, type MixedForestLayer, type MixedForestOptions, type PerfMonitor, type PerfMonitorOptions, type PerfMonitorUpdate, SlopeBand, type SlopeBandId, SlopeBandLabel, SurfaceCover, type SurfaceCoverId, SurfaceCoverLabel, TILE_ASSET_VERSION, TerrainBiome, type TerrainBiomeId, TerrainBiomeLabel, type TerrainCell, type TerrainParams, type TileAsset, type TileAssetPayload, type TileBakeOutput, type TileBakeWriter, TileCache, type TileCacheEntry, type TileCacheOptions, type TileCacheStatus, type TileGenerator, type TileKey, type Vec3, type WorldGeneratorWorkerAuthority, type WorldGeneratorWorkerBudgetLevel, type WorldGeneratorWorkerBudgetLevelConfig, type WorldGeneratorWorkerDomain, type WorldGeneratorWorkerImportance, type WorldGeneratorWorkerManifest, type WorldGeneratorWorkerManifestJob, type WorldGeneratorWorkerProfile, type WorldGeneratorWorkerProfileName, type WorldGeneratorWorkerQueueClass, assetMatches, axialToWorld, bakeTileAsset, buildHexLevels, classifySlopeBand, computeNormal, createFractalPrepassRunner, createMeshBuilder, createPerfMonitor, defaultFieldParams, defaultFractalMandelSettings, defaultWorldGeneratorWorkerProfile, encodeTerrainParams, fieldWgslUrl, fractalPrepassWgslUrl, generateHexGrid, generateTemperateMixedForest, getWorldGeneratorWorkerManifest, getWorldGeneratorWorkerProfile, hexAreaFromSide, hexSideFromArea, loadFieldWgsl, loadFractalPrepassWgsl, loadTerrainWgsl, normalize, normalizeTileKey, packHexCells, parseFractalAsset, parseTileAssetBinary, parseTileAssetJson, resolveTileSizeWorld, sampleFieldStack, serializeFractalAsset, serializeTileAssetBinary, serializeTileAssetBinaryFromJson, serializeTileAssetJson, serializeTileAssetJsonFromBinary, shade, terrainWgslUrl, tileAssetFileStem, tileBoundsWorld, tileKeyFromWorldPosition, tileKeyToString, unpackTerrain, validateTileAssetPayload, worldGeneratorDebugOwner, worldGeneratorWorkerManifests, worldGeneratorWorkerProfileNames, worldGeneratorWorkerProfiles, worldGeneratorWorkerQueueClass };
+export { DEFAULT_TILE_SIZE_WORLD, FIELD_DOWNWARD_MAX, FIELD_UPWARD_MIN, FRACTAL_ASSET_VERSION, FRACTAL_SAMPLE_STRIDE, type FieldParams, type FieldSample, type FractalAsset, type FractalAssetPayload, type FractalMandelSettings, type FractalPrepassRunOptions, type FractalPrepassRunner, type HexCell, type HexLevelSpec, MacroBiome, type MacroBiomeId, MacroBiomeLabel, type MeshBuilder, type MeshBuilderOptions, type MeshGeomorph, MicroFeature, type MicroFeatureId, MicroFeatureLabel, type MixedForestLayer, type MixedForestOptions, type PerfMonitor, type PerfMonitorOptions, type PerfMonitorUpdate, SlopeBand, type SlopeBandId, SlopeBandLabel, SurfaceCover, type SurfaceCoverId, SurfaceCoverLabel, TILE_ASSET_VERSION, TerrainBiome, type TerrainBiomeId, TerrainBiomeLabel, type TerrainCell, type TerrainParams, type TileAsset, type TileAssetPayload, type TileBakeOutput, type TileBakeWriter, TileCache, type TileCacheEntry, type TileCacheOptions, type TileCacheStatus, type TileGenerator, type TileKey, type Vec3, type WorldGeneratorRepresentationBand, type WorldGeneratorRepresentationCadence, type WorldGeneratorRepresentationDescriptor, type WorldGeneratorRepresentationOutput, type WorldGeneratorRepresentationPlan, type WorldGeneratorRepresentationRtParticipation, type WorldGeneratorRepresentationShadowRelevance, type WorldGeneratorWorkerAuthority, type WorldGeneratorWorkerBudgetLevel, type WorldGeneratorWorkerBudgetLevelConfig, type WorldGeneratorWorkerDomain, type WorldGeneratorWorkerImportance, type WorldGeneratorWorkerManifest, type WorldGeneratorWorkerManifestJob, type WorldGeneratorWorkerProfile, type WorldGeneratorWorkerProfileName, type WorldGeneratorWorkerQueueClass, assetMatches, axialToWorld, bakeTileAsset, buildHexLevels, classifySlopeBand, computeNormal, createFractalPrepassRunner, createMeshBuilder, createPerfMonitor, createWorldGeneratorRepresentationPlan, defaultFieldParams, defaultFractalMandelSettings, defaultWorldGeneratorWorkerProfile, encodeTerrainParams, fieldWgslUrl, fractalPrepassWgslUrl, generateHexGrid, generateTemperateMixedForest, getWorldGeneratorWorkerManifest, getWorldGeneratorWorkerProfile, hexAreaFromSide, hexSideFromArea, loadFieldWgsl, loadFractalPrepassWgsl, loadTerrainWgsl, normalize, normalizeTileKey, packHexCells, parseFractalAsset, parseTileAssetBinary, parseTileAssetJson, resolveTileSizeWorld, sampleFieldStack, serializeFractalAsset, serializeTileAssetBinary, serializeTileAssetBinaryFromJson, serializeTileAssetJson, serializeTileAssetJsonFromBinary, shade, terrainWgslUrl, tileAssetFileStem, tileBoundsWorld, tileKeyFromWorldPosition, tileKeyToString, unpackTerrain, validateTileAssetPayload, worldGeneratorDebugOwner, worldGeneratorRepresentationBands, worldGeneratorRepresentationOutputs, worldGeneratorWorkerManifests, worldGeneratorWorkerProfileNames, worldGeneratorWorkerProfiles, worldGeneratorWorkerQueueClass };

package/dist/index.js

@@ -1303,7 +1303,6 @@ function serializeTileAssetBinary(asset) {
   view.setUint32(cursor, materialStride >>> 0, true);
   cursor += 4;
   view.setUint32(cursor, featureStride >>> 0, true);
-  cursor += 4;
   let writeOffset = HEADER_BYTES;
   new Float32Array(buffer, writeOffset, heightCount).set(asset.height);
   writeOffset += heightBytes;
@@ -1368,7 +1367,6 @@ function parseTileAssetBinary(input) {
   const materialStride = view.getUint32(cursor, true);
   cursor += 4;
   const featureStride = view.getUint32(cursor, true);
-  cursor += 4;
   const heightBytes = heightCount * 4;
   const fieldBytes = fieldCount * 4;
   const materialBytes = materialCount;
@@ -1789,6 +1787,64 @@ function createMeshBuilder(sizeOrOptions = 1) {
 var worldGeneratorDebugOwner = "world-generator";
 var worldGeneratorWorkerQueueClass = "voxel";
 var defaultWorldGeneratorWorkerProfile = "streaming";
+var worldGeneratorRepresentationBands = Object.freeze([
+  "near",
+  "mid",
+  "far",
+  "horizon"
+]);
+var worldGeneratorRepresentationOutputs = Object.freeze([
+  "liveGeometry",
+  "simplifiedGeometry",
+  "rtProxy",
+  "mergedProxy",
+  "horizonShell"
+]);
+var worldGeneratorRepresentationBandPriorityHints = Object.freeze({
+  near: 400,
+  mid: 300,
+  far: 200,
+  horizon: 100
+});
+function assertWorldGeneratorIdentifier(name, value) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${name} must be a non-empty string.`);
+  }
+  return value.trim();
+}
+function normalizeWorldGeneratorImportance(name, value) {
+  if (value === "medium" || value === "high" || value === "critical") {
+    return value;
+  }
+  throw new Error(`${name} must be one of: medium, high, critical.`);
+}
+function buildWorldGeneratorRepresentationDescriptor(options) {
+  return Object.freeze({
+    id: `${options.chunkId}.${options.band}.${options.output}`,
+    chunkId: options.chunkId,
+    profile: options.profile,
+    band: options.band,
+    output: options.output,
+    rasterMode: options.rasterMode,
+    rtParticipation: options.rtParticipation,
+    shadowRelevance: options.shadowRelevance,
+    refreshCadence: Object.freeze({
+      kind: options.refreshCadence.kind,
+      divisor: options.refreshCadence.divisor
+    }),
+    preservesChunkIdentity: options.preservesChunkIdentity,
+    sourceChunkIds: Object.freeze([options.chunkId]),
+    sourceJobKeys: Object.freeze([...options.sourceJobKeys]),
+    suggestedAllocationIds: Object.freeze([...options.suggestedAllocationIds]),
+    scheduling: Object.freeze({
+      owner: "renderer",
+      queueClass: worldGeneratorWorkerQueueClass,
+      priorityHint: worldGeneratorRepresentationBandPriorityHints[options.band],
+      gameplayImportance: options.gameplayImportance,
+      representationBand: options.band
+    })
+  });
+}
 function buildBudgetLevels(jobType, queueClass, levels) {
   return Object.freeze(
     levels.map(
@@ -2369,6 +2425,108 @@ function getWorldGeneratorWorkerManifest(name = defaultWorldGeneratorWorkerProfi
   }
   return manifest;
 }
+function createWorldGeneratorRepresentationPlan(options) {
+  const profile = options.profile ?? defaultWorldGeneratorWorkerProfile;
+  const spec = worldGeneratorWorkerProfileSpecs[profile];
+  if (!spec) {
+    const available = worldGeneratorWorkerProfileNames.join(", ");
+    throw new Error(
+      `Unknown world-generator worker profile "${profile}". Available: ${available}.`
+    );
+  }
+  const chunkId = assertWorldGeneratorIdentifier("chunkId", options.chunkId);
+  const gameplayImportance = normalizeWorldGeneratorImportance(
+    "gameplayImportance",
+    options.gameplayImportance ?? "high"
+  );
+  const highValueAllocations = spec.suggestedAllocationIds;
+  const farFieldAllocations = spec.suggestedAllocationIds.filter(
+    (allocationId) => allocationId.includes("mesh") || allocationId.includes("asset") || allocationId.includes("tile")
+  );
+  const bakeSourceJobKeys = profile === "bake" ? ["meshBuild", "tileBake", "assetSerialize"] : ["meshBuild", "tileBake"];
+  const representations = Object.freeze([
+    buildWorldGeneratorRepresentationDescriptor({
+      profile,
+      chunkId,
+      band: "near",
+      output: "liveGeometry",
+      rasterMode: "full-live",
+      rtParticipation: "full",
+      shadowRelevance: "ray-traced-primary",
+      refreshCadence: { kind: "per-frame", divisor: 1 },
+      preservesChunkIdentity: true,
+      sourceJobKeys: ["meshBuild"],
+      gameplayImportance: gameplayImportance === "medium" ? "high" : gameplayImportance,
+      suggestedAllocationIds: highValueAllocations
+    }),
+    buildWorldGeneratorRepresentationDescriptor({
+      profile,
+      chunkId,
+      band: "mid",
+      output: "simplifiedGeometry",
+      rasterMode: "simplified-live",
+      rtParticipation: "selective",
+      shadowRelevance: "selective-raster",
+      refreshCadence: { kind: "interval", divisor: 2 },
+      preservesChunkIdentity: true,
+      sourceJobKeys: ["meshBuild"],
+      gameplayImportance,
+      suggestedAllocationIds: highValueAllocations
+    }),
+    buildWorldGeneratorRepresentationDescriptor({
+      profile,
+      chunkId,
+      band: "mid",
+      output: "rtProxy",
+      rasterMode: "not-rendered",
+      rtParticipation: "proxy",
+      shadowRelevance: "selective-raster",
+      refreshCadence: { kind: "interval", divisor: 2 },
+      preservesChunkIdentity: true,
+      sourceJobKeys: ["meshBuild", "tileBake"],
+      gameplayImportance,
+      suggestedAllocationIds: highValueAllocations
+    }),
+    buildWorldGeneratorRepresentationDescriptor({
+      profile,
+      chunkId,
+      band: "far",
+      output: "mergedProxy",
+      rasterMode: "proxy",
+      rtParticipation: "proxy",
+      shadowRelevance: "proxy-caster",
+      refreshCadence: { kind: "interval", divisor: 8 },
+      preservesChunkIdentity: true,
+      sourceJobKeys: bakeSourceJobKeys,
+      gameplayImportance: "medium",
+      suggestedAllocationIds: farFieldAllocations.length > 0 ? farFieldAllocations : highValueAllocations
+    }),
+    buildWorldGeneratorRepresentationDescriptor({
+      profile,
+      chunkId,
+      band: "horizon",
+      output: "horizonShell",
+      rasterMode: "horizon-shell",
+      rtParticipation: "disabled",
+      shadowRelevance: "baked-impression",
+      refreshCadence: { kind: "interval", divisor: 60 },
+      preservesChunkIdentity: true,
+      sourceJobKeys: profile === "bake" ? ["tileBake", "assetSerialize"] : ["tileBake"],
+      gameplayImportance: "medium",
+      suggestedAllocationIds: farFieldAllocations.length > 0 ? farFieldAllocations : highValueAllocations
+    })
+  ]);
+  return Object.freeze({
+    schemaVersion: 1,
+    owner: worldGeneratorDebugOwner,
+    profile,
+    chunkId,
+    representations,
+    bands: Object.freeze(
+      [...new Set(representations.map((representation) => representation.band))]
+    )
+  });
+}
 export {
   DEFAULT_TILE_SIZE_WORLD,
   FIELD_DOWNWARD_MAX,
@@ -2396,6 +2554,7 @@ export {
   createFractalPrepassRunner,
   createMeshBuilder,
   createPerfMonitor,
+  createWorldGeneratorRepresentationPlan,
   defaultFieldParams,
   defaultFractalMandelSettings,
   defaultWorldGeneratorWorkerProfile,
@@ -2433,6 +2592,8 @@ export {
   unpackTerrain,
   validateTileAssetPayload,
   worldGeneratorDebugOwner,
+  worldGeneratorRepresentationBands,
+  worldGeneratorRepresentationOutputs,
   worldGeneratorWorkerManifests,
   worldGeneratorWorkerProfileNames,
   worldGeneratorWorkerProfiles,