jaml-ui 0.6.1 → 0.7.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 pifreak
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 pifreak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,145 +1,135 @@
-# jaml-ui
-
-React components and utilities for Balatro/JAML. Pair with **`motely-wasm`** when you need the engine (peer). Update both in consumers with normal **`pnpm update`** / semver like any other deps.
-
-## Package shape
-
-- `jaml-ui`
-  - React/client entry for rendered components and hooks
-- `jaml-ui/core`
-  - Pure asset helpers, sprite metadata, and decode utilities that do not depend on `motely-wasm`
-- `jaml-ui/motely`
-  - Optional plain `motely-wasm` helpers for decoding Motely item enums
-
-## Install
-
-```bash
-npm install jaml-ui react react-dom
-```
-
-If you want the Motely-specific helpers too:
-
-```bash
-npm install jaml-ui motely-wasm react react-dom
-```
-
-## Quick start
-
-```tsx
-"use client";
-
-import { JamlGameCard } from "jaml-ui";
-
-export function Example() {
-  return (
-    <JamlGameCard
-      type="joker"
-      card={{
-        name: "Blueprint",
-        edition: "Foil",
-        isEternal: true,
-        scale: 1.5,
-      }}
-    />
-  );
-}
-```
-
-## JAML preview
-
-```tsx
-"use client";
-
-import { JamlMapPreview } from "jaml-ui";
-
-export function PreviewExample({ jaml }: { jaml: string }) {
-  return <JamlMapPreview jaml={jaml} title="JAML Intent Preview" />;
-}
-```
-
-## Lightweight JAML IDE shell
-
-```tsx
-"use client";
-
-import { useState } from "react";
-import { JamlIde } from "jaml-ui";
-
-export function IdeExample() {
-  const [jaml, setJaml] = useState("must:\n  joker: Blueprint");
-
-  return (
-    <JamlIde
-      jaml={jaml}
-      onChange={setJaml}
-      results={[]}
-    />
-  );
-}
-```
-
-## Asset handling
-
-By default, `jaml-ui` resolves its packaged sprite assets from the package `assets/` directory using `import.meta.url`.
-
-If you want to host the assets yourself, set a custom base URL once during app startup:
-
-```tsx
-"use client";
-
-import { setJamlAssetBaseUrl } from "jaml-ui";
-
-setJamlAssetBaseUrl("/vendor/jaml-ui/");
-```
-
-Reset back to packaged assets with:
-
-```ts
-import { clearJamlAssetBaseUrl } from "jaml-ui";
-
-clearJamlAssetBaseUrl();
-```
-
-## Core utilities
-
-```ts
-import { SPRITE_SHEETS, getSpriteData, resolveJamlAssetUrl } from "jaml-ui/core";
-
-const jokerSheetUrl = SPRITE_SHEETS.jokers.src;
-const blueprintSprite = getSpriteData("Blueprint");
-const vouchersUrl = resolveJamlAssetUrl("vouchers");
-```
-
-## Motely helpers
-
-```ts
-"use client";
-
-import { decodeMotelyItemName, motelyItemTypeName } from "jaml-ui/motely";
-
-const itemName = decodeMotelyItemName(0x5001);
-const enumKey = motelyItemTypeName(0x5001);
-```
-
-## Next.js notes
-
-- The root `jaml-ui` entry is client-oriented and preserves the `"use client"` boundary for component consumers.
-- Import pure helpers from `jaml-ui/core` when you want server-safe metadata and asset utilities.
-- If you are consuming `jaml-ui` from a local workspace package in a Next.js app, you may need:
-
-```ts
-// next.config.ts
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {
-  transpilePackages: ["jaml-ui"],
-};
-
-export default nextConfig;
-```
-
-## Browser-first runtime direction
-
-`jaml-ui` is designed for browser/React consumers. The optional `jaml-ui/motely` entry targets plain `motely-wasm` and does not assume threaded WASM, SAB, or COEP setup.
-
-The built-in `JamlIde` intentionally stays lightweight. Rich editor integrations like Monaco, custom language servers, or extension-host-specific tooling should live in app-level packages on top of `jaml-ui`, not in the base renderer package.
+# jaml-ui
+
+React components, UI tokens, sprites, and utilities for Balatro/JAML apps.
+
+## Install
+
+```bash
+npm install jaml-ui react react-dom
+```
+
+## Package exports
+
+| Entry | Contents |
+|-------|----------|
+| `jaml-ui` | Game card components, JAML IDE, Analyzer Explorer, hooks |
+| `jaml-ui/ui` | Jimbo design system — JimboPanel, JimboButton, JimboModal, tokens |
+| `jaml-ui/core` | Pure asset helpers, sprite metadata, decode utilities (no React) |
+| `jaml-ui/motely` | motely-wasm decode helpers (requires `motely-wasm` peer) |
+| `jaml-ui/r3f` | 3D card component via React Three Fiber (requires r3f peers) |
+
+## Quick start
+
+```tsx
+import { JamlGameCard, AnalyzerExplorer, JamlIde } from "jaml-ui";
+import { JimboPanel, JimboButton } from "jaml-ui/ui";
+```
+
+### Game card
+
+```tsx
+import { JamlGameCard } from "jaml-ui";
+
+<JamlGameCard
+  type="joker"
+  card={{ name: "Blueprint", edition: "Foil", isEternal: true, scale: 1.5 }}
+/>
+```
+
+### Jimbo UI (Balatro design system)
+
+```tsx
+import { JimboPanel, JimboButton, JimboModal } from "jaml-ui/ui";
+import { JimboColorOption } from "jaml-ui/ui";
+
+<JimboPanel sway onBack={() => setOpen(false)}>
+  <JimboButton variant="primary" onClick={handleSearch}>Search</JimboButton>
+</JimboPanel>
+```
+
+Available variants: `primary`, `secondary`, `danger`, `back`, `ghost`
+
+### JAML IDE
+
+```tsx
+import { JamlIde } from "jaml-ui";
+
+<JamlIde
+  jaml={jaml}
+  onChange={setJaml}
+  searchResults={results}
+  onSearch={handleSearch}
+  isSearching={isSearching}
+/>
+```
+
+### Analyzer Explorer
+
+```tsx
+import { AnalyzerExplorer } from "jaml-ui";
+
+// antes: AnalyzerAnteView[] — stream from motely-wasm createSearchContext
+<AnalyzerExplorer antes={antes} totalAntes={8} highlights={highlights} />
+```
+
+### JAML Map Preview
+
+```tsx
+import { JamlMapPreview } from "jaml-ui";
+
+<JamlMapPreview jaml={jaml} />
+```
+
+## Asset handling
+
+By default sprites resolve from the package `assets/` directory via `import.meta.url`.
+
+Override at app startup:
+
+```ts
+import { setJamlAssetBaseUrl, clearJamlAssetBaseUrl } from "jaml-ui";
+
+setJamlAssetBaseUrl("/vendor/jaml-ui/");  // custom CDN
+clearJamlAssetBaseUrl();                   // back to default
+```
+
+## Core utilities
+
+```ts
+import { SPRITE_SHEETS, getSpriteData, resolveJamlAssetUrl } from "jaml-ui/core";
+```
+
+## Motely decode helpers
+
+```ts
+import { decodeMotelyItemName, motelyItemTypeName } from "jaml-ui/motely";
+```
+
+## 3D card (optional)
+
+```bash
+npm install three @react-three/fiber @react-three/drei @react-spring/three
+```
+
+```tsx
+import { Card3D } from "jaml-ui/r3f";
+
+<Card3D itemName="Blueprint" />
+```
+
+## Next.js
+
+Import pure helpers from `jaml-ui/core` for server components. For local workspace installs add:
+
+```ts
+// next.config.ts
+const nextConfig = { transpilePackages: ["jaml-ui"] };
+```
+
+## Peer dependencies
+
+| Peer | Required for |
+|------|-------------|
+| `react`, `react-dom` | All components |
+| `motely-wasm ^10 \|\| ^11 \|\| ^12` | `jaml-ui/motely`, `AnalyzerExplorer` data |
+| `three`, `@react-three/fiber`, `@react-three/drei`, `@react-spring/three` | `jaml-ui/r3f` only |

