@certe/atmos-terrain 0.1.0

package/dist/marching-cubes.js

@@ -0,0 +1,200 @@
+import { EDGE_TABLE, TRI_TABLE, CORNER_OFFSETS, EDGE_CORNERS } from './marching-cubes-tables.js';
+/** Stride in floats: pos(3) + normal(3) + uv(2) */
+const STRIDE = 8;
+/**
+ * Extract an isosurface from a flat density grid using marching cubes.
+ *
+ * @param densityGrid Flat Float32Array of (size+1)^3 density values,
+ *   indexed as z*(s+1)*(s+1) + y*(s+1) + x. Positive = air, negative = solid.
+ * @param size Number of voxels per axis (grid has size+1 samples per axis).
+ * @param voxelSize World-space size of each voxel.
+ * @param isoLevel Density threshold (default 0).
+ * @param outVertices Pre-allocated vertex buffer (caller-owned).
+ * @param outIndices Pre-allocated index buffer (caller-owned).
+ * @returns MeshData with counts; vertices have placeholder normals (0,1,0) and triplanar UVs.
+ */
+export function extractSurface(densityGrid, size, voxelSize, isoLevel, outVertices, outIndices) {
+    const s1 = size + 1;
+    const s1s1 = s1 * s1;
+    // Edge vertex caches: one index per edge in each direction.
+    // X-edges: size edges per row, s1 rows per slice, s1 slices = size * s1 * s1
+    // Y-edges: s1 * size * s1
+    // Z-edges: s1 * s1 * size
+    const xEdge = new Int32Array(size * s1 * s1).fill(-1);
+    const yEdge = new Int32Array(s1 * size * s1).fill(-1);
+    const zEdge = new Int32Array(s1 * s1 * size).fill(-1);
+    let vertCount = 0;
+    let idxCount = 0;
+    // Scratch for 8 corner densities and 12 edge vertex indices
+    const cornerDensity = new Float32Array(8);
+    const edgeVerts = new Int32Array(12);
+    for (let z = 0; z < size; z++) {
+        for (let y = 0; y < size; y++) {
+            for (let x = 0; x < size; x++) {
+                // Gather 8 corner densities
+                let cubeIndex = 0;
+                for (let c = 0; c < 8; c++) {
+                    const co = CORNER_OFFSETS[c];
+                    const gx = x + co[0];
+                    const gy = y + co[1];
+                    const gz = z + co[2];
+                    const d = densityGrid[gz * s1s1 + gy * s1 + gx];
+                    cornerDensity[c] = d;
+                    if (d < isoLevel)
+                        cubeIndex |= (1 << c);
+                }
+                const edgeBits = EDGE_TABLE[cubeIndex];
+                if (edgeBits === 0)
+                    continue;
+                // For each active edge, compute or retrieve the interpolated vertex
+                for (let e = 0; e < 12; e++) {
+                    if ((edgeBits & (1 << e)) === 0) {
+                        edgeVerts[e] = -1;
+                        continue;
+                    }
+                    const ec = EDGE_CORNERS[e];
+                    const c0 = ec[0];
+                    const c1 = ec[1];
+                    // Look up in directional cache
+                    const cached = getCachedEdge(e, x, y, z, s1, size, xEdge, yEdge, zEdge);
+                    if (cached >= 0) {
+                        edgeVerts[e] = cached;
+                        continue;
+                    }
+                    // Interpolate
+                    const d0 = cornerDensity[c0];
+                    const d1 = cornerDensity[c1];
+                    const denom = d0 - d1;
+                    const t = Math.abs(denom) < 1e-10 ? 0.5 : (d0 - isoLevel) / denom;
+                    const co0 = CORNER_OFFSETS[c0];
+                    const co1 = CORNER_OFFSETS[c1];
+                    const px = (x + co0[0] + t * (co1[0] - co0[0])) * voxelSize;
+                    const py = (y + co0[1] + t * (co1[1] - co0[1])) * voxelSize;
+                    const pz = (z + co0[2] + t * (co1[2] - co0[2])) * voxelSize;
+                    // Triplanar UVs (will be replaced by normals pass, using dominant axis)
+                    const o = vertCount * STRIDE;
+                    outVertices[o] = px;
+                    outVertices[o + 1] = py;
+                    outVertices[o + 2] = pz;
+                    // Placeholder normal (0, 1, 0) — replaced by terrain-normals pass
+                    outVertices[o + 3] = 0;
+                    outVertices[o + 4] = 1;
+                    outVertices[o + 5] = 0;
+                    // Triplanar UV placeholder (will be computed after normals)
+                    outVertices[o + 6] = 0;
+                    outVertices[o + 7] = 0;
+                    edgeVerts[e] = vertCount;
+                    setCachedEdge(e, x, y, z, s1, size, xEdge, yEdge, zEdge, vertCount);
+                    vertCount++;
+                }
+                // Emit triangles
+                const triBase = cubeIndex * 16;
+                for (let t = 0; t < 15; t += 3) {
+                    const e0 = TRI_TABLE[triBase + t];
+                    if (e0 === -1)
+                        break;
+                    const e1 = TRI_TABLE[triBase + t + 1];
+                    const e2 = TRI_TABLE[triBase + t + 2];
+                    outIndices[idxCount++] = edgeVerts[e0];
+                    outIndices[idxCount++] = edgeVerts[e1];
+                    outIndices[idxCount++] = edgeVerts[e2];
+                }
+            }
+        }
+    }
+    return {
+        vertices: outVertices,
+        indices: outIndices,
+        vertexCount: vertCount,
+        indexCount: idxCount,
+    };
+}
+/** Compute triplanar UVs for vertices based on their normals. */
+export function computeTriplanarUVs(vertices, vertexCount, uvScale = 1) {
+    for (let i = 0; i < vertexCount; i++) {
+        const o = i * STRIDE;
+        const px = vertices[o];
+        const py = vertices[o + 1];
+        const pz = vertices[o + 2];
+        const nx = Math.abs(vertices[o + 3]);
+        const ny = Math.abs(vertices[o + 4]);
+        const nz = Math.abs(vertices[o + 5]);
+        // Choose dominant axis for UV projection
+        if (nx >= ny && nx >= nz) {
+            // X-dominant: project onto YZ
+            vertices[o + 6] = pz * uvScale;
+            vertices[o + 7] = py * uvScale;
+        }
+        else if (ny >= nz) {
+            // Y-dominant: project onto XZ
+            vertices[o + 6] = px * uvScale;
+            vertices[o + 7] = pz * uvScale;
+        }
+        else {
+            // Z-dominant: project onto XY
+            vertices[o + 6] = px * uvScale;
+            vertices[o + 7] = py * uvScale;
+        }
+    }
+}
+// --- Edge cache helpers ---
+// Edges are categorized by direction:
+// Edges 0,2,4,6 → X direction (along x-axis)
+// Edges 8,9,10,11 → Y direction (along y-axis)
+// Edges 1,3,5,7 → Z direction (along z-axis)
+// (Derived from which axis differs between the two corners.)
+function edgeDirection(e) {
+    // X-edges: 0(0→1), 2(3→2), 4(4→5), 6(7→6) — x changes
+    // Z-edges: 1(1→2), 3(0→3), 5(5→6), 7(4→7) — z changes
+    // Y-edges: 8(0→4), 9(1→5), 10(2→6), 11(3→7) — y changes
+    if (e === 0 || e === 2 || e === 4 || e === 6)
+        return 0; // X
+    if (e === 1 || e === 3 || e === 5 || e === 7)
+        return 2; // Z
+    return 1; // Y (8,9,10,11)
+}
+/**
+ * Return the canonical grid origin of an edge: the endpoint with the
+ * smaller coordinate value along the edge's direction.
+ * This ensures two adjacent cubes sharing the same physical edge
+ * always compute the same cache key.
+ */
+function edgeOrigin(e, x, y, z) {
+    const ec = EDGE_CORNERS[e];
+    const co0 = CORNER_OFFSETS[ec[0]];
+    const co1 = CORNER_OFFSETS[ec[1]];
+    const dir = edgeDirection(e);
+    // Pick the corner with the lower value along the edge direction
+    const co = co0[dir] <= co1[dir] ? co0 : co1;
+    return [x + co[0], y + co[1], z + co[2]];
+}
+function getCachedEdge(e, x, y, z, s1, size, xEdge, yEdge, zEdge) {
+    const [ox, oy, oz] = edgeOrigin(e, x, y, z);
+    const dir = edgeDirection(e);
+    if (dir === 0) {
+        // X-edge: index = oz * s1 * size + oy * size + ox
+        return xEdge[oz * s1 * size + oy * size + ox];
+    }
+    else if (dir === 1) {
+        // Y-edge: index = oz * s1 * s1 + oy * s1 + ox  (but oy ranges [0..size-1])
+        return yEdge[oz * size * s1 + oy * s1 + ox];
+    }
+    else {
+        // Z-edge: index = oz * s1 * s1 + oy * s1 + ox
+        return zEdge[oz * s1 * s1 + oy * s1 + ox];
+    }
+}
+function setCachedEdge(e, x, y, z, s1, size, xEdge, yEdge, zEdge, vertexIndex) {
+    const [ox, oy, oz] = edgeOrigin(e, x, y, z);
+    const dir = edgeDirection(e);
+    if (dir === 0) {
+        xEdge[oz * s1 * size + oy * size + ox] = vertexIndex;
+    }
+    else if (dir === 1) {
+        yEdge[oz * size * s1 + oy * s1 + ox] = vertexIndex;
+    }
+    else {
+        zEdge[oz * s1 * s1 + oy * s1 + ox] = vertexIndex;
+    }
+}
+//# sourceMappingURL=marching-cubes.js.map

