nucleation 0.10.21 → 0.10.23

package/renderer/ResourcePack.d.ts

@@ -0,0 +1,105 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { ResourcePackList } from "./ResourcePackList.mjs"
+import type { TextureInfo } from "./TextureInfo.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A loaded (possibly merged) Minecraft resource pack.
+ * Wraps {@link crate::meshing::ResourcePackSource}.
+ */
+export class ResourcePack {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Load a resource pack from an in-memory ZIP buffer.
+     */
+    static fromBytes(data: Array<number>): ResourcePack;
+
+    /**
+     * Load and merge multiple resource packs, lowest priority first.
+     */
+    static fromList(list: ResourcePackList): ResourcePack;
+
+    /**
+     * Number of blockstate definitions in the pack.
+     */
+    blockstateCount(): number;
+
+    /**
+     * Number of model definitions in the pack.
+     */
+    modelCount(): number;
+
+    /**
+     * Number of textures in the pack.
+     */
+    textureCount(): number;
+
+    /**
+     * Namespaces present in the pack, as a JSON array string.
+     */
+    namespacesJson(): string;
+
+    /**
+     * All blockstate identifiers, as a JSON array string.
+     */
+    listBlockstatesJson(): string;
+
+    /**
+     * All model identifiers, as a JSON array string.
+     */
+    listModelsJson(): string;
+
+    /**
+     * All texture identifiers, as a JSON array string.
+     */
+    listTexturesJson(): string;
+
+    /**
+     * The blockstate definition JSON for `name`; `NotFound` if absent.
+     */
+    getBlockstateJson(name: string): string;
+
+    /**
+     * The model definition JSON for `name`; `NotFound` if absent.
+     */
+    getModelJson(name: string): string;
+
+    /**
+     * Texture metadata (size, animation flag, frame count).
+     */
+    getTextureInfo(name: string): TextureInfo;
+
+    /**
+     * Raw RGBA pixels of a texture, base64-encoded.
+     */
+    getTexturePixelsB64(name: string): string;
+
+    /**
+     * Add (or override) a blockstate definition from a JSON string.
+     */
+    addBlockstateJson(name: string, json: string): void;
+
+    /**
+     * Add (or override) a model definition from a JSON string.
+     */
+    addModelJson(name: string, json: string): void;
+
+    /**
+     * Add a raw RGBA texture (`pixels` length must be `width * height * 4`).
+     */
+    addTexture(name: string, width: number, height: number, pixels: Array<number>): void;
+
+    /**
+     * Register a MeshExporter with the FormatManager so `save_as("mesh", ...)`
+     * works. (Old ABI: `schematic_register_mesh_exporter`.)
+     */
+    registerMeshExporter(): void;
+}

package/renderer/ResourcePack.mjs

