@certe/atmos-terrain 0.1.0

package/README.md

@@ -0,0 +1,155 @@
+# 🏔️ @certe/atmos-terrain
+
+Voxel-based terrain system for the Atmos Engine. Provides density field primitives, marching cubes surface extraction, multi-level LOD streaming, and optional splat texturing with 3-layer blending.
+
+---
+
+## 🔑 Key Concepts
+
+- **Density Field** — A function `(x, y, z) → number` where negative = solid, positive = air, surface at `isoLevel`
+- **Marching Cubes** — Polygonizes the density field into triangle meshes per chunk
+- **LOD Streaming** — `TerrainWorld` streams chunks around a camera with 3 LOD levels
+- **Splat Texturing** — Blend 3 terrain textures based on surface normal and height
+
+---
+
+## 🚀 Quick Start
+
+```ts
+import { TerrainWorld, noiseTerrain, registerTerrainBuiltins } from '@certe/atmos-terrain';
+import { perlinNoise3D } from '@certe/atmos-math';
+
+registerTerrainBuiltins();
+
+const terrain = gameObject.addComponent(TerrainWorld);
+terrain.setDensityFn(noiseTerrain(perlinNoise3D, 32, 0));
+terrain.init(device, pipelineResources, scene);
+terrain.cameraTarget = cameraGameObject;
+```
+
+---
+
+## 📖 API Overview
+
+### Density Primitives
+
+Build terrain shapes with CSG composition:
+
+```ts
+import { sphereDensity, planeDensity, boxDensity,
+         unionDensity, subtractDensity, noiseTerrain } from '@certe/atmos-terrain';
+
+const ground = planeDensity(0);
+const hill = sphereDensity(10, 0, 10, 8);
+const cave = sphereDensity(10, -2, 10, 4);
+
+const density = subtractDensity(unionDensity(ground, hill), cave);
+```
+
+| Function | Description |
+|---|---|
+| `sphereDensity(cx, cy, cz, r)` | SDF sphere |
+| `planeDensity(height)` | Half-space below Y |
+| `boxDensity(cx, cy, cz, hx, hy, hz)` | SDF box |
+| `unionDensity(a, b)` | CSG union |
+| `intersectDensity(a, b)` | CSG intersection |
+| `subtractDensity(a, b)` | CSG subtraction |
+| `noiseTerrain(noiseFn, amp, baseY)` | Noise-based heightmap |
+
+### TerrainWorld (Infinite Streaming)
+
+Streams chunks around a focus point with 3 LOD levels:
+
+| Property | Description |
+|---|---|
+| `loadRadius` / `unloadRadius` | Chunk-distance thresholds |
+| `maxBuildsPerFrame` / `buildBudgetMs` | Amortized build limits |
+| `cameraTarget` | GameObject to track for streaming |
+| `config` | `TerrainConfig` (chunkSize, voxelSize, smoothNormals) |
+| `lodConfig` | `LODConfig` with distance thresholds |
+
+| Method | Description |
+|---|---|
+| `setDensityFn(fn)` | Set the terrain density function |
+| `init(device, pipeline, scene)` | Initialize GPU context |
+| `setSplatMaterials(pipeline, textures, weightFn)` | Enable 3-layer splat blending |
+| `edit(op)` | Apply brush edit (sphere/cube) |
+
+LOD levels: **LOD 0** (step=1, near) → **LOD 1** (step=2, medium) → **LOD 2** (step=4, far)
+
+### TerrainVolume (Bounded Grid)
+
+Fixed N×M×P chunk grid for smaller terrains:
+
+```ts
+const volume = gameObject.addComponent(TerrainVolume);
+volume.chunksX = 4; volume.chunksY = 2; volume.chunksZ = 4;
+volume.setDensityFn(myDensity);
+volume.init(device, pipelineResources, scene);
+volume.build();
+```
+
+### Brush Editing
+
+```ts
+terrain.edit({
+  shape: 'sphere',
+  x: hitPoint[0], y: hitPoint[1], z: hitPoint[2],
+  radius: 3,
+  strength: -0.5,  // negative = add, positive = remove
+  falloff: 1,
+});
+```
+
+### Splat Texturing
+
+Blend 3 textures based on surface normal and world height:
+
+```ts
+terrain.setSplatMaterials(terrainPipeline, [grassTex, rockTex, snowTex],
+  (nx, ny, nz, worldY) => {
+    const slope = 1 - ny;
+    const snow = worldY > 20 ? 1 : 0;
+    return [1 - slope - snow, slope]; // [grass, rock], snow = remainder
+  }
+);
+```
+
+---
+
+## 🧠 Implementation Details
+
+- **Vertex format**: 8 floats (pos+normal+uv) standard, 10 floats (+ weights) for splat
+- **Skirt geometry**: Chunks extend 1 voxel past boundaries to hide LOD seams
+- **Pooled buffers**: Scratch vertex/index/density arrays reused across builds
+- **Deferred removal**: Old chunks kept 1 frame for smooth transitions
+- **Chunk keys**: 30-bit packed coordinates (10 bits per axis)
+
+---
+
+## 📁 Structure
+
+```
+packages/terrain/src/
+  index.ts              # Public API
+  types.ts              # TerrainConfig, DensityFn, ChunkCoord, etc.
+  density-field.ts      # Density primitives + CSG
+  marching-cubes.ts     # Full-resolution surface extraction
+  lod-extract.ts        # LOD-stepped marching cubes
+  terrain-normals.ts    # Gradient + triangle normal computation
+  chunk.ts              # TerrainChunk (density grid + mesh)
+  chunk-key.ts          # Coordinate packing utilities
+  lod-chunk.ts          # buildLODMesh / buildLODSplatMesh
+  terrain-world.ts      # TerrainWorld streaming component
+  terrain-volume.ts     # TerrainVolume bounded grid component
+  terrain-editor.ts     # Brush edit system
+  register-builtins.ts  # Component registry integration
+```
+
+---
+
+## 🔗 Dependencies
+
+- `@certe/atmos-core` — Component, GameObject, Scene
+- `@certe/atmos-math` — Noise functions for terrain generation
+- `@certe/atmos-renderer` — Mesh, Material, terrain pipeline, textures

