extra-rand 0.2.1 → 0.3.1

package/README.md

@@ -9,9 +9,16 @@ yarn add extra-rand
 ```
 
 ## API
+```ts
+interface IRandomNumberGenerator {
+  next(): number // [0, 1)
+}
+```
+
 ### random
 ```ts
 function random(min: number, max: number): number
+function random(generator: IRandomNumberGenerator, min: number, max: number): number
 ```
 
 The function returns a number in the range `[min, max)`.
@@ -19,6 +26,7 @@ The function returns a number in the range `[min, max)`.
 ### randomInt
 ```ts
 function randomInt(min: number, max: number): number
+function randomInt(generator: IRandomNumberGenerator, min: number, max: number): number
 ```
 
 The function returns an integer in the range `[Math.ceil(min), Math.floor(max))`.
@@ -26,6 +34,11 @@ The function returns an integer in the range `[Math.ceil(min), Math.floor(max))`
 ### randomIntInclusive
 ```ts
 function randomIntInclusive(min: number, max: number): number
+function randomIntInclusive(
+  generator: IRandomNumberGenerator
+, min: number
+, max: number
+): number
 ```
 
 The function returns an integer in the range `[Math.ceil(min), Math.floor(max)]`.
@@ -33,15 +46,70 @@ The function returns an integer in the range `[Math.ceil(min), Math.floor(max)]`
 ### randomBool
 ```ts
 function randomBool(probabilityOfTrue: number): boolean
+function randomBool(generator: IRandomNumberGenerator, probabilityOfTrue: number): boolean
 ```
 
-### randomByWeight
+### randomIndexByWeight
 ```ts
