@onimaxxing/worldgen 0.15.0

package/serial/oni_wasm_bg.wasm.d.ts

@@ -0,0 +1,47 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const evaluate_noise: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+export const game_version: () => [number, number];
+export const generate_cluster: (a: number, b: number, c: number) => [number, number];
+export const generate_cluster_cells: (a: number, b: number, c: number) => [number, number];
+export const generate_cluster_with_configs: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number];
+export const generate_from_coordinate: (a: number, b: number) => [number, number];
+export const generate_layout_cells: (a: number, b: number, c: number) => [number, number];
+export const generate_map_data: (a: number, b: number) => any;
+export const get_entity_spawners: () => [number, number];
+export const noise_node_kinds: () => [number, number];
+export const set_skip_templates: (a: number) => void;
+export const settings_reset: () => void;
+export const settle_cluster_advance: (a: number) => [number, number];
+export const sim_env_drain_log: (a: number, b: number) => [number, number];
+export const sim_env_set: (a: number, b: number, c: number, d: number) => void;
+export const snapshot_checksum: (a: number, b: number) => [number, number, number, number];
+export const snapshot_checksum_bytes: (a: number, b: number) => [number, number];
+export const snapshot_from_files: (a: number, b: number) => [number, number, number, number];
+export const snapshot_from_files_extensions: (a: number, b: number) => [number, number, number, number];
+export const snapshot_load_vanilla: () => [number, number, number, number];
+export const snapshot_load_vanilla_extensions: () => [number, number, number, number];
+export const snapshot_merge_files: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+export const snapshot_remove_paths: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+export const snapshot_state_checksum: () => [number, number, number, number];
+export const snapshot_state_drop_paths: (a: number, b: number) => [number, number, number];
+export const snapshot_state_files: () => [number, number, number, number];
+export const snapshot_state_load: (a: number, b: number) => [number, number, number];
+export const snapshot_state_load_extensions: (a: number, b: number) => [number, number, number];
+export const snapshot_state_merge: (a: number, b: number) => [number, number, number];
+export const snapshot_state_reset: () => void;
+export const snapshot_state_vanilla: () => number;
+export const snapshot_state_vanilla_extensions: () => number;
+export const snapshot_to_files: (a: number, b: number) => [number, number, number, number];
+export const snapshot_checksum_canonical: (a: number, b: number) => [number, number, number, number];
+export const clear_cluster_cache: () => void;
+export const snapshot_state_version: () => number;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_exn_store: (a: number) => void;
+export const __externref_table_alloc: () => number;
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_start: () => void;

package/yaml.d.ts

@@ -0,0 +1,19 @@
+// Type declaration for the Klei-faithful YAML parser. Mirrors
+// `yaml.js` in the same directory. Consumers can also import
+// `parseKleiYaml` directly from the package root (re-exported by
+// `index.{js,cjs}`).
+
+/**
+ * Parse a YAML string the way Klei (YamlDotNet) would:
+ *
+ *   1. Tabs are pre-expanded to 4 spaces (Klei's `readText.Replace`).
+ *   2. YAML 1.1 boolean sentinels (`yes/no/on/off`) on plain scalars
+ *      become booleans; quoted forms stay as strings.
+ *   3. Duplicate mapping keys: last-wins.
+ *   4. Unknown YAML tags are silently stripped.
+ *   5. Null mapping values are dropped recursively (Klei's reflection-
+ *      based loader treats `key:` as "field not present").
+ *
+ * Returns a plain JS object/array/scalar suitable for JSON.stringify.
+ */
+export function parseKleiYaml(text: string): unknown;

package/yaml.js

