extra-rand 0.3.0 → 0.3.2

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,11 +46,16 @@ 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
 ```
 
 ### randomIndexByWeight
 ```ts
 function randomIndexByWeight(weights: NonEmptyArray<number>): number
+function randomIndexByWeight(
+  generator: IRandomNumberGenerator
+, weights: NonEmptyArray<number>
+): number
 ```
 
 The function returns an index of one of weights.
@@ -49,6 +67,10 @@ interface IWeighted {
 }
 
 function randomWeighted<T extends IWeighted>(values: NonEmptyArray<T>): T
+function randomWeighted<T extends IWeighted>(
+  generator: IRandomNumberGenerator
+, values: NonEmptyArray<T>
+): T
 ```
 
 ### randomByWeightModel
@@ -58,7 +80,8 @@ type IWeightModel<T> = NonEmptyArray<{
   value: T
 }>
 
-function randomByWeightModel<T>(model: IWeightModel<T>): number
+function randomByWeightModel<T>(model: IWeightModel<T>): T
+function randomByWeightModel<T>(generator: IRandomNumberGenerator, model: IWeightModel<T>): T
 ```
 
 ### randomByModel
@@ -82,7 +105,15 @@ type IRandomModel =
     value: IRandomModel
   }>
 
+
 function randomByModel(model: IRandomModel): number
+function randomByModel(generator: IRandomNumberGenerator, model: IRandomModel): number
+```
+
+### shuffle
+```ts
+function shuffle(arr: unknown[]): void
+function shuffle(generator: IRandomNumberGenerator, arr: unknown[]): void
 ```
 
 ### mapToRange

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+export * from './types.js';
 export * from './random.js';
 export * from './random-int.js';
 export * from './random-int-inclusive.js';
@@ -6,5 +7,6 @@ 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 './shuffle.js';
 export * from './map-to-range.js';
 export * from './map-to-index-by-weight.js';

package/lib/index.js

@@ -1,3 +1,4 @@
+export * from './types.js';
 export * from './random.js';
 export * from './random-int.js';
 export * from './random-int-inclusive.js';
@@ -6,6 +7,7 @@ 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 './shuffle.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,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"}
+{"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;AACpC,cAAc,cAAc,CAAA;AAE5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,6BAA6B,CAAA"}

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,5 +1,15 @@
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
 import { random } from './random.js';
-export function randomBool(probabilityOfTrue) {
-    return random(0, 1) < probabilityOfTrue;
+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;
 }
 //# 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,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,UAAU,UAAU,CAAC,iBAAyB;IAClD,OAAO,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAA;AACzC,CAAC"}
+{"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

@@ -1,4 +1,5 @@
 import { Getter, NonEmptyArray } from 'justypes';
+import { IRandomNumberGenerator } from './types.js';
 export declare enum Type {
     Float = 0,
     Integer = 1,
@@ -13,3 +14,4 @@ export type IRandomModel = number | Getter<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

@@ -3,13 +3,23 @@ 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(model) {
+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;
     }
@@ -17,15 +27,15 @@ export function randomByModel(model) {
         return model();
     }
     else if (isArray(model)) {
-        const subModel = randomByWeightModel(model);
-        return randomByModel(subModel);
+        const subModel = randomByWeightModel(generator, model);
+        return randomByModel(generator, subModel);
     }
     else {
         const { type, min, max } = model;
         switch (type) {
-            case Type.Float: return random(min, max);
-            case Type.Integer: return randomInt(min, max);
-            case Type.IntegerInclusive: return randomIntInclusive(min, max);
+            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/lib/random-by-model.js.map

@@ -1 +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,MAAM,CAAN,IAAY,IAIX;AAJD,WAAY,IAAI;IACd,iCAAK,CAAA;IACL,qCAAO,CAAA;IACP,uDAAgB,CAAA;AAClB,CAAC,EAJW,IAAI,KAAJ,IAAI,QAIf;AAeD,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,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,KAAK,CAAC,CAAA;QAC3C,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAA;IAChC,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,GAAG,EAAE,GAAG,CAAC,CAAA;YACxC,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC7C,KAAK,IAAI,CAAC,gBAAgB,CAAC,CAAC,OAAO,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;AACH,CAAC"}
+{"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

@@ -1,6 +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

@@ -1,6 +1,16 @@
 import { randomWeighted } from './random-weighted.js';
-export function randomByWeightModel(model) {
-    const { value } = randomWeighted(model);
+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

@@ -1 +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;AAOrD,MAAM,UAAU,mBAAmB,CAAI,KAAsB;IAC3D,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IACvC,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"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

@@ -1,2 +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

@@ -1,5 +1,15 @@
 import { mapToIndexByWeight } from './map-to-index-by-weight.js';
-export function randomIndexByWeight(weights) {
-    return mapToIndexByWeight(Math.random(), 0, 1, weights);
+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

@@ -1 +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,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IAChE,OAAO,kBAAkB,CACvB,IAAI,CAAC,MAAM,EAAE,EACb,CAAC,EAAE,CAAC,EACJ,OAAO,CACR,CAAA;AACH,CAAC"}
+{"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,5 +1,16 @@
 import { mapToRange } from './map-to-range.js';
-export function randomIntInclusive(min, max) {
-    return Math.floor(mapToRange(Math.random(), 0, 1, Math.ceil(min), Math.floor(max) + 1));
+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));
 }
 //# 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,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,GAAW;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAC1B,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"}
+{"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,5 +1,16 @@
 import { mapToRange } from './map-to-range.js';
-export function randomInt(min, max) {
-    return Math.floor(mapToRange(Math.random(), 0, 1, Math.ceil(min), Math.floor(max)));
+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)));
 }
 //# 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,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAC1B,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"}
+{"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

@@ -1,5 +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

@@ -1,7 +1,17 @@
 import { randomIndexByWeight } from './random-index-by-weight.js';
-export function randomWeighted(values) {
+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(weights);
+    const index = randomIndexByWeight(generator, weights);
     return values[index];
 }
 //# sourceMappingURL=random-weighted.js.map

package/lib/random-weighted.js.map

@@ -1 +1 @@
-{"version":3,"file":"random-weighted.js","sourceRoot":"","sources":["../src/random-weighted.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAOjE,MAAM,UAAU,cAAc,CAAsB,MAAwB;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAA0B,CAAA;IAC5E,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}
+{"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,5 +1,16 @@
 import { mapToRange } from './map-to-range.js';
-export function random(min, max) {
-    return mapToRange(Math.random(), 0, 1, min, max);
+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);
 }
 //# sourceMappingURL=random.js.map

package/lib/random.js.map

@@ -1 +1 @@
-{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,GAAW;IAC7C,OAAO,UAAU,CACf,IAAI,CAAC,MAAM,EAAE,EACb,CAAC,EAAE,CAAC,EACJ,GAAG,EAAE,GAAG,CACT,CAAA;AACH,CAAC"}
+{"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/shuffle.d.ts

@@ -0,0 +1,3 @@
+import { IRandomNumberGenerator } from './types.js';
+export declare function shuffle(arr: unknown[]): void;
+export declare function shuffle(generator: IRandomNumberGenerator, arr: unknown[]): void;

package/lib/shuffle.js

@@ -0,0 +1,20 @@
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js';
+import { randomInt } from './random-int.js';
+export function shuffle(...args) {
+    let generator;
+    let arr;
+    if (args.length === 1) {
+        generator = NativeRandomNumberGenerator;
+        [arr] = args;
+    }
+    else {
+        [generator, arr] = args;
+    }
+    for (let targetIndex = arr.length - 1; targetIndex > 1; targetIndex--) {
+        const index = randomInt(generator, 0, targetIndex);
+        const temp = arr[targetIndex];
+        arr[targetIndex] = arr[index];
+        arr[index] = temp;
+    }
+}
+//# sourceMappingURL=shuffle.js.map

package/lib/shuffle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.js","sourceRoot":"","sources":["../src/shuffle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAI3C,MAAM,UAAU,OAAO,CAAC,GAAG,IAE0B;IAEnD,IAAI,SAAiC,CAAA;IACrC,IAAI,GAAc,CAAA;IAElB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,SAAS,GAAG,2BAA2B,CACtC;QAAA,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACf,CAAC;SAAM,CAAC;QACN,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IACzB,CAAC;IAED,KAAK,IAAI,WAAW,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;QACtE,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;QAClD,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,CAAA;QAC7B,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAA;QAC7B,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACnB,CAAC;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.3.0",
+  "version": "0.3.2",
   "description": "Yet another random library",
   "keywords": [
     "random"

package/src/index.ts

@@ -1,3 +1,5 @@
+export * from './types.js'
+
 export * from './random.js'
 export * from './random-int.js'
 export * from './random-int-inclusive.js'
@@ -6,6 +8,7 @@ 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 './shuffle.js'
 
 export * from './map-to-range.js'
 export * from './map-to-index-by-weight.js'

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 { 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

@@ -4,6 +4,8 @@ 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
@@ -24,20 +26,38 @@ export type IRandomModel =
     value: IRandomModel
   }>
 
-export function randomByModel(model: IRandomModel): number {
+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(model)
-    return randomByModel(subModel)
+    const subModel = randomByWeightModel(generator, model)
+    return randomByModel(generator, subModel)
   } else {
     const { type, min, max } = model
     switch (type) {
-      case Type.Float: return random(min, max)
-      case Type.Integer: return randomInt(min, max)
-      case Type.IntegerInclusive: return randomIntInclusive(min, max)
+      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

@@ -1,12 +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 {
-  const { value } = randomWeighted(model)
+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

@@ -1,9 +1,29 @@
 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
+  }
 
-export function randomIndexByWeight(weights: NonEmptyArray<number>): number {
   return mapToIndexByWeight(
-    Math.random()
+    generator.next()
   , 0, 1
   , weights
   )

package/src/random-int-inclusive.ts

@@ -1,8 +1,33 @@
 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.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

@@ -1,12 +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>(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(weights)
+  const index = randomIndexByWeight(generator, weights)
   return values[index]
 }

package/src/random.ts

@@ -1,8 +1,30 @@
 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/shuffle.ts

@@ -0,0 +1,27 @@
+import { IRandomNumberGenerator } from './types.js'
+import { NativeRandomNumberGenerator } from './native-random-number-generator.js'
+import { randomInt } from './random-int.js'
+
+export function shuffle(arr: unknown[]): void
+export function shuffle(generator: IRandomNumberGenerator, arr: unknown[]): void
+export function shuffle(...args:
+| [arr: unknown[]]
+| [generator: IRandomNumberGenerator, arr: unknown[]]
+) {
+  let generator: IRandomNumberGenerator
+  let arr: unknown[]
+
+  if (args.length === 1) {
+    generator = NativeRandomNumberGenerator
+    ;[arr] = args
+  } else {
+    [generator, arr] = args
+  }
+
+  for (let targetIndex = arr.length - 1; targetIndex > 1; targetIndex--) {
+    const index = randomInt(generator, 0, targetIndex)
+    const temp = arr[targetIndex]
+    arr[targetIndex] = arr[index]
+    arr[index] = temp
+  }
+}

package/src/types.ts

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