nucleation 0.10.22 → 0.10.23

package/renderer/ItemModelConfig.d.mts

@@ -0,0 +1,65 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Item model generation configuration. Wraps {@link crate::meshing::ItemModelConfig}.
+ */
+export class ItemModelConfig {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create a config for a model named `model_name` (used in resource-pack
+     * file paths). Other options start at their defaults: namespace
+     * "nucleation", centered, 16px texture resolution, item "paper",
+     * custom model data "1", auto scale.
+     */
+    static create(modelName: string): ItemModelConfig;
+
+    /**
+     * Set the resource-pack namespace (default: "nucleation").
+     */
+    setNamespace(namespace: string): void;
+
+    /**
+     * Center the schematic within the model bounds (default: true).
+     */
+    setCenter(center: boolean): void;
+
+    /**
+     * Set the texture resolution in pixels per block face (default: 16).
+     */
+    setTextureResolution(resolution: number): void;
+
+    /**
+     * Set the Minecraft item the model binds to (default: "paper").
+     */
+    setItem(item: string): void;
+
+    /**
+     * Set the custom-model-data string used to select this model in game
+     * (default: "1").
+     */
+    setCustomModelData(cmd: string): void;
+
+    /**
+     * Uniform scale.
+     */
+    setScale(scale: number): void;
+
+    /**
+     * Per-axis scale.
+     */
+    setScaleXyz(sx: number, sy: number, sz: number): void;
+
+    /**
+     * Auto-fit scale.
+     */
+    setScaleAuto(): void;
+}

package/renderer/ItemModelConfig.d.ts

@@ -0,0 +1,65 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Item model generation configuration. Wraps {@link crate::meshing::ItemModelConfig}.
+ */
+export class ItemModelConfig {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create a config for a model named `model_name` (used in resource-pack
+     * file paths). Other options start at their defaults: namespace
+     * "nucleation", centered, 16px texture resolution, item "paper",
+     * custom model data "1", auto scale.
+     */
+    static create(modelName: string): ItemModelConfig;
+
+    /**
+     * Set the resource-pack namespace (default: "nucleation").
+     */
+    setNamespace(namespace: string): void;
+
+    /**
+     * Center the schematic within the model bounds (default: true).
+     */
+    setCenter(center: boolean): void;
+
+    /**
+     * Set the texture resolution in pixels per block face (default: 16).
+     */
+    setTextureResolution(resolution: number): void;
+
+    /**
+     * Set the Minecraft item the model binds to (default: "paper").
+     */
+    setItem(item: string): void;
+
+    /**
+     * Set the custom-model-data string used to select this model in game
+     * (default: "1").
+     */
+    setCustomModelData(cmd: string): void;
+
+    /**
+     * Uniform scale.
+     */
+    setScale(scale: number): void;
+
+    /**
+     * Per-axis scale.
+     */
+    setScaleXyz(sx: number, sy: number, sz: number): void;
+
+    /**
+     * Auto-fit scale.
+     */
+    setScaleAuto(): void;
+}

package/renderer/ItemModelConfig.mjs