@@ -0,0 +1,447 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import { ResourcePackList } from "./ResourcePackList.mjs"
+import { TextureInfo } from "./TextureInfo.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const ResourcePack_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.ResourcePack_destroy(ptr);
+});
+
+/**
+ * A loaded (possibly merged) Minecraft resource pack.
+ * Wraps {@link crate::meshing::ResourcePackSource}.
+ */
+export class ResourcePack {
+    // 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("ResourcePack 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) {
+            ResourcePack_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Load a resource pack from an in-memory ZIP buffer.
+     */
+    static fromBytes(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.ResourcePack_from_bytes(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 ResourcePack(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Load and merge multiple resource packs, lowest priority first.
+     */
+    static fromList(list) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ResourcePack_from_list(diplomatReceive.buffer, list.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 ResourcePack(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Number of blockstate definitions in the pack.
+     */
+    blockstateCount() {
+
+        const result = wasm.ResourcePack_blockstate_count(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Number of model definitions in the pack.
+     */
+    modelCount() {
+
+        const result = wasm.ResourcePack_model_count(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Number of textures in the pack.
+     */
+    textureCount() {
+
+        const result = wasm.ResourcePack_texture_count(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Namespaces present in the pack, as a JSON array string.
+     */
+    namespacesJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.ResourcePack_namespaces_json(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * All blockstate identifiers, as a JSON array string.
+     */
+    listBlockstatesJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.ResourcePack_list_blockstates_json(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * All model identifiers, as a JSON array string.
+     */
+    listModelsJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.ResourcePack_list_models_json(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * All texture identifiers, as a JSON array string.
+     */
+    listTexturesJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.ResourcePack_list_textures_json(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * The blockstate definition JSON for `name`; `NotFound` if absent.
+     */
+    getBlockstateJson(name) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.ResourcePack_get_blockstate_json(diplomatReceive.buffer, this.ffiValue, nameSlice.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();
+        }
+    }
+
+    /**
+     * The model definition JSON for `name`; `NotFound` if absent.
+     */
+    getModelJson(name) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.ResourcePack_get_model_json(diplomatReceive.buffer, this.ffiValue, nameSlice.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();
+        }
+    }
+
+    /**
+     * Texture metadata (size, animation flag, frame count).
+     */
+    getTextureInfo(name) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 17, 4, true);
+
+
+        const result = wasm.ResourcePack_get_texture_info(diplomatReceive.buffer, this.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 TextureInfo._fromFFI(diplomatRuntime.internalConstructor, diplomatReceive.buffer);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Raw RGBA pixels of a texture, base64-encoded.
+     */
+    getTexturePixelsB64(name) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.ResourcePack_get_texture_pixels_b64(diplomatReceive.buffer, this.ffiValue, nameSlice.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();
+        }
+    }
+
+    /**
+     * Add (or override) a blockstate definition from a JSON string.
+     */
+    addBlockstateJson(name, json) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const jsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, json)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ResourcePack_add_blockstate_json(diplomatReceive.buffer, this.ffiValue, nameSlice.ptr, jsonSlice.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();
+        }
+    }
+
+    /**
+     * Add (or override) a model definition from a JSON string.
+     */
+    addModelJson(name, json) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const jsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, json)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ResourcePack_add_model_json(diplomatReceive.buffer, this.ffiValue, nameSlice.ptr, jsonSlice.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();
+        }
+    }
+
+    /**
+     * Add a raw RGBA texture (`pixels` length must be `width * height * 4`).
+     */
+    addTexture(name, width, height, pixels) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const nameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, name)));
+        const pixelsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, pixels, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ResourcePack_add_texture(diplomatReceive.buffer, this.ffiValue, nameSlice.ptr, width, height, pixelsSlice.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();
+        }
+    }
+
+    /**
+     * Register a MeshExporter with the FormatManager so `save_as("mesh", ...)`
+     * works. (Old ABI: `schematic_register_mesh_exporter`.)
+     */
+    registerMeshExporter() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.ResourcePack_register_mesh_exporter(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 });
+            }
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/ResourcePackList.d.mts

@@ -0,0 +1,32 @@
+// generated by diplomat-tool
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Ordered list of raw resource-pack ZIP buffers, lowest priority first.
+ * Feed it to {@link ResourcePack::from_list}.
+ */
+export class ResourcePackList {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create an empty resource-pack list.
+     */
+    static create(): ResourcePackList;
+
+    /**
+     * Append one resource-pack ZIP buffer. Later buffers overlay earlier
+     * ones on per-key collision (Minecraft pack-ordering semantics).
+     */
+    add(data: Array<number>): void;
+
+    /**
+     * Number of pack buffers added so far.
+     */
+    len(): number;
+}

package/renderer/ResourcePackList.d.ts

@@ -0,0 +1,32 @@
+// generated by diplomat-tool
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Ordered list of raw resource-pack ZIP buffers, lowest priority first.
+ * Feed it to {@link ResourcePack::from_list}.
+ */
+export class ResourcePackList {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create an empty resource-pack list.
+     */
+    static create(): ResourcePackList;
+
+    /**
+     * Append one resource-pack ZIP buffer. Later buffers overlay earlier
+     * ones on per-key collision (Minecraft pack-ordering semantics).
+     */
+    add(data: Array<number>): void;
+
+    /**
+     * Number of pack buffers added so far.
+     */
+    len(): number;
+}

package/renderer/ResourcePackList.mjs

@@ -0,0 +1,96 @@
+// generated by diplomat-tool
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const ResourcePackList_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.ResourcePackList_destroy(ptr);
+});
+
+/**
+ * Ordered list of raw resource-pack ZIP buffers, lowest priority first.
+ * Feed it to {@link ResourcePack::from_list}.
+ */
+export class ResourcePackList {
+    // 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("ResourcePackList 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) {
+            ResourcePackList_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Create an empty resource-pack list.
+     */
+    static create() {
+
+        const result = wasm.ResourcePackList_create();
+
+        try {
+            return new ResourcePackList(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Append one resource-pack ZIP buffer. Later buffers overlay earlier
+     * ones on per-key collision (Minecraft pack-ordering semantics).
+     */
+    add(data) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const dataSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, data, "u8")));
+    wasm.ResourcePackList_add(this.ffiValue, dataSlice.ptr);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+        }
+    }
+
+    /**
+     * Number of pack buffers added so far.
+     */
+    len() {
+
+        const result = wasm.ResourcePackList_len(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}