@yipe/dice 0.2.22 → 0.3.0

package/dist/index.d.cts

@@ -1,5 +1,31 @@
-import { P as PMF } from './pmf-BC1poIqF.cjs';
-export { B as Bin, C as CritConfig, D as DamageDistribution, i as DiceQuery, E as EPS, L as LRUCache, O as OutcomeLabelMap, j as OutcomeSnapshot, a as OutcomeType, R as Rounding, S as Snapshot, o as onAnyHit, b as onCritOnly, c as onHitOnly, e as onMissDamageOnly, d as onMissOnly, h as onPotentCantripOnly, g as onSaveFailOnly, f as onSaveHalfOnly, p as pmfCache } from './pmf-BC1poIqF.cjs';
+import { P as PMF } from './pmf-DqUCnYN9.cjs';
+export { B as Bin, C as CritConfig, a as DamageDistribution, D as DiceQuery, E as EPS, L as LRUCache, O as OutcomeLabelMap, b as OutcomeSnapshot, c as OutcomeType, R as Rounding, S as Snapshot, o as onAnyHit, d as onCritOnly, e as onHitOnly, f as onMissDamageOnly, g as onMissOnly, h as onPotentCantripOnly, i as onSaveFailOnly, j as onSaveHalfOnly, p as pmfCache } from './pmf-DqUCnYN9.cjs';
+
+/**
+ * Error thrown when a dice expression cannot be parsed.
+ *
+ * Extends the built-in {@link Error}, so existing `catch (e)` / message checks
+ * continue to work, while callers can now narrow with `instanceof DiceParseError`.
+ *
+ * @example
+ * try {
+ *   parse("d6@3");
+ * } catch (e) {
+ *   if (e instanceof DiceParseError) {
+ *     // e.expression === "d6@3"
+ *   }
+ * }
+ */
+declare class DiceParseError extends Error {
+    /** The original expression that failed to parse, when available. */
+    readonly expression?: string;
+    /** The underlying error that triggered this one, when available. */
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        expression?: string;
+        cause?: unknown;
+    });
+}
 
 /** Enable or disable the internal parse cache. */
 declare function setCachingEnabled(enabled: boolean): void;
@@ -50,4 +76,4 @@ declare class Mixture<L extends string = string> {
     static mix<L extends string = string>(items: Array<[label: L, pmf: PMF, weight: number]>, eps?: number): PMF;
 }
 
-export { Mixture, PMF, clearParserCache, getCachingEnabled, parse, setCachingEnabled };
+export { DiceParseError, Mixture, PMF, clearParserCache, getCachingEnabled, parse, setCachingEnabled };

package/dist/index.d.ts

@@ -1,5 +1,31 @@
-import { P as PMF } from './pmf-BC1poIqF.js';
-export { B as Bin, C as CritConfig, D as DamageDistribution, i as DiceQuery, E as EPS, L as LRUCache, O as OutcomeLabelMap, j as OutcomeSnapshot, a as OutcomeType, R as Rounding, S as Snapshot, o as onAnyHit, b as onCritOnly, c as onHitOnly, e as onMissDamageOnly, d as onMissOnly, h as onPotentCantripOnly, g as onSaveFailOnly, f as onSaveHalfOnly, p as pmfCache } from './pmf-BC1poIqF.js';
+import { P as PMF } from './pmf-DqUCnYN9.js';
+export { B as Bin, C as CritConfig, a as DamageDistribution, D as DiceQuery, E as EPS, L as LRUCache, O as OutcomeLabelMap, b as OutcomeSnapshot, c as OutcomeType, R as Rounding, S as Snapshot, o as onAnyHit, d as onCritOnly, e as onHitOnly, f as onMissDamageOnly, g as onMissOnly, h as onPotentCantripOnly, i as onSaveFailOnly, j as onSaveHalfOnly, p as pmfCache } from './pmf-DqUCnYN9.js';
+
+/**
+ * Error thrown when a dice expression cannot be parsed.
+ *
+ * Extends the built-in {@link Error}, so existing `catch (e)` / message checks
+ * continue to work, while callers can now narrow with `instanceof DiceParseError`.
+ *
+ * @example
+ * try {
+ *   parse("d6@3");
+ * } catch (e) {
+ *   if (e instanceof DiceParseError) {
+ *     // e.expression === "d6@3"
+ *   }
+ * }
+ */
+declare class DiceParseError extends Error {
+    /** The original expression that failed to parse, when available. */
+    readonly expression?: string;
+    /** The underlying error that triggered this one, when available. */
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        expression?: string;
+        cause?: unknown;
+    });
+}
 
 /** Enable or disable the internal parse cache. */
 declare function setCachingEnabled(enabled: boolean): void;
@@ -50,4 +76,4 @@ declare class Mixture<L extends string = string> {
     static mix<L extends string = string>(items: Array<[label: L, pmf: PMF, weight: number]>, eps?: number): PMF;
 }
 
-export { Mixture, PMF, clearParserCache, getCachingEnabled, parse, setCachingEnabled };
+export { DiceParseError, Mixture, PMF, clearParserCache, getCachingEnabled, parse, setCachingEnabled };