nucleation 0.1.184 → 0.2.1

package/README.md

@@ -109,25 +109,48 @@ println!("{:?}", schematic.get_info());
 #### JavaScript (WASM)
 
 ```ts
-import { SchematicParser } from "nucleation";
+import init from "nucleation";
+import { Schematic } from "nucleation/api";
+await init();
 
 const bytes = await fetch("example.litematic").then((r) => r.arrayBuffer());
-const parser = new SchematicParser();
-await parser.fromData(new Uint8Array(bytes));
-console.log(parser.getDimensions());
+const schem = Schematic.open(new Uint8Array(bytes), { hint: "example.litematic" });
+schem.setBlock([0, 0, 0], "minecraft:gold_block");
+await schem.save("out.schem");
 ```
 
 #### Python
 
 ```python
-from nucleation import Schematic
+from nucleation import Schematic, sign, text
+
+# Three explicit constructors (legacy `Schematic("file.schem")` still works):
+schem = Schematic.open("example.litematic")        # load
+fresh = Schematic.new("my_schematic")              # blank
+templ = Schematic.from_template("ab\ncd")          # ASCII template
+
+# Polished set_block: tuple coords, structured state and NBT, chainable.
+schem.set_block((0, 0, 0), "minecraft:repeater",
+                state={"delay": 4, "facing": "east"})
+schem.set_block((0, 1, 0), "minecraft:oak_sign",
+                state={"rotation": 8},
+                nbt=sign([text("Hello", color="gold"), "world"]))
+
+# Format inferred from extension.
+schem.save("out.litematic")
+```
 
-with open("example.litematic", "rb") as f:
-    data = f.read()
+For hot loops placing many blocks, prefer the batch / fast-path APIs:
 
-schem = Schematic("my_schematic")
-schem.load_from_bytes(data)
-print(schem.get_info())
+```python
+# 30+ M placements/sec — one native call.
+schem.set_blocks([(x, 0, 0) for x in range(1_000_000)], "minecraft:stone")
+
+# 10+ M placements/sec — pre-resolve once, place by index.
+stone = schem.prepare_block("minecraft:stone")
+place = schem.place
+for x, y, z in positions:
+    place(x, y, z, stone)
 ```
 
 ### Building Schematics with ASCII Art

package/api.js

@@ -0,0 +1,608 @@
+// Polished JS API for Nucleation, layered over the wasm-bindgen output.
+//
+// The default `nucleation` import still exposes `init`, `SchematicWrapper`,
+// `SchematicBuilderWrapper`, etc. — that surface is unchanged. This sub-module
+// (`nucleation/api`) adds an ergonomic facade analogous to the Python API
+// described in api_upgrade.md.
+//
+// Usage:
+//   import init from 'nucleation';
+//   import { Schematic, Block, UseBlock } from 'nucleation/api';
+//   await init();
+//
+//   const schem = Schematic.new('test');
+//   schem.setBlock([0, 0, 0], 'minecraft:repeater', { state: { delay: 4 } });
+//   schem.save('out.litematic'); // browser: returns Uint8Array if no fs.
+
+import init, * as raw from './nucleation.js';
+
+export { init };
+export const _raw = raw;
+
+// --- Block ----------------------------------------------------------------
+
+const SNBT_RAW = '__snbt__';
+
+export class Block {
+  /**
+   * @param {string} id
+   * @param {object} [opts]
+   * @param {Record<string, string|number|boolean>} [opts.state]
+   * @param {Record<string, any>} [opts.nbt]
+   */
+  constructor(id, { state = null, nbt = null } = {}) {
+    this.id = id;
+    this.state = state;
+    this.nbt = nbt;
+    // Cached lazily on first toString() call. Block is otherwise frozen below.
+    this._payload = null;
+    this._hasExtras = !!(state && Object.keys(state).length) || !!(nbt && Object.keys(nbt).length);
+    Object.seal(this);  // allow _payload assignment, prevent new props
+  }
+
+  /** Parse "id[k=v,...]{snbt}" form. */
+  static parse(s) {
+    if (typeof s !== 'string') {
+      throw new TypeError(`Block.parse() expects a string, got ${typeof s}`);
+    }
+    let rest = s.trim();
+    let snbt = null;
+    if (rest.endsWith('}')) {
+      let depth = 0;
+      let cut = -1;
+      for (let i = rest.length - 1; i >= 0; i--) {
+        const ch = rest[i];
+        if (ch === '}') depth++;
+        else if (ch === '{') {
+          depth--;
+          if (depth === 0) {
+            cut = i;
+            break;
+          }
+        }
+      }
+      if (cut >= 0) {
+        snbt = rest.slice(cut + 1, -1);
+        rest = rest.slice(0, cut);
+      }
+    }
+    let state = null;
+    if (rest.endsWith(']')) {
+      const cut = rest.lastIndexOf('[');
+      if (cut >= 0) {
+        const inner = rest.slice(cut + 1, -1);
+        rest = rest.slice(0, cut);
+        state = {};
+        for (const kv of inner.split(',')) {
+          if (!kv.trim()) continue;
+          const eq = kv.indexOf('=');
+          if (eq < 0) continue;
+          const k = kv.slice(0, eq).trim();
+          const v = kv.slice(eq + 1).trim();
+          state[k] = coerceStateValue(v);
+        }
+      }
+    }
+    const nbt = snbt !== null ? { [SNBT_RAW]: snbt } : null;
+    return new Block(rest, { state, nbt });
+  }
+
+  withState(extra) {
+    return new Block(this.id, {
+      state: { ...(this.state || {}), ...extra },
+      nbt: this.nbt,
+    });
+  }
+
+  withNbt(extra) {
+    return new Block(this.id, {
+      state: this.state,
+      nbt: { ...(this.nbt || {}), ...extra },
+    });
+  }
+
+  toString() {
+    if (this._payload !== null) return this._payload;
+    let out = this.id;
+    if (this.state) {
+      const parts = Object.entries(this.state).map(
+        ([k, v]) => `${k}=${stateToStr(v)}`
+      );
+      if (parts.length) out += `[${parts.join(',')}]`;
+    }
+    if (this.nbt) {
+      if (SNBT_RAW in this.nbt && Object.keys(this.nbt).length === 1) {
+        out += `{${this.nbt[SNBT_RAW]}}`;
+      } else {
+        out += `{${dictToSnbt(this.nbt)}}`;
+      }
+    }
+    this._payload = out;
+    return out;
+  }
+}
+
+function coerceStateValue(v) {
+  if (v === 'true') return true;
+  if (v === 'false') return false;
+  if (/^-?\d+$/.test(v)) return parseInt(v, 10);
+  return v;
+}
+
+function stateToStr(v) {
+  if (typeof v === 'boolean') return v ? 'true' : 'false';
+  return String(v);
+}
+
+function valueToSnbt(v) {
+  if (typeof v === 'boolean') return v ? '1b' : '0b';
+  if (typeof v === 'number') {
+    return Number.isInteger(v) ? `${v}` : `${v}f`;
+  }
+  if (typeof v === 'string') {
+    return `"${v.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+  }
+  if (Array.isArray(v)) return `[${v.map(valueToSnbt).join(',')}]`;
+  if (v && typeof v === 'object') return `{${dictToSnbt(v)}}`;
+  throw new TypeError(`Cannot encode ${typeof v} as SNBT`);
+}
+
+function dictToSnbt(d) {
+  if (SNBT_RAW in d && Object.keys(d).length === 1) return String(d[SNBT_RAW]);
+  return Object.entries(d)
+    .map(([k, v]) => `${k}:${valueToSnbt(v)}`)
+    .join(',');
+}
+
+// --- Minecraft helpers (chest, sign, text, Item) -------------------------
+//
+// Modern (1.20+) NBT schemas. For pre-1.20 layouts, build the dict by hand
+// or use the `__snbt__` escape hatch in setBlock.
+
+export function text(s, opts = {}) {
+  if (typeof s !== 'string') {
+    throw new TypeError(`text() expects a string, got ${typeof s}`);
+  }
+  const out = { text: s };
+  if (opts.color !== undefined) out.color = opts.color;
+  for (const k of ['bold', 'italic', 'underlined', 'strikethrough', 'obfuscated']) {
+    if (opts[k] !== undefined) out[k] = opts[k];
+  }
+  return JSON.stringify(out);
+}
+
+export class Item {
+  constructor(id, { count = 1, slot = null, components = null } = {}) {
+    this.id = id;
+    this.count = count;
+    this.slot = slot;
+    this.components = components;
+    Object.freeze(this);
+  }
+}
+
+function coerceItem(x, defaultSlot) {
+  if (x instanceof Item) {
+    const d = {
+      Slot: x.slot != null ? x.slot : defaultSlot,
+      id: x.id,
+      Count: x.count,
+    };
+    if (x.components) d.components = { ...x.components };
+    return d;
+  }
+  if (typeof x === 'string') {
+    return { Slot: defaultSlot, id: x, Count: 1 };
+  }
+  if (Array.isArray(x)) {
+    if (x.length === 2) {
+      const [id, count] = x;
+      return { Slot: defaultSlot, id, Count: count };
+    }
+    if (x.length === 3) {
+      const [id, count, components] = x;
+      const d = { Slot: defaultSlot, id, Count: count };
+      if (components) d.components = { ...components };
+      return d;
+    }
+  }
+  throw new TypeError(
+    `Unsupported chest item: ${JSON.stringify(x)}. ` +
+    `Use Item(...), 'minecraft:foo', or [id, count, components?].`
+  );
+}
+
+export function chest(items, { name = null, lock = null, lootTable = null } = {}) {
+  const out = [];
+  if (items && !Array.isArray(items) && typeof items === 'object') {
+    // Plain object → explicit-slot map.
+    for (const [slotStr, x] of Object.entries(items)) {
+      const slot = parseInt(slotStr, 10);
+      const d = coerceItem(x, slot);
+      d.Slot = slot;
+      out.push(d);
+    }
+  } else {
+    let i = 0;
+    for (const x of items || []) {
+      out.push(coerceItem(x, i));
+      i++;
+    }
+  }
+  const nbt = { Items: out };
+  if (name !== null) nbt.CustomName = name.startsWith('{') ? name : text(name);
+  if (lock !== null) nbt.Lock = lock;
+  if (lootTable !== null) nbt.LootTable = lootTable;
+  return nbt;
+}
+
+function signMessages(lines) {
+  const msgs = [];
+  for (const line of lines || []) {
+    if (line == null || line === '') {
+      msgs.push('""');
+    } else if (typeof line === 'string') {
+      msgs.push(line.startsWith('{') ? line : text(line));
+    } else {
+      throw new TypeError('Sign line must be string (plain or JSON-component)');
+    }
+  }
+  while (msgs.length < 4) msgs.push('""');
+  if (msgs.length > 4) throw new RangeError('A sign has at most 4 lines per side');
+  return msgs;
+}
+
+export function sign(lines = [], { back = [], color = 'black', glowing = false, waxed = false } = {}) {
+  return {
+    front_text: { messages: signMessages(lines), color, has_glowing_text: glowing },
+    back_text:  { messages: signMessages(back),  color, has_glowing_text: glowing },
+    is_waxed: waxed,
+  };
+}
+
+// --- Events ---------------------------------------------------------------
+
+export class UseBlock {
+  constructor(pos) {
+    this.pos = pos;
+    Object.freeze(this);
+  }
+}
+
+export class ButtonPress {
+  constructor(pos) {
+    this.pos = pos;
+    Object.freeze(this);
+  }
+}
+
+// --- Cursor ---------------------------------------------------------------
+
+export class Cursor {
+  constructor(schem, origin, step) {
+    this._schem = schem;
+    this._origin = origin;
+    this.pos = origin;
+    this.step = step;
+  }
+
+  place(block, opts = {}) {
+    const offset = opts.offset || [0, 0, 0];
+    const target = [
+      this.pos[0] + offset[0],
+      this.pos[1] + offset[1],
+      this.pos[2] + offset[2],
+    ];
+    this._schem.setBlock(target, block, {
+      state: opts.state,
+      nbt: opts.nbt,
+    });
+    return this;
+  }
+
+  advance(n = 1) {
+    this.pos = [
+      this.pos[0] + this.step[0] * n,
+      this.pos[1] + this.step[1] * n,
+      this.pos[2] + this.step[2] * n,
+    ];
+    return this;
+  }
+
+  reset() {
+    this.pos = this._origin;
+    return this;
+  }
+}
+
+// --- Schematic ------------------------------------------------------------
+
+const LOAD_EXTS = ['.schem', '.litematic', '.nbt', '.schematic', '.mcstructure'];
+
+function suffixOf(path) {
+  const m = String(path).toLowerCase().match(/\.[^.\/\\]+$/);
+  return m ? m[0] : '';
+}
+
+export class Schematic {
+  constructor(rawWrapper, { pack = null } = {}) {
+    this.raw = rawWrapper;
+    this.pack = pack;
+    this._pendingBuilder = null;
+  }
+
+  /** Create a blank schematic. */
+  static new(name = 'untitled', { pack = null } = {}) {
+    if (typeof name !== 'string') {
+      throw new TypeError(`Schematic.new() name must be a string, got ${typeof name}`);
+    }
+    const w = new raw.SchematicWrapper();
+    if (typeof w.set_name === 'function') {
+      try { w.set_name(name); } catch {}
+    }
+    return new Schematic(w, { pack });
+  }
+
+  /**
+   * Load from binary data (Uint8Array). Format inferred from the second arg
+   * if it ends in a known extension; otherwise from_data() autodetects.
+   */
+  static open(data, { hint = null, pack = null } = {}) {
+    const w = new raw.SchematicWrapper();
+    const ext = hint ? suffixOf(hint) : '';
+    if (ext === '.litematic') w.from_litematic(data);
+    else if (ext === '.schem' || ext === '.schematic') w.from_schematic(data);
+    else if (ext === '.mcstructure') w.from_mcstructure(data);
+    else w.from_data(data);
+    return new Schematic(w, { pack });
+  }
+
+  /** Build from an ASCII-art template via SchematicBuilderWrapper. */
+  static fromTemplate(template, { name = 'untitled', pack = null } = {}) {
+    const builder = raw.SchematicBuilderWrapper.from_template
+      ? raw.SchematicBuilderWrapper.from_template(template)
+      : new raw.SchematicBuilderWrapper().from_template(template);
+    if (typeof builder.name === 'function') builder.name(name);
+    const schem = new Schematic(/* placeholder */ null, { pack });
+    schem._pendingBuilder = builder;
+    schem._pendingName = name;
+    return schem;
+  }
+
+  _ensureBuilt() {
+    if (this._pendingBuilder) {
+      this.raw = this._pendingBuilder.build();
+      this._pendingBuilder = null;
+    }
+    return this.raw;
+  }
+
+  /**
+   * Pre-resolve a plain block id to a palette index. Pair with `place()`
+   * in hot loops to skip the per-call name lookup. Returns the index.
+   */
+  prepareBlock(name) {
+    this._ensureBuilt();
+    return this.raw.prepareBlock(name);
+  }
+
+  /**
+   * Place a block by pre-resolved palette index. Pair with `prepareBlock`.
+   *
+   * Hot-loop pattern (~10 M placements/sec):
+   *
+   *   const stone = schem.prepareBlock('minecraft:stone');
+   *   const place = schem.raw.place.bind(schem.raw);
+   *   for (const [x, y, z] of positions) place(x, y, z, stone);
+   */
+  place(x, y, z, paletteIndex) {
+    this._ensureBuilt();
+    this.raw.place(x, y, z, paletteIndex);
+    return this;
+  }
+
+  /**
+   * setBlock([x, y, z], "id" | Block, { state?, nbt? })
+   * setBlock(x, y, z, "id")           — legacy form
+   *
+   * Performance: plain id strings and reused `Block` instances take fast
+   * paths (Block payloads cache after first use). For uniform regions or
+   * many positions of one block, prefer fill() / raw set_blocks().
+   */
+  setBlock(...args) {
+    let x, y, z, block, opts;
+    if (args.length === 4 && typeof args[0] === 'number') {
+      [x, y, z, block] = args;
+      opts = null;
+    } else if ((args.length === 2 || args.length === 3) && Array.isArray(args[0])) {
+      const pos = args[0];
+      if (pos.length !== 3 || !pos.every((v) => typeof v === 'number')) {
+        throw new TypeError(
+          `setBlock((x, y, z), block): first arg must be a 3-tuple of numbers, got [${pos.join(', ')}]`
+        );
+      }
+      [[x, y, z], block, opts = null] = args;
+    } else {
+      throw new TypeError(
+        `setBlock expected (x, y, z, block) or ([x, y, z], block, opts?), got ${args.length} args`
+      );
+    }
+    if (typeof block !== 'string' && !(block instanceof Block)) {
+      throw new TypeError(`block must be a string or Block, got ${typeof block}`);
+    }
+    if (opts && typeof opts !== 'object') {
+      throw new TypeError(`setBlock opts must be an object, got ${typeof opts}`);
+    }
+    if (opts && opts.state != null && (typeof opts.state !== 'object' || Array.isArray(opts.state))) {
+      throw new TypeError(`setBlock opts.state must be an object, got ${typeof opts.state}`);
+    }
+    if (opts && opts.nbt != null && (typeof opts.nbt !== 'object' || Array.isArray(opts.nbt))) {
+      throw new TypeError(
+        `setBlock opts.nbt must be an object, got ${typeof opts.nbt}. ` +
+        `For raw SNBT pass nbt: { __snbt__: '<your-snbt>' }.`
+      );
+    }
+    const inner = this.raw || this._ensureBuilt();
+
+    // Ultra-fast path: plain id, no opts.
+    if (!opts && typeof block === 'string') {
+      if (block.indexOf('[') < 0 && block.indexOf('{') < 0) {
+        inner.set_block(x, y, z, block);
+        return this;
+      }
+      inner.set_block_from_string(x, y, z, block);
+      return this;
+    }
+
+    // Fast path: reused Block, no override opts.
+    if (!opts && block instanceof Block) {
+      if (!block._hasExtras) {
+        inner.set_block(x, y, z, block.id);
+      } else if (block.nbt) {
+        inner.set_block_from_string(x, y, z, block.toString());
+      } else {
+        const props = {};
+        for (const [k, v] of Object.entries(block.state)) props[k] = stateToStr(v);
+        inner.set_block_with_properties(x, y, z, block.id, props);
+      }
+      return this;
+    }
+
+    // Slow path: opts may augment.
+    opts = opts || {};
+    let blockObj;
+    if (block instanceof Block) blockObj = block;
+    else if (typeof block === 'string') {
+      if (!opts.state && !opts.nbt && (block.includes('[') || block.includes('{'))) {
+        blockObj = Block.parse(block);
+      } else {
+        blockObj = new Block(block, { state: opts.state, nbt: opts.nbt });
+      }
+    } else {
+      throw new TypeError(`block must be string or Block, got ${typeof block}`);
+    }
+    const effState = { ...(blockObj.state || {}), ...(opts.state || {}) };
+    const effNbt = { ...(blockObj.nbt || {}), ...(opts.nbt || {}) };
+    const hasState = Object.keys(effState).length > 0;
+    const hasNbt = Object.keys(effNbt).length > 0;
+
+    if (hasNbt) {
+      const snbt = (SNBT_RAW in effNbt && Object.keys(effNbt).length === 1)
+        ? String(effNbt[SNBT_RAW])
+        : dictToSnbt(effNbt);
+      let payload = blockObj.id;
+      if (hasState) {
+        payload += '[' + Object.entries(effState).map(([k, v]) => `${k}=${stateToStr(v)}`).join(',') + ']';
+      }
+      payload += '{' + snbt + '}';
+      inner.set_block_from_string(x, y, z, payload);
+    } else if (hasState) {
+      const props = {};
+      for (const [k, v] of Object.entries(effState)) props[k] = stateToStr(v);
+      inner.set_block_with_properties(x, y, z, blockObj.id, props);
+    } else {
+      inner.set_block(x, y, z, blockObj.id);
+    }
+    return this;
+  }
+
+  map(char, block, { state = null, nbt = null } = {}) {
+    if (!this._pendingBuilder) {
+      throw new Error('map() is only valid on Schematic.fromTemplate()');
+    }
+    let payload;
+    if (block instanceof Block) payload = block.toString();
+    else if (state || nbt) payload = new Block(block, { state, nbt }).toString();
+    else payload = block;
+    this._pendingBuilder.map(char, payload);
+    return this;
+  }
+
+  fill([p1, p2], block) {
+    const blockId = block instanceof Block ? block.toString() : block;
+    const inner = this._ensureBuilt();
+    inner.fillCuboid(p1[0], p1[1], p1[2], p2[0], p2[1], p2[2], blockId);
+    return this;
+  }
+
+  cursor({ origin = [0, 0, 0], step = [1, 0, 0] } = {}) {
+    this._ensureBuilt();
+    return new Cursor(this, origin, step);
+  }
+
+  withPack(pack) {
+    this.pack = pack;
+    return this;
+  }
+
+  copy() {
+    const inner = this._ensureBuilt();
+    const data = inner.to_litematic();
+    const w = new raw.SchematicWrapper();
+    w.from_litematic(data);
+    return new Schematic(w, { pack: this.pack });
+  }
+
+  /** Run a redstone simulation, then sync results back into this schematic. */
+  simulate({ ticks = 1, events = [] } = {}) {
+    const inner = this._ensureBuilt();
+    if (typeof inner.create_simulation_world !== 'function') {
+      throw new Error('simulation feature is not available in this WASM build');
+    }
+    const world = inner.create_simulation_world();
+    for (const ev of events) {
+      if (ev instanceof UseBlock || ev instanceof ButtonPress) {
+        const [x, y, z] = ev.pos;
+        world.on_use_block(x, y, z);
+      } else {
+        throw new TypeError('Unsupported event; use UseBlock or ButtonPress');
+      }
+    }
+    world.tick(ticks);
+    world.sync_to_schematic();
+    if (typeof world.into_schematic === 'function') {
+      this.raw = world.into_schematic();
+    } else if (typeof world.get_schematic === 'function') {
+      this.raw = world.get_schematic();
+    }
+    return this;
+  }
+
+  /**
+   * Serialize to bytes by format extension; if a Node fs is provided
+   * (the default in Node), write to disk.
+   */
+  async save(path, { format = null, fs = null } = {}) {
+    const inner = this._ensureBuilt();
+    const ext = format ? '.' + format : suffixOf(path);
+    let bytes;
+    if (ext === '.litematic') bytes = inner.to_litematic();
+    else if (ext === '.schem' || ext === '.schematic') bytes = inner.to_schematic();
+    else if (ext === '.mcstructure') bytes = inner.to_mcstructure();
+    else throw new Error(`save: unknown format for ${path}`);
+    bytes = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
+    if (typeof process !== 'undefined' && process.versions?.node) {
+      const nodeFs = fs || (await import('node:fs/promises'));
+      await nodeFs.writeFile(path, bytes);
+      return null;
+    }
+    return bytes;
+  }
+}
+
+// --- SchematicBuilder shim ------------------------------------------------
+
+export class SchematicBuilder {
+  constructor() {
+    if (typeof console !== 'undefined' && console.warn) {
+      console.warn(
+        '[nucleation] SchematicBuilder is deprecated; use Schematic.fromTemplate(...)'
+      );
+    }
+    this._raw = new raw.SchematicBuilderWrapper();
+  }
+  name(n) { this._raw.name(n); return this; }
+  fromTemplate(t) { this._raw = raw.SchematicBuilderWrapper.from_template(t); return this; }
+  map(c, b) { this._raw.map(c, b); return this; }
+  build() { return new Schematic(this._raw.build()); }
+}

package/nucleation-original.js

@@ -4224,6 +4224,19 @@ export class SchematicWrapper {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Pre-resolve a plain block id to a palette index. Pair with
+     * `place(x, y, z, idx)` for the absolute fastest per-block placement
+     * in tight loops with multiple unique ids.
+     * @param {string} block_name
+     * @returns {number}
+     */
+    prepareBlock(block_name) {
+        const ptr0 = passStringToWasm0(block_name, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.schematicwrapper_prepareBlock(this.__wbg_ptr, ptr0, len0);
+        return ret >>> 0;
+    }
     /**
      * Remove a mobile entity by index. Returns true if removed.
      * @param {number} index
@@ -5065,6 +5078,17 @@ export class SchematicWrapper {
         SchematicWrapperFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * Place a block by pre-resolved palette index. Caller must have called
+     * `prepareBlock(name)` first to obtain `palette_index`.
+     * @param {number} x
+     * @param {number} y
+     * @param {number} z
+     * @param {number} palette_index
+     */
+    place(x, y, z, palette_index) {
+        wasm.schematicwrapper_place(this.__wbg_ptr, x, y, z, palette_index);
+    }
     /**
      * @returns {Array<any>}
      */
@@ -5226,6 +5250,34 @@ export class SchematicWrapper {
         const len0 = WASM_VECTOR_LEN;
         wasm.schematicwrapper_set_block(this.__wbg_ptr, x, y, z, ptr0, len0);
     }
+    /**
+     * Creates a simulation world for this schematic with default options
+     *
+     * This allows you to simulate redstone circuits and interact with them.
+     * @returns {MchprsWorldWrapper}
+     */
+    create_simulation_world() {
+        const ret = wasm.schematicwrapper_create_simulation_world(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return MchprsWorldWrapper.__wrap(ret[0]);
+    }
+    /**
+     * Creates a simulation world for this schematic with custom options
+     *
+     * This allows you to configure simulation behavior like wire state tracking.
+     * @param {SimulationOptionsWrapper} options
+     * @returns {MchprsWorldWrapper}
+     */
+    create_simulation_world_with_options(options) {
+        _assertClass(options, SimulationOptionsWrapper);
+        const ret = wasm.schematicwrapper_create_simulation_world_with_options(this.__wbg_ptr, options.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return MchprsWorldWrapper.__wrap(ret[0]);
+    }
     /**
      * Generate raw mesh data for custom rendering pipelines.
      * @param {ResourcePackWrapper} pack
@@ -5397,34 +5449,6 @@ export class SchematicWrapper {
         }
         return MeshOutputWrapper.__wrap(ret[0]);
     }
-    /**
-     * Creates a simulation world for this schematic with default options
-     *
-     * This allows you to simulate redstone circuits and interact with them.
-     * @returns {MchprsWorldWrapper}
-     */
-    create_simulation_world() {
-        const ret = wasm.schematicwrapper_create_simulation_world(this.__wbg_ptr);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return MchprsWorldWrapper.__wrap(ret[0]);
-    }
-    /**
-     * Creates a simulation world for this schematic with custom options
-     *
-     * This allows you to configure simulation behavior like wire state tracking.
-     * @param {SimulationOptionsWrapper} options
-     * @returns {MchprsWorldWrapper}
-     */
-    create_simulation_world_with_options(options) {
-        _assertClass(options, SimulationOptionsWrapper);
-        const ret = wasm.schematicwrapper_create_simulation_world_with_options(this.__wbg_ptr, options.__wbg_ptr);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return MchprsWorldWrapper.__wrap(ret[0]);
-    }
 }
 if (Symbol.dispose) SchematicWrapper.prototype[Symbol.dispose] = SchematicWrapper.prototype.free;
 

package/nucleation.d.ts

@@ -1224,6 +1224,12 @@ export class SchematicWrapper {
    * Fast binary snapshot deserialization — bypasses format manager for maximum speed.
    */
   fromSnapshot(data: Uint8Array): void;
+  /**
+   * Pre-resolve a plain block id to a palette index. Pair with
+   * `place(x, y, z, idx)` for the absolute fastest per-block placement
+   * in tight loops with multiple unique ids.
+   */
+  prepareBlock(block_name: string): number;
   /**
    * Remove a mobile entity by index. Returns true if removed.
    */
@@ -1366,6 +1372,11 @@ export class SchematicWrapper {
   createDefinitionRegionFromPoint(name: string, x: number, y: number, z: number): void;
   createDefinitionRegionFromBounds(name: string, min: BlockPosition, max: BlockPosition): void;
   constructor();
+  /**
+   * Place a block by pre-resolved palette index. Caller must have called
+   * `prepareBlock(name)` first to obtain `palette_index`.
+   */
+  place(x: number, y: number, z: number, palette_index: number): void;
   blocks(): Array<any>;
   chunks(chunk_width: number, chunk_height: number, chunk_length: number): Array<any>;
   /**
@@ -1403,6 +1414,18 @@ export class SchematicWrapper {
   from_data(data: Uint8Array): void;
   get_block(x: number, y: number, z: number): string | undefined;
   set_block(x: number, y: number, z: number, block_name: string): void;
+  /**
+   * Creates a simulation world for this schematic with default options
+   *
+   * This allows you to simulate redstone circuits and interact with them.
+   */
+  create_simulation_world(): MchprsWorldWrapper;
+  /**
+   * Creates a simulation world for this schematic with custom options
+   *
+   * This allows you to configure simulation behavior like wire state tracking.
+   */
+  create_simulation_world_with_options(options: SimulationOptionsWrapper): MchprsWorldWrapper;
   /**
    * Generate raw mesh data for custom rendering pipelines.
    */
@@ -1458,18 +1481,6 @@ export class SchematicWrapper {
    * Generate a USDZ mesh for the entire schematic.
    */
   toUsdz(pack: ResourcePackWrapper, config: MeshConfigWrapper): MeshOutputWrapper;
-  /**
-   * Creates a simulation world for this schematic with default options
-   *
-   * This allows you to simulate redstone circuits and interact with them.
-   */
-  create_simulation_world(): MchprsWorldWrapper;
-  /**
-   * Creates a simulation world for this schematic with custom options
-   *
-   * This allows you to configure simulation behavior like wire state tracking.
-   */
-  create_simulation_world_with_options(options: SimulationOptionsWrapper): MchprsWorldWrapper;
 }
 
 export class ShapeWrapper {
@@ -2013,6 +2024,8 @@ export interface InitOutput {
   readonly schematicwrapper_get_tight_dimensions: (a: number) => [number, number];
   readonly schematicwrapper_get_volume: (a: number) => number;
   readonly schematicwrapper_new: () => number;
+  readonly schematicwrapper_place: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly schematicwrapper_prepareBlock: (a: number, b: number, c: number) => number;
   readonly schematicwrapper_print_schematic: (a: number) => [number, number];
   readonly schematicwrapper_removeDefinitionRegion: (a: number, b: number, c: number) => number;
   readonly schematicwrapper_remove_entity: (a: number, b: number) => number;
@@ -2046,9 +2059,124 @@ export interface InitOutput {
   readonly schematicwrapper_to_world_zip: (a: number, b: number, c: number) => [number, number, number, number];
   readonly start: () => void;
   readonly schematicwrapper_updateRegion: (a: number, b: number, c: number, d: number) => void;
+  readonly __wbg_palettemanager_free: (a: number, b: number) => void;
+  readonly palettemanager_getConcreteBlocks: () => [number, number];
+  readonly palettemanager_getPaletteByKeywords: (a: number, b: number) => [number, number];
+  readonly palettemanager_getTerracottaBlocks: () => [number, number];
+  readonly palettemanager_getWoolBlocks: () => [number, number];
+  readonly __wbg_mchprsworldwrapper_free: (a: number, b: number) => void;
+  readonly __wbg_simulationoptionswrapper_free: (a: number, b: number) => void;
+  readonly mchprsworldwrapper_checkCustomIoChanges: (a: number) => void;
+  readonly mchprsworldwrapper_clearCustomIoChanges: (a: number) => void;
+  readonly mchprsworldwrapper_flush: (a: number) => void;
+  readonly mchprsworldwrapper_getSignalStrength: (a: number, b: number, c: number, d: number) => number;
+  readonly mchprsworldwrapper_get_lever_power: (a: number, b: number, c: number, d: number) => number;
+  readonly mchprsworldwrapper_get_redstone_power: (a: number, b: number, c: number, d: number) => number;
+  readonly mchprsworldwrapper_get_schematic: (a: number) => number;
+  readonly mchprsworldwrapper_get_truth_table: (a: number) => any;
+  readonly mchprsworldwrapper_into_schematic: (a: number) => number;
+  readonly mchprsworldwrapper_is_lit: (a: number, b: number, c: number, d: number) => number;
+  readonly mchprsworldwrapper_new: (a: number) => [number, number, number];
+  readonly mchprsworldwrapper_on_use_block: (a: number, b: number, c: number, d: number) => void;
+  readonly mchprsworldwrapper_peekCustomIoChanges: (a: number) => any;
+  readonly mchprsworldwrapper_pollCustomIoChanges: (a: number) => any;
+  readonly mchprsworldwrapper_setSignalStrength: (a: number, b: number, c: number, d: number, e: number) => void;
+  readonly mchprsworldwrapper_sync_to_schematic: (a: number) => void;
+  readonly mchprsworldwrapper_tick: (a: number, b: number) => void;
+  readonly mchprsworldwrapper_with_options: (a: number, b: number) => [number, number, number];
+  readonly simulationoptionswrapper_addCustomIo: (a: number, b: number, c: number, d: number) => void;
+  readonly simulationoptionswrapper_clearCustomIo: (a: number) => void;
+  readonly simulationoptionswrapper_io_only: (a: number) => number;
+  readonly simulationoptionswrapper_new: () => number;
+  readonly simulationoptionswrapper_optimize: (a: number) => number;
+  readonly simulationoptionswrapper_set_io_only: (a: number, b: number) => void;
+  readonly simulationoptionswrapper_set_optimize: (a: number, b: number) => void;
+  readonly schematicwrapper_create_simulation_world: (a: number) => [number, number, number];
+  readonly schematicwrapper_create_simulation_world_with_options: (a: number, b: number) => [number, number, number];
+  readonly __wbg_brushwrapper_free: (a: number, b: number) => void;
+  readonly __wbg_definitionregionwrapper_free: (a: number, b: number) => void;
+  readonly __wbg_shapewrapper_free: (a: number, b: number) => void;
+  readonly __wbg_wasmbuildingtool_free: (a: number, b: number) => void;
+  readonly brushwrapper_bilinear_gradient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number) => number;
+  readonly brushwrapper_color: (a: number, b: number, c: number, d: number, e: number) => number;
+  readonly brushwrapper_curveGradient: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+  readonly brushwrapper_linear_gradient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number) => number;
+  readonly brushwrapper_point_gradient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
+  readonly brushwrapper_shaded: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly brushwrapper_solid: (a: number, b: number) => [number, number, number];
+  readonly definitionregionwrapper_addBounds: (a: number, b: any, c: any) => [number, number, number];
+  readonly definitionregionwrapper_addFilter: (a: number, b: number, c: number) => [number, number, number];
+  readonly definitionregionwrapper_addPoint: (a: number, b: number, c: number, d: number) => number;
+  readonly definitionregionwrapper_boxCount: (a: number) => number;
+  readonly definitionregionwrapper_center: (a: number) => any;
+  readonly definitionregionwrapper_centerF32: (a: number) => any;
+  readonly definitionregionwrapper_clone: (a: number) => number;
+  readonly definitionregionwrapper_connectedComponents: (a: number) => number;
+  readonly definitionregionwrapper_contains: (a: number, b: number, c: number, d: number) => number;
+  readonly definitionregionwrapper_contract: (a: number, b: number) => number;
+  readonly definitionregionwrapper_contracted: (a: number, b: number) => number;
+  readonly definitionregionwrapper_dimensions: (a: number) => any;
+  readonly definitionregionwrapper_excludeBlock: (a: number, b: number, c: number) => [number, number, number];
+  readonly definitionregionwrapper_expand: (a: number, b: number, c: number, d: number) => number;
+  readonly definitionregionwrapper_expanded: (a: number, b: number, c: number, d: number) => number;
+  readonly definitionregionwrapper_filterByBlock: (a: number, b: number, c: number, d: number) => number;
+  readonly definitionregionwrapper_filterByProperties: (a: number, b: number, c: any) => [number, number, number];
+  readonly definitionregionwrapper_fromBoundingBoxes: (a: any) => [number, number, number];
+  readonly definitionregionwrapper_fromBounds: (a: number, b: number) => number;
+  readonly definitionregionwrapper_fromPositions: (a: any) => [number, number, number];
+  readonly definitionregionwrapper_getAllMetadata: (a: number) => any;
+  readonly definitionregionwrapper_getBlocks: (a: number) => [number, number, number];
+  readonly definitionregionwrapper_getBounds: (a: number) => any;
+  readonly definitionregionwrapper_getBox: (a: number, b: number) => any;
+  readonly definitionregionwrapper_getBoxes: (a: number) => any;
+  readonly definitionregionwrapper_getMetadata: (a: number, b: number, c: number) => any;
+  readonly definitionregionwrapper_intersect: (a: number, b: number) => number;
+  readonly definitionregionwrapper_intersected: (a: number, b: number) => number;
+  readonly definitionregionwrapper_intersectsBounds: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+  readonly definitionregionwrapper_isContiguous: (a: number) => number;
+  readonly definitionregionwrapper_isEmpty: (a: number) => number;
+  readonly definitionregionwrapper_merge: (a: number, b: number) => number;
+  readonly definitionregionwrapper_metadataKeys: (a: number) => any;
+  readonly definitionregionwrapper_new: () => number;
+  readonly definitionregionwrapper_positions: (a: number) => any;
+  readonly definitionregionwrapper_positionsSorted: (a: number) => any;
+  readonly definitionregionwrapper_setColor: (a: number, b: number) => number;
+  readonly definitionregionwrapper_setMetadata: (a: number, b: number, c: number, d: number, e: number) => number;
+  readonly definitionregionwrapper_shift: (a: number, b: number, c: number, d: number) => number;
+  readonly definitionregionwrapper_shifted: (a: number, b: number, c: number, d: number) => number;
+  readonly definitionregionwrapper_simplify: (a: number) => number;
+  readonly definitionregionwrapper_subtract: (a: number, b: number) => number;
+  readonly definitionregionwrapper_subtracted: (a: number, b: number) => number;
+  readonly definitionregionwrapper_union: (a: number, b: number) => number;
+  readonly definitionregionwrapper_unionInto: (a: number, b: number) => number;
+  readonly definitionregionwrapper_volume: (a: number) => number;
+  readonly shapewrapper_bezier: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+  readonly shapewrapper_cone: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly shapewrapper_cuboid: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly shapewrapper_cylinder: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly shapewrapper_cylinderBetween: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+  readonly shapewrapper_difference: (a: number, b: number) => number;
+  readonly shapewrapper_disk: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
+  readonly shapewrapper_ellipsoid: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+  readonly shapewrapper_hollow: (a: number, b: number) => number;
+  readonly shapewrapper_intersection: (a: number, b: number) => number;
+  readonly shapewrapper_line: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly shapewrapper_plane: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => number;
+  readonly shapewrapper_pyramid: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
+  readonly shapewrapper_sphere: (a: number, b: number, c: number, d: number) => number;
+  readonly shapewrapper_torus: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
+  readonly shapewrapper_triangle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => number;
+  readonly shapewrapper_union: (a: number, b: number) => number;
+  readonly wasmbuildingtool_fill: (a: number, b: number, c: number) => void;
+  readonly wasmbuildingtool_rstack: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+  readonly definitionregionwrapper_copy: (a: number) => number;
+  readonly __wbg_blockposition_free: (a: number, b: number) => void;
   readonly __wbg_chunkmeshiteratorwrapper_free: (a: number, b: number) => void;
   readonly __wbg_chunkmeshresultwrapper_free: (a: number, b: number) => void;
   readonly __wbg_circuitbuilderwrapper_free: (a: number, b: number) => void;
+  readonly __wbg_get_blockposition_x: (a: number) => number;
+  readonly __wbg_get_blockposition_y: (a: number) => number;
+  readonly __wbg_get_blockposition_z: (a: number) => number;
   readonly __wbg_itemmodelconfigwrapper_free: (a: number, b: number) => void;
   readonly __wbg_itemmodelresultwrapper_free: (a: number, b: number) => void;
   readonly __wbg_meshconfigwrapper_free: (a: number, b: number) => void;
@@ -2056,9 +2184,13 @@ export interface InitOutput {
   readonly __wbg_multimeshresultwrapper_free: (a: number, b: number) => void;
   readonly __wbg_rawmeshexportwrapper_free: (a: number, b: number) => void;
   readonly __wbg_resourcepackwrapper_free: (a: number, b: number) => void;
+  readonly __wbg_set_blockposition_x: (a: number, b: number) => void;
+  readonly __wbg_set_blockposition_y: (a: number, b: number) => void;
+  readonly __wbg_set_blockposition_z: (a: number, b: number) => void;
   readonly __wbg_sortstrategywrapper_free: (a: number, b: number) => void;
   readonly __wbg_statemodeconstants_free: (a: number, b: number) => void;
   readonly __wbg_textureatlaswrapper_free: (a: number, b: number) => void;
+  readonly blockposition_new: (a: number, b: number, c: number) => number;
   readonly buildResourcePack: (a: number, b: number) => [number, number, number];
   readonly chunkmeshiteratorwrapper_advance: (a: number) => [number, number, number];
   readonly chunkmeshiteratorwrapper_chunkCount: (a: number) => number;
@@ -2226,125 +2358,6 @@ export interface InitOutput {
   readonly multimeshresultwrapper_meshCount: (a: number) => number;
   readonly textureatlaswrapper_height: (a: number) => number;
   readonly textureatlaswrapper_width: (a: number) => number;
-  readonly __wbg_blockposition_free: (a: number, b: number) => void;
-  readonly __wbg_get_blockposition_x: (a: number) => number;
-  readonly __wbg_get_blockposition_y: (a: number) => number;
-  readonly __wbg_get_blockposition_z: (a: number) => number;
-  readonly __wbg_mchprsworldwrapper_free: (a: number, b: number) => void;
-  readonly __wbg_set_blockposition_x: (a: number, b: number) => void;
-  readonly __wbg_set_blockposition_y: (a: number, b: number) => void;
-  readonly __wbg_set_blockposition_z: (a: number, b: number) => void;
-  readonly __wbg_simulationoptionswrapper_free: (a: number, b: number) => void;
-  readonly blockposition_new: (a: number, b: number, c: number) => number;
-  readonly mchprsworldwrapper_checkCustomIoChanges: (a: number) => void;
-  readonly mchprsworldwrapper_clearCustomIoChanges: (a: number) => void;
-  readonly mchprsworldwrapper_flush: (a: number) => void;
-  readonly mchprsworldwrapper_getSignalStrength: (a: number, b: number, c: number, d: number) => number;
-  readonly mchprsworldwrapper_get_lever_power: (a: number, b: number, c: number, d: number) => number;
-  readonly mchprsworldwrapper_get_redstone_power: (a: number, b: number, c: number, d: number) => number;
-  readonly mchprsworldwrapper_get_schematic: (a: number) => number;
-  readonly mchprsworldwrapper_get_truth_table: (a: number) => any;
-  readonly mchprsworldwrapper_into_schematic: (a: number) => number;
-  readonly mchprsworldwrapper_is_lit: (a: number, b: number, c: number, d: number) => number;
-  readonly mchprsworldwrapper_new: (a: number) => [number, number, number];
-  readonly mchprsworldwrapper_on_use_block: (a: number, b: number, c: number, d: number) => void;
-  readonly mchprsworldwrapper_peekCustomIoChanges: (a: number) => any;
-  readonly mchprsworldwrapper_pollCustomIoChanges: (a: number) => any;
-  readonly mchprsworldwrapper_setSignalStrength: (a: number, b: number, c: number, d: number, e: number) => void;
-  readonly mchprsworldwrapper_sync_to_schematic: (a: number) => void;
-  readonly mchprsworldwrapper_tick: (a: number, b: number) => void;
-  readonly mchprsworldwrapper_with_options: (a: number, b: number) => [number, number, number];
-  readonly simulationoptionswrapper_addCustomIo: (a: number, b: number, c: number, d: number) => void;
-  readonly simulationoptionswrapper_clearCustomIo: (a: number) => void;
-  readonly simulationoptionswrapper_io_only: (a: number) => number;
-  readonly simulationoptionswrapper_new: () => number;
-  readonly simulationoptionswrapper_optimize: (a: number) => number;
-  readonly simulationoptionswrapper_set_io_only: (a: number, b: number) => void;
-  readonly simulationoptionswrapper_set_optimize: (a: number, b: number) => void;
-  readonly schematicwrapper_create_simulation_world: (a: number) => [number, number, number];
-  readonly schematicwrapper_create_simulation_world_with_options: (a: number, b: number) => [number, number, number];
-  readonly __wbg_palettemanager_free: (a: number, b: number) => void;
-  readonly palettemanager_getConcreteBlocks: () => [number, number];
-  readonly palettemanager_getPaletteByKeywords: (a: number, b: number) => [number, number];
-  readonly palettemanager_getTerracottaBlocks: () => [number, number];
-  readonly palettemanager_getWoolBlocks: () => [number, number];
-  readonly __wbg_brushwrapper_free: (a: number, b: number) => void;
-  readonly __wbg_definitionregionwrapper_free: (a: number, b: number) => void;
-  readonly __wbg_shapewrapper_free: (a: number, b: number) => void;
-  readonly __wbg_wasmbuildingtool_free: (a: number, b: number) => void;
-  readonly brushwrapper_bilinear_gradient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number, q: number, r: number, s: number, t: number, u: number, v: number, w: number, x: number) => number;
-  readonly brushwrapper_color: (a: number, b: number, c: number, d: number, e: number) => number;
-  readonly brushwrapper_curveGradient: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
-  readonly brushwrapper_linear_gradient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number) => number;
-  readonly brushwrapper_point_gradient: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number];
-  readonly brushwrapper_shaded: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
-  readonly brushwrapper_solid: (a: number, b: number) => [number, number, number];
-  readonly definitionregionwrapper_addBounds: (a: number, b: any, c: any) => [number, number, number];
-  readonly definitionregionwrapper_addFilter: (a: number, b: number, c: number) => [number, number, number];
-  readonly definitionregionwrapper_addPoint: (a: number, b: number, c: number, d: number) => number;
-  readonly definitionregionwrapper_boxCount: (a: number) => number;
-  readonly definitionregionwrapper_center: (a: number) => any;
-  readonly definitionregionwrapper_centerF32: (a: number) => any;
-  readonly definitionregionwrapper_clone: (a: number) => number;
-  readonly definitionregionwrapper_connectedComponents: (a: number) => number;
-  readonly definitionregionwrapper_contains: (a: number, b: number, c: number, d: number) => number;
-  readonly definitionregionwrapper_contract: (a: number, b: number) => number;
-  readonly definitionregionwrapper_contracted: (a: number, b: number) => number;
-  readonly definitionregionwrapper_dimensions: (a: number) => any;
-  readonly definitionregionwrapper_excludeBlock: (a: number, b: number, c: number) => [number, number, number];
-  readonly definitionregionwrapper_expand: (a: number, b: number, c: number, d: number) => number;
-  readonly definitionregionwrapper_expanded: (a: number, b: number, c: number, d: number) => number;
-  readonly definitionregionwrapper_filterByBlock: (a: number, b: number, c: number, d: number) => number;
-  readonly definitionregionwrapper_filterByProperties: (a: number, b: number, c: any) => [number, number, number];
-  readonly definitionregionwrapper_fromBoundingBoxes: (a: any) => [number, number, number];
-  readonly definitionregionwrapper_fromBounds: (a: number, b: number) => number;
-  readonly definitionregionwrapper_fromPositions: (a: any) => [number, number, number];
-  readonly definitionregionwrapper_getAllMetadata: (a: number) => any;
-  readonly definitionregionwrapper_getBlocks: (a: number) => [number, number, number];
-  readonly definitionregionwrapper_getBounds: (a: number) => any;
-  readonly definitionregionwrapper_getBox: (a: number, b: number) => any;
-  readonly definitionregionwrapper_getBoxes: (a: number) => any;
-  readonly definitionregionwrapper_getMetadata: (a: number, b: number, c: number) => any;
-  readonly definitionregionwrapper_intersect: (a: number, b: number) => number;
-  readonly definitionregionwrapper_intersected: (a: number, b: number) => number;
-  readonly definitionregionwrapper_intersectsBounds: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
-  readonly definitionregionwrapper_isContiguous: (a: number) => number;
-  readonly definitionregionwrapper_isEmpty: (a: number) => number;
-  readonly definitionregionwrapper_merge: (a: number, b: number) => number;
-  readonly definitionregionwrapper_metadataKeys: (a: number) => any;
-  readonly definitionregionwrapper_new: () => number;
-  readonly definitionregionwrapper_positions: (a: number) => any;
-  readonly definitionregionwrapper_positionsSorted: (a: number) => any;
-  readonly definitionregionwrapper_setColor: (a: number, b: number) => number;
-  readonly definitionregionwrapper_setMetadata: (a: number, b: number, c: number, d: number, e: number) => number;
-  readonly definitionregionwrapper_shift: (a: number, b: number, c: number, d: number) => number;
-  readonly definitionregionwrapper_shifted: (a: number, b: number, c: number, d: number) => number;
-  readonly definitionregionwrapper_simplify: (a: number) => number;
-  readonly definitionregionwrapper_subtract: (a: number, b: number) => number;
-  readonly definitionregionwrapper_subtracted: (a: number, b: number) => number;
-  readonly definitionregionwrapper_union: (a: number, b: number) => number;
-  readonly definitionregionwrapper_unionInto: (a: number, b: number) => number;
-  readonly definitionregionwrapper_volume: (a: number) => number;
-  readonly shapewrapper_bezier: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
-  readonly shapewrapper_cone: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
-  readonly shapewrapper_cuboid: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
-  readonly shapewrapper_cylinder: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
-  readonly shapewrapper_cylinderBetween: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
-  readonly shapewrapper_difference: (a: number, b: number) => number;
-  readonly shapewrapper_disk: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
-  readonly shapewrapper_ellipsoid: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
-  readonly shapewrapper_hollow: (a: number, b: number) => number;
-  readonly shapewrapper_intersection: (a: number, b: number) => number;
-  readonly shapewrapper_line: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
-  readonly shapewrapper_plane: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => number;
-  readonly shapewrapper_pyramid: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
-  readonly shapewrapper_sphere: (a: number, b: number, c: number, d: number) => number;
-  readonly shapewrapper_torus: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => number;
-  readonly shapewrapper_triangle: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => number;
-  readonly shapewrapper_union: (a: number, b: number) => number;
-  readonly wasmbuildingtool_fill: (a: number, b: number, c: number) => void;
-  readonly wasmbuildingtool_rstack: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-  readonly definitionregionwrapper_copy: (a: number) => number;
   readonly generate_gradient_between_blocks: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => any;
   readonly generate_gradient_between_colors: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => any;
   readonly get_all_colored_blocks: () => any;

package/package.json

@@ -5,7 +5,7 @@
     "Nano nano@schem.at"
   ],
   "description": "A high-performance Minecraft schematic parser and utility library",
-  "version": "0.1.184",
+  "version": "0.2.1",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
@@ -18,6 +18,7 @@
     "nucleation_bg.wasm",
     "nucleation_bg.d.ts",
     "nucleation-cdn-loader.js",
+    "api.js",
     "README.md"
   ],
   "main": "./nucleation.js",
@@ -40,6 +41,9 @@
     "./cdn-loader": {
       "import": "./nucleation-cdn-loader.js"
     },
+    "./api": {
+      "import": "./api.js"
+    },
     "./package.json": "./package.json"
   },
   "homepage": "https://github.com/Schem-at/Nucleation",