@mcptoolshop/roll 1.0.0

package/dist/display/format.js

@@ -0,0 +1,134 @@
+import { bold, dim, red, green, yellow, cyan, boldGreen, boldRed, boldYellow, magenta } from "./color.js";
+import { drawBox } from "./box.js";
+const DICE_FACES = ["⚀", "⚁", "⚂", "⚃", "⚄", "⚅"];
+function dieFace(value, sides) {
+    if (sides === 6 && value >= 1 && value <= 6) {
+        return DICE_FACES[value - 1];
+    }
+    return String(value);
+}
+function formatDie(die, maxSide) {
+    const face = dieFace(die.value, maxSide);
+    if (!die.kept)
+        return dim(`[${face}]`);
+    if (die.exploded)
+        return magenta(`${face}!`);
+    if (die.value === maxSide && maxSide > 1)
+        return boldGreen(face); // crit
+    if (die.value === 1 && maxSide > 1)
+        return boldRed(face); // fumble
+    return face;
+}
+function formatGroup(group) {
+    // Determine max side for crit/fumble detection
+    const maxSide = inferMaxSide(group.expression);
+    const dice = group.dice.map((d) => formatDie(d, maxSide)).join(" ");
+    return `${dim(group.expression)}: ${dice} ${dim("=")} ${bold(String(group.total))}`;
+}
+function inferMaxSide(expr) {
+    const match = expr.match(/d(\d+)/);
+    if (match)
+        return parseInt(match[1], 10);
+    if (expr.includes("d%"))
+        return 100;
+    if (expr.includes("dF"))
+        return 1;
+    return 6;
+}
+/** Format a roll result for terminal display. */
+export function formatRollResult(result, expression) {
+    const lines = [];
+    // Show each dice group
+    for (const group of result.groups) {
+        lines.push(formatGroup(group));
+    }
+    // Total
+    const totalStr = boldYellow(` ${result.total} `);
+    lines.push("");
+    lines.push(`${bold("Total:")} ${totalStr}`);
+    return drawBox(lines, `${cyan("roll")} ${expression}`);
+}
+/** Format stats summary for terminal display. */
+export function formatStats(stats) {
+    const lines = [];
+    lines.push(`${bold("Mean:")}    ${stats.mean.toFixed(2)}`);
+    lines.push(`${bold("Median:")}  ${stats.median}`);
+    lines.push(`${bold("Mode:")}    ${stats.mode}`);
+    lines.push(`${bold("Std Dev:")} ${stats.stddev.toFixed(2)}`);
+    lines.push(`${bold("Range:")}   ${stats.min}${dim("–")}${stats.max}`);
+    lines.push(`${bold("Entropy:")} ${stats.entropy.toFixed(2)} bits`);
+    lines.push("");
+    lines.push(bold("Percentiles:"));
+    const pctKeys = [10, 25, 50, 75, 90, 95];
+    const pctLine = pctKeys
+        .map((k) => `${dim(`p${k}:`)}${stats.percentiles[k] ?? "?"}`)
+        .join("  ");
+    lines.push(`  ${pctLine}`);
+    return drawBox(lines, "Statistics");
+}
+/** Format probability for --at-least display. */
+export function formatAtLeast(target, probability, expression) {
+    const pct = (probability * 100).toFixed(2);
+    const lines = [];
+    // Visual probability bar
+    const barWidth = 40;
+    const filled = Math.round(probability * barWidth);
+    const bar = green("█".repeat(filled)) + dim("░".repeat(barWidth - filled));
+    lines.push(`P(${bold(expression)} >= ${bold(String(target))})`);
+    lines.push("");
+    lines.push(`  ${bar} ${boldYellow(pct + "%")}`);
+    lines.push("");
+    if (probability >= 0.95)
+        lines.push(green("  Almost certain"));
+    else if (probability >= 0.75)
+        lines.push(green("  Very likely"));
+    else if (probability >= 0.5)
+        lines.push(yellow("  Likely"));
+    else if (probability >= 0.25)
+        lines.push(yellow("  Possible"));
+    else if (probability >= 0.05)
+        lines.push(red("  Unlikely"));
+    else
+        lines.push(red("  Very unlikely"));
+    return drawBox(lines, "At Least");
+}
+/** Format a comparison of two distributions side by side. */
+export function formatComparison(expr1, stats1, expr2, stats2) {
+    const w = 12;
+    const lines = [];
+    const header = `${"".padEnd(10)}${bold(expr1.padEnd(w))}${bold(expr2.padEnd(w))}${bold("Diff")}`;
+    lines.push(header);
+    lines.push(dim("─".repeat(10 + w * 2 + 8)));
+    function row(label, v1, v2, decimals = 2) {
+        const s1 = v1.toFixed(decimals).padEnd(w);
+        const s2 = v2.toFixed(decimals).padEnd(w);
+        const diff = v1 - v2;
+        const diffStr = diff > 0 ? green(`+${diff.toFixed(decimals)}`) : diff < 0 ? red(diff.toFixed(decimals)) : dim("0");
+        lines.push(`${dim(label.padEnd(10))}${s1}${s2}${diffStr}`);
+    }
+    row("Mean", stats1.mean, stats2.mean);
+    row("Median", stats1.median, stats2.median, 0);
+    row("Mode", stats1.mode, stats2.mode, 0);
+    row("Std Dev", stats1.stddev, stats2.stddev);
+    row("Min", stats1.min, stats2.min, 0);
+    row("Max", stats1.max, stats2.max, 0);
+    row("Entropy", stats1.entropy, stats2.entropy);
+    return drawBox(lines, "Comparison");
+}
+/** Format roll result as JSON. */
+export function formatJson(result, expression) {
+    return JSON.stringify({
+        expression,
+        total: result.total,
+        groups: result.groups.map((g) => ({
+            expression: g.expression,
+            total: g.total,
+            dice: g.dice.map((d) => ({
+                value: d.value,
+                kept: d.kept,
+                ...(d.exploded ? { exploded: true } : {}),
+            })),
+        })),
+    }, null, 2);
+}
+//# sourceMappingURL=format.js.map

