jaml-ui 4.4.0 → 6.0.0

package/dist/components/DailyRitualView.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { DailyRitual } from '../lib/daily/ritual.js';
+export interface DailyRitualViewProps {
+    /** The ritual to render. Provide this or {@link jaml}; `ritual` wins if both are given. */
+    ritual?: DailyRitual;
+    /** Raw JAML source; parsed into a ritual when `ritual` is not supplied. */
+    jaml?: string;
+    /** Which day this is, for the header badge. Runtime info, not part of the ritual file. */
+    dayNumber?: number;
+    /** Formatted date for the header badge, e.g. "Fri, Aug 21". */
+    dateString?: string;
+    onLoadJaml?: (jaml: string) => void;
+    onPlayRitual?: (ritual: DailyRitual) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare function DailyRitualView({ ritual: ritualProp, jaml, dayNumber, dateString, onLoadJaml, onPlayRitual, className, style, }: DailyRitualViewProps): React.JSX.Element;

package/dist/components/DeckStakePicker.d.ts

@@ -0,0 +1,12 @@
+declare const DECKS: readonly string[];
+declare const STAKES: readonly string[];
+export interface DeckStakePickerProps {
+    deck: string;
+    stake: string;
+    onDeckChange: (deck: string) => void;
+    onStakeChange: (stake: string) => void;
+    className?: string;
+}
+/** New-run deck + stake cyclers. Sprites from the atlas, names from Motely enums. */
+export declare function DeckStakePicker({ deck, stake, onDeckChange, onStakeChange, className, }: DeckStakePickerProps): import("react").JSX.Element;
+export { DECKS as DECK_PICKER_NAMES, STAKES as STAKE_PICKER_NAMES };

package/dist/components/JamlIdeToolbar.d.ts

@@ -1,15 +1,12 @@
 import { default as React } from 'react';
-export type JamlIdeMode = "visual" | "code" | "map" | "results" | "jamlyzer";
+export type JamlIdeMode = "visual" | "code" | "inspect";
 export interface JamlIdeToolbarProps {
     mode: JamlIdeMode;
     onModeChange: (mode: JamlIdeMode) => void;
-    resultCount?: number;
-    showResultsTab?: boolean;
-    showJamlyzerTab?: boolean;
     className?: string;
     onSearch?: () => void;
     isSearching?: boolean;
     onLoadFile?: () => void;
     isLoadingFile?: boolean;
 }
-export declare function JamlIdeToolbar({ mode, onModeChange, resultCount, showResultsTab, showJamlyzerTab, className, onSearch, isSearching, onLoadFile, isLoadingFile, }: JamlIdeToolbarProps): React.JSX.Element;
+export declare function JamlIdeToolbar({ mode, onModeChange, className, onSearch, isSearching, onLoadFile, isLoadingFile, }: JamlIdeToolbarProps): React.JSX.Element;

package/dist/components/JamlIdeVisual.d.ts

@@ -45,13 +45,14 @@ export declare function MysteryAddTile({ zone, onTap }: {
     zone: JamlZone;
     onTap?: () => void;
 }): React.JSX.Element;
-export declare function ZoneRail({ zone, clauses, onAdd, onRemove, onEdit, onDragStart, }: {
+export declare function ZoneRail({ zone, clauses, onAdd, onRemove, onEdit, onDragStart, dropTarget, }: {
     zone: JamlZone;
     clauses: JamlVisualClause[];
     onAdd?: () => void;
     onRemove: (id: string) => void;
     onEdit: (clause: JamlVisualClause) => void;
     onDragStart: (e: React.MouseEvent | React.TouchEvent, clause: JamlVisualClause, zone: JamlZone) => void;
+    dropTarget?: boolean;
 }): React.JSX.Element;
 export declare function TopMatter({ filter, onChange, }: {
     filter: JamlVisualFilter;

package/dist/components/Jamlyzer.d.ts

@@ -1,8 +1,20 @@
 import { default as React } from 'react';
+import { MotelyJamlyzerSeedResult, MotelyDeck, MotelyStake } from 'motely-wasm';
 export interface JamlyzerProps {
     /** Full JAML document. Seeds come from the top-level `seeds:` array via Motely. */
-    jaml: string;
+    jaml?: string;
+    /** Direct in-memory seeds array or pre-analyzed seed results. */
+    seeds?: readonly (string | MotelyJamlyzerSeedResult)[];
+    /** Pre-analyzed seed results. */
+    results?: readonly MotelyJamlyzerSeedResult[];
+    deck?: MotelyDeck | number;
+    stake?: MotelyStake | number;
+    maxAnte?: number;
+    defaultSelectedSeed?: string;
+    onSelectSeed?: (seed: string) => void;
     className?: string;
     style?: React.CSSProperties;
 }
-export declare function Jamlyzer({ jaml, className, style }: JamlyzerProps): React.JSX.Element;
+export type JamlyzerSortMode = "highest-score" | "ante1-hits" | "alpha";
+export type JamlyzerFilterMode = "all" | "matches" | "pinned";
+export declare function Jamlyzer({ jaml, seeds: seedsProp, results: resultsProp, deck, stake, maxAnte, defaultSelectedSeed, onSelectSeed, className, style, }: JamlyzerProps): React.JSX.Element;

package/dist/components/JamlyzerBulk.d.ts

@@ -1,20 +1,21 @@
 import { MotelyJamlyzerSeedResult } from 'motely-wasm';
-import { ParsedJamlClause } from '../lib/jaml/parseClauses.js';
+import { JamlClause } from '../lib/jaml/jaml.js';
 export interface JamlyzerBulkProps {
     results: MotelyJamlyzerSeedResult[];
     /** Raw JAML text; used to derive clause identities if `clauses` is not provided. */
     jamlText?: string;
     /** Pre-parsed clauses (alternative to `jamlText`). */
-    clauses?: ParsedJamlClause[];
+    clauses?: JamlClause[];
     /** Per-seed per-should-clause tally values, in JAML order. */
     tallies?: (number[] | Int32Array)[];
     /** Optional deck/stake applied to every seed in the bulk view. */
     deck?: number;
     stake?: number;
+    pageSize?: number;
 }
 export declare function ClauseHitPanel({ clause, hitAntes, tally, }: {
-    clause: ParsedJamlClause;
+    clause: JamlClause;
     hitAntes: number[];
     tally?: number;
 }): import("react").JSX.Element;
-export declare function JamlyzerBulk({ results, jamlText, clauses: clausesProp, tallies, deck, stake }: JamlyzerBulkProps): import("react").JSX.Element;
+export declare function JamlyzerBulk({ results, jamlText, clauses: clausesProp, tallies, deck, stake, pageSize, }: JamlyzerBulkProps): import("react").JSX.Element;

package/dist/components/JamlyzerView.d.ts

@@ -1,19 +1,8 @@
-import { default as React } from 'react';
 import { MotelyJamlyzerSeedResult, MotelyDeck, MotelyStake } from 'motely-wasm';
-import { ParsedJamlClause } from '../lib/jaml/parseClauses.js';
 export interface JamlyzerViewProps {
     result: MotelyJamlyzerSeedResult;
     deck?: MotelyDeck;
     stake?: MotelyStake;
-    /** Maximum ante number to display in the rail. Antes 0–39 are valid in Balatro. */
     maxAnte?: number;
-    /** Raw JAML text used to derive clause identities for highlighting. */
-    jamlText?: string;
-    /** Pre-parsed clauses (alternative to `jamlText`). */
-    clauses?: ParsedJamlClause[];
-    /** Per-should-clause tally values, in JAML order. */
-    tallies?: number[] | Int32Array;
-    /** Called when the user hovers a clause in the scoreboard. */
-    onHoverClause?: (clause: ParsedJamlClause | null) => void;
 }
-export declare function JamlyzerView({ result, deck, stake, maxAnte: maxAnteProp, jamlText, clauses: clausesProp, tallies, onHoverClause, }: JamlyzerViewProps): React.JSX.Element;
+export declare function JamlyzerView({ result, deck, stake, maxAnte: maxAnteProp, }: JamlyzerViewProps): import("react").JSX.Element;

package/dist/components/SeedCalculus.d.ts

@@ -0,0 +1,17 @@
+export interface SeedCalculusProps {
+    /**
+     * Measured rarity source. When present with at least one hit, rarity is
+     * `seedsChecked / hits` and the rarity dial is locked — "measure it beats
+     * any formula". Wire it to a live search's `matchingSeeds / totalSeedsSearched`.
+     */
+    measured?: {
+        hits: number;
+        seedsChecked: number;
+    };
+    /** Starting "1 in N" rarity when not measured. Default 346,736,850. */
+    defaultRarityOneIn?: number;
+    /** Starting rig speed in seeds/sec. Default 3,300,000. */
+    defaultSeedsPerSecond?: number;
+    className?: string;
+}
+export declare function SeedCalculus({ measured, defaultRarityOneIn, defaultSeedsPerSecond, className, }: SeedCalculusProps): import("react").JSX.Element;

package/dist/components/SeedLab.d.ts

@@ -0,0 +1,21 @@
+export declare const STARTER_JAML = "must:\n  - joker: Blueprint\n    antes: [1]\nshould:\n  - voucher: Telescope\n    antes: [1]\n";
+export declare const JAMLYZE_JAML = "seeds:\n  - WEEJOKER\nmust:\n  - joker: Blueprint\n    antes: [1]\nshould:\n  - voucher: Telescope\n    antes: [1]\n";
+export type SeedHit = {
+    seed: string;
+    score: number;
+};
+export type SeedSearchPhase = "idle" | "booting" | "searching" | "done" | "cancelled" | "error";
+export type SeedSearchStats = {
+    seedsSearched: number;
+    matchingSeeds: number;
+    /** 0-1. */
+    percentComplete: number;
+    seedsPerSecond: number;
+    elapsedMs: number;
+};
+export declare function LiveJamlIde({ defaultJaml }: {
+    defaultJaml?: string;
+}): import("react").JSX.Element;
+export declare function SeedLab({ defaultJaml }: {
+    defaultJaml?: string;
+}): import("react").JSX.Element;

package/dist/components/jamlSeedUtils.d.ts

@@ -1 +1,2 @@
 export declare function normalizeJamlSeed(seed: string): string;
+export declare function randomLength8Seeds(count: number): string[];

package/dist/components/jamlyzer/JamlyzerAnteDetails.d.ts

@@ -1,4 +1,8 @@
 import { MotelyJamlyzerAnteResult } from 'motely-wasm';
+export declare function LabeledItem({ value, scale }: {
+    value: number;
+    scale: number;
+}): import("react").JSX.Element;
 export declare function ResolvedItem({ value, scale }: {
     value: number;
     scale: number;

package/dist/components/jamlyzer/JamlyzerErraticDeck.d.ts

@@ -1,8 +1,8 @@
 import { MotelyItem } from 'motely-wasm';
-import { ParsedJamlClause } from '../../lib/jaml/parseClauses.js';
+import { JamlClause } from '../../lib/jaml/jaml.js';
 export interface JamlyzerErraticDeckProps {
     cards: MotelyItem[];
-    matches: Map<string, ParsedJamlClause[]>;
+    matches: Map<string, JamlClause[]>;
 }
 /** The randomized starting deck when playing the Erratic deck. */
 export declare function JamlyzerErraticDeck({ cards, matches }: JamlyzerErraticDeckProps): import("react").JSX.Element | null;

package/dist/components/jamlyzer/JamlyzerPackSection.d.ts

@@ -1,9 +1,5 @@
 import { MotelyJamlyzerAnteResult } from 'motely-wasm';
-import { ParsedJamlClause } from '../../lib/jaml/parseClauses.js';
 export interface JamlyzerPackSectionProps {
     pack: MotelyJamlyzerAnteResult["packs"][number];
-    ante: number;
-    matches: Map<string, ParsedJamlClause[]>;
 }
-/** One booster pack: name + card count, then the cards inside. */
-export declare function JamlyzerPackSection({ pack, ante, matches }: JamlyzerPackSectionProps): import("react").JSX.Element;
+export declare function JamlyzerPackSection({ pack }: JamlyzerPackSectionProps): import("react").JSX.Element;

package/dist/components/jamlyzer/JamlyzerPulls.d.ts

@@ -1,8 +1,8 @@
 import { MotelyJamlyzerAnteResult } from 'motely-wasm';
-import { ParsedJamlClause } from '../../lib/jaml/parseClauses.js';
+import { JamlClause } from '../../lib/jaml/jaml.js';
 export interface JamlyzerPullsProps {
     ante: MotelyJamlyzerAnteResult;
-    matches: Map<string, ParsedJamlClause[]>;
+    matches: Map<string, JamlClause[]>;
 }
 /** Extra-card pulls (Judgement, Wraith, tags, …) and the voucher sequence. */
 export declare function JamlyzerPulls({ ante, matches }: JamlyzerPullsProps): import("react").JSX.Element | null;

package/dist/components/jamlyzer/JamlyzerSeedCard.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+import { MotelyJamlyzerSeedResult } from 'motely-wasm';
+import { JamlClause } from '../../lib/jaml/jaml.js';
+export interface JamlyzerSeedCardProps {
+    result: MotelyJamlyzerSeedResult;
+    selected?: boolean;
+    pinned?: boolean;
+    onSelect: () => void;
+    onTogglePin?: (e: React.MouseEvent) => void;
+    maxScore?: number;
+    clauses?: JamlClause[];
+    className?: string;
+    style?: React.CSSProperties;
+}
+export interface SeedMilestoneHit {
+    ante: number;
+    label: string;
+    tone: "green" | "orange" | "purple" | "blue" | "red";
+}
+export declare function extractSeedMilestones(result: MotelyJamlyzerSeedResult, clauses?: JamlClause[], maxMilestones?: number): SeedMilestoneHit[];
+export declare function JamlyzerSeedCard({ result, selected, pinned, onSelect, onTogglePin, clauses, className, style, }: JamlyzerSeedCardProps): React.JSX.Element;

package/dist/components/jamlyzer/JamlyzerTape.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+export interface JamlyzerTapeProps {
+    /** A JAML filter. Its `seeds:` list must name exactly one seed. */
+    jaml: string;
+    /** Rolls fetched per page. The engine's own default is 20. */
+    pageSize?: number;
+    /** Stop after this many rolls so a runaway scroll can't page forever. */
+    maxRolls?: number;
+}
+export declare function JamlyzerTape({ jaml, pageSize, maxRolls, }: JamlyzerTapeProps): React.JSX.Element;

package/dist/components/jamlyzer/highlight.d.ts

@@ -1,5 +1,5 @@
-import { ParsedJamlClause, JamlItemType } from '../../lib/jaml/parseClauses.js';
+import { JamlClause, JamlItemType } from '../../lib/jaml/jaml.js';
 import { MotelyRenderableCategory } from '../../decode/motelyItemDecoder.js';
 export declare function itemTypeOfCategory(category: MotelyRenderableCategory): JamlItemType;
-export declare function buildMatchMap(clauses: ParsedJamlClause[]): Map<string, ParsedJamlClause[]>;
-export declare function selectHighlight(itemType: JamlItemType, name: string, ante: number, matches: Map<string, ParsedJamlClause[]>): string | undefined;
+export declare function buildMatchMap(clauses: JamlClause[]): Map<string, JamlClause[]>;
+export declare function selectHighlight(itemType: JamlItemType, name: string, ante: number, matches: Map<string, JamlClause[]>): string | undefined;

package/dist/decode/motelyItemDecoder.d.ts

@@ -3,6 +3,7 @@ export type MotelyRenderableCategory = CardCategory | "unknown";
 export type MotelyItemInput = number | MotelyRuntimeItem | null | undefined;
 export interface MotelyRuntimeItem {
     type?: number;
+    typeCategory?: number;
     value?: number;
     edition?: number;
     seal?: number;

package/dist/decode/motelySprite.d.ts

@@ -1,19 +1,16 @@
-import { MotelyRenderableCategory } from './motelyItemDecoder.js';
-export interface MotelySpriteData {
+import { MotelyItem } from 'motely-wasm';
+export interface MotelySpriteCell {
     atlasPath: string;
     gridCol: number;
     gridRow: number;
     gridCols: number;
     gridRows: number;
-    displayName: string;
-    category: MotelyRenderableCategory;
 }
-/**
- * Given a raw motely-wasm item value (which may be a bitpacked integer or raw MotelyItemType),
- * resolves it to a sprite atlas path and grid coordinates for rendering.
- */
-export declare function motelyItemToSprite(rawValue: number): MotelySpriteData | null;
-/**
- * Resolves a sprite by name and category without needing a Motely integer.
- */
-export declare function getMotelySpriteByName(name: string, category?: MotelyRenderableCategory): MotelySpriteData | null;
+export declare function unpackSpriteCell(packed: number): {
+    sheet: number;
+    x: number;
+    y: number;
+};
+/** O(1): MotelyItemType int → atlas cell. No name, no normalize. */
+export declare function motelyItemTypeToSprite(type: number): MotelySpriteCell | null;
+export declare function motelyItemToSprite(item: MotelyItem | number): MotelySpriteCell | null;

package/dist/decode/motelySpriteLut.generated.d.ts

@@ -0,0 +1,2 @@
+/** packed cell: sheet:8 | x:8 | y:8. sheet 0=Jokers 1=Tarots 2=Decks */
+export declare const MOTELY_SPRITE_BY_TYPE: ReadonlyMap<number, number>;

package/dist/index.d.ts

@@ -2,15 +2,28 @@ export { JamlCardRenderer, type JamlCardRendererProps, } from './render/CanvasRe
 export { JamlGameCard, JamlVoucher, JamlTag, JamlBoss, resolveAnalyzerShopItem, type JamlGameCardProps, type AnalyzerShopItem, type AnalyzerResolvedItem, } from './components/GameCard.js';
 export { JamlyzerView, type JamlyzerViewProps, } from './components/JamlyzerView.js';
 export { JimboBalatroFooter, type JimboBalatroFooterProps, } from './components/JimboBalatroFooter.js';
+export { Jamlyzer, type JamlyzerProps, type JamlyzerSortMode, type JamlyzerFilterMode, } from './components/Jamlyzer.js';
+export { JamlyzerSeedCard, type JamlyzerSeedCardProps, type SeedMilestoneHit, } from './components/jamlyzer/JamlyzerSeedCard.js';
 export { JamlyzerBulk, type JamlyzerBulkProps, } from './components/JamlyzerBulk.js';
-export { parseJamlClauses, type ParsedJamlClause, type JamlClauseKind, type JamlItemType, type ParsedJamlFilters, matchClauseToItem, matchClauseToAnte, matchMotelyItemToClause, } from './lib/jaml/parseClauses.js';
+export { JamlyzerTape, type JamlyzerTapeProps, } from './components/jamlyzer/JamlyzerTape.js';
+export { JamlSeedInput, type JamlSeedInputProps, type JamlSeedInputVariant, } from './components/JamlSeedInput.js';
+export { JamlSeedSpinner, type JamlSeedSpinnerProps, } from './components/JamlSeedSpinner.js';
+export { normalizeJamlSeed } from './components/jamlSeedUtils.js';
+export { DailyRitualView, type DailyRitualViewProps, } from './components/DailyRitualView.js';
+export { type DailyRitual, parseRitual } from './lib/daily/ritual.js';
+export { parseJaml, type JamlClause, type JamlClauseKind, type JamlItemType, type JamlFilter, matchClauseToItem, matchClauseToAnte, matchMotelyItemToClause, } from './lib/jaml/jaml.js';
+export { estimateJamlRarity, estimateEtaSeconds, formatOneIn, formatEta, type JamlRarityEstimate, type ClauseRarityEstimate, type RarityFlag, type RaritySeverity, type RarityClauseKind, } from './lib/jaml/rarity.js';
+export { RARITY_DATA, type RarityData } from './lib/jaml/rarityData.generated.js';
 export { DeckSprite, DECK_SPRITE_POS, STAKE_SPRITE_POS, type DeckSpriteProps, } from './components/DeckSprite.js';
+export { DeckStakePicker, DECK_PICKER_NAMES, STAKE_PICKER_NAMES, type DeckStakePickerProps, } from './components/DeckStakePicker.js';
 export { StandardCard } from './components/StandardCard.js';
 export { CardSuit, CardRank, CardEnhancement, CardSeal, CardEdition, } from './components/cardEnums.js';
 export { JamlMapEditor, CategoryMenu, MysterySlot, JokerPicker, CategoryPicker, type JamlMapEditorProps, type MysterySlotProps, type SlotSelection, type SlotCategory, type JokerPickerProps, type JokerRarity, 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';
 export { JamlIde, type JamlIdeProps, type JamlIdeSearchResult, type JamlVisualFilter, type JamlVisualClause, type JamlZone, } from './components/JamlIde.js';
+export { SeedLab, LiveJamlIde, STARTER_JAML, JAMLYZE_JAML, type SeedHit } from './components/SeedLab.js';
 export { JamlIdeVisual, type JamlIdeVisualProps } from './components/JamlIdeVisual.js';
 export { JamlIdeToolbar, type JamlIdeToolbarProps, type JamlIdeMode } from './components/JamlIdeToolbar.js';
 export { JamlMapPreview, type JamlMapPreviewProps } from './components/JamlMapPreview.js';
+export { SeedCalculus, type SeedCalculusProps } from './components/SeedCalculus.js';
 export * from './ui.js';
 export * from './json-render/index.js';