@yipe/dice 0.5.0 → 0.6.0

package/dist/builder/ac.d.ts

@@ -0,0 +1,25 @@
+import { PMF } from "../pmf/pmf.js";
+import { AttackBuilder } from "./attack.js";
+import { AlwaysCritBuilder, RollBuilder } from "./roll.js";
+export interface AttackConfig {
+    ac: number;
+    critThreshold: number;
+}
+export declare class ACBuilder extends RollBuilder {
+    readonly attackConfig: AttackConfig;
+    constructor(baseRoll: RollBuilder, ac: number, attackConfig?: AttackConfig);
+    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(threshold: number): ACBuilder;
+    alwaysCrits(): AlwaysCritBuilder;
+    toExpression(): string;
+    toPMF(eps?: number): PMF;
+    copy(): ACBuilder;
+}
+//# sourceMappingURL=ac.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ac.d.ts","sourceRoot":"","sources":["../../src/builder/ac.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AACD,qBAAa,SAAU,SAAQ,WAAW;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC,YAAY,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,EAQzE;IAMD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IAClC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IAClC,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC;IACtD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IACnD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IACxE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IAMrE,IAAI,aAAa,IAAI,MAAM,CAE1B;IAGD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAMnC;IAED,WAAW,IAAI,iBAAiB,CAS/B;IAGQ,YAAY,IAAI,MAAM,CAM9B;IAEQ,KAAK,CAAC,GAAG,GAAE,MAAU,GAAG,GAAG,CA0BnC;IAEQ,IAAI,IAAI,SAAS,CAOzB;CACF"}

package/dist/builder/ast.d.ts

@@ -0,0 +1,9 @@
+import { PMF } from "../.js";
+import type { ExpressionNode } from "./nodes.js";
+import type { RollBuilder } from "./roll.js";
+import type { RollConfig } from "./types.js";
+export declare function astFromRollConfigs(configs: readonly RollConfig[]): ExpressionNode | undefined;
+export declare function resolve(node: ExpressionNode, eps?: number): PMF;
+export declare function pmfFromRollBuilder(rb: RollBuilder, eps?: number): PMF;
+export declare function getASTSignature(node: ExpressionNode): string;
+//# sourceMappingURL=ast.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/builder/ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAAE,MAAM,KAAK,CAAC;AAGpC,OAAO,KAAK,EAKV,cAAc,EAIf,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAO1C,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,cAAc,GAAG,SAAS,CAqH5B;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,GAAE,MAAmB,GAAG,GAAG,CAyF3E;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,WAAW,EACf,GAAG,GAAE,MAAmB,GACvB,GAAG,CAGL;AAsUD,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAsD5D"}

package/dist/builder/attack.d.ts

