jaml-ui 4.3.1 → 4.6.0

package/dist/lib/jaml/{parseClauses.d.ts → jaml.d.ts}

@@ -1,6 +1,6 @@
 export type JamlClauseKind = "must" | "should" | "mustNot";
 export type JamlItemType = "joker" | "voucher" | "boss" | "tag" | "tarot" | "planet" | "spectral" | "consumable" | "standardcard" | "deck" | "stake" | "seed" | "any" | "unknown";
-export interface ParsedJamlClause {
+export interface JamlClause {
     kind: JamlClauseKind;
     itemType: JamlItemType;
     /** Exact names as written in JAML (e.g. "WeeJoker"). */
@@ -14,22 +14,26 @@ export interface ParsedJamlClause {
     /** Raw clause object for advanced consumers. */
     raw: Record<string, unknown>;
 }
-export interface ParsedJamlFilters {
+export interface JamlFilter {
     deck?: string;
     stake?: string;
-    must: ParsedJamlClause[];
-    should: ParsedJamlClause[];
-    mustNot: ParsedJamlClause[];
-    all: ParsedJamlClause[];
+    must: JamlClause[];
+    should: JamlClause[];
+    mustNot: JamlClause[];
+    all: JamlClause[];
 }
-export declare function parseJamlClauses(jamlText: string): ParsedJamlFilters;
+/** Pure line-based JAML parser without generic YAML library dependencies */
+export declare function parseJamlDocument(jamlText: string): Record<string, unknown>;
+export declare function parseJaml(jamlText: string): JamlFilter;
+export declare function highlightClassForKind(kind: JamlClauseKind): string;
 export declare function splitCamelCase(key: string): string;
 export declare function normalizeName(name: string): string;
-export declare function matchClauseToItem(clause: ParsedJamlClause, itemType: JamlItemType, itemName: string): boolean;
-export declare function matchClauseToAnte(clause: ParsedJamlClause, ante: number): boolean;
-export declare function highlightClassForKind(kind: JamlClauseKind): string;
-/** Convenience matcher that maps the coarse decoder category to a JAML item type. */
-export declare function matchMotelyItemToClause(item: {
+export declare function matchClauseToItem(clause: JamlClause, itemType: string, itemName: string): boolean;
+export declare function matchClauseToAnte(clause: JamlClause, ante: number): boolean;
+export declare function matchMotelyItemToClause(decodedItem: {
     category?: string;
+    kind?: string;
     displayName?: string;
-}, clause: ParsedJamlClause): boolean;
+    name?: string;
+    enumKey?: string;
+}, clause: JamlClause): boolean;

package/dist/lib/jaml/rarity.d.ts

@@ -0,0 +1,53 @@
+export type RarityClauseKind = "must" | "should" | "mustNot";
+export type RaritySeverity = "error" | "warn" | "flag" | "info";
+export interface RarityFlag {
+    id: string;
+    severity: RaritySeverity;
+    reason: string;
+}
+export interface ClauseRarityEstimate {
+    kind: RarityClauseKind;
+    /** Engine discriminator as written (e.g. "legendaryJoker"). */
+    discriminator: string;
+    names: string[];
+    /** Ante window used for the estimate (defaulted to 1-8 when unspecified). */
+    antes: number[];
+    label: string;
+    /** Probability a uniformly random seed satisfies this clause. */
+    pPerSeed: number;
+    /** 1 / pPerSeed; null when the clause is certain or impossible. */
+    oneIn: number | null;
+    /** Expected hit count per seed before the ≥min tail (diagnostic). */
+    lambda: number;
+    flags: RarityFlag[];
+    /** One-line description of the math used, for UI tooltips. */
+    model: string;
+    raw: Record<string, unknown>;
+}
+export interface JamlRarityEstimate {
+    deck?: string;
+    stake?: string;
+    clauses: ClauseRarityEstimate[];
+    combined: {
+        /** Naive product over must/mustNot clauses (should clauses rank, not gate). */
+        pPerSeed: number;
+        oneIn: number | null;
+        /** The independence assumption is coarse — treat oneIn as an order of magnitude. */
+        errorBand: "±10x";
+        /** pPerSeed × the 35^8 length-8 keyspace motely-wasm batches cover. */
+        expectedMatchesLength8: number;
+    };
+    flags: RarityFlag[];
+}
+export declare function estimateJamlRarity(jaml: string): JamlRarityEstimate;
+/** "1 in ~1.8B" style formatting; p=0 renders as unsatisfiable infinity. */
+export declare function formatOneIn(oneIn: number | null): string;
+/**
+ * Expected seconds to find `targetMatches` seeds at a MEASURED throughput.
+ * Benchmark seedsPerSecond against a real batch on the target hardware first —
+ * browser (WASM SIMD128) and native (AVX-512) rates differ by orders of
+ * magnitude, so this module never supplies a default.
+ */
+export declare function estimateEtaSeconds(pPerSeed: number, seedsPerSecond: number, targetMatches?: number): number;
+/** "≈3d 4h" / "≈12min" style duration formatting for ETA display. */
+export declare function formatEta(seconds: number): string;