@plasius/gpu-world-generator 0.0.10 → 0.0.11
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/README.md +24 -0
- package/dist/index.cjs +603 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +75 -1
- package/dist/index.d.ts +75 -1
- package/dist/index.js +594 -1
- package/dist/index.js.map +1 -1
- package/docs/adrs/adr-0004-worker-dag-manifests-for-chunk-and-voxel-generation.md +37 -0
- package/docs/adrs/index.md +1 -0
- package/docs/design/worker-manifest-integration.md +42 -0
- package/docs/tdrs/index.md +3 -0
- package/docs/tdrs/tdr-0001-world-generator-worker-manifest-contract.md +39 -0
- package/package.json +6 -3
- package/src/index.ts +1 -0
- package/src/worker.ts +710 -0
package/dist/index.d.cts
CHANGED
|
@@ -444,4 +444,78 @@ declare function computeNormal(a: Vec3, b: Vec3, c: Vec3): Vec3;
|
|
|
444
444
|
declare function shade(color: Vec3, factor: number): Vec3;
|
|
445
445
|
declare function createMeshBuilder(sizeOrOptions?: number | MeshBuilderOptions): MeshBuilder;
|
|
446
446
|
|
|
447
|
-
|
|
447
|
+
type WorldGeneratorWorkerQueueClass = "voxel";
|
|
448
|
+
type WorldGeneratorWorkerProfileName = "streaming" | "bake";
|
|
449
|
+
type WorldGeneratorWorkerDomain = "geometry" | "textures" | "custom";
|
|
450
|
+
type WorldGeneratorWorkerAuthority = "visual" | "non-authoritative-simulation" | "authoritative";
|
|
451
|
+
type WorldGeneratorWorkerImportance = "medium" | "high" | "critical";
|
|
452
|
+
interface WorldGeneratorWorkerBudgetLevelConfig {
|
|
453
|
+
maxDispatchesPerFrame: number;
|
|
454
|
+
maxJobsPerDispatch: number;
|
|
455
|
+
cadenceDivisor: number;
|
|
456
|
+
workgroupScale: number;
|
|
457
|
+
maxQueueDepth: number;
|
|
458
|
+
metadata: Readonly<{
|
|
459
|
+
owner: typeof worldGeneratorDebugOwner;
|
|
460
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
461
|
+
jobType: string;
|
|
462
|
+
quality: string;
|
|
463
|
+
}>;
|
|
464
|
+
}
|
|
465
|
+
interface WorldGeneratorWorkerBudgetLevel {
|
|
466
|
+
id: string;
|
|
467
|
+
estimatedCostMs: number;
|
|
468
|
+
config: WorldGeneratorWorkerBudgetLevelConfig;
|
|
469
|
+
}
|
|
470
|
+
interface WorldGeneratorWorkerProfile {
|
|
471
|
+
readonly name: WorldGeneratorWorkerProfileName;
|
|
472
|
+
readonly description: string;
|
|
473
|
+
readonly jobs: readonly string[];
|
|
474
|
+
}
|
|
475
|
+
interface WorldGeneratorWorkerManifestJob {
|
|
476
|
+
readonly key: string;
|
|
477
|
+
readonly label: string;
|
|
478
|
+
readonly worker: Readonly<{
|
|
479
|
+
jobType: string;
|
|
480
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
481
|
+
priority: number;
|
|
482
|
+
dependencies: readonly string[];
|
|
483
|
+
schedulerMode: "dag";
|
|
484
|
+
}>;
|
|
485
|
+
readonly performance: Readonly<{
|
|
486
|
+
id: string;
|
|
487
|
+
jobType: string;
|
|
488
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
489
|
+
domain: WorldGeneratorWorkerDomain;
|
|
490
|
+
authority: WorldGeneratorWorkerAuthority;
|
|
491
|
+
importance: WorldGeneratorWorkerImportance;
|
|
492
|
+
levels: readonly WorldGeneratorWorkerBudgetLevel[];
|
|
493
|
+
}>;
|
|
494
|
+
readonly debug: Readonly<{
|
|
495
|
+
owner: typeof worldGeneratorDebugOwner;
|
|
496
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
497
|
+
jobType: string;
|
|
498
|
+
tags: readonly string[];
|
|
499
|
+
suggestedAllocationIds: readonly string[];
|
|
500
|
+
}>;
|
|
501
|
+
}
|
|
502
|
+
interface WorldGeneratorWorkerManifest {
|
|
503
|
+
readonly schemaVersion: 1;
|
|
504
|
+
readonly owner: typeof worldGeneratorDebugOwner;
|
|
505
|
+
readonly profile: WorldGeneratorWorkerProfileName;
|
|
506
|
+
readonly description: string;
|
|
507
|
+
readonly queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
508
|
+
readonly schedulerMode: "dag";
|
|
509
|
+
readonly suggestedAllocationIds: readonly string[];
|
|
510
|
+
readonly jobs: readonly WorldGeneratorWorkerManifestJob[];
|
|
511
|
+
}
|
|
512
|
+
declare const worldGeneratorDebugOwner = "world-generator";
|
|
513
|
+
declare const worldGeneratorWorkerQueueClass = "voxel";
|
|
514
|
+
declare const defaultWorldGeneratorWorkerProfile = "streaming";
|
|
515
|
+
declare const worldGeneratorWorkerProfiles: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerProfile>>;
|
|
516
|
+
declare const worldGeneratorWorkerProfileNames: readonly WorldGeneratorWorkerProfileName[];
|
|
517
|
+
declare const worldGeneratorWorkerManifests: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerManifest>>;
|
|
518
|
+
declare function getWorldGeneratorWorkerProfile(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerProfile;
|
|
519
|
+
declare function getWorldGeneratorWorkerManifest(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerManifest;
|
|
520
|
+
|
|
521
|
+
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 };
|
package/dist/index.d.ts
CHANGED
|
@@ -444,4 +444,78 @@ declare function computeNormal(a: Vec3, b: Vec3, c: Vec3): Vec3;
|
|
|
444
444
|
declare function shade(color: Vec3, factor: number): Vec3;
|
|
445
445
|
declare function createMeshBuilder(sizeOrOptions?: number | MeshBuilderOptions): MeshBuilder;
|
|
446
446
|
|
|
447
|
-
|
|
447
|
+
type WorldGeneratorWorkerQueueClass = "voxel";
|
|
448
|
+
type WorldGeneratorWorkerProfileName = "streaming" | "bake";
|
|
449
|
+
type WorldGeneratorWorkerDomain = "geometry" | "textures" | "custom";
|
|
450
|
+
type WorldGeneratorWorkerAuthority = "visual" | "non-authoritative-simulation" | "authoritative";
|
|
451
|
+
type WorldGeneratorWorkerImportance = "medium" | "high" | "critical";
|
|
452
|
+
interface WorldGeneratorWorkerBudgetLevelConfig {
|
|
453
|
+
maxDispatchesPerFrame: number;
|
|
454
|
+
maxJobsPerDispatch: number;
|
|
455
|
+
cadenceDivisor: number;
|
|
456
|
+
workgroupScale: number;
|
|
457
|
+
maxQueueDepth: number;
|
|
458
|
+
metadata: Readonly<{
|
|
459
|
+
owner: typeof worldGeneratorDebugOwner;
|
|
460
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
461
|
+
jobType: string;
|
|
462
|
+
quality: string;
|
|
463
|
+
}>;
|
|
464
|
+
}
|
|
465
|
+
interface WorldGeneratorWorkerBudgetLevel {
|
|
466
|
+
id: string;
|
|
467
|
+
estimatedCostMs: number;
|
|
468
|
+
config: WorldGeneratorWorkerBudgetLevelConfig;
|
|
469
|
+
}
|
|
470
|
+
interface WorldGeneratorWorkerProfile {
|
|
471
|
+
readonly name: WorldGeneratorWorkerProfileName;
|
|
472
|
+
readonly description: string;
|
|
473
|
+
readonly jobs: readonly string[];
|
|
474
|
+
}
|
|
475
|
+
interface WorldGeneratorWorkerManifestJob {
|
|
476
|
+
readonly key: string;
|
|
477
|
+
readonly label: string;
|
|
478
|
+
readonly worker: Readonly<{
|
|
479
|
+
jobType: string;
|
|
480
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
481
|
+
priority: number;
|
|
482
|
+
dependencies: readonly string[];
|
|
483
|
+
schedulerMode: "dag";
|
|
484
|
+
}>;
|
|
485
|
+
readonly performance: Readonly<{
|
|
486
|
+
id: string;
|
|
487
|
+
jobType: string;
|
|
488
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
489
|
+
domain: WorldGeneratorWorkerDomain;
|
|
490
|
+
authority: WorldGeneratorWorkerAuthority;
|
|
491
|
+
importance: WorldGeneratorWorkerImportance;
|
|
492
|
+
levels: readonly WorldGeneratorWorkerBudgetLevel[];
|
|
493
|
+
}>;
|
|
494
|
+
readonly debug: Readonly<{
|
|
495
|
+
owner: typeof worldGeneratorDebugOwner;
|
|
496
|
+
queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
497
|
+
jobType: string;
|
|
498
|
+
tags: readonly string[];
|
|
499
|
+
suggestedAllocationIds: readonly string[];
|
|
500
|
+
}>;
|
|
501
|
+
}
|
|
502
|
+
interface WorldGeneratorWorkerManifest {
|
|
503
|
+
readonly schemaVersion: 1;
|
|
504
|
+
readonly owner: typeof worldGeneratorDebugOwner;
|
|
505
|
+
readonly profile: WorldGeneratorWorkerProfileName;
|
|
506
|
+
readonly description: string;
|
|
507
|
+
readonly queueClass: typeof worldGeneratorWorkerQueueClass;
|
|
508
|
+
readonly schedulerMode: "dag";
|
|
509
|
+
readonly suggestedAllocationIds: readonly string[];
|
|
510
|
+
readonly jobs: readonly WorldGeneratorWorkerManifestJob[];
|
|
511
|
+
}
|
|
512
|
+
declare const worldGeneratorDebugOwner = "world-generator";
|
|
513
|
+
declare const worldGeneratorWorkerQueueClass = "voxel";
|
|
514
|
+
declare const defaultWorldGeneratorWorkerProfile = "streaming";
|
|
515
|
+
declare const worldGeneratorWorkerProfiles: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerProfile>>;
|
|
516
|
+
declare const worldGeneratorWorkerProfileNames: readonly WorldGeneratorWorkerProfileName[];
|
|
517
|
+
declare const worldGeneratorWorkerManifests: Readonly<Record<WorldGeneratorWorkerProfileName, WorldGeneratorWorkerManifest>>;
|
|
518
|
+
declare function getWorldGeneratorWorkerProfile(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerProfile;
|
|
519
|
+
declare function getWorldGeneratorWorkerManifest(name?: WorldGeneratorWorkerProfileName): WorldGeneratorWorkerManifest;
|
|
520
|
+
|
|
521
|
+
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 };
|