package/dist/marching-cubes.js.map

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

package/dist/register-builtins.d.ts

@@ -0,0 +1,2 @@
+export declare function registerTerrainBuiltins(): void;
+//# sourceMappingURL=register-builtins.d.ts.map

package/dist/register-builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-builtins.d.ts","sourceRoot":"","sources":["../src/register-builtins.ts"],"names":[],"mappings":"AAIA,wBAAgB,uBAAuB,IAAI,IAAI,CA8B9C"}

package/dist/register-builtins.js

@@ -0,0 +1,34 @@
+import { registerComponent } from '@certe/atmos-core';
+import { TerrainVolume } from './terrain-volume.js';
+import { TerrainWorld } from './terrain-world.js';
+export function registerTerrainBuiltins() {
+    registerComponent(TerrainVolume, {
+        name: 'TerrainVolume',
+        properties: [
+            { key: 'chunksX', type: 'number', min: 1, max: 32, step: 1 },
+            { key: 'chunksY', type: 'number', min: 1, max: 32, step: 1 },
+            { key: 'chunksZ', type: 'number', min: 1, max: 32, step: 1 },
+            { key: 'config.chunkSize', type: 'number', min: 4, max: 64, step: 1 },
+            { key: 'config.voxelSize', type: 'number', min: 0.1, max: 10, step: 0.1 },
+            { key: 'config.isoLevel', type: 'number', min: -10, max: 10, step: 0.01 },
+            { key: 'config.smoothNormals', type: 'boolean' },
+        ],
+    });
+    registerComponent(TerrainWorld, {
+        name: 'TerrainWorld',
+        properties: [
+            { key: 'loadRadius', type: 'number', min: 1, max: 16, step: 1 },
+            { key: 'unloadRadius', type: 'number', min: 2, max: 24, step: 1 },
+            { key: 'maxBuildsPerFrame', type: 'number', min: 1, max: 16, step: 1 },
+            { key: 'buildBudgetMs', type: 'number', min: 1, max: 32, step: 1 },
+            { key: 'config.chunkSize', type: 'number', min: 4, max: 64, step: 1 },
+            { key: 'config.voxelSize', type: 'number', min: 0.1, max: 10, step: 0.1 },
+            { key: 'config.isoLevel', type: 'number', min: -10, max: 10, step: 0.01 },
+            { key: 'config.smoothNormals', type: 'boolean' },
+            { key: 'cameraTarget', type: 'gameObjectRef' },
+            { key: 'lodConfig.lodDistances.0', type: 'number', min: 1, max: 16, step: 1 },
+            { key: 'lodConfig.lodDistances.1', type: 'number', min: 2, max: 24, step: 1 },
+        ],
+    });
+}
+//# sourceMappingURL=register-builtins.js.map

