nucleation 0.3.14 → 0.3.16

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.14",
+  "version": "0.3.16",
   "description": "A high-performance Minecraft schematic parser and utility library",
   "type": "module",
   "main": "index.mjs",