nucleation 0.5.1 → 0.7.0

package/Palette.d.mts

@@ -0,0 +1,145 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A set of colored blocks that color/gradient brushes snap their computed
+ * colors to (nearest neighbor in Oklab space). Wraps an Arc'd
+ * {@link crate::building::BlockPalette}; sharing one palette across many
+ * brushes is cheap.
+ */
+export class Palette {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Every block blockpedia knows a color for (the default palette
+     * brushes use when none is set).
+     */
+    static all(): Palette;
+
+    /**
+     * Only solid blocks: no transparency, gravity, tile entities, or
+     * support requirements.
+     */
+    static solid(): Palette;
+
+    /**
+     * Conservative structural set (full building blocks).
+     */
+    static structural(): Palette;
+
+    /**
+     * Decorative set: allows stairs/slabs but no tile entities.
+     */
+    static decorative(): Palette;
+
+    /**
+     * The 16 concrete colors (excludes concrete powder).
+     */
+    static concrete(): Palette;
+
+    /**
+     * The 16 wool colors.
+     */
+    static wool(): Palette;
+
+    /**
+     * Terracotta colors (excludes glazed variants).
+     */
+    static terracotta(): Palette;
+
+    /**
+     * Genuinely gray blocks: opaque full cubes whose measured color
+     * is near-neutral (low Oklab chroma) — judged from color data,
+     * not names.
+     */
+    static grayscale(): Palette;
+
+    /**
+     * The planks family — a natural light→dark wood ramp.
+     */
+    static wood(): Palette;
+
+    /**
+     * A copy of this palette with ordered dithering enabled: brushes
+     * snapping through it alternate between the two nearest blocks per
+     * voxel (4x4 Bayer threshold, deterministic in position), which
+     * reads as intermediate shades at a distance — the classic map-art
+     * trick. Ramp and list queries are unaffected.
+     */
+    dithered(): Palette;
+
+    /**
+     * A copy of this palette ordered by perceptual lightness (Oklab L,
+     * dark → light). Combined with `block_ids_json`, gives a
+     * ready-to-index ramp: `ids[i]` for intensity `i / (len - 1)`.
+     */
+    sortedByLightness(): Palette;
+
+    /**
+     * JSON array of exactly `steps` DISTINCT block ids forming the
+     * smoothest ramp this palette can make from (`r1`,`g1`,`b1`) to
+     * (`r2`,`g2`,`b2`): targets are evenly spaced along the Oklab line
+     * and blocks are chosen by a minimum-cost monotonic matching, so
+     * off-hue blocks are penalized and no block repeats. Errors with
+     * `InvalidArgument` when the palette has fewer than `steps` blocks,
+     * `steps` is 0, or start equals end.
+     */
+    rampIdsJson(r1: number, g1: number, b1: number, r2: number, g2: number, b2: number, steps: number): string;
+
+    /**
+     * JSON array of exactly `steps` block ids sampling the color
+     * gradient from (`r1`,`g1`,`b1`) to (`r2`,`g2`,`b2`) in Oklab
+     * space, each step snapped to this palette's closest block. Built
+     * for value→block lookups (heatmaps, fractals): index the returned
+     * list by `intensity * (steps - 1)`. Entries may repeat on coarse
+     * palettes; errors with `NotFound` on an empty palette.
+     */
+    gradientIdsJson(r1: number, g1: number, b1: number, r2: number, g2: number, b2: number, steps: number): string;
+
+    /**
+     * JSON array of exactly `steps` block ids sampling an Oklab gradient
+     * whose endpoints are the measured texture colors of `start_block`
+     * and `end_block`. Errors with `NotFound` when either id is unknown
+     * or has no measured color, or when this palette is empty.
+     */
+    gradientIdsBetweenBlocksJson(startBlock: string, endBlock: string, steps: number): string;
+
+    /**
+     * Custom palette from a JSON array of block ids, e.g.
+     * `["minecraft:stone", "minecraft:oak_planks"]`. Ids blockpedia has
+     * no color for are silently skipped — check `len` afterwards.
+     */
+    static fromBlockIds(idsJson: string): Palette;
+
+    /**
+     * Number of blocks in the palette.
+     */
+    len(): number;
+
+    /**
+     * The palette's block ids as a JSON array string.
+     */
+    blockIdsJson(): string;
+
+    /**
+     * Position-aware dithered snap: the block for the given RGB at
+     * voxel (x, y, z), alternating between the two nearest palette
+     * blocks per position (4x4 Bayer) — the per-pixel entry point for
+     * pixel art and image mapping. Deterministic. Errors with
+     * `NotFound` on an empty palette.
+     */
+    closestBlockDithered(r: number, g: number, b: number, x: number, y: number, z: number): string;
+
+    /**
+     * The palette block whose color is closest (Oklab distance) to the
+     * given RGB. Errors with `NotFound` on an empty palette.
+     */
+    closestBlock(r: number, g: number, b: number): string;
+}