package/dist/register-builtins.js.map

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

package/dist/terrain-editor.d.ts

@@ -0,0 +1,15 @@
+import type { TerrainChunk } from './chunk.js';
+import type { TerrainEdit } from './types.js';
+/**
+ * Apply a terrain edit to a set of chunks.
+ * Modifies density grid values in affected chunks and returns
+ * the set of dirty chunk keys that need re-meshing.
+ *
+ * @param edit The edit operation to apply
+ * @param chunks Map of chunk key → TerrainChunk
+ * @param chunkSize Voxels per chunk axis
+ * @param voxelSize World-space size of each voxel
+ * @returns Set of chunk keys whose density grids were modified
+ */
+export declare function applyEdit(edit: TerrainEdit, chunks: Map<number, TerrainChunk>, chunkSize: number, voxelSize: number): Set<number>;
+//# sourceMappingURL=terrain-editor.d.ts.map

package/dist/terrain-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-editor.d.ts","sourceRoot":"","sources":["../src/terrain-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,GAAG,CAAC,MAAM,CAAC,CAmDb"}

package/dist/terrain-editor.js

@@ -0,0 +1,85 @@
+import { chunkKey } from './chunk-key.js';
+import { BrushShape } from './types.js';
+/**
+ * Apply a terrain edit to a set of chunks.
+ * Modifies density grid values in affected chunks and returns
+ * the set of dirty chunk keys that need re-meshing.
+ *
+ * @param edit The edit operation to apply
+ * @param chunks Map of chunk key → TerrainChunk
+ * @param chunkSize Voxels per chunk axis
+ * @param voxelSize World-space size of each voxel
+ * @returns Set of chunk keys whose density grids were modified
+ */
+export function applyEdit(edit, chunks, chunkSize, voxelSize) {
+    const dirty = new Set();
+    const chunkWorldSize = chunkSize * voxelSize;
+    const s1 = chunkSize + 1;
+    const s1s1 = s1 * s1;
+    // Determine which chunks the brush can affect
+    const minCX = Math.floor((edit.x - edit.radius) / chunkWorldSize);
+    const maxCX = Math.floor((edit.x + edit.radius) / chunkWorldSize);
+    const minCY = Math.floor((edit.y - edit.radius) / chunkWorldSize);
+    const maxCY = Math.floor((edit.y + edit.radius) / chunkWorldSize);
+    const minCZ = Math.floor((edit.z - edit.radius) / chunkWorldSize);
+    const maxCZ = Math.floor((edit.z + edit.radius) / chunkWorldSize);
+    for (let cz = minCZ; cz <= maxCZ; cz++) {
+        for (let cy = minCY; cy <= maxCY; cy++) {
+            for (let cx = minCX; cx <= maxCX; cx++) {
+                const key = chunkKey(cx, cy, cz);
+                const chunk = chunks.get(key);
+                if (!chunk)
+                    continue;
+                const originX = cx * chunkWorldSize;
+                const originY = cy * chunkWorldSize;
+                const originZ = cz * chunkWorldSize;
+                let modified = false;
+                for (let z = 0; z <= chunkSize; z++) {
+                    for (let y = 0; y <= chunkSize; y++) {
+                        for (let x = 0; x <= chunkSize; x++) {
+                            const wx = originX + x * voxelSize;
+                            const wy = originY + y * voxelSize;
+                            const wz = originZ + z * voxelSize;
+                            const weight = brushWeight(edit, wx, wy, wz);
+                            if (weight <= 0)
+                                continue;
+                            const idx = z * s1s1 + y * s1 + x;
+                            chunk.densityGrid[idx] = chunk.densityGrid[idx] + edit.strength * weight;
+                            modified = true;
+                        }
+                    }
+                }
+                if (modified) {
+                    dirty.add(key);
+                }
+            }
+        }
+    }
+    return dirty;
+}
+/** Compute brush influence weight at a world position (0 = no effect, 1 = full). */
+function brushWeight(edit, wx, wy, wz) {
+    const dx = wx - edit.x;
+    const dy = wy - edit.y;
+    const dz = wz - edit.z;
+    let dist;
+    if (edit.shape === BrushShape.Sphere) {
+        dist = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    }
+    else {
+        // Cube: Chebyshev distance
+        dist = Math.max(Math.abs(dx), Math.abs(dy), Math.abs(dz));
+    }
+    if (dist > edit.radius)
+        return 0;
+    if (edit.falloff <= 0)
+        return 1;
+    // Smooth falloff: starts at (1 - falloff) * radius
+    const innerRadius = edit.radius * (1 - edit.falloff);
+    if (dist <= innerRadius)
+        return 1;
+    const t = (dist - innerRadius) / (edit.radius - innerRadius);
+    // Smoothstep
+    return 1 - t * t * (3 - 2 * t);
+}
+//# sourceMappingURL=terrain-editor.js.map