package/dist/chunk-key.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bit-packs chunk coordinates into a single number for use as a Map key.
+ * Supports coordinates in the range [-511, 512] per axis (10 bits each).
+ */
+export declare function chunkKey(cx: number, cy: number, cz: number): number;
+/** Unpack a chunk key back into [cx, cy, cz]. */
+export declare function fromChunkKey(key: number): [number, number, number];
+/** Convert world position to chunk coordinates. */
+export declare function worldToChunk(wx: number, wy: number, wz: number, chunkWorldSize: number): [number, number, number];
+//# sourceMappingURL=chunk-key.d.ts.map

package/dist/chunk-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-key.d.ts","sourceRoot":"","sources":["../src/chunk-key.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAKlE;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAClC,cAAc,EAAE,MAAM,GACrB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM1B"}

package/dist/chunk-key.js

@@ -0,0 +1,27 @@
+/**
+ * Bit-packs chunk coordinates into a single number for use as a Map key.
+ * Supports coordinates in the range [-511, 512] per axis (10 bits each).
+ */
+export function chunkKey(cx, cy, cz) {
+    // Offset to make values positive, then mask to 10 bits
+    const x = (cx + 512) & 0x3FF;
+    const y = (cy + 512) & 0x3FF;
+    const z = (cz + 512) & 0x3FF;
+    return (x << 20) | (y << 10) | z;
+}
+/** Unpack a chunk key back into [cx, cy, cz]. */
+export function fromChunkKey(key) {
+    const x = ((key >>> 20) & 0x3FF) - 512;
+    const y = ((key >>> 10) & 0x3FF) - 512;
+    const z = (key & 0x3FF) - 512;
+    return [x, y, z];
+}
+/** Convert world position to chunk coordinates. */
+export function worldToChunk(wx, wy, wz, chunkWorldSize) {
+    return [
+        Math.floor(wx / chunkWorldSize),
+        Math.floor(wy / chunkWorldSize),
+        Math.floor(wz / chunkWorldSize),
+    ];
+}
+//# sourceMappingURL=chunk-key.js.map

package/dist/chunk-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-key.js","sourceRoot":"","sources":["../src/chunk-key.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU;IACzD,uDAAuD;IACvD,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAC1B,EAAU,EAAE,EAAU,EAAE,EAAU,EAClC,cAAsB;IAEtB,OAAO;QACL,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,cAAc,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,cAAc,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,cAAc,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/chunk.d.ts