package/dist/assets.js

@@ -11,17 +11,20 @@ export const JAML_ASSET_FILES = {
     tags: "tags.png",
 };
 const assetKeyByFileName = Object.fromEntries(Object.entries(JAML_ASSET_FILES).map(([key, fileName]) => [fileName, key]));
+// Keep in lockstep with package.json version. Upload assets to this path when publishing.
+const JAML_UI_VERSION = "0.7.0";
+const CDN_BASE = `https://cdn.seedfinder.app/jaml-ui/${JAML_UI_VERSION}/assets/`;
 const defaultAssetUrls = {
-    deck: new URL("../assets/8BitDeck.png", import.meta.url).href,
-    blinds: new URL("../assets/BlindChips.png", import.meta.url).href,
-    boosters: new URL("../assets/Boosters.png", import.meta.url).href,
-    editions: new URL("../assets/Editions.png", import.meta.url).href,
-    enhancers: new URL("../assets/Enhancers.png", import.meta.url).href,
-    jokers: new URL("../assets/Jokers.png", import.meta.url).href,
-    tarots: new URL("../assets/Tarots.png", import.meta.url).href,
-    vouchers: new URL("../assets/Vouchers.png", import.meta.url).href,
-    stickers: new URL("../assets/stickers.png", import.meta.url).href,
-    tags: new URL("../assets/tags.png", import.meta.url).href,
+    deck: `${CDN_BASE}${JAML_ASSET_FILES.deck}`,
+    blinds: `${CDN_BASE}${JAML_ASSET_FILES.blinds}`,
+    boosters: `${CDN_BASE}${JAML_ASSET_FILES.boosters}`,
+    editions: `${CDN_BASE}${JAML_ASSET_FILES.editions}`,
+    enhancers: `${CDN_BASE}${JAML_ASSET_FILES.enhancers}`,
+    jokers: `${CDN_BASE}${JAML_ASSET_FILES.jokers}`,
+    tarots: `${CDN_BASE}${JAML_ASSET_FILES.tarots}`,
+    vouchers: `${CDN_BASE}${JAML_ASSET_FILES.vouchers}`,
+    stickers: `${CDN_BASE}${JAML_ASSET_FILES.stickers}`,
+    tags: `${CDN_BASE}${JAML_ASSET_FILES.tags}`,
 };
 let customAssetBaseUrl = null;
 function normalizeBaseUrl(baseUrl) {

package/dist/components/JamlIdeToolbar.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { JimboButton } from "../ui/panel.js";
 import { JimboColorOption } from "../ui/tokens.js";
 const TABS = [
     { id: "visual", label: "Visual" },
@@ -16,40 +17,5 @@ export function JamlIdeToolbar({ mode, onModeChange, resultCount = 0, className
             padding: "6px 10px",
             borderBottom: `1px solid ${JimboColorOption.PANEL_EDGE}`,
             background: JimboColorOption.DARKEST,
-        }, children: [_jsx("div", { style: { display: "flex", alignItems: "center", gap: 4 }, children: TABS.map((tab) => {
-                    const selected = mode === tab.id;
-                    return (_jsxs("button", { type: "button", onClick: () => onModeChange(tab.id), style: {
-                            cursor: "pointer",
-                            borderRadius: 6,
-                            border: selected ? `1px solid ${JimboColorOption.GOLD}` : "1px solid transparent",
-                            background: selected ? `${JimboColorOption.GOLD}22` : "transparent",
-                            color: selected ? JimboColorOption.GOLD_TEXT : JimboColorOption.GREY,
-                            padding: "5px 10px",
-                            fontSize: 11,
-                            fontWeight: 700,
-                            fontFamily: "m6x11plus, monospace",
-                            transition: "background 120ms, color 120ms",
-                        }, children: [tab.label, tab.id === "results" && resultCount > 0 ? (_jsx("span", { style: {
-                                    marginLeft: 6,
-                                    borderRadius: 999,
-                                    background: `${JimboColorOption.GOLD}33`,
-                                    color: JimboColorOption.GOLD_TEXT,
-                                    padding: "1px 6px",
-                                    fontSize: 10,
-                                }, children: resultCount })) : null] }, tab.id));
-                }) }), onSearch ? (_jsx("button", { type: "button", onClick: onSearch, style: {
-                    cursor: "pointer",
-                    borderRadius: 6,
-                    border: isSearching
-                        ? `1px solid ${JimboColorOption.DARK_RED}`
-                        : `1px solid ${JimboColorOption.GREEN}`,
-                    background: isSearching
-                        ? `${JimboColorOption.RED}22`
-                        : `${JimboColorOption.GREEN}22`,
-                    color: isSearching ? JimboColorOption.RED : JimboColorOption.GREEN_TEXT,
-                    padding: "5px 14px",
-                    fontSize: 11,
-                    fontWeight: 700,
-                    fontFamily: "m6x11plus, monospace",
-                }, children: isSearching ? "Stop" : "Search" })) : null] }));
+        }, children: [_jsx("div", { style: { display: "flex", alignItems: "center", gap: 4 }, children: TABS.map((tab) => (_jsxs(JimboButton, { tone: mode === tab.id ? "gold" : "grey", size: "xs", onClick: () => onModeChange(tab.id), children: [tab.label, tab.id === "results" && resultCount > 0 ? (_jsx("span", { style: { marginLeft: 6, borderRadius: 999, background: "rgba(228,182,67,0.2)", color: JimboColorOption.GOLD_TEXT, padding: "1px 6px", fontSize: 10 }, children: resultCount })) : null] }, tab.id))) }), onSearch ? (_jsx(JimboButton, { tone: isSearching ? "red" : "blue", size: "xs", onClick: onSearch, children: isSearching ? "Stop" : "Search" })) : null] }));
 }