package/dist/terrain-editor.js.map

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

package/dist/terrain-normals.d.ts

@@ -0,0 +1,13 @@
+import type { DensityFn } from './types.js';
+/**
+ * Compute smooth normals via central-difference gradient of the density field.
+ * Overwrites the normal slots (offsets 3,4,5) in the vertex buffer.
+ */
+export declare function computeGradientNormals(vertices: Float32Array, vertexCount: number, densityFn: DensityFn, epsilon: number): void;
+/**
+ * Compute face-weighted normals from triangle data.
+ * Each vertex normal is the normalized sum of the face normals of all
+ * triangles sharing that vertex, weighted by triangle area.
+ */
+export declare function computeTriangleNormals(vertices: Float32Array, indices: Uint32Array, vertexCount: number, indexCount: number): void;
+//# sourceMappingURL=terrain-normals.d.ts.map

package/dist/terrain-normals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-normals.d.ts","sourceRoot":"","sources":["../src/terrain-normals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,IAAI,CA4BN;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,IAAI,CAsDN"}

package/dist/terrain-normals.js

@@ -0,0 +1,96 @@
+const STRIDE = 8;
+/**
+ * Compute smooth normals via central-difference gradient of the density field.
+ * Overwrites the normal slots (offsets 3,4,5) in the vertex buffer.
+ */
+export function computeGradientNormals(vertices, vertexCount, densityFn, epsilon) {
+    for (let i = 0; i < vertexCount; i++) {
+        const o = i * STRIDE;
+        const px = vertices[o];
+        const py = vertices[o + 1];
+        const pz = vertices[o + 2];
+        // Central differences: gradient of density (positive = air)
+        // Normal points from solid toward air (in direction of increasing density)
+        let nx = densityFn(px + epsilon, py, pz) - densityFn(px - epsilon, py, pz);
+        let ny = densityFn(px, py + epsilon, pz) - densityFn(px, py - epsilon, pz);
+        let nz = densityFn(px, py, pz + epsilon) - densityFn(px, py, pz - epsilon);
+        // Normalize
+        const len = Math.sqrt(nx * nx + ny * ny + nz * nz);
+        if (len > 1e-10) {
+            const inv = 1 / len;
+            nx *= inv;
+            ny *= inv;
+            nz *= inv;
+        }
+        else {
+            nx = 0;
+            ny = 1;
+            nz = 0;
+        }
+        vertices[o + 3] = nx;
+        vertices[o + 4] = ny;
+        vertices[o + 5] = nz;
+    }
+}
+/**
+ * Compute face-weighted normals from triangle data.
+ * Each vertex normal is the normalized sum of the face normals of all
+ * triangles sharing that vertex, weighted by triangle area.
+ */
+export function computeTriangleNormals(vertices, indices, vertexCount, indexCount) {
+    // Zero out normals
+    for (let i = 0; i < vertexCount; i++) {
+        const o = i * STRIDE;
+        vertices[o + 3] = 0;
+        vertices[o + 4] = 0;
+        vertices[o + 5] = 0;
+    }
+    // Accumulate face normals (area-weighted via cross product magnitude)
+    for (let t = 0; t < indexCount; t += 3) {
+        const i0 = indices[t];
+        const i1 = indices[t + 1];
+        const i2 = indices[t + 2];
+        const o0 = i0 * STRIDE;
+        const o1 = i1 * STRIDE;
+        const o2 = i2 * STRIDE;
+        const ax = vertices[o1] - vertices[o0];
+        const ay = vertices[o1 + 1] - vertices[o0 + 1];
+        const az = vertices[o1 + 2] - vertices[o0 + 2];
+        const bx = vertices[o2] - vertices[o0];
+        const by = vertices[o2 + 1] - vertices[o0 + 1];
+        const bz = vertices[o2 + 2] - vertices[o0 + 2];
+        // Cross product (area-weighted normal)
+        const nx = ay * bz - az * by;
+        const ny = az * bx - ax * bz;
+        const nz = ax * by - ay * bx;
+        vertices[o0 + 3] = vertices[o0 + 3] + nx;
+        vertices[o0 + 4] = vertices[o0 + 4] + ny;
+        vertices[o0 + 5] = vertices[o0 + 5] + nz;
+        vertices[o1 + 3] = vertices[o1 + 3] + nx;
+        vertices[o1 + 4] = vertices[o1 + 4] + ny;
+        vertices[o1 + 5] = vertices[o1 + 5] + nz;
+        vertices[o2 + 3] = vertices[o2 + 3] + nx;
+        vertices[o2 + 4] = vertices[o2 + 4] + ny;
+        vertices[o2 + 5] = vertices[o2 + 5] + nz;
+    }
+    // Normalize
+    for (let i = 0; i < vertexCount; i++) {
+        const o = i * STRIDE;
+        let nx = vertices[o + 3];
+        let ny = vertices[o + 4];
+        let nz = vertices[o + 5];
+        const len = Math.sqrt(nx * nx + ny * ny + nz * nz);
+        if (len > 1e-10) {
+            const inv = 1 / len;
+            vertices[o + 3] = nx * inv;
+            vertices[o + 4] = ny * inv;
+            vertices[o + 5] = nz * inv;
+        }
+        else {
+            vertices[o + 3] = 0;
+            vertices[o + 4] = 1;
+            vertices[o + 5] = 0;
+        }
+    }
+}
+//# sourceMappingURL=terrain-normals.js.map

