nucleation 0.3.15 → 0.3.17

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/WorldChunkView.d.ts

@@ -39,6 +39,18 @@ export class WorldChunkView {
      */
     toSchematic(): Schematic;
 
+    /**
+     * Build a chunk view at (`cx`, `cz`) from a schematic — every non-air
+     * block whose world (x, z) falls in this chunk is copied in, the rest
+     * ignored. The write-side twin of `to_schematic`: this is how the
+     * schematic building tools become a *world generator*. Fill a schematic
+     * with any shape, SDF, brush, or footprint (intersect it with the
+     * chunk's cuboid to keep memory flat), then hand it here per chunk and
+     * `WorldSink.write_chunk` it. Also the transform step of a world filter:
+     * `to_schematic` a streamed chunk, edit it, rebuild with this.
+     */
+    static fromSchematic(schematic: Schematic, cx: number, cz: number): WorldChunkView;
+
     /**
      * Set a block at absolute world coordinates inside this chunk view.
      * `block_name` must be a valid Minecraft block identifier (e.g.

package/WorldChunkView.mjs

@@ -108,6 +108,29 @@ export class WorldChunkView {
         }
     }
 
+    /**
+     * Build a chunk view at (`cx`, `cz`) from a schematic — every non-air
+     * block whose world (x, z) falls in this chunk is copied in, the rest
+     * ignored. The write-side twin of `to_schematic`: this is how the
+     * schematic building tools become a *world generator*. Fill a schematic
+     * with any shape, SDF, brush, or footprint (intersect it with the
+     * chunk's cuboid to keep memory flat), then hand it here per chunk and
+     * `WorldSink.write_chunk` it. Also the transform step of a world filter:
+     * `to_schematic` a streamed chunk, edit it, rebuild with this.
+     */
+    static fromSchematic(schematic, cx, cz) {
+
+        const result = wasm.WorldChunkView_from_schematic(schematic.ffiValue, cx, cz);
+
+        try {
+            return new WorldChunkView(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
     /**
      * Set a block at absolute world coordinates inside this chunk view.
      * `block_name` must be a valid Minecraft block identifier (e.g.

package/package.json

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