jaml-ui 0.21.5 → 0.22.0

package/dist/components/JamlCurator.d.ts

@@ -1,3 +1,5 @@
+import { type MotelyRuntime } from "../hooks/useAnalyzer.js";
 export interface JamlCuratorProps {
+    motelyRuntime: MotelyRuntime;
 }
-export declare function JamlCurator({}: JamlCuratorProps): import("react/jsx-runtime").JSX.Element;
+export declare function JamlCurator({ motelyRuntime }: JamlCuratorProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/JamlCurator.js

@@ -11,11 +11,11 @@ import { useSearch } from "../hooks/useSearch.js";
 import { useAnalyzer } from "../hooks/useAnalyzer.js";
 import { JamlSpeedometer } from "./JamlSpeedometer.js";
 const C = JimboColorOption;
-export function JamlCurator({}) {
+export function JamlCurator({ motelyRuntime }) {
     // Use map editor by default to generate JAML
     const [jamlText, setJamlText] = useState("");
     const search = useSearch();
-    const analyzer = useAnalyzer();
+    const analyzer = useAnalyzer(motelyRuntime);
     // Search results pagination
     const [resultIndex, setResultIndex] = useState(0);
     const isSearching = search.status === "running";

package/dist/decode/motelyItemDecoder.d.ts

@@ -1,7 +1,13 @@
 /**
  * Motely item decoder — thin wrapper over motely-wasm runtime enums.
  * No hand-rolled bitmask tables. The WASM enum IS the source of truth.
+ *
+ * Consumers must call `setMotelyEnums(Motely)` once after `await bootsharp.boot()`
+ * for runtime enum lookups to resolve. Before that, decoders return placeholder
+ * strings rather than throwing.
  */
+import type { Motely as MotelyEnumsType } from "motely-wasm";
+export declare function setMotelyEnums(motely: typeof MotelyEnumsType): void;
 export type CardCategory = "joker" | "consumable" | "playing" | "spectral" | "tarot" | "planet";
 export type MotelyRenderableCategory = CardCategory | "unknown";
 export type MotelyItemInput = number | MotelyRuntimeItem | null | undefined;

package/dist/decode/motelyItemDecoder.js

@@ -1,8 +1,31 @@
 /**
  * Motely item decoder — thin wrapper over motely-wasm runtime enums.
  * No hand-rolled bitmask tables. The WASM enum IS the source of truth.
+ *
+ * Consumers must call `setMotelyEnums(Motely)` once after `await bootsharp.boot()`
+ * for runtime enum lookups to resolve. Before that, decoders return placeholder
+ * strings rather than throwing.
  */
-import { Motely } from "motely-wasm";
+let _motely = null;
+let _categoryMap = null;
+export function setMotelyEnums(motely) {
+    _motely = motely;
+    _categoryMap = null;
+}
+function getCategoryMap() {
+    if (_categoryMap)
+        return _categoryMap;
+    if (!_motely)
+        return {};
+    _categoryMap = {
+        [_motely.MotelyItemTypeCategory.Standardcard]: "playing",
+        [_motely.MotelyItemTypeCategory.SpectralCard]: "spectral",
+        [_motely.MotelyItemTypeCategory.TarotCard]: "tarot",
+        [_motely.MotelyItemTypeCategory.PlanetCard]: "planet",
+        [_motely.MotelyItemTypeCategory.Joker]: "joker",
+    };
+    return _categoryMap;
+}
 // ─── Helpers using motely-wasm runtime enums directly ────────────────────────
 function enumKey(e, value) {
     const k = e[String(value)];
@@ -11,13 +34,6 @@ function enumKey(e, value) {
 function spaceSplit(value) {
     return value.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2");
 }
-const CATEGORY_MAP = {
-    [Motely.MotelyItemTypeCategory.Standardcard]: "playing",
-    [Motely.MotelyItemTypeCategory.SpectralCard]: "spectral",
-    [Motely.MotelyItemTypeCategory.TarotCard]: "tarot",
-    [Motely.MotelyItemTypeCategory.PlanetCard]: "planet",
-    [Motely.MotelyItemTypeCategory.Joker]: "joker",
-};
 // ─── Core decoder ────────────────────────────────────────────────────────────
 function resolvePackedValue(input) {
     if (input == null)
@@ -34,11 +50,13 @@ export function motelyItemTypeName(input) {
     const itemType = resolveMotelyItemType(input);
     if (itemType === null)
         return "Unknown";
-    return enumKey(Motely.MotelyItemType, itemType) ?? `item#${itemType}`;
+    if (!_motely)
+        return `item#${itemType}`;
+    return enumKey(_motely.MotelyItemType, itemType) ?? `item#${itemType}`;
 }
 export function motelyItemCategory(itemType) {
     const catValue = (itemType >> 12) & 0xf;
-    return CATEGORY_MAP[catValue] ?? "unknown";
+    return getCategoryMap()[catValue] ?? "unknown";
 }
 export function motelyItemRenderCategory(input) {
     const itemType = resolveMotelyItemType(input);
@@ -50,53 +68,53 @@ export function motelyItemDisplayName(input) {
     return spaceSplit(motelyItemTypeName(input));
 }
 export function motelyItemEditionName(input) {
-    if (input == null)
+    if (input == null || !_motely)
         return null;
     const val = typeof input === "number" ? input : input.edition;
     if (val == null)
         return null;
-    const key = enumKey(Motely.MotelyItemEdition, typeof val === "number" ? val : 0);
+    const key = enumKey(_motely.MotelyItemEdition, typeof val === "number" ? val : 0);
     if (!key || key === "None")
         return null;
     return key;
 }
 export function motelyItemSealName(input) {
-    if (input == null)
+    if (input == null || !_motely)
         return null;
     const val = typeof input === "number" ? null : input.seal;
     if (val == null)
         return null;
-    const key = enumKey(Motely.MotelyItemSeal, val);
+    const key = enumKey(_motely.MotelyItemSeal, val);
     if (!key || key === "None")
         return null;
     return key;
 }
 export function motelyItemEnhancementName(input) {
-    if (input == null)
+    if (input == null || !_motely)
         return null;
     const val = typeof input === "number" ? null : input.enhancement;
     if (val == null)
         return null;
-    const key = enumKey(Motely.MotelyItemEnhancement, val);
+    const key = enumKey(_motely.MotelyItemEnhancement, val);
     if (!key || key === "None")
         return null;
     return key;
 }
 export function motelyStandardcardRankName(input) {
-    if (input == null)
+    if (input == null || !_motely)
         return null;
     const val = typeof input === "number" ? null : input.rank;
     if (val == null)
         return null;
-    return enumKey(Motely.MotelyStandardcardRank, val);
+    return enumKey(_motely.MotelyStandardcardRank, val);
 }
 export function motelyStandardcardSuitName(input) {
-    if (input == null)
+    if (input == null || !_motely)
         return null;
     const val = typeof input === "number" ? null : input.suit;
     if (val == null)
         return null;
-    return enumKey(Motely.MotelyStandardcardSuit, val);
+    return enumKey(_motely.MotelyStandardcardSuit, val);
 }
 export function decodeMotelyItemName(input) {
     return motelyItemTypeName(input);
@@ -105,7 +123,9 @@ export function decodeMotelyItem(input) {
     const itemType = resolveMotelyItemType(input);
     if (itemType === null)
         return null;
-    const enumKeyStr = enumKey(Motely.MotelyItemType, itemType) ?? `Unknown_${itemType}`;
+    const enumKeyStr = _motely
+        ? enumKey(_motely.MotelyItemType, itemType) ?? `Unknown_${itemType}`
+        : `Unknown_${itemType}`;
     const category = motelyItemCategory(itemType);
     const displayName = spaceSplit(enumKeyStr);
     return {
@@ -140,6 +160,5 @@ export function decodeMotelyItemToJamlCard(input, scale) {
         },
     };
 }
-// Cache warming is now a no-op since we use runtime enums directly
 export function warmMotelyItemCache() { }
 export function motelyItemCacheSize() { return 0; }

package/dist/hooks/useAnalyzer.d.ts

@@ -1,4 +1,4 @@
-import { MotelyWasm, Motely } from "motely-wasm";
+import type { MotelyWasm as MotelyWasmType, Motely as MotelyEnumsType } from "motely-wasm";
 import type { AnalyzerAnteView } from "../components/AnalyzerExplorer.js";
 export type AnalyzerStatus = "idle" | "running" | "done" | "error";
 export type MotelyJsRunState = {
@@ -6,23 +6,25 @@ export type MotelyJsRunState = {
     bossBitfield: number;
 };
 /**
- * Snapshot of the live search context after `analyze()` resolves, exposed so
- * higher-level components can open additional streams (shop chunks, soul-
- * joker chunks, pack contents) on demand without re-walking the seed. The
- * `runStates` map is keyed by ante and holds the runState AFTER the boss +
- * voucher have been resolved for that ante — i.e. the correct input for
- * `createShopItemStream(ante, runState, ...)`.
+ * Runtime handle for motely-wasm. Consumers boot motely-wasm once and pass
+ * `{ MotelyWasm, Motely }` to hooks that need it. This keeps jaml-ui free of
+ * static motely-wasm imports so consumer bundlers don't pull the 12MB engine
+ * into their main bundle.
  */
+export interface MotelyRuntime {
+    MotelyWasm: typeof MotelyWasmType;
+    Motely: typeof MotelyEnumsType;
+}
 export interface AnalyzerLive {
-    ctx: ReturnType<typeof MotelyWasm.createSearchContext>;
-    Motely: typeof Motely;
+    ctx: ReturnType<typeof MotelyWasmType.createSearchContext>;
+    Motely: typeof MotelyEnumsType;
     runStates: Record<number, MotelyJsRunState>;
     desiredNames: ReadonlySet<string>;
     seed: string;
     deck: string;
     stake: string;
 }
-export declare function useAnalyzer(): {
+export declare function useAnalyzer(runtime: MotelyRuntime): {
     antes: AnalyzerAnteView[];
     status: AnalyzerStatus;
     error: string | null;

package/dist/hooks/useAnalyzer.js

@@ -1,11 +1,9 @@
 "use client";
 import { useState, useCallback } from "react";
-import motely, { MotelyWasm, Motely } from "motely-wasm";
-// Boot motely immediately when this module is loaded
-motely.boot().catch(console.error);
 import { extractVisualJamlItems } from "../utils/jamlMapPreview.js";
 import { motelyItemDisplayNameFromValue } from "../motelyDisplay.js";
-export function useAnalyzer() {
+export function useAnalyzer(runtime) {
+    const { MotelyWasm, Motely } = runtime;
     const [antes, setAntes] = useState([]);
     const [status, setStatus] = useState("idle");
     const [error, setError] = useState(null);
@@ -79,7 +77,7 @@ export function useAnalyzer() {
             setError(e instanceof Error ? e.message : String(e));
             setStatus("error");
         }
-    }, []);
+    }, [MotelyWasm, Motely]);
     const clearError = useCallback(() => {
         setError(null);
         setStatus((s) => (s === "error" ? "idle" : s));

package/dist/index.d.ts

@@ -21,7 +21,9 @@ export { Showcase, type ShowcaseFilter, type ShowcaseLiveStats, type ShowcasePro
 export { extractVisualJamlItems, type JamlPreviewGroups, type JamlPreviewItem, type JamlPreviewSection, type JamlPreviewVisualType, } from "./utils/jamlMapPreview.js";
 export { useMotelyStream, type StreamItem, type StreamState } from "./hooks/useShopStream.js";
 export { useSearch, type SearchResult, type SearchStatus, type UseSearchState, } from "./hooks/useSearch.js";
-export { useAnalyzer, type AnalyzerStatus, type AnalyzerLive, type MotelyJsRunState, } from "./hooks/useAnalyzer.js";
+export { useAnalyzer, type AnalyzerStatus, type AnalyzerLive, type MotelyJsRunState, type MotelyRuntime, } from "./hooks/useAnalyzer.js";
+export { setMotelyEnums as setMotelyDisplayEnums } from "./motelyDisplay.js";
+export { setMotelyEnums as setMotelyDecoderEnums } from "./decode/motelyItemDecoder.js";
 export { JamlAestheticSelector, type JamlAestheticSelectorProps, type JamlAestheticOption, } from "./components/JamlAestheticSelector.js";
 export { JamlSeedInput, type JamlSeedInputProps, } from "./components/JamlSeedInput.js";
 export { JamlMapEditor, JokerPicker, MysterySlot, CategoryPicker, type JamlMapEditorProps, type JokerPickerProps, type JokerRarity, type MysterySlotProps, type SlotCategory, type SlotSelection, type CategoryPickerConfig, type CategoryPickerProps, VOUCHER_PICKER_CONFIG, TAG_PICKER_CONFIG, BOSS_PICKER_CONFIG, TAROT_PICKER_CONFIG, PLANET_PICKER_CONFIG, SPECTRAL_PICKER_CONFIG, PACK_PICKER_CONFIG, } from "./components/jamlMap/index.js";

package/dist/index.js

@@ -23,6 +23,11 @@ export { extractVisualJamlItems, } from "./utils/jamlMapPreview.js";
 export { useMotelyStream } from "./hooks/useShopStream.js";
 export { useSearch, } from "./hooks/useSearch.js";
 export { useAnalyzer, } from "./hooks/useAnalyzer.js";
+// Setter pattern for motely-wasm runtime enums. Consumers boot motely-wasm
+// and call setMotelyEnums(Motely) once after boot so display/decoder helpers
+// can resolve enum keys without statically importing motely-wasm.
+export { setMotelyEnums as setMotelyDisplayEnums } from "./motelyDisplay.js";
+export { setMotelyEnums as setMotelyDecoderEnums } from "./decode/motelyItemDecoder.js";
 export { JamlAestheticSelector, } from "./components/JamlAestheticSelector.js";
 export { JamlSeedInput, } from "./components/JamlSeedInput.js";
 export { JamlMapEditor, JokerPicker, MysterySlot, CategoryPicker, VOUCHER_PICKER_CONFIG, TAG_PICKER_CONFIG, BOSS_PICKER_CONFIG, TAROT_PICKER_CONFIG, PLANET_PICKER_CONFIG, SPECTRAL_PICKER_CONFIG, PACK_PICKER_CONFIG, } from "./components/jamlMap/index.js";

package/dist/lib/hooks/useSeedAnalyzer.d.ts

@@ -1,5 +1,9 @@
-import { Analysis } from 'motely-wasm';
-export declare function useSeedAnalyzer(seed: string | null): {
+import type { MotelyWasm as MotelyWasmType, Motely as MotelyEnumsType, Analysis } from "motely-wasm";
+export interface MotelyRuntime {
+    MotelyWasm: typeof MotelyWasmType;
+    Motely: typeof MotelyEnumsType;
+}
+export declare function useSeedAnalyzer(runtime: MotelyRuntime, seed: string | null): {
     data: Analysis.MotelyLegacyTextAnalyzer | null | undefined;
     loading: boolean;
     error: string | null;

package/dist/lib/hooks/useSeedAnalyzer.js

@@ -1,7 +1,6 @@
 "use client";
-import { useState, useEffect } from 'react';
-import motely, { MotelyWasm } from 'motely-wasm';
-export function useSeedAnalyzer(seed) {
+import { useState, useEffect } from "react";
+export function useSeedAnalyzer(runtime, seed) {
     const [data, setData] = useState(null);
     const [loading, setLoading] = useState(false);
     const [error, setError] = useState(null);
@@ -15,11 +14,8 @@ export function useSeedAnalyzer(seed) {
             setLoading(true);
             setError(null);
             try {
-                await motely.boot();
-                if (abortController.signal.aborted)
-                    return;
                 const jaml = `version: 1\nconfig:\n  deck: Erratic\n  stake: White\n`;
-                const rawResult = MotelyWasm.analyzeJamlSeeds(jaml, [seed]);
+                const rawResult = runtime.MotelyWasm.analyzeJamlSeeds(jaml, [seed]);
                 if (abortController.signal.aborted)
                     return;
                 if (rawResult && rawResult.seeds.length > 0) {
@@ -43,6 +39,6 @@ export function useSeedAnalyzer(seed) {
         };
         runAnalysis();
         return () => abortController.abort();
-    }, [seed]);
+    }, [runtime, seed]);
     return { data, loading, error };
 }

package/dist/motelyDisplay.d.ts

@@ -1,3 +1,5 @@
+import type { Motely as MotelyEnumsType } from "motely-wasm";
+export declare function setMotelyEnums(motely: typeof MotelyEnumsType): void;
 export declare function motelyBossDisplayName(value: number): string;
 export declare function motelyBossDisplayNameFromKey(key: string): string;
 export declare function motelyVoucherDisplayName(value: number): string;

package/dist/motelyDisplay.js

@@ -1,34 +1,48 @@
-import { Motely } from "motely-wasm";
+// Setter pattern: consumers boot motely-wasm and call `setMotelyEnums(Motely)`
+// once after boot. Display functions degrade gracefully (return placeholder
+// strings) before the setter is called rather than throwing.
+let _motely = null;
+export function setMotelyEnums(motely) {
+    _motely = motely;
+}
 function runtimeEnumKey(enumObject, value) {
     if (!enumObject || typeof enumObject !== "object")
         return null;
     const key = enumObject[String(value)];
     return typeof key === "string" && key.length > 0 ? key : null;
 }
-// ─── Public API (same signatures as before, zero hand-rolled tables) ────────
+// ─── Public API ──────────────────────────────────────────────────────────────
 export function motelyBossDisplayName(value) {
-    const key = runtimeEnumKey(Motely.MotelyBossBlind, value & 0xff);
+    if (!_motely)
+        return `boss#${value}`;
+    const key = runtimeEnumKey(_motely.MotelyBossBlind, value & 0xff);
     return key === null ? `boss#${value}` : key;
 }
 export function motelyBossDisplayNameFromKey(key) {
     return key;
 }
 export function motelyVoucherDisplayName(value) {
-    const key = runtimeEnumKey(Motely.MotelyVoucher, value);
+    if (!_motely)
+        return `voucher#${value}`;
+    const key = runtimeEnumKey(_motely.MotelyVoucher, value);
     return key === null ? `voucher#${value}` : key;
 }
 export function motelyVoucherDisplayNameFromKey(key) {
     return key;
 }
 export function motelyTagDisplayName(value) {
-    const key = runtimeEnumKey(Motely.MotelyTag, value);
+    if (!_motely)
+        return `tag#${value}`;
+    const key = runtimeEnumKey(_motely.MotelyTag, value);
     return key === null ? `tag#${value}` : key;
 }
 export function motelyTagDisplayNameFromKey(key) {
     return key;
 }
 export function motelyBoosterPackDisplayName(value) {
-    const key = runtimeEnumKey(Motely.MotelyBoosterPack, value);
+    if (!_motely)
+        return `pack#${value}`;
+    const key = runtimeEnumKey(_motely.MotelyBoosterPack, value);
     return key === null ? `pack#${value}` : key;
 }
 export function motelyBoosterPackDisplayNameFromKey(key) {
@@ -38,6 +52,8 @@ export function motelyItemDisplayNameFromKey(key) {
     return key;
 }
 export function motelyItemDisplayNameFromValue(value) {
-    const key = runtimeEnumKey(Motely.MotelyItemType, value & 0xffff);
+    if (!_motely)
+        return `item#${value}`;
+    const key = runtimeEnumKey(_motely.MotelyItemType, value & 0xffff);
     return key === null ? `item#${value}` : key;
 }

package/dist/ui.d.ts

@@ -21,10 +21,7 @@ export * from './ui/jimboStatGrid.js';
 export * from './ui/jimboSectionHeader.js';
 export * from './ui/jimboInfoCard.js';
 export * from './ui/jimboInset.js';
-export * from './ui/ide/JamlBuilder.js';
 export * from './ui/ide/JamlEditor.js';
-export * from './ui/ide/WasmStatus.js';
-export * from './ui/ide/AgnosticSeedCard.js';
 export * from './ui/JimboIconButton.js';
 export * from './ui/JimboInputModal.js';
 export * from './ui/JimboSelect.js';

package/dist/ui.js

@@ -23,10 +23,13 @@ export * from './ui/jimboStatGrid.js';
 export * from './ui/jimboSectionHeader.js';
 export * from './ui/jimboInfoCard.js';
 export * from './ui/jimboInset.js';
-export * from './ui/ide/JamlBuilder.js';
+// Old IDE prototypes — orphaned, statically import motely-wasm + use Vite-only
+// `?worker` syntax. Removed from the public surface so webpack consumers don't
+// transitively bundle motely-wasm. Files left on disk for triage.
+// export * from './ui/ide/JamlBuilder.js'
 export * from './ui/ide/JamlEditor.js';
-export * from './ui/ide/WasmStatus.js';
-export * from './ui/ide/AgnosticSeedCard.js';
+// export * from './ui/ide/WasmStatus.js'
+// export * from './ui/ide/AgnosticSeedCard.js'
 export * from './ui/JimboIconButton.js';
 export * from './ui/JimboInputModal.js';
 export * from './ui/JimboSelect.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaml-ui",
-  "version": "0.21.5",
+  "version": "0.22.0",
   "description": "Balatro rendering components, sprite metadata, and optional Motely helpers for React apps.",
   "type": "module",
   "main": "./dist/index.js",