package/dist/display/format.js.map

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

package/dist/display/histogram.d.ts

@@ -0,0 +1,7 @@
+import type { Distribution } from "../analyze/distribution.js";
+import type { DistributionStats } from "../analyze/stats.js";
+/** Render a horizontal bar chart of a probability distribution. */
+export declare function renderHistogram(dist: Distribution, stats: DistributionStats, maxWidth?: number): string;
+/** Render a compact sparkline for inline display. */
+export declare function renderSparkline(dist: Distribution): string;
+//# sourceMappingURL=histogram.d.ts.map

package/dist/display/histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../../src/display/histogram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,mEAAmE;AACnE,wBAAgB,eAAe,CAC7B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,iBAAiB,EACxB,QAAQ,SAAK,GACZ,MAAM,CAqCR;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAQ1D"}

package/dist/display/histogram.js

@@ -0,0 +1,48 @@
+import { bold, dim, cyan, yellow, boldCyan } from "./color.js";
+const FULL_BLOCK = "\u2588";
+const BLOCKS = [" ", "\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
+/** Render a horizontal bar chart of a probability distribution. */
+export function renderHistogram(dist, stats, maxWidth = 60) {
+    const entries = [...dist.entries()].sort((a, b) => a[0] - b[0]);
+    if (entries.length === 0)
+        return "";
+    const maxProb = Math.max(...entries.map(([, p]) => p));
+    const lines = [];
+    // Header
+    lines.push(boldCyan("  Distribution"));
+    lines.push("");
+    // Determine label width
+    const maxLabel = Math.max(...entries.map(([v]) => String(v).length));
+    const barWidth = Math.min(maxWidth, (process.stdout.columns || 80) - maxLabel - 15);
+    for (const [value, prob] of entries) {
+        const label = String(value).padStart(maxLabel);
+        const barLen = Math.round((prob / maxProb) * barWidth);
+        const bar = FULL_BLOCK.repeat(barLen);
+        const pctStr = (prob * 100).toFixed(2).padStart(6) + "%";
+        // Highlight mode
+        const isMode = value === stats.mode;
+        const isMedian = value === stats.median;
+        let prefix = "  ";
+        if (isMode && isMedian)
+            prefix = bold("M>");
+        else if (isMode)
+            prefix = bold("*>");
+        else if (isMedian)
+            prefix = "~>";
+        const coloredBar = isMode ? yellow(bar) : cyan(bar);
+        const coloredPct = isMode ? bold(pctStr) : dim(pctStr);
+        lines.push(`${prefix}${dim(label)} ${coloredBar} ${coloredPct}`);
+    }
+    return lines.join("\n");
+}
+/** Render a compact sparkline for inline display. */
+export function renderSparkline(dist) {
+    const entries = [...dist.entries()].sort((a, b) => a[0] - b[0]);
+    if (entries.length === 0)
+        return "";
+    const maxProb = Math.max(...entries.map(([, p]) => p));
+    return entries
+        .map(([, p]) => BLOCKS[Math.round((p / maxProb) * 8)])
+        .join("");
+}
+//# sourceMappingURL=histogram.js.map

package/dist/display/histogram.js.map

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

package/dist/engine/random.d.ts

@@ -0,0 +1,6 @@
+export type RngFn = (min: number, max: number) => number;
+/** Cryptographically secure random integer in [min, max] (inclusive). */
+export declare const cryptoRng: RngFn;
+/** Create a seeded PRNG for deterministic testing. Simple mulberry32. */
+export declare function seededRng(seed: number): RngFn;
+//# sourceMappingURL=random.d.ts.map

package/dist/engine/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/engine/random.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,SAAS,EAAE,KAEvB,CAAC;AAEF,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAS7C"}

package/dist/engine/random.js

@@ -0,0 +1,17 @@
+import { randomInt } from "node:crypto";
+/** Cryptographically secure random integer in [min, max] (inclusive). */
+export const cryptoRng = (min, max) => {
+    return randomInt(min, max + 1); // crypto.randomInt upper bound is exclusive
+};
+/** Create a seeded PRNG for deterministic testing. Simple mulberry32. */
+export function seededRng(seed) {
+    let state = seed | 0;
+    return (min, max) => {
+        state = (state + 0x6d2b79f5) | 0;
+        let t = Math.imul(state ^ (state >>> 15), 1 | state);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        const raw = ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+        return min + Math.floor(raw * (max - min + 1));
+    };
+}
+//# sourceMappingURL=random.js.map

package/dist/engine/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../src/engine/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,yEAAyE;AACzE,MAAM,CAAC,MAAM,SAAS,GAAU,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE;IACnE,OAAO,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,4CAA4C;AAC9E,CAAC,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACrB,OAAO,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE;QAC1C,KAAK,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;QACrD,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;QAClD,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC"}

package/dist/engine/roller.d.ts

@@ -0,0 +1,19 @@
+import type { ASTNode } from "../parser/ast.js";
+import { type RngFn } from "./random.js";
+export interface DieResult {
+    value: number;
+    kept: boolean;
+    exploded: boolean;
+}
+export interface DiceGroupResult {
+    expression: string;
+    dice: DieResult[];
+    total: number;
+}
+export interface RollResult {
+    expression: string;
+    total: number;
+    groups: DiceGroupResult[];
+}
+export declare function evaluate(ast: ASTNode, rng?: RngFn): RollResult;
+//# sourceMappingURL=roller.d.ts.map

package/dist/engine/roller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roller.d.ts","sourceRoot":"","sources":["../../src/engine/roller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAqC,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAiJD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,GAAE,KAAiB,GAAG,UAAU,CAsCzE"}

package/dist/engine/roller.js

@@ -0,0 +1,168 @@
+import { cryptoRng } from "./random.js";
+const MAX_EXPLOSIONS = 100;
+function resolveSides(sides) {
+    if (sides === "%")
+        return 100;
+    if (sides === "F")
+        return 3; // internal: we roll 0-2 and map to -1,0,+1
+    return sides;
+}
+function rollSingleDie(sides, rng) {
+    if (sides === "F") {
+        return rng(0, 2) - 1; // -1, 0, +1
+    }
+    const max = sides === "%" ? 100 : sides;
+    return rng(1, max);
+}
+function rollDiceGroup(node, rng) {
+    const maxSide = resolveSides(node.sides);
+    const isFate = node.sides === "F";
+    // Determine explosion settings
+    const explodeMod = node.modifiers.find((m) => m.kind === "explode");
+    const explodeThreshold = explodeMod
+        ? explodeMod.value ?? (isFate ? undefined : maxSide)
+        : undefined;
+    // Roll initial dice
+    const rawRolls = [];
+    for (let i = 0; i < node.count; i++) {
+        let roll = rollSingleDie(node.sides, rng);
+        rawRolls.push(roll);
+        // Handle exploding
+        if (explodeThreshold !== undefined && !isFate) {
+            let explosions = 0;
+            while (roll >= explodeThreshold && explosions < MAX_EXPLOSIONS) {
+                roll = rollSingleDie(node.sides, rng);
+                rawRolls.push(roll);
+                explosions++;
+            }
+        }
+    }
+    // Build die results (all kept initially)
+    const dice = rawRolls.map((value) => ({
+        value,
+        kept: true,
+        exploded: false,
+    }));
+    // Mark exploded dice
+    if (explodeThreshold !== undefined && !isFate) {
+        let dieIndex = 0;
+        for (let i = 0; i < node.count; i++) {
+            // Skip the initial die
+            dieIndex++;
+            // Mark subsequent exploded dice
+            while (dieIndex < dice.length &&
+                dice[dieIndex - 1].value >= explodeThreshold) {
+                dice[dieIndex].exploded = true;
+                dieIndex++;
+            }
+        }
+    }
+    // Apply keep/drop modifiers
+    for (const mod of node.modifiers) {
+        if (mod.kind === "explode")
+            continue;
+        applyKeepDrop(dice, mod);
+    }
+    const total = dice.filter((d) => d.kept).reduce((sum, d) => sum + d.value, 0);
+    // Build expression string
+    let expr = `${node.count}d${node.sides === "%" ? "%" : node.sides === "F" ? "F" : node.sides}`;
+    for (const mod of node.modifiers) {
+        if (mod.kind === "explode") {
+            expr += "!";
+            if (mod.value !== undefined)
+                expr += `>${mod.value}`;
+        }
+        else {
+            expr += mod.kind;
+            if (mod.value !== undefined)
+                expr += mod.value;
+        }
+    }
+    return { expression: expr, dice, total };
+}
+function applyKeepDrop(dice, mod) {
+    const n = mod.value ?? 1;
+    const keptDice = dice.filter((d) => d.kept);
+    // Sort by value to determine which to keep/drop
+    const sorted = [...keptDice].sort((a, b) => a.value - b.value);
+    switch (mod.kind) {
+        case "kh": {
+            // Keep highest N — drop everything else
+            const threshold = sorted.length - n;
+            let dropped = 0;
+            for (const d of sorted) {
+                if (dropped < threshold) {
+                    d.kept = false;
+                    dropped++;
+                }
+            }
+            break;
+        }
+        case "kl": {
+            // Keep lowest N — drop everything else
+            let kept = 0;
+            for (const d of sorted) {
+                if (kept < n) {
+                    kept++;
+                }
+                else {
+                    d.kept = false;
+                }
+            }
+            break;
+        }
+        case "dh": {
+            // Drop highest N
+            let dropped = 0;
+            for (let i = sorted.length - 1; i >= 0 && dropped < n; i--) {
+                sorted[i].kept = false;
+                dropped++;
+            }
+            break;
+        }
+        case "dl": {
+            // Drop lowest N
+            let dropped = 0;
+            for (let i = 0; i < sorted.length && dropped < n; i++) {
+                sorted[i].kept = false;
+                dropped++;
+            }
+            break;
+        }
+    }
+}
+export function evaluate(ast, rng = cryptoRng) {
+    const groups = [];
+    function walk(node) {
+        switch (node.type) {
+            case "number":
+                return node.value;
+            case "dice": {
+                const group = rollDiceGroup(node, rng);
+                groups.push(group);
+                return group.total;
+            }
+            case "binary": {
+                const left = walk(node.left);
+                const right = walk(node.right);
+                switch (node.op) {
+                    case "+":
+                        return left + right;
+                    case "-":
+                        return left - right;
+                    case "*":
+                        return left * right;
+                    case "/":
+                        return right === 0 ? 0 : Math.floor(left / right);
+                }
+                break;
+            }
+            case "unary_minus":
+                return -walk(node.operand);
+        }
+        return 0;
+    }
+    const total = walk(ast);
+    return { expression: "", total, groups };
+}
+//# sourceMappingURL=roller.js.map

package/dist/engine/roller.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { parse, ParseError } from "./parser/parser.js";
+export { tokenize, LexerError } from "./parser/lexer.js";
+export type { ASTNode, DiceNode, NumberNode, BinaryOpNode, UnaryMinusNode, DiceModifier, DiceSides } from "./parser/ast.js";
+export { TokenType } from "./parser/tokens.js";
+export type { Token } from "./parser/tokens.js";
+export { evaluate } from "./engine/roller.js";
+export type { RollResult, DiceGroupResult, DieResult } from "./engine/roller.js";
+export { cryptoRng, seededRng } from "./engine/random.js";
+export type { RngFn } from "./engine/random.js";
+export { computeDistribution } from "./analyze/distribution.js";
+export type { Distribution } from "./analyze/distribution.js";
+export { computeStats, probabilityAtLeast } from "./analyze/stats.js";
+export type { DistributionStats } from "./analyze/stats.js";
+export { monteCarloDistribution } from "./analyze/montecarlo.js";
+export { rollLootTable, validateLootTables } from "./loot/table.js";
+export type { LootTable, LootItem, LootDrop, LootTableCollection } from "./loot/table.js";
+import type { RollResult } from "./engine/roller.js";
+import type { RngFn } from "./engine/random.js";
+/** Roll a dice expression and return the result. */
+export declare function roll(expression: string, rng?: RngFn): RollResult;
+/** Analyze a dice expression — returns distribution, stats, and a P(>=target) function. */
+export declare function analyze(expression: string): {
+    distribution: import("./analyze/distribution.js").Distribution;
+    stats: import("./analyze/stats.js").DistributionStats;
+    probabilityAtLeast: (target: number) => number;
+};
+//# 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":"AACA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5H,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAO1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,oDAAoD;AACpD,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAKhE;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM;;;iCAOT,MAAM;EAEtC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+// Parser
+export { parse, ParseError } from "./parser/parser.js";
+export { tokenize, LexerError } from "./parser/lexer.js";
+export { TokenType } from "./parser/tokens.js";
+// Engine
+export { evaluate } from "./engine/roller.js";
+export { cryptoRng, seededRng } from "./engine/random.js";
+// Analysis
+export { computeDistribution } from "./analyze/distribution.js";
+export { computeStats, probabilityAtLeast } from "./analyze/stats.js";
+export { monteCarloDistribution } from "./analyze/montecarlo.js";
+// Loot
+export { rollLootTable, validateLootTables } from "./loot/table.js";
+// Convenience functions
+import { parse as _parse } from "./parser/parser.js";
+import { evaluate as _evaluate } from "./engine/roller.js";
+import { computeDistribution as _computeDist } from "./analyze/distribution.js";
+import { computeStats as _computeStats, probabilityAtLeast as _probAtLeast } from "./analyze/stats.js";
+/** Roll a dice expression and return the result. */
+export function roll(expression, rng) {
+    const ast = _parse(expression);
+    const result = _evaluate(ast, rng);
+    result.expression = expression;
+    return result;
+}
+/** Analyze a dice expression — returns distribution, stats, and a P(>=target) function. */
+export function analyze(expression) {
+    const ast = _parse(expression);
+    const dist = _computeDist(ast);
+    const stats = _computeStats(dist);
+    return {
+        distribution: dist,
+        stats,
+        probabilityAtLeast: (target) => _probAtLeast(dist, target),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,SAAS;AACT,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG1D,WAAW;AACX,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO;AACP,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,wBAAwB;AACxB,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,kBAAkB,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvG,oDAAoD;AACpD,MAAM,UAAU,IAAI,CAAC,UAAkB,EAAE,GAAW;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,OAAO,CAAC,UAAkB;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,KAAK;QACL,kBAAkB,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/loot/table.d.ts

@@ -0,0 +1,27 @@
+import type { RngFn } from "../engine/random.js";
+export interface LootItem {
+    name: string;
+    weight: number;
+    roll?: string;
+    table?: string;
+    quantity?: string;
+}
+export interface LootTable {
+    table: string;
+    items: LootItem[];
+}
+export interface LootDrop {
+    item: string;
+    quantity: number;
+    rollValue?: number;
+    rollExpression?: string;
+    fromTable: string;
+}
+export interface LootTableCollection {
+    tables: LootTable[];
+}
+/** Roll on a loot table, resolving nested tables and dice expressions. */
+export declare function rollLootTable(tables: LootTable[], tableName?: string, rng?: RngFn, depth?: number): LootDrop[];
+/** Validate a loot table collection. Returns errors or empty array. */
+export declare function validateLootTables(tables: LootTable[]): string[];
+//# sourceMappingURL=table.d.ts.map

package/dist/loot/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/loot/table.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EAAE,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,GAAE,KAAiB,EACtB,KAAK,SAAI,GACR,QAAQ,EAAE,CAgEZ;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CA6BhE"}