package/dist/terrain-normals.js.map

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

package/dist/terrain-volume.d.ts

@@ -0,0 +1,42 @@
+import { Component, Scene } from '@certe/atmos-core';
+import type { Material } from '@certe/atmos-renderer';
+import type { DensityFn, TerrainConfig, TerrainEdit } from './types.js';
+/**
+ * Bounded terrain volume component.
+ * Manages an NxMxP grid of terrain chunks as child GameObjects with MeshRenderers.
+ */
+export declare class TerrainVolume extends Component {
+    /** Number of chunks along each axis */
+    chunksX: number;
+    chunksY: number;
+    chunksZ: number;
+    config: TerrainConfig;
+    private _densityFn;
+    private _chunks;
+    private _chunkObjects;
+    private _rendererCtx;
+    private _scene;
+    private _material;
+    /** GOs kept alive for 1 overlap frame, then moved to _pendingRemoval. */
+    private _pendingDisable;
+    /** GOs with disabled MR, ready for scene removal + buffer destruction. */
+    private _pendingRemoval;
+    setDensityFn(fn: DensityFn): void;
+    init(device: GPUDevice, pipelineResources: import('@certe/atmos-renderer').PipelineResources, scene: Scene, material?: Material): void;
+    build(): void;
+    edit(op: TerrainEdit): void;
+    onDestroy(): void;
+    onRender(): void;
+    private _buildChunk;
+    private _rebuildChunkMesh;
+    /**
+     * Two-phase deferred removal:
+     * Phase 1: disable overlap GOs (were drawn alongside replacement last frame)
+     * Phase 2: destroy GOs that were disabled last frame (safe after submit)
+     */
+    private _flushRemovals;
+    private _createChunkObject;
+    private _destroyGO;
+    private _destroyAllChunks;
+}
+//# sourceMappingURL=terrain-volume.d.ts.map

package/dist/terrain-volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-volume.d.ts","sourceRoot":"","sources":["../src/terrain-volume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAc,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAuB,MAAM,uBAAuB,CAAC;AAI3E,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGxE;;;GAGG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,uCAAuC;IACvC,OAAO,SAAK;IACZ,OAAO,SAAK;IACZ,OAAO,SAAK;IAEZ,MAAM,EAAE,aAAa,CAAiC;IAEtD,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAyB;IAC1C,yEAAyE;IACzE,OAAO,CAAC,eAAe,CAAoB;IAC3C,0EAA0E;IAC1E,OAAO,CAAC,eAAe,CAAoB;IAE3C,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAIjC,IAAI,CACF,MAAM,EAAE,SAAS,EACjB,iBAAiB,EAAE,OAAO,uBAAuB,EAAE,iBAAiB,EACpE,KAAK,EAAE,KAAK,EACZ,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI;IAMP,KAAK,IAAI,IAAI;IAcb,IAAI,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAa3B,SAAS,IAAI,IAAI;IAIjB,QAAQ,IAAI,IAAI;IAIhB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,iBAAiB;IAkBzB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;CAW1B"}