@@ -0,0 +1,223 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const ItemModelConfig_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.ItemModelConfig_destroy(ptr);
+});
+
+/**
+ * Item model generation configuration. Wraps {@link crate::meshing::ItemModelConfig}.
+ */
+export class ItemModelConfig {
+    // 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("ItemModelConfig 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) {
+            ItemModelConfig_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Create a config for a model named `model_name` (used in resource-pack
+     * file paths). Other options start at their defaults: namespace
+     * "nucleation", centered, 16px texture resolution, item "paper",
+     * custom model data "1", auto scale.
+     */
+    static create(modelName) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const modelNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, modelName)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ItemModelConfig_create(diplomatReceive.buffer, modelNameSlice.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 ItemModelConfig(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Set the resource-pack namespace (default: "nucleation").
+     */
+    setNamespace(namespace) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const namespaceSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, namespace)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ItemModelConfig_set_namespace(diplomatReceive.buffer, this.ffiValue, namespaceSlice.ptr);
+
+        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();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Center the schematic within the model bounds (default: true).
+     */
+    setCenter(center) {
+    wasm.ItemModelConfig_set_center(this.ffiValue, center);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Set the texture resolution in pixels per block face (default: 16).
+     */
+    setTextureResolution(resolution) {
+    wasm.ItemModelConfig_set_texture_resolution(this.ffiValue, resolution);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Set the Minecraft item the model binds to (default: "paper").
+     */
+    setItem(item) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const itemSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, item)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ItemModelConfig_set_item(diplomatReceive.buffer, this.ffiValue, itemSlice.ptr);
+
+        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();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Set the custom-model-data string used to select this model in game
+     * (default: "1").
+     */
+    setCustomModelData(cmd) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const cmdSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, cmd)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ItemModelConfig_set_custom_model_data(diplomatReceive.buffer, this.ffiValue, cmdSlice.ptr);
+
+        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();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Uniform scale.
+     */
+    setScale(scale) {
+    wasm.ItemModelConfig_set_scale(this.ffiValue, scale);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Per-axis scale.
+     */
+    setScaleXyz(sx, sy, sz) {
+    wasm.ItemModelConfig_set_scale_xyz(this.ffiValue, sx, sy, sz);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Auto-fit scale.
+     */
+    setScaleAuto() {
+    wasm.ItemModelConfig_set_scale_auto(this.ffiValue);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/ItemModelPackBuilder.d.mts

@@ -0,0 +1,32 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Accumulates {@link ItemModelResult}s to build a combined resource pack ZIP
+ * (old ABI: `itemmodel_build_resource_pack` took an array of pointers).
+ */
+export class ItemModelPackBuilder {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create an empty pack builder.
+     */
+    static create(): ItemModelPackBuilder;
+
+    /**
+     * Number of results added so far.
+     */
+    len(): number;
+
+    /**
+     * Build a resource pack ZIP from every added result, base64-encoded.
+     */
+    buildZipB64(): string;
+}

package/renderer/ItemModelPackBuilder.d.ts

@@ -0,0 +1,32 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Accumulates {@link ItemModelResult}s to build a combined resource pack ZIP
+ * (old ABI: `itemmodel_build_resource_pack` took an array of pointers).
+ */
+export class ItemModelPackBuilder {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create an empty pack builder.
+     */
+    static create(): ItemModelPackBuilder;
+
+    /**
+     * Number of results added so far.
+     */
+    len(): number;
+
+    /**
+     * Build a resource pack ZIP from every added result, base64-encoded.
+     */
+    buildZipB64(): string;
+}

package/renderer/ItemModelPackBuilder.mjs

@@ -0,0 +1,104 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const ItemModelPackBuilder_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.ItemModelPackBuilder_destroy(ptr);
+});
+
+/**
+ * Accumulates {@link ItemModelResult}s to build a combined resource pack ZIP
+ * (old ABI: `itemmodel_build_resource_pack` took an array of pointers).
+ */
+export class ItemModelPackBuilder {
+    // 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("ItemModelPackBuilder 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) {
+            ItemModelPackBuilder_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Create an empty pack builder.
+     */
+    static create() {
+
+        const result = wasm.ItemModelPackBuilder_create();
+
+        try {
+            return new ItemModelPackBuilder(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Number of results added so far.
+     */
+    len() {
+
+        const result = wasm.ItemModelPackBuilder_len(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Build a resource pack ZIP from every added result, base64-encoded.
+     */
+    buildZipB64() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.ItemModelPackBuilder_build_zip_b64(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();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/ItemModelResult.d.mts

@@ -0,0 +1,72 @@
+// generated by diplomat-tool
+import type { Dimensions } from "./Dimensions.mjs"
+import type { ItemModelConfig } from "./ItemModelConfig.mjs"
+import type { ItemModelPackBuilder } from "./ItemModelPackBuilder.mjs"
+import type { ItemScale } from "./ItemScale.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { ResourcePack } from "./ResourcePack.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A generated item model. Wraps {@link crate::meshing::ItemModelResult}.
+ *
+ * Holds `Option<...>` because {@link ItemModelResult::add_to_pack} moves the
+ * inner value into an {@link ItemModelPackBuilder} (PORTING rule 11); accessors
+ * return `AlreadyConsumed` afterwards.
+ */
+export class ItemModelResult {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Generate an item model from a schematic (old ABI: `schematic_to_item_model`).
+     */
+    static create(schematic: Schematic, pack: ResourcePack, config: ItemModelConfig): ItemModelResult;
+
+    /**
+     * The Minecraft item model JSON.
+     */
+    modelJson(): string;
+
+    /**
+     * Number of elements (cuboids) in the generated model.
+     */
+    elementCount(): number;
+
+    /**
+     * Number of textures the generated model uses.
+     */
+    textureCount(): number;
+
+    /**
+     * Number of textured planes in the generated model.
+     */
+    planeCount(): number;
+
+    /**
+     * Source schematic dimensions in blocks.
+     */
+    dimensions(): Dimensions;
+
+    /**
+     * The applied model scale (old ABI: `itemmodel_result_scale`).
+     */
+    scale(): ItemScale;
+
+    /**
+     * A single-model resource pack ZIP, base64-encoded.
+     */
+    toResourcePackZipB64(): string;
+
+    /**
+     * Move this result into a pack builder. Consumes the result: further
+     * accessor calls return `AlreadyConsumed`.
+     */
+    addToPack(builder: ItemModelPackBuilder): void;
+}

package/renderer/ItemModelResult.d.ts

@@ -0,0 +1,72 @@
+// generated by diplomat-tool
+import type { Dimensions } from "./Dimensions.mjs"
+import type { ItemModelConfig } from "./ItemModelConfig.mjs"
+import type { ItemModelPackBuilder } from "./ItemModelPackBuilder.mjs"
+import type { ItemScale } from "./ItemScale.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { ResourcePack } from "./ResourcePack.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A generated item model. Wraps {@link crate::meshing::ItemModelResult}.
+ *
+ * Holds `Option<...>` because {@link ItemModelResult::add_to_pack} moves the
+ * inner value into an {@link ItemModelPackBuilder} (PORTING rule 11); accessors
+ * return `AlreadyConsumed` afterwards.
+ */
+export class ItemModelResult {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Generate an item model from a schematic (old ABI: `schematic_to_item_model`).
+     */
+    static create(schematic: Schematic, pack: ResourcePack, config: ItemModelConfig): ItemModelResult;
+
+    /**
+     * The Minecraft item model JSON.
+     */
+    modelJson(): string;
+
+    /**
+     * Number of elements (cuboids) in the generated model.
+     */
+    elementCount(): number;
+
+    /**
+     * Number of textures the generated model uses.
+     */
+    textureCount(): number;
+
+    /**
+     * Number of textured planes in the generated model.
+     */
+    planeCount(): number;
+
+    /**
+     * Source schematic dimensions in blocks.
+     */
+    dimensions(): Dimensions;
+
+    /**
+     * The applied model scale (old ABI: `itemmodel_result_scale`).
+     */
+    scale(): ItemScale;
+
+    /**
+     * A single-model resource pack ZIP, base64-encoded.
+     */
+    toResourcePackZipB64(): string;
+
+    /**
+     * Move this result into a pack builder. Consumes the result: further
+     * accessor calls return `AlreadyConsumed`.
+     */
+    addToPack(builder: ItemModelPackBuilder): void;
+}