honse-sim 0.1.0

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "honse-sim",
+  "type": "module",
+  "description": "WebAssembly adapter for the uma-sim race simulation engines (contested + vacuum).",
+  "version": "0.1.0",
+  "license": "GPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jalbarrang/torena-sim"
+  },
+  "files": [
+    "uma_sim_wasm_bg.wasm",
+    "uma_sim_wasm.js",
+    "uma_sim_wasm.d.ts"
+  ],
+  "main": "uma_sim_wasm.js",
+  "types": "uma_sim_wasm.d.ts",
+  "sideEffects": [
+    "./snippets/*"
+  ]
+}

package/uma_sim_wasm.d.ts

@@ -0,0 +1,130 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * A streaming race simulator with per-event JS callbacks.
+ *
+ * Construct with [`WasmRaceSimulator::new`], register callbacks, then call
+ * [`run`](WasmRaceSimulator::run) to drive the race aggregate over the
+ * configured rounds. Callbacks fire live; the serialized batch result is
+ * returned at the end.
+ */
+export class WasmRaceSimulator {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Build a simulator from a [`WasmRaceSimParams`] JS object.
+     */
+    constructor(params: any);
+    /**
+     * Run the configured rounds, firing callbacks live, and return the
+     * serialized [`WasmRaceSimResult`].
+     */
+    run(): any;
+    /**
+     * Register the `after-runner-tick(snapshot)` callback.
+     */
+    setOnAfterRunnerTick(cb: Function): void;
+    /**
+     * Register the `before-tick(dt)` callback.
+     */
+    setOnBeforeTick(cb: Function): void;
+    /**
+     * Register the `round-end()` callback.
+     */
+    setOnRoundEnd(cb: Function): void;
+    /**
+     * Register the `round-start(seed)` callback.
+     */
+    setOnRoundStart(cb: Function): void;
+    /**
+     * Register the `runner-finished(runnerId)` callback.
+     */
+    setOnRunnerFinished(cb: Function): void;
+}
+
+/**
+ * All condition tokens the Rust engine's catalog recognizes.
+ *
+ * Exposed so the TS-side simulatability gate (ADR-0003, driven by the TS
+ * `knownConditionTokens` vocabulary) can be cross-checked against the engine
+ * that actually runs the sim, closing the dual-parser drift risk (ADR-0004):
+ * any token the UI treats as simulatable must be resolvable by this engine.
+ * Returned as a sorted JS string array.
+ */
+export function knownConditionTokens(): string[];
+
+/**
+ * Run a batch compare-family simulation and return the serialized result.
+ *
+ * `params` is a [`WasmCompareParams`] JS object (a small vacuum field over
+ * `nsamples` rounds). Returns a [`WasmCompareData`] (per-round, per-runner
+ * telemetry); the bashin-delta + summary stats are computed on the TS side.
+ */
+export function runCompare(params: any): any;
+
+/**
+ * Run a same-race compare-family simulation and return the serialized result.
+ *
+ * `params` is a [`WasmContestedCompareParams`] JS object (2..=12 compared
+ * runners, optionally mob-filled via `fillTo`). Returns the same [`WasmCompareData`] shape
+ * as vacuum compare so the TS reducer can be reused.
+ */
+export function runContestedCompare(params: any): any;
+
+/**
+ * Run a batch race simulation and return the serialized result.
+ *
+ * `params` is a [`WasmRaceSimParams`] JS object. Returns a
+ * [`WasmRaceSimResult`] (per-round finish orders + focus telemetry).
+ */
+export function runRaceSim(params: any): any;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_wasmracesimulator_free: (a: number, b: number) => void;
+    readonly knownConditionTokens: () => [number, number];
+    readonly runCompare: (a: any) => [number, number, number];
+    readonly runContestedCompare: (a: any) => [number, number, number];
+    readonly runRaceSim: (a: any) => [number, number, number];
+    readonly wasmracesimulator_new: (a: any) => [number, number, number];
+    readonly wasmracesimulator_run: (a: number) => [number, number, number];
+    readonly wasmracesimulator_setOnAfterRunnerTick: (a: number, b: any) => void;
+    readonly wasmracesimulator_setOnBeforeTick: (a: number, b: any) => void;
+    readonly wasmracesimulator_setOnRoundEnd: (a: number, b: any) => void;
+    readonly wasmracesimulator_setOnRoundStart: (a: number, b: any) => void;
+    readonly wasmracesimulator_setOnRunnerFinished: (a: number, b: any) => void;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_exn_store: (a: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __externref_drop_slice: (a: number, b: number) => void;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;