motely-wasm 19.0.2 → 19.1.0

package/README.md

@@ -15,10 +15,9 @@ npm install motely-wasm
 ```js
 import bootsharp, { Motely } from "motely-wasm";
 
-// Boot the .NET WASM runtime. In a browser, pass the URL path under which your
-// host serves the package's `bin/` directory (where dotnet.native.wasm lives).
-// In Node, pass the `.wasm` bytes directly — see the "Booting" section below.
-await bootsharp.boot("/motely-wasm/bin");
+// Boot the .NET WASM runtime — no arguments needed.
+// The WASM binary is embedded in the package as base64 (single self-contained ESM).
+await bootsharp.boot();
 
 // A JAML filter — see https://github.com/OptimusPi/MotelyJAML for the language.
 const jaml = `
@@ -46,53 +45,22 @@ console.log("done:", search.totalSeedsSearched, "searched,", search.matchingSeed
 
 ## Booting
 
-`bootsharp.boot(...)` initializes the .NET WASM runtime. Call it once before any
-`Motely.*` API. The argument shape depends on the host.
+`bootsharp.boot()` initializes the .NET WASM runtime. Call it once before any `Motely.*` API.
 
-### Browser
-
-Pass the URL path your host serves the package's `bin/` directory at (where
-`dotnet.native.wasm` lives). It's host-chosen — typical mountings:
-
-| Host | Mount `bin/` at | Boot call |
-| --- | --- | --- |
-| Vite / Storybook `staticDirs` | `/motely-wasm/bin` | `boot("/motely-wasm/bin")` |
-| Next.js route handler | `/motely-wasm/bin/[...path]` | `boot("/motely-wasm/bin")` |
-| Public CDN (pinned version) | `https://unpkg.com/motely-wasm@<version>/bin` | `boot("https://unpkg.com/motely-wasm@18.2.2/bin")` |
-
-Web Workers must boot from the **same** URL as the main thread — absolute paths
-in a worker resolve against the page origin, so whichever URL serves the WASM
-to the main thread is the same one the worker must pass.
+The WASM binary is **embedded** in the package as base64 — no separate files to serve, no CDN config, no `bin/` directory. One import, one `boot()`, done. Works in browser, Node, Web Workers, v0 previews, MCP apps, GitHub Pages — anywhere.
 
 ```js
 import bootsharp from "motely-wasm";
 
 if (bootsharp.getStatus() === bootsharp.BootStatus.Standby) {
-  await bootsharp.boot("/motely-wasm/bin");
+  await bootsharp.boot();
 }
 
 console.log(bootsharp.getStatus()); // BootStatus.Booted
 ```
 
-### Node / Bun / Deno
-
-Same ESM import as the browser. Point `boot()` at the published `bin/` directory
-(Node `fetch` accepts `file://` URLs):
-
-```js
-import bootsharp, { Motely } from "motely-wasm";
-
-const binRoot = new URL("bin/", import.meta.resolve("motely-wasm/package.json")).href;
-await bootsharp.boot(binRoot);
-
-const status = Motely.validateJaml(jaml);
-```
-
-Requires Node ≥ 20.6 (`import.meta.resolve`). Node 22 LTS is the recommended floor.
-
 **Publish gate (repo):** after `dotnet publish Motely.Wasm -c Release`, run
-`node Motely.Wasm/motely.test.mjs` and `node Motely.Wasm/pack-consumer-smoke.mjs`
-(`npm pack` → fresh `npm install` → same boot path).
+`node Motely.Wasm/motely.test.mjs` and `node Motely.Wasm/pack-consumer-smoke.mjs`.
 
 ## JAML API
 
