jaml-ui 0.16.0 → 0.17.1

package/dist/components/jamlMap/JokerPicker.js

@@ -0,0 +1,258 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useCallback, useMemo } from "react";
+import { JimboSprite } from "../../ui/sprites.js";
+import { JimboColorOption, withAlpha } from "../../ui/tokens.js";
+import { JOKERS } from "../../sprites/spriteData.js";
+const LEGENDARY_JOKERS = new Set([
+    "Canio", "Triboulet", "Yorick", "Chicot", "Perkeo",
+]);
+const RARE_JOKERS = new Set([
+    "Blueprint", "Brainstorm", "Drivers License", "Burnt Joker",
+    "Cartomancer", "Astronomer", "Satellite", "Shoot the Moon",
+    "The Idol", "Seeing Double", "Matador", "Hit the Road",
+    "The Duo", "The Trio", "The Family", "The Order", "The Tribe",
+    "Stuntman", "Invisible Joker", "Showman", "Flower Pot",
+    "Glass Joker", "Wee Joker", "Merry Andy", "Oops! All 6s",
+    "Certificate", "Smeared Joker", "Throwback", "Hanging Chad",
+    "Rough Gem", "Bloodstone", "Arrowhead", "Onyx Agate",
+]);
+const UNCOMMON_JOKERS = new Set([
+    "Greedy Joker", "Lusty Joker", "Wrathful Joker", "Gluttonous Joker",
+    "Jolly Joker", "Zany Joker", "Mad Joker", "Crazy Joker", "Droll Joker",
+    "Sly Joker", "Wily Joker", "Clever Joker", "Devious Joker", "Crafty Joker",
+    "Joker Stencil", "Four Fingers", "Mime", "Credit Card",
+    "Ceremonial Dagger", "Banner", "Mystic Summit", "Marble Joker",
+    "Loyalty Card", "8 Ball", "Misprint", "Dusk", "Raised Fist",
+    "Fibonacci", "Steel Joker", "Scary Face", "Abstract Joker",
+    "Delayed Gratification", "Hack", "Pareidolia", "Gros Michel",
+    "Even Steven", "Odd Todd", "Scholar", "Business Card", "Supernova",
+    "Ride the Bus", "Space Joker", "Egg", "Burglar", "Blackboard",
+    "Runner", "Ice Cream", "DNA", "Splash", "Blue Joker",
+    "Sixth Sense", "Constellation", "Hiker", "Faceless Joker",
+    "Green Joker", "Superposition", "To Do List", "Cavendish",
+    "Card Sharp", "Red Card", "Madness", "Square Joker",
+    "Seance", "Riff-raff", "Vampire", "Shortcut",
+    "Hologram", "Vagabond", "Baron", "Cloud 9", "Rocket", "Obelisk",
+    "Midas Mask", "Luchador", "Photograph", "Gift Card", "Turtle Bean",
+    "Erosion", "Reserved Parking", "Mail In Rebate", "To the Moon", "Hallucination",
+    "Fortune Teller", "Golden Joker", "Lucky Cat", "Baseball Card", "Bull",
+    "Diet Cola", "Trading Card", "Flash Card", "Popcorn",
+    "Spare Trousers", "Ancient Joker", "Ramen", "Walkie Talkie",
+    "Seltzer", "Castle", "Smiley Face", "Campfire",
+    "Golden Ticket", "Mr. Bones", "Acrobat", "Sock and Buskin",
+    "Swashbuckler", "Troubadour", "Bootstraps",
+]);
+function getJokerRarity(name) {
+    if (LEGENDARY_JOKERS.has(name))
+        return "legendary";
+    if (RARE_JOKERS.has(name))
+        return "rare";
+    if (UNCOMMON_JOKERS.has(name))
+        return "uncommon";
+    return "common";
+}
+// ─── Rarity colors ───────────────────────────────────────────────────────────
+const C = JimboColorOption;
+const RARITY_META = {
+    common: { label: "Common", color: C.BLUE, bg: withAlpha(C.BLUE, 0.12), hint: "Found in shops and Buffoon Packs" },
+    uncommon: { label: "Uncommon", color: C.GREEN, bg: withAlpha(C.GREEN, 0.12), hint: "Found in shops and Buffoon Packs" },
+    rare: { label: "Rare", color: C.RED, bg: withAlpha(C.RED, 0.12), hint: "Found in shops and Buffoon Packs" },
+    legendary: { label: "Legendary", color: C.PURPLE, bg: withAlpha(C.PURPLE, 0.12), hint: "Spawns from The Soul only! Find in Arcana Pack, Spectral Pack, Charm Tag, or Ethereal Tag." },
+};
+export function JokerPicker({ onSelect, onCancel }) {
+    const [step, setStep] = useState("rarity");
+    const [selectedRarity, setSelectedRarity] = useState(null);
+    const [search, setSearch] = useState("");
+    const filteredJokers = useMemo(() => {
+        if (!selectedRarity)
+            return [];
+        return JOKERS.filter((j) => {
+            if (getJokerRarity(j.name) !== selectedRarity)
+                return false;
+            if (search && !j.name.toLowerCase().includes(search.toLowerCase()))
+                return false;
+            return true;
+        });
+    }, [selectedRarity, search]);
+    const handleRaritySelect = useCallback((rarity) => {
+        setSelectedRarity(rarity);
+        setStep("specific");
+        setSearch("");
+    }, []);
+    const handleJokerSelect = useCallback((joker) => {
+        onSelect({
+            category: "joker",
+            value: joker.name,
+            clauseKey: selectedRarity === "legendary" ? "legendaryJoker"
+                : selectedRarity === "rare" ? "rareJoker"
+                    : selectedRarity === "uncommon" ? "uncommonJoker"
+                        : "commonJoker",
+            rarity: selectedRarity ?? "common",
+        });
+    }, [onSelect, selectedRarity]);
+    const handleAnySelect = useCallback(() => {
+        const rarity = selectedRarity ?? "common";
+        onSelect({
+            category: "joker",
+            value: "Any",
+            clauseKey: rarity === "legendary" ? "legendaryJoker"
+                : rarity === "rare" ? "rareJoker"
+                    : rarity === "uncommon" ? "uncommonJoker"
+                        : "commonJoker",
+            rarity,
+        });
+    }, [onSelect, selectedRarity]);
+    return (_jsxs("div", { style: styles.container, children: [_jsxs("div", { style: styles.header, children: [_jsx("button", { onClick: step === "rarity" ? onCancel : () => setStep("rarity"), style: styles.backBtn, children: step === "rarity" ? "✕" : "← Back" }), _jsx("span", { style: styles.title, children: step === "rarity" ? "Select Joker Rarity" : `${RARITY_META[selectedRarity].label} Jokers` }), _jsx("div", { style: { width: 44 } })] }), step === "rarity" && (_jsx("div", { style: styles.rarityGrid, children: ["common", "uncommon", "rare", "legendary"].map((rarity) => {
+                    const meta = RARITY_META[rarity];
+                    return (_jsxs("button", { onClick: () => handleRaritySelect(rarity), style: {
+                            ...styles.rarityBtn,
+                            borderColor: meta.color,
+                            background: meta.bg,
+                        }, children: [_jsx("span", { style: { ...styles.rarityLabel, color: meta.color }, children: meta.label }), _jsx("span", { style: styles.rarityHint, children: meta.hint })] }, rarity));
+                }) })), step === "specific" && selectedRarity && (_jsxs(_Fragment, { children: [_jsxs("div", { style: styles.searchRow, children: [_jsx("input", { type: "text", placeholder: "Search jokers...", value: search, onChange: (e) => setSearch(e.target.value), style: styles.searchInput }), _jsx("button", { onClick: handleAnySelect, style: styles.anyBtn, children: "Any" })] }), selectedRarity === "legendary" && (_jsxs("div", { style: styles.legendaryBanner, children: [_jsx("span", { style: { fontSize: 14 }, children: "\uD83D\uDC51" }), _jsxs("span", { children: ["Legendary jokers spawn from ", _jsx("b", { children: "The Soul" }), ". Find it in ", _jsx("b", { children: "Arcana Pack" }), ",", " ", _jsx("b", { children: "Spectral Pack" }), ", ", _jsx("b", { children: "Charm Tag" }), ", or ", _jsx("b", { children: "Ethereal Tag" }), " only!"] })] })), _jsxs("div", { style: styles.jokerGrid, children: [filteredJokers.map((joker) => (_jsxs("div", { onClick: () => handleJokerSelect(joker), title: joker.name, style: styles.jokerCell, children: [_jsx(JimboSprite, { name: joker.name, sheet: "Jokers", width: 48 }), _jsx("span", { style: styles.jokerName, children: joker.name })] }, joker.name))), filteredJokers.length === 0 && (_jsxs("div", { style: styles.emptyState, children: ["No jokers match \"", search, "\""] }))] })] }))] }));
+}
+// ─── Styles ──────────────────────────────────────────────────────────────────
+const styles = {
+    container: {
+        background: C.DARKEST,
+        border: `2px solid ${C.TEAL_GREY}`,
+        borderRadius: 8,
+        padding: 0,
+        maxWidth: 400,
+        maxHeight: "80vh",
+        overflow: "hidden",
+        display: "flex",
+        flexDirection: "column",
+        fontFamily: "m6x11plus, ui-monospace, monospace",
+        boxShadow: `0 8px 32px ${withAlpha(C.BLACK, 0.6)}`,
+    },
+    header: {
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "space-between",
+        padding: "10px 12px",
+        borderBottom: `1px solid ${C.TEAL_GREY}`,
+        background: withAlpha(C.DARK_GREY, 0.5),
+    },
+    backBtn: {
+        background: "none",
+        border: "none",
+        color: C.GREY,
+        fontFamily: "m6x11plus, ui-monospace, monospace",
+        fontSize: 14,
+        cursor: "pointer",
+        padding: "4px 8px",
+    },
+    title: {
+        color: C.WHITE,
+        fontSize: 16,
+        fontWeight: "bold",
+        letterSpacing: 0.5,
+    },
+    rarityGrid: {
+        display: "flex",
+        flexDirection: "column",
+        gap: 8,
+        padding: 12,
+    },
+    rarityBtn: {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "flex-start",
+        gap: 4,
+        padding: "12px 14px",
+        border: "2px solid",
+        borderRadius: 6,
+        cursor: "pointer",
+        textAlign: "left",
+        transition: "background 150ms",
+    },
+    rarityLabel: {
+        fontSize: 16,
+        fontWeight: "bold",
+        fontFamily: "m6x11plus, ui-monospace, monospace",
+    },
+    rarityHint: {
+        fontSize: 11,
+        color: C.GREY,
+        fontFamily: "m6x11plus, ui-monospace, monospace",
+        lineHeight: "1.3",
+    },
+    searchRow: {
+        display: "flex",
+        gap: 8,
+        padding: "10px 12px 6px",
+    },
+    searchInput: {
+        flex: 1,
+        padding: "6px 10px",
+        borderRadius: 4,
+        border: `1px solid ${C.TEAL_GREY}`,
+        background: withAlpha(C.DARK_GREY, 0.8),
+        color: C.WHITE,
+        fontSize: 13,
+        fontFamily: "m6x11plus, ui-monospace, monospace",
+        outline: "none",
+    },
+    anyBtn: {
+        padding: "6px 14px",
+        borderRadius: 4,
+        border: `1px solid ${C.GOLD}`,
+        background: withAlpha(C.GOLD, 0.15),
+        color: C.GOLD,
+        fontSize: 13,
+        fontFamily: "m6x11plus, ui-monospace, monospace",
+        cursor: "pointer",
+        fontWeight: "bold",
+    },
+    legendaryBanner: {
+        display: "flex",
+        alignItems: "flex-start",
+        gap: 6,
+        margin: "4px 12px 8px",
+        padding: "8px 10px",
+        borderRadius: 4,
+        background: withAlpha(C.PURPLE, 0.12),
+        border: `1px solid ${withAlpha(C.PURPLE, 0.3)}`,
+        color: C.PURPLE,
+        fontSize: 11,
+        lineHeight: "1.4",
+    },
+    jokerGrid: {
+        display: "grid",
+        gridTemplateColumns: "repeat(auto-fill, minmax(64px, 1fr))",
+        gap: 6,
+        padding: "8px 12px 12px",
+        overflowY: "auto",
+        flex: 1,
+    },
+    jokerCell: {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        gap: 3,
+        padding: 4,
+        borderRadius: 4,
+        cursor: "pointer",
+        transition: "background 120ms",
+        background: "transparent",
+    },
+    jokerName: {
+        fontSize: 9,
+        color: C.GREY,
+        textAlign: "center",
+        lineHeight: "1.2",
+        maxWidth: 60,
+        overflow: "hidden",
+        textOverflow: "ellipsis",
+        whiteSpace: "nowrap",
+    },
+    emptyState: {
+        gridColumn: "1 / -1",
+        textAlign: "center",
+        color: C.GREY,
+        fontSize: 13,
+        padding: 20,
+    },
+};