@@ -0,0 +1,36 @@
+import type { Mesh } from '@certe/atmos-renderer';
+import type { DensityFn, TerrainConfig, MeshData } from './types.js';
+import { ChunkState } from './types.js';
+/**
+ * A single terrain chunk: owns a density grid, scratch buffers, and a GPU mesh.
+ */
+export declare class TerrainChunk {
+    readonly cx: number;
+    readonly cy: number;
+    readonly cz: number;
+    readonly densityGrid: Float32Array;
+    state: ChunkState;
+    mesh: Mesh | null;
+    lastMeshData: MeshData | null;
+    lodLevel: number;
+    skirtFaces: number;
+    private readonly _size;
+    private readonly _gridLen;
+    private _scratchVerts;
+    private _scratchIdx;
+    constructor(cx: number, cy: number, cz: number, size: number);
+    /** Fill the density grid by sampling the density function. */
+    sampleDensity(fn: DensityFn, voxelSize: number): void;
+    /**
+     * Run marching cubes + normals + UVs and create a GPU mesh.
+     * Returns the Mesh, or null if the chunk produced no geometry.
+     */
+    buildMesh(device: GPUDevice, config: TerrainConfig, densityFn?: DensityFn): Mesh | null;
+    /** Destroy the GPU mesh, keeping density data intact. */
+    destroyMesh(): void;
+    /** Release CPU-side scratch buffers (keeps GPU mesh alive). */
+    destroyCPU(): void;
+    /** Full cleanup: GPU + CPU resources. */
+    destroy(): void;
+}
+//# sourceMappingURL=chunk.d.ts.map

package/dist/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../src/chunk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAIlD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAcxC;;GAEG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC,KAAK,aAAoB;IACzB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAQ;IACzB,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAQ;IACrC,QAAQ,SAAK;IACb,UAAU,SAAK;IAEf,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,WAAW,CAA4B;gBAEnC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAS5D,8DAA8D;IAC9D,aAAa,CACX,EAAE,EAAE,SAAS,EACb,SAAS,EAAE,MAAM,GAChB,IAAI;IAoBP;;;OAGG;IACH,SAAS,CACP,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,SAAS,CAAC,EAAE,SAAS,GACpB,IAAI,GAAG,IAAI;IAmEd,yDAAyD;IACzD,WAAW,IAAI,IAAI;IAQnB,+DAA+D;IAC/D,UAAU,IAAI,IAAI;IAMlB,yCAAyC;IACzC,OAAO,IAAI,IAAI;CAIhB"}

package/dist/chunk.js

