nucleation 0.3.9 → 0.3.11

package/Palette.d.ts

@@ -66,6 +66,15 @@ export class Palette {
      */
     static wood(): Palette;
 
+    /**
+     * A copy of this palette with ordered dithering enabled: brushes
+     * snapping through it alternate between the two nearest blocks per
+     * voxel (4x4 Bayer threshold, deterministic in position), which
+     * reads as intermediate shades at a distance — the classic map-art
+     * trick. Ramp and list queries are unaffected.
+     */
+    dithered(): Palette;
+
     /**
      * A copy of this palette ordered by perceptual lightness (Oklab L,
      * dark → light). Combined with `block_ids_json`, gives a
@@ -111,6 +120,15 @@ export class Palette {
      */
     blockIdsJson(): string;
 
+    /**
+     * Position-aware dithered snap: the block for the given RGB at
+     * voxel (x, y, z), alternating between the two nearest palette
+     * blocks per position (4x4 Bayer) — the per-pixel entry point for
+     * pixel art and image mapping. Deterministic. Errors with
+     * `NotFound` on an empty palette.
+     */
+    closestBlockDithered(r: number, g: number, b: number, x: number, y: number, z: number): string;
+
     /**
      * The palette block whose color is closest (Oklab distance) to the
      * given RGB. Errors with `NotFound` on an empty palette.

package/Palette.mjs

@@ -190,6 +190,26 @@ export class Palette {
         }
     }
 
+    /**
+     * A copy of this palette with ordered dithering enabled: brushes
+     * snapping through it alternate between the two nearest blocks per
+     * voxel (4x4 Bayer threshold, deterministic in position), which
+     * reads as intermediate shades at a distance — the classic map-art
+     * trick. Ramp and list queries are unaffected.
+     */
+    dithered() {
+
+        const result = wasm.Palette_dithered(this.ffiValue);
+
+        try {
+            return new Palette(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
     /**
      * A copy of this palette ordered by perceptual lightness (Oklab L,
      * dark → light). Combined with `block_ids_json`, gives a
@@ -335,6 +355,36 @@ export class Palette {
         }
     }
 
+    /**
+     * Position-aware dithered snap: the block for the given RGB at
+     * voxel (x, y, z), alternating between the two nearest palette
+     * blocks per position (4x4 Bayer) — the per-pixel entry point for
+     * pixel art and image mapping. Deterministic. Errors with
+     * `NotFound` on an empty palette.
+     */
+    closestBlockDithered(r, g, b, x, y, z) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Palette_closest_block_dithered(diplomatReceive.buffer, this.ffiValue, r, g, b, x, y, z, 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();
+        }
+    }
+
     /**
      * The palette block whose color is closest (Oklab distance) to the
      * given RGB. Errors with `NotFound` on an empty palette.

package/package.json

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