honse-sim 0.1.0 → 0.1.1

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "honse-sim",
   "type": "module",
-  "description": "WebAssembly adapter for the uma-sim race simulation engines (contested + vacuum).",
-  "version": "0.1.0",
+  "description": "WebAssembly adapter for the honse-sim race simulation engine.",
+  "version": "0.1.1",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
@@ -11,11 +11,12 @@
   "files": [
     "uma_sim_wasm_bg.wasm",
     "uma_sim_wasm.js",
-    "uma_sim_wasm.d.ts"
+    "uma_sim_wasm.d.ts",
+    "snippets"
   ],
   "main": "uma_sim_wasm.js",
   "types": "uma_sim_wasm.d.ts",
   "sideEffects": [
     "./snippets/*"
   ]
-}
+}

package/uma_sim_wasm.d.ts

@@ -43,17 +43,38 @@ export class WasmRaceSimulator {
     setOnRunnerFinished(cb: Function): void;
 }
 
+/**
+ * The late-race HP consumption multiplier for a guts stat.
+ *
+ * See [`honse_sim::readouts::guts_hp_burn_multiplier`].
+ */
+export function gutsHpBurnMultiplier(guts: number): number;
+
+/**
+ * Stamina's HP conversion coefficient for a strategy id (1-5).
+ *
+ * See [`honse_sim::readouts::hp_strategy_coefficient`].
+ */
+export function hpStrategyCoefficient(strategy: number): number;
+
 /**
  * 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.
+ * Exposed so an external consumer can cross-check its simulatability gate
+ * against the engine that runs the simulation. Any token a consumer treats as
+ * simulatable must be resolvable by this engine.
  * Returned as a sorted JS string array.
  */
 export function knownConditionTokens(): string[];
 
+/**
+ * The HP a runner starts a race with, from stamina, strategy id, and course
+ * distance in meters.
+ *
+ * See [`honse_sim::readouts::max_hp`].
+ */
+export function maxHp(stamina: number, strategy: number, distance: number): number;
+
 /**
  * Run a batch compare-family simulation and return the serialized result.
  *
@@ -80,12 +101,21 @@ export function runContestedCompare(params: any): any;
  */
 export function runRaceSim(params: any): any;
 
+/**
+ * The pre-race wisdom check pass rate, as a percentage, for a base wit stat.
+ *
+ * See [`honse_sim::readouts::skill_activation_percent`].
+ */
+export function skillActivationPercent(base_wit: number): number;
+
 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 hpStrategyCoefficient: (a: number) => [number, number, number];
     readonly knownConditionTokens: () => [number, number];
+    readonly maxHp: (a: number, b: number, c: number) => [number, number, number];
     readonly runCompare: (a: any) => [number, number, number];
     readonly runContestedCompare: (a: any) => [number, number, number];
     readonly runRaceSim: (a: any) => [number, number, number];
@@ -96,14 +126,16 @@ export interface InitOutput {
     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 gutsHpBurnMultiplier: (a: number) => number;
+    readonly skillActivationPercent: (a: number) => number;
     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_table_dealloc: (a: number) => void;
     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;
 }
 

package/uma_sim_wasm.js

@@ -83,23 +83,67 @@ export class WasmRaceSimulator {
 }
 if (Symbol.dispose) WasmRaceSimulator.prototype[Symbol.dispose] = WasmRaceSimulator.prototype.free;
 
+/**
+ * The late-race HP consumption multiplier for a guts stat.
+ *
+ * See [`honse_sim::readouts::guts_hp_burn_multiplier`].
+ * @param {number} guts
+ * @returns {number}
+ */
+export function gutsHpBurnMultiplier(guts) {
+    const ret = wasm.gutsHpBurnMultiplier(guts);
+    return ret;
+}
+
+/**
+ * Stamina's HP conversion coefficient for a strategy id (1-5).
+ *
+ * See [`honse_sim::readouts::hp_strategy_coefficient`].
+ * @param {number} strategy
+ * @returns {number}
+ */
+export function hpStrategyCoefficient(strategy) {
+    const ret = wasm.hpStrategyCoefficient(strategy);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return ret[0];
+}
+
 /**
  * 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.
+ * Exposed so an external consumer can cross-check its simulatability gate
+ * against the engine that runs the simulation. Any token a consumer treats as
+ * simulatable must be resolvable by this engine.
  * Returned as a sorted JS string array.
  * @returns {string[]}
  */
 export function knownConditionTokens() {
     const ret = wasm.knownConditionTokens();
-    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
     wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
     return v1;
 }
 
