@yipe/dice 0.2.1 → 0.2.2

package/dist/{pmf-DIegvlyA.d.cts → pmf-D1p2Re-J.d.cts}

@@ -33,6 +33,14 @@ type DamageDistribution = Record<number, number>;
 /** Canonical outcome labels supported by the query helpers. */
 type OutcomeType = "crit" | "hit" | "missNone" | "missDamage" | "saveHalf" | "saveFail" | "pc";
 type Rounding = "none" | "floor" | "round" | "ceil";
+declare const onAnyHit: OutcomeType[];
+declare const onCritOnly: OutcomeType[];
+declare const onHitOnly: OutcomeType[];
+declare const onMissOnly: OutcomeType[];
+declare const onMissDamageOnly: OutcomeType[];
+declare const onSaveHalfOnly: OutcomeType[];
+declare const onSaveFailOnly: OutcomeType[];
+declare const onPotentCantripOnly: OutcomeType[];
 
 /**
  * Query interface for analyzing dice roll probability distributions.
@@ -705,24 +713,33 @@ declare class PMF {
      *  - A PMF representing its outcome (e.g., damage dice).
      *  - A weight representing its probability of being selected.
      *
-     * This is useful for modeling situations like:
-     *  - Sneak Attack: 6d6 if first hit is a crit, 3d6 if first hit is non-crit, 0 otherwise.
-     *  - Multiple exclusive spells: Fireball vs Cone of Cold vs nothing.
-     *
      * Notes:
-     *  - If the total weight is less than 1, a zero PMF will automatically be added to
-     *    make up the remaining probability.
-     *  - Throws an error if the total weight is greater than 1 (invalid probability sum).
+     *  - If total weight < 1 (within eps), leftover mass is assumed to be PMF.zero()
      *
-     * @param options Array of `{ pmf, weight }` objects, each representing an outcome and its probability.
-     * @param label Optional name for debugging or charting.
-     * @param eps Optional tolerance for floating point rounding
-     * @returns A single PMF representing the exclusive mixture of all options.
+     * @param options Array of `{ pmf, weight }` or `[PMF, number]`.
+     * @param eps Optional tolerance for floating point rounding.
      */
     static exclusive(options: Array<{
         pmf: PMF;
         weight: number;
     } | [PMF, number]>, eps?: number): PMF;
+    /**
+     * PMF.mix()
+     *
+     * Builds a PMF as a linear combination of input PMFs with the given weights.
+     * Unlike `exclusive`, this does NOT:
+     *  - enforce that weights sum to 1
+     *  - add leftover probability to δ0 (PMF.zero())
+     *
+     * Use when outcomes are not mutually exclusive, or for interpolation/blending.
+     *
+     * @param options Array of `{ pmf, weight }` or `[PMF, number]`.
+     * @param eps Optional tolerance for skipping tiny weights.
+     */
+    static mix(options: Array<{
+        pmf: PMF;
+        weight: number;
+    } | [PMF, number]>, eps?: number): PMF;
     /**
      * General-purpose N-way mixture.
      * weights: Array of [weight, PMF].
@@ -881,4 +898,4 @@ declare class PMF {
     query(): DiceQuery;
 }
 
-export { type Bin as B, type DamageDistribution as D, EPS as E, LRUCache as L, type OutcomeLabelMap as O, PMF as P, type Rounding as R, type Snapshot as S, type OutcomeType as a, DiceQuery as b, type OutcomeSnapshot as c, pmfCache as p };
+export { type Bin as B, type DamageDistribution as D, EPS as E, LRUCache as L, type OutcomeLabelMap as O, PMF as P, type Rounding as R, type Snapshot as S, type OutcomeType as a, onCritOnly as b, onHitOnly as c, onMissOnly as d, onMissDamageOnly as e, onSaveHalfOnly as f, onSaveFailOnly as g, onPotentCantripOnly as h, DiceQuery as i, type OutcomeSnapshot as j, onAnyHit as o, pmfCache as p };

package/dist/{pmf-DIegvlyA.d.ts → pmf-D1p2Re-J.d.ts}

@@ -33,6 +33,14 @@ type DamageDistribution = Record<number, number>;
 /** Canonical outcome labels supported by the query helpers. */
 type OutcomeType = "crit" | "hit" | "missNone" | "missDamage" | "saveHalf" | "saveFail" | "pc";
 type Rounding = "none" | "floor" | "round" | "ceil";
+declare const onAnyHit: OutcomeType[];
+declare const onCritOnly: OutcomeType[];
+declare const onHitOnly: OutcomeType[];
+declare const onMissOnly: OutcomeType[];
+declare const onMissDamageOnly: OutcomeType[];
+declare const onSaveHalfOnly: OutcomeType[];
+declare const onSaveFailOnly: OutcomeType[];
+declare const onPotentCantripOnly: OutcomeType[];
 
 /**
  * Query interface for analyzing dice roll probability distributions.
@@ -705,24 +713,33 @@ declare class PMF {
      *  - A PMF representing its outcome (e.g., damage dice).
      *  - A weight representing its probability of being selected.
      *
-     * This is useful for modeling situations like:
-     *  - Sneak Attack: 6d6 if first hit is a crit, 3d6 if first hit is non-crit, 0 otherwise.
-     *  - Multiple exclusive spells: Fireball vs Cone of Cold vs nothing.
-     *
      * Notes:
-     *  - If the total weight is less than 1, a zero PMF will automatically be added to
-     *    make up the remaining probability.
-     *  - Throws an error if the total weight is greater than 1 (invalid probability sum).
+     *  - If total weight < 1 (within eps), leftover mass is assumed to be PMF.zero()
      *
-     * @param options Array of `{ pmf, weight }` objects, each representing an outcome and its probability.
-     * @param label Optional name for debugging or charting.
-     * @param eps Optional tolerance for floating point rounding
-     * @returns A single PMF representing the exclusive mixture of all options.
+     * @param options Array of `{ pmf, weight }` or `[PMF, number]`.
+     * @param eps Optional tolerance for floating point rounding.
      */
     static exclusive(options: Array<{
         pmf: PMF;
         weight: number;
     } | [PMF, number]>, eps?: number): PMF;
+    /**
+     * PMF.mix()
+     *
+     * Builds a PMF as a linear combination of input PMFs with the given weights.
+     * Unlike `exclusive`, this does NOT:
+     *  - enforce that weights sum to 1
+     *  - add leftover probability to δ0 (PMF.zero())
+     *
+     * Use when outcomes are not mutually exclusive, or for interpolation/blending.
+     *
+     * @param options Array of `{ pmf, weight }` or `[PMF, number]`.
+     * @param eps Optional tolerance for skipping tiny weights.
+     */
+    static mix(options: Array<{
+        pmf: PMF;
+        weight: number;
+    } | [PMF, number]>, eps?: number): PMF;
     /**
      * General-purpose N-way mixture.
      * weights: Array of [weight, PMF].
@@ -881,4 +898,4 @@ declare class PMF {
     query(): DiceQuery;
 }
 
-export { type Bin as B, type DamageDistribution as D, EPS as E, LRUCache as L, type OutcomeLabelMap as O, PMF as P, type Rounding as R, type Snapshot as S, type OutcomeType as a, DiceQuery as b, type OutcomeSnapshot as c, pmfCache as p };
+export { type Bin as B, type DamageDistribution as D, EPS as E, LRUCache as L, type OutcomeLabelMap as O, PMF as P, type Rounding as R, type Snapshot as S, type OutcomeType as a, onCritOnly as b, onHitOnly as c, onMissOnly as d, onMissDamageOnly as e, onSaveHalfOnly as f, onSaveFailOnly as g, onPotentCantripOnly as h, DiceQuery as i, type OutcomeSnapshot as j, onAnyHit as o, pmfCache as p };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yipe/dice",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "A high-performance dice probability engine for D&D 5e DPR calculations. Powers dprcalc.com.",
   "keywords": [
     "dnd",