nucleation 0.3.6 → 0.3.8

package/Blocks.d.ts

@@ -38,6 +38,14 @@ export class Blocks {
 
     /**
      * Ids of every block carrying the vanilla block tag, as a sorted
+     * Blocks whose measured texture color is within `max_distance`
+     * (Oklab; ~0.05 = same color family, ~0.15 = generous) of the given
+     * RGB, as a JSON array of `{"id", "color": [r,g,b], "distance"}`
+     * sorted nearest-first. Blocks without color data never match.
+     */
+    static byColorJson(r: number, g: number, b: number, maxDistance: number): string;
+
+    /**
      * JSON array string (`[]` for unknown tags). Accepts
      * `minecraft:wool` and short `wool` forms, including nested paths
      * like `mineable/pickaxe`.

package/Blocks.mjs

@@ -102,6 +102,35 @@ export class Blocks {
 
     /**
      * Ids of every block carrying the vanilla block tag, as a sorted
+     * Blocks whose measured texture color is within `max_distance`
+     * (Oklab; ~0.05 = same color family, ~0.15 = generous) of the given
+     * RGB, as a JSON array of `{"id", "color": [r,g,b], "distance"}`
+     * sorted nearest-first. Blocks without color data never match.
+     */
+    static byColorJson(r, g, b, maxDistance) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Blocks_by_color_json(diplomatReceive.buffer, r, g, b, maxDistance, 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 string (`[]` for unknown tags). Accepts
      * `minecraft:wool` and short `wool` forms, including nested paths
      * like `mineable/pickaxe`.

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

@@ -94,6 +94,24 @@ export class PaletteBuilder {
      */
     kind(k: string): void;
 
+    /**
+     * Keep only blocks whose measured Oklab lightness L is within
+     * `[min, max]` (0.0 = black, 1.0 = white).
+     */
+    lightnessBetween(min: number, max: number): void;
+
+    /**
+     * Keep only near-neutral blocks: measured Oklab chroma at most
+     * `max` (the grayscale preset uses 0.022).
+     */
+    chromaBelow(max: number): void;
+
+    /**
+     * Keep only blocks whose measured color is within `max_distance`
+     * (Oklab; ~0.05 = same family, ~0.15 = generous) of the RGB color.
+     */
+    colorNear(r: number, g: number, b: number, maxDistance: number): void;
+
     /**
      * Build the palette; consumes the builder.
      */

package/PaletteBuilder.mjs

@@ -359,6 +359,75 @@ export class PaletteBuilder {
         }
     }
 
+    /**
+     * Keep only blocks whose measured Oklab lightness L is within
+     * `[min, max]` (0.0 = black, 1.0 = white).
+     */
+    lightnessBetween(min, max) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.PaletteBuilder_lightness_between(diplomatReceive.buffer, this.ffiValue, min, max);
+
+        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();
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Keep only near-neutral blocks: measured Oklab chroma at most
+     * `max` (the grayscale preset uses 0.022).
+     */
+    chromaBelow(max) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.PaletteBuilder_chroma_below(diplomatReceive.buffer, this.ffiValue, max);
+
+        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();
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Keep only blocks whose measured color is within `max_distance`
+     * (Oklab; ~0.05 = same family, ~0.15 = generous) of the RGB color.
+     */
+    colorNear(r, g, b, maxDistance) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.PaletteBuilder_color_near(diplomatReceive.buffer, this.ffiValue, r, g, b, maxDistance);
+
+        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();
+            diplomatReceive.free();
+        }
+    }
+
     /**
      * Build the palette; consumes the builder.
      */

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

@@ -85,6 +85,23 @@ export class Shape {
      */
     static bezier(controlPoints: Array<number>, thickness: number, resolution: number): Shape;
 
+    /**
+     * Any SDF tree as a Shape: the same JSON the terrain sampler takes
+     * (primitives, smooth booleans, noise — see the SDF guide) becomes
+     * fillable with every brush, combinable with other shapes, and
+     * usable in masked fills. Normals come from the field gradient, so
+     * the shaded brush shades smooth blends smoothly. Errors with
+     * `Parse` on invalid JSON and `InvalidArgument` for unbounded trees
+     * (use `sdf_bounded`).
+     */
+    static sdf(sdfJson: string): Shape;
+
+    /**
+     * Like `sdf`, with explicit sampling bounds (inclusive block
+     * coordinates) for unbounded trees such as planes.
+     */
+    static sdfBounded(sdfJson: string, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): Shape;
+
     /**
      * Hollowed-out copy of this shape with the given wall thickness (clones the
      * input, like the old `shape_hollow`).

package/Shape.mjs

@@ -265,6 +265,69 @@ export class Shape {
         }
     }
 
+    /**
+     * Any SDF tree as a Shape: the same JSON the terrain sampler takes
+     * (primitives, smooth booleans, noise — see the SDF guide) becomes
+     * fillable with every brush, combinable with other shapes, and
+     * usable in masked fills. Normals come from the field gradient, so
+     * the shaded brush shades smooth blends smoothly. Errors with
+     * `Parse` on invalid JSON and `InvalidArgument` for unbounded trees
+     * (use `sdf_bounded`).
+     */
+    static sdf(sdfJson) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const sdfJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, sdfJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Shape_sdf(diplomatReceive.buffer, sdfJsonSlice.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 Shape(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Like `sdf`, with explicit sampling bounds (inclusive block
+     * coordinates) for unbounded trees such as planes.
+     */
+    static sdfBounded(sdfJson, minX, minY, minZ, maxX, maxY, maxZ) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const sdfJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, sdfJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Shape_sdf_bounded(diplomatReceive.buffer, sdfJsonSlice.ptr, minX, minY, minZ, maxX, maxY, maxZ);
+
+        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 Shape(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
     /**
      * Hollowed-out copy of this shape with the given wall thickness (clones the
      * input, like the old `shape_hollow`).

package/package.json

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