package/Palette.d.ts

@@ -1,5 +1,5 @@
 // generated by diplomat-tool
-import type { NucleationError } from "./NucleationError"
+import type { NucleationError } from "./NucleationError.mjs"
 import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
 
 
@@ -103,6 +103,14 @@ export class Palette {
      */
     gradientIdsJson(r1: number, g1: number, b1: number, r2: number, g2: number, b2: number, steps: number): string;
 
+    /**
+     * JSON array of exactly `steps` block ids sampling an Oklab gradient
+     * whose endpoints are the measured texture colors of `start_block`
+     * and `end_block`. Errors with `NotFound` when either id is unknown
+     * or has no measured color, or when this palette is empty.
+     */
+    gradientIdsBetweenBlocksJson(startBlock: string, endBlock: string, steps: number): string;
+
     /**
      * Custom palette from a JSON array of block ids, e.g.
      * `["minecraft:stone", "minecraft:oak_planks"]`. Ids blockpedia has

package/Palette.mjs

@@ -291,6 +291,41 @@ export class Palette {
         }
     }
 
+    /**
+     * JSON array of exactly `steps` block ids sampling an Oklab gradient
+     * whose endpoints are the measured texture colors of `start_block`
+     * and `end_block`. Errors with `NotFound` when either id is unknown
+     * or has no measured color, or when this palette is empty.
+     */
+    gradientIdsBetweenBlocksJson(startBlock, endBlock, steps) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const startBlockSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, startBlock)));
+        const endBlockSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, endBlock)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+
+        const result = wasm.Palette_gradient_ids_between_blocks_json(diplomatReceive.buffer, this.ffiValue, startBlockSlice.ptr, endBlockSlice.ptr, steps, 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();
+        }
+    }
+
     /**
      * Custom palette from a JSON array of block ids, e.g.
      * `["minecraft:stone", "minecraft:oak_planks"]`. Ids blockpedia has

package/PaletteBuilder.d.mts

@@ -0,0 +1,119 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Palette } from "./Palette.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Filter-driven palette construction (wraps
+ * {@link crate::building::PaletteBuilder}, which fronts blockpedia's
+ * `BlockFilter`). Call flag methods, then `build` — the builder is
+ * consumed; further calls error with `AlreadyConsumed`.
+ */
+export class PaletteBuilder {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * A builder matching every colored block (no filters yet).
+     */
+    static create(): PaletteBuilder;
+
+    /**
+     * Exclude gravity-affected blocks (sand, gravel, ...).
+     */
+    excludeFalling(): void;
+
+    /**
+     * Exclude blocks with block entities (chests, furnaces, ...).
+     */
+    excludeTileEntities(): void;
+
+    /**
+     * Keep only full cube blocks (no stairs, slabs, fences, ...).
+     * Metadata-driven: uses the official model geometry extracted from
+     * the vanilla jars, not block-name guessing.
+     */
+    fullBlocksOnly(): void;
+
+    /**
+     * Exclude blocks that need supporting blocks (torches, rails, ...).
+     */
+    excludeNeedsSupport(): void;
+
+    /**
+     * Exclude transparent/translucent blocks (glass, leaves, ...).
+     * Metadata-driven: uses the per-block transparency flag from the
+     * block-data pipeline, not block-name guessing.
+     */
+    excludeTransparent(): void;
+
+    /**
+     * Exclude light-emitting blocks (glowstone, lanterns, ...).
+     */
+    excludeLightSources(): void;
+
+    /**
+     * Keep only blocks obtainable in survival.
+     */
+    survivalOnly(): void;
+
+    /**
+     * Exclude blocks whose id contains `keyword`.
+     */
+    excludeKeyword(keyword: string): void;
+
+    /**
+     * Keep only blocks whose id contains `keyword` (repeatable; matches
+     * any of the included keywords).
+     */
+    includeKeyword(keyword: string): void;
+
+    /**
+     * Require the vanilla block tag `t` (`minecraft:wool` or short
+     * `wool`, nested paths like `mineable/pickaxe` too). Repeatable —
+     * a block must carry ALL required tags (AND semantics).
+     */
+    tag(t: string): void;
+
+    /**
+     * Exclude blocks carrying the vanilla block tag `t` (any listed
+     * tag disqualifies). Repeatable.
+     */
+    excludeTag(t: string): void;
+
+    /**
+     * Keep only blocks of the official definition kind `k`
+     * (`minecraft:stair` or short `stair`; plain full blocks are
+     * `minecraft:block`). Repeatable — a block matching ANY listed
+     * kind passes (OR semantics).
+     */
+    kind(k: string): void;
+
+    /**
+     * Keep only blocks whose measured Oklab lightness L is within
+     * `[min, max]` (0.0 = black, 1.0 = white).
+     */
+    lightnessBetween(min: number, max: number): void;
+
+    /**
+     * Keep only near-neutral blocks: measured Oklab chroma at most
+     * `max` (the grayscale preset uses 0.022).
+     */
+    chromaBelow(max: number): void;
+
+    /**
+     * Keep only blocks whose measured color is within `max_distance`
+     * (Oklab; ~0.05 = same family, ~0.15 = generous) of the RGB color.
+     */
+    colorNear(r: number, g: number, b: number, maxDistance: number): void;
+
+    /**
+     * Build the palette; consumes the builder.
+     */
+    build(): Palette;
+}

