nucleation 0.10.22 → 0.10.24

package/renderer/WorldSink.d.ts

@@ -0,0 +1,50 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { WorldChunkView } from "./WorldChunkView.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A world writer. `finish` is consuming (PORTING rule 11): the inner sink is
+ * held in an `Option` and taken on `finish`; every method afterwards returns
+ * `AlreadyConsumed`. Dropping the handle without `finish` abandons the sink.
+ */
+export class WorldSink {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create a new world sink that writes fresh chunk data to `dir`.
+     * `options_json` is a serialized `WorldExportOptions` (empty string =
+     * defaults).
+     */
+    static create(dir: string, optionsJson: string): WorldSink;
+
+    /**
+     * Open an existing world directory for patching via `put_chunk`.
+     */
+    static openExisting(dir: string): WorldSink;
+
+    /**
+     * Write (append) a chunk view into the sink. The view is not consumed.
+     */
+    writeChunk(view: WorldChunkView): void;
+
+    /**
+     * Overwrite the chunk at (`view.cx`, `view.cz`) of the sink's world with
+     * the supplied view's block data. Only valid on sinks opened with
+     * `open_existing`; errors with `Io` on a create-mode sink. The view is
+     * not consumed.
+     */
+    putChunk(view: WorldChunkView): void;
+
+    /**
+     * Finalise and flush all pending writes. Consuming (PORTING rule 11):
+     * afterwards every method on this sink returns `AlreadyConsumed`.
+     */
+    finish(): void;
+}

package/renderer/WorldSink.mjs

