@spotlab/range 0.1.0 → 0.3.0

package/README.md

@@ -10,8 +10,13 @@ import { initRange, parseRange, formatRange } from "@spotlab/range";
 await initRange(); // once, at startup; idempotent, returns the same promise
 const hands = parseRange("AKs:0.5,QQ"); // synchronous from here on
 formatRange(hands); // "AKs:0.5,QQ"
+formatRange(parseRange("AA,KK,QQ,A5s-A2s:0.5")); // "QQ+,A5s-A2s:0.5"
 ```
 
+The grammar (hand tokens, combos, suitless combos, `22+` / `TT-77` shorthand)
+and the canonical rendering rules are documented in the
+[`spotlab-range` README](../../crates/spotlab-range#grammar).
+
 ## Why an explicit `initRange()`
 
 Instantiating a wasm module is asynchronous, and top-level `await` is not

package/dist/index.d.ts

@@ -4,8 +4,7 @@ export declare const RANKS: readonly string[];
 export declare const SUITS: readonly string[];
 export declare const COMBOS: readonly string[];
 export { SpotlabInputError, RangeInitError, RangeNotInitializedError, } from './errors.js';
-export { Hand } from './types.js';
-export type { HandFrequency } from './types.js';
+export type { Hand, HandFrequency } from './types.js';
 /** Parse a range string into its expanded hand-keyed form. */
 export declare function parseRange(input: string): HandFrequency[];
 /** Render a hand-keyed range back to its compacted string form. */
@@ -19,5 +18,14 @@ export declare function handsOfCombo(combo: string): Hand[];
  * serializes the underlying Rust map as a JS `Map`, not a plain object.
  */
 export declare function toComboWeights(hands: HandFrequency[]): Map<string, number>;
+/**
+ * Expand per-combo weights to a hand-keyed range: every hand of each combo
+ * takes that combo's weight, and zero-weight combos are dropped. The inverse
+ * of `toComboWeights` — `toComboWeights(expandComboWeights(m))` gives back `m`,
+ * up to float rounding — though not the other way round, since the collapse
+ * averages over a combo's hands. Throws `SpotlabInputError` for a key that
+ * isn't a combo or a weight outside `[0, 1]`, as `parseRange` does.
+ */
+export declare function expandComboWeights(weights: Map<string, number>): HandFrequency[];
 /** Every hand in the deck at weight 1 — the unconstrained range. */
 export declare function fullRange(): HandFrequency[];