package/PaletteBuilder.d.ts

@@ -1,6 +1,6 @@
 // generated by diplomat-tool
-import type { NucleationError } from "./NucleationError"
-import type { Palette } from "./Palette"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { Palette } from "./Palette.mjs"
 import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
 
 

package/RawMeshExport.d.mts

@@ -0,0 +1,74 @@
+// generated by diplomat-tool
+import type { MeshConfig } from "./MeshConfig.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { ResourcePack } from "./ResourcePack.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Raw vertex streams for custom rendering. Wraps {@link crate::meshing::RawMeshExport}.
+ */
+export class RawMeshExport {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Export raw mesh data (old ABI: `schematic_to_raw_mesh`).
+     */
+    static create(schematic: Schematic, pack: ResourcePack, config: MeshConfig): RawMeshExport;
+
+    /**
+     * Number of vertices in the exported mesh.
+     */
+    vertexCount(): number;
+
+    /**
+     * Number of triangles in the exported mesh.
+     */
+    triangleCount(): number;
+
+    /**
+     * Flat `[x,y,z,...]` positions as little-endian `f32` bytes, base64-encoded.
+     */
+    positionsB64(): string;
+
+    /**
+     * Flat normals as little-endian `f32` bytes, base64-encoded.
+     */
+    normalsB64(): string;
+
+    /**
+     * Flat UVs as little-endian `f32` bytes, base64-encoded.
+     */
+    uvsB64(): string;
+
+    /**
+     * Flat vertex colors as little-endian `f32` bytes, base64-encoded.
+     */
+    colorsB64(): string;
+
+    /**
+     * Triangle indices as little-endian `u32` bytes, base64-encoded.
+     */
+    indicesB64(): string;
+
+    /**
+     * Raw RGBA texture pixels, base64-encoded.
+     */
+    textureRgbaB64(): string;
+
+    /**
+     * Width of the baked texture in pixels.
+     */
+    textureWidth(): number;
+
+    /**
+     * Height of the baked texture in pixels.
+     */
+    textureHeight(): number;
+}