-function randomByWeight(weights: number[]): number
+function randomIndexByWeight(weights: NonEmptyArray<number>): number
+function randomIndexByWeight(
+  generator: IRandomNumberGenerator
+, weights: NonEmptyArray<number>
+): number
 ```
 
 The function returns an index of one of weights.
 
+### randomWeighted
+```ts
+interface IWeighted {
+  weight: number
+}
+
+function randomWeighted<T extends IWeighted>(values: NonEmptyArray<T>): T
+function randomWeighted<T extends IWeighted>(
+  generator: IRandomNumberGenerator
+, values: NonEmptyArray<T>
+): T
+```
+
+### randomByWeightModel
+```ts
+type IWeightModel<T> = NonEmptyArray<{
+  weight: number
+  value: T
+}>
+
+function randomByWeightModel<T>(model: IWeightModel<T>): T
+function randomByWeightModel<T>(generator: IRandomNumberGenerator, model: IWeightModel<T>): T
+```
+
+### randomByModel
+```ts
+enum Type {
+  Float
+, Integer
+, IntegerInclusive
+}
+
+type IRandomModel =
+| number
+| Getter<number>
+| {
+    type: Type
+    min: number
+    max: number
+  }
+| NonEmptyArray<{
+    weight: number
+    value: IRandomModel
+  }>
+
+
+function randomByModel(model: IRandomModel): number
+function randomByModel(generator: IRandomNumberGenerator, model: IRandomModel): number
+```
+
 ### mapToRange
 ```ts
 function mapToRange(
@@ -55,10 +123,10 @@ A low-level function helps you to use random number generators other than `Math.
 
 ### mapToIndexByWeight
 ```ts
-function mapByWeight(
+function mapToIndexByWeight(
   value: number
 , oldMin: number, oldMax: number
-, weights: number[]
+, weights: NonEmptyArray<number>
 ): number
 ```
 

package/lib/index.d.ts

@@ -1,7 +1,11 @@
-export * from './random';
-export * from './random-int';
-export * from './random-int-inclusive';
-export * from './random-bool';
-export * from './random-by-weight';
-export * from './map-to-range';
-export * from './map-to-index-by-weight';
+export * from './types.js';
+export * from './random.js';
+export * from './random-int.js';
+export * from './random-int-inclusive.js';
+export * from './random-bool.js';
+export * from './random-index-by-weight.js';
+export * from './random-weighted.js';
+export * from './random-by-weight-model.js';
+export * from './random-by-model.js';
+export * from './map-to-range.js';
+export * from './map-to-index-by-weight.js';

package/lib/index.js

@@ -1,24 +1,12 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./random"), exports);
-__exportStar(require("./random-int"), exports);
-__exportStar(require("./random-int-inclusive"), exports);
-__exportStar(require("./random-bool"), exports);
-__exportStar(require("./random-by-weight"), exports);
-__exportStar(require("./map-to-range"), exports);
-__exportStar(require("./map-to-index-by-weight"), exports);
+export * from './types.js';
+export * from './random.js';
+export * from './random-int.js';
+export * from './random-int-inclusive.js';
+export * from './random-bool.js';
+export * from './random-index-by-weight.js';
+export * from './random-weighted.js';
+export * from './random-by-weight-model.js';
+export * from './random-by-model.js';
+export * from './map-to-range.js';
+export * from './map-to-index-by-weight.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwB;AACxB,+CAA4B;AAC5B,yDAAsC;AACtC,gDAA6B;AAC7B,qDAAkC;AAElC,iDAA8B;AAC9B,2DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAE1B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,kBAAkB,CAAA;AAChC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,sBAAsB,CAAA;AACpC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,sBAAsB,CAAA;AAEpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,6BAA6B,CAAA"}

package/lib/map-to-index-by-weight.d.ts

@@ -1 +1,2 @@
-export declare function mapToIndexByWeight(value: number, oldMin: number, oldMax: number, weights: number[]): number;
+import { NonEmptyArray } from 'justypes';
+export declare function mapToIndexByWeight(value: number, oldMin: number, oldMax: number, weights: NonEmptyArray<number>): number;

package/lib/map-to-index-by-weight.js

@@ -1,18 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapToIndexByWeight = void 0;
-const map_to_range_1 = require("./map-to-range");
-function mapToIndexByWeight(value, oldMin, oldMax, weights) {
+import { mapToRange } from './map-to-range.js';
+export function mapToIndexByWeight(value, oldMin, oldMax, weights) {
     const newMin = 0;
     const newMax = weights.reduce((acc, cur) => acc + Math.max(cur, 0));
     if (newMax === 0) {
-        const index = Math.floor((0, map_to_range_1.mapToRange)(value, oldMin, oldMax, newMin, weights.length));
+        const index = Math.floor(mapToRange(value, oldMin, oldMax, newMin, weights.length));
         return index === weights.length
             ? weights.length - 1
             : index;
     }
     else {
-        const newValue = (0, map_to_range_1.mapToRange)(value, oldMin, oldMax, newMin, newMax);
+        const newValue = mapToRange(value, oldMin, oldMax, newMin, newMax);
         let remains = newMax;
         for (let i = weights.length; i--;) {
             const weight = weights[i];
@@ -29,5 +26,4 @@ function mapToIndexByWeight(value, oldMin, oldMax, weights) {
         throw new Error('Impossible route');
     }
 }
-exports.mapToIndexByWeight = mapToIndexByWeight;
 //# sourceMappingURL=map-to-index-by-weight.js.map

package/lib/map-to-index-by-weight.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-to-index-by-weight.js","sourceRoot":"","sources":["../src/map-to-index-by-weight.ts"],"names":[],"mappings":";;;AAAA,iDAA2C;AAE3C,SAAgB,kBAAkB,CAChC,KAAa,EACb,MAAc,EAAE,MAAc,EAC9B,OAAiB;IAEjB,MAAM,MAAM,GAAG,CAAC,CAAA;IAChB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IACnE,IAAI,MAAM,KAAK,CAAC,EAAE;QAEhB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,yBAAU,EAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;QAEnF,OAAO,KAAK,KAAK,OAAO,CAAC,MAAM;YAC1B,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,KAAK,CAAA;KACb;SAAM;QACL,MAAM,QAAQ,GAAG,IAAA,yBAAU,EAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAElE,IAAI,OAAO,GAAG,MAAM,CAAA;QACpB,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG;YACjC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;YACzB,IAAI,MAAM,IAAI,CAAC,EAAE;gBACf,SAAQ;aACT;iBAAM;gBACL,OAAO,IAAI,MAAM,CAAA;gBACjB,IAAI,QAAQ,IAAI,OAAO,EAAE;oBACvB,OAAO,CAAC,CAAA;iBACT;aACF;SACF;QAED,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;KACpC;AACH,CAAC;AAhCD,gDAgCC"}
+{"version":3,"file":"map-to-index-by-weight.js","sourceRoot":"","sources":["../src/map-to-index-by-weight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,MAAc,EAAE,MAAc,EAC9B,OAA8B;IAE9B,MAAM,MAAM,GAAG,CAAC,CAAA;IAChB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;IACnE,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;QAEnF,OAAO,KAAK,KAAK,OAAO,CAAC,MAAM;YAC1B,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,KAAK,CAAA;IACd,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAElE,IAAI,OAAO,GAAG,MAAM,CAAA;QACpB,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC;YAClC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;YACzB,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAChB,SAAQ;YACV,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,MAAM,CAAA;gBACjB,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;oBACxB,OAAO,CAAC,CAAA;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;IACrC,CAAC;AACH,CAAC"}

package/lib/map-to-range.js

@@ -1,10 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapToRange = void 0;
-function mapToRange(value, oldMin, oldMax, newMin, newMax) {
+export function mapToRange(value, oldMin, oldMax, newMin, newMax) {
     return (value - oldMin) / (oldMax - oldMin)
         * (newMax - newMin)
         + newMin;
 }
-exports.mapToRange = mapToRange;
 //# sourceMappingURL=map-to-range.js.map

package/lib/map-to-range.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-to-range.js","sourceRoot":"","sources":["../src/map-to-range.ts"],"names":[],"mappings":";;;AAAA,SAAgB,UAAU,CACxB,KAAa,EACb,MAAc,EAAE,MAAc,EAC9B,MAAc,EAAE,MAAc;IAE9B,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;UACpC,CAAC,MAAM,GAAG,MAAM,CAAC;UACjB,MAAM,CAAA;AACf,CAAC;AARD,gCAQC"}
+{"version":3,"file":"map-to-range.js","sourceRoot":"","sources":["../src/map-to-range.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,MAAc,EAAE,MAAc,EAC9B,MAAc,EAAE,MAAc;IAE9B,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;UACpC,CAAC,MAAM,GAAG,MAAM,CAAC;UACjB,MAAM,CAAA;AACf,CAAC"}

package/lib/native-random-number-generator.d.ts

@@ -0,0 +1,2 @@
+import { IRandomNumberGenerator } from './types.js';
+export declare const NativeRandomNumberGenerator: IRandomNumberGenerator;

package/lib/native-random-number-generator.js

@@ -0,0 +1,4 @@
+export const NativeRandomNumberGenerator = {
+    next: Math.random
+};
+//# sourceMappingURL=native-random-number-generator.js.map

package/lib/native-random-number-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-random-number-generator.js","sourceRoot":"","sources":["../src/native-random-number-generator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAA2B;IACjE,IAAI,EAAE,IAAI,CAAC,MAAM;CAClB,CAAA"}

package/lib/random-bool.d.ts

@@ -1 +1,3 @@
+import { IRandomNumberGenerator } from './types.js';
 export declare function randomBool(probabilityOfTrue: number): boolean;
+export declare function randomBool(generator: IRandomNumberGenerator, probabilityOfTrue: number): boolean;

package/lib/random-bool.js

@@ -1,9 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomBool = void 0;
-const random_1 = require("./random");
-function randomBool(probabilityOfTrue) {
-    return (0, random_1.random)(0, 1) < probabilityOfTrue;
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+import { random } from './random.js';
+export function randomBool(...args) {
+    let generator;
+    let probabilityOfTrue;
+    if (args.length === 1) {
+        generator = NativeRandomNumberGenerator;
+        [probabilityOfTrue] = args;
+    }
+    else {
+        [generator, probabilityOfTrue] = args;
+    }
+    return random(generator, 0, 1) < probabilityOfTrue;
 }
-exports.randomBool = randomBool;
 //# sourceMappingURL=random-bool.js.map

package/lib/random-bool.js.map

@@ -1 +1 @@
-{"version":3,"file":"random-bool.js","sourceRoot":"","sources":["../src/random-bool.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AAEjC,SAAgB,UAAU,CAAC,iBAAyB;IAClD,OAAO,IAAA,eAAM,EAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAA;AACzC,CAAC;AAFD,gCAEC"}
+{"version":3,"file":"random-bool.js","sourceRoot":"","sources":["../src/random-bool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAOpC,MAAM,UAAU,UAAU,CAAC,GAAG,IAEkC;IAE9D,IAAI,SAAiC,CAAA;IACrC,IAAI,iBAAyB,CAAA;IAE7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;IAC7B,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAA;IACvC,CAAC;IAED,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAA;AACpD,CAAC"}

package/lib/random-by-model.d.ts

@@ -0,0 +1,17 @@
+import { Getter, NonEmptyArray } from 'justypes';
+import { IRandomNumberGenerator } from './types.js';
+export declare enum Type {
+    Float = 0,
+    Integer = 1,
+    IntegerInclusive = 2
+}
+export type IRandomModel = number | Getter<number> | {
+    type: Type;
+    min: number;
+    max: number;
+} | NonEmptyArray<{
+    weight: number;
+    value: IRandomModel;
+}>;
+export declare function randomByModel(model: IRandomModel): number;
+export declare function randomByModel(generator: IRandomNumberGenerator, model: IRandomModel): number;

package/lib/random-by-model.js

@@ -0,0 +1,42 @@
+import { isArray, isFunction, isNumber } from 'extra-utils';
+import { randomByWeightModel } from './random-by-weight-model.js';
+import { random } from './random.js';
+import { randomInt } from './random-int.js';
+import { randomIntInclusive } from './random-int-inclusive.js';
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+export var Type;
+(function (Type) {
+    Type[Type["Float"] = 0] = "Float";
+    Type[Type["Integer"] = 1] = "Integer";
+    Type[Type["IntegerInclusive"] = 2] = "IntegerInclusive";
+})(Type || (Type = {}));
+export function randomByModel(...args) {
+    let generator;
+    let model;
+    if (args.length === 1) {
+        generator = NativeRandomNumberGenerator;
+        [model] = args;
+    }
+    else {
+        [generator, model] = args;
+    }
+    if (isNumber(model)) {
+        return model;
+    }
+    else if (isFunction(model)) {
+        return model();
+    }
+    else if (isArray(model)) {
+        const subModel = randomByWeightModel(generator, model);
+        return randomByModel(generator, subModel);
+    }
+    else {
+        const { type, min, max } = model;
+        switch (type) {
+            case Type.Float: return random(generator, min, max);
+            case Type.Integer: return randomInt(generator, min, max);
+            case Type.IntegerInclusive: return randomIntInclusive(generator, min, max);
+        }
+    }
+}
+//# sourceMappingURL=random-by-model.js.map

package/lib/random-by-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-by-model.js","sourceRoot":"","sources":["../src/random-by-model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAEjF,MAAM,CAAN,IAAY,IAIX;AAJD,WAAY,IAAI;IACd,iCAAK,CAAA;IACL,qCAAO,CAAA;IACP,uDAAgB,CAAA;AAClB,CAAC,EAJW,IAAI,KAAJ,IAAI,QAIf;AAoBD,MAAM,UAAU,aAAa,CAAC,GAAG,IAEyB;IAExD,IAAI,SAAiC,CAAA;IACrC,IAAI,KAAmB,CAAA;IAEvB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,IAAI,CAAA;IAC3B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAA;IACd,CAAC;SAAM,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,EAAE,CAAA;IAChB,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACtD,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAA;QAChC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;YACnD,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;YACxD,KAAK,IAAI,CAAC,gBAAgB,CAAC,CAAC,OAAO,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;QAC5E,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/random-by-weight-model.d.ts

@@ -0,0 +1,8 @@
+import { NonEmptyArray } from 'justypes';
+import { IRandomNumberGenerator } from './types.js';
+export type IWeightModel<T> = NonEmptyArray<{
+    weight: number;
+    value: T;
+}>;
+export declare function randomByWeightModel<T>(model: IWeightModel<T>): T;
+export declare function randomByWeightModel<T>(generator: IRandomNumberGenerator, model: IWeightModel<T>): T;

package/lib/random-by-weight-model.js

@@ -0,0 +1,16 @@
+import { randomWeighted } from './random-weighted.js';
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+export function randomByWeightModel(...args) {
+    let generator;
+    let model;
+    if (args.length === 1) {
+        generator = NativeRandomNumberGenerator;
+        [model] = args;
+    }
+    else {
+        [generator, model] = args;
+    }
+    const { value } = randomWeighted(generator, model);
+    return value;
+}
+//# sourceMappingURL=random-by-weight-model.js.map

package/lib/random-by-weight-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-by-weight-model.js","sourceRoot":"","sources":["../src/random-by-weight-model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAYjF,MAAM,UAAU,mBAAmB,CAAI,GAAG,IAEmB;IAE3D,IAAI,SAAiC,CAAA;IACrC,IAAI,KAAsB,CAAA;IAE1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,IAAI,CAAA;IAC3B,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAClD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/lib/random-index-by-weight.d.ts

@@ -0,0 +1,4 @@
+import { NonEmptyArray } from 'justypes';
+import { IRandomNumberGenerator } from './types.js';
+export declare function randomIndexByWeight(weights: NonEmptyArray<number>): number;
+export declare function randomIndexByWeight(generator: IRandomNumberGenerator, weights: NonEmptyArray<number>): number;

package/lib/random-index-by-weight.js

@@ -0,0 +1,15 @@
+import { mapToIndexByWeight } from './map-to-index-by-weight.js';
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+export function randomIndexByWeight(...args) {
+    let generator;
+    let weights;
+    if (args.length === 1) {
+        generator = NativeRandomNumberGenerator;
+        [weights] = args;
+    }
+    else {
+        [generator, weights] = args;
+    }
+    return mapToIndexByWeight(generator.next(), 0, 1, weights);
+}
+//# sourceMappingURL=random-index-by-weight.js.map

package/lib/random-index-by-weight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-index-by-weight.js","sourceRoot":"","sources":["../src/random-index-by-weight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAEhE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAOjF,MAAM,UAAU,mBAAmB,CAAC,GAAG,IAE8B;IAEnE,IAAI,SAAiC,CAAA;IACrC,IAAI,OAA8B,CAAA;IAElC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IACnB,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC7B,CAAC;IAED,OAAO,kBAAkB,CACvB,SAAS,CAAC,IAAI,EAAE,EAChB,CAAC,EAAE,CAAC,EACJ,OAAO,CACR,CAAA;AACH,CAAC"}

package/lib/random-int-inclusive.d.ts

@@ -1 +1,3 @@
+import { IRandomNumberGenerator } from './types.js';
 export declare function randomIntInclusive(min: number, max: number): number;
+export declare function randomIntInclusive(generator: IRandomNumberGenerator, min: number, max: number): number;

package/lib/random-int-inclusive.js

@@ -1,9 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomIntInclusive = void 0;
-const map_to_range_1 = require("./map-to-range");
-function randomIntInclusive(min, max) {
-    return Math.floor((0, map_to_range_1.mapToRange)(Math.random(), 0, 1, Math.ceil(min), Math.floor(max) + 1));
+import { mapToRange } from './map-to-range.js';
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+export function randomIntInclusive(...args) {
+    let generator;
+    let min;
+    let max;
+    if (args.length === 2) {
+        generator = NativeRandomNumberGenerator;
+        [min, max] = args;
+    }
+    else {
+        [generator, min, max] = args;
+    }
+    return Math.floor(mapToRange(generator.next(), 0, 1, Math.ceil(min), Math.floor(max) + 1));
 }
-exports.randomIntInclusive = randomIntInclusive;
 //# sourceMappingURL=random-int-inclusive.js.map

package/lib/random-int-inclusive.js.map

@@ -1 +1 @@
-{"version":3,"file":"random-int-inclusive.js","sourceRoot":"","sources":["../src/random-int-inclusive.ts"],"names":[],"mappings":";;;AAAA,iDAA2C;AAE3C,SAAgB,kBAAkB,CAAC,GAAW,EAAE,GAAW;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,yBAAU,EAC1B,IAAI,CAAC,MAAM,EAAE,EACb,CAAC,EAAE,CAAC,EACJ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CACpC,CAAC,CAAA;AACJ,CAAC;AAND,gDAMC"}
+{"version":3,"file":"random-int-inclusive.js","sourceRoot":"","sources":["../src/random-int-inclusive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAWjF,MAAM,UAAU,kBAAkB,CAAC,GAAG,IAEyB;IAE7D,IAAI,SAAiC,CAAA;IACrC,IAAI,GAAW,CAAA;IACf,IAAI,GAAW,CAAA;IAEf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IACpB,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAC1B,SAAS,CAAC,IAAI,EAAE,EAChB,CAAC,EAAE,CAAC,EACJ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CACpC,CAAC,CAAA;AACJ,CAAC"}

package/lib/random-int.d.ts

@@ -1 +1,3 @@
+import { IRandomNumberGenerator } from './types.js';
 export declare function randomInt(min: number, max: number): number;
+export declare function randomInt(generator: IRandomNumberGenerator, min: number, max: number): number;

package/lib/random-int.js

@@ -1,9 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomInt = void 0;
-const map_to_range_1 = require("./map-to-range");
-function randomInt(min, max) {
-    return Math.floor((0, map_to_range_1.mapToRange)(Math.random(), 0, 1, Math.ceil(min), Math.floor(max)));
+import { mapToRange } from './map-to-range.js';
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+export function randomInt(...args) {
+    let generator;
+    let min;
+    let max;
+    if (args.length === 2) {
+        generator = NativeRandomNumberGenerator;
+        [min, max] = args;
+    }
+    else {
+        [generator, min, max] = args;
+    }
+    return Math.floor(mapToRange(generator.next(), 0, 1, Math.ceil(min), Math.floor(max)));
 }
-exports.randomInt = randomInt;
 //# sourceMappingURL=random-int.js.map

package/lib/random-int.js.map

@@ -1 +1 @@
-{"version":3,"file":"random-int.js","sourceRoot":"","sources":["../src/random-int.ts"],"names":[],"mappings":";;;AAAA,iDAA2C;AAE3C,SAAgB,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,yBAAU,EAC1B,IAAI,CAAC,MAAM,EAAE,EACb,CAAC,EAAE,CAAC,EACJ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAChC,CAAC,CAAA;AACJ,CAAC;AAND,8BAMC"}
+{"version":3,"file":"random-int.js","sourceRoot":"","sources":["../src/random-int.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAQjF,MAAM,UAAU,SAAS,CAAC,GAAG,IAEkC;IAE7D,IAAI,SAAiC,CAAA;IACrC,IAAI,GAAW,CAAA;IACf,IAAI,GAAW,CAAA;IAEf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IACpB,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAC1B,SAAS,CAAC,IAAI,EAAE,EAChB,CAAC,EAAE,CAAC,EACJ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAChC,CAAC,CAAA;AACJ,CAAC"}

package/lib/random-weighted.d.ts

@@ -0,0 +1,7 @@
+import { NonEmptyArray } from 'justypes';
+import { IRandomNumberGenerator } from './types.js';
+export interface IWeighted {
+    weight: number;
+}
+export declare function randomWeighted<T extends IWeighted>(values: NonEmptyArray<T>): T;
+export declare function randomWeighted<T extends IWeighted>(generator: IRandomNumberGenerator, values: NonEmptyArray<T>): T;

package/lib/random-weighted.js

@@ -0,0 +1,17 @@
+import { randomIndexByWeight } from './random-index-by-weight.js';
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+export function randomWeighted(...args) {
+    let generator;
+    let values;
+    if (args.length === 1) {
+        generator = NativeRandomNumberGenerator;
+        [values] = args;
+    }
+    else {
+        [generator, values] = args;
+    }
+    const weights = values.map(option => option.weight);
+    const index = randomIndexByWeight(generator, weights);
+    return values[index];
+}
+//# sourceMappingURL=random-weighted.js.map

package/lib/random-weighted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-weighted.js","sourceRoot":"","sources":["../src/random-weighted.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAGjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAWjF,MAAM,UAAU,cAAc,CAAsB,GAAG,IAEQ;IAE7D,IAAI,SAAiC,CAAA;IACrC,IAAI,MAAwB,CAAA;IAE5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAClB,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAC5B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAA0B,CAAA;IAC5E,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}

package/lib/random.d.ts

@@ -1 +1,3 @@
+import { IRandomNumberGenerator } from './types.js';
 export declare function random(min: number, max: number): number;
+export declare function random(generator: IRandomNumberGenerator, min: number, max: number): number;

package/lib/random.js

@@ -1,9 +1,16 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.random = void 0;
-const map_to_range_1 = require("./map-to-range");
-function random(min, max) {
-    return (0, map_to_range_1.mapToRange)(Math.random(), 0, 1, min, max);
+import { mapToRange } from './map-to-range.js';
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+export function random(...args) {
+    let generator;
+    let min;
+    let max;
+    if (args.length === 2) {
+        generator = NativeRandomNumberGenerator;
+        [min, max] = args;
+    }
+    else {
+        [generator, min, max] = args;
+    }
+    return mapToRange(generator.next(), 0, 1, min, max);
 }
-exports.random = random;
 //# sourceMappingURL=random.js.map

package/lib/random.js.map

@@ -1 +1 @@
-{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":";;;AAAA,iDAA2C;AAE3C,SAAgB,MAAM,CAAC,GAAW,EAAE,GAAW;IAC7C,OAAO,IAAA,yBAAU,EACf,IAAI,CAAC,MAAM,EAAE,EACb,CAAC,EAAE,CAAC,EACJ,GAAG,EAAE,GAAG,CACT,CAAA;AACH,CAAC;AAND,wBAMC"}
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAQjF,MAAM,UAAU,MAAM,CAAC,GAAG,IAEqC;IAE7D,IAAI,SAAiC,CAAA;IACrC,IAAI,GAAW,CAAA;IACf,IAAI,GAAW,CAAA;IAEf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IACpB,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAC9B,CAAC;IAED,OAAO,UAAU,CACf,SAAS,CAAC,IAAI,EAAE,EAChB,CAAC,EAAE,CAAC,EACJ,GAAG,EAAE,GAAG,CACT,CAAA;AACH,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,3 @@
+export interface IRandomNumberGenerator {
+    next(): number;
+}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extra-rand",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Yet another random library",
   "keywords": [
     "random"
@@ -12,43 +12,49 @@
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "sideEffects": false,
+  "type": "module",
+  "engines": {
+    "node": ">=18.17.0"
+  },
   "repository": "git@github.com:BlackGlory/extra-rand.git",
   "author": "BlackGlory <woshenmedoubuzhidao@blackglory.me>",
   "license": "MIT",
   "scripts": {
-    "lint": "eslint --ext .js,.jsx,.ts,.tsx --quiet src __tests__",
-    "test": "jest --config jest.config.js",
-    "test:debug": "node --inspect-brk node_modules/.bin/jest --runInBand",
-    "test:coverage": "jest --coverage --config jest.config.js",
-    "prepublishOnly": "run-s clean build",
+    "prepare": "ts-patch install -s",
+    "lint": "eslint --quiet src __tests__",
+    "test": "vitest --run",
+    "prepublishOnly": "run-s prepare clean build",
     "clean": "rimraf lib",
-    "build": "run-s build:*",
-    "build:compile": "tsc --project tsconfig.build.json --module commonjs --target es2018 --outDir lib",
-    "build:patch": "tscpaths -p tsconfig.build.json -s ./src -o ./lib",
+    "build": "tsc --project tsconfig.build.json --outDir lib",
     "release": "standard-version"
   },
   "husky": {
     "hooks": {
-      "pre-commit": "run-s lint build test",
+      "pre-commit": "run-s prepare lint build test",
       "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
     }
   },
   "devDependencies": {
-    "@commitlint/cli": "^17.5.1",
-    "@commitlint/config-conventional": "^17.4.4",
-    "@types/jest": "^29.5.0",
-    "@typescript-eslint/eslint-plugin": "^5.57.0",
-    "@typescript-eslint/parser": "^5.57.0",
-    "eslint": "^8.37.0",
+    "@commitlint/cli": "^19.2.2",
+    "@commitlint/config-conventional": "^19.2.2",
+    "@eslint/js": "^9.0.0",
+    "eslint": "^9.0.0",
     "husky": "^4.3.8",
-    "jest": "^29.5.0",
     "npm-run-all": "^4.1.5",
-    "rimraf": "^3.0.2",
+    "rimraf": "^5.0.5",
     "standard-version": "^9.5.0",
-    "ts-jest": "^29.0.5",
-    "tscpaths": "^0.0.9",
-    "tslib": "^2.5.0",
-    "typescript": "^4.7.4"
+    "ts-patch": "^3.1.2",
+    "tslib": "^2.6.2",
+    "typescript": "^5.4.5",
+    "typescript-eslint": "^7.7.0",
+    "typescript-transform-paths": "^3.4.7",
+    "vite": "^5.2.9",
+    "vite-tsconfig-paths": "^4.3.2",
+    "vitest": "^1.5.0"
   },
-  "dependencies": {}
+  "dependencies": {
+    "@blackglory/errors": "^3.0.3",
+    "extra-utils": "^5.7.0",
+    "justypes": "^4.2.1"
+  }
 }

package/src/index.ts

@@ -1,8 +1,13 @@
-export * from './random'
-export * from './random-int'
-export * from './random-int-inclusive'
-export * from './random-bool'
-export * from './random-by-weight'
+export * from './types.js'
 
-export * from './map-to-range'
-export * from './map-to-index-by-weight'
+export * from './random.js'
+export * from './random-int.js'
+export * from './random-int-inclusive.js'
+export * from './random-bool.js'
+export * from './random-index-by-weight.js'
+export * from './random-weighted.js'
+export * from './random-by-weight-model.js'
+export * from './random-by-model.js'
+
+export * from './map-to-range.js'
+export * from './map-to-index-by-weight.js'

package/src/map-to-index-by-weight.ts

@@ -1,9 +1,10 @@
-import { mapToRange } from './map-to-range'
+import { NonEmptyArray } from 'justypes'
+import { mapToRange } from './map-to-range.js'
 
 export function mapToIndexByWeight(
   value: number
 , oldMin: number, oldMax: number
-, weights: number[]
+, weights: NonEmptyArray<number>
 ): number {
   const newMin = 0
   const newMax = weights.reduce((acc, cur) => acc + Math.max(cur, 0))

package/src/native-random-number-generator.ts

@@ -0,0 +1,5 @@
+import { IRandomNumberGenerator } from './types.js'
+
+export const NativeRandomNumberGenerator: IRandomNumberGenerator = {
+  next: Math.random
+}

package/src/random-bool.ts

@@ -1,5 +1,25 @@
-import { random } from './random'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+import { random } from './random.js'
 
-export function randomBool(probabilityOfTrue: number): boolean {
-  return random(0, 1) < probabilityOfTrue
+export function randomBool(probabilityOfTrue: number): boolean
+export function randomBool(
+  generator: IRandomNumberGenerator
+, probabilityOfTrue: number
+): boolean
+export function randomBool(...args:
+| [probabilityOfTrue: number]
+| [generator: IRandomNumberGenerator, probabilityOfTrue: number]
+): boolean {
+  let generator: IRandomNumberGenerator
+  let probabilityOfTrue: number
+
+  if (args.length === 1) {
+    generator = NativeRandomNumberGenerator
+    ;[probabilityOfTrue] = args
+  } else {
+    [generator, probabilityOfTrue] = args
+  }
+
+  return random(generator, 0, 1) < probabilityOfTrue
 }

package/src/random-by-model.ts

@@ -0,0 +1,63 @@
+import { Getter, NonEmptyArray } from 'justypes'
+import { isArray, isFunction, isNumber } from 'extra-utils'
+import { randomByWeightModel } from './random-by-weight-model.js'
+import { random } from './random.js'
+import { randomInt } from './random-int.js'
+import { randomIntInclusive } from './random-int-inclusive.js'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+
+export enum Type {
+  Float
+, Integer
+, IntegerInclusive
+}
+
+export type IRandomModel =
+| number
+| Getter<number>
+| {
+    type: Type
+    min: number
+    max: number
+  }
+| NonEmptyArray<{
+    weight: number
+    value: IRandomModel
+  }>
+
+export function randomByModel(model: IRandomModel): number
+export function randomByModel(
+  generator: IRandomNumberGenerator
+, model: IRandomModel
+): number
+export function randomByModel(...args:
+| [model: IRandomModel]
+| [generator: IRandomNumberGenerator, model: IRandomModel]
+): number {
+  let generator: IRandomNumberGenerator
+  let model: IRandomModel
+
+  if (args.length === 1) {
+    generator = NativeRandomNumberGenerator
+    ;[model] = args
+  } else {
+    [generator, model] = args
+  }
+
+  if (isNumber(model)) {
+    return model
+  } else if (isFunction(model)) {
+    return model()
+  } else if (isArray(model)) {
+    const subModel = randomByWeightModel(generator, model)
+    return randomByModel(generator, subModel)
+  } else {
+    const { type, min, max } = model
+    switch (type) {
+      case Type.Float: return random(generator, min, max)
+      case Type.Integer: return randomInt(generator, min, max)
+      case Type.IntegerInclusive: return randomIntInclusive(generator, min, max)
+    }
+  }
+}

package/src/random-by-weight-model.ts

@@ -0,0 +1,32 @@
+import { NonEmptyArray } from 'justypes'
+import { randomWeighted } from './random-weighted.js'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+
+export type IWeightModel<T> = NonEmptyArray<{
+  weight: number
+  value: T
+}>
+
+export function randomByWeightModel<T>(model: IWeightModel<T>): T
+export function randomByWeightModel<T>(
+  generator: IRandomNumberGenerator
+, model: IWeightModel<T>
+): T
+export function randomByWeightModel<T>(...args:
+| [model: IWeightModel<T>]
+| [generator: IRandomNumberGenerator, model: IWeightModel<T>]
+): T {
+  let generator: IRandomNumberGenerator
+  let model: IWeightModel<T>
+
+  if (args.length === 1) {
+    generator = NativeRandomNumberGenerator
+    ;[model] = args
+  } else {
+    [generator, model] = args
+  }
+
+  const { value } = randomWeighted(generator, model)
+  return value
+}

package/src/random-index-by-weight.ts

@@ -0,0 +1,30 @@
+import { NonEmptyArray } from 'justypes'
+import { mapToIndexByWeight } from './map-to-index-by-weight.js'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+
+export function randomIndexByWeight(weights: NonEmptyArray<number>): number
+export function randomIndexByWeight(
+  generator: IRandomNumberGenerator
+, weights: NonEmptyArray<number>
+): number
+export function randomIndexByWeight(...args:
+| [weights: NonEmptyArray<number>]
+| [generator: IRandomNumberGenerator, weights: NonEmptyArray<number>]
+): number {
+  let generator: IRandomNumberGenerator
+  let weights: NonEmptyArray<number>
+
+  if (args.length === 1) {
+    generator = NativeRandomNumberGenerator
+    ;[weights] = args
+  } else {
+    [generator, weights] = args
+  }
+
+  return mapToIndexByWeight(
+    generator.next()
+  , 0, 1
+  , weights
+  )
+}

package/src/random-int-inclusive.ts

@@ -1,8 +1,33 @@
-import { mapToRange } from './map-to-range'
+import { mapToRange } from './map-to-range.js'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+
+export function randomIntInclusive(
+  min: number
+, max: number
+): number
+export function randomIntInclusive(
+  generator: IRandomNumberGenerator
+, min: number
+, max: number
+): number
+export function randomIntInclusive(...args:
+| [min: number, max: number]
+| [generator: IRandomNumberGenerator, min: number, max: number]
+): number {
+  let generator: IRandomNumberGenerator
+  let min: number
+  let max: number
+
+  if (args.length === 2) {
+    generator = NativeRandomNumberGenerator
+    ;[min, max] = args
+  } else {
+    [generator, min, max] = args
+  }
 
-export function randomIntInclusive(min: number, max: number): number {
   return Math.floor(mapToRange(
-    Math.random()
+    generator.next()
   , 0, 1
   , Math.ceil(min), Math.floor(max) + 1
   ))

package/src/random-int.ts

@@ -1,8 +1,30 @@
-import { mapToRange } from './map-to-range'
+import { mapToRange } from './map-to-range.js'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+
+export function randomInt(min: number, max: number): number
+export function randomInt(
+  generator: IRandomNumberGenerator
+, min: number
+, max: number
+): number
+export function randomInt(...args:
+| [min: number, max: number]
+| [generator: IRandomNumberGenerator, min: number, max: number]
+): number {
+  let generator: IRandomNumberGenerator
+  let min: number
+  let max: number
+
+  if (args.length === 2) {
+    generator = NativeRandomNumberGenerator
+    ;[min, max] = args
+  } else {
+    [generator, min, max] = args
+  }
 
-export function randomInt(min: number, max: number): number {
   return Math.floor(mapToRange(
-    Math.random()
+    generator.next()
   , 0, 1
   , Math.ceil(min), Math.floor(max)
   ))

package/src/random-weighted.ts

@@ -0,0 +1,32 @@
+import { randomIndexByWeight } from './random-index-by-weight.js'
+import { NonEmptyArray } from 'justypes'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+
+export interface IWeighted {
+  weight: number
+}
+
+export function randomWeighted<T extends IWeighted>(values: NonEmptyArray<T>): T
+export function randomWeighted<T extends IWeighted>(
+  generator: IRandomNumberGenerator
+, values: NonEmptyArray<T>
+): T
+export function randomWeighted<T extends IWeighted>(...args:
+| [values: NonEmptyArray<T>]
+| [generator: IRandomNumberGenerator, values: NonEmptyArray<T>]
+): T {
+  let generator: IRandomNumberGenerator
+  let values: NonEmptyArray<T>
+
+  if (args.length === 1) {
+    generator = NativeRandomNumberGenerator
+    ;[values] = args
+  } else {
+    [generator, values] = args
+  }
+
+  const weights = values.map(option => option.weight) as NonEmptyArray<number>
+  const index = randomIndexByWeight(generator, weights)
+  return values[index]
+}

package/src/random.ts

@@ -1,8 +1,30 @@
-import { mapToRange } from './map-to-range'
+import { mapToRange } from './map-to-range.js'
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+
+export function random(min: number, max: number): number
+export function random(
+  generator: IRandomNumberGenerator
+, min: number
+, max: number
+): number
+export function random(...args:
+| [min: number, max: number]
+| [generator: IRandomNumberGenerator, min: number, max: number]
+): number {
+  let generator: IRandomNumberGenerator
+  let min: number
+  let max: number
+
+  if (args.length === 2) {
+    generator = NativeRandomNumberGenerator
+    ;[min, max] = args
+  } else {
+    [generator, min, max] = args
+  }
 
-export function random(min: number, max: number): number {
   return mapToRange(
-    Math.random()
+    generator.next()
   , 0, 1
   , min, max
   )

package/src/types.ts

@@ -0,0 +1,3 @@
+export interface IRandomNumberGenerator {
+  next(): number
+}

package/lib/random-by-weight.d.ts

@@ -1 +0,0 @@
-export declare function randomByWeight(weights: number[]): number;

package/lib/random-by-weight.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomByWeight = void 0;
-const map_to_index_by_weight_1 = require("./map-to-index-by-weight");
-function randomByWeight(weights) {
-    return (0, map_to_index_by_weight_1.mapToIndexByWeight)(Math.random(), 0, 1, weights);
-}
-exports.randomByWeight = randomByWeight;
-//# sourceMappingURL=random-by-weight.js.map

package/lib/random-by-weight.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"random-by-weight.js","sourceRoot":"","sources":["../src/random-by-weight.ts"],"names":[],"mappings":";;;AAAA,qEAA6D;AAE7D,SAAgB,cAAc,CAAC,OAAiB;IAC9C,OAAO,IAAA,2CAAkB,EACvB,IAAI,CAAC,MAAM,EAAE,EACb,CAAC,EAAE,CAAC,EACJ,OAAO,CACR,CAAA;AACH,CAAC;AAND,wCAMC"}

package/src/random-by-weight.ts

@@ -1,9 +0,0 @@
-import { mapToIndexByWeight } from './map-to-index-by-weight'
-
-export function randomByWeight(weights: number[]): number {
-  return mapToIndexByWeight(
-    Math.random()
-  , 0, 1
-  , weights
-  )
-}