jaml-ui 0.22.4 → 0.23.0

package/README.md

@@ -1,147 +1,147 @@
-# 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"] };
-```
-
-## Search Worker Architecture
-
-The library provides `useAnalyzer` to interact with `motely-wasm`'s search context natively.
-**Important:** As of `motely-wasm@14.3.3`, the search worker utilizes Vite's `?worker&inline` pattern. You no longer need to pass `motelyWasmUrl`.
-
-Ensure `motely-wasm` is imported and booted at the module level in your application:
-
-```tsx
-import { boot } from "motely-wasm";
-boot(); // Call early in your application lifecycle
-```
-
-## Peer dependencies
-
-| Peer | Required for |
-|------|-------------|
-| `react`, `react-dom` | All components |
-| `motely-wasm ^14.3.3` | `jaml-ui/motely`, `AnalyzerExplorer`, `useAnalyzer` data |
-| `three`, `@react-three/fiber`, `@react-three/drei`, `@react-spring/three` | `jaml-ui/r3f` only |
+# 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"] };
+```
+
+## Search Worker Architecture
+
+The library provides `useAnalyzer` to interact with `motely-wasm`'s search context natively.
+**Important:** As of `motely-wasm@14.3.3`, the search worker utilizes Vite's `?worker&inline` pattern. You no longer need to pass `motelyWasmUrl`.
+
+Ensure `motely-wasm` is imported and booted at the module level in your application:
+
+```tsx
+import { boot } from "motely-wasm";
+boot(); // Call early in your application lifecycle
+```
+
+## Peer dependencies
+
+| Peer | Required for |
+|------|-------------|
+| `react`, `react-dom` | All components |
+| `motely-wasm ^14.3.3` | `jaml-ui/motely`, `AnalyzerExplorer`, `useAnalyzer` data |
+| `three`, `@react-three/fiber`, `@react-three/drei`, `@react-spring/three` | `jaml-ui/r3f` only |

package/dist/hooks/searchWorkerCode.d.ts

@@ -1 +1 @@
-export declare const SEARCH_WORKER_CODE = "\nlet MotelyWasm = null;\nlet MotelyWasmEvents = null;\nlet Filters = 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      Filters = mod.Filters;\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, tallyColumns) {\n      self.postMessage({ type: 'result', seed, score, tallyColumns: Array.from(tallyColumns) });\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      const mode = msg.mode || 'random';\n\n      if (mode === 'random') {\n        activeSearch = MotelyWasm.startRandomSearch(msg.jaml, msg.count);\n      } else if (mode === 'aesthetic') {\n        activeSearch = MotelyWasm.startAestheticSearch(msg.jaml, msg.aesthetic);\n      } else if (mode === 'seedList') {\n        activeSearch = MotelyWasm.startSeedListSearch(msg.jaml, msg.seeds);\n      } else if (mode === 'keyword') {\n        activeSearch = MotelyWasm.startKeywordSearch(msg.jaml, msg.keywords, msg.padding || '');\n      } else if (mode === 'sequential') {\n        activeSearch = MotelyWasm.startSequentialSearch(msg.jaml, msg.batchCharCount, BigInt(msg.startBatch), BigInt(msg.endBatch));\n      } else {\n        self.postMessage({ type: 'error', message: 'Unknown search mode: ' + mode });\n        cleanup();\n        return;\n      }\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  if (msg.type === 'get_tally_labels') {\n    if (!MotelyWasm) { self.postMessage({ type: 'error', message: 'Not initialized' }); return; }\n    try {\n      const labels = MotelyWasm.getTallyLabels(msg.jaml);\n      self.postMessage({ type: 'tally_labels', labels });\n    } catch (err) {\n      self.postMessage({ type: 'error', message: String(err) });\n    }\n  }\n});\n";
+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      const motely = mod.Motely;\n      MotelyWasm = motely.MotelyWasm;\n      MotelyWasmEvents = motely.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    function cleanup() {\n      MotelyWasmEvents.notifyResult = () => {};\n      MotelyWasmEvents.notifyProgress = () => {};\n      MotelyWasmEvents.notifyComplete = () => {};\n      activeSearch = null;\n    }\n\n    MotelyWasmEvents.notifyResult = function(seed, score, tallyColumns) {\n      self.postMessage({ type: 'result', seed, score, tallyColumns: Array.from(tallyColumns) });\n    };\n    MotelyWasmEvents.notifyProgress = function(searched, matching) {\n      self.postMessage({ type: 'progress', searched: searched.toString(), matching: matching.toString() });\n    };\n    MotelyWasmEvents.notifyComplete = function(status, searched, matched) {\n      cleanup();\n      self.postMessage({ type: 'complete', status, searched: searched.toString(), matched: matched.toString() });\n    };\n\n    try {\n      const mode = msg.mode || 'random';\n      if (mode === 'random') {\n        activeSearch = MotelyWasm.startRandomSearch(msg.jaml, msg.count);\n      } else if (mode === 'aesthetic') {\n        activeSearch = MotelyWasm.startAestheticSearch(msg.jaml, msg.aesthetic);\n      } else if (mode === 'seedList') {\n        activeSearch = MotelyWasm.startSeedListSearch(msg.jaml, msg.seeds);\n      } else if (mode === 'keyword') {\n        activeSearch = MotelyWasm.startKeywordSearch(msg.jaml, msg.keywords, msg.padding || '');\n      } else if (mode === 'sequential') {\n        activeSearch = MotelyWasm.startSequentialSearch(msg.jaml, msg.batchCharCount, BigInt(msg.startBatch), BigInt(msg.endBatch));\n      } else {\n        self.postMessage({ type: 'error', message: 'Unknown search mode: ' + mode });\n        cleanup();\n        return;\n      }\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  if (msg.type === 'get_tally_labels') {\n    if (!MotelyWasm) { self.postMessage({ type: 'error', message: 'Not initialized' }); return; }\n    try {\n      const labels = MotelyWasm.getTallyLabels(msg.jaml);\n      self.postMessage({ type: 'tally_labels', labels: Array.from(labels) });\n    } catch (err) {\n      self.postMessage({ type: 'error', message: String(err) });\n    }\n  }\n});\n";

