@dicelette/core 1.20.0 → 1.21.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Engine } from 'random-js';
+import { Engine, Random } from 'random-js';
 import { z } from 'zod';
 
 /**
@@ -24,6 +24,41 @@ declare function roll(dice: string, engine?: Engine | null): Resultat | undefine
  */
 declare function calculator(sign: Sign, value: number, total: number): number;
 
+declare class DiceTypeError extends Error {
+    readonly dice: string;
+    readonly cause: string | undefined;
+    readonly method: unknown;
+    constructor(dice: string, cause?: string, method?: unknown);
+}
+declare class FormulaError extends Error {
+    readonly formula: string;
+    readonly cause: string | undefined;
+    readonly method: unknown;
+    constructor(formula: string, cause?: string, method?: unknown);
+}
+declare class MaxGreater extends Error {
+    readonly name: string;
+    readonly value: number;
+    readonly max: number;
+    constructor(value: number, max: number);
+}
+declare class EmptyObjectError extends Error {
+    readonly name: string;
+    constructor();
+}
+declare class TooManyDice extends Error {
+    readonly name: string;
+    constructor();
+}
+declare class TooManyStats extends Error {
+    readonly name: string;
+    constructor();
+}
+declare class NoStatisticsError extends Error {
+    readonly name: string;
+    constructor();
+}
+
 interface Resultat {
     /**
      * Original dice throw
@@ -198,6 +233,61 @@ interface CustomCritical {
     affectSkill?: boolean;
 }
 
+declare const COMMENT_REGEX: RegExp;
+declare const SIGN_REGEX: RegExp;
+declare const SIGN_REGEX_SPACE: RegExp;
+declare const SYMBOL_DICE = "&";
+declare const DETECT_CRITICAL: RegExp;
+
+interface StatisticalSchema extends StatisticalTemplate {
+    /**
+     * Specifies the URL for the schema definition
+     * This property is optional and should contain a valid URI.
+     */
+    $schema?: string;
+}
+
+/**
+ * Definition of the Zod schema for template data
+ */
+
+declare const templateSchema: z.ZodObject<{
+    charName: z.ZodOptional<z.ZodBoolean>;
+    statistics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        max: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number | undefined, number>>>;
+        min: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number | undefined, number>>>;
+        combinaison: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        exclude: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    total: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number | undefined, number>>>;
+    forceDistrib: z.ZodOptional<z.ZodBoolean>;
+    diceType: z.ZodOptional<z.ZodString>;
+    critical: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+        success: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        failure: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>, z.ZodTransform<{
+        success?: string | number | undefined;
+        failure?: string | number | undefined;
+    }, {
+        success?: string | number | undefined;
+        failure?: string | number | undefined;
+    }>>>;
+    customCritical: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        sign: z.ZodEnum<{
+            "<": "<";
+            ">": ">";
+            ">=": ">=";
+            "<=": "<=";
+            "!=": "!=";
+            "==": "==";
+        }>;
+        value: z.ZodString;
+        onNaturalDice: z.ZodOptional<z.ZodBoolean>;
+        affectSkill: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    damage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+
 /**
  * Escape regex string
  * @param string {string}
@@ -236,6 +326,22 @@ declare function isNumber(value: unknown): boolean;
  * @returns {string} the dice with the {exp} replaced by a random value
  */
 declare function replaceExpByRandom(dice: string, engine?: Engine | null): string;
+/**
+ * Utility function to get a random integer between min and max and using the specified engine
+ * @param min {number}
+ * @param max {number}
+ * @param engine {Engine | null} Engine to use, default to nodeCrypto
+ * @param rng {Random | undefined} Random instance to use, see https://www.npmjs.com/package/random-js#usage
+ * @returns {number} Random integer between min and max
+ */
+declare function randomInt(min: number, max: number, engine?: Engine | null, rng?: Random): number;
+/**
+ * Utility function that allow to get the id of an engine
+ * @param engine {unknown} Engine to identify
+ * @returns {string} Id of the engine or "unknown"
+ * @private
+ */
+declare function getEngineId(engine: unknown): string;
 /**
  * Utility function to get the engine from its name
  * @param engine {"nativeMath" | "browserCrypto" | "nodeCrypto"} The engine name
@@ -243,7 +349,6 @@ declare function replaceExpByRandom(dice: string, engine?: Engine | null): strin
  * @public
  */
 declare function getEngine(engine: "nativeMath" | "browserCrypto" | "nodeCrypto"): Engine;
-declare function randomInt(min: number, max: number, engine?: Engine | null): number;
 
 /**
  * Verify if the provided dice work with random value
@@ -303,94 +408,4 @@ declare function testStatCombinaison(template: StatisticalTemplate, engine?: Eng
  */
 declare function generateRandomStat(total?: number | undefined, max?: number, min?: number, engine?: Engine | null): number;
 
-declare class DiceTypeError extends Error {
-    readonly dice: string;
-    readonly cause: string | undefined;
-    readonly method: unknown;
-    constructor(dice: string, cause?: string, method?: unknown);
-}
-declare class FormulaError extends Error {
-    readonly formula: string;
-    readonly cause: string | undefined;
-    readonly method: unknown;
-    constructor(formula: string, cause?: string, method?: unknown);
-}
-declare class MaxGreater extends Error {
-    readonly name: string;
-    readonly value: number;
-    readonly max: number;
-    constructor(value: number, max: number);
-}
-declare class EmptyObjectError extends Error {
-    readonly name: string;
-    constructor();
-}
-declare class TooManyDice extends Error {
-    readonly name: string;
-    constructor();
-}
-declare class TooManyStats extends Error {
-    readonly name: string;
-    constructor();
-}
-declare class NoStatisticsError extends Error {
-    readonly name: string;
-    constructor();
-}
-
-declare const COMMENT_REGEX: RegExp;
-declare const SIGN_REGEX: RegExp;
-declare const SIGN_REGEX_SPACE: RegExp;
-declare const SYMBOL_DICE = "&";
-declare const DETECT_CRITICAL: RegExp;
-
-/**
- * Definition of the Zod schema for template data
- */
-
-declare const templateSchema: z.ZodObject<{
-    charName: z.ZodOptional<z.ZodBoolean>;
-    statistics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        max: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number | undefined, number>>>;
-        min: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number | undefined, number>>>;
-        combinaison: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
-        exclude: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>>;
-    total: z.ZodOptional<z.ZodPipe<z.ZodNumber, z.ZodTransform<number | undefined, number>>>;
-    forceDistrib: z.ZodOptional<z.ZodBoolean>;
-    diceType: z.ZodOptional<z.ZodString>;
-    critical: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-        success: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-        failure: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    }, z.core.$strip>, z.ZodTransform<{
-        success?: string | number | undefined;
-        failure?: string | number | undefined;
-    }, {
-        success?: string | number | undefined;
-        failure?: string | number | undefined;
-    }>>>;
-    customCritical: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        sign: z.ZodEnum<{
-            ">=": ">=";
-            "<=": "<=";
-            "<": "<";
-            ">": ">";
-            "!=": "!=";
-            "==": "==";
-        }>;
-        value: z.ZodString;
-        onNaturalDice: z.ZodOptional<z.ZodBoolean>;
-        affectSkill: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>>;
-    damage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strip>;
-
-interface StatisticalSchema extends StatisticalTemplate {
-    /**
-     * Specifies the URL for the schema definition
-     * This property is optional and should contain a valid URI.
-     */
-    $schema?: string;
-}
-
-export { COMMENT_REGEX, type Compare, type ComparedValue, type Critical, type CustomCritical, type CustomCriticalMap, DETECT_CRITICAL, DiceTypeError, EmptyObjectError, FormulaError, MaxGreater, type Modifier, NoStatisticsError, type Resultat, SIGN_REGEX, SIGN_REGEX_SPACE, SYMBOL_DICE, type Sign, type Statistic, type StatisticalSchema, type StatisticalTemplate, TooManyDice, TooManyStats, calculator, createCriticalCustom, diceRandomParse, diceTypeRandomParse, escapeRegex, evalCombinaison, evalOneCombinaison, evalStatsDice, generateRandomStat, generateStatsDice, getEngine, isNumber, randomInt, replaceExpByRandom, replaceFormulaInDice, roll, standardizeDice, templateSchema, testDiceRegistered, testStatCombinaison, verifyTemplateValue };
+export { COMMENT_REGEX, type Compare, type ComparedValue, type Critical, type CustomCritical, type CustomCriticalMap, DETECT_CRITICAL, DiceTypeError, EmptyObjectError, FormulaError, MaxGreater, type Modifier, NoStatisticsError, type Resultat, SIGN_REGEX, SIGN_REGEX_SPACE, SYMBOL_DICE, type Sign, type Statistic, type StatisticalSchema, type StatisticalTemplate, TooManyDice, TooManyStats, calculator, createCriticalCustom, diceRandomParse, diceTypeRandomParse, escapeRegex, evalCombinaison, evalOneCombinaison, evalStatsDice, generateRandomStat, generateStatsDice, getEngine, getEngineId, isNumber, randomInt, replaceExpByRandom, replaceFormulaInDice, roll, standardizeDice, templateSchema, testDiceRegistered, testStatCombinaison, verifyTemplateValue };