@mcptoolshop/roll 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 1.0.0 (2026-04-10)
+
+Initial release.
+
+### Features
+
+- **Dice expression parser** — full recursive descent parser supporting `NdM`, arithmetic (`+`, `-`, `*`, `/`), parentheses, keep highest/lowest (`kh`, `kl`), drop highest/lowest (`dh`, `dl`), exploding dice (`!`, `!>N`), percentile (`d%`), and Fate dice (`dF`)
+- **Probability analyzer** — exact distributions via convolution and enumeration, Monte Carlo fallback for complex expressions
+- **Statistics** — mean, median, mode, standard deviation, percentiles (10/25/50/75/90/95), Shannon entropy
+- **Terminal histograms** — colored bar charts with mode/median markers
+- **Loot table roller** — weighted selection, nested table references, integrated dice expressions for quantity and value
+- **Comparison mode** — side-by-side distribution analysis of two expressions
+- **At-least mode** — P(result >= target) with visual probability bar
+- **Zero runtime dependencies** — Node 22+ builtins only
+- **Dual-use** — CLI via `npx @mcptoolshop/roll` and importable as a library

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,204 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.md">English</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/roll/readme.png" width="400" alt="Roll"></p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/roll/actions"><img src="https://github.com/mcp-tool-shop-org/roll/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/roll/"><img src="https://img.shields.io/badge/Landing_Page-online-brightgreen" alt="Landing Page"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/roll"><img src="https://img.shields.io/npm/v/@mcptoolshop/roll" alt="npm version"></a>
+</p>
+
+<p align="center">RPG dice engine with probability analysis, loot tables, and beautiful terminal output.</p>
+
+```
+npx @mcptoolshop/roll 4d6dl1 --analyze
+```
+
+```
+  Distribution
+
+   3    0.08%
+   4 █   0.31%
+   5 ███   0.77%
+   6 ███████   1.62%
+   7 █████████████   2.93%
+   8 ██████████████████████   4.78%
+   9 ████████████████████████████████   7.02%
+  10 ███████████████████████████████████████████   9.41%
+  11 ████████████████████████████████████████████████████  11.42%
+  12 ██████████████████████████████████████████████████████████  12.89%
+  13 ████████████████████████████████████████████████████████████  13.27%
+  14 ████████████████████████████████████████████████████████  12.35%
+  15 ██████████████████████████████████████████████  10.11%
+  16 █████████████████████████████████   7.25%
+  17 ███████████████████   4.17%
+  18 ███████   1.62%
+
+┌─ Statistics ─────────────────────────────────┐
+│ Mean:    12.24                                │
+│ Median:  12                                   │
+│ Mode:    13                                   │
+│ Std Dev: 2.85                                 │
+│ Range:   3–18                                 │
+│ Entropy: 3.53 bits                            │
+│                                               │
+│ Percentiles:                                  │
+│   p10:8  p25:10  p50:12  p75:14  p90:16  p95:17│
+└───────────────────────────────────────────────┘
+```
+
+## Instalación
+
+```bash
+npm install @mcptoolshop/roll
+```
+
+Requiere Node.js >= 22.
+
+## Uso de la línea de comandos
+
+### Lanzar dados
+
+```bash
+roll 2d6+3
+roll d20+5
+roll 4d6kh3
+roll 1d6!
+roll d%
+roll 4dF
+roll "(2d6+3)*2"
+```
+
+### Analizar probabilidad
+
+```bash
+roll 2d6 --analyze          # Full distribution + statistics
+roll d20+5 --at-least 15    # P(result >= 15)
+```
+
+### Comparar distribuciones
+
+```bash
+roll --compare "4d6dl1" "3d6"
+```
+
+Estadísticas comparativas (media, mediana, moda, desviación estándar, rango, entropía) con columna de diferencias, además de ambos histogramas.
+
+### Tablas de botín
+
+```bash
+roll --loot treasure.json
+```
+
+Formato JSON:
+
+```json
+{
+  "tables": [
+    {
+      "table": "Treasure",
+      "items": [
+        { "name": "Gold", "weight": 40, "roll": "2d6*10" },
+        { "name": "Potion of Healing", "weight": 30 },
+        { "name": "Scroll", "weight": 15, "quantity": "1d3" },
+        { "name": "Rare Item", "weight": 5, "table": "Rare Weapons" }
+      ]
+    },
+    {
+      "table": "Rare Weapons",
+      "items": [
+        { "name": "Vorpal Blade", "weight": 5 },
+        { "name": "Frost Brand", "weight": 25 }
+      ]
+    }
+  ]
+}
+```
+
+Características: selección ponderada, referencias a tablas anidadas, expresiones de dados para cantidad y valor.
+
+### Otras opciones
+
+```bash
+roll 2d6+3 --times 5       # Roll 5 times
+roll 2d6+3 --json           # Machine-readable output
+roll --help                 # Full usage
+roll --version              # Version
+```
+
+## Notación de dados
+
+| Notación | Significado |
+|----------|---------|
+| `2d6` | Lanzar 2 dados de seis caras |
+| `d20` | Lanzar 1 dado de veinte caras |
+| `4d6kh3` | Lanzar 4d6, conservar los 3 más altos |
+| `4d6dl1` | Lanzar 4d6, descartar el más bajo |
+| `1d6!` | Dado explosivo (relanzar en el máximo, sumar) |
+| `1d6!>4` | Explosión al obtener 4 o más |
+| `d%` | Dado de percentil (1-100) |
+| `4dF` | Dados de Fate/Fudge (-1, 0, +1 cada uno) |
+| `(2d6+3)*2` | Aritmética con agrupación |
+| `2d6+1d4+3` | Expresiones encadenadas |
+
+## API de la biblioteca
+
+```typescript
+import { roll, analyze, parse, evaluate, computeDistribution } from '@mcptoolshop/roll';
+
+// Quick roll
+const result = roll('4d6kh3');
+console.log(result.total);        // 14
+console.log(result.groups[0].dice); // per-die breakdown
+
+// Full analysis
+const analysis = analyze('2d6+3');
+console.log(analysis.stats.mean);                  // 10
+console.log(analysis.stats.percentiles[95]);        // 14
+console.log(analysis.probabilityAtLeast(12));       // 0.2778
+
+// Low-level: parse → AST → evaluate
+import { seededRng } from '@mcptoolshop/roll';
+const ast = parse('4d6dl1');
+const r = evaluate(ast, seededRng(42));  // deterministic
+
+// Loot tables
+import { rollLootTable } from '@mcptoolshop/roll';
+const tables = [{ table: "Loot", items: [{ name: "Gold", weight: 50, roll: "2d6*10" }] }];
+const drops = rollLootTable(tables);
+```
+
+## Motor de probabilidad
+
+- **Distribuciones exactas** mediante convolución polinómica para NdM básicos.
+- **Enumeración completa** para mecánicas de conservación/descarte (4d6 = 1296 estados).
+- **Recursión truncada** para dados explosivos (limitado a 10 explosiones).
+- **Método de Monte Carlo** (100.000 muestras) cuando el cálculo exacto supera los 10 millones de estados.
+
+## Sin dependencias externas
+
+Construido completamente con funciones integradas de Node.js 22+:
+- `util.styleText` para colores en la terminal.
+- `util.parseArgs` para el análisis de argumentos de la línea de comandos.
+- `crypto.randomInt` para generación de números aleatorios criptográficamente seguros para el lanzamiento de dados.
+
+## Seguridad y Confianza
+
+`@mcptoolshop/roll` procesa expresiones de dados y nada más. No realiza solicitudes de red, no escribe archivos y no recopila datos. El único acceso al sistema de archivos es a través de la opción `--loot`, que lee un único archivo JSON especificado por el usuario.
+
+No hay telemetría, ni análisis, ni seguimiento de ningún tipo. No se utilizan secretos, tokens ni credenciales en ninguna operación.
+
+Todos los lanzamientos de dados utilizan `crypto.randomInt` del módulo `crypto` de Node.js, proporcionando aleatoriedad criptográficamente segura adecuada para obtener resultados justos.
+
+Consulte [SECURITY.md](./SECURITY.md) para obtener la política de informes de vulnerabilidades.
+
+## Licencia
+
+MIT
+
+---
+
+Desarrollado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/README.fr.md

