nucleation 0.2.18 → 0.3.1

package/Renderer.d.ts

@@ -0,0 +1,35 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError"
+import type { RenderConfig } from "./RenderConfig"
+import type { Schematic } from "./Schematic"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Namespace type for the render entry points (PORTING rule 12).
+ */
+export class Renderer {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Render a schematic to raw RGBA pixel bytes, written as base64
+     * (PORTING rule 6). `pack_zip` is a resource-pack zip in memory.
+     */
+    static renderPixelsB64(schematic: Schematic, packZip: Array<number>, config: RenderConfig): string;
+
+    /**
+     * Render a schematic to PNG bytes, written as base64 (PORTING rule 6).
+     * `pack_zip` is a resource-pack zip in memory.
+     */
+    static renderPngB64(schematic: Schematic, packZip: Array<number>, config: RenderConfig): string;
+
+    /**
+     * Render a schematic to a PNG file at `path`.
+     */
+    static renderToFile(schematic: Schematic, packZip: Array<number>, config: RenderConfig, path: string): void;
+}

package/Renderer.mjs

@@ -0,0 +1,139 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import { RenderConfig } from "./RenderConfig.mjs"
+import { Schematic } from "./Schematic.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const Renderer_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.Renderer_destroy(ptr);
+});
+
+/**
+ * Namespace type for the render entry points (PORTING rule 12).
+ */
+export class Renderer {
+    // 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("Renderer 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) {
+            Renderer_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Render a schematic to raw RGBA pixel bytes, written as base64
+     * (PORTING rule 6). `pack_zip` is a resource-pack zip in memory.
+     */
+    static renderPixelsB64(schematic, packZip, config) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const packZipSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, packZip, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Renderer_render_pixels_b64(diplomatReceive.buffer, schematic.ffiValue, packZipSlice.ptr, config.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();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+            write.free();
+        }
+    }
+
+    /**
+     * Render a schematic to PNG bytes, written as base64 (PORTING rule 6).
+     * `pack_zip` is a resource-pack zip in memory.
+     */
+    static renderPngB64(schematic, packZip, config) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const packZipSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, packZip, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Renderer_render_png_b64(diplomatReceive.buffer, schematic.ffiValue, packZipSlice.ptr, config.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();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+            write.free();
+        }
+    }
+
+    /**
+     * Render a schematic to a PNG file at `path`.
+     */
+    static renderToFile(schematic, packZip, config, path) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const packZipSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, packZip, "u8")));
+        const pathSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, path)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Renderer_render_to_file(diplomatReceive.buffer, schematic.ffiValue, packZipSlice.ptr, config.ffiValue, pathSlice.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();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/ResourcePack.d.ts

@@ -0,0 +1,105 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError"
+import type { ResourcePackList } from "./ResourcePackList"
+import type { TextureInfo } from "./TextureInfo"
+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;
+}