@@ -0,0 +1,128 @@
+import { createMesh } from '@certe/atmos-renderer';
+import { computeBoundingSphere, VERTEX_STRIDE_FLOATS } from '@certe/atmos-renderer';
+import { extractSurface, computeTriplanarUVs } from './marching-cubes.js';
+import { computeGradientNormals, computeTriangleNormals } from './terrain-normals.js';
+import { ChunkState } from './types.js';
+/**
+ * Maximum triangles per chunk (worst case: ~5 triangles per voxel).
+ * Used to pre-allocate scratch buffers.
+ */
+function maxTriangles(size) {
+    return size * size * size * 5;
+}
+function maxVertices(size) {
+    return maxTriangles(size) * 3;
+}
+/**
+ * A single terrain chunk: owns a density grid, scratch buffers, and a GPU mesh.
+ */
+export class TerrainChunk {
+    cx;
+    cy;
+    cz;
+    densityGrid;
+    state = ChunkState.Empty;
+    mesh = null;
+    lastMeshData = null;
+    lodLevel = 0;
+    skirtFaces = 0;
+    _size;
+    _gridLen;
+    _scratchVerts = null;
+    _scratchIdx = null;
+    constructor(cx, cy, cz, size) {
+        this.cx = cx;
+        this.cy = cy;
+        this.cz = cz;
+        this._size = size;
+        this._gridLen = (size + 1) ** 3;
+        this.densityGrid = new Float32Array(this._gridLen);
+    }
+    /** Fill the density grid by sampling the density function. */
+    sampleDensity(fn, voxelSize) {
+        const s = this._size;
+        const s1 = s + 1;
+        const originX = this.cx * s * voxelSize;
+        const originY = this.cy * s * voxelSize;
+        const originZ = this.cz * s * voxelSize;
+        for (let z = 0; z <= s; z++) {
+            for (let y = 0; y <= s; y++) {
+                for (let x = 0; x <= s; x++) {
+                    const wx = originX + x * voxelSize;
+                    const wy = originY + y * voxelSize;
+                    const wz = originZ + z * voxelSize;
+                    this.densityGrid[z * s1 * s1 + y * s1 + x] = fn(wx, wy, wz);
+                }
+            }
+        }
+        this.state = ChunkState.Sampled;
+    }
+    /**
+     * Run marching cubes + normals + UVs and create a GPU mesh.
+     * Returns the Mesh, or null if the chunk produced no geometry.
+     */
+    buildMesh(device, config, densityFn) {
+        const s = this._size;
+        // Lazy-allocate scratch buffers
+        if (!this._scratchVerts) {
+            this._scratchVerts = new Float32Array(maxVertices(s) * VERTEX_STRIDE_FLOATS);
+        }
+        if (!this._scratchIdx) {
+            this._scratchIdx = new Uint32Array(maxTriangles(s) * 3);
+        }
+        const meshData = extractSurface(this.densityGrid, s, config.voxelSize, config.isoLevel, this._scratchVerts, this._scratchIdx);
+        if (meshData.vertexCount === 0 || meshData.indexCount === 0) {
+            this.destroyMesh();
+            this.lastMeshData = null;
+            this.state = ChunkState.Meshed;
+            return null;
+        }
+        // Compute normals
+        if (config.smoothNormals && densityFn) {
+            const voxelSize = config.voxelSize;
+            const originX = this.cx * s * voxelSize;
+            const originY = this.cy * s * voxelSize;
+            const originZ = this.cz * s * voxelSize;
+            // Offset density function to chunk-local coords → world coords
+            const worldDensity = (x, y, z) => densityFn(x + originX, y + originY, z + originZ);
+            computeGradientNormals(meshData.vertices, meshData.vertexCount, worldDensity, config.normalEpsilon);
+        }
+        else {
+            computeTriangleNormals(meshData.vertices, meshData.indices, meshData.vertexCount, meshData.indexCount);
+        }
+        // Compute triplanar UVs after normals are ready
+        computeTriplanarUVs(meshData.vertices, meshData.vertexCount);
+        // Trim to actual size for GPU upload
+        const trimmedVerts = meshData.vertices.subarray(0, meshData.vertexCount * VERTEX_STRIDE_FLOATS);
+        const trimmedIdx = meshData.indices.subarray(0, meshData.indexCount);
+        // Detach old mesh reference (caller is responsible for destroying old
+        // GPU buffers via MeshRenderer.destroyMesh() after submit completes).
+        this.mesh = null;
+        const gpuMesh = createMesh(device, trimmedVerts, trimmedIdx, VERTEX_STRIDE_FLOATS);
+        gpuMesh.bounds = computeBoundingSphere(trimmedVerts, VERTEX_STRIDE_FLOATS);
+        this.mesh = gpuMesh;
+        this.lastMeshData = meshData;
+        this.state = ChunkState.Meshed;
+        return gpuMesh;
+    }
+    /** Destroy the GPU mesh, keeping density data intact. */
+    destroyMesh() {
+        if (this.mesh) {
+            this.mesh.vertexBuffer.destroy();
+            this.mesh.indexBuffer.destroy();
+            this.mesh = null;
+        }
+    }
+    /** Release CPU-side scratch buffers (keeps GPU mesh alive). */
+    destroyCPU() {
+        this._scratchVerts = null;
+        this._scratchIdx = null;
+        this.lastMeshData = null;
+    }
+    /** Full cleanup: GPU + CPU resources. */
+    destroy() {
+        this.destroyMesh();
+        this.destroyCPU();
+    }
+}
+//# sourceMappingURL=chunk.js.map

package/dist/chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../src/chunk.ts"],"names":[],"mappings":"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"}

package/dist/density-field.d.ts

