nucleation 0.3.6 → 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

@@ -37,6 +37,15 @@ export class RenderConfig {
      */
     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

@@ -97,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/package.json

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