@@ -0,0 +1,41 @@
+import { PMF } from "../pmf/pmf.js";
+import type { DiceQuery } from "../pmf/query.js";
+import type { ACBuilder } from "./ac.js";
+import { AlwaysCritBuilder, AlwaysHitBuilder, RollBuilder } from "./roll.js";
+import type { AttackResolution, CheckBuilder } from "./types.js";
+type ActionEffect = RollBuilder;
+export declare class AttackBuilder implements CheckBuilder {
+    readonly check: ACBuilder | AlwaysHitBuilder | AlwaysCritBuilder;
+    private readonly hitEffect?;
+    private readonly critEffect?;
+    private readonly missEffect?;
+    constructor(check: ACBuilder | AlwaysHitBuilder | AlwaysCritBuilder, hitEffect?: ActionEffect | undefined, critEffect?: ActionEffect | null | undefined, missEffect?: ActionEffect | undefined);
+    onCrit(val: number): AttackBuilder;
+    onCrit(val: string): AttackBuilder;
+    onCrit(val: RollBuilder): AttackBuilder;
+    onCrit(count: number, die: RollBuilder): AttackBuilder;
+    onCrit(count: number, sides: number): AttackBuilder;
+    onCrit(count: number, die: RollBuilder, modifier: number): AttackBuilder;
+    onCrit(count: number, sides: number, modifier: number): AttackBuilder;
+    onMiss(val: number): AttackBuilder;
+    onMiss(val: string): AttackBuilder;
+    onMiss(val: RollBuilder): AttackBuilder;
+    onMiss(count: number, die: RollBuilder): AttackBuilder;
+    onMiss(count: number, sides: number): AttackBuilder;
+    onMiss(count: number, die: RollBuilder, modifier: number): AttackBuilder;
+    onMiss(count: number, sides: number, modifier: number): AttackBuilder;
+    noCrit(): AttackBuilder;
+    toExpression(): string;
+    resolveProbabilities(check: ACBuilder | AlwaysHitBuilder | AlwaysCritBuilder, eps?: number): {
+        pSuccess: number;
+        pHit: number;
+        pCrit: number;
+        pMiss: number;
+    };
+    resolve(eps?: number): AttackResolution;
+    toPMF(eps?: number): PMF;
+    get pmf(): PMF;
+    toQuery(eps?: number): DiceQuery;
+}
+export {};
+//# sourceMappingURL=attack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attack.d.ts","sourceRoot":"","sources":["../../src/builder/attack.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAGtC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAEhB,WAAW,EACZ,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9D,KAAK,YAAY,GAAG,WAAW,CAAC;AAEhC,qBAAa,aAAc,YAAW,YAAY;IAE9C,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAJ9B,YACW,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,EAC/C,SAAS,CAAC,EAAE,YAAY,YAAA,EACxB,UAAU,CAAC,EAAE,YAAY,GAAG,IAAI,YAAA,EAChC,UAAU,CAAC,EAAE,YAAY,YAAA,EACxC;IAEJ,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IAWtE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IAWtE,MAAM,IAAI,aAAa,CAEtB;IAGD,YAAY,IAAI,MAAM,CA+CrB;IAED,oBAAoB,CAClB,KAAK,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,EACvD,GAAG,GAAE,MAAU,GACd;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAmGlE;IAED,OAAO,CAAC,GAAG,GAAE,MAAY,GAAG,gBAAgB,CA+D3C;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/d20.d.ts

@@ -0,0 +1,6 @@
+import { PMF } from "../.js";
+import type { RollType } from "./types.js";
+/** Lift a single d20 PMF into advantage, disadvantage, or elven (triple-advantage). */
+export declare function d20RollPMF(rollType: RollType | undefined, rerollOne?: boolean): PMF;
+export declare function d20PMF(rerollOne: boolean): PMF;
+//# sourceMappingURL=d20.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"d20.d.ts","sourceRoot":"","sources":["../../src/builder/d20.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,GAAG,EAAY,MAAM,KAAK,CAAC;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAaxC,uFAAuF;AACvF,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,SAAS,GAAE,OAAe,GACzB,GAAG,CAqCL;AAED,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,GAAG,CAoB9C"}

package/dist/builder/dc.d.ts

@@ -0,0 +1,26 @@
+import { PMF } from "../pmf/pmf.js";
+import { RollBuilder } from "./roll.js";
+import { SaveBuilder } from "./save.js";
+interface SaveConfig {
+    dc: number;
+}
+export declare class DCBuilder extends RollBuilder {
+    private readonly saveConfig;
+    constructor(baseRoll: RollBuilder, saveConfig?: SaveConfig);
+    dc(saveDC: number): DCBuilder;
+    get saveDC(): number;
+    add(anotherRoll: RollBuilder): DCBuilder;
+    addRoll(count?: number): DCBuilder;
+    onSaveFailure(val: number): SaveBuilder;
+    onSaveFailure(val: string): SaveBuilder;
+    onSaveFailure(val: RollBuilder): SaveBuilder;
+    onSaveFailure(count: number, die: RollBuilder): SaveBuilder;
+    onSaveFailure(count: number, sides: number): SaveBuilder;
+    onSaveFailure(count: number, die: RollBuilder, modifier: number): SaveBuilder;
+    onSaveFailure(count: number, sides: number, modifier: number): SaveBuilder;
+    withElvenAccuracy(): never;
+    toExpression(): string;
+    toPMF(eps?: number): PMF;
+}
+export {};
+//# sourceMappingURL=dc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dc.d.ts","sourceRoot":"","sources":["../../src/builder/dc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,YAAY,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,UAAU,EAGzD;IAEQ,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAOrC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEQ,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAGhD;IAEQ,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAG1C;IAED,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;IACxC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;IACxC,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,WAAW,CAAC;IAC5D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IACzD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9E,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;IAMlE,iBAAiB,IAAI,KAAK,CAIlC;IAGQ,YAAY,IAAI,MAAM,CAK9B;IAEQ,KAAK,CAAC,GAAG,GAAE,MAAU,GAAG,GAAG,CA2BnC;CACF"}

