nucleation 0.10.22 → 0.10.23

package/renderer/Blocks.d.ts

@@ -0,0 +1,91 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Namespace for read-only queries over the built-in block table
+ * (Java 26.2 blocks + official semantics extracted from the vanilla
+ * jars: definition kinds, base-block links, block tags, model
+ * geometry). All list results are JSON array strings sorted by id;
+ * block/tag/kind arguments accept both `minecraft:`-prefixed and
+ * short forms (`minecraft:oak_stairs` / `oak_stairs`).
+ */
+export class Blocks {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Full facts for one block as a JSON object:
+     * `{id, kind, base_block, tags: [...], full_cube, transparent,
+     * color: [r, g, b] | null, properties: {name: [values...]},
+     * default_state: {name: value}}`. `kind` is the official
+     * definition kind (`minecraft:stair`, plain full blocks are
+     * `minecraft:block`); `base_block` is the block this one is a
+     * shape variant of (or `null`); `color` is the texture-derived
+     * average RGB. Errors with `NotFound` for unknown ids.
+     */
+    static getJson(id: string): string;
+
+    /**
+     * All known block ids as a sorted JSON array string.
+     */
+    static idsJson(): string;
+
+    /**
+     * Ids of every block carrying the vanilla block tag, as a sorted
+     * Blocks whose measured texture color is within `max_distance`
+     * (Oklab; ~0.05 = same color family, ~0.15 = generous) of the given
+     * RGB, as a JSON array of `{"id", "color": [r,g,b], "distance"}`
+     * sorted nearest-first. Blocks without color data never match.
+     */
+    static byColorJson(r: number, g: number, b: number, maxDistance: number): string;
+
+    /**
+     * JSON array string (`[]` for unknown tags). Accepts
+     * `minecraft:wool` and short `wool` forms, including nested paths
+     * like `mineable/pickaxe`.
+     */
+    static byTagJson(tag: string): string;
+
+    /**
+     * Ids of every block of the given official definition kind
+     * (`minecraft:stair`, `minecraft:slab`, `minecraft:door`, ...), as
+     * a sorted JSON array string (`[]` for unknown kinds).
+     */
+    static byKindJson(kind: string): string;
+
+    /**
+     * The base block followed by all its shape variants — blocks whose
+     * `base_block` is `base_id` (stairs, slabs, walls, fences of the
+     * base) — as a JSON array string. The base itself is always first;
+     * variants follow sorted by id. Errors with `NotFound` for unknown
+     * base ids.
+     */
+    static variantsOfJson(baseId: string): string;
+
+    /**
+     * All known vanilla block tag names as a sorted JSON array string
+     * (`minecraft:`-prefixed, e.g. `minecraft:wool`).
+     */
+    static tagsJson(): string;
+
+    /**
+     * Every property-value combination of the block as a JSON array of
+     * `{prop: value}` objects (a single `{}` entry for property-less
+     * blocks). Errors with `NotFound` for unknown ids and with
+     * `InvalidArgument` if the combination count exceeds 4096 (guard
+     * against pathological output; the current data tops out at 1350
+     * for `minecraft:note_block`).
+     */
+    static statesJson(id: string): string;
+
+    /**
+     * Total number of blocks in the table.
+     */
+    static count(): number;
+}

package/renderer/Blocks.mjs