@@ -0,0 +1,34 @@
+import type { DensityFn, DensityWithWeightsFn } from './types.js';
+/** Adapt a simple DensityFn to DensityWithWeightsFn (no weights). */
+export declare function adaptDensityFn(fn: DensityFn): DensityWithWeightsFn;
+/**
+ * Signed distance field for a sphere.
+ * Negative inside, positive outside (solid inside).
+ * Returns a DensityFn where negative = solid.
+ */
+export declare function sphereDensity(cx: number, cy: number, cz: number, radius: number): DensityFn;
+/**
+ * Half-space density: solid below the plane at y = height.
+ * Returns negative (solid) when y < height, positive (air) when y > height.
+ */
+export declare function planeDensity(height: number): DensityFn;
+/**
+ * Axis-aligned box density. Solid inside the box.
+ * @param cx,cy,cz Center of the box
+ * @param hx,hy,hz Half-extents
+ */
+export declare function boxDensity(cx: number, cy: number, cz: number, hx: number, hy: number, hz: number): DensityFn;
+/** Union: solid where either A or B is solid (min of two SDFs). */
+export declare function unionDensity(a: DensityFn, b: DensityFn): DensityFn;
+/** Intersection: solid where both A and B are solid (max of two SDFs). */
+export declare function intersectDensity(a: DensityFn, b: DensityFn): DensityFn;
+/** Subtraction: solid where A is solid but B is not (A minus B). */
+export declare function subtractDensity(a: DensityFn, b: DensityFn): DensityFn;
+/**
+ * Noise-based terrain: creates a heightmap-style density using an external noise function.
+ * @param noiseFn 2D noise function (x, z) => value in [-1, 1]
+ * @param amplitude Height amplitude of the noise
+ * @param baseHeight Base terrain height (y)
+ */
+export declare function noiseTerrain(noiseFn: (x: number, z: number) => number, amplitude: number, baseHeight: number): DensityFn;
+//# sourceMappingURL=density-field.d.ts.map

package/dist/density-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"density-field.d.ts","sourceRoot":"","sources":["../src/density-field.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElE,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,oBAAoB,CAElE;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAClC,MAAM,EAAE,MAAM,GACb,SAAS,CAOX;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAClC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GACjC,SAAS,CAYX;AAID,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,CAElE;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,CAEtE;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,EACzC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,SAAS,CAKX"}

package/dist/density-field.js

@@ -0,0 +1,68 @@
+/** Adapt a simple DensityFn to DensityWithWeightsFn (no weights). */
+export function adaptDensityFn(fn) {
+    return (x, y, z) => ({ density: fn(x, y, z) });
+}
+// --- Primitives ---
+// Convention: positive = air, negative = solid, surface at 0
+/**
+ * Signed distance field for a sphere.
+ * Negative inside, positive outside (solid inside).
+ * Returns a DensityFn where negative = solid.
+ */
+export function sphereDensity(cx, cy, cz, radius) {
+    return (x, y, z) => {
+        const dx = x - cx;
+        const dy = y - cy;
+        const dz = z - cz;
+        return Math.sqrt(dx * dx + dy * dy + dz * dz) - radius;
+    };
+}
+/**
+ * Half-space density: solid below the plane at y = height.
+ * Returns negative (solid) when y < height, positive (air) when y > height.
+ */
+export function planeDensity(height) {
+    return (_x, y, _z) => y - height;
+}
+/**
+ * Axis-aligned box density. Solid inside the box.
+ * @param cx,cy,cz Center of the box
+ * @param hx,hy,hz Half-extents
+ */
+export function boxDensity(cx, cy, cz, hx, hy, hz) {
+    return (x, y, z) => {
+        const dx = Math.abs(x - cx) - hx;
+        const dy = Math.abs(y - cy) - hy;
+        const dz = Math.abs(z - cz) - hz;
+        // Exact SDF for an AABB
+        const outsideDist = Math.sqrt(Math.max(dx, 0) ** 2 + Math.max(dy, 0) ** 2 + Math.max(dz, 0) ** 2);
+        const insideDist = Math.min(Math.max(dx, dy, dz), 0);
+        return outsideDist + insideDist;
+    };
+}
+// --- CSG Combinators ---
+/** Union: solid where either A or B is solid (min of two SDFs). */
+export function unionDensity(a, b) {
+    return (x, y, z) => Math.min(a(x, y, z), b(x, y, z));
+}
+/** Intersection: solid where both A and B are solid (max of two SDFs). */
+export function intersectDensity(a, b) {
+    return (x, y, z) => Math.max(a(x, y, z), b(x, y, z));
+}
+/** Subtraction: solid where A is solid but B is not (A minus B). */
+export function subtractDensity(a, b) {
+    return (x, y, z) => Math.max(a(x, y, z), -b(x, y, z));
+}
+/**
+ * Noise-based terrain: creates a heightmap-style density using an external noise function.
+ * @param noiseFn 2D noise function (x, z) => value in [-1, 1]
+ * @param amplitude Height amplitude of the noise
+ * @param baseHeight Base terrain height (y)
+ */
+export function noiseTerrain(noiseFn, amplitude, baseHeight) {
+    return (x, y, z) => {
+        const terrainHeight = baseHeight + noiseFn(x, z) * amplitude;
+        return y - terrainHeight;
+    };
+}
+//# sourceMappingURL=density-field.js.map