package/dist/builder/example.d.ts

@@ -0,0 +1,356 @@
+import "./ac.js";
+import type { ACBuilder } from "./ac.js";
+import "./dc.js";
+import type { DCBuilder } from "./dc.js";
+import type { RollBuilder } from "./roll.js";
+import type { SaveBuilder } from "./save.js";
+export declare const fullAttack: import("./attack.js").AttackBuilder;
+export declare const fullAttackExprExpected = "(d20 + 5 AC 10) * (2d6) crit (4d6)";
+export declare const fullAttackWithCrit: import("./attack.js").AttackBuilder;
+export declare const fullAttackWithCritExprExpected = "(d20 + 5 AC 10) * (2d6) crit (5d6)";
+export declare const fullAttackWithCritAndMiss: import("./attack.js").AttackBuilder;
+export declare const fullAttackWithCritAndMissExprExpected = "(d20 + 5 AC 10) * (2d6) crit (4d6) miss (5)";
+export declare const basicDamageRoll: RollBuilder;
+export declare const basicDamageRollExprExpected = "1d6 + 3";
+/** Basic 2d6 + 3 damage roll
+ * For multiple dice, you need to use roll().
+ */
+export declare const basic2d6Plus3: RollBuilder;
+export declare const basic2d6Plus3ExprExpected = "2d6 + 3";
+/** Rollling 2 x (1d6+3) */
+export declare const basicShorthandD6Plus3Roll: RollBuilder;
+export declare const basicShorthandD6Plus3RollExprExpected = "2d6 + 6";
+/** Same as above using no shorthand */
+export declare const another2d6Plus3: RollBuilder;
+export declare const another2d6Plus3ExprExpected = "2d6 + 3";
+/** Same as above using the shorthand factory signature */
+export declare const basicShorthandRoll: RollBuilder;
+export declare const basicShorthandRollExprExpected = "2d6 + 3";
+/** Same as above using the shorthand factory signature */
+export declare const basicShorthandD6Roll: RollBuilder;
+export declare const basicShorthandD6RollExprExpected = "2d6 + 3";
+/** Using die shortcuts without roll() */
+export declare const shortcutDie: RollBuilder;
+export declare const shortcutDieExprExpected = "1d8 + 2";
+/** Flat modifier only (no dice)
+ * You can also use roll.flat(n) if you prefer.
+ * Many methods take pure numbers, so this may not even be needed in many cases.
+ * */
+export declare const flatFive: RollBuilder;
+export declare const flatFiveExprExpected = "5";
+/** Negative base dice */
+export declare const negativeBaseDieInline: RollBuilder;
+export declare const negativeBaseDieInlineExprExpected = "-1d8";
+/** Negative base dice explicit */
+export declare const negativeBaseDie: RollBuilder;
+export declare const negativeBaseDieExprExpected = "-1d8";
+/** Subtracting a bonus die via negative roll part.
+ * Useful for effects like Bane
+ */
+export declare const subtractBonusDie: RollBuilder;
+export declare const subtractBonusDieExprExpected = "d20 - 1d4";
+/** A single d20 roll */
+export declare const singleD20: RollBuilder;
+export declare const singleD20ExprExpected = "d20";
+/** Adding a bunch */
+export declare const addAWholeBunch: RollBuilder;
+export declare const addAWholeBunchExprExpected = "1d20 + 1d12 + 1d10 + 1d8 + 1d6";
+/** Subtracting a bunch */
+export declare const subtractAWholeBunch: RollBuilder;
+export declare const subtractAWholeBunchExprExpected = "-1d20 - 1d12 - 1d10 - 1d8 + 1d6";
+export declare const addingMultipleConstants: RollBuilder;
+export declare const addingMultipleConstantsExprExpected = "1d6 + 6";
+export declare const realisticChaining: RollBuilder;
+export declare const realisticChainingExprExpected = "2d8 + 3d6 + 4";
+/** Halfling die using the `roll.hd20()` shorthand */
+export declare const halflingD20Shorthand: RollBuilder;
+export declare const halflingD20ShorthandExprExpected = "hd20";
+/** Halfling die shorthand: d20 reroll 1. */
+export declare const halflingD20: RollBuilder;
+export declare const halflingD20ExprExpected = "hd20";
+/** Halfling die with advantage. */
+export declare const halflingAdv: RollBuilder;
+export declare const halflingAdvExprExpected = "hd20 > hd20";
+/** Reroll 1s and 2s on 2d6. */
+export declare const twoD6Reroll12: RollBuilder;
+export declare const twoD6Reroll12ExprExpected = "2(d6 reroll 1 reroll 2)";
+/** Minimum 2 on a d6. */
+export declare const min2OnD6: RollBuilder;
+export declare const min2OnD6ExprExpected = "2>d6";
+/** Keep highest 3 of 4d6. */
+export declare const kh3Of4d6: RollBuilder;
+export declare const kh3Of4d6ExprExpected = "4kh3(4d6)";
+/** Keep lowest 2 of 4d8. */
+export declare const kl2Of4d8: RollBuilder;
+export declare const kl2Of4d8ExprExpected = "4kl2(4d8)";
+/** Advantage on d20. */
+export declare const advD20: RollBuilder;
+export declare const advD20ExprExpected = "d20 > d20";
+/** Disadvantage on d20. */
+export declare const disD20: RollBuilder;
+export declare const disD20ExprExpected = "d20 < d20";
+/** Advantage on hd20. */
+export declare const advHd20: RollBuilder;
+export declare const advHd20ExprExpected = "hd20 > hd20";
+/** Complex chain: 2d6 + 1d8 + 4(d4 reroll 1) + 5
+ * Note that reroll(1) applies to the immediate roll before it.
+ */
+export declare const complexDamage: RollBuilder;
+export declare const complexDamageExprExpected = "4(d4 reroll 1) + 1d8 + 2d6 + 5";
+/** Double dice (useful for crit damage duplication) */
+export declare const doubledD8: RollBuilder;
+export declare const doubledD8ExprExpected = "2d8 + 5";
+/**
+ * Best-of example.
+ * Roll a set of dice and take the highest N dice rolls.
+ */
+export declare const bestOfExample: RollBuilder;
+export declare const bestOfExampleExprExpected = "4d6kh3";
+/** Double a d6 roll, resulting in 2d6. */
+export declare const doubleD6: RollBuilder;
+export declare const doubleD6ExprExpected = "2d6";
+/** Double a d6+1 roll, resulting in 2d6+2. Note that modifiers are also doubled. */
+export declare const doubleD6Plus1: RollBuilder;
+export declare const doubleD6Plus1ExprExpected = "2d6 + 2";
+/** Double a 2d6 roll, resulting in 4d6. */
+export declare const double2d6: RollBuilder;
+export declare const double2d6ExprExpected = "4d6";
+/** Double a 2d6+3 roll, resulting in 4d6+6. */
+export declare const double2d6plus3: RollBuilder;
+export declare const double2d6plus3ExprExpected = "4d6 + 6";
+/** Triple a complex roll of 1d8+1d4+2, resulting in 3d8+3d4+6. */
+export declare const tripleComplexRoll: RollBuilder;
+export declare const tripleComplexRollExprExpected = "3d8 + 3d4 + 6";
+/**
+ * Basic attack check: d20 + 7 vs AC 15.
+ * Returns an ACBuilder; use `onHit()` to attach damage.
+ */
+export declare const basicAttackCheck: ACBuilder;
+export declare const basicAttackCheckExprExpected = "(d20 + 7 AC 15)";
+/** Attack with bless (bonus-to-hit via 1d4). */
+export declare const blessedAttack: ACBuilder;
+export declare const blessedAttackExprExpected = "(d20 + 7 + 1d4 AC 15)";
+/** Elven Accuracy (3d20 keep highest) attack to-hit. */
+export declare const elvenAccuracyAttack: ACBuilder;
+export declare const elvenAccuracyAttackExprExpected = "(d20 > d20 > d20 + 8 AC 18)";
+/**
+ * Full attack: to-hit check multiplied by effects.
+ * - Hit: 2d6 + 4
+ * - Crit: default doubling of hit dice if not explicitly provided
+ */
+export declare const basicAttack: ReturnType<ACBuilder["onHit"]>;
+export declare const basicAttackExprExpected = "(d20 + 6 AC 16) * (2d6 + 4) crit (4d6 + 4)";
+/** Attack with explicit crit and miss effects; crits on 19–20. */
+export declare const detailedAttack: ReturnType<ACBuilder["onHit"]>;
+export declare const detailedAttackExprExpected = "(d20 + 9 AC 17) * (1d12 + 5) xcrit2 (2d12 + 5) miss (0)";
+/** Attack where all hits become crits (natural 1s still miss). */
+export declare const alwaysCritsAttack: ReturnType<ACBuilder["onHit"]>;
+export declare const alwaysCritsAttackExprExpected = "d20 + 5 * (1d8) crit (2d8)";
+/** Attack that always hits and always crits (no misses at all). */
+export declare const alwaysHitsAlwaysCrits: ReturnType<ACBuilder["onHit"]>;
+export declare const alwaysHitsAlwaysCritsExprExpected = "d20 * (1d8) crit (2d8)";
+/**
+ * Basic save: d20 + 5 vs DC 15; on failure, take 3d6.
+ * Use `saveHalf()` to apply half damage on success.
+ */
+export declare const basicSaveCheck: DCBuilder;
+export declare const basicSaveCheckExprExpected = "(d20 + 5 DC 15)";
+/** Save with failure effect (no half on success). */
+export declare const saveFailOnly: SaveBuilder;
+export declare const saveFailOnlyExprExpected = "(d20 + 5 DC 15) * (3d6)";
+/** Save that deals half damage on success. */
+export declare const saveHalf: SaveBuilder;
+export declare const saveHalfExprExpected = "(d20 + 5 DC 15) * (3d6) save half";
+/** Save at disadvantage (apply before turning into DC builder). */
+export declare const disadvantagedSave: DCBuilder;
+export declare const disadvantagedSaveExprExpected = "(d20 < d20 DC 14)";
+/** Example of resolving save PMFs and weights from structured computation. */
+export declare function resolveSaveExample(): {
+    pmfMean: number;
+    weights: {
+        [key: string]: number;
+    } & {
+        success: number;
+        fail: number;
+    };
+};
+export declare const factoryOverload: RollBuilder;
+export declare const factoryOverloadExprExpected = "4d4 + 1";
+export declare function analyzeRoll(builder: RollBuilder, threshold?: number): {
+    expr: string;
+    min: number;
+    max: number;
+    mean: number;
+    pAtLeastThreshold: number;
+};
+/**
+ * Summarizes a single attack using DiceQuery utilities.
+ * Returns DPR, hit/crit odds, and per-outcome damage stats.
+ */
+export declare function analyzeAttack(attack: ReturnType<ACBuilder["onHit"]>): {
+    expr: string;
+    dpr: number;
+    pNonCritHit: number;
+    pCrit: number;
+    pHitOrCrit: number;
+    hitDamage: {
+        min: number;
+        max: number;
+        avg: number;
+        count: number;
+    };
+    critDamage: {
+        min: number;
+        max: number;
+        avg: number;
+        count: number;
+    };
+};
+/**
+ * Compares three variants of the same attack: disadvantage, normal, advantage.
+ */
+export declare function compareAdvantageStates(baseToHit: number, ac: number, damage: RollBuilder): {
+    normal: {
+        dpr: number;
+        pHitOrCrit: number;
+        pCrit: number;
+    };
+    advantage: {
+        dpr: number;
+        pHitOrCrit: number;
+        pCrit: number;
+    };
+    disadvantage: {
+        dpr: number;
+        pHitOrCrit: number;
+        pCrit: number;
+    };
+};
+/**
+ * Demonstrates multi-attack aggregation (e.g., two swings) with combined DPR and crit odds.
+ */
+export declare function analyzeTwoAttacks(attack: ReturnType<ACBuilder["onHit"]>): {
+    expr: string;
+    attacks: number;
+    dpr: number;
+    pAtLeastOneCrit: number;
+    pAtLeastOneHitOrCrit: number;
+};
+/**
+ * Compares a blessed attack (bonus-to-hit d4) to the same attack without bless.
+ */
+export declare function blessWhatIf(baseToHit: number, ac: number, damage: RollBuilder): {
+    normal: {
+        dpr: number;
+        pHitOrCrit: number;
+    };
+    blessed: {
+        dpr: number;
+        pHitOrCrit: number;
+    };
+    lift: {
+        dpr: number;
+        pHitOrCrit: number;
+    };
+};
+export declare function analyzeSave(save: SaveBuilder): {
+    expr: string;
+    resolved: {
+        mean: number;
+        weights: {
+            [key: string]: number;
+        } & {
+            success: number;
+            fail: number;
+        };
+    };
+    query: {
+        mean: number;
+        pFail: number;
+        pHalf: number;
+    };
+};
+export declare function demoAnalyses(): {
+    advCompare: {
+        normal: {
+            dpr: number;
+            pHitOrCrit: number;
+            pCrit: number;
+        };
+        advantage: {
+            dpr: number;
+            pHitOrCrit: number;
+            pCrit: number;
+        };
+        disadvantage: {
+            dpr: number;
+            pHitOrCrit: number;
+            pCrit: number;
+        };
+    };
+    basicAtk: {
+        expr: string;
+        dpr: number;
+        pNonCritHit: number;
+        pCrit: number;
+        pHitOrCrit: number;
+        hitDamage: {
+            min: number;
+            max: number;
+            avg: number;
+            count: number;
+        };
+        critDamage: {
+            min: number;
+            max: number;
+            avg: number;
+            count: number;
+        };
+    };
+    twoSwings: {
+        expr: string;
+        attacks: number;
+        dpr: number;
+        pAtLeastOneCrit: number;
+        pAtLeastOneHitOrCrit: number;
+    };
+    blessCompare: {
+        normal: {
+            dpr: number;
+            pHitOrCrit: number;
+        };
+        blessed: {
+            dpr: number;
+            pHitOrCrit: number;
+        };
+        lift: {
+            dpr: number;
+            pHitOrCrit: number;
+        };
+    };
+    complexRoll: {
+        expr: string;
+        min: number;
+        max: number;
+        mean: number;
+        pAtLeastThreshold: number;
+    };
+    saveInfo: {
+        expr: string;
+        resolved: {
+            mean: number;
+            weights: {
+                [key: string]: number;
+            } & {
+                success: number;
+                fail: number;
+            };
+        };
+        query: {
+            mean: number;
+            pFail: number;
+            pHalf: number;
+        };
+    };
+};
+//# sourceMappingURL=example.d.ts.map

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

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

