nucleation 0.3.5 → 0.3.7

package/Palette.d.ts

@@ -55,7 +55,9 @@ export class Palette {
     static terracotta(): Palette;
 
     /**
-     * Grayscale-leaning blocks (stones, basalt, deepslate, ...).
+     * Genuinely gray blocks: opaque full cubes whose measured color
+     * is near-neutral (low Oklab chroma) — judged from color data,
+     * not names.
      */
     static grayscale(): Palette;
 
@@ -71,6 +73,17 @@ export class Palette {
      */
     sortedByLightness(): Palette;
 
+    /**
+     * JSON array of exactly `steps` DISTINCT block ids forming the
+     * smoothest ramp this palette can make from (`r1`,`g1`,`b1`) to
+     * (`r2`,`g2`,`b2`): targets are evenly spaced along the Oklab line
+     * and blocks are chosen by a minimum-cost monotonic matching, so
+     * off-hue blocks are penalized and no block repeats. Errors with
+     * `InvalidArgument` when the palette has fewer than `steps` blocks,
+     * `steps` is 0, or start equals end.
+     */
+    rampIdsJson(r1: number, g1: number, b1: number, r2: number, g2: number, b2: number, steps: number): string;
+
     /**
      * JSON array of exactly `steps` block ids sampling the color
      * gradient from (`r1`,`g1`,`b1`) to (`r2`,`g2`,`b2`) in Oklab

package/Palette.mjs

@@ -157,7 +157,9 @@ export class Palette {
     }
 
     /**
-     * Grayscale-leaning blocks (stones, basalt, deepslate, ...).
+     * Genuinely gray blocks: opaque full cubes whose measured color
+     * is near-neutral (low Oklab chroma) — judged from color data,
+     * not names.
      */
     static grayscale() {
 
@@ -206,6 +208,38 @@ export class Palette {
         }
     }
 
+    /**
+     * JSON array of exactly `steps` DISTINCT block ids forming the
+     * smoothest ramp this palette can make from (`r1`,`g1`,`b1`) to
+     * (`r2`,`g2`,`b2`): targets are evenly spaced along the Oklab line
+     * and blocks are chosen by a minimum-cost monotonic matching, so
+     * off-hue blocks are penalized and no block repeats. Errors with
+     * `InvalidArgument` when the palette has fewer than `steps` blocks,
+     * `steps` is 0, or start equals end.
+     */
+    rampIdsJson(r1, g1, b1, r2, g2, b2, steps) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Palette_ramp_ids_json(diplomatReceive.buffer, this.ffiValue, r1, g1, b1, r2, g2, b2, steps, write.buffer);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+            write.free();
+        }
+    }
+
     /**
      * JSON array of exactly `steps` block ids sampling the color
      * gradient from (`r1`,`g1`,`b1`) to (`r2`,`g2`,`b2`) in Oklab

package/RenderConfig.d.ts

@@ -31,11 +31,21 @@ 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;
 
+    /**
+     * Fit the camera to the model's bounding sphere instead of its
+     * yaw-dependent silhouette. The sphere is rotation invariant, so
+     * orbiting cameras (turntables) keep a constant distance instead
+     * of pulsing as the silhouette changes. Frames slightly looser
+     * than the default fit. Default: false.
+     */
+    setSphereFit(sphereFit: boolean): void;
+
     /**
      * Set the vertical field of view in degrees (perspective projection
      * only). Default: 45.

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);
@@ -96,6 +97,23 @@ export class RenderConfig {
         }
     }
 
+    /**
+     * Fit the camera to the model's bounding sphere instead of its
+     * yaw-dependent silhouette. The sphere is rotation invariant, so
+     * orbiting cameras (turntables) keep a constant distance instead
+     * of pulsing as the silhouette changes. Frames slightly looser
+     * than the default fit. Default: false.
+     */
+    setSphereFit(sphereFit) {
+    wasm.RenderConfig_set_sphere_fit(this.ffiValue, sphereFit);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
     /**
      * Set the vertical field of view in degrees (perspective projection
      * only). Default: 45.

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