nucleation 0.10.22 → 0.10.23

package/renderer/Value.d.ts

@@ -0,0 +1,73 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A typed circuit value (payload-carrying enum; PORTING rule 10).
+ */
+export class Value {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create an unsigned 32-bit integer value.
+     */
+    static fromU32(v: number): Value;
+
+    /**
+     * Create a signed 32-bit integer value.
+     */
+    static fromI32(v: number): Value;
+
+    /**
+     * Create a 32-bit IEEE 754 float value.
+     */
+    static fromF32(v: number): Value;
+
+    /**
+     * Create a boolean value.
+     */
+    static fromBool(v: boolean): Value;
+
+    /**
+     * Create a string value. Fails if the bytes are not valid UTF-8.
+     */
+    static fromString(s: string): Value;
+
+    /**
+     * The value as u32. Also accepts u64/non-negative signed ints that
+     * fit, and bool (false → 0, true → 1); fails otherwise.
+     */
+    asU32(): number;
+
+    /**
+     * The value as i32. Also accepts i64 values in i32 range; fails for
+     * other types.
+     */
+    asI32(): number;
+
+    /**
+     * The value as f32; fails if this is not an f32 value.
+     */
+    asF32(): number;
+
+    /**
+     * The value as bool; fails if this is not a bool value.
+     */
+    asBool(): boolean;
+
+    /**
+     * The string payload; fails if this is not a string value.
+     */
+    asString(): string;
+
+    /**
+     * The type name (e.g. "u32", "bool", "string").
+     */
+    typeName(): string;
+}

package/renderer/Value.mjs

@@ -0,0 +1,275 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const Value_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.Value_destroy(ptr);
+});
+
+/**
+ * A typed circuit value (payload-carrying enum; PORTING rule 10).
+ */
+export class Value {
+    // 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("Value 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) {
+            Value_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Create an unsigned 32-bit integer value.
+     */
+    static fromU32(v) {
+
+        const result = wasm.Value_from_u32(v);
+
+        try {
+            return new Value(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Create a signed 32-bit integer value.
+     */
+    static fromI32(v) {
+
+        const result = wasm.Value_from_i32(v);
+
+        try {
+            return new Value(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Create a 32-bit IEEE 754 float value.
+     */
+    static fromF32(v) {
+
+        const result = wasm.Value_from_f32(v);
+
+        try {
+            return new Value(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Create a boolean value.
+     */
+    static fromBool(v) {
+
+        const result = wasm.Value_from_bool(v);
+
+        try {
+            return new Value(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Create a string value. Fails if the bytes are not valid UTF-8.
+     */
+    static fromString(s) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const sSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, s)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Value_from_string(diplomatReceive.buffer, sSlice.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 Value(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * The value as u32. Also accepts u64/non-negative signed ints that
+     * fit, and bool (false → 0, true → 1); fails otherwise.
+     */
+    asU32() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Value_as_u32(diplomatReceive.buffer, this.ffiValue);
+
+        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 Uint32Array(wasm.memory.buffer, diplomatReceive.buffer, 1))[0];
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * The value as i32. Also accepts i64 values in i32 range; fails for
+     * other types.
+     */
+    asI32() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Value_as_i32(diplomatReceive.buffer, this.ffiValue);
+
+        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 Int32Array(wasm.memory.buffer, diplomatReceive.buffer, 1))[0];
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * The value as f32; fails if this is not an f32 value.
+     */
+    asF32() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Value_as_f32(diplomatReceive.buffer, this.ffiValue);
+
+        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 Float32Array(wasm.memory.buffer, diplomatReceive.buffer, 1))[0];
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * The value as bool; fails if this is not a bool value.
+     */
+    asBool() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 1, true);
+
+
+        const result = wasm.Value_as_bool(diplomatReceive.buffer, this.ffiValue);
+
+        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 Uint8Array(wasm.memory.buffer, diplomatReceive.buffer, 1))[0] === 1;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * The string payload; fails if this is not a string value.
+     */
+    asString() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Value_as_string(diplomatReceive.buffer, this.ffiValue, 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 type name (e.g. "u32", "bool", "string").
+     */
+    typeName() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Value_type_name(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/VideoConfig.d.mts

@@ -0,0 +1,15 @@
+// generated by diplomat-tool
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Native FFmpeg video output preset.
+ */
+export class VideoConfig {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+}

package/renderer/VideoConfig.d.ts

@@ -0,0 +1,15 @@
+// generated by diplomat-tool
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Native FFmpeg video output preset.
+ */
+export class VideoConfig {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+}

package/renderer/VideoConfig.mjs

@@ -0,0 +1,44 @@
+// generated by diplomat-tool
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const VideoConfig_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.VideoConfig_destroy(ptr);
+});
+
+/**
+ * Native FFmpeg video output preset.
+ */
+export class VideoConfig {
+    // 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("VideoConfig 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) {
+            VideoConfig_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/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/renderer/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/renderer/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/renderer/Voxelizer.d.mts

@@ -0,0 +1,80 @@
+// generated by diplomat-tool
+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";
+
+
+
+/**
+ * Namespace for the mesh-voxelization entry points (GLB/OBJ → shapes
+ * and textured schematics).
+ */
+export class Voxelizer {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    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
+     * largest dimension equals `target_size` voxels, centered on x/z
+     * with its base resting at y = 0. Solidity is a parity test at each
+     * voxel center (robust on closed meshes), plus — when `shell` > 0 —
+     * every voxel whose center is within `shell` blocks of the surface,
+     * which rescues thin walls and hollow vessels (0.7–1.0 closes
+     * single-voxel shells; 0 = pure parity; a *negative* `shell` is
+     * surface-only — a skin |shell| blocks thick with no interior fill,
+     * for open sheets/ribbons that dip or self-overlap). Errors with `Parse` on
+     * malformed/triangle-less GLB and `InvalidArgument` on a
+     * non-positive `target_size`.
+     */
+    static shapeFromGlb(data: Array<number>, targetSize: number, shell: number): Shape;
+
+    /**
+     * Load a Wavefront OBJ (`v`/`vt`/`f` lines; polygon faces are
+     * fan-triangulated, negative indices supported, materials ignored)
+     * and voxelize it into a fillable Shape, fitted and shelled exactly
+     * like `shape_from_glb`. Errors with `Parse` on malformed/triangle-less
+     * OBJ and `InvalidArgument` on invalid UTF-8 or a non-positive
+     * `target_size`.
+     */
+    static shapeFromObj(text: string, targetSize: number, shell: number): Shape;
+
+    /**
+     * Load a binary glTF and voxelize it directly into a textured
+     * schematic named `name`: every solid voxel becomes the `palette`
+     * block closest to its nearest-surface texture color (interior
+     * voxels inherit the nearest surface color; voxels without texture
+     * info snap to mid-gray). `shell` behaves as in `shape_from_glb` —
+     * use ~0.7 for thin-walled models. Errors with `Parse` on malformed GLB and
+     * `InvalidArgument` on invalid UTF-8 or a non-positive
+     * `target_size`.
+     */
+    static schematicFromGlbTextured(data: Array<number>, targetSize: number, shell: number, palette: Palette, name: string): Schematic;
+}