@yipe/dice 0.5.0 → 0.6.0

package/dist/builder/roll.d.ts

@@ -0,0 +1,205 @@
+import type { ACBuilder } from "./ac.js";
+import type { CritConfig } from "../common/types.js";
+import type { DCBuilder } from "./dc.js";
+import type { PMF } from "../pmf/pmf.js";
+import type { DiceQuery } from "../pmf/query.js";
+import { AttackBuilder } from "./attack.js";
+import type { ExpressionNode } from "./nodes.js";
+import type { RollConfig, RollType } from "./types.js";
+export declare const defaultConfig: RollConfig;
+export declare class RollBuilder {
+    protected readonly subRollConfigs: readonly RollConfig[];
+    constructor(countOrConfigs?: number | readonly RollConfig[]);
+    protected create(configs: readonly RollConfig[]): RollBuilder;
+    protected get lastConfig(): RollConfig;
+    hasHiddenState(): boolean;
+    getSubRollConfigs(): readonly RollConfig[];
+    static fromConfig(config: Partial<RollConfig>): RollBuilder;
+    static fromConfigs(configs: Partial<RollConfig>[]): RollBuilder;
+    static fromArgs(...args: any[]): RollBuilder;
+    d(sides: number | undefined): RollBuilder;
+    plus(modOrRoll: number | RollBuilder | undefined): RollBuilder;
+    plus(count: number, die: RollBuilder): RollBuilder;
+    minus(modOrRoll: number | RollBuilder | undefined): RollBuilder;
+    minus(count: number, die: RollBuilder): RollBuilder;
+    /** Apply one-pass reroll threshold (k): reroll faces 1..k once, must keep. */
+    reroll(value: number): RollBuilder;
+    /** Set finite explode count for max-face explosions (Infinity allowed). */
+    explode(count?: number | undefined): RollBuilder;
+    /** Apply per-die minimum value (min > 0). */
+    minimum(val: number | undefined): RollBuilder;
+    bestOf(count: number | undefined): RollBuilder;
+    keepHighest(total: number, count: number): RollBuilder;
+    keepLowest(total: number, count: number): RollBuilder;
+    keepHighestAll(total: number, count: number): PooledRollBuilder;
+    keepLowestAll(total: number, count: number): PooledRollBuilder;
+    withAdvantage(): RollBuilder;
+    withDisadvantage(): RollBuilder;
+    add(anotherRoll: RollBuilder | undefined): RollBuilder;
+    withBonus(anotherRoll: RollBuilder): RollBuilder;
+    addRoll(count?: number): RollBuilder;
+    scaleDice(scale: number): RollBuilder;
+    doubleDice(): RollBuilder;
+    alwaysHits(): AlwaysHitBuilder;
+    alwaysCrits(): AlwaysCritBuilder;
+    copy(): RollBuilder;
+    d4: () => RollBuilder;
+    d6: () => RollBuilder;
+    d8: () => RollBuilder;
+    d10: () => RollBuilder;
+    d12: () => RollBuilder;
+    d20: () => RollBuilder;
+    d100: () => RollBuilder;
+    withElvenAccuracy(): RollBuilder;
+    toExpression(): string;
+    toPMF(eps?: number): PMF;
+    get pmf(): PMF;
+    toQuery(eps?: number): DiceQuery;
+    toAST(): ExpressionNode;
+    private configToSingleExpressionWithoutModifier;
+    getRootDieConfig(): RollConfig | undefined;
+    getAllDieConfigs(): readonly RollConfig[];
+    getBonusDiceConfigs(): RollConfig[];
+    getBonusDicePMFs(check: RollBuilder, eps?: number): PMF[];
+    get modifier(): number;
+    get rollType(): RollType;
+    get baseReroll(): number;
+    half(): HalfRollBuilder;
+    /**
+     * Scale this roll's result by `numerator / denominator`, rounding each outcome.
+     * A general, composable form of {@link half} — used to model damage-type resistance
+     * (`scaleResult(1, 2)` → `(expr) // 2`) and vulnerability (`scaleResult(2)` → `2 * (expr)`).
+     * Compose several of these (and plain rolls) into one payload with {@link sumRolls}.
+     */
+    scaleResult(numerator: number, denominator?: number, rounding?: "floor" | "round" | "ceil"): ScaleRollBuilder;
+    maxOf(count: number): MaxOfRollBuilder;
+    ac(_targetAC: number): ACBuilder;
+    dc(_saveDC: number): DCBuilder;
+}
+export declare class HalfRollBuilder extends RollBuilder {
+    private readonly innerRoll;
+    constructor(innerRoll: RollBuilder);
+    hasHiddenState(): boolean;
+    get lastConfig(): RollConfig;
+    getSubRollConfigs(): readonly RollConfig[];
+    toExpression(): string;
+    toAST(): ExpressionNode;
+    toPMF(eps?: number): PMF;
+    copy(): HalfRollBuilder;
+}
+/**
+ * A roll whose result is scaled by `numerator / denominator` and rounded — the composable
+ * generalization of {@link HalfRollBuilder}. Renders as `N * (inner)`, `(inner) // D`, or
+ * `(inner) * N // D`. Terminal (like `half`): use {@link sumRolls} to combine with other rolls.
+ */
+export declare class ScaleRollBuilder extends RollBuilder {
+    private readonly innerRoll;
+    private readonly numerator;
+    private readonly denominator;
+    private readonly rounding;
+    constructor(innerRoll: RollBuilder, numerator: number, denominator?: number, rounding?: "floor" | "round" | "ceil");
+    hasHiddenState(): boolean;
+    get lastConfig(): RollConfig;
+    getSubRollConfigs(): readonly RollConfig[];
+    toExpression(): string;
+    toAST(): ExpressionNode;
+    toPMF(eps?: number): PMF;
+    copy(): ScaleRollBuilder;
+}
+export declare class MaxOfRollBuilder extends RollBuilder {
+    private readonly innerRoll;
+    private readonly count;
+    private readonly diceCount?;
+    private readonly diceSides?;
+    constructor(innerRoll: RollBuilder, count: number, diceCount?: number | undefined, diceSides?: number | undefined);
+    hasHiddenState(): boolean;
+    get lastConfig(): RollConfig;
+    getSubRollConfigs(): readonly RollConfig[];
+    toExpression(): string;
+    toAST(): ExpressionNode;
+    toPMF(eps?: number): PMF;
+    copy(): MaxOfRollBuilder;
+}
+export declare class AlwaysHitBuilder extends RollBuilder {
+    readonly attackConfig: CritConfig;
+    constructor(baseRoll: RollBuilder, attackConfig?: CritConfig);
+    protected create(configs: readonly RollConfig[]): RollBuilder;
+    onHit(val: number): AttackBuilder;
+    onHit(val: string): AttackBuilder;
+    onHit(val: RollBuilder): AttackBuilder;
+    onHit(count: number, die: RollBuilder): AttackBuilder;
+    onHit(count: number, sides: number): AttackBuilder;
+    onHit(count: number, die: RollBuilder, modifier: number): AttackBuilder;
+    onHit(count: number, sides: number, modifier: number): AttackBuilder;
+    get critThreshold(): number;
+    critOn(critThreshold: number): AlwaysHitBuilder;
+    alwaysCrits(): AlwaysCritBuilder;
+    toExpression(): string;
+    toPMF(): PMF;
+    copy(): AlwaysHitBuilder;
+}
+export declare class AlwaysCritBuilder extends RollBuilder {
+    readonly attackConfig: CritConfig & {
+        ac?: number;
+    };
+    readonly fromAlwaysHit: boolean;
+    constructor(baseRoll: RollBuilder, attackConfig?: CritConfig & {
+        ac?: number;
+    }, fromAlwaysHit?: boolean);
+    protected create(configs: readonly RollConfig[]): RollBuilder;
+    onHit(val: number): AttackBuilder;
+    onHit(val: string): AttackBuilder;
+    onHit(val: RollBuilder): AttackBuilder;
+    onHit(count: number, die: RollBuilder): AttackBuilder;
+    onHit(count: number, sides: number): AttackBuilder;
+    onHit(count: number, die: RollBuilder, modifier: number): AttackBuilder;
+    onHit(count: number, sides: number, modifier: number): AttackBuilder;
+    get critThreshold(): number;
+    critOn(critThreshold: number): AlwaysCritBuilder;
+    toExpression(): string;
+    toPMF(): PMF;
+    copy(): AlwaysCritBuilder;
+}
+export declare class ParsedRollBuilder extends RollBuilder {
+    private readonly cachedPMF;
+    private readonly originalExpression;
+    constructor(expression: string);
+    hasHiddenState(): boolean;
+    protected create(configs: readonly RollConfig[]): RollBuilder;
+    toPMF(_eps?: number): PMF;
+    toExpression(): string;
+    toAST(): ExpressionNode;
+    copy(): ParsedRollBuilder;
+    doubleDice(): ParsedRollBuilder;
+}
+export declare class PooledRollBuilder extends RollBuilder {
+    private readonly baseAST;
+    private readonly baseExpression;
+    constructor(baseAST: ExpressionNode, baseExpression: string, configs?: readonly RollConfig[]);
+    protected create(configs: readonly RollConfig[]): PooledRollBuilder;
+    hasHiddenState(): boolean;
+    d(_sides: number | undefined): RollBuilder;
+    reroll(_value: number): RollBuilder;
+    explode(_count?: number | undefined): RollBuilder;
+    minimum(_val: number | undefined): RollBuilder;
+    bestOf(_count: number | undefined): RollBuilder;
+    keepHighest(_total: number, _count: number): RollBuilder;
+    keepLowest(_total: number, _count: number): RollBuilder;
+    withAdvantage(): RollBuilder;
+    withDisadvantage(): RollBuilder;
+    withElvenAccuracy(): RollBuilder;
+    toAST(): ExpressionNode;
+    toExpression(): string;
+    copy(): PooledRollBuilder;
+    scaleDice(scale: number): RollBuilder;
+    times(count: number): PooledRollBuilder;
+}
+/**
+ * Combine several rolls into one additive payload whose PMF is their convolution and whose
+ * expression is them joined with ` + `. Unlike `a.plus(b)`, this preserves parts that carry
+ * hidden state (e.g. `roll.scaleResult(1, 2)` / `roll.half()`), so per-damage-type resistance
+ * and vulnerability survive into both the distribution and the rendered expression.
+ * Empty parts collapse to `0`; a single part is returned unwrapped.
+ */
+export declare function sumRolls(parts: readonly RollBuilder[]): RollBuilder;
+//# sourceMappingURL=roll.d.ts.map