package/dist/density-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"density-field.js","sourceRoot":"","sources":["../src/density-field.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export type { DensityFn, DensityWithWeightsFn, DensitySample, SplatWeightFn, SplatTextures } from './types.js';
+export type { ChunkCoord, TerrainConfig, MeshData, TerrainEdit, LODConfig } from './types.js';
+export { BrushShape, ChunkState, DEFAULT_TERRAIN_CONFIG, DEFAULT_LOD_CONFIG } from './types.js';
+export { chunkKey, fromChunkKey, worldToChunk } from './chunk-key.js';
+export { extractSurface, computeTriplanarUVs } from './marching-cubes.js';
+export { computeGradientNormals, computeTriangleNormals } from './terrain-normals.js';
+export { adaptDensityFn, sphereDensity, planeDensity, boxDensity, unionDensity, intersectDensity, subtractDensity, noiseTerrain, } from './density-field.js';
+export { TerrainChunk } from './chunk.js';
+export { applyEdit } from './terrain-editor.js';
+export { extractSurfaceLOD } from './lod-extract.js';
+export { buildLODMesh, buildLODSplatMesh } from './lod-chunk.js';
+export { TerrainVolume } from './terrain-volume.js';
+export { TerrainWorld } from './terrain-world.js';
+export { registerTerrainBuiltins } from './register-builtins.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/G,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1E,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAGtF,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+export { BrushShape, ChunkState, DEFAULT_TERRAIN_CONFIG, DEFAULT_LOD_CONFIG } from './types.js';
+// Chunk key utilities
+export { chunkKey, fromChunkKey, worldToChunk } from './chunk-key.js';
+// Marching cubes
+export { extractSurface, computeTriplanarUVs } from './marching-cubes.js';
+// Normals
+export { computeGradientNormals, computeTriangleNormals } from './terrain-normals.js';
+// Density primitives & CSG
+export { adaptDensityFn, sphereDensity, planeDensity, boxDensity, unionDensity, intersectDensity, subtractDensity, noiseTerrain, } from './density-field.js';
+// Chunk
+export { TerrainChunk } from './chunk.js';
+// Editor (brush system)
+export { applyEdit } from './terrain-editor.js';
+// LOD
+export { extractSurfaceLOD } from './lod-extract.js';
+export { buildLODMesh, buildLODSplatMesh } from './lod-chunk.js';
+// Components
+export { TerrainVolume } from './terrain-volume.js';
+export { TerrainWorld } from './terrain-world.js';
+// Registration
+export { registerTerrainBuiltins } from './register-builtins.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhG,sBAAsB;AACtB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtE,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,UAAU;AACV,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,2BAA2B;AAC3B,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM;AACN,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEjE,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,eAAe;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lod-chunk.d.ts

@@ -0,0 +1,20 @@
+import type { Mesh } from '@certe/atmos-renderer';
+import type { TerrainChunk } from './chunk.js';
+import type { DensityFn, TerrainConfig, SplatWeightFn } from './types.js';
+/**
+ * Build a mesh at the given LOD level with grid overlap
+ * to hide cracks at LOD transitions.
+ *
+ * When `skirtFaces` is non-zero and `densityFn` is provided, the MC grid
+ * is extended by 1 cell (step voxels) past each boundary. The resulting
+ * mesh naturally overlaps with neighbors and the depth buffer hides seams.
+ * No extra skirt geometry — just real terrain surface past the boundary.
+ */
+export declare function buildLODMesh(chunk: TerrainChunk, device: GPUDevice, config: TerrainConfig, lodLevel: number, skirtFaces: number, densityFn?: DensityFn): Mesh | null;
+/**
+ * Build a terrain mesh with splat weights (10-float stride).
+ * Runs the normal 8-float mesh build, then repacks into 10-float stride
+ * adding splat weights computed from surface normal + world height.
+ */
+export declare function buildLODSplatMesh(chunk: TerrainChunk, device: GPUDevice, config: TerrainConfig, lodLevel: number, skirtFaces: number, densityFn: DensityFn, weightFn: SplatWeightFn): Mesh | null;
+//# sourceMappingURL=lod-chunk.d.ts.map

package/dist/lod-chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lod-chunk.d.ts","sourceRoot":"","sources":["../src/lod-chunk.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAIlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkG1E;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,SAAS,GACpB,IAAI,GAAG,IAAI,CA0Gb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,aAAa,GACtB,IAAI,GAAG,IAAI,CAwGb"}