package/dist/hooks/searchWorkerCode.js

@@ -1,88 +1,85 @@
-export const SEARCH_WORKER_CODE = `
-let MotelyWasm = null;
-let MotelyWasmEvents = null;
-let Filters = 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;
-      Filters = mod.Filters;
-      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, tallyColumns) {
-      self.postMessage({ type: 'result', seed, score, tallyColumns: Array.from(tallyColumns) });
-    });
-    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 {
-      const mode = msg.mode || 'random';
-
-      if (mode === 'random') {
-        activeSearch = MotelyWasm.startRandomSearch(msg.jaml, msg.count);
-      } else if (mode === 'aesthetic') {
-        activeSearch = MotelyWasm.startAestheticSearch(msg.jaml, msg.aesthetic);
-      } else if (mode === 'seedList') {
-        activeSearch = MotelyWasm.startSeedListSearch(msg.jaml, msg.seeds);
-      } else if (mode === 'keyword') {
-        activeSearch = MotelyWasm.startKeywordSearch(msg.jaml, msg.keywords, msg.padding || '');
-      } else if (mode === 'sequential') {
-        activeSearch = MotelyWasm.startSequentialSearch(msg.jaml, msg.batchCharCount, BigInt(msg.startBatch), BigInt(msg.endBatch));
-      } else {
-        self.postMessage({ type: 'error', message: 'Unknown search mode: ' + mode });
-        cleanup();
-        return;
-      }
-    } 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' });
-  }
-
-  if (msg.type === 'get_tally_labels') {
-    if (!MotelyWasm) { self.postMessage({ type: 'error', message: 'Not initialized' }); return; }
-    try {
-      const labels = MotelyWasm.getTallyLabels(msg.jaml);
-      self.postMessage({ type: 'tally_labels', labels });
-    } catch (err) {
-      self.postMessage({ type: 'error', message: String(err) });
-    }
-  }
-});
+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();
+      const motely = mod.Motely;
+      MotelyWasm = motely.MotelyWasm;
+      MotelyWasmEvents = motely.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; }
+
+    function cleanup() {
+      MotelyWasmEvents.notifyResult = () => {};
+      MotelyWasmEvents.notifyProgress = () => {};
+      MotelyWasmEvents.notifyComplete = () => {};
+      activeSearch = null;
+    }
+
+    MotelyWasmEvents.notifyResult = function(seed, score, tallyColumns) {
+      self.postMessage({ type: 'result', seed, score, tallyColumns: Array.from(tallyColumns) });
+    };
+    MotelyWasmEvents.notifyProgress = function(searched, matching) {
+      self.postMessage({ type: 'progress', searched: searched.toString(), matching: matching.toString() });
+    };
+    MotelyWasmEvents.notifyComplete = function(status, searched, matched) {
+      cleanup();
+      self.postMessage({ type: 'complete', status, searched: searched.toString(), matched: matched.toString() });
+    };
+
+    try {
+      const mode = msg.mode || 'random';
+      if (mode === 'random') {
+        activeSearch = MotelyWasm.startRandomSearch(msg.jaml, msg.count);
+      } else if (mode === 'aesthetic') {
+        activeSearch = MotelyWasm.startAestheticSearch(msg.jaml, msg.aesthetic);
+      } else if (mode === 'seedList') {
+        activeSearch = MotelyWasm.startSeedListSearch(msg.jaml, msg.seeds);
+      } else if (mode === 'keyword') {
+        activeSearch = MotelyWasm.startKeywordSearch(msg.jaml, msg.keywords, msg.padding || '');
+      } else if (mode === 'sequential') {
+        activeSearch = MotelyWasm.startSequentialSearch(msg.jaml, msg.batchCharCount, BigInt(msg.startBatch), BigInt(msg.endBatch));
+      } else {
+        self.postMessage({ type: 'error', message: 'Unknown search mode: ' + mode });
+        cleanup();
+        return;
+      }
+    } 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' });
+  }
+
+  if (msg.type === 'get_tally_labels') {
+    if (!MotelyWasm) { self.postMessage({ type: 'error', message: 'Not initialized' }); return; }
+    try {
+      const labels = MotelyWasm.getTallyLabels(msg.jaml);
+      self.postMessage({ type: 'tally_labels', labels: Array.from(labels) });
+    } catch (err) {
+      self.postMessage({ type: 'error', message: String(err) });
+    }
+  }
+});
 `;