package/dist/components/JamlIdeVisual.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 import { JimboColorOption } from "../ui/tokens.js";
-import { BalSprite } from "../ui/sprites.js";
+import { JimboSprite } from "../ui/sprites.js";
 const ZONE_META = {
     must: { label: "MUST", color: JimboColorOption.BLUE },
     should: { label: "SHOULD", color: JimboColorOption.RED },
@@ -25,7 +25,7 @@ function ClauseSprite({ clause, size = 26 }) {
     const sheet = clauseSpriteSheet(clause.type);
     if (!sheet)
         return null;
-    return _jsx(BalSprite, { name: clause.value, sheet: sheet, width: size });
+    return _jsx(JimboSprite, { name: clause.value, sheet: sheet, width: size });
 }
 function DragClausePill({ clause, zone, onDragStart, }) {
     const z = ZONE_META[zone];

package/dist/hooks/loadMotelyWasm.d.ts

@@ -0,0 +1,7 @@
+interface MotelyModules {
+    MotelyWasm: any;
+    MotelyWasmEvents: any;
+    Motely: any;
+}
+export declare function loadMotelyWasm(url: string): Promise<MotelyModules>;
+export {};

package/dist/hooks/loadMotelyWasm.js

@@ -0,0 +1,16 @@
+// Module-level cache so multiple hooks share a single boot per URL.
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const cache = new Map();
+export function loadMotelyWasm(url) {
+    if (!cache.has(url)) {
+        cache.set(url, (async () => {
+            const mod = await import(/* @vite-ignore */ url);
+            await mod.default.boot();
+            return { MotelyWasm: mod.MotelyWasm, MotelyWasmEvents: mod.MotelyWasmEvents, Motely: mod.Motely };
+        })().catch((err) => {
+            cache.delete(url);
+            throw err;
+        }));
+    }
+    return cache.get(url);
+}

package/dist/hooks/searchWorkerCode.d.ts

@@ -0,0 +1 @@
+export declare const SEARCH_WORKER_CODE = "\nlet MotelyWasm = null;\nlet MotelyWasmEvents = null;\nlet activeSearch = null;\n\nself.addEventListener('message', async function(e) {\n  const msg = e.data;\n\n  if (msg.type === 'init') {\n    try {\n      const mod = await import(msg.url);\n      await mod.default.boot();\n      MotelyWasm = mod.MotelyWasm;\n      MotelyWasmEvents = mod.MotelyWasmEvents;\n      self.postMessage({ type: 'ready' });\n    } catch (err) {\n      self.postMessage({ type: 'error', message: String(err) });\n    }\n    return;\n  }\n\n  if (msg.type === 'start') {\n    if (!MotelyWasm) { self.postMessage({ type: 'error', message: 'Not initialized' }); return; }\n    const validation = MotelyWasm.validateJaml(msg.jaml);\n    if (validation !== 'valid') { self.postMessage({ type: 'error', message: validation }); return; }\n\n    let rId, pId, cId;\n    function cleanup() {\n      MotelyWasmEvents.onResult.unsubscribeById(rId);\n      MotelyWasmEvents.onProgress.unsubscribeById(pId);\n      MotelyWasmEvents.onComplete.unsubscribeById(cId);\n      activeSearch = null;\n    }\n\n    rId = MotelyWasmEvents.onResult.subscribe(function(seed, score) {\n      self.postMessage({ type: 'result', seed, score });\n    });\n    pId = MotelyWasmEvents.onProgress.subscribe(function(searched, matching) {\n      self.postMessage({ type: 'progress', searched: searched.toString(), matching: matching.toString() });\n    });\n    cId = MotelyWasmEvents.onComplete.subscribe(function(status, searched, matched) {\n      cleanup();\n      self.postMessage({ type: 'complete', status, searched: searched.toString(), matched: matched.toString() });\n    });\n\n    try {\n      activeSearch = MotelyWasm.startRandomSearch(msg.jaml, msg.count);\n    } catch (err) {\n      cleanup();\n      self.postMessage({ type: 'error', message: String(err) });\n    }\n    return;\n  }\n\n  if (msg.type === 'stop') {\n    if (activeSearch) { activeSearch.cancel(); activeSearch = null; }\n    self.postMessage({ type: 'cancelled' });\n  }\n});\n";

package/dist/hooks/searchWorkerCode.js

@@ -0,0 +1,62 @@
+// Worker code as an inline string — created as a Blob URL at runtime.
+// This avoids bundler/import.meta.url issues when shipped as an npm package.
+export const SEARCH_WORKER_CODE = `
+let MotelyWasm = null;
+let MotelyWasmEvents = null;
+let activeSearch = null;
+
+self.addEventListener('message', async function(e) {
+  const msg = e.data;
+
+  if (msg.type === 'init') {
+    try {
+      const mod = await import(msg.url);
+      await mod.default.boot();
+      MotelyWasm = mod.MotelyWasm;
+      MotelyWasmEvents = mod.MotelyWasmEvents;
+      self.postMessage({ type: 'ready' });
+    } catch (err) {
+      self.postMessage({ type: 'error', message: String(err) });
+    }
+    return;
+  }
+
+  if (msg.type === 'start') {
+    if (!MotelyWasm) { self.postMessage({ type: 'error', message: 'Not initialized' }); return; }
+    const validation = MotelyWasm.validateJaml(msg.jaml);
+    if (validation !== 'valid') { self.postMessage({ type: 'error', message: validation }); return; }
+
+    let rId, pId, cId;
+    function cleanup() {
+      MotelyWasmEvents.onResult.unsubscribeById(rId);
+      MotelyWasmEvents.onProgress.unsubscribeById(pId);
+      MotelyWasmEvents.onComplete.unsubscribeById(cId);
+      activeSearch = null;
+    }
+
+    rId = MotelyWasmEvents.onResult.subscribe(function(seed, score) {
+      self.postMessage({ type: 'result', seed, score });
+    });
+    pId = MotelyWasmEvents.onProgress.subscribe(function(searched, matching) {
+      self.postMessage({ type: 'progress', searched: searched.toString(), matching: matching.toString() });
+    });
+    cId = MotelyWasmEvents.onComplete.subscribe(function(status, searched, matched) {
+      cleanup();
+      self.postMessage({ type: 'complete', status, searched: searched.toString(), matched: matched.toString() });
+    });
+
+    try {
+      activeSearch = MotelyWasm.startRandomSearch(msg.jaml, msg.count);
+    } catch (err) {
+      cleanup();
+      self.postMessage({ type: 'error', message: String(err) });
+    }
+    return;
+  }
+
+  if (msg.type === 'stop') {
+    if (activeSearch) { activeSearch.cancel(); activeSearch = null; }
+    self.postMessage({ type: 'cancelled' });
+  }
+});
+`;

package/dist/hooks/useAnalyzer.d.ts

@@ -0,0 +1,8 @@
+import type { AnalyzerAnteView } from "../components/AnalyzerExplorer.js";
+export type AnalyzerStatus = "idle" | "running" | "done" | "error";
+export declare function useAnalyzer(motelyWasmUrl: string): {
+    antes: AnalyzerAnteView[];
+    status: AnalyzerStatus;
+    error: string | null;
+    analyze: (seed: string, deck: string, stake: string, jaml?: string) => Promise<void>;
+};

package/dist/hooks/useAnalyzer.js

@@ -0,0 +1,72 @@
+"use client";
+import { useState, useCallback } from "react";
+import { loadMotelyWasm } from "./loadMotelyWasm.js";
+import { extractVisualJamlItems } from "../utils/jamlMapPreview.js";
+import { motelyItemDisplayNameFromValue } from "../motelyDisplay.js";
+export function useAnalyzer(motelyWasmUrl) {
+    const [antes, setAntes] = useState([]);
+    const [status, setStatus] = useState("idle");
+    const [error, setError] = useState(null);
+    const analyze = useCallback(async (seed, deck, stake, jaml) => {
+        setAntes([]);
+        setStatus("running");
+        setError(null);
+        try {
+            const { MotelyWasm, Motely } = await loadMotelyWasm(motelyWasmUrl);
+            const deckEnum = Motely.MotelyDeck[deck] ?? Motely.MotelyDeck.Red;
+            const stakeEnum = Motely.MotelyStake[stake] ?? Motely.MotelyStake.White;
+            const desiredNames = new Set();
+            if (jaml) {
+                const groups = extractVisualJamlItems(jaml);
+                for (const item of [...groups.must, ...groups.should]) {
+                    desiredNames.add(item.value.toLowerCase());
+                }
+            }
+            const ctx = MotelyWasm.createSearchContext(seed, deckEnum, stakeEnum);
+            const bossStream = ctx.createBossStream();
+            let runState = { voucherBitfield: 0, bossBitfield: 0 };
+            const results = [];
+            for (let ante = 1; ante <= 8; ante++) {
+                const bossResult = ctx.getNextBossForAnte(bossStream, ante, runState);
+                const bossName = Motely.MotelyBossBlind[bossResult.boss] ?? `Unknown(${bossResult.boss})`;
+                runState = bossResult.runState;
+                const voucherResult = ctx.getAnteFirstVoucher(ante, runState);
+                const voucherName = Motely.MotelyVoucher[voucherResult.voucher] ?? `Unknown(${voucherResult.voucher})`;
+                runState = voucherResult.runState;
+                const tagStream = ctx.createTagStream(ante);
+                const tag1 = ctx.getNextTag(tagStream);
+                const tag2 = ctx.getNextTag(tagStream);
+                const packStream = ctx.createBoosterPackStream(ante);
+                const packs = [];
+                for (let p = 0; p < 2; p++) {
+                    const packResult = ctx.getNextBoosterPack(packStream);
+                    packs.push(Motely.MotelyBoosterPack[packResult.pack] ?? `Unknown(${packResult.pack})`);
+                }
+                const shopStream = ctx.createShopItemStream(ante, runState, Motely.MotelyShopStreamFlags.Default, Motely.MotelyJokerStreamFlags.Default);
+                const shop = [];
+                for (let i = 0; i < 4; i++) {
+                    const itemResult = ctx.getNextShopItem(shopStream);
+                    const name = motelyItemDisplayNameFromValue(itemResult.item.value);
+                    const desired = desiredNames.size > 0 && desiredNames.has(name.toLowerCase());
+                    shop.push({ id: `${ante}-shop-${i}`, name, value: itemResult.item.value, desired });
+                }
+                results.push({
+                    ante,
+                    boss: bossName,
+                    voucher: voucherName,
+                    smallBlindTag: Motely.MotelyTag[tag1.tag] ?? `Unknown(${tag1.tag})`,
+                    bigBlindTag: Motely.MotelyTag[tag2.tag] ?? `Unknown(${tag2.tag})`,
+                    packs,
+                    shop,
+                });
+            }
+            setAntes(results);
+            setStatus("done");
+        }
+        catch (e) {
+            setError(e instanceof Error ? e.message : String(e));
+            setStatus("error");
+        }
+    }, [motelyWasmUrl]);
+    return { antes, status, error, analyze };
+}

package/dist/hooks/useSearch.d.ts

@@ -0,0 +1,21 @@
+export interface SearchResult {
+    seed: string;
+    score: number;
+}
+export type SearchStatus = "idle" | "booting" | "running" | "completed" | "cancelled" | "error";
+export interface UseSearchState {
+    results: SearchResult[];
+    totalSearched: bigint;
+    matchingSeeds: bigint;
+    status: SearchStatus;
+    error: string | null;
+}
+export declare function useSearch(motelyWasmUrl: string): {
+    start: (jaml: string, count: number) => void;
+    cancel: () => void;
+    results: SearchResult[];
+    totalSearched: bigint;
+    matchingSeeds: bigint;
+    status: SearchStatus;
+    error: string | null;
+};