@@ -0,0 +1,97 @@
+// Klei-faithful YAML parser. The single canonical implementation
+// for both `scripts/yaml_to_json.mjs` (the batch CLI) and the
+// published worldgen wrapper (re-exports `parseKleiYaml` from
+// `index.{js,cjs}`).
+//
+// WASM stays JSON-only — every consumer that ingests a Klei `.yaml`
+// file goes through this function first, then hands the resulting
+// JSON to `worldgen.snapshot.load` / `merge`.
+//
+// Klei (YamlDotNet) compatibility — what we mimic via the schema/
+// options below, matching the decompiled `Klei.YamlIO.Parse`:
+//
+//   (1) Tab → 4-space preprocessing. Klei runs `readText.Replace(
+//       "\t", "    ")` unconditionally before YamlDotNet. The YAML
+//       spec rejects tab indentation; mod authors use tabs constantly.
+//   (2) YAML 1.1 boolean sentinels (`yes/no/on/off`) as PLAIN scalars
+//       become booleans. Quoted forms ("yes") stay as strings.
+//   (3) Duplicate mapping keys: last-wins. js-yaml >=4 throws on
+//       duplicate keys unless `json: true` is passed; we opt in to
+//       that mode so YamlDotNet-style "last-wins" semantics carry
+//       through (mods like Baator ship feature/noise YAMLs with
+//       duplicated `source0:` / `add:` keys that YamlDotNet accepts
+//       silently).
+//   (4) Unknown YAML tags (`!Foo value`) silently stripped.
+//   (5) `key:` with null value: strip the key recursively so missing
+//       scalars stay at their default and missing lists become
+//       empty — serde rejects explicit `null` for non-Option types.
+
+import yaml from 'js-yaml';
+
+const KleiBool = new yaml.Type('tag:yaml.org,2002:bool', {
+    kind: 'scalar',
+    // Single-letter `y`/`n` are intentionally EXCLUDED: many files
+    // have keys like `X: 64, Y: 96` (Vec2/Vec3 components). js-yaml's
+    // resolvers run uniformly in key and value position, so accepting
+    // `y`/`Y` here would coerce `Y:` keys to literal `true:` and lose
+    // the data.
+    resolve: (data) => typeof data === 'string'
+        && /^(yes|no|on|off|true|false)$/i.test(data),
+    construct: (data) => /^(yes|on|true)$/i.test(data),
+});
+
+// IMPORTANT: use `{ implicit: [...] }`, NOT a bare array. The bare
+// form APPENDS — `string` (catch-all) matches "yes" first, so KleiBool
+// never runs. Implicit-prepend wins.
+//
+// We do NOT register a custom Float Type here. js-yaml keys Types by
+// (tag, kind), so an extension with the same `tag:yaml.org,2002:float`
+// REPLACES the default float resolver entirely — we accidentally
+// broke parsing of standard `0.4`/`1.5` floats this way once. The
+// leading-dot-without-zero form (`.2`, `-.2`) that C# accepts but
+// js-yaml emits as a string is handled in `coerceNumericStrings`
+// below, which post-processes the parsed tree.
+const KleiSchema = yaml.DEFAULT_SCHEMA.extend({ implicit: [KleiBool] });
+
+/** Match strings of the form `.5`, `-.5`, `+.5`, with optional
+ *  scientific exponent. Standard floats like `0.5` already become JS
+ *  numbers via js-yaml's built-in resolver — only the leading-dot
+ *  form needs this post-pass.
+ *  See `worldgen/traits/MisalignedStart.yaml` (`min: -.2 / max: .2`)
+ *  for an example shipped by Klei. */
+const LEADING_DOT_FLOAT = /^[-+]?\.[0-9]+(?:[eE][-+]?[0-9]+)?$/;
+
+/** Parse a YAML string the way Klei (YamlDotNet) would. Returns a
+ *  plain JS object/array/scalar suitable for JSON.stringify. */
+export function parseKleiYaml(text) {
+    const preprocessed = text.replace(/\t/g, '    ');
+    const raw = yaml.load(preprocessed, { schema: KleiSchema, json: true });
+    return stripNulls(raw);
+}
+
+function stripNulls(node) {
+    if (node === null || node === undefined) return undefined;
+    if (Array.isArray(node)) {
+        const out = [];
+        for (const v of node) {
+            const stripped = stripNulls(v);
+            if (stripped !== undefined) out.push(stripped);
+        }
+        return out;
+    }
+    if (typeof node === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(node)) {
+            const stripped = stripNulls(v);
+            if (stripped !== undefined) out[k] = stripped;
+        }
+        return out;
+    }
+    // Coerce leading-dot floats (`.5`, `-.5`) to JS numbers. Standard
+    // floats arrive as numbers already; this branch only catches
+    // strings that LOOK like floats but failed the default resolver.
+    if (typeof node === 'string' && LEADING_DOT_FLOAT.test(node)) {
+        return parseFloat(node);
+    }
+    return node;
+}