nucleation 0.3.12 → 0.3.14

package/Geo.d.ts

@@ -0,0 +1,41 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError"
+import type { Schematic } from "./Schematic"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Namespace for the geodata entry points (no network — data goes in,
+ * blocks come out).
+ */
+export class Geo {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Extrude building footprints into a massed schematic. `buildings_json`
+     * is a JSON array of objects:
+     * `{"polygon": [[x, z], ...], "height": <blocks>, "block": "minecraft:...",
+     * "min_y": <optional base, default 1>}`. Footprints are stamped
+     * tallest-last, so overlaps keep the tallest occupant per column.
+     * `base_block` (empty string = none) lays a ground slab at y=0 under the
+     * whole extent. Errors `Parse` on bad JSON, `InvalidArgument` on non-UTF-8.
+     */
+    static extrudeFootprints(buildingsJson: string, baseBlock: string, name: string): Schematic;
+
+    /**
+     * Raise terrain from a heightmap. `heights_json` is a flat row-major
+     * JSON array of per-column heights (blocks); `width` is columns per row.
+     * `surface_blocks_json` is a JSON array of block names — one entry (the
+     * same surface everywhere) or one per column, row-major and the same
+     * length as `heights`, for elevation/slope banding. Each column's top
+     * `surface_depth` blocks are its surface block, the rest are
+     * `subsurface_block`. Errors `Parse` on bad JSON, `InvalidArgument` on a
+     * non-positive width, empty surface list, or non-UTF-8.
+     */
+    static heightmapTerrain(heightsJson: string, width: number, surfaceBlocksJson: string, subsurfaceBlock: string, surfaceDepth: number, name: string): Schematic;
+}

package/Geo.mjs

@@ -0,0 +1,121 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import { Schematic } from "./Schematic.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const Geo_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.Geo_destroy(ptr);
+});
+
+/**
+ * Namespace for the geodata entry points (no network — data goes in,
+ * blocks come out).
+ */
+export class Geo {
+    // Internal ptr reference:
+    #ptr = null;
+
+    // Lifetimes are only to keep dependencies alive.
+    // Since JS won't garbage collect until there are no incoming edges.
+    #selfEdge = [];
+
+    #internalConstructor(symbol, ptr, selfEdge) {
+        if (symbol !== diplomatRuntime.internalConstructor) {
+            console.error("Geo is an Opaque type. You cannot call its constructor.");
+            return;
+        }
+        this.#ptr = ptr;
+        this.#selfEdge = selfEdge;
+
+        // Are we being borrowed? If not, we can register.
+        if (this.#selfEdge.length === 0) {
+            Geo_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Extrude building footprints into a massed schematic. `buildings_json`
+     * is a JSON array of objects:
+     * `{"polygon": [[x, z], ...], "height": <blocks>, "block": "minecraft:...",
+     * "min_y": <optional base, default 1>}`. Footprints are stamped
+     * tallest-last, so overlaps keep the tallest occupant per column.
+     * `base_block` (empty string = none) lays a ground slab at y=0 under the
+     * whole extent. Errors `Parse` on bad JSON, `InvalidArgument` on non-UTF-8.
+     */
+    static extrudeFootprints(buildingsJson, baseBlock, name) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const buildingsJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, buildingsJson)));
+        const baseBlockSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, baseBlock)));
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Geo_extrude_footprints(diplomatReceive.buffer, buildingsJsonSlice.ptr, baseBlockSlice.ptr, nameSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Schematic(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Raise terrain from a heightmap. `heights_json` is a flat row-major
+     * JSON array of per-column heights (blocks); `width` is columns per row.
+     * `surface_blocks_json` is a JSON array of block names — one entry (the
+     * same surface everywhere) or one per column, row-major and the same
+     * length as `heights`, for elevation/slope banding. Each column's top
+     * `surface_depth` blocks are its surface block, the rest are
+     * `subsurface_block`. Errors `Parse` on bad JSON, `InvalidArgument` on a
+     * non-positive width, empty surface list, or non-UTF-8.
+     */
+    static heightmapTerrain(heightsJson, width, surfaceBlocksJson, subsurfaceBlock, surfaceDepth, name) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const heightsJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, heightsJson)));
+        const surfaceBlocksJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, surfaceBlocksJson)));
+        const subsurfaceBlockSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, subsurfaceBlock)));
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Geo_heightmap_terrain(diplomatReceive.buffer, heightsJsonSlice.ptr, width, surfaceBlocksJsonSlice.ptr, subsurfaceBlockSlice.ptr, surfaceDepth, nameSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Schematic(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/Shape.d.ts

@@ -26,6 +26,17 @@ export class Shape {
      */
     static cuboid(minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): Shape;
 
+    /**
+     * A closed 2D polygon extruded between two Y levels (inclusive). The
+     * footprint is `polygon_json`, a JSON array of `[x, z]` world-coordinate
+     * pairs in order (winding does not matter; the ring closes implicitly);
+     * any simple polygon works, concave ones included. This is the shape
+     * behind extruded building footprints, lake outlines, and plot fills.
+     * Errors with `Parse` on invalid JSON and `InvalidArgument` on non-UTF-8
+     * or fewer than three vertices.
+     */
+    static polygonPrism(polygonJson: string, yMin: number, yMax: number): Shape;
+
     /**
      * Ellipsoid centered at (`cx`, `cy`, `cz`) with per-axis radii.
      */

package/Shape.mjs

@@ -73,6 +73,40 @@ export class Shape {
         }
     }
 
+    /**
+     * A closed 2D polygon extruded between two Y levels (inclusive). The
+     * footprint is `polygon_json`, a JSON array of `[x, z]` world-coordinate
+     * pairs in order (winding does not matter; the ring closes implicitly);
+     * any simple polygon works, concave ones included. This is the shape
+     * behind extruded building footprints, lake outlines, and plot fills.
+     * Errors with `Parse` on invalid JSON and `InvalidArgument` on non-UTF-8
+     * or fewer than three vertices.
+     */
+    static polygonPrism(polygonJson, yMin, yMax) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const polygonJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, polygonJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Shape_polygon_prism(diplomatReceive.buffer, polygonJsonSlice.ptr, yMin, yMax);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Shape(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
     /**
      * Ellipsoid centered at (`cx`, `cy`, `cz`) with per-axis radii.
      */

package/Voxelizer.d.ts

@@ -26,7 +26,9 @@ export class Voxelizer {
      * voxel center (robust on closed meshes), plus — when `shell` > 0 —
      * every voxel whose center is within `shell` blocks of the surface,
      * which rescues thin walls and hollow vessels (0.7–1.0 closes
-     * single-voxel shells; 0 = pure parity). Errors with `Parse` on
+     * single-voxel shells; 0 = pure parity; a *negative* `shell` is
+     * surface-only — a skin |shell| blocks thick with no interior fill,
+     * for open sheets/ribbons that dip or self-overlap). Errors with `Parse` on
      * malformed/triangle-less GLB and `InvalidArgument` on a
      * non-positive `target_size`.
      */

package/Voxelizer.mjs

@@ -51,7 +51,9 @@ export class Voxelizer {
      * voxel center (robust on closed meshes), plus — when `shell` > 0 —
      * every voxel whose center is within `shell` blocks of the surface,
      * which rescues thin walls and hollow vessels (0.7–1.0 closes
-     * single-voxel shells; 0 = pure parity). Errors with `Parse` on
+     * single-voxel shells; 0 = pure parity; a *negative* `shell` is
+     * surface-only — a skin |shell| blocks thick with no interior fill,
+     * for open sheets/ribbons that dip or self-overlap). Errors with `Parse` on
      * malformed/triangle-less GLB and `InvalidArgument` on a
      * non-positive `target_size`.
      */

package/index.d.ts

@@ -38,6 +38,8 @@ export { Diff } from "./Diff"
 
 export { Fingerprint } from "./Fingerprint"
 
+export { Geo } from "./Geo"
+
 export { ChunkMeshResult } from "./ChunkMeshResult"
 
 export { ItemModelConfig } from "./ItemModelConfig"

package/index.mjs

@@ -36,6 +36,8 @@ export { Diff } from "./Diff.mjs"
 
 export { Fingerprint } from "./Fingerprint.mjs"
 
+export { Geo } from "./Geo.mjs"
+
 export { ChunkMeshResult } from "./ChunkMeshResult.mjs"
 
 export { ItemModelConfig } from "./ItemModelConfig.mjs"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nucleation",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "A high-performance Minecraft schematic parser and utility library",
   "type": "module",
   "main": "index.mjs",