nucleation 0.10.21 → 0.10.23

package/renderer/SortStrategy.mjs

@@ -0,0 +1,272 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const SortStrategy_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.SortStrategy_destroy(ptr);
+});
+
+/**
+ * Ordering applied to region positions before bit assignment
+ * (PORTING rule 10).
+ */
+export class SortStrategy {
+    // 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("SortStrategy 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) {
+            SortStrategy_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Sort by Y ascending, then X, then Z (default Minecraft layer
+     * order). The first position after sorting is bit 0 (LSB).
+     */
+    static yxz() {
+
+        const result = wasm.SortStrategy_yxz();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Sort by X ascending, then Y, then Z.
+     */
+    static xyz() {
+
+        const result = wasm.SortStrategy_xyz();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Sort by Z ascending, then Y, then X.
+     */
+    static zyx() {
+
+        const result = wasm.SortStrategy_zyx();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Sort by Y descending, then X ascending, then Z ascending.
+     */
+    static yDescXz() {
+
+        const result = wasm.SortStrategy_y_desc_xz();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Sort by X descending, then Y ascending, then Z ascending.
+     */
+    static xDescYz() {
+
+        const result = wasm.SortStrategy_x_desc_yz();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Sort by Z descending, then Y ascending, then X ascending.
+     */
+    static zDescYx() {
+
+        const result = wasm.SortStrategy_z_desc_yx();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Old ABI name: `sort_strategy_descending`.
+     */
+    static descending() {
+
+        const result = wasm.SortStrategy_descending();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Sort by Euclidean distance from the reference point, closest
+     * first (ties broken by Y, X, Z ascending).
+     */
+    static distanceFrom(x, y, z) {
+
+        const result = wasm.SortStrategy_distance_from(x, y, z);
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Sort by Euclidean distance from the reference point, farthest
+     * first (ties broken by Y, X, Z descending).
+     */
+    static distanceFromDesc(x, y, z) {
+
+        const result = wasm.SortStrategy_distance_from_desc(x, y, z);
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Keep positions in the order they were added (no sorting). Useful
+     * when positions were ordered manually or box order matters.
+     */
+    static preserve() {
+
+        const result = wasm.SortStrategy_preserve();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Reverse of the order positions were added.
+     */
+    static reverse() {
+
+        const result = wasm.SortStrategy_reverse();
+
+        try {
+            return new SortStrategy(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Parse from a name (e.g. "yxz", "descending", "preserve").
+     */
+    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.SortStrategy_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 SortStrategy(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * The strategy name.
+     */
+    name() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.SortStrategy_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/Store.d.mts

@@ -0,0 +1,83 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A key/value store opened from a URL (e.g. `mem://`, `file:///path`,
+ * `ssh://user@host/path`, `s3://bucket/prefix`, `redis://…`, `postgres://…`).
+ */
+export class Store {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Open a store from a URL. Errors with `Store` on an unknown scheme or
+     * connection failure.
+     */
+    static open(url: string): Store;
+
+    /**
+     * Fetch `key`, writing the value as base64 (PORTING rule 6). Errors with
+     * `NotFound` when the key is absent.
+     */
+    getB64(key: string): string;
+
+    /**
+     * Store `data` at `key`.
+     */
+    put(key: string, data: Array<number>): void;
+
+    /**
+     * Whether `key` exists.
+     */
+    exists(key: string): boolean;
+
+    /**
+     * Delete `key` (idempotent).
+     */
+    delete_(key: string): void;
+
+    /**
+     * List keys under `prefix`, written as a JSON array string.
+     */
+    list(prefix: string): string;
+
+    /**
+     * Atomically write `data` at `key` only if it does not already exist.
+     * Returns `true` if written, `false` if the key existed.
+     */
+    putIfAbsent(key: string, data: Array<number>): boolean;
+
+    /**
+     * A keyset page of keys under `prefix`. `after` is the exclusive cursor
+     * (empty string for the first page); at most `limit` keys are returned.
+     * Writes a JSON object string `{"keys":[...],"next":"…"|null}`.
+     */
+    listPaginated(prefix: string, after: string, limit: number): string;
+
+    /**
+     * Health check: `Ok` when the store is usable.
+     */
+    health(): void;
+
+    /**
+     * Open a schematic stored at `key` in this store. Works for every
+     * backend, including `redis://`/`postgres://`/`mem://` that the
+     * single-string URI form (`StoreIo::open`) rejects.
+     */
+    openSchematic(key: string): Schematic;
+
+    /**
+     * Save a schematic at `key` in this store. `version` selects the format
+     * version (empty string = format default). Works for every backend,
+     * including `redis://`/`postgres://`/`mem://` that the single-string URI
+     * form (`StoreIo::save`) rejects.
+     */
+    saveSchematic(schematic: Schematic, key: string, version: string): void;
+}

package/renderer/Store.d.ts

@@ -0,0 +1,83 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A key/value store opened from a URL (e.g. `mem://`, `file:///path`,
+ * `ssh://user@host/path`, `s3://bucket/prefix`, `redis://…`, `postgres://…`).
+ */
+export class Store {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Open a store from a URL. Errors with `Store` on an unknown scheme or
+     * connection failure.
+     */
+    static open(url: string): Store;
+
+    /**
+     * Fetch `key`, writing the value as base64 (PORTING rule 6). Errors with
+     * `NotFound` when the key is absent.
+     */
+    getB64(key: string): string;
+
+    /**
+     * Store `data` at `key`.
+     */
+    put(key: string, data: Array<number>): void;
+
+    /**
+     * Whether `key` exists.
+     */
+    exists(key: string): boolean;
+
+    /**
+     * Delete `key` (idempotent).
+     */
+    delete_(key: string): void;
+
+    /**
+     * List keys under `prefix`, written as a JSON array string.
+     */
+    list(prefix: string): string;
+
+    /**
+     * Atomically write `data` at `key` only if it does not already exist.
+     * Returns `true` if written, `false` if the key existed.
+     */
+    putIfAbsent(key: string, data: Array<number>): boolean;
+
+    /**
+     * A keyset page of keys under `prefix`. `after` is the exclusive cursor
+     * (empty string for the first page); at most `limit` keys are returned.
+     * Writes a JSON object string `{"keys":[...],"next":"…"|null}`.
+     */
+    listPaginated(prefix: string, after: string, limit: number): string;
+
+    /**
+     * Health check: `Ok` when the store is usable.
+     */
+    health(): void;
+
+    /**
+     * Open a schematic stored at `key` in this store. Works for every
+     * backend, including `redis://`/`postgres://`/`mem://` that the
+     * single-string URI form (`StoreIo::open`) rejects.
+     */
+    openSchematic(key: string): Schematic;
+
+    /**
+     * Save a schematic at `key` in this store. `version` selects the format
+     * version (empty string = format default). Works for every backend,
+     * including `redis://`/`postgres://`/`mem://` that the single-string URI
+     * form (`StoreIo::save`) rejects.
+     */
+    saveSchematic(schematic: Schematic, key: string, version: string): void;
+}