+/**
+ * The HP a runner starts a race with, from stamina, strategy id, and course
+ * distance in meters.
+ *
+ * See [`honse_sim::readouts::max_hp`].
+ * @param {number} stamina
+ * @param {number} strategy
+ * @param {number} distance
+ * @returns {number}
+ */
+export function maxHp(stamina, strategy, distance) {
+    const ret = wasm.maxHp(stamina, strategy, distance);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return ret[0];
+}
+
 /**
  * Run a batch compare-family simulation and return the serialized result.
  *
@@ -149,14 +193,26 @@ export function runRaceSim(params) {
     }
     return takeFromExternrefTable0(ret[0]);
 }
+
+/**
+ * The pre-race wisdom check pass rate, as a percentage, for a base wit stat.
+ *
+ * See [`honse_sim::readouts::skill_activation_percent`].
+ * @param {number} base_wit
+ * @returns {number}
+ */
+export function skillActivationPercent(base_wit) {
+    const ret = wasm.skillActivationPercent(base_wit);
+    return ret;
+}
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_ef53bc310eb298a0: function(arg0, arg1) {
+        __wbg_Error_408e67f47ca7b58b: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_Number_6b506e6536831eaa: function(arg0) {
+        __wbg_Number_3890faa6d3ff057d: function(arg0) {
             const ret = Number(arg0);
             return ret;
         },
@@ -167,64 +223,64 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_bigint_get_as_i64_38130e98eecd467d: function(arg0, arg1) {
+        __wbg___wbindgen_bigint_get_as_i64_c4ecf48528083721: function(arg0, arg1) {
             const v = arg1;
             const ret = typeof(v) === 'bigint' ? v : undefined;
             getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_boolean_get_1a45e2c38d4d41b9: function(arg0) {
+        __wbg___wbindgen_boolean_get_c9c83ebd41b34df3: function(arg0) {
             const v = arg0;
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_0accd80f45e5faa2: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_a57024b9c6e4a48b: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
             const len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_in_70a403a56e771704: function(arg0, arg1) {
+        __wbg___wbindgen_in_ac983077f137f2e6: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_bigint_6ffd6468a9bc44b9: function(arg0) {
+        __wbg___wbindgen_is_bigint_8ffbbef442139384: function(arg0) {
             const ret = typeof(arg0) === 'bigint';
             return ret;
         },
-        __wbg___wbindgen_is_function_754e9f305ff6029e: function(arg0) {
+        __wbg___wbindgen_is_function_5e4570eb24ffa122: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_object_56732c2bc353f41d: function(arg0) {
+        __wbg___wbindgen_is_object_a2790eb24c211ea0: function(arg0) {
             const val = arg0;
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_string_c236cabd84a4d769: function(arg0) {
+        __wbg___wbindgen_is_string_e6f02f0ea5f20a32: function(arg0) {
             const ret = typeof(arg0) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_67b456be8673d3d7: function(arg0) {
+        __wbg___wbindgen_is_undefined_6cff064c44e0d823: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_eq_1068e624fa87f6ab: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_eq_0a18949a61670320: function(arg0, arg1) {
             const ret = arg0 === arg1;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_2c56564c75129511: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_acf2776254a8d832: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_9bb1761122181af2: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_136b9679cab35cfb: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_72bdf95d3ae505b1: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_d154f1e671052120: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -232,34 +288,34 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_1506f2235d1bdba0: function(arg0, arg1) {
+        __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_8a89609d89f6608a: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_1c5886ab9c57d1c7: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_call_9c758de292015997: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_call_35dba3c747ad7521: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_done_60cf307fcc680536: function(arg0) {
+        __wbg_done_669171204c3dcae2: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_entries_04b37a02507f1713: function(arg0) {
+        __wbg_entries_7774d489e1da5f4f: function(arg0) {
             const ret = Object.entries(arg0);
             return ret;
         },
-        __wbg_get_1f8f054ddbaa7db2: function() { return handleError(function (arg0, arg1) {
-            const ret = Reflect.get(arg0, arg1);
-            return ret;
-        }, arguments); },
-        __wbg_get_2b48c7d0d006a781: function(arg0, arg1) {
+        __wbg_get_c0c8f8d7da0c03dd: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
-        __wbg_get_unchecked_33f6e5c9e2f2d6b2: function(arg0, arg1) {
+        __wbg_get_d173c0308df22d37: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(arg0, arg1);
+            return ret;
+        }, arguments); },
+        __wbg_get_unchecked_e20b893aeafc3fca: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
@@ -267,7 +323,7 @@ function __wbg_get_imports() {
             const ret = arg0[arg1];
             return ret;
         },
-        __wbg_instanceof_ArrayBuffer_8f49811467741499: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_993d02d2d254cad1: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof ArrayBuffer;
@@ -277,7 +333,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_86f30649f63ef9c2: function(arg0) {
+        __wbg_instanceof_Uint8Array_f935dbb0aa7cdeed: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -287,64 +343,64 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_67c2c9c4313f4448: function(arg0) {
+        __wbg_isArray_6339f732981044bf: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_isSafeInteger_66acec27e09e99a7: function(arg0) {
+        __wbg_isSafeInteger_f3d6cd19ccfe4512: function(arg0) {
             const ret = Number.isSafeInteger(arg0);
             return ret;
         },
-        __wbg_iterator_8732428d309e270e: function() {
+        __wbg_iterator_5cebbb86e33c6dd6: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_4a591ecaa01354d9: function(arg0) {
+        __wbg_length_36bd29c6848c2144: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_66f1a4b2e9026940: function(arg0) {
+        __wbg_length_ecfa2c63d3d0d82c: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_578aeef4b6b94378: function(arg0) {
+        __wbg_new_116be93542d39019: function() {
+            const ret = new Array();
+            return ret;
+        },
+        __wbg_new_77cc4f4f472aeb81: function(arg0) {
             const ret = new Uint8Array(arg0);
             return ret;
         },
-        __wbg_new_622fc80556be2e26: function() {
+        __wbg_new_cdf041679ded4c5f: function() {
             const ret = new Map();
             return ret;
         },
-        __wbg_new_ce1ab61c1c2b300d: function() {
+        __wbg_new_ebe3e0f6837f0879: function() {
             const ret = new Object();
             return ret;
         },
-        __wbg_new_d90091b82fdf5b91: function() {
-            const ret = new Array();
+        __wbg_next_42cf16ee0dafc9e2: function() { return handleError(function (arg0) {
+            const ret = arg0.next();
             return ret;
-        },
-        __wbg_next_9e03acdf51c4960d: function(arg0) {
+        }, arguments); },
+        __wbg_next_8f26b64fa5e9f64b: function(arg0) {
             const ret = arg0.next;
             return ret;
         },
-        __wbg_next_eb8ca7351fa27906: function() { return handleError(function (arg0) {
-            const ret = arg0.next();
-            return ret;
-        }, arguments); },
-        __wbg_prototypesetcall_3249fc62a0fafa30: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_de8e0d9553586985: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_set_52b1e1eb5bed906a: function(arg0, arg1, arg2) {
+        __wbg_set_014226dfeca53178: function(arg0, arg1, arg2) {
             const ret = arg0.set(arg1, arg2);
             return ret;
         },
         __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
             arg0[arg1] = arg2;
         },
-        __wbg_set_dca99999bba88a9a: function(arg0, arg1, arg2) {
+        __wbg_set_a80955eb93b145c6: function(arg0, arg1, arg2) {
             arg0[arg1 >>> 0] = arg2;
         },
-        __wbg_value_f3625092ee4b37f4: function(arg0) {
+        __wbg_value_1e2369fab29b420e: function(arg0) {
             const ret = arg0.value;
             return ret;
         },
@@ -593,11 +649,15 @@ function __wbg_finalize_init(instance, module) {
 
 async function __wbg_load(module, imports) {
     if (typeof Response === 'function' && module instanceof Response) {
+        if (!module.ok) {
+            throw new Error(`failed to fetch Wasm: ${module.status} ${module.statusText} fetching '${module.url}'`);
+        }
+
         if (typeof WebAssembly.instantiateStreaming === 'function') {
             try {
                 return await WebAssembly.instantiateStreaming(module, imports);
             } catch (e) {
-                const validResponse = module.ok && expectedResponseType(module.type);
+                const validResponse = expectedResponseType(module.type);
 
                 if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
                     console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);