@@ -0,0 +1,204 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.md">English</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/roll/readme.png" width="400" alt="Roll"></p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/roll/actions"><img src="https://github.com/mcp-tool-shop-org/roll/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/roll/"><img src="https://img.shields.io/badge/Landing_Page-online-brightgreen" alt="Landing Page"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/roll"><img src="https://img.shields.io/npm/v/@mcptoolshop/roll" alt="npm version"></a>
+</p>
+
+<p align="center">RPG dice engine with probability analysis, loot tables, and beautiful terminal output.</p>
+
+```
+npx @mcptoolshop/roll 4d6dl1 --analyze
+```
+
+```
+  Distribution
+
+   3    0.08%
+   4 █   0.31%
+   5 ███   0.77%
+   6 ███████   1.62%
+   7 █████████████   2.93%
+   8 ██████████████████████   4.78%
+   9 ████████████████████████████████   7.02%
+  10 ███████████████████████████████████████████   9.41%
+  11 ████████████████████████████████████████████████████  11.42%
+  12 ██████████████████████████████████████████████████████████  12.89%
+  13 ████████████████████████████████████████████████████████████  13.27%
+  14 ████████████████████████████████████████████████████████  12.35%
+  15 ██████████████████████████████████████████████  10.11%
+  16 █████████████████████████████████   7.25%
+  17 ███████████████████   4.17%
+  18 ███████   1.62%
+
+┌─ Statistics ─────────────────────────────────┐
+│ Mean:    12.24                                │
+│ Median:  12                                   │
+│ Mode:    13                                   │
+│ Std Dev: 2.85                                 │
+│ Range:   3–18                                 │
+│ Entropy: 3.53 bits                            │
+│                                               │
+│ Percentiles:                                  │
+│   p10:8  p25:10  p50:12  p75:14  p90:16  p95:17│
+└───────────────────────────────────────────────┘
+```
+
+## Installation
+
+```bash
+npm install @mcptoolshop/roll
+```
+
+Nécessite Node.js >= 22.
+
+## Utilisation de l'interface en ligne de commande (CLI)
+
+### Lancer des dés
+
+```bash
+roll 2d6+3
+roll d20+5
+roll 4d6kh3
+roll 1d6!
+roll d%
+roll 4dF
+roll "(2d6+3)*2"
+```
+
+### Analyser les probabilités
+
+```bash
+roll 2d6 --analyze          # Full distribution + statistics
+roll d20+5 --at-least 15    # P(result >= 15)
+```
+
+### Comparer les distributions
+
+```bash
+roll --compare "4d6dl1" "3d6"
+```
+
+Statistiques côte à côte (moyenne, médiane, mode, écart type, plage, entropie) avec une colonne de différence, ainsi que les deux histogrammes.
+
+### Tables de butin
+
+```bash
+roll --loot treasure.json
+```
+
+Format JSON :
+
+```json
+{
+  "tables": [
+    {
+      "table": "Treasure",
+      "items": [
+        { "name": "Gold", "weight": 40, "roll": "2d6*10" },
+        { "name": "Potion of Healing", "weight": 30 },
+        { "name": "Scroll", "weight": 15, "quantity": "1d3" },
+        { "name": "Rare Item", "weight": 5, "table": "Rare Weapons" }
+      ]
+    },
+    {
+      "table": "Rare Weapons",
+      "items": [
+        { "name": "Vorpal Blade", "weight": 5 },
+        { "name": "Frost Brand", "weight": 25 }
+      ]
+    }
+  ]
+}
+```
+
+Fonctionnalités : sélection pondérée, références de tables imbriquées, expressions de dés pour la quantité et la valeur.
+
+### Autres options
+
+```bash
+roll 2d6+3 --times 5       # Roll 5 times
+roll 2d6+3 --json           # Machine-readable output
+roll --help                 # Full usage
+roll --version              # Version
+```
+
+## Notation des dés
+
+| Notation | Signification |
+|----------|---------|
+| `2d6` | Lancer 2 dés à 6 faces |
+| `d20` | Lancer 1 dé à 20 faces |
+| `4d6kh3` | Lancer 4d6, conserver les 3 plus élevés |
+| `4d6dl1` | Lancer 4d6, éliminer le plus bas |
+| `1d6!` | Dé explosif (relancer sur le maximum, ajouter) |
+| `1d6!>4` | Exploser sur 4 ou plus |
+| `d%` | Dé en pourcentage (1-100) |
+| `4dF` | Dés Fate/Fudge (-1, 0, +1 chacun) |
+| `(2d6+3)*2` | Opérations arithmétiques avec regroupement |
+| `2d6+1d4+3` | Expressions chaînées |
+
+## API de la bibliothèque
+
+```typescript
+import { roll, analyze, parse, evaluate, computeDistribution } from '@mcptoolshop/roll';
+
+// Quick roll
+const result = roll('4d6kh3');
+console.log(result.total);        // 14
+console.log(result.groups[0].dice); // per-die breakdown
+
+// Full analysis
+const analysis = analyze('2d6+3');
+console.log(analysis.stats.mean);                  // 10
+console.log(analysis.stats.percentiles[95]);        // 14
+console.log(analysis.probabilityAtLeast(12));       // 0.2778
+
+// Low-level: parse → AST → evaluate
+import { seededRng } from '@mcptoolshop/roll';
+const ast = parse('4d6dl1');
+const r = evaluate(ast, seededRng(42));  // deterministic
+
+// Loot tables
+import { rollLootTable } from '@mcptoolshop/roll';
+const tables = [{ table: "Loot", items: [{ name: "Gold", weight: 50, roll: "2d6*10" }] }];
+const drops = rollLootTable(tables);
+```
+
+## Moteur de probabilités
+
+- **Distributions exactes** via convolution polynomiale pour les dés de base (NdM)
+- **Énumération complète** pour les mécanismes de conservation/élimination (4d6 = 1296 états)
+- **Récursion tronquée** pour les dés explosifs (limité à 10 explosions)
+- **Rétrogradation Monte Carlo** (100 000 échantillons) lorsque le calcul exact dépasse 10 millions d'états
+
+## Aucune dépendance
+
+Construit entièrement sur les fonctionnalités intégrées de Node.js 22+ :
+- `util.styleText` pour les couleurs du terminal
+- `util.parseArgs` pour l'analyse des arguments de l'interface en ligne de commande
+- `crypto.randomInt` pour des lancers de dés cryptographiquement sécurisés
+
+## Sécurité et confiance
+
+`@mcptoolshop/roll` traite les expressions de dés et rien d'autre. Il ne fait aucune requête réseau, n'écrit aucun fichier et ne collecte aucune donnée. L'accès au système de fichiers est limité à l'option `--loot`, qui lit un seul fichier JSON spécifié par l'utilisateur.
+
+Il n'y a pas de télémétrie, d'analyse ni de suivi de quelque nature que ce soit. Aucun secret, jeton ou identifiant n'est impliqué dans aucune opération.
+
+Tous les lancers de dés utilisent `crypto.randomInt` du module `crypto` de Node.js, ce qui fournit une aléatoire cryptographiquement sécurisée, adaptée pour des résultats équitables.
+
+Consultez [SECURITY.md](./SECURITY.md) pour connaître la politique de signalement des vulnérabilités.
+
+## Licence
+
+MIT
+
+---
+
+Créé par <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/README.hi.md