@@ -193,74 +161,6 @@ console.log(search.isCompleted, search.totalSeedsSearched, search.matchingSeeds)
 search.cancel(); // stop early
 ```
 
-## Stream cursor
-
-`Motely.createStreamCursor(seed, deck, stake, ante, kind)` returns a stateful cursor over
-one of Balatro's per-ante PRNG streams — one packed int per item, no JAML filter needed.
-The `kind` argument selects which stream; one factory + one enum arg covers every stream
-type:
-
-```js
-import { Motely } from "motely-wasm";
-import { MotelyStreamKind } from "motely-wasm/motely";
-import { MotelyDeck, MotelyStake } from "motely-wasm/motely/enums";
-
-const cursor = Motely.createStreamCursor("AAAAAAAA", MotelyDeck.Red, MotelyStake.White, 1, MotelyStreamKind.Shop);
-const items = cursor.getNextChunk(6); // 6 packed ints, one WASM crossing
-```
-
-**Always prefer `getNextChunk(n)` over repeated `getNext()` calls** — each call is a WASM
-interop crossing, so batching is the right default.
-
-| `MotelyStreamKind` value | Stream | Returned int |
-|---|---|---|
-| `Shop` | Mixed shop (jokers, tarots, planets, spectrals on Ghost, standard cards with MagicTrick) | Packed item (`decodeItemType`, `decodeItemCategory`, …) |
-| `Joker` | Shop jokers — includes edition + sticker bits | Packed item |
-| `Tarot` | Shop tarots | Packed item |
-| `Planet` | Shop planets | Packed item |
-| `Spectral` | Shop spectrals (non-Ghost returns `SpectralExcludedByStream`) | Packed item |
-| `LegendaryJoker` | Legendary fixed-rarity joker stream | Packed item |
-| `RareTagJoker` | Rare Tag hand-out joker stream | Packed item |
-| `Tag` | Tags — raw `MotelyTag` enum cast to int. Decoders do not apply; use `MotelyTag[value]`. | `(int)MotelyTag` |
-| `Voucher` | Vouchers — raw `MotelyVoucher` enum cast to int. Uses an empty run state, so odd-indexed (prerequisite-required) vouchers are skipped by the engine. Use `MotelyVoucher[value]`. | `(int)MotelyVoucher` |
-
-## Packed-int decoders
-
-Stream cursors return packed integers. Bit fields are extracted with the decode helpers
-on `Motely`:
-
-```js
-import { Motely } from "motely-wasm";
-import { MotelyStreamKind } from "motely-wasm/motely";
-import {
-    MotelyItemType, MotelyItemTypeCategory, MotelyJokerRarity,
-    MotelyItemEdition, MotelyItemSeal, MotelyItemEnhancement,
-} from "motely-wasm/motely/enums";
-
-const cursor = Motely.createStreamCursor("AAAAAAAA", 0, 0, 1, MotelyStreamKind.Joker);
-const v = cursor.getNext();
-
-const type      = Motely.decodeItemType(v);        // → MotelyItemType value
-const category  = Motely.decodeItemCategory(v);    // → MotelyItemTypeCategory value
-const rarity    = Motely.decodeJokerRarity(v);     // → MotelyJokerRarity (Common/Uncommon/Rare/Legendary)
-const edition   = Motely.decodeItemEdition(v);     // → MotelyItemEdition (None/Foil/Holo/Poly/Negative)
-const seal      = Motely.decodeItemSeal(v);        // → MotelyItemSeal
-const enh       = Motely.decodeItemEnhancement(v); // → MotelyItemEnhancement
-
-const perishable = Motely.isPerishable(v);  // → boolean
-const eternal    = Motely.isEternal(v);     // → boolean
-const rental     = Motely.isRental(v);      // → boolean
-
-console.log(MotelyItemType[type]);      // e.g. "WeeJoker"
-console.log(MotelyJokerRarity[rarity]); // e.g. "Common"
-```
-
-All enum tables (`MotelyItemType`, `MotelyItemTypeCategory`, `MotelyJokerRarity`,
-`MotelyItemEdition`, `MotelyItemSeal`, `MotelyItemEnhancement`, `MotelyTag`,
-`MotelyVoucher`, `MotelyBoosterPack`, `MotelyDeck`, `MotelyStake`) live at
-`motely-wasm/motely/enums` and can be used for reverse-lookup by numeric value or
-forward-lookup by name. `MotelyStreamKind` lives at `motely-wasm/motely`.
-
 ## Events
 
 Callbacks are registered on `Motely` once per `bootsharp.boot()` — not on each settings
@@ -287,7 +187,7 @@ Motely.onScoredResult.unsubscribe(handler);
 | Import path | Contents |
 |---|---|
 | `motely-wasm` | Default export: `boot`, `getStatus`, `BootStatus`. Named export: `Motely` (main API) |
-| `motely-wasm/motely` | `IMotelySearch`, `SearchSettings`, `IMotelyStreamCursor`, `MotelyProgress`, `MotelyScoredSeedResult`, `MotelyStreamKind` |
+| `motely-wasm/motely` | `IMotelySearch`, `SearchSettings`, `MotelyProgress`, `MotelyScoredSeedResult`, `MotelyStreamKind` |
 | `motely-wasm/motely/enums` | All Balatro enums — `MotelyItemType`, `MotelyItemTypeCategory`, `MotelyJokerRarity`, `MotelyItemEdition`, `MotelyItemSeal`, `MotelyItemEnhancement`, `MotelyTag`, `MotelyVoucher`, `MotelyBoosterPack`, `MotelyDeck`, `MotelyStake`, `MotelyBossBlind`, etc. |
 | `motely-wasm/motely/filters` | `JamlAesthetic`, `JamlSearchPlan` |
 | `motely-wasm/motely/analysis` | `MotelyJamlyzerResult`, `MotelySeedAnalysis` |
@@ -315,7 +215,7 @@ self.onmessage = async ({ data }) => {
 
   try {
     if (bootsharp.getStatus() === bootsharp.BootStatus.Standby) {
-      await bootsharp.boot("/motely-wasm/bin");
+      await bootsharp.boot();
     }
 
     const onResult = r =>

package/dist/bcl/collection.d.mts

@@ -3,7 +3,7 @@
  *  user code and passed across the interop boundary; instances received from C# are wrapped into
  *  generated proxies that expose the same shape. */
 export declare class Collection<T> {
-    private readonly items;
+    protected readonly items: T[];
     constructor(items?: Iterable<T>);
     /** Number of items in the collection. */
     get count(): number;

package/dist/bcl/index.d.mts

@@ -1,3 +1,4 @@
 export * from "./event.mjs";
 export * from "./collection.mjs";
+export * from "./list.mjs";
 export * from "./cancellation.mjs";

package/dist/bcl/index.mjs

@@ -1,3 +1,4 @@
 export * from "./event.mjs";
 export * from "./collection.mjs";
+export * from "./list.mjs";
 export * from "./cancellation.mjs";

package/dist/bcl/list.d.mts

@@ -0,0 +1,17 @@
+import { Collection } from "./collection.mjs";
+/** JavaScript counterpart of the C# <c>System.Collections.Generic.IList&lt;T&gt;</c> specialization.
+ *  Extends <see cref="Collection"/> with index-based access; like the collection, hand-rolled
+ *  instances are passed across the interop boundary, while instances received from C# are wrapped
+ *  into generated proxies that expose the same shape. */
+export declare class List<T> extends Collection<T> {
+    /** Returns the index of the first occurrence of the specified item, or -1 when not found. */
+    indexOf(item: T): number;
+    /** Inserts the specified item at the specified index. */
+    insert(index: number, item: T): void;
+    /** Removes the item at the specified index. */
+    removeAt(index: number): void;
+    /** Returns the item at the specified index. */
+    getAt(index: number): T;
+    /** Assigns the specified item at the specified index. */
+    setAt(index: number, item: T): void;
+}

package/dist/bcl/list.mjs

@@ -0,0 +1,27 @@
+import { Collection } from "./collection.mjs";
+/** JavaScript counterpart of the C# <c>System.Collections.Generic.IList&lt;T&gt;</c> specialization.
+ *  Extends <see cref="Collection"/> with index-based access; like the collection, hand-rolled
+ *  instances are passed across the interop boundary, while instances received from C# are wrapped
+ *  into generated proxies that expose the same shape. */
+export class List extends Collection {
+    /** Returns the index of the first occurrence of the specified item, or -1 when not found. */
+    indexOf(item) {
+        return this.items.indexOf(item);
+    }
+    /** Inserts the specified item at the specified index. */
+    insert(index, item) {
+        this.items.splice(index, 0, item);
+    }
+    /** Removes the item at the specified index. */
+    removeAt(index) {
+        this.items.splice(index, 1);
+    }
+    /** Returns the item at the specified index. */
+    getAt(index) {
+        return this.items[index];
+    }
+    /** Assigns the specified item at the specified index. */
+    setAt(index, item) {
+        this.items[index] = item;
+    }
+}