@yipe/dice 0.2.16 → 0.2.19

package/dist/{pmf-CYaEbY7m.d.cts → pmf-BC1poIqF.d.cts}

@@ -58,8 +58,29 @@ declare const onPotentCantripOnly: OutcomeType[];
 declare class DiceQuery {
     readonly singles: PMF[];
     readonly combined: PMF;
+    private _combinedWithAttr?;
     constructor(singles: PMF | PMF[], combined?: PMF, eps?: number);
     private static readonly DEFAULT_OUTCOMES;
+    /**
+     * Returns a new PMF with damage attribution metadata populated.
+     *
+     * This method computes attribution on-demand for builder-generated PMFs,
+     * enabling them to work with damage attribution charts. The `attr` field
+     * tracks how much damage each outcome type contributes at each damage value.
+     *
+     * For each bin at damage D: sum(attr.values()) ≈ D × P(damage = D)
+     *
+     * Performance: Cached after first call. Adds minimal overhead vs `combined`.
+     *
+     * @returns PMF with attr field populated for damage attribution charts
+     *
+     * @example
+     * const attack = d20.plus(5).ac(15).onHit(d(2,6).plus(3)).onCrit(d(2,6))
+     * const query = attack.toQuery()
+     * const pmf = query.combinedWithAttribution()
+     * // Now pmf can be used with toDamageAttributionChartSeries()
+     */
+    combinedWithAttribution(): PMF;
     /**
      * Returns the expected damage across all possible outcomes.
      *
@@ -743,6 +764,16 @@ declare class PMF {
         pmf: PMF;
         weight: number;
     } | [PMF, number]>, eps?: number): PMF;
+    /**
+     * Adds damage attribution metadata to this PMF based on existing count metadata.
+     * For each bin, sets attr[outcome] = damage × count[outcome].
+     *
+     * This enables damage attribution charts to work with builder-generated PMFs.
+     * The parser generates attr automatically, but builder PMFs only have count.
+     *
+     * @returns New PMF with attr field populated in each bin
+     */
+    withAttribution(): PMF;
     /**
      * General-purpose N-way mixture.
      * weights: Array of [weight, PMF].

package/dist/{pmf-CYaEbY7m.d.ts → pmf-BC1poIqF.d.ts}

@@ -58,8 +58,29 @@ declare const onPotentCantripOnly: OutcomeType[];
 declare class DiceQuery {
     readonly singles: PMF[];
     readonly combined: PMF;
+    private _combinedWithAttr?;
     constructor(singles: PMF | PMF[], combined?: PMF, eps?: number);
     private static readonly DEFAULT_OUTCOMES;
+    /**
+     * Returns a new PMF with damage attribution metadata populated.
+     *
+     * This method computes attribution on-demand for builder-generated PMFs,
+     * enabling them to work with damage attribution charts. The `attr` field
+     * tracks how much damage each outcome type contributes at each damage value.
+     *
+     * For each bin at damage D: sum(attr.values()) ≈ D × P(damage = D)
+     *
+     * Performance: Cached after first call. Adds minimal overhead vs `combined`.
+     *
+     * @returns PMF with attr field populated for damage attribution charts
+     *
+     * @example
+     * const attack = d20.plus(5).ac(15).onHit(d(2,6).plus(3)).onCrit(d(2,6))
+     * const query = attack.toQuery()
+     * const pmf = query.combinedWithAttribution()
+     * // Now pmf can be used with toDamageAttributionChartSeries()
+     */
+    combinedWithAttribution(): PMF;
     /**
      * Returns the expected damage across all possible outcomes.
      *
@@ -743,6 +764,16 @@ declare class PMF {
         pmf: PMF;
         weight: number;
     } | [PMF, number]>, eps?: number): PMF;
+    /**
+     * Adds damage attribution metadata to this PMF based on existing count metadata.
+     * For each bin, sets attr[outcome] = damage × count[outcome].
+     *
+     * This enables damage attribution charts to work with builder-generated PMFs.
+     * The parser generates attr automatically, but builder PMFs only have count.
+     *
+     * @returns New PMF with attr field populated in each bin
+     */
+    withAttribution(): PMF;
     /**
      * General-purpose N-way mixture.
      * weights: Array of [weight, PMF].

package/package.json

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