@@ -0,0 +1,204 @@
+<p align="center">
+  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.md">English</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/roll/readme.png" width="400" alt="Roll"></p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/roll/actions"><img src="https://github.com/mcp-tool-shop-org/roll/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <a href="https://mcp-tool-shop-org.github.io/roll/"><img src="https://img.shields.io/badge/Landing_Page-online-brightgreen" alt="Landing Page"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/roll"><img src="https://img.shields.io/npm/v/@mcptoolshop/roll" alt="npm version"></a>
+</p>
+
+<p align="center">RPG dice engine with probability analysis, loot tables, and beautiful terminal output.</p>
+
+```
+npx @mcptoolshop/roll 4d6dl1 --analyze
+```
+
+```
+  Distribution
+
+   3    0.08%
+   4 █   0.31%
+   5 ███   0.77%
+   6 ███████   1.62%
+   7 █████████████   2.93%
+   8 ██████████████████████   4.78%
+   9 ████████████████████████████████   7.02%
+  10 ███████████████████████████████████████████   9.41%
+  11 ████████████████████████████████████████████████████  11.42%
+  12 ██████████████████████████████████████████████████████████  12.89%
+  13 ████████████████████████████████████████████████████████████  13.27%
+  14 ████████████████████████████████████████████████████████  12.35%
+  15 ██████████████████████████████████████████████  10.11%
+  16 █████████████████████████████████   7.25%
+  17 ███████████████████   4.17%
+  18 ███████   1.62%
+
+┌─ Statistics ─────────────────────────────────┐
+│ Mean:    12.24                                │
+│ Median:  12                                   │
+│ Mode:    13                                   │
+│ Std Dev: 2.85                                 │
+│ Range:   3–18                                 │
+│ Entropy: 3.53 bits                            │
+│                                               │
+│ Percentiles:                                  │
+│   p10:8  p25:10  p50:12  p75:14  p90:16  p95:17│
+└───────────────────────────────────────────────┘
+```
+
+## इंस्टॉल करें
+
+```bash
+npm install @mcptoolshop/roll
+```
+
+इसके लिए Node.js >= 22 की आवश्यकता है।
+
+## सीएलआई (CLI) का उपयोग
+
+### पासा फेंको
+
+```bash
+roll 2d6+3
+roll d20+5
+roll 4d6kh3
+roll 1d6!
+roll d%
+roll 4dF
+roll "(2d6+3)*2"
+```
+
+### संभावना का विश्लेषण करें
+
+```bash
+roll 2d6 --analyze          # Full distribution + statistics
+roll d20+5 --at-least 15    # P(result >= 15)
+```
+
+### वितरणों की तुलना करें
+
+```bash
+roll --compare "4d6dl1" "3d6"
+```
+
+एक साथ आंकड़े (माध्य, माध्यिका, बहुलक, मानक विचलन, सीमा, एंट्रॉपी) 'अंतर' कॉलम के साथ, साथ ही दोनों हिस्टोग्राम।
+
+### लूट तालिकाएँ
+
+```bash
+roll --loot treasure.json
+```
+
+JSON प्रारूप:
+
+```json
+{
+  "tables": [
+    {
+      "table": "Treasure",
+      "items": [
+        { "name": "Gold", "weight": 40, "roll": "2d6*10" },
+        { "name": "Potion of Healing", "weight": 30 },
+        { "name": "Scroll", "weight": 15, "quantity": "1d3" },
+        { "name": "Rare Item", "weight": 5, "table": "Rare Weapons" }
+      ]
+    },
+    {
+      "table": "Rare Weapons",
+      "items": [
+        { "name": "Vorpal Blade", "weight": 5 },
+        { "name": "Frost Brand", "weight": 25 }
+      ]
+    }
+  ]
+}
+```
+
+विशेषताएं: भारित चयन, नेस्टेड टेबल संदर्भ, मात्रा और मूल्य के लिए पासा अभिव्यक्तियाँ।
+
+### अन्य विकल्प
+
+```bash
+roll 2d6+3 --times 5       # Roll 5 times
+roll 2d6+3 --json           # Machine-readable output
+roll --help                 # Full usage
+roll --version              # Version
+```
+
+## पासा संकेतन
+
+| संकेतन | अर्थ |
+|----------|---------|
+| `2d6` | 2 छः-भुजा वाले पासे फेंको |
+| `d20` | 1 बीस-भुजा वाला पासा फेंको |
+| `4d6kh3` | 4d6 फेंको, शीर्ष 3 रखें |
+| `4d6dl1` | 4d6 फेंको, सबसे कम 1 हटा दें |
+| `1d6!` | विस्फोटक d6 (अधिकतम पर पुनः रोल करें, जोड़ें) |
+| `1d6!>4` | 4 या उससे अधिक पर विस्फोट करें |
+| `d%` | प्रतिशत पासा (1-100) |
+| `4dF` | फेट/फज पासे (-1, 0, +1 प्रत्येक) |
+| `(2d6+3)*2` | समूहीकरण के साथ अंकगणित |
+| `2d6+1d4+3` | शृंखलाबद्ध अभिव्यक्तियाँ |
+
+## लाइब्रेरी एपीआई
+
+```typescript
+import { roll, analyze, parse, evaluate, computeDistribution } from '@mcptoolshop/roll';
+
+// Quick roll
+const result = roll('4d6kh3');
+console.log(result.total);        // 14
+console.log(result.groups[0].dice); // per-die breakdown
+
+// Full analysis
+const analysis = analyze('2d6+3');
+console.log(analysis.stats.mean);                  // 10
+console.log(analysis.stats.percentiles[95]);        // 14
+console.log(analysis.probabilityAtLeast(12));       // 0.2778
+
+// Low-level: parse → AST → evaluate
+import { seededRng } from '@mcptoolshop/roll';
+const ast = parse('4d6dl1');
+const r = evaluate(ast, seededRng(42));  // deterministic
+
+// Loot tables
+import { rollLootTable } from '@mcptoolshop/roll';
+const tables = [{ table: "Loot", items: [{ name: "Gold", weight: 50, roll: "2d6*10" }] }];
+const drops = rollLootTable(tables);
+```
+
+## संभावना इंजन
+
+- बुनियादी NdM के लिए बहुपद संवलन के माध्यम से **सटीक वितरण**
+- 'कीप/ड्रॉप' तंत्र के लिए **पूर्ण गणना** (4d6 = 1,296 अवस्थाएँ)
+- विस्फोटक पासे के लिए **छंटनी की गई पुनरावृत्ति** (10 विस्फोटों तक सीमित)
+- जब सटीक गणना 10 मिलियन से अधिक अवस्थाओं से अधिक हो जाती है तो **मोंटे कार्लो बैकअप** (100k नमूने)
+
+## शून्य निर्भरताएँ
+
+यह पूरी तरह से Node.js 22+ के अंतर्निहित घटकों पर आधारित है:
+- टर्मिनल रंगों के लिए `util.styleText`
+- सीएलआई तर्क पार्सिंग के लिए `util.parseArgs`
+- क्रिप्टोग्राफिक रूप से सुरक्षित पासा रोल के लिए `crypto.randomInt`
+
+## सुरक्षा और विश्वसनीयता
+
+`@mcptoolshop/roll` केवल पासा अभिव्यक्तियों को संसाधित करता है और कुछ और नहीं। यह कोई नेटवर्क अनुरोध नहीं करता है, कोई फ़ाइल नहीं लिखता है और कोई डेटा एकत्र नहीं करता है। एकमात्र फ़ाइल सिस्टम एक्सेस `--loot` ध्वज है, जो एक उपयोगकर्ता-निर्दिष्ट JSON फ़ाइल को पढ़ता है।
+
+इसमें कोई टेलीमेट्री, कोई विश्लेषण और किसी भी प्रकार की ट्रैकिंग नहीं है। किसी भी ऑपरेशन में कोई गुप्त जानकारी, टोकन या क्रेडेंशियल शामिल नहीं हैं।
+
+सभी पासा रोल Node.js के `crypto` मॉड्यूल से `crypto.randomInt` का उपयोग करते हैं, जो निष्पक्ष परिणामों के लिए उपयुक्त क्रिप्टोग्राफिक रूप से सुरक्षित यादृच्छिकता प्रदान करता है।
+
+भेद्यता रिपोर्टिंग नीति के लिए [SECURITY.md](./SECURITY.md) देखें।
+
+## लाइसेंस
+
+MIT
+
+---
+
+<a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a> द्वारा निर्मित।