package/dist/components/jamlMap/MysterySlot.d.ts

@@ -0,0 +1,32 @@
+import React from "react";
+import type { SpriteSheetType } from "../../sprites/spriteMapper.js";
+export type JamlZone = "must" | "should" | "mustnot";
+/** The item category that can appear in a slot. */
+export type SlotCategory = "joker" | "voucher" | "tag" | "boss" | "tarot" | "spectral" | "planet" | "pack";
+/** Result of selecting a specific item in a slot. */
+export interface SlotSelection {
+    category: SlotCategory;
+    /** The specific item name, or "Any" for wildcards. */
+    value: string;
+    /** JAML clause key (e.g. "commonJoker", "legendaryJoker", "voucher"). */
+    clauseKey: string;
+    /** Optional rarity for jokers. */
+    rarity?: "common" | "uncommon" | "rare" | "legendary";
+}
+export interface MysterySlotProps {
+    /** Which zone this slot belongs to — determines border color. */
+    zone: JamlZone;
+    /** What sheet type to render mystery card from. */
+    sheetType: SpriteSheetType;
+    /** Current selection, if any. */
+    selection?: SlotSelection;
+    /** Width of the card sprite. */
+    width?: number;
+    /** Called when the slot is tapped (to open a picker). */
+    onTap?: () => void;
+    /** Called when the selection is cleared. */
+    onClear?: () => void;
+    /** Additional inline styles. */
+    style?: React.CSSProperties;
+}
+export declare function MysterySlot({ zone, sheetType, selection, width, onTap, onClear, style, }: MysterySlotProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/jamlMap/MysterySlot.js

@@ -0,0 +1,109 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { JimboSprite } from "../../ui/sprites.js";
+import { JimboColorOption, withAlpha, JIMBO_ANIMATIONS } from "../../ui/tokens.js";
+// ─── Zone colors ─────────────────────────────────────────────────────────────
+const C = JimboColorOption;
+const ZONE_BORDER = {
+    must: C.BLUE,
+    should: C.RED,
+    mustnot: C.ORANGE,
+};
+// ─── Sheet → "Any" wildcard mapping ─────────────────────────────────────────
+function getWildcardName(category) {
+    if (!category)
+        return null;
+    switch (category) {
+        case "joker": return null; // uses generic mystery
+        case "voucher": return null;
+        case "tag": return null;
+        case "boss": return null;
+        case "tarot": return null;
+        case "spectral": return null;
+        case "planet": return null;
+        case "pack": return null;
+        default: return null;
+    }
+}
+// ─── Component ───────────────────────────────────────────────────────────────
+export function MysterySlot({ zone, sheetType, selection, width = 56, onTap, onClear, style, }) {
+    const [hover, setHover] = useState(false);
+    const [pressed, setPressed] = useState(false);
+    const borderColor = ZONE_BORDER[zone];
+    const isEmpty = !selection;
+    const cardH = Math.round((width * 95) / 71);
+    // Determine what to render
+    const spriteName = selection?.value ?? "";
+    const spriteSheet = selection ? categoryToSheet(selection.category) ?? sheetType : sheetType;
+    const scale = pressed
+        ? 0.95
+        : hover
+            ? JIMBO_ANIMATIONS.JUICE_UP_SCALE
+            : 1;
+    return (_jsxs("div", { onClick: onTap, onMouseEnter: () => setHover(true), onMouseLeave: () => { setHover(false); setPressed(false); }, onMouseDown: () => setPressed(true), onMouseUp: () => setPressed(false), style: {
+            position: "relative",
+            width: width + 8,
+            height: cardH + 8,
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            cursor: onTap ? "pointer" : "default",
+            borderRadius: 6,
+            border: isEmpty
+                ? `2px dashed ${withAlpha(borderColor, 0.4)}`
+                : `3px solid ${borderColor}`,
+            background: isEmpty
+                ? withAlpha(borderColor, 0.06)
+                : withAlpha(C.DARKEST, 0.8),
+            transform: `scale(${scale})`,
+            transition: `transform ${JIMBO_ANIMATIONS.JUICE_DURATION}ms ${JIMBO_ANIMATIONS.JUICE_EASING}, border-color 200ms`,
+            ...style,
+        }, children: [_jsx(JimboSprite, { name: spriteName, sheet: spriteSheet, width: width, style: {
+                    opacity: isEmpty ? 0.5 : 1,
+                    filter: isEmpty ? "saturate(0.3)" : "none",
+                    transition: "opacity 200ms, filter 200ms",
+                } }), selection && onClear && (_jsx("div", { onClick: (e) => { e.stopPropagation(); onClear(); }, style: {
+                    position: "absolute",
+                    top: -6,
+                    right: -6,
+                    width: 18,
+                    height: 18,
+                    borderRadius: "50%",
+                    background: C.RED,
+                    color: C.WHITE,
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "center",
+                    fontSize: 11,
+                    fontFamily: "m6x11plus, ui-monospace, monospace",
+                    cursor: "pointer",
+                    lineHeight: 1,
+                    boxShadow: `0 1px 4px ${withAlpha(C.BLACK, 0.5)}`,
+                }, children: "\u00D7" })), isEmpty && hover && (_jsx("div", { style: {
+                    position: "absolute",
+                    bottom: -16,
+                    left: "50%",
+                    transform: "translateX(-50%)",
+                    fontFamily: "m6x11plus, ui-monospace, monospace",
+                    fontSize: 10,
+                    color: borderColor,
+                    whiteSpace: "nowrap",
+                    textTransform: "uppercase",
+                    letterSpacing: 1,
+                }, children: "+ tap" }))] }));
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function categoryToSheet(cat) {
+    switch (cat) {
+        case "joker": return "Jokers";
+        case "voucher": return "Vouchers";
+        case "tag": return "tags";
+        case "boss": return "BlindChips";
+        case "tarot":
+        case "spectral":
+        case "planet": return "Tarots";
+        case "pack": return "Boosters";
+        default: return null;
+    }
+}

package/dist/components/jamlMap/index.d.ts

@@ -0,0 +1,3 @@
+export { MysterySlot, type MysterySlotProps, type SlotSelection, type SlotCategory, type JamlZone } from "./MysterySlot.js";
+export { JokerPicker, type JokerPickerProps, type JokerRarity } from "./JokerPicker.js";
+export { JamlMapEditorDemo, type JamlMapEditorDemoProps } from "./JamlMapEditorDemo.js";

package/dist/components/jamlMap/index.js

@@ -0,0 +1,3 @@
+export { MysterySlot } from "./MysterySlot.js";
+export { JokerPicker } from "./JokerPicker.js";
+export { JamlMapEditorDemo } from "./JamlMapEditorDemo.js";

package/dist/core.d.ts

@@ -2,6 +2,4 @@ export { JAML_ASSET_FILES, clearJamlAssetBaseUrl, getDefaultJamlAssetUrlMap, res
 export { Layer, type LayerOptions } from "./render/Layer.js";
 export { getSpriteData, type SpriteData, type SpriteSheetType } from "./sprites/spriteMapper.js";
 export { SPRITE_SHEETS, JOKERS, JOKER_FACES, TAROTS_AND_PLANETS, CONSUMABLE_FACES, VOUCHERS, BOSSES, TAGS, BOOSTER_PACKS, EDITION_MAP, STICKER_MAP, RANK_MAP, SUIT_MAP, ENHANCER_MAP, SEAL_MAP, type SpritePos, type SpriteEntry, type SpriteSheetInfo, } from "./sprites/spriteData.js";
-export { BalatroItemCategory, packedItemCategory, packedJokerRarity, packedItemIndex, isPackedItemValid, } from "./decode/packedBalatroItem.js";
-export { getItemDisplayName, getItemCategory, getSuitColor } from "./utils/itemUtils.js";
 export { getStandardCardPosition, getSealPosition, getEnhancerPosition } from "./utils/gameCardUtils.js";

package/dist/core.js

@@ -2,6 +2,4 @@ export { JAML_ASSET_FILES, clearJamlAssetBaseUrl, getDefaultJamlAssetUrlMap, res
 export { Layer } from "./render/Layer.js";
 export { getSpriteData } from "./sprites/spriteMapper.js";
 export { SPRITE_SHEETS, JOKERS, JOKER_FACES, TAROTS_AND_PLANETS, CONSUMABLE_FACES, VOUCHERS, BOSSES, TAGS, BOOSTER_PACKS, EDITION_MAP, STICKER_MAP, RANK_MAP, SUIT_MAP, ENHANCER_MAP, SEAL_MAP, } from "./sprites/spriteData.js";
-export { BalatroItemCategory, packedItemCategory, packedJokerRarity, packedItemIndex, isPackedItemValid, } from "./decode/packedBalatroItem.js";
-export { getItemDisplayName, getItemCategory, getSuitColor } from "./utils/itemUtils.js";
 export { getStandardCardPosition, getSealPosition, getEnhancerPosition } from "./utils/gameCardUtils.js";

package/dist/decode/motelyItemDecoder.d.ts

@@ -1,12 +1,9 @@
 /**
- * Motely item decoder.
- *
- * MotelyItem.Value is a packed integer. The MotelyItemType enum
- * uses packed integers where the top nibble encodes category:
- *   0x1000 = Standardcard, 0x2000 = Spectral, 0x3000 = Tarot,
- *   0x4000 = Planet, 0x5000 = Joker, 0xF000 = Invalid
+ * Motely item decoder — thin wrapper over motely-wasm runtime enums.
+ * No hand-rolled bitmask tables. The WASM enum IS the source of truth.
  */
-import { type CardCategory } from "../utils/itemUtils.js";
+export type CardCategory = "joker" | "consumable" | "playing" | "spectral" | "tarot" | "planet";
+export type MotelyRenderableCategory = CardCategory | "unknown";
 export type MotelyItemInput = number | MotelyRuntimeItem | null | undefined;
 export interface MotelyRuntimeItem {
     type?: number;
@@ -17,7 +14,6 @@ export interface MotelyRuntimeItem {
     suit?: number;
     rank?: number;
 }
-export type MotelyRenderableCategory = CardCategory | "unknown";
 export interface DecodedMotelyItem {
     itemType: number;
     enumKey: string;
@@ -42,26 +38,17 @@ export interface MotelyJamlCard {
     };
 }
 export declare function resolveMotelyItemType(input: MotelyItemInput): number | null;
+export declare function motelyItemTypeName(input: MotelyItemInput): string;
+export declare function motelyItemCategory(itemType: number): MotelyRenderableCategory;
 export declare function motelyItemRenderCategory(input: MotelyItemInput): MotelyRenderableCategory;
+export declare function motelyItemDisplayName(input: MotelyItemInput): string;
 export declare function motelyItemEditionName(input: MotelyItemInput): "Foil" | "Holographic" | "Polychrome" | "Negative" | null;
 export declare function motelyItemSealName(input: MotelyItemInput): "Gold" | "Red" | "Blue" | "Purple" | null;
 export declare function motelyItemEnhancementName(input: MotelyItemInput): string | null;
-export declare function motelyStandardcardSuitName(input: MotelyItemInput): "Clubs" | "Diamonds" | "Hearts" | "Spades" | null;
 export declare function motelyStandardcardRankName(input: MotelyItemInput): string | null;
-/** Get the enum key name for a MotelyItemType value. */
-export declare function motelyItemTypeName(input: MotelyItemInput): string;
-/** Get the category string for a MotelyItemType value. */
-export declare function motelyItemCategory(input: MotelyItemInput): string;
-/** Convert PascalCase enum key to display name. */
-export declare function motelyItemDisplayName(input: MotelyItemInput): string;
+export declare function motelyStandardcardSuitName(input: MotelyItemInput): "Clubs" | "Diamonds" | "Hearts" | "Spades" | null;
+export declare function decodeMotelyItemName(input: MotelyItemInput): string;
 export declare function decodeMotelyItem(input: MotelyItemInput): DecodedMotelyItem | null;
 export declare function decodeMotelyItemToJamlCard(input: MotelyItemInput, scale?: number): MotelyJamlCard | null;
-/**
- * Decode a MotelyItemType integer to a display name for sprite lookup.
- * Cached per value.
- */
-export declare function decodeMotelyItemName(input: MotelyItemInput): string | null;
-/** Warm the cache for a batch of item type values. */
-export declare function warmMotelyItemCache(itemTypes: readonly MotelyItemInput[]): void;
-/** Number of unique items decoded so far. */
+export declare function warmMotelyItemCache(): void;
 export declare function motelyItemCacheSize(): number;