package/RawMeshExport.d.ts

@@ -1,8 +1,8 @@
 // generated by diplomat-tool
-import type { MeshConfig } from "./MeshConfig"
-import type { NucleationError } from "./NucleationError"
-import type { ResourcePack } from "./ResourcePack"
-import type { Schematic } from "./Schematic"
+import type { MeshConfig } from "./MeshConfig.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { ResourcePack } from "./ResourcePack.mjs"
+import type { Schematic } from "./Schematic.mjs"
 import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
 
 

package/RedstoneGraph.d.mts

@@ -0,0 +1,58 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * An extracted redstone logic graph. Wraps
+ * {@link crate::simulation::graph::RedstoneGraph}.
+ */
+export class RedstoneGraph {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Number of nodes in the graph.
+     */
+    nodeCount(): number;
+
+    /**
+     * Total number of directed edges in the graph.
+     */
+    edgeCount(): number;
+
+    /**
+     * The nodes as a JSON array string.
+     */
+    nodesJson(): string;
+
+    /**
+     * The directed edges as a JSON array string.
+     */
+    edgesJson(): string;
+
+    /**
+     * Computed graph features as a JSON object string.
+     */
+    featuresJson(): string;
+
+    /**
+     * Fingerprint (hex string) for `preset` ("structural" | "functional" |
+     * "exact"; empty defaults to "structural").
+     */
+    fingerprint(preset: string): string;
+
+    /**
+     * Serialize the whole graph to JSON.
+     */
+    toJson(): string;
+
+    /**
+     * Deserialize a graph from a JSON string.
+     */
+    static fromJson(json: string): RedstoneGraph;
+}

package/RedstoneGraph.d.ts

@@ -1,5 +1,5 @@
 // generated by diplomat-tool
-import type { NucleationError } from "./NucleationError"
+import type { NucleationError } from "./NucleationError.mjs"
 import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
 
 

package/RegionBounds.d.mts

@@ -0,0 +1,41 @@
+// generated by diplomat-tool
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+export type RegionBounds_obj = {
+    minX: number;
+    minY: number;
+    minZ: number;
+    maxX: number;
+    maxY: number;
+    maxZ: number;
+};
+
+
+
+/**
+ * An inclusive block-coordinate box (a definition region is a union of
+ * these).
+ */
+export class RegionBounds {
+    get minX(): number;
+    set minX(value: number);
+    get minY(): number;
+    set minY(value: number);
+    get minZ(): number;
+    set minZ(value: number);
+    get maxX(): number;
+    set maxX(value: number);
+    get maxY(): number;
+    set maxY(value: number);
+    get maxZ(): number;
+    set maxZ(value: number);
+    /** @internal */
+    static fromFields(structObj : RegionBounds_obj) : RegionBounds;
+
+    /**
+    * Create `RegionBounds` from an object that contains all of `RegionBounds`s fields.
+    * Optional fields do not need to be included in the provided object.
+    */
+    constructor(structObj: RegionBounds_obj);
+
+}

package/RenderConfig.d.mts