@@ -0,0 +1,308 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const Blocks_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.Blocks_destroy(ptr);
+});
+
+/**
+ * Namespace for read-only queries over the built-in block table
+ * (Java 26.2 blocks + official semantics extracted from the vanilla
+ * jars: definition kinds, base-block links, block tags, model
+ * geometry). All list results are JSON array strings sorted by id;
+ * block/tag/kind arguments accept both `minecraft:`-prefixed and
+ * short forms (`minecraft:oak_stairs` / `oak_stairs`).
+ */
+export class Blocks {
+    // 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("Blocks 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) {
+            Blocks_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Full facts for one block as a JSON object:
+     * `{id, kind, base_block, tags: [...], full_cube, transparent,
+     * color: [r, g, b] | null, properties: {name: [values...]},
+     * default_state: {name: value}}`. `kind` is the official
+     * definition kind (`minecraft:stair`, plain full blocks are
+     * `minecraft:block`); `base_block` is the block this one is a
+     * shape variant of (or `null`); `color` is the texture-derived
+     * average RGB. Errors with `NotFound` for unknown ids.
+     */
+    static getJson(id) {
+        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 write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Blocks_get_json(diplomatReceive.buffer, idSlice.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();
+        }
+    }
+
+    /**
+     * All known block ids as a sorted JSON array string.
+     */
+    static idsJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Blocks_ids_json(write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Ids of every block carrying the vanilla block tag, as a sorted
+     * Blocks whose measured texture color is within `max_distance`
+     * (Oklab; ~0.05 = same color family, ~0.15 = generous) of the given
+     * RGB, as a JSON array of `{"id", "color": [r,g,b], "distance"}`
+     * sorted nearest-first. Blocks without color data never match.
+     */
+    static byColorJson(r, g, b, maxDistance) {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Blocks_by_color_json(diplomatReceive.buffer, r, g, b, maxDistance, 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();
+        }
+    }
+
+    /**
+     * JSON array string (`[]` for unknown tags). Accepts
+     * `minecraft:wool` and short `wool` forms, including nested paths
+     * like `mineable/pickaxe`.
+     */
+    static byTagJson(tag) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const tagSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, tag)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Blocks_by_tag_json(diplomatReceive.buffer, tagSlice.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();
+        }
+    }
+
+    /**
+     * Ids of every block of the given official definition kind
+     * (`minecraft:stair`, `minecraft:slab`, `minecraft:door`, ...), as
+     * a sorted JSON array string (`[]` for unknown kinds).
+     */
+    static byKindJson(kind) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const kindSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, kind)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Blocks_by_kind_json(diplomatReceive.buffer, kindSlice.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 base block followed by all its shape variants — blocks whose
+     * `base_block` is `base_id` (stairs, slabs, walls, fences of the
+     * base) — as a JSON array string. The base itself is always first;
+     * variants follow sorted by id. Errors with `NotFound` for unknown
+     * base ids.
+     */
+    static variantsOfJson(baseId) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const baseIdSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, baseId)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Blocks_variants_of_json(diplomatReceive.buffer, baseIdSlice.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();
+        }
+    }
+
+    /**
+     * All known vanilla block tag names as a sorted JSON array string
+     * (`minecraft:`-prefixed, e.g. `minecraft:wool`).
+     */
+    static tagsJson() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Blocks_tags_json(write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Every property-value combination of the block as a JSON array of
+     * `{prop: value}` objects (a single `{}` entry for property-less
+     * blocks). Errors with `NotFound` for unknown ids and with
+     * `InvalidArgument` if the combination count exceeds 4096 (guard
+     * against pathological output; the current data tops out at 1350
+     * for `minecraft:note_block`).
+     */
+    static statesJson(id) {
+        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 write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Blocks_states_json(diplomatReceive.buffer, idSlice.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();
+        }
+    }
+
+    /**
+     * Total number of blocks in the table.
+     */
+    static count() {
+
+        const result = wasm.Blocks_count();
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/Brush.d.mts

@@ -0,0 +1,99 @@
+// generated by diplomat-tool
+import type { Field3 } from "./Field3.mjs"
+import type { InterpolationSpace } from "./InterpolationSpace.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Palette } from "./Palette.mjs"
+import type { Sdf } from "./Sdf.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Decides which block goes at each point of a filled shape. Wraps `BrushEnum`.
+ */
+export class Brush {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Every point becomes `block_name` (a block-state string).
+     */
+    static solid(blockName: string): Brush;
+
+    /**
+     * Nearest-block-to-RGB-color brush.
+     */
+    static color(r: number, g: number, b: number): Brush;
+
+    /**
+     * Linear color gradient between two anchored points.
+     */
+    static linearGradient(x1: number, y1: number, z1: number, r1: number, g1: number, b1: number, x2: number, y2: number, z2: number, r2: number, g2: number, b2: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Base color shaded by surface normal against light direction
+     * (`lx`, `ly`, `lz`).
+     */
+    static shaded(r: number, g: number, b: number, lx: number, ly: number, lz: number): Brush;
+
+    /**
+     * Bilinear gradient over the patch `origin + s*u + t*v` with corner colors
+     * c00/c10/c01/c11.
+     */
+    static bilinearGradient(ox: number, oy: number, oz: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number, r00: number, g00: number, b00: number, r10: number, g10: number, b10: number, r01: number, g01: number, b01: number, r11: number, g11: number, b11: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Inverse-distance-weighted gradient between colored anchor points.
+     * `positions` is flat `[x0, y0, z0, x1, …]` and `colors` is flat
+     * `[r0, g0, b0, r1, …]`; both must describe the same non-zero number of
+     * points (`positions.len() == colors.len()`, a multiple of 3).
+     */
+    static pointGradient(positions: Array<number>, colors: Array<number>, falloff: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Spotlight-lit base color (`r`, `g`, `b`): Lambert shading toward a
+     * cone light at (`px`, `py`, `pz`) aimed along (`dx`, `dy`, `dz`).
+     * Full intensity inside 0.7 × `cone_angle_deg`, smoothstep falloff
+     * to zero at the cone edge; surfaces facing away or outside the cone
+     * drop to a 4% ambient floor.
+     */
+    static spotlight(px: number, py: number, pz: number, dx: number, dy: number, dz: number, coneAngleDeg: number, r: number, g: number, b: number): Brush;
+
+    /**
+     * Use `palette` for this brush's color→block snapping instead of the
+     * default all-blocks palette. No-op for `solid` brushes, which place
+     * a fixed block state. Set it before filling; the palette is shared,
+     * not copied.
+     */
+    setPalette(palette: Palette): void;
+
+    /**
+     * Gradient along a parametric curve: `stops` holds the curve parameters in
+     * `[0, 1]` and `colors` the matching flat RGB triples
+     * (`colors.len() == stops.len() * 3`, `stops` non-empty).
+     */
+    static curveGradient(stops: Array<number>, colors: Array<number>, space: InterpolationSpace): Brush;
+
+    /**
+     * Compatibility path that colors voxels by evaluating an SDF graph as
+     * a scalar field. Prefer `field3` for new code.
+     * `stops` are in `[0, 1]`; `colors` are flat RGB triples. The sampled
+     * value is remapped from `[lo, hi]` before reading the gradient.
+     */
+    static fieldSdf(field: Sdf, stops: Array<number>, colors: Array<number>, lo: number, hi: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Color every voxel by evaluating a geometry-neutral scalar field at
+     * its center. The field is cloned into the brush, so both wrappers
+     * may be independently destroyed after construction.
+     */
+    static field3(field: Field3, stops: Array<number>, colors: Array<number>, lo: number, hi: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Legacy JSON-first field brush. Prefer `field3` for new code.
+     */
+    static field(fieldJson: string, stops: Array<number>, colors: Array<number>, lo: number, hi: number, space: InterpolationSpace): Brush;
+}

package/renderer/Brush.d.ts

@@ -0,0 +1,99 @@
+// generated by diplomat-tool
+import type { Field3 } from "./Field3.mjs"
+import type { InterpolationSpace } from "./InterpolationSpace.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Palette } from "./Palette.mjs"
+import type { Sdf } from "./Sdf.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Decides which block goes at each point of a filled shape. Wraps `BrushEnum`.
+ */
+export class Brush {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Every point becomes `block_name` (a block-state string).
+     */
+    static solid(blockName: string): Brush;
+
+    /**
+     * Nearest-block-to-RGB-color brush.
+     */
+    static color(r: number, g: number, b: number): Brush;
+
+    /**
+     * Linear color gradient between two anchored points.
+     */
+    static linearGradient(x1: number, y1: number, z1: number, r1: number, g1: number, b1: number, x2: number, y2: number, z2: number, r2: number, g2: number, b2: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Base color shaded by surface normal against light direction
+     * (`lx`, `ly`, `lz`).
+     */
+    static shaded(r: number, g: number, b: number, lx: number, ly: number, lz: number): Brush;
+
+    /**
+     * Bilinear gradient over the patch `origin + s*u + t*v` with corner colors
+     * c00/c10/c01/c11.
+     */
+    static bilinearGradient(ox: number, oy: number, oz: number, ux: number, uy: number, uz: number, vx: number, vy: number, vz: number, r00: number, g00: number, b00: number, r10: number, g10: number, b10: number, r01: number, g01: number, b01: number, r11: number, g11: number, b11: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Inverse-distance-weighted gradient between colored anchor points.
+     * `positions` is flat `[x0, y0, z0, x1, …]` and `colors` is flat
+     * `[r0, g0, b0, r1, …]`; both must describe the same non-zero number of
+     * points (`positions.len() == colors.len()`, a multiple of 3).
+     */
+    static pointGradient(positions: Array<number>, colors: Array<number>, falloff: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Spotlight-lit base color (`r`, `g`, `b`): Lambert shading toward a
+     * cone light at (`px`, `py`, `pz`) aimed along (`dx`, `dy`, `dz`).
+     * Full intensity inside 0.7 × `cone_angle_deg`, smoothstep falloff
+     * to zero at the cone edge; surfaces facing away or outside the cone
+     * drop to a 4% ambient floor.
+     */
+    static spotlight(px: number, py: number, pz: number, dx: number, dy: number, dz: number, coneAngleDeg: number, r: number, g: number, b: number): Brush;
+
+    /**
+     * Use `palette` for this brush's color→block snapping instead of the
+     * default all-blocks palette. No-op for `solid` brushes, which place
+     * a fixed block state. Set it before filling; the palette is shared,
+     * not copied.
+     */
+    setPalette(palette: Palette): void;
+
+    /**
+     * Gradient along a parametric curve: `stops` holds the curve parameters in
+     * `[0, 1]` and `colors` the matching flat RGB triples
+     * (`colors.len() == stops.len() * 3`, `stops` non-empty).
+     */
+    static curveGradient(stops: Array<number>, colors: Array<number>, space: InterpolationSpace): Brush;
+
+    /**
+     * Compatibility path that colors voxels by evaluating an SDF graph as
+     * a scalar field. Prefer `field3` for new code.
+     * `stops` are in `[0, 1]`; `colors` are flat RGB triples. The sampled
+     * value is remapped from `[lo, hi]` before reading the gradient.
+     */
+    static fieldSdf(field: Sdf, stops: Array<number>, colors: Array<number>, lo: number, hi: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Color every voxel by evaluating a geometry-neutral scalar field at
+     * its center. The field is cloned into the brush, so both wrappers
+     * may be independently destroyed after construction.
+     */
+    static field3(field: Field3, stops: Array<number>, colors: Array<number>, lo: number, hi: number, space: InterpolationSpace): Brush;
+
+    /**
+     * Legacy JSON-first field brush. Prefer `field3` for new code.
+     */
+    static field(fieldJson: string, stops: Array<number>, colors: Array<number>, lo: number, hi: number, space: InterpolationSpace): Brush;
+}