motely-wasm 9.0.0 → 9.9.9

package/README.md

@@ -1,14 +1,21 @@
 # motely-wasm (NativeAOT-LLVM + Bootsharp)
 
-This project compiles Motely to **browser WASM** with **Bootsharp** interop. Prefer **`MotelyJamlSearchBuilder`** for new code (`loadJaml`/`compileJummy` → search mode → `run`). The legacy **`MotelyWasmHost`** `start*` helpers are still exported for compatibility. Progress/results go through **`SearchEvents`**.
+This project compiles Motely to **browser WASM** with **Bootsharp** interop. Two complementary APIs are exported, both first-class:
+
+- **`MotelyWasmHost`** — one-call host. `loadJaml` / `compileJummy` parse JAML; `startRandomSearchFromJaml(jaml, count)`, `startConfiguredSearchFromJaml(...)`, `startSeedListSearchFromJaml(...)` start a search in a single call. The host owns `_currentSearch`; `stopSearch()` cancels it.
+- **`MotelyJamlSearchBuilder`** — fluent multi-step builder. Chain `loadJaml(jaml) → random(n) | sequential(...) | seedList(...) | aesthetic(a) | keywords(...) → run()` when you need fine-grained control over the search pipeline.
+
+Both call into the same engine. Pick whichever shape matches your call site; neither is deprecated.
+
+Progress and results go through **`SearchEvents`** (`onProgress`, `onResult`, `onComplete` — JS subscribes; C# notifies). Single-seed inspection lives on **`MotelyWasmHost`** (`singleGetBossForAnte`, `singleGetAnteFirstVoucher`, etc.) — these take `seed/deck/stake` on every call so JS does not have to hold a stateful per-instance handle.
 
 The **`Program`** class here is only the **runtime bootstrap** (`Main` → `RunBootsharp()`). Do not confuse it with `Motely.CLI`.
 
-**Bootsharp glue** (`JSExport` / `JSImport` / `JSPreferences`) is isolated in **`BootsharpInterop.cs`** so you can ignore it while working in C#. **`MotelyJamlSearchBuilder`** (preferred search API), **`MotelyWasmHost`** (compatibility wrapper), **`MotelySingleSearchContext`** (seed inspection), and **`SearchEvents`** (progress/results) are the real API surface.
+**Bootsharp glue** (`JSExport` / `JSImport` / `JSPreferences`) is isolated in **`BootsharpInterop.cs`** so you can ignore it while working in C#. The public API surface is **`MotelyWasmHost`**, **`MotelyJamlSearchBuilder`**, **`MotelySingleSearchContext`** (seed inspection), and **`SearchEvents`** (progress/results).
 
-After `dotnet publish` on this project, the npm package is emitted under `motely-wasm/` (and `motely-wasm-compat/` is built by the csproj target). **Monaco** is not part of these packages — use `tools/jaml-language/monaco` (`@motely/jaml-monaco`) for editor assets.
+After `dotnet publish` on this project, the npm package is emitted under `motely-wasm/` (single package, binaries always embedded). **Monaco** is not part of these packages — use `tools/jaml-language/monaco` (`@motely/jaml-monaco`) for editor assets.
 
-**API note:** `MotelyJamlSearchBuilder` is the preferred API (`loadJaml` → `random`/`sequential`/etc → `run`), but `MotelyWasmHost` remains available for older callers (`loadJaml`, `startRandomSearch`, `stopSearch`, etc.).
+**Bootsharp interop rule (9.0.0+):** a `[JSExport]` interface method on `MotelyWasmHost` must NOT call another `[JSExport]` interface method on `this`. Mono WASM rejects the resulting managed→`[UnmanagedCallersOnly]` dispatch with `Fatal error. Invalid Program: attempted to call a UnmanagedCallersOnly method from managed code.` Inline shared logic into a `private static` helper (see `LoadJamlCore`) and call the helper from each public method.
 
 **Sequential batch size:** `batchCharCount` applies only to **sequential** search (`startSequentialSearch*`, and `startConfiguredSearch` when the JAML has **no** `aesthetics`). Keyword/random/aesthetic/seed-list modes are **provider** searches and do **not** take `batchCharCount` (the engine uses fixed vector-width batches).
 

package/package.json

@@ -1,40 +1,37 @@
 {
-    "name": "motely-wasm",
-    "version": "9.0.0",
-    "description": "MotelyJAML — Balatro seed search engine (browser WASM / NativeAOT-LLVM). Import: import bootsharp, { MotelyJamlSearchBuilder, MotelyWasmHost, SearchEvents, Motely } from \"motely-wasm\"; await bootsharp.boot();",
-    "type": "module",
-    "main": "./index.mjs",
-    "types": "./types/index.d.ts",
-    "browser": {
-        "fs/promises": false
-    },
-    "exports": {
-        ".": {
-            "types": "./types/index.d.ts",
-            "import": "./index.mjs",
-            "default": "./index.mjs"
-        },
-        "./jaml.schema.json": "./jaml.schema.json"
-    },
-    "files": [
-        "**/*",
-        "!test.html",
-        "!index.html",
-        "!**/*.pdb",
-        "!**/*.tgz"
-    ],
-    "keywords": [
-        "balatro",
-        "seed",
-        "wasm",
-        "bootsharp",
-        "nativeaot-llvm",
-        "jaml"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/OptimusPi/MotelyJAML.git",
-        "directory": "Motely"
-    },
-    "license": "MIT"
+  "name": "motely-wasm",
+  "version": "9.9.9",
+  "description": "MotelyJAML — Balatro seed search engine (browser WASM / NativeAOT-LLVM). Import: import bootsharp, { MotelyJamlSearchBuilder, MotelyWasmHost, SearchEvents, Motely } from \"motely-wasm\"; await bootsharp.boot();",
+  "type": "module",
+  "main": "../motely-wasm/index.mjs",
+  "types": "../motely-wasm/types/index.d.ts",
+  "browser": {
+    "fs/promises": false
+  },
+  "exports": {
+    ".": {
+      "types": "../motely-wasm/types/index.d.ts",
+      "import": "../motely-wasm/index.mjs",
+      "default": "../motely-wasm/index.mjs"
+    }
+  },
+  "files": [
+    "../motely-wasm/**/*",
+    "!**/*.pdb",
+    "!**/*.tgz"
+  ],
+  "keywords": [
+    "balatro",
+    "seed",
+    "wasm",
+    "bootsharp",
+    "nativeaot-llvm",
+    "jaml"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OptimusPi/MotelyJAML.git",
+    "directory": "Motely"
+  },
+  "license": "MIT"
 }