@@ -0,0 +1,101 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Camera / output configuration for rendering.
+ */
+export class RenderConfig {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    /**
+     * Create a config with the given output size in pixels. Camera starts
+     * at the defaults: yaw 45°, pitch 30°, zoom 1.0, fov 45°, perspective
+     * projection, default sky background.
+     */
+    static create(width: number, height: number): RenderConfig;
+
+    /**
+     * Set the camera yaw (horizontal orbit angle) in degrees. Default: 45.
+     */
+    setYaw(yaw: number): void;
+
+    /**
+     * Set the camera pitch (downward tilt) in degrees. Default: 30.
+     */
+    setPitch(pitch: number): void;
+
+    /**
+     * Set the zoom factor applied to the auto-fitted framing
+     * (1.0 = frame the whole model; 2.0 = twice as close; 0.5 = twice
+     * as far). Default: 1.0.
+     */
+    setZoom(zoom: number): void;
+
+    /**
+     * Fit the camera to the model's bounding sphere instead of its
+     * yaw-dependent silhouette. The sphere is rotation invariant, so
+     * orbiting cameras (turntables) keep a constant distance instead
+     * of pulsing as the silhouette changes. Frames slightly looser
+     * than the default fit. Default: false.
+     */
+    setSphereFit(sphereFit: boolean): void;
+
+    /**
+     * Set the vertical field of view in degrees (perspective projection
+     * only). Default: 45.
+     */
+    setFov(fov: number): void;
+
+    /**
+     * Set the world-space directional light and its non-negative intensity.
+     */
+    setDirectionalLight(x: number, y: number, z: number, intensity: number): void;
+
+    /**
+     * Set the unlit floor for non-HDRI rendering, in `0..=1`.
+     */
+    setAmbientLight(ambient: number): void;
+
+    /**
+     * Set a solid RGBA clear color (linear 0.0–1.0). Alpha < 1.0 yields a
+     * transparent PNG. Ignored when HDRI is enabled.
+     */
+    setBackground(r: number, g: number, b: number, a: number): void;
+
+    /**
+     * Clear the custom background — revert to default sky / HDRI.
+     */
+    clearBackground(): void;
+
+    /**
+     * Configure a one-block world grid. Models are centred on integer
+     * schematic coordinates, so grid lines are placed on half-integer
+     * block boundaries automatically.
+     */
+    setGrid(halfExtent: number, spacing: number, planeY: number, showAxes: boolean, red: number, green: number, blue: number, alpha: number): void;
+
+    /**
+     * Configure a compact grid fitted to half-integer block boundaries.
+     */
+    setFittedGrid(margin: number, spacing: number, planeY: number, showAxes: boolean, red: number, green: number, blue: number, alpha: number): void;
+
+    clearGrid(): void;
+
+    /**
+     * Enable (`true`) or disable orthographic projection.
+     */
+    setOrthographic(orthographic: boolean): void;
+
+    /**
+     * Configure a true isometric view: orthographic at yaw 45° /
+     * pitch ≈35.264° (preserves the current width/height).
+     */
+    setIsometric(): void;
+}

package/RenderConfig.d.ts

@@ -1,5 +1,5 @@
 // generated by diplomat-tool
-import type { NucleationError } from "./NucleationError"
+import type { NucleationError } from "./NucleationError.mjs"
 import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
 
 

package/Renderer.d.mts

@@ -0,0 +1,51 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError.mjs"
+import type { RenderConfig } from "./RenderConfig.mjs"
+import type { ResourcePack } from "./ResourcePack.mjs"
+import type { Schematic } from "./Schematic.mjs"
+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;
+
+    /**
+     * Render with an already parsed resource pack, avoiding repeated ZIP parsing.
+     */
+    static renderToFileWithPack(schematic: Schematic, pack: ResourcePack, config: RenderConfig, path: string): void;
+
+    /**
+     * Render raw RGBA pixels with an already parsed resource pack.
+     */
+    static renderPixelsB64WithPack(schematic: Schematic, pack: ResourcePack, config: RenderConfig): string;
+
+    /**
+     * Render PNG bytes with an already parsed resource pack.
+     */
+    static renderPngB64WithPack(schematic: Schematic, pack: ResourcePack, config: RenderConfig): string;
+}