nucleation 0.3.4 → 0.3.6

package/RenderConfig.d.ts

@@ -31,8 +31,9 @@ export class RenderConfig {
     setPitch(pitch: number): void;
 
     /**
-     * Set the zoom factor scaling the auto-fitted camera distance
-     * (1.0 = frame the whole model; larger = further away). Default: 1.0.
+     * Set the zoom factor applied to the auto-fitted framing
+     * (1.0 = frame the whole model; 2.0 = twice as close; 0.5 = twice
+     * as far). Default: 1.0.
      */
     setZoom(zoom: number): void;
 

package/RenderConfig.mjs

@@ -83,8 +83,9 @@ export class RenderConfig {
     }
 
     /**
-     * Set the zoom factor scaling the auto-fitted camera distance
-     * (1.0 = frame the whole model; larger = further away). Default: 1.0.
+     * Set the zoom factor applied to the auto-fitted framing
+     * (1.0 = frame the whole model; 2.0 = twice as close; 0.5 = twice
+     * as far). Default: 1.0.
      */
     setZoom(zoom) {
     wasm.RenderConfig_set_zoom(this.ffiValue, zoom);

package/Schematic.d.ts

@@ -37,19 +37,6 @@ export class Schematic {
      */
     getBlockName(x: number, y: number, z: number): string;
 
-    /**
-     * Save the schematic to a file, always in Litematic format (the
-     * extension is not consulted; use `save_to_file_with_format` for
-     * other formats).
-     */
-    saveToFile(path: string): void;
-
-    /**
-     * Load a schematic from a Litematic file (this path is
-     * Litematic-only; use `from_data` for format auto-detection).
-     */
-    static loadFromFile(path: string): Schematic;
-
     /**
      * Build a schematic from raw byte data, auto-detecting the format.
      * Supports Litematic, Sponge Schematic, and McStructure (Bedrock) formats.
@@ -555,12 +542,6 @@ export class Schematic {
      */
     saveAsB64(format: string, version: string, settings: string): string;
 
-    /**
-     * Save to a file. If `format` is empty, the format is auto-detected from
-     * the file extension; `version` may be empty for the default.
-     */
-    saveToFileWithFormat(path: string, format: string, version: string): void;
-
     /**
      * Serialize as a Sponge schematic targeting a specific format version,
      * base64-encoded.

package/Schematic.mjs

@@ -136,64 +136,6 @@ export class Schematic {
         }
     }
 
-    /**
-     * Save the schematic to a file, always in Litematic format (the
-     * extension is not consulted; use `save_to_file_with_format` for
-     * other formats).
-     */
-    saveToFile(path) {
-        let functionCleanupArena = new diplomatRuntime.CleanupArena();
-
-        const pathSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, path)));
-        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
-
-
-        const result = wasm.Schematic_save_to_file(diplomatReceive.buffer, this.ffiValue, pathSlice.ptr);
-
-        try {
-            if (!diplomatReceive.resultFlag) {
-                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
-                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
-            }
-        }
-
-        finally {
-            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
-            functionCleanupArena.free();
-
-            diplomatReceive.free();
-        }
-    }
-
-    /**
-     * Load a schematic from a Litematic file (this path is
-     * Litematic-only; use `from_data` for format auto-detection).
-     */
-    static loadFromFile(path) {
-        let functionCleanupArena = new diplomatRuntime.CleanupArena();
-
-        const pathSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, path)));
-        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
-
-
-        const result = wasm.Schematic_load_from_file(diplomatReceive.buffer, pathSlice.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();
-        }
-    }
-
     /**
      * Build a schematic from raw byte data, auto-detecting the format.
      * Supports Litematic, Sponge Schematic, and McStructure (Bedrock) formats.
@@ -2224,36 +2166,6 @@ export class Schematic {
         }
     }
 
-    /**
-     * Save to a file. If `format` is empty, the format is auto-detected from
-     * the file extension; `version` may be empty for the default.
-     */
-    saveToFileWithFormat(path, format, version) {
-        let functionCleanupArena = new diplomatRuntime.CleanupArena();
-
-        const pathSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, path)));
-        const formatSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, format)));
-        const versionSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, version)));
-        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
-
-
-        const result = wasm.Schematic_save_to_file_with_format(diplomatReceive.buffer, this.ffiValue, pathSlice.ptr, formatSlice.ptr, versionSlice.ptr);
-
-        try {
-            if (!diplomatReceive.resultFlag) {
-                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
-                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
-            }
-        }
-
-        finally {
-            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
-            functionCleanupArena.free();
-
-            diplomatReceive.free();
-        }
-    }
-
     /**
      * Serialize as a Sponge schematic targeting a specific format version,
      * base64-encoded.

package/Sdf.d.ts

@@ -18,6 +18,14 @@ export class Sdf {
 
     /**
      * Builds a schematic by sampling an SDF JSON tree with material rules JSON.
+     * Sample an SDF tree into a schematic using the tree's own AABB —
+     * the ergonomic path for bounded trees (all primitives except
+     * `plane`). Fails with `InvalidArgument` for unbounded trees; use
+     * `schematic_from_sdf` with explicit bounds for those.
+     */
+    static schematicFromSdfAuto(sdfJson: string, rulesJson: string): Schematic;
+
+    /**
      * When `has_bounds` is false the tree's own AABB is used (fails with
      * `InvalidArgument` for unbounded trees) and the `min_*`/`max_*` arguments
      * are ignored.

package/Sdf.mjs

@@ -43,6 +43,38 @@ export class Sdf {
 
     /**
      * Builds a schematic by sampling an SDF JSON tree with material rules JSON.
+     * Sample an SDF tree into a schematic using the tree's own AABB —
+     * the ergonomic path for bounded trees (all primitives except
+     * `plane`). Fails with `InvalidArgument` for unbounded trees; use
+     * `schematic_from_sdf` with explicit bounds for those.
+     */
+    static schematicFromSdfAuto(sdfJson, rulesJson) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const sdfJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, sdfJson)));
+        const rulesJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, rulesJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Sdf_schematic_from_sdf_auto(diplomatReceive.buffer, sdfJsonSlice.ptr, rulesJsonSlice.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();
+        }
+    }
+
+    /**
      * When `has_bounds` is false the tree's own AABB is used (fails with
      * `InvalidArgument` for unbounded trees) and the `min_*`/`max_*` arguments
      * are ignored.

package/package.json

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