@@ -0,0 +1,177 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import { WorldChunkView } from "./WorldChunkView.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const WorldSink_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.WorldSink_destroy(ptr);
+});
+
+/**
+ * A world writer. `finish` is consuming (PORTING rule 11): the inner sink is
+ * held in an `Option` and taken on `finish`; every method afterwards returns
+ * `AlreadyConsumed`. Dropping the handle without `finish` abandons the sink.
+ */
+export class WorldSink {
+    // 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("WorldSink 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) {
+            WorldSink_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Create a new world sink that writes fresh chunk data to `dir`.
+     * `options_json` is a serialized `WorldExportOptions` (empty string =
+     * defaults).
+     */
+    static create(dir, optionsJson) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const dirSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, dir)));
+        const optionsJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, optionsJson)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.WorldSink_create(diplomatReceive.buffer, dirSlice.ptr, optionsJsonSlice.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 WorldSink(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Open an existing world directory for patching via `put_chunk`.
+     */
+    static openExisting(dir) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const dirSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, dir)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.WorldSink_open_existing(diplomatReceive.buffer, dirSlice.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 WorldSink(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Write (append) a chunk view into the sink. The view is not consumed.
+     */
+    writeChunk(view) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.WorldSink_write_chunk(diplomatReceive.buffer, this.ffiValue, view.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();
+        }
+    }
+
+    /**
+     * Overwrite the chunk at (`view.cx`, `view.cz`) of the sink's world with
+     * the supplied view's block data. Only valid on sinks opened with
+     * `open_existing`; errors with `Io` on a create-mode sink. The view is
+     * not consumed.
+     */
+    putChunk(view) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.WorldSink_put_chunk(diplomatReceive.buffer, this.ffiValue, view.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();
+        }
+    }
+
+    /**
+     * Finalise and flush all pending writes. Consuming (PORTING rule 11):
+     * afterwards every method on this sink returns `AlreadyConsumed`.
+     */
+    finish() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.WorldSink_finish(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/WorldStream.d.mts

@@ -0,0 +1,45 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { WorldChunkView } from "./WorldChunkView.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A streaming iterator over the chunks of a world.
+ */
+export class WorldStream {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Open a streaming iterator over a world directory.
+     */
+    static openDir(path: string): WorldStream;
+
+    /**
+     * Open a streaming iterator over a world directory, bounded to the given
+     * block-coordinate box `[min_x..max_x, min_y..max_y, min_z..max_z]`.
+     */
+    static openDirBounded(path: string, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): WorldStream;
+
+    /**
+     * Open a streaming iterator from a zip archive in memory.
+     */
+    static fromZip(data: Array<number>): WorldStream;
+
+    /**
+     * Open a bounded streaming iterator from a zip archive in memory.
+     */
+    static fromZipBounded(data: Array<number>, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): WorldStream;
+
+    /**
+     * Advance the iterator and return the next chunk view. Errors with
+     * `NotFound` at end-of-stream (the old ABI returned NULL). Corrupt
+     * chunks are silently skipped, matching the old ABI.
+     */
+    next(): WorldChunkView;
+}

package/renderer/WorldStream.d.ts

@@ -0,0 +1,45 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { WorldChunkView } from "./WorldChunkView.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A streaming iterator over the chunks of a world.
+ */
+export class WorldStream {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Open a streaming iterator over a world directory.
+     */
+    static openDir(path: string): WorldStream;
+
+    /**
+     * Open a streaming iterator over a world directory, bounded to the given
+     * block-coordinate box `[min_x..max_x, min_y..max_y, min_z..max_z]`.
+     */
+    static openDirBounded(path: string, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): WorldStream;
+
+    /**
+     * Open a streaming iterator from a zip archive in memory.
+     */
+    static fromZip(data: Array<number>): WorldStream;
+
+    /**
+     * Open a bounded streaming iterator from a zip archive in memory.
+     */
+    static fromZipBounded(data: Array<number>, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): WorldStream;
+
+    /**
+     * Advance the iterator and return the next chunk view. Errors with
+     * `NotFound` at end-of-stream (the old ABI returned NULL). Corrupt
+     * chunks are silently skipped, matching the old ABI.
+     */
+    next(): WorldChunkView;
+}

package/renderer/WorldStream.mjs

@@ -0,0 +1,184 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import { WorldChunkView } from "./WorldChunkView.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const WorldStream_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.WorldStream_destroy(ptr);
+});
+
+/**
+ * A streaming iterator over the chunks of a world.
+ */
+export class WorldStream {
+    // 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("WorldStream 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) {
+            WorldStream_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Open a streaming iterator over a world directory.
+     */
+    static openDir(path) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        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.WorldStream_open_dir(diplomatReceive.buffer, 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 });
+            }
+            return new WorldStream(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Open a streaming iterator over a world directory, bounded to the given
+     * block-coordinate box `[min_x..max_x, min_y..max_y, min_z..max_z]`.
+     */
+    static openDirBounded(path, minX, minY, minZ, maxX, maxY, maxZ) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        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.WorldStream_open_dir_bounded(diplomatReceive.buffer, pathSlice.ptr, minX, minY, minZ, maxX, maxY, maxZ);
+
+        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 WorldStream(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Open a streaming iterator from a zip archive in memory.
+     */
+    static fromZip(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.WorldStream_from_zip(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 WorldStream(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Open a bounded streaming iterator from a zip archive in memory.
+     */
+    static fromZipBounded(data, minX, minY, minZ, maxX, maxY, maxZ) {
+        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.WorldStream_from_zip_bounded(diplomatReceive.buffer, dataSlice.ptr, minX, minY, minZ, maxX, maxY, maxZ);
+
+        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 WorldStream(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Advance the iterator and return the next chunk view. Errors with
+     * `NotFound` at end-of-stream (the old ABI returned NULL). Corrupt
+     * chunks are silently skipped, matching the old ABI.
+     */
+    next() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.WorldStream_next(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 WorldChunkView(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/WsPartitionHints.d.mts

@@ -0,0 +1,29 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Caller-supplied partition hints (full-column boxes a cluster may never
+ * span under {@link PartitionPolicy::HardCut}). Order does not matter:
+ * {@link PartitionIndex::new}(crate::world_segment::partition::PartitionIndex)
+ * sorts hints by full content at construction time.
+ */
+export class WsPartitionHints {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    static create(): WsPartitionHints;
+
+    /**
+     * Add a full-column hint (`y_range: None`) covering inclusive
+     * `x0..=x1, z0..=z1`.
+     */
+    add(id: string, x0: number, x1: number, z0: number, z1: number): void;
+
+    len(): number;
+}

package/renderer/WsPartitionHints.d.ts

@@ -0,0 +1,29 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Caller-supplied partition hints (full-column boxes a cluster may never
+ * span under {@link PartitionPolicy::HardCut}). Order does not matter:
+ * {@link PartitionIndex::new}(crate::world_segment::partition::PartitionIndex)
+ * sorts hints by full content at construction time.
+ */
+export class WsPartitionHints {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    static create(): WsPartitionHints;
+
+    /**
+     * Add a full-column hint (`y_range: None`) covering inclusive
+     * `x0..=x1, z0..=z1`.
+     */
+    add(id: string, x0: number, x1: number, z0: number, z1: number): void;
+
+    len(): number;
+}

package/renderer/WsPartitionHints.mjs

@@ -0,0 +1,102 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const WsPartitionHints_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.WsPartitionHints_destroy(ptr);
+});
+
+/**
+ * Caller-supplied partition hints (full-column boxes a cluster may never
+ * span under {@link PartitionPolicy::HardCut}). Order does not matter:
+ * {@link PartitionIndex::new}(crate::world_segment::partition::PartitionIndex)
+ * sorts hints by full content at construction time.
+ */
+export class WsPartitionHints {
+    // 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("WsPartitionHints 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) {
+            WsPartitionHints_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    static create() {
+
+        const result = wasm.WsPartitionHints_create();
+
+        try {
+            return new WsPartitionHints(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Add a full-column hint (`y_range: None`) covering inclusive
+     * `x0..=x1, z0..=z1`.
+     */
+    add(id, x0, x1, z0, z1) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const idSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, id)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.WsPartitionHints_add(diplomatReceive.buffer, this.ffiValue, idSlice.ptr, x0, x1, z0, z1);
+
+        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();
+        }
+    }
+
+    len() {
+
+        const result = wasm.WsPartitionHints_len(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}