package/dist/builder/roll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roll.d.ts","sourceRoot":"","sources":["../../src/builder/roll.ts"],"names":[],"mappings":"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"}

package/dist/builder/save.d.ts

@@ -0,0 +1,19 @@
+import { PMF } from "../pmf/pmf.js";
+import type { DiceQuery } from "../pmf/query.js";
+import type { DCBuilder } from "./dc.js";
+import { type RollBuilder } from "./roll.js";
+import type { CheckBuilder, SaveResolution } from "./types.js";
+export type SaveOutcome = "normal" | "half";
+export declare class SaveBuilder implements CheckBuilder {
+    readonly check: DCBuilder;
+    private readonly failureEffect?;
+    private readonly saveOutcome;
+    constructor(check: DCBuilder, failureEffect?: RollBuilder | undefined, saveOutcome?: SaveOutcome);
+    saveHalf(): SaveBuilder;
+    toExpression(): string;
+    resolve(eps?: number): SaveResolution;
+    toPMF(eps?: number): PMF;
+    get pmf(): PMF;
+    toQuery(eps?: number): DiceQuery;
+}
+//# sourceMappingURL=save.d.ts.map

package/dist/builder/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/builder/save.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5C,qBAAa,WAAY,YAAW,YAAY;IAE5C,QAAQ,CAAC,KAAK,EAAE,SAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAH9B,YACW,KAAK,EAAE,SAAS,EACR,aAAa,CAAC,EAAE,WAAW,YAAA,EAC3B,WAAW,GAAE,WAAsB,EAClD;IAEJ,QAAQ,IAAI,WAAW,CAEtB;IAED,YAAY,IAAI,MAAM,CAOrB;IAED,OAAO,CAAC,GAAG,GAAE,MAAY,GAAG,cAAc,CA8BzC;IAGD,KAAK,CAAC,GAAG,GAAE,MAAU,GAAG,GAAG,CAE1B;IAED,IAAI,GAAG,QAEN;IAGD,OAAO,CAAC,GAAG,GAAE,MAAU,GAAG,SAAS,CAElC;CACF"}

