@onimaxxing/worldgen-node 0.15.0

package/index.cjs

@@ -0,0 +1,147 @@
+// CommonJS wrapper for the Node target. Mirrors `index.js` (ESM) but
+// uses require/module.exports so it interoperates with the CJS
+// `oni_wasm.js` that wasm-pack generates for `--target nodejs`.
+//
+// Same surface as `index.js`: default export is `init` (a no-op on
+// Node since WASM is loaded synchronously at require time), plus the
+// `worldgen` singleton.
+
+const _wasm = require('./oni_wasm.js');
+
+// JS-side checksum cache. The resident snapshot lives WASM-side (in
+// SNAPSHOT_SLOT). Mutator methods set `_checksumDirty = true`; the
+// hot path is a boolean check + cached string return.
+let _lastChecksum = null;
+let _checksumDirty = true;
+
+// No-op init for consistency with the web target. Node's wasm-pack
+// glue loads the WASM at require time via fs.readFileSync; there's
+// nothing to await.
+async function init(_opts) {}
+
+function decodeSnapshot(buf) {
+  if (!buf || buf.length === 0) {
+    throw new Error(
+      'settle_cluster_advance returned an empty buffer — no cached cluster, or tick out of range. Did you call worldgen.generate(coord) first?'
+    );
+  }
+  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+  let offset = 0;
+  const version = view.getUint32(offset, true); offset += 4;
+  if (version !== 4) {
+    throw new Error(`decodeSnapshot: expected version 4, got ${version}`);
+  }
+  const tick = view.getUint32(offset, true); offset += 4;
+  const worldCount = view.getUint32(offset, true); offset += 4;
+
+  const worlds = [];
+  for (let w = 0; w < worldCount; w++) {
+    const width = view.getUint32(offset, true); offset += 4;
+    const height = view.getUint32(offset, true); offset += 4;
+    const cells = width * height;
+
+    const element_idx = new Uint16Array(cells);
+    const mass = new Float32Array(cells);
+    const temperature = new Float32Array(cells);
+    const disease_idx = new Uint8Array(cells);
+    const disease_count = new Int32Array(cells);
+
+    for (let c = 0; c < cells; c++) {
+      element_idx[c] = view.getUint16(offset, true); offset += 2;
+      mass[c] = view.getFloat32(offset, true); offset += 4;
+      temperature[c] = view.getFloat32(offset, true); offset += 4;
+      disease_idx[c] = view.getUint8(offset); offset += 1;
+      disease_count[c] = view.getInt32(offset, true); offset += 4;
+    }
+
+    worlds.push({
+      width, height,
+      element_idx, mass, temperature,
+      disease_idx, disease_count,
+    });
+  }
+
+  return { tick, worlds };
+}
+
+const worldgen = {
+  generate(coord) {
+    // Typed-array transport: per-cell grids arrive as Uint16Array /
+    // Float32Array / Uint8Array / Int32Array — no JSON.parse.
+    return _wasm.generate_map_data(coord);
+  },
+  advance(tick) {
+    return decodeSnapshot(_wasm.settle_cluster_advance(tick));
+  },
+  entities() {
+    return JSON.parse(_wasm.get_entity_spawners());
+  },
+  clear() {
+    _wasm.clear_cluster_cache();
+  },
+
+  // Snapshot-based settings I/O. The resident snapshot lives WASM-side
+  // in a thread-local slot; JS only tracks a checksum-cache dirty
+  // flag. See index.js for the full contract notes.
+  snapshot: {
+    loadVanilla() {
+      _wasm.snapshot_state_vanilla();
+      _checksumDirty = true;
+    },
+    loadVanillaExtensions() {
+      _wasm.snapshot_state_vanilla_extensions();
+      _checksumDirty = true;
+    },
+    load(files) {
+      _wasm.snapshot_state_load(JSON.stringify(files));
+      _checksumDirty = true;
+    },
+    loadExtensions(files) {
+      _wasm.snapshot_state_load_extensions(JSON.stringify(files));
+      _checksumDirty = true;
+    },
+    merge(files) {
+      _wasm.snapshot_state_merge(JSON.stringify(files));
+      _checksumDirty = true;
+    },
+    files() {
+      return JSON.parse(_wasm.snapshot_state_files());
+    },
+    checksum() {
+      if (!_checksumDirty && _lastChecksum !== null) {
+        return _lastChecksum;
+      }
+      _lastChecksum = _wasm.snapshot_state_checksum();
+      _checksumDirty = false;
+      return _lastChecksum;
+    },
+    remove(paths) {
+      if (!paths || paths.length === 0) return;
+      _wasm.snapshot_state_drop_paths(JSON.stringify(paths));
+      _checksumDirty = true;
+    },
+    schemaVersion() {
+      return _wasm.game_version();
+    },
+  },
+
+  reset() {
+    _wasm.settings_reset();
+    _lastChecksum = null;
+    _checksumDirty = true;
+  },
+
+  version() {
+    return _wasm.game_version();
+  },
+};
+
+// Re-export the Klei-faithful YAML parser so consumers have a
+// one-stop import for the full ingestion pipeline (YAML → JSON →
+// worldgen.snapshot.merge). Mirrors the ESM variant in `index.js`.
+const { parseKleiYaml } = require('./yaml.cjs');
+
+module.exports = init;
+module.exports.default = init;
+module.exports.worldgen = worldgen;
+module.exports.parseKleiYaml = parseKleiYaml;