nucleation 0.10.20 → 0.10.21

package/Palette.d.mts

@@ -17,6 +17,18 @@ export class Palette {
     constructor();
 
 
+    /**
+     * Opaque building blocks and full glass blocks, for material-aware imports.
+     */
+    static materials(): Palette;
+
+    /**
+     * Keep only opaque blocks (`false`) or full glass blocks (`true`).
+     * Includes/excludes remain respected. Returns an empty palette when
+     * no suitable block exists; check `len()` before matching colours.
+     */
+    forMaterial(translucent: boolean): Palette;
+
     /**
      * Every block blockpedia knows a color for (the default palette
      * brushes use when none is set).

package/Palette.d.ts

@@ -17,6 +17,18 @@ export class Palette {
     constructor();
 
 
+    /**
+     * Opaque building blocks and full glass blocks, for material-aware imports.
+     */
+    static materials(): Palette;
+
+    /**
+     * Keep only opaque blocks (`false`) or full glass blocks (`true`).
+     * Includes/excludes remain respected. Returns an empty palette when
+     * no suitable block exists; check `len()` before matching colours.
+     */
+    forMaterial(translucent: boolean): Palette;
+
     /**
      * Every block blockpedia knows a color for (the default palette
      * brushes use when none is set).

package/Palette.mjs

@@ -42,6 +42,40 @@ export class Palette {
     }
 
 
+    /**
+     * Opaque building blocks and full glass blocks, for material-aware imports.
+     */
+    static materials() {
+
+        const result = wasm.Palette_materials();
+
+        try {
+            return new Palette(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Keep only opaque blocks (`false`) or full glass blocks (`true`).
+     * Includes/excludes remain respected. Returns an empty palette when
+     * no suitable block exists; check `len()` before matching colours.
+     */
+    forMaterial(translucent) {
+
+        const result = wasm.Palette_for_material(this.ffiValue, translucent);
+
+        try {
+            return new Palette(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
     /**
      * Every block blockpedia knows a color for (the default palette
      * brushes use when none is set).

package/VoxelModel.d.mts

@@ -0,0 +1,34 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Palette } from "./Palette.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A parsed GLB/OBJ, reusable for size estimates and configured imports.
+ */
+export class VoxelModel {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Return {dimensions:[width,height,depth],volume} or {error:message}.
+     * Options: target_size, axis (longest/x/y/z), hollow, optional lighting
+     * {direction:[x,y,z],strength:0..1}, optional untextured_block.
+     * Estimates preserve proportions and run before voxel-grid allocation.
+     */
+    planJson(optionsJson: string): string;
+
+    /**
+     * Import using plan_json's options. Anchored at (0,0,0), with exact
+     * axis-based uniform scaling. Hollow uses a sparse surface raster;
+     * lighting darkens sampled texture colours before palette matching.
+     * Rejects oversized/over-complex output with InvalidArgument.
+     */
+    toSchematic(optionsJson: string, palette: Palette, name: string): Schematic;
+}

package/VoxelModel.d.ts

@@ -0,0 +1,34 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Palette } from "./Palette.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A parsed GLB/OBJ, reusable for size estimates and configured imports.
+ */
+export class VoxelModel {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Return {dimensions:[width,height,depth],volume} or {error:message}.
+     * Options: target_size, axis (longest/x/y/z), hollow, optional lighting
+     * {direction:[x,y,z],strength:0..1}, optional untextured_block.
+     * Estimates preserve proportions and run before voxel-grid allocation.
+     */
+    planJson(optionsJson: string): string;
+
+    /**
+     * Import using plan_json's options. Anchored at (0,0,0), with exact
+     * axis-based uniform scaling. Hollow uses a sparse surface raster;
+     * lighting darkens sampled texture colours before palette matching.
+     * Rejects oversized/over-complex output with InvalidArgument.
+     */
+    toSchematic(optionsJson: string, palette: Palette, name: string): Schematic;
+}

package/VoxelModel.mjs

@@ -0,0 +1,113 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import { Palette } from "./Palette.mjs"
+import { Schematic } from "./Schematic.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const VoxelModel_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.VoxelModel_destroy(ptr);
+});
+
+/**
+ * A parsed GLB/OBJ, reusable for size estimates and configured imports.
+ */
+export class VoxelModel {
+    // Internal ptr reference:
+    #ptr = null;
+
+    // Lifetimes are only to keep dependencies alive.
+    // Since JS won't garbage collect until there are no incoming edges.
+    #selfEdge = [];
+
+    #internalConstructor(symbol, ptr, selfEdge) {
+        if (symbol !== diplomatRuntime.internalConstructor) {
+            console.error("VoxelModel is an Opaque type. You cannot call its constructor.");
+            return;
+        }
+        this.#ptr = ptr;
+        this.#selfEdge = selfEdge;
+
+        // Are we being borrowed? If not, we can register.
+        if (this.#selfEdge.length === 0) {
+            VoxelModel_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Return {dimensions:[width,height,depth],volume} or {error:message}.
+     * Options: target_size, axis (longest/x/y/z), hollow, optional lighting
+     * {direction:[x,y,z],strength:0..1}, optional untextured_block.
+     * Estimates preserve proportions and run before voxel-grid allocation.
+     */
+    planJson(optionsJson) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const optionsJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, optionsJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.VoxelModel_plan_json(diplomatReceive.buffer, this.ffiValue, optionsJsonSlice.ptr, 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();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+            write.free();
+        }
+    }
+
+    /**
+     * Import using plan_json's options. Anchored at (0,0,0), with exact
+     * axis-based uniform scaling. Hollow uses a sparse surface raster;
+     * lighting darkens sampled texture colours before palette matching.
+     * Rejects oversized/over-complex output with InvalidArgument.
+     */
+    toSchematic(optionsJson, palette, name) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const optionsJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, optionsJson)));
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.VoxelModel_to_schematic(diplomatReceive.buffer, this.ffiValue, optionsJsonSlice.ptr, palette.ffiValue, nameSlice.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();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/Voxelizer.d.mts

@@ -3,6 +3,7 @@ import type { NucleationError } from "./NucleationError.mjs"
 import type { Palette } from "./Palette.mjs"
 import type { Schematic } from "./Schematic.mjs"
 import type { Shape } from "./Shape.mjs"
+import type { VoxelModel } from "./VoxelModel.mjs"
 import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
 
 
@@ -18,6 +19,27 @@ export class Voxelizer {
     constructor();
 
 
+    /**
+     * Reason the last configured model import failed; cleared on success.
+     */
+    static lastErrorDetail(): string;
+
+    /**
+     * PHP-friendly GLB input: avoids expanding every byte into a boxed
+     * integer array before copying it over FFI.
+     */
+    static loadGlbBase64(data: string): VoxelModel;
+
+    /**
+     * Parse a GLB once for axis-based size estimates and lit voxelization.
+     */
+    static loadGlb(data: Array<number>): VoxelModel;
+
+    /**
+     * Parse an OBJ once for axis-based size estimates and lit voxelization.
+     */
+    static loadObj(text: string): VoxelModel;
+
     /**
      * Load a binary glTF (`.glb`, embedded buffers/images) and voxelize
      * it into a fillable Shape: the model is uniformly scaled so its

package/Voxelizer.d.ts

@@ -3,6 +3,7 @@ import type { NucleationError } from "./NucleationError.mjs"
 import type { Palette } from "./Palette.mjs"
 import type { Schematic } from "./Schematic.mjs"
 import type { Shape } from "./Shape.mjs"
+import type { VoxelModel } from "./VoxelModel.mjs"
 import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
 
 
@@ -18,6 +19,27 @@ export class Voxelizer {
     constructor();
 
 
+    /**
+     * Reason the last configured model import failed; cleared on success.
+     */
+    static lastErrorDetail(): string;
+
+    /**
+     * PHP-friendly GLB input: avoids expanding every byte into a boxed
+     * integer array before copying it over FFI.
+     */
+    static loadGlbBase64(data: string): VoxelModel;
+
+    /**
+     * Parse a GLB once for axis-based size estimates and lit voxelization.
+     */
+    static loadGlb(data: Array<number>): VoxelModel;
+
+    /**
+     * Parse an OBJ once for axis-based size estimates and lit voxelization.
+     */
+    static loadObj(text: string): VoxelModel;
+
     /**
      * Load a binary glTF (`.glb`, embedded buffers/images) and voxelize
      * it into a fillable Shape: the model is uniformly scaled so its

package/Voxelizer.mjs

@@ -3,6 +3,7 @@ import { NucleationError } from "./NucleationError.mjs"
 import { Palette } from "./Palette.mjs"
 import { Schematic } from "./Schematic.mjs"
 import { Shape } from "./Shape.mjs"
+import { VoxelModel } from "./VoxelModel.mjs"
 import wasm from "./diplomat-wasm.mjs";
 import * as diplomatRuntime from "./diplomat-runtime.mjs";
 
@@ -43,6 +44,109 @@ export class Voxelizer {
     }
 
 
+    /**
+     * Reason the last configured model import failed; cleared on success.
+     */
+    static lastErrorDetail() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Voxelizer_last_error_detail(write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * PHP-friendly GLB input: avoids expanding every byte into a boxed
+     * integer array before copying it over FFI.
+     */
+    static loadGlbBase64(data) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const dataSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, data)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Voxelizer_load_glb_base64(diplomatReceive.buffer, dataSlice.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 VoxelModel(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Parse a GLB once for axis-based size estimates and lit voxelization.
+     */
+    static loadGlb(data) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const dataSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, data, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Voxelizer_load_glb(diplomatReceive.buffer, dataSlice.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 VoxelModel(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Parse an OBJ once for axis-based size estimates and lit voxelization.
+     */
+    static loadObj(text) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const textSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, text)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Voxelizer_load_obj(diplomatReceive.buffer, textSlice.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 VoxelModel(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
     /**
      * Load a binary glTF (`.glb`, embedded buffers/images) and voxelize
      * it into a fillable Shape: the model is uniformly scaled so its

package/index.d.mts

@@ -142,6 +142,8 @@ export { Store } from "./Store.mjs"
 
 export { StoreIo } from "./StoreIo.mjs"
 
+export { VoxelModel } from "./VoxelModel.mjs"
+
 export { Voxelizer } from "./Voxelizer.mjs"
 
 export { CellularSdfConfig } from "./CellularSdfConfig.mjs"

package/index.d.ts

@@ -142,6 +142,8 @@ export { Store } from "./Store.mjs"
 
 export { StoreIo } from "./StoreIo.mjs"
 
+export { VoxelModel } from "./VoxelModel.mjs"
+
 export { Voxelizer } from "./Voxelizer.mjs"
 
 export { CellularSdfConfig } from "./CellularSdfConfig.mjs"

package/index.mjs

@@ -140,6 +140,8 @@ export { Store } from "./Store.mjs"
 
 export { StoreIo } from "./StoreIo.mjs"
 
+export { VoxelModel } from "./VoxelModel.mjs"
+
 export { Voxelizer } from "./Voxelizer.mjs"
 
 export { CellularSdfConfig } from "./CellularSdfConfig.mjs"

package/package.json

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