package/dist/builder/types.d.ts

@@ -0,0 +1,66 @@
+import type { PMF } from "../pmf/pmf.js";
+import type { RollType } from "../common/types.js";
+import type { RollBuilder } from "./roll.js";
+export type { RollType };
+export type RollFactory = {
+    (count: number, sides?: number, modifier?: number): RollBuilder;
+    (count: number, die: RollBuilder, modifier?: number): RollBuilder;
+    d(sides: number | string): RollBuilder;
+    hd20(): RollBuilder;
+    d4(): RollBuilder;
+    d6(): RollBuilder;
+    d8(): RollBuilder;
+    d10(): RollBuilder;
+    d12(): RollBuilder;
+    d20(): RollBuilder;
+    d100(): RollBuilder;
+    flat(n: number): RollBuilder;
+};
+export type KeepMode = "highest" | "lowest";
+export type RollConfig = {
+    count: number;
+    sides: number;
+    modifier: number;
+    reroll: number;
+    explode: number;
+    minimum: number;
+    bestOf: number;
+    keep: {
+        total: number;
+        count: number;
+        mode: KeepMode;
+    } | undefined;
+    rollType: RollType;
+    isSubtraction?: boolean;
+};
+export type Resolution = {
+    pmf: PMF;
+    check: PMF;
+    weights: {
+        [key: string]: number;
+    };
+};
+export type AttackResolution = Resolution & {
+    hit: PMF;
+    crit: PMF;
+    miss: PMF;
+    weights: {
+        hit: number;
+        crit: number;
+        miss: number;
+    };
+};
+export type SaveResolution = Resolution & {
+    saveFail: PMF;
+    saveSuccess: PMF;
+    weights: {
+        success: number;
+        fail: number;
+    };
+};
+export interface CheckBuilder {
+    resolve(eps?: number): Resolution;
+    toExpression(): string;
+    readonly pmf: PMF;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/builder/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAChE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAClE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACvC,IAAI,IAAI,WAAW,CAAC;IACpB,EAAE,IAAI,WAAW,CAAC;IAClB,EAAE,IAAI,WAAW,CAAC;IAClB,EAAE,IAAI,WAAW,CAAC;IAClB,GAAG,IAAI,WAAW,CAAC;IACnB,GAAG,IAAI,WAAW,CAAC;IACnB,GAAG,IAAI,WAAW,CAAC;IACnB,IAAI,IAAI,WAAW,CAAC;IACpB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAG5C,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG,SAAS,CAAC;IACnE,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG;IAC1C,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC,QAAQ,EAAE,GAAG,CAAC;IACd,WAAW,EAAE,GAAG,CAAC;IACjB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAClC,YAAY,IAAI,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACnB"}

package/dist/common/bounce.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Bounce odds — the "birthday problem" for bouncing damage dice (e.g. Chromatic
+ * Orb): the probability that at least two of K dice with S faces show the same
+ * value, which is what lets the spell jump to another target.
+ *
+ * Accounts for two modifiers:
+ * - **Elemental Adept** (`minimumDieRoll >= 2`): rolls below the minimum are
+ *   bumped up to it, collapsing the low faces onto a single heavier value.
+ * - **Empowered Spell** (`rerollDamageDice > 0`): a number of dice may be
+ *   rerolled once, giving a second chance at a match.
+ *
+ * The base and Elemental-Adept cases are computed exactly (see
+ * {@link pAllDistinct}); the Empowered-Spell reroll is an explicit model layered
+ * on the exact base match probability.
+ */
+/** Options that modify bounce odds via metamagic / feats. */
+export interface BounceOddsOptions {
+    /** Minimum die roll — e.g. 2 for Elemental Adept, 3 for Great Weapon Fighting 2024. */
+    minimumDieRoll?: number;
+    /** Number of dice that may be rerolled once — e.g. CHA modifier for Empowered Spell. */
+    rerollDamageDice?: number;
+}
+/**
+ * P(at least two of `diceCount` dice with `dieFaces` faces match), honoring
+ * Elemental Adept and Empowered Spell. Returns a probability in [0, 1].
+ *
+ * @param diceCount Number of dice rolled.
+ * @param dieFaces Faces per die (e.g. 8 for d8).
+ * @param options Optional metamagic / feat modifiers.
+ */
+export declare function calculateBounceOdds(diceCount: number, dieFaces: number, options?: BounceOddsOptions): number;
+//# sourceMappingURL=bounce.d.ts.map

package/dist/common/bounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounce.d.ts","sourceRoot":"","sources":["../../src/common/bounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAuDD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAgCR"}

package/dist/common/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Error thrown when a dice expression cannot be parsed.
+ *
+ * Extends the built-in {@link Error}, so existing `catch (e)` / message checks
+ * continue to work, while callers can now narrow with `instanceof DiceParseError`.
+ *
+ * @example
+ * try {
+ *   parse("d6@3");
+ * } catch (e) {
+ *   if (e instanceof DiceParseError) {
+ *     // e.expression === "d6@3"
+ *   }
+ * }
+ */
+export declare class DiceParseError extends Error {
+    /** The original expression that failed to parse, when available. */
+    readonly expression?: string;
+    /** The underlying error that triggered this one, when available. */
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        expression?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/common/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/common/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEzB,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAQnD;CACF"}

package/dist/common/lru-cache.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Simple LRU cache implementation
+ */
+export declare class LRUCache<K, V> {
+    private readonly maxSize;
+    private cache;
+    constructor(maxSize?: number);
+    get(key: K): V | undefined;
+    delete(key: K): void;
+    set(key: K, value: V): this;
+    clear(): void;
+    get size(): number;
+    has(key: K): boolean;
+    keys(): IterableIterator<K>;
+    values(): IterableIterator<V>;
+}
+//# sourceMappingURL=lru-cache.d.ts.map

package/dist/common/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../src/common/lru-cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IAGZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,KAAK,CAAmB;IAEhC,YAA6B,OAAO,SAAO,EAAI;IAE/C,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAOzB;IAED,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAEnB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAQ1B;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAEnB;IAED,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAE1B;IAED,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAE5B;CACF"}

package/dist/common/types.d.ts

@@ -0,0 +1,65 @@
+/** Mapping from outcome label to probability mass or damage attribution. */
+export type OutcomeLabelMap = Partial<Record<string, number>>;
+/** Computational epsilon for pruning negligible probabilities. */
+export declare const EPS = 1e-12;
+/** A probability bin for a specific damage value. */
+export interface Bin {
+    /** Total probability mass at this damage value. */
+    p: number;
+    /** Per-outcome probability mass contributions at this damage. */
+    count: OutcomeLabelMap;
+    /** Optional per-outcome damage attribution at this damage. */
+    attr?: OutcomeLabelMap;
+}
+export interface CritConfig {
+    critThreshold: number;
+}
+/** Simple mapping from damage value to probability. */
+export type DamageDistribution = Record<number, number>;
+/** Canonical outcome labels supported by the query helpers. */
+export type OutcomeType = "crit" | "hit" | "missNone" | "missDamage" | "saveHalf" | "saveFail" | "pc";
+export type Rounding = "none" | "floor" | "round" | "ceil";
+/** How a d20 attack roll resolves: single die, keep-highest of 2/3, or keep-lowest of 2. */
+export type RollType = "flat" | "advantage" | "disadvantage" | "elven accuracy";
+/**
+ * P(critical hit) for the given crit window and d20 {@link RollType}.
+ *
+ * `critRange` is the number of top faces that crit (1 for a natural 20, 2 for
+ * 19–20, …), so a single die crits with probability `critRange / 20`. Advantage
+ * rolls two d20s / elven accuracy three, keeping the best; disadvantage keeps
+ * the worst of two.
+ */
+export declare function critProbability(critRange: number, rollType?: RollType): number;
+/**
+ * The canonical "clean miss" outcome — a point of zero damage with no rider.
+ * This is the {@link OutcomeType} that attribution charts and outcome stats key
+ * on, and is distinct from the builder's attack-resolution `miss` weight label.
+ */
+export declare const MISS_NONE_OUTCOME: OutcomeType;
+/**
+ * All outcome types in canonical severity order — clean miss → crit. This is
+ * also the natural stacking order for attribution charts (least- to
+ * most-impactful, bottom → top). Enumerates every {@link OutcomeType} exactly
+ * once; use it instead of hand-maintained per-consumer outcome tables.
+ */
+export declare const ALL_OUTCOME_TYPES: OutcomeType[];
+/**
+ * Outcome types in display order for stats / breakdown rows — most prominent
+ * first (crit, hit, …) down to the clean miss.
+ */
+export declare const OUTCOME_DISPLAY_ORDER: OutcomeType[];
+/**
+ * Sort outcome labels by a canonical order (defaults to {@link ALL_OUTCOME_TYPES}).
+ * Labels not present in `order` sort after known ones, alphabetically — so
+ * ad-hoc/test labels outside the {@link OutcomeType} union stay stable.
+ */
+export declare function sortOutcomes<T extends string>(outcomes: Iterable<T>, order?: readonly string[]): T[];
+export declare const onAnyHit: OutcomeType[];
+export declare const onCritOnly: OutcomeType[];
+export declare const onHitOnly: OutcomeType[];
+export declare const onMissOnly: OutcomeType[];
+export declare const onMissDamageOnly: OutcomeType[];
+export declare const onSaveHalfOnly: OutcomeType[];
+export declare const onSaveFailOnly: OutcomeType[];
+export declare const onPotentCantripOnly: OutcomeType[];
+//# sourceMappingURL=types.d.ts.map

package/dist/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9D,kEAAkE;AAClE,eAAO,MAAM,GAAG,QAAQ,CAAC;AAEzB,qDAAqD;AACrD,MAAM,WAAW,GAAG;IAClB,mDAAmD;IACnD,CAAC,EAAE,MAAM,CAAC;IACV,iEAAiE;IACjE,KAAK,EAAE,eAAe,CAAC;IACvB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxD,+DAA+D;AAC/D,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,KAAK,GACL,UAAU,GACV,YAAY,GACZ,UAAU,GACV,UAAU,GACV,IAAI,CAAC;AAET,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D,4FAA4F;AAC5F,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEhF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAiB,GAAG,MAAM,CAatF;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAwB,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAQ1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,EAQ9C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,KAAK,GAAE,SAAS,MAAM,EAAsB,GAC3C,CAAC,EAAE,CAUL;AAED,eAAO,MAAM,QAAQ,EAAE,WAAW,EAAoB,CAAC;AACvD,eAAO,MAAM,UAAU,EAAE,WAAW,EAAa,CAAC;AAClD,eAAO,MAAM,SAAS,EAAE,WAAW,EAAY,CAAC;AAChD,eAAO,MAAM,UAAU,EAAE,WAAW,EAA+B,CAAC;AACpE,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAAmB,CAAC;AAC9D,eAAO,MAAM,cAAc,EAAE,WAAW,EAAiB,CAAC;AAC1D,eAAO,MAAM,cAAc,EAAE,WAAW,EAAiB,CAAC;AAC1D,eAAO,MAAM,mBAAmB,EAAE,WAAW,EAAW,CAAC"}

package/dist/index.d.ts

@@ -1,111 +1,9 @@
-import { P as PMF } from './pmf-D5VRghZI.js';
-export { A as ALL_OUTCOME_TYPES, B as Bin, C as CritConfig, D as DamageDistribution, l as DiceQuery, E as EPS, L as LRUCache, M as MISS_NONE_OUTCOME, d as OUTCOME_DISPLAY_ORDER, O as OutcomeLabelMap, m as OutcomeSnapshot, a as OutcomeType, b as RollType, R as Rounding, S as Snapshot, c as critProbability, o as onAnyHit, e as onCritOnly, f as onHitOnly, h as onMissDamageOnly, g as onMissOnly, k as onPotentCantripOnly, j as onSaveFailOnly, i as onSaveHalfOnly, p as pmfCache, s as sortOutcomes } from './pmf-D5VRghZI.js';
-
-/**
- * Bounce odds — the "birthday problem" for bouncing damage dice (e.g. Chromatic
- * Orb): the probability that at least two of K dice with S faces show the same
- * value, which is what lets the spell jump to another target.
- *
- * Accounts for two modifiers:
- * - **Elemental Adept** (`minimumDieRoll >= 2`): rolls below the minimum are
- *   bumped up to it, collapsing the low faces onto a single heavier value.
- * - **Empowered Spell** (`rerollDamageDice > 0`): a number of dice may be
- *   rerolled once, giving a second chance at a match.
- *
- * The base and Elemental-Adept cases are computed exactly (see
- * {@link pAllDistinct}); the Empowered-Spell reroll is an explicit model layered
- * on the exact base match probability.
- */
-/** Options that modify bounce odds via metamagic / feats. */
-interface BounceOddsOptions {
-    /** Minimum die roll — e.g. 2 for Elemental Adept, 3 for Great Weapon Fighting 2024. */
-    minimumDieRoll?: number;
-    /** Number of dice that may be rerolled once — e.g. CHA modifier for Empowered Spell. */
-    rerollDamageDice?: number;
-}
-/**
- * P(at least two of `diceCount` dice with `dieFaces` faces match), honoring
- * Elemental Adept and Empowered Spell. Returns a probability in [0, 1].
- *
- * @param diceCount Number of dice rolled.
- * @param dieFaces Faces per die (e.g. 8 for d8).
- * @param options Optional metamagic / feat modifiers.
- */
-declare function calculateBounceOdds(diceCount: number, dieFaces: number, options?: BounceOddsOptions): number;
-
-/**
- * Error thrown when a dice expression cannot be parsed.
- *
- * Extends the built-in {@link Error}, so existing `catch (e)` / message checks
- * continue to work, while callers can now narrow with `instanceof DiceParseError`.
- *
- * @example
- * try {
- *   parse("d6@3");
- * } catch (e) {
- *   if (e instanceof DiceParseError) {
- *     // e.expression === "d6@3"
- *   }
- * }
- */
-declare class DiceParseError extends Error {
-    /** The original expression that failed to parse, when available. */
-    readonly expression?: string;
-    /** The underlying error that triggered this one, when available. */
-    readonly cause?: unknown;
-    constructor(message: string, options?: {
-        expression?: string;
-        cause?: unknown;
-    });
-}
-
-/** Enable or disable the internal parse cache. */
-declare function setCachingEnabled(enabled: boolean): void;
-/** Returns whether the internal parse cache is currently enabled. */
-declare function getCachingEnabled(): boolean;
-/** Clears the internal parse cache. */
-declare function clearParserCache(): void;
-/**
- * Parse a dice expression into a PMF.
- *
- * - Expression is case-insensitive and ignores spaces.
- */
-declare function parse(expression: string, n?: number): PMF;
-
-/** A labeled mixture builder that preserves provenance in Bin.count. */
-declare class Mixture<L extends string = string> {
-    private readonly totals;
-    private readonly labelMass;
-    private readonly eps;
-    constructor(eps?: number);
-    /** Remove all accumulated state. */
-    clear(): this;
-    /** Number of distinct outcome values currently accumulated. */
-    size(): number;
-    /** Whether a label was ever added. */
-    hasLabel(label: L): boolean;
-    /**
-     * Add a labeled component with a mixture weight.
-     * Weight can be any positive finite number. Very small contributions are pruned by eps.
-     */
-    add(label: L, pmf: PMF, weight?: number): this;
-    buildPMF(eps?: number): PMF;
-    /**
-     * Produce normalized *per-label* PMFs (labels independent).
-     * These are unlabeled PMFs built from the raw mass of that label alone.
-     */
-    byOutcome(): Record<L, PMF>;
-    /**
-     * Mixture weights per label, normalized to sum to 1 over labels that appeared.
-     * Uses raw mass before per-outcome normalization.
-     */
-    weights(): Record<L, number>;
-    toJSON(): {
-        totals: Array<[number, number]>;
-        labels: Array<[number, Record<L, number>]>;
-        eps: number;
-    };
-    static mix<L extends string = string>(items: Array<[label: L, pmf: PMF, weight: number]>, eps?: number): PMF;
-}
-
-export { type BounceOddsOptions, DiceParseError, Mixture, PMF, calculateBounceOdds, clearParserCache, getCachingEnabled, parse, setCachingEnabled };
+export * from "./common/bounce.js";
+export * from "./common/errors.js";
+export * from "./common/lru-cache.js";
+export * from "./common/types.js";
+export * from "./parser/parser.js";
+export * from "./pmf/mixture.js";
+export * from "./pmf/pmf.js";
+export * from "./pmf/query.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}