nucleation 0.3.16 → 0.3.18

package/Brush.d.ts

@@ -74,4 +74,17 @@ export class Brush {
      * (`colors.len() == stops.len() * 3`, `stops` non-empty).
      */
     static curveGradient(stops: Array<number>, colors: Array<number>, space: InterpolationSpace): Brush;
+
+    /**
+     * A field brush: color every voxel by evaluating a scalar field at its
+     * center, remapping `[lo, hi]` to `[0, 1]`, and reading a multi-stop
+     * gradient (`stops` in `[0, 1]`, `colors` as flat RGB triples). The
+     * field is any SDF JSON — the same language that builds geometry — so a
+     * `cells` node paints a Voronoi mosaic (`mode: value`) or cracks
+     * (`mode: f2MinusF1`), an fbm field a marble, a coordinate expression a
+     * stripe. Call `set_palette` to choose the block set. Errors with
+     * `Parse` on bad field JSON and `InvalidArgument` on a stops/colors
+     * length mismatch.
+     */
+    static field(fieldJson: string, stops: Array<number>, colors: Array<number>, lo: number, hi: number, space: InterpolationSpace): Brush;
 }

package/Brush.mjs

@@ -234,6 +234,44 @@ export class Brush {
         }
     }
 
+    /**
+     * A field brush: color every voxel by evaluating a scalar field at its
+     * center, remapping `[lo, hi]` to `[0, 1]`, and reading a multi-stop
+     * gradient (`stops` in `[0, 1]`, `colors` as flat RGB triples). The
+     * field is any SDF JSON — the same language that builds geometry — so a
+     * `cells` node paints a Voronoi mosaic (`mode: value`) or cracks
+     * (`mode: f2MinusF1`), an fbm field a marble, a coordinate expression a
+     * stripe. Call `set_palette` to choose the block set. Errors with
+     * `Parse` on bad field JSON and `InvalidArgument` on a stops/colors
+     * length mismatch.
+     */
+    static field(fieldJson, stops, colors, lo, hi, space) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const fieldJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, fieldJson)));
+        const stopsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, stops, "f32")));
+        const colorsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, colors, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Brush_field(diplomatReceive.buffer, fieldJsonSlice.ptr, stopsSlice.ptr, colorsSlice.ptr, lo, hi, space.ffiValue);
+
+        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 Brush(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/DistanceField.d.ts

@@ -0,0 +1,39 @@
+// generated by diplomat-tool
+import type { Schematic } from "./Schematic"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+export class DistanceField {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Distance transform of a build's occupied voxels: every solid block
+     * learns how many blocks it sits below the surface, and the gradient of
+     * that depth gives the outward normal. Computed once over the
+     * schematic's bounding box.
+     */
+    static fromSchematic(schematic: Schematic): DistanceField;
+
+    /**
+     * Blocks below the surface at a voxel: 0 for empty/outside, 1 at the
+     * surface, increasing inward.
+     */
+    depth(x: number, y: number, z: number): number;
+
+    /**
+     * The upward component of the outward surface normal: 1 on flat ground,
+     * 0 on a vertical face, negative under an overhang. The scalar to key
+     * slope-based landscaping on (grass on the flats, stone on the steeps).
+     */
+    slope(x: number, y: number, z: number): number;
+
+    /**
+     * The full outward surface normal as JSON `[nx, ny, nz]`.
+     */
+    normalJson(x: number, y: number, z: number): string;
+}

package/DistanceField.mjs

@@ -0,0 +1,114 @@
+// generated by diplomat-tool
+import { Schematic } from "./Schematic.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const DistanceField_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.DistanceField_destroy(ptr);
+});
+
+export class DistanceField {
+    // 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("DistanceField 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) {
+            DistanceField_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Distance transform of a build's occupied voxels: every solid block
+     * learns how many blocks it sits below the surface, and the gradient of
+     * that depth gives the outward normal. Computed once over the
+     * schematic's bounding box.
+     */
+    static fromSchematic(schematic) {
+
+        const result = wasm.DistanceField_from_schematic(schematic.ffiValue);
+
+        try {
+            return new DistanceField(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Blocks below the surface at a voxel: 0 for empty/outside, 1 at the
+     * surface, increasing inward.
+     */
+    depth(x, y, z) {
+
+        const result = wasm.DistanceField_depth(this.ffiValue, x, y, z);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * The upward component of the outward surface normal: 1 on flat ground,
+     * 0 on a vertical face, negative under an overhang. The scalar to key
+     * slope-based landscaping on (grass on the flats, stone on the steeps).
+     */
+    slope(x, y, z) {
+
+        const result = wasm.DistanceField_slope(this.ffiValue, x, y, z);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * The full outward surface normal as JSON `[nx, ny, nz]`.
+     */
+    normalJson(x, y, z) {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.DistanceField_normal_json(this.ffiValue, x, y, z, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/index.d.ts

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

package/index.mjs

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

package/package.json

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