package/dist/builder/factory.d.ts

@@ -0,0 +1,17 @@
+import { LRUCache } from "../common/lru-cache.js";
+import type { PMF } from "../pmf/pmf.js";
+import { RollBuilder } from "./roll.js";
+import type { RollFactory } from "./types.js";
+export declare function d(sides: number | string): RollBuilder;
+export declare const d4: RollBuilder;
+export declare const d6: RollBuilder;
+export declare const d8: RollBuilder;
+export declare const d10: RollBuilder;
+export declare const d12: RollBuilder;
+export declare const d20: RollBuilder;
+export declare const hd20: RollBuilder;
+export declare const d100: RollBuilder;
+export declare const flat: (n: number) => RollBuilder;
+export declare const roll: RollFactory;
+export declare const builderPMFCache: LRUCache<string, PMF>;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/builder/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA8D3C,wBAAgB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAKrD;AAED,eAAO,MAAM,EAAE,aAA0B,CAAC;AAC1C,eAAO,MAAM,EAAE,aAA0B,CAAC;AAC1C,eAAO,MAAM,EAAE,aAA0B,CAAC;AAC1C,eAAO,MAAM,GAAG,aAA2B,CAAC;AAC5C,eAAO,MAAM,GAAG,aAA2B,CAAC;AAC5C,eAAO,MAAM,GAAG,aAA2B,CAAC;AAC5C,eAAO,MAAM,IAAI,aAAqC,CAAC;AACvD,eAAO,MAAM,IAAI,aAA4B,CAAC;AAC9C,eAAO,MAAM,IAAI,MAAO,MAAM,gBAA+B,CAAC;AAE9D,eAAO,MAAM,IAAI,EAAE,WAAmC,CAAC;AAEvD,eAAO,MAAM,eAAe,uBAAkC,CAAC"}