toosoon-prng 4.0.3 → 4.1.0

package/README.md

@@ -1,6 +1,8 @@
 # TOOSOON Pseudo-Random Number Generator (PRNG)
 
-This project provides PRNG functions for generating pseudo-random values using a seed-based approach and various algorithms. These are particularly useful for applications requiring deterministic randomization, such as procedural generation or simulations.
+This project provides PRNG functions for generating pseudo-random values using a seed-based approach. These are particularly useful for applications requiring deterministic randomization, such as procedural generation or simulations.
+
+[![NPM](https://nodei.co/npm/toosoon-prng.png)](https://nodei.co/npm/toosoon-prng/)
 
 ## Installation
 
@@ -18,172 +20,237 @@ $ npm install toosoon-prng
 
 ## Usage
 
+Using default PRNG instance.
+
 ```ts
 import prng from 'toosoon-prng';
 
 prng.setSeed('seed');
-console.log(prng.randomFloat('angle', 0, Math.PI)); // Pseudo-random number in the interval [0, PI]
-```
 
-## PRNG Functions
+prng.randomFloat('angle', 0, Math.PI); // Pseudo-random number in the interval [0, PI)
+```
 
-All PRNG functions have a `seed` parameter wich allows you to add a sub-seed string to the `PRNG` instance global `seed` in order to get different pseudo-random values while using a PRNG function multiple times.
+Using PRNG class constructor.
 
 ```ts
-prng.setSeed('global-seed');
-console.log(prng.randomBoolean('one')); // Could be true or false
-console.log(prng.randomBoolean('two')); // Could be different from the first pseudo-random value
+import { PRNG } from 'toosoon-prng';
+
+const prng = new PRNG('seed');
+
+prng.randomFloat('angle', 0, Math.PI); // Pseudo-random number in the interval [0, PI)
 ```
 
-##### setSeed(seed)
+## API
 
-Set the `PRNG` instance seed.
+### PRNG <a id="prng"></a>
 
-- `seed`
+Utility class for generating pseudo-random values.
+
+- [new PRNG(seed?, generator?)](#prng-constructor)
+	- [.seed](#prng-seed): `string`
+	- [.generator](#prng-generator): `Function`
+	- [.setSeed(seed?)](#prng-set-seed-method): `void`
+	- [.random(subseed)](#prng-random-method): `number`
+	- [.randomBoolean(subseed, probability?)](#prng-random-boolean-method): `boolean`
+	- [.randomSign(subseed, probability?)](#prng-random-sign-method): `number`
+	- [.randomFloat(subseed, min?, max?, precision?)](#prng-random-float-method): `number`
+	- [.randomInt(subseed, min, max)](#prng-random-int-method): `number`
+	- [.randomHexColor(subseed)](#prng-random-hex-color-method): `string`
+	- [.randomItem(subseed, array)](#prng-random-item-method): `unknown|undefined`
+	- [.randomObjectProperty(subseed, object)](#prng-random-object-property-method): `unknown|undefined`
+	- [.randomIndex(subseed, weights)](#prng-random-index-method): `number`
+	- [.randomGaussian(subseed, mean?, spread?)](#prng-random-gaussian-method): `number`
+
+#### Types
 
 ```ts
-prng.setSeed(seed: string | number): void;
+type Seed = string | number;
+
+type Generator = (...hashes: number[]) => number;
 ```
 
-##### setAlgorithm(algorithmName)
+#### Constructor <a id="prng-constructor"></a>
+
+| Parameter   | Type        | Default | Description                                            |
+| ----------- | ----------- | ------- | ------------------------------------------------------ |
+| [seed]      | `Seed`      |         | Seed string used for pseudo-random generations.        |
+| [generator] | `Generator` | `sfc32` | Generator function used for pseudo-random generations. |
 
-Set the `PRNG` algorithm for generating pseudo-random values.
+#### Properties
 
-- `algorithmName`: Algorithm name.
+##### .`seed` <a id="prng-seed"></a>
+
+Seed string used for pseudo-random generations.
+
+```ts
+PRNG.seed: string;
+```
+
+##### .`generator` <a id="prng-generator"></a>
+
+Generator function used for pseudo-random generations.
 
 ```ts
-prng.setAlgorithm(algorithmName: AlgorithmName): void;
+PRNG.generator: Generator;
 ```
 
-##### random(seed)
+#### Methods
 
-Generate a pseudo-random number in the interval [0, 1]. PRNG equivalent of `Math.random()`.
+##### .`setSeed(seed)` <a id="prng-set-seed-method"></a>
+
+Set the `PRNG` instance seed.
 
 - `seed`
 
 ```ts
-prng.random(seed: string | number): number;
+PRNG.setSeed(seed: Seed): void;
 ```
 
-##### randomBoolean(seed)
+##### .`random(subseed)` <a id="prng-random-method"></a>
+
+Generate a pseudo-random number between 0 and 1 (0 inclusive, 1 exclusive). 
+Pseudo-random equivalent of `Math.random()`.
+
+- `subseed`
+
+```ts
+PRNG.random(subseed: Seed): number;
+```
+
+##### .`randomBoolean(subseed, probability?)` <a id="prng-random-boolean-method"></a>
 
 Generate a pseudo-random boolean (true or false).
 
-- `seed`
+- `subseed`
 - `[probability=0.5]`: Probability to get true.
 
 ```ts
-prng.randomBoolean(seed: string | number, probability?: number): boolean;
+PRNG.randomBoolean(subseed: Seed, probability?: number): boolean;
 ```
 
-##### randomSign(seed)
+##### .`randomSign(subseed, probability?)` <a id="prng-random-sign-method"></a>
 
 Generate a pseudo-random sign (1 or -1).
 
-- `seed`
+- `subseed`
 - `[probability=0.5]`: Probability to get 1.
 
 ```ts
-prng.randomSign(seed: string | number, probability?: number): number;
+PRNG.randomSign(subseed: Seed, probability?: number): number;
 ```
 
-##### randomFloat(seed, min, max)
+##### .`randomFloat(subseed, min?, max?, precision?)` <a id="prng-random-float-method"></a>
 
-Generate pseudo-random a floating-point number within a specified range.
+Generate a pseudo-random floating-point number within a specified range.
 
-- `seed`
+- `subseed`
 - `[min=0]`: Minimum boundary.
 - `[max=1]`: Maximum boundary.
 - `[precison=2]`: Number of digits after the decimal point.
 
 ```ts
-prng.randomFloat(seed: string | number, min?: number, max?: number1, precision?: number): number;
+PRNG.randomFloat(subseed: Seed, min?: number, max?: number1, precision?: number): number;
 ```
 
-##### randomInt(seed, min, max)
+##### .`randomInt(subseed, min, max)` <a id="prng-random-int-method"></a>
 
-Generate pseudo-random integer number within a specified range.
+Generate a pseudo-random integer number within a specified range.
 
-- `seed`
+- `subseed`
 - `min`: Minimum boundary.
 - `max`: Maximum boundary.
 
 ```ts
-prng.randomInt(seed: string | number, min: number, max: number): void;
+PRNG.randomInt(subseed: Seed, min: number, max: number): void;
 ```
 
-##### randomHexColor(seed)
+##### .`randomHexColor(subseed)` <a id="prng-random-hex-color-method"></a>
 
 Generate a pseudo-random hexadecimal color.
 
-- `seed`
+- `subseed`
 
 ```ts
-prng.randomHexColor(seed: string | number): string;
+PRNG.randomHexColor(subseed: Seed): string;
 ```
 
-##### randomItem(seed0 array)
+##### .`randomItem(subseed, array)` <a id="prng-random-item-method"></a>
 
-Pick a pseudo-random item from a given array.
+Pseudo-randomly pick an item from an array.
 
-- `seed`
+- `subseed`
 - `array`: Array to pick the item from.
 
 ```ts
-prng.randomItem<T>(seed: string | number, array: T[]): T | undefined;
+PRNG.randomItem<T>(subseed: Seed, array: T[]): T | undefined;
 ```
 
-##### randomObjectProperty(seed, object)
+##### .`randomObjectProperty(subseed, object)` <a id="prng-random-object-property-method"></a>
 
-Pick a pseudo-random property value from a given object.
+Pseudo-randomly pick a property value from an object.
 
-- `seed`
+- `subseed`
 - `object`: Object to pick the property from.
 
 ```ts
-prng.randomObjectProperty<T>(seed: string | number, object: Record<string, T>): T | undefined;
+PRNG.randomObjectProperty<T>(subseed: Seed, object: Record<string, T>): T | undefined;
 ```
 
-##### randomIndex(seed, weights)
+##### .`randomIndex(subseed, weights)` <a id="prng-random-index-method"></a>
 
 Select a pseudo-random index from an array of weighted items.
 
-- `seed`
-- `weights`: Array of weights
+- `subseed`
+- `weights`: Array of weights.
 
 ```ts
-prng.randomIndex(seed: string | number, weights: number[]): number;
+PRNG.randomIndex(subseed: Seed, weights: number[]): number;
 ```
 
-##### randomGaussian(seed, mean, spread)
+##### .`randomGaussian(subseed, mean?, spread?)` <a id="prng-random-gaussian-method"></a>
 
 Generate a pseudo-random number fitting a Gaussian (normal) distribution.
 
-`seed`
-`[mean=0]`: Central value.
-`[spread=1]`: Standard deviation.
+- `subseed`
+- `[mean=0]`: Mean (central) value of the distribution.
+- `[spread=1]`: Spread (standard deviation) of the distribution.
 
 ```ts
-prng.randomGaussian(seed: string | number, mean?: number, spread?: number): number;
+PRNG.randomGaussian(subseed: Seed, mean?: number, spread?: number): number;
 ```
 
-## Algorithms
+### Generators
 
-By default, the library is using _SplitMix32_ algorithm for generating the pseudo-random values but it is possible to change the algorithm used by one of the following:
+By default, the library is using _SplitMix32_ generator for generating the pseudo-random values but it is possible to change the generator used by one of the following:
 
-- `jsf32`: _Jenkins' Small Fast_, Generator with a 32-bit state.
-- `mulberry32`: _Mulberry32_, Generator with a 32-bit state.
 - `sfc32`: _Simple Fast Counter_, Generator with a 128-bit state.
-- `splitmix32`: _SplitMix32_, Generator with a 32-bit state.
+- `jsf32`: _Jenkins' Small Fast_, Generator with a 128-bit state.
 - `xoshiro128ss`: _xoshiro128\*\*_, Generator with a 128-bit state.
+- `mulberry32`: _Mulberry32_, Generator with a 32-bit state.
+- `splitmix32`: _SplitMix32_, Generator with a 32-bit state.
 
 ```ts
-import prng, { Algorithm } from 'toosoon-prng';
+import { PRNG, sfc32 } from 'toosoon-prng';
 
-// Set 'Simple Fast Counter' as the PRNG instance algorithm
-prng.setAlgorithm(Algorithm.sfc32);
+const prng = new PRNG('seed', { generator: sfc32 });
 ```
 
+### Utils
+
+##### `randomSeed(length?)`
+
+Generate a random string that can be used as a seed.
+
+- `[length=64]`: Length of the generated seed string.
+
+```ts
+randomSeed(length?: number): string;
+```
+
+### Constants
+
+`DEFAULT_SEED`
+
 ## License
 
 MIT License, see [LICENSE](https://github.com/toosoon-dev/toosoon-prng/tree/master/LICENSE) for details.

package/lib/constants.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_SEED = "0x0000000000000000000000000000000000000000000000000000000000000000";

package/lib/constants.js

@@ -0,0 +1 @@
+export const DEFAULT_SEED = '0x0000000000000000000000000000000000000000000000000000000000000000';

package/lib/generators.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Produce a 128-bit hash value from a seed string
+ *
+ * @param {string} seed
+ * @returns {[number, number, number, number]}
+ */
+export declare function cyrb128(seed: string): [number, number, number, number];
+/**
+ * Simple Fast Counter
+ * 128-bit state PRNG
+ *
+ * @param {number} a
+ * @param {number} b
+ * @param {number} c
+ * @param {number} d
+ * @returns {number}
+ */
+export declare function sfc32(a: number, b: number, c: number, d: number): number;
+/**
+ * Jenkins' Small Fast
+ * 128-bit state PRNG
+ *
+ * @param {number} a
+ * @param {number} b
+ * @param {number} c
+ * @param {number} d
+ * @returns {number}
+ */
+export declare function jsf32(a: number, b: number, c: number, d: number): number;
+/**
+ * xoshiro128**
+ * 128-bit state PRNG
+ *
+ * @param {number} a
+ * @param {number} b
+ * @param {number} c
+ * @param {number} d
+ * @returns {number}
+ */
+export declare function xoshiro128ss(a: number, b: number, c: number, d: number): number;
+/**
+ * Mulberry32
+ * 32-bit state PRNG
+ *
+ * @param {number} a
+ * @returns {number}
+ */
+export declare function mulberry32(a: number): number;
+/**
+ * SplitMix
+ * 32-bit state PRNG
+ *
+ * @param {number} a
+ * @returns {number}
+ */
+export declare function splitmix32(a: number): number;

package/lib/generators.js

@@ -0,0 +1,125 @@
+/**
+ * Produce a 128-bit hash value from a seed string
+ *
+ * @param {string} seed
+ * @returns {[number, number, number, number]}
+ */
+export function cyrb128(seed) {
+    let h1 = 1779033703;
+    let h2 = 3144134277;
+    let h3 = 1013904242;
+    let h4 = 2773480762;
+    for (let i = 0, k; i < seed.length; i++) {
+        k = seed.charCodeAt(i);
+        h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+        h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+        h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+        h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+    }
+    h1 = Math.imul(h3 ^ (h1 >>> 18), 597399067);
+    h2 = Math.imul(h4 ^ (h2 >>> 22), 2869860233);
+    h3 = Math.imul(h1 ^ (h3 >>> 17), 951274213);
+    h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);
+    return [
+        (h1 ^ h2 ^ h3 ^ h4) >>> 0,
+        (h2 ^ h1) >>> 0,
+        (h3 ^ h1) >>> 0,
+        (h4 ^ h1) >>> 0
+    ];
+}
+/**
+ * Simple Fast Counter
+ * 128-bit state PRNG
+ *
+ * @param {number} a
+ * @param {number} b
+ * @param {number} c
+ * @param {number} d
+ * @returns {number}
+ */
+export function sfc32(a, b, c, d) {
+    a >>>= 0;
+    b >>>= 0;
+    c >>>= 0;
+    d >>>= 0;
+    let t = (a + b | 0) + d | 0;
+    d = d + 1 | 0;
+    a = b ^ b >>> 9;
+    b = c + (c << 3) | 0;
+    c = (c << 21 | c >>> 11);
+    c = c + t | 0;
+    return (t >>> 0) / 4294967296;
+}
+/**
+ * Jenkins' Small Fast
+ * 128-bit state PRNG
+ *
+ * @param {number} a
+ * @param {number} b
+ * @param {number} c
+ * @param {number} d
+ * @returns {number}
+ */
+export function jsf32(a, b, c, d) {
+    a |= 0;
+    b |= 0;
+    c |= 0;
+    d |= 0;
+    let t = (a - ((b << 27) | (b >>> 5))) | 0;
+    a = b ^ ((c << 17) | (c >>> 15));
+    b = (c + d) | 0;
+    c = (d + t) | 0;
+    d = (a + t) | 0;
+    return (d >>> 0) / 4294967296;
+}
+/**
+ * xoshiro128**
+ * 128-bit state PRNG
+ *
+ * @param {number} a
+ * @param {number} b
+ * @param {number} c
+ * @param {number} d
+ * @returns {number}
+ */
+export function xoshiro128ss(a, b, c, d) {
+    let t = b << 9;
+    let r = a * 5;
+    r = ((r << 7) | (r >>> 25)) * 9;
+    c ^= a;
+    d ^= b;
+    b ^= c;
+    a ^= d;
+    c ^= t;
+    d = (d << 11) | (d >>> 21);
+    return (r >>> 0) / 4294967296;
+}
+/**
+ * Mulberry32
+ * 32-bit state PRNG
+ *
+ * @param {number} a
+ * @returns {number}
+ */
+export function mulberry32(a) {
+    let t = (a += 0x6d2b79f5);
+    t = Math.imul(t ^ (t >>> 15), t | 1);
+    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+}
+/**
+ * SplitMix
+ * 32-bit state PRNG
+ *
+ * @param {number} a
+ * @returns {number}
+ */
+export function splitmix32(a) {
+    a |= 0;
+    a = (a + 0x9e3779b9) | 0;
+    var t = a ^ (a >>> 16);
+    t = Math.imul(t, 0x21f0aaad);
+    t = t ^ (t >>> 15);
+    t = Math.imul(t, 0x735a2d97);
+    return ((t = t ^ (t >>> 15)) >>> 0) / 4294967296;
+}

package/lib/index.d.ts

@@ -1,2 +1,5 @@
+export { DEFAULT_SEED } from './constants';
+export { cyrb128, sfc32, jsf32, xoshiro128ss, splitmix32, mulberry32 } from './generators';
+export { randomSeed } from './utils';
 export { default, PRNG } from './prng';
 export type * from './types';

package/lib/index.js

@@ -1 +1,4 @@
+export { DEFAULT_SEED } from './constants';
+export { cyrb128, sfc32, jsf32, xoshiro128ss, splitmix32, mulberry32 } from './generators';
+export { randomSeed } from './utils';
 export { default, PRNG } from './prng';

package/lib/prng.d.ts

@@ -1,4 +1,4 @@
-import { AlgorithmFunction, AlgorithmName } from './types';
+import type { Seed, Generator } from './types';
 /**
  * Utility class for generating pseudo-random values
  *
@@ -6,114 +6,110 @@ import { AlgorithmFunction, AlgorithmName } from './types';
  * @exports
  */
 export declare class PRNG {
-    protected _seed: string;
-    protected _algorithm: AlgorithmFunction;
-    get seed(): string | number;
-    set seed(seed: string | number);
-    get algorithm(): AlgorithmFunction;
-    set algorithm(algorithm: AlgorithmFunction);
     /**
-     * Set this PRNG seed
-     *
-     * @param {string|number} seed
+     * Seed string used for pseudo-random generations
+     */
+    seed: string;
+    /**
+     * Generator function used for pseudo-random generations
+     */
+    readonly generator: Generator;
+    /**
+     * @param {Seed} [seed] Seed string used for pseudo-random generations
+     * @param {Generator} [generator=sfc32] Generator function used for pseudo-random generations
      */
-    setSeed(seed: string | number): void;
+    constructor(seed?: Seed, generator?: Generator);
     /**
-     * Set this PRNG algorithm
+     * Set this PRNG seed
      *
-     * @param {AlgorithmName} algorithmName Algorithm name
+     * @param {Seed} seed
      */
-    setAlgorithm(algorithmName: AlgorithmName): void;
+    setSeed(seed?: Seed): void;
     /**
-     * Generate a pseudo-random number in the interval [0, 1]
-     * PRNG equivalent of `Math.random()`
+     * Generate a pseudo-random number between 0 and 1 (0 inclusive, 1 exclusive)
+     * Pseudo-random equivalent of `Math.random()`
      *
-     * @param {string|number} seed
-     * @returns {number}
+     * @param {Seed} subseed
+     * @returns {number} Generated pseudo-random number between `0` and `1`
      */
-    random(seed: string | number): number;
+    random(subseed: Seed): number;
     /**
      * Generate a pseudo-random boolean (true or false)
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @param {number} [probability=0.5] Probability to get `true`
      * @returns {boolean} Either `true` or `false`
      */
-    randomBoolean(seed: string | number, probability?: number): boolean;
+    randomBoolean(subseed: Seed, probability?: number): boolean;
     /**
      * Generate a pseudo-random sign (1 or -1)
      *
-     * @param {string|number} seed
-     * @param {number} [probability=0.5] Probability to get 1
-     * @returns {number} Either 1 or -1
+     * @param {Seed} subseed
+     * @param {number} [probability=0.5] Probability to get `1`
+     * @returns {number} Either `1` or `-1`
      */
-    randomSign(seed: string | number, probability?: number): number;
+    randomSign(subseed: Seed, probability?: number): number;
     /**
      * Generate a pseudo-random floating-point number within a specified range
      *
-     * @param {string|number} seed
-     * @param {number} [min=0]       Minimum boundary
-     * @param {number} [max=1]       Maximum boundary
+     * @param {Seed} subseed
+     * @param {number} [min=0] Minimum boundary
+     * @param {number} [max=1] Maximum boundary
      * @param {number} [precision=2] Number of digits after the decimal point
-     * @returns {number} Generated float
+     * @returns {number} Generated floating-point number
      */
-    randomFloat(seed: string | number, min?: number, max?: number, precision?: number): number;
+    randomFloat(subseed: Seed, min?: number, max?: number, precision?: number): number;
     /**
      * Generate a pseudo-random integer number within a specified range
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @param {number} min Minimum boundary
      * @param {number} max Maximum boundary
-     * @returns {number} Generated integer
+     * @returns {number} Generated integer number
      */
-    randomInt(seed: string | number, min: number, max: number): number;
+    randomInt(subseed: Seed, min: number, max: number): number;
     /**
      * Generate a pseudo-random hexadecimal color
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @returns {string} Generated hexadecimal color
      */
-    randomHexColor(seed: string | number): string;
+    randomHexColor(subseed: Seed): string;
     /**
-     * Pick a pseudo-random item from a given array
+     * Pseudo-randomly pick an item from an array
      *
-     * @param {string|number} seed
+     * @template [T=unknown]
+     * @param {Seed} subseed
      * @param {T[]} array Array to pick the item from
-     * @returns {T|undefined} Random item picked
+     * @returns {T|undefined} Item picked
      */
-    randomItem<T = unknown>(seed: string | number, array: T[]): T | undefined;
+    randomItem<T = unknown>(subseed: Seed, array: T[]): T | undefined;
     /**
-     * Pick a pseudo-random property value from a given object
+     * Pseudo-randomly pick a property value from an object
      *
-     * @param {string|number} seed
+     * @template [T=unknown]
+     * @param {Seed} subseed
      * @param {object} object Object to pick the property from
-     * @returns {T|undefined} Random item picked
+     * @returns {T|undefined} Pseudo-random property value picked
      */
-    randomObjectProperty<T = unknown>(seed: string | number, object: Record<string, T>): T | undefined;
+    randomObjectProperty<T = unknown>(subseed: Seed, object: Record<string, T>): T | undefined;
     /**
      * Select a pseudo-random index from an array of weighted items
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @param {number[]} weights Array of weights
-     * @returns {number} Random index based on weights
+     * @returns {number} Pseudo-random index based on weights
      */
-    randomIndex(seed: string | number, weights: number[]): number;
+    randomIndex(subseed: Seed, weights: number[]): number;
     /**
      * Generate a pseudo-random number fitting a Gaussian (normal) distribution
      *
-     * @param {string|number} seed
-     * @param {number} [mean=0]   Central value
-     * @param {number} [spread=1] Standard deviation
-     * @returns Generated number
-     */
-    randomGaussian(seed: string | number, mean?: number, spread?: number): number;
-    /**
-     * Get the PRNG algorithm function by its name
-     *
-     * @param {AlgorithmName} algorithmName Algorithm name
-     * @returns {Function} PRNG algorithm function
+     * @param {Seed} subseed
+     * @param {number} [mean=0] Mean (central) value of the distribution
+     * @param {number} [spread=1] Spread (standard deviation) of the distribution
+     * @returns {number} Generated number
      */
-    protected getAlgorithmByName(algorithmName: AlgorithmName): (...args: number[]) => number;
+    randomGaussian(subseed: Seed, mean?: number, spread?: number): number;
 }
 declare const prng: PRNG;
 export default prng;

package/lib/prng.js

@@ -1,5 +1,6 @@
-import { cyrb128, jsf32, mulberry32, sfc32, splitmix32, xoshiro128ss } from 'toosoon-utils/prng';
-import { AlgorithmName } from './types';
+import { DEFAULT_SEED } from './constants';
+import { cyrb128, sfc32 } from './generators';
+import { randomSeed } from './utils';
 /**
  * Utility class for generating pseudo-random values
  *
@@ -7,121 +8,117 @@ import { AlgorithmName } from './types';
  * @exports
  */
 export class PRNG {
-    _seed = '';
-    _algorithm = splitmix32;
-    get seed() {
-        return this._seed;
-    }
-    set seed(seed) {
-        this._seed = `${seed}`;
-    }
-    get algorithm() {
-        return this._algorithm;
-    }
-    set algorithm(algorithm) {
-        this._algorithm = algorithm;
-    }
     /**
-     * Set this PRNG seed
-     *
-     * @param {string|number} seed
+     * Seed string used for pseudo-random generations
+     */
+    seed = '';
+    /**
+     * Generator function used for pseudo-random generations
      */
-    setSeed(seed) {
+    generator;
+    /**
+     * @param {Seed} [seed] Seed string used for pseudo-random generations
+     * @param {Generator} [generator=sfc32] Generator function used for pseudo-random generations
+     */
+    constructor(seed = randomSeed(), generator = sfc32) {
         this.seed = `${seed}`;
+        this.generator = generator;
     }
     /**
-     * Set this PRNG algorithm
+     * Set this PRNG seed
      *
-     * @param {AlgorithmName} algorithmName Algorithm name
+     * @param {Seed} seed
      */
-    setAlgorithm(algorithmName) {
-        this.algorithm = this.getAlgorithmByName(algorithmName);
+    setSeed(seed = randomSeed()) {
+        this.seed = `${seed}`;
     }
     /**
-     * Generate a pseudo-random number in the interval [0, 1]
-     * PRNG equivalent of `Math.random()`
+     * Generate a pseudo-random number between 0 and 1 (0 inclusive, 1 exclusive)
+     * Pseudo-random equivalent of `Math.random()`
      *
-     * @param {string|number} seed
-     * @returns {number}
+     * @param {Seed} subseed
+     * @returns {number} Generated pseudo-random number between `0` and `1`
      */
-    random(seed) {
-        const hashes = cyrb128(this.seed + `${seed}`);
-        return this.algorithm(...hashes);
+    random(subseed) {
+        const hashes = cyrb128(this.seed + `${subseed}`);
+        return this.generator(...hashes);
     }
     /**
      * Generate a pseudo-random boolean (true or false)
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @param {number} [probability=0.5] Probability to get `true`
      * @returns {boolean} Either `true` or `false`
      */
-    randomBoolean(seed, probability = 0.5) {
-        return this.random(seed) < probability;
+    randomBoolean(subseed, probability = 0.5) {
+        return this.random(subseed) < probability;
     }
     /**
      * Generate a pseudo-random sign (1 or -1)
      *
-     * @param {string|number} seed
-     * @param {number} [probability=0.5] Probability to get 1
-     * @returns {number} Either 1 or -1
+     * @param {Seed} subseed
+     * @param {number} [probability=0.5] Probability to get `1`
+     * @returns {number} Either `1` or `-1`
      */
-    randomSign(seed, probability = 0.5) {
-        return this.randomBoolean(seed, probability) ? 1 : -1;
+    randomSign(subseed, probability = 0.5) {
+        return this.randomBoolean(subseed, probability) ? 1 : -1;
     }
     /**
      * Generate a pseudo-random floating-point number within a specified range
      *
-     * @param {string|number} seed
-     * @param {number} [min=0]       Minimum boundary
-     * @param {number} [max=1]       Maximum boundary
+     * @param {Seed} subseed
+     * @param {number} [min=0] Minimum boundary
+     * @param {number} [max=1] Maximum boundary
      * @param {number} [precision=2] Number of digits after the decimal point
-     * @returns {number} Generated float
+     * @returns {number} Generated floating-point number
      */
-    randomFloat(seed, min = 0, max = 1, precision = 2) {
-        return parseFloat(Math.min(min + this.random(seed) * (max - min), max).toFixed(precision));
+    randomFloat(subseed, min = 0, max = 1, precision = 2) {
+        return parseFloat(Math.min(min + this.random(subseed) * (max - min), max).toFixed(precision));
     }
     /**
      * Generate a pseudo-random integer number within a specified range
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @param {number} min Minimum boundary
      * @param {number} max Maximum boundary
-     * @returns {number} Generated integer
+     * @returns {number} Generated integer number
      */
-    randomInt(seed, min, max) {
-        return Math.floor(this.random(seed) * (max - min + 1) + min);
+    randomInt(subseed, min, max) {
+        return Math.floor(this.random(subseed) * (max - min + 1) + min);
     }
     /**
      * Generate a pseudo-random hexadecimal color
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @returns {string} Generated hexadecimal color
      */
-    randomHexColor(seed) {
-        return '#' + ('00000' + ((this.random(seed) * (1 << 24)) | 0).toString(16)).slice(-6);
+    randomHexColor(subseed) {
+        return '#' + ('00000' + ((this.random(subseed) * (1 << 24)) | 0).toString(16)).slice(-6);
     }
     /**
-     * Pick a pseudo-random item from a given array
+     * Pseudo-randomly pick an item from an array
      *
-     * @param {string|number} seed
+     * @template [T=unknown]
+     * @param {Seed} subseed
      * @param {T[]} array Array to pick the item from
-     * @returns {T|undefined} Random item picked
+     * @returns {T|undefined} Item picked
      */
-    randomItem(seed, array) {
+    randomItem(subseed, array) {
         if (array.length === 0)
             return undefined;
-        return array[this.randomInt(seed, 0, array.length - 1)];
+        return array[this.randomInt(subseed, 0, array.length - 1)];
     }
     /**
-     * Pick a pseudo-random property value from a given object
+     * Pseudo-randomly pick a property value from an object
      *
-     * @param {string|number} seed
+     * @template [T=unknown]
+     * @param {Seed} subseed
      * @param {object} object Object to pick the property from
-     * @returns {T|undefined} Random item picked
+     * @returns {T|undefined} Pseudo-random property value picked
      */
-    randomObjectProperty(seed, object) {
+    randomObjectProperty(subseed, object) {
         const keys = Object.keys(object);
-        const key = this.randomItem(seed, keys);
+        const key = this.randomItem(subseed, keys);
         if (key && object.hasOwnProperty(key)) {
             return object[key];
         }
@@ -129,11 +126,11 @@ export class PRNG {
     /**
      * Select a pseudo-random index from an array of weighted items
      *
-     * @param {string|number} seed
+     * @param {Seed} subseed
      * @param {number[]} weights Array of weights
-     * @returns {number} Random index based on weights
+     * @returns {number} Pseudo-random index based on weights
      */
-    randomIndex(seed, weights) {
+    randomIndex(subseed, weights) {
         if (weights.length === 0)
             return -1;
         let totalWeight = 0;
@@ -142,7 +139,7 @@ export class PRNG {
         }
         if (totalWeight <= 0)
             console.warn('PRNG.randomIndex()', 'Weights must sum to > 0', totalWeight);
-        let weight = this.random(seed) * totalWeight;
+        let weight = this.random(subseed) * totalWeight;
         for (let i = 0; i < weights.length; i++) {
             if (weight < weights[i])
                 return i;
@@ -153,38 +150,18 @@ export class PRNG {
     /**
      * Generate a pseudo-random number fitting a Gaussian (normal) distribution
      *
-     * @param {string|number} seed
-     * @param {number} [mean=0]   Central value
-     * @param {number} [spread=1] Standard deviation
-     * @returns Generated number
+     * @param {Seed} subseed
+     * @param {number} [mean=0] Mean (central) value of the distribution
+     * @param {number} [spread=1] Spread (standard deviation) of the distribution
+     * @returns {number} Generated number
      */
-    randomGaussian(seed, mean = 0, spread = 1) {
-        const hashes = cyrb128(this.seed + `${seed}`);
-        const u = this.algorithm(hashes[0] + hashes[1]);
-        const v = this.algorithm(hashes[2] + hashes[3]);
+    randomGaussian(subseed, mean = 0, spread = 1) {
+        const hashes = cyrb128(this.seed + `${subseed}`);
+        const u = this.generator(hashes[0], hashes[1], hashes[2], hashes[3]);
+        const v = this.generator(hashes[3], hashes[2], hashes[1], hashes[0]);
         const z = Math.sqrt(-2.0 * Math.log(u)) * Math.cos(2.0 * Math.PI * v);
         return mean + z * spread;
     }
-    /**
-     * Get the PRNG algorithm function by its name
-     *
-     * @param {AlgorithmName} algorithmName Algorithm name
-     * @returns {Function} PRNG algorithm function
-     */
-    getAlgorithmByName(algorithmName) {
-        switch (algorithmName) {
-            case AlgorithmName.jsf32:
-                return jsf32;
-            case AlgorithmName.mulberry32:
-                return mulberry32;
-            case AlgorithmName.sfc32:
-                return sfc32;
-            case AlgorithmName.splitmix32:
-                return splitmix32;
-            case AlgorithmName.xoshiro128ss:
-                return xoshiro128ss;
-        }
-    }
 }
-const prng = new PRNG();
+const prng = new PRNG(DEFAULT_SEED);
 export default prng;

package/lib/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"program":{"fileNames":["../node_modules/typescript/lib/lib.es5.d.ts","../node_modules/typescript/lib/lib.es2015.d.ts","../node_modules/typescript/lib/lib.es2016.d.ts","../node_modules/typescript/lib/lib.es2017.d.ts","../node_modules/typescript/lib/lib.es2018.d.ts","../node_modules/typescript/lib/lib.es2019.d.ts","../node_modules/typescript/lib/lib.es2020.d.ts","../node_modules/typescript/lib/lib.es2021.d.ts","../node_modules/typescript/lib/lib.es2022.d.ts","../node_modules/typescript/lib/lib.es2023.d.ts","../node_modules/typescript/lib/lib.esnext.d.ts","../node_modules/typescript/lib/lib.dom.d.ts","../node_modules/typescript/lib/lib.dom.iterable.d.ts","../node_modules/typescript/lib/lib.es2015.core.d.ts","../node_modules/typescript/lib/lib.es2015.collection.d.ts","../node_modules/typescript/lib/lib.es2015.generator.d.ts","../node_modules/typescript/lib/lib.es2015.iterable.d.ts","../node_modules/typescript/lib/lib.es2015.promise.d.ts","../node_modules/typescript/lib/lib.es2015.proxy.d.ts","../node_modules/typescript/lib/lib.es2015.reflect.d.ts","../node_modules/typescript/lib/lib.es2015.symbol.d.ts","../node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../node_modules/typescript/lib/lib.es2016.array.include.d.ts","../node_modules/typescript/lib/lib.es2016.intl.d.ts","../node_modules/typescript/lib/lib.es2017.date.d.ts","../node_modules/typescript/lib/lib.es2017.object.d.ts","../node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts","../node_modules/typescript/lib/lib.es2017.string.d.ts","../node_modules/typescript/lib/lib.es2017.intl.d.ts","../node_modules/typescript/lib/lib.es2017.typedarrays.d.ts","../node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts","../node_modules/typescript/lib/lib.es2018.asynciterable.d.ts","../node_modules/typescript/lib/lib.es2018.intl.d.ts","../node_modules/typescript/lib/lib.es2018.promise.d.ts","../node_modules/typescript/lib/lib.es2018.regexp.d.ts","../node_modules/typescript/lib/lib.es2019.array.d.ts","../node_modules/typescript/lib/lib.es2019.object.d.ts","../node_modules/typescript/lib/lib.es2019.string.d.ts","../node_modules/typescript/lib/lib.es2019.symbol.d.ts","../node_modules/typescript/lib/lib.es2019.intl.d.ts","../node_modules/typescript/lib/lib.es2020.bigint.d.ts","../node_modules/typescript/lib/lib.es2020.date.d.ts","../node_modules/typescript/lib/lib.es2020.promise.d.ts","../node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts","../node_modules/typescript/lib/lib.es2020.string.d.ts","../node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts","../node_modules/typescript/lib/lib.es2020.intl.d.ts","../node_modules/typescript/lib/lib.es2020.number.d.ts","../node_modules/typescript/lib/lib.es2021.promise.d.ts","../node_modules/typescript/lib/lib.es2021.string.d.ts","../node_modules/typescript/lib/lib.es2021.weakref.d.ts","../node_modules/typescript/lib/lib.es2021.intl.d.ts","../node_modules/typescript/lib/lib.es2022.array.d.ts","../node_modules/typescript/lib/lib.es2022.error.d.ts","../node_modules/typescript/lib/lib.es2022.intl.d.ts","../node_modules/typescript/lib/lib.es2022.object.d.ts","../node_modules/typescript/lib/lib.es2022.sharedmemory.d.ts","../node_modules/typescript/lib/lib.es2022.string.d.ts","../node_modules/typescript/lib/lib.es2022.regexp.d.ts","../node_modules/typescript/lib/lib.es2023.array.d.ts","../node_modules/typescript/lib/lib.es2023.collection.d.ts","../node_modules/typescript/lib/lib.esnext.collection.d.ts","../node_modules/typescript/lib/lib.esnext.intl.d.ts","../node_modules/typescript/lib/lib.esnext.disposable.d.ts","../node_modules/typescript/lib/lib.esnext.promise.d.ts","../node_modules/typescript/lib/lib.esnext.decorators.d.ts","../node_modules/typescript/lib/lib.esnext.object.d.ts","../node_modules/typescript/lib/lib.decorators.d.ts","../node_modules/typescript/lib/lib.decorators.legacy.d.ts","../node_modules/toosoon-utils/lib/prng.d.ts","../src/types.ts","../src/prng.ts","../src/index.ts"],"fileInfos":[{"version":"824cb491a40f7e8fdeb56f1df5edf91b23f3e3ee6b4cde84d4a99be32338faee","affectsGlobalScope":true},"45b7ab580deca34ae9729e97c13cfd999df04416a79116c3bfb483804f85ded4","3facaf05f0c5fc569c5649dd359892c98a85557e3e0c847964caeb67076f4d75","9a68c0c07ae2fa71b44384a839b7b8d81662a236d4b9ac30916718f7510b1b2d","5e1c4c362065a6b95ff952c0eab010f04dcd2c3494e813b493ecfd4fcb9fc0d8","68d73b4a11549f9c0b7d352d10e91e5dca8faa3322bfb77b661839c42b1ddec7","5efce4fc3c29ea84e8928f97adec086e3dc876365e0982cc8479a07954a3efd4","feecb1be483ed332fad555aff858affd90a48ab19ba7272ee084704eb7167569","5514e54f17d6d74ecefedc73c504eadffdeda79c7ea205cf9febead32d45c4bc","1c0cdb8dc619bc549c3e5020643e7cf7ae7940058e8c7e5aefa5871b6d86f44b","886e50ef125efb7878f744e86908884c0133e7a6d9d80013f421b0cd8fb2af94",{"version":"87d693a4920d794a73384b3c779cadcb8548ac6945aa7a925832fe2418c9527a","affectsGlobalScope":true},{"version":"76f838d5d49b65de83bc345c04aa54c62a3cfdb72a477dc0c0fce89a30596c30","affectsGlobalScope":true},{"version":"138fb588d26538783b78d1e3b2c2cc12d55840b97bf5e08bca7f7a174fbe2f17","affectsGlobalScope":true},{"version":"dc2df20b1bcdc8c2d34af4926e2c3ab15ffe1160a63e58b7e09833f616efff44","affectsGlobalScope":true},{"version":"4443e68b35f3332f753eacc66a04ac1d2053b8b035a0e0ac1d455392b5e243b3","affectsGlobalScope":true},{"version":"bc47685641087c015972a3f072480889f0d6c65515f12bd85222f49a98952ed7","affectsGlobalScope":true},{"version":"0dc1e7ceda9b8b9b455c3a2d67b0412feab00bd2f66656cd8850e8831b08b537","affectsGlobalScope":true},{"version":"ce691fb9e5c64efb9547083e4a34091bcbe5bdb41027e310ebba8f7d96a98671","affectsGlobalScope":true},{"version":"8d697a2a929a5fcb38b7a65594020fcef05ec1630804a33748829c5ff53640d0","affectsGlobalScope":true},{"version":"4ff2a353abf8a80ee399af572debb8faab2d33ad38c4b4474cff7f26e7653b8d","affectsGlobalScope":true},{"version":"93495ff27b8746f55d19fcbcdbaccc99fd95f19d057aed1bd2c0cafe1335fbf0","affectsGlobalScope":true},{"version":"6fc23bb8c3965964be8c597310a2878b53a0306edb71d4b5a4dfe760186bcc01","affectsGlobalScope":true},{"version":"ea011c76963fb15ef1cdd7ce6a6808b46322c527de2077b6cfdf23ae6f5f9ec7","affectsGlobalScope":true},{"version":"38f0219c9e23c915ef9790ab1d680440d95419ad264816fa15009a8851e79119","affectsGlobalScope":true},{"version":"bb42a7797d996412ecdc5b2787720de477103a0b2e53058569069a0e2bae6c7e","affectsGlobalScope":true},{"version":"4738f2420687fd85629c9efb470793bb753709c2379e5f85bc1815d875ceadcd","affectsGlobalScope":true},{"version":"2f11ff796926e0832f9ae148008138ad583bd181899ab7dd768a2666700b1893","affectsGlobalScope":true},{"version":"4de680d5bb41c17f7f68e0419412ca23c98d5749dcaaea1896172f06435891fc","affectsGlobalScope":true},{"version":"9fc46429fbe091ac5ad2608c657201eb68b6f1b8341bd6d670047d32ed0a88fa","affectsGlobalScope":true},{"version":"61c37c1de663cf4171e1192466e52c7a382afa58da01b1dc75058f032ddf0839","affectsGlobalScope":true},{"version":"b541a838a13f9234aba650a825393ffc2292dc0fc87681a5d81ef0c96d281e7a","affectsGlobalScope":true},{"version":"b20fe0eca9a4e405f1a5ae24a2b3290b37cf7f21eba6cbe4fc3fab979237d4f3","affectsGlobalScope":true},{"version":"811ec78f7fefcabbda4bfa93b3eb67d9ae166ef95f9bff989d964061cbf81a0c","affectsGlobalScope":true},{"version":"717937616a17072082152a2ef351cb51f98802fb4b2fdabd32399843875974ca","affectsGlobalScope":true},{"version":"d7e7d9b7b50e5f22c915b525acc5a49a7a6584cf8f62d0569e557c5cfc4b2ac2","affectsGlobalScope":true},{"version":"71c37f4c9543f31dfced6c7840e068c5a5aacb7b89111a4364b1d5276b852557","affectsGlobalScope":true},{"version":"576711e016cf4f1804676043e6a0a5414252560eb57de9faceee34d79798c850","affectsGlobalScope":true},{"version":"89c1b1281ba7b8a96efc676b11b264de7a8374c5ea1e6617f11880a13fc56dc6","affectsGlobalScope":true},{"version":"49ed889be54031e1044af0ad2c603d627b8bda8b50c1a68435fe85583901d072","affectsGlobalScope":true},{"version":"e93d098658ce4f0c8a0779e6cab91d0259efb88a318137f686ad76f8410ca270","affectsGlobalScope":true},{"version":"063600664504610fe3e99b717a1223f8b1900087fab0b4cad1496a114744f8df","affectsGlobalScope":true},{"version":"934019d7e3c81950f9a8426d093458b65d5aff2c7c1511233c0fd5b941e608ab","affectsGlobalScope":true},{"version":"bf14a426dbbf1022d11bd08d6b8e709a2e9d246f0c6c1032f3b2edb9a902adbe","affectsGlobalScope":true},{"version":"5e07ed3809d48205d5b985642a59f2eba47c402374a7cf8006b686f79efadcbd","affectsGlobalScope":true},{"version":"2b72d528b2e2fe3c57889ca7baef5e13a56c957b946906d03767c642f386bbc3","affectsGlobalScope":true},{"version":"8073890e29d2f46fdbc19b8d6d2eb9ea58db9a2052f8640af20baff9afbc8640","affectsGlobalScope":true},{"version":"368af93f74c9c932edd84c58883e736c9e3d53cec1fe24c0b0ff451f529ceab1","affectsGlobalScope":true},{"version":"af3dd424cf267428f30ccfc376f47a2c0114546b55c44d8c0f1d57d841e28d74","affectsGlobalScope":true},{"version":"995c005ab91a498455ea8dfb63aa9f83fa2ea793c3d8aa344be4a1678d06d399","affectsGlobalScope":true},{"version":"51e547984877a62227042850456de71a5c45e7fe86b7c975c6e68896c86fa23b","affectsGlobalScope":true},{"version":"956d27abdea9652e8368ce029bb1e0b9174e9678a273529f426df4b3d90abd60","affectsGlobalScope":true},{"version":"4fa6ed14e98aa80b91f61b9805c653ee82af3502dc21c9da5268d3857772ca05","affectsGlobalScope":true},{"version":"e6633e05da3ff36e6da2ec170d0d03ccf33de50ca4dc6f5aeecb572cedd162fb","affectsGlobalScope":true},{"version":"d8670852241d4c6e03f2b89d67497a4bbefe29ecaa5a444e2c11a9b05e6fccc6","affectsGlobalScope":true},{"version":"8444af78980e3b20b49324f4a16ba35024fef3ee069a0eb67616ea6ca821c47a","affectsGlobalScope":true},{"version":"caccc56c72713969e1cfe5c3d44e5bab151544d9d2b373d7dbe5a1e4166652be","affectsGlobalScope":true},{"version":"3287d9d085fbd618c3971944b65b4be57859f5415f495b33a6adc994edd2f004","affectsGlobalScope":true},{"version":"50d53ccd31f6667aff66e3d62adf948879a3a16f05d89882d1188084ee415bbc","affectsGlobalScope":true},{"version":"08a58483392df5fcc1db57d782e87734f77ae9eab42516028acbfe46f29a3ef7","affectsGlobalScope":true},{"version":"436aaf437562f276ec2ddbee2f2cdedac7664c1e4c1d2c36839ddd582eeb3d0a","affectsGlobalScope":true},{"version":"b1cb28af0c891c8c96b2d6b7be76bd394fddcfdb4709a20ba05a7c1605eea0f9","affectsGlobalScope":true},{"version":"13f6e6380c78e15e140243dc4be2fa546c287c6d61f4729bc2dd7cf449605471","affectsGlobalScope":true},{"version":"15b98a533864d324e5f57cd3cfc0579b231df58c1c0f6063ea0fcb13c3c74ff9","affectsGlobalScope":true},{"version":"ac77cb3e8c6d3565793eb90a8373ee8033146315a3dbead3bde8db5eaf5e5ec6","affectsGlobalScope":true},{"version":"d4b1d2c51d058fc21ec2629fff7a76249dec2e36e12960ea056e3ef89174080f","affectsGlobalScope":true},{"version":"2fef54945a13095fdb9b84f705f2b5994597640c46afeb2ce78352fab4cb3279","affectsGlobalScope":true},{"version":"33358442698bb565130f52ba79bfd3d4d484ac85fe33f3cb1759c54d18201393","affectsGlobalScope":true},{"version":"782dec38049b92d4e85c1585fbea5474a219c6984a35b004963b00beb1aab538","affectsGlobalScope":true},"3244739232ed0f77eb4aa4cd9af4feddcf5c3eabdf4f6c3388a5a75569935adb",{"version":"0c162dad72573d233d13195e3b80fed773694e9677b525d9fa22f34d660fe7a9","signature":"aca3e00c7103e529286ca739994f17f821acdbdad539c2be48312dbe529a85fa"},{"version":"459a0e96cb1da14cfd2a81d944b21098d48de670346eaaf2ea377f7831656132","signature":"217968e68843a319adba2493b7af7bcf6a7e100b69cc478454466deb3c3e9a36"},{"version":"e4035c130e9e1e9c9462141cf3af38879f74d9653e70c7585e0cec14a3fee8a4","signature":"f9ca5cc1b894f1a19cbb55135cbfa308ad994ef06e1412e04ff1796272a93b89"}],"root":[[71,73]],"options":{"allowJs":true,"checkJs":true,"declaration":true,"module":99,"outDir":"./","skipLibCheck":true,"strict":true,"target":99},"fileIdsList":[[71,72],[70,71],[71]],"referencedMap":[[73,1],[72,2]],"exportedModulesMap":[[73,1],[72,3]],"semanticDiagnosticsPerFile":[70,68,69,12,13,15,14,2,16,17,18,19,20,21,22,23,3,24,4,25,29,26,27,28,30,31,32,5,33,34,35,36,6,40,37,38,39,41,7,42,47,48,43,44,45,46,8,52,49,50,51,53,9,54,55,56,59,57,58,60,61,10,1,62,11,66,64,63,67,65,73,72,71]},"version":"5.4.2"}
+{"program":{"fileNames":["../node_modules/typescript/lib/lib.es5.d.ts","../node_modules/typescript/lib/lib.es2015.d.ts","../node_modules/typescript/lib/lib.es2016.d.ts","../node_modules/typescript/lib/lib.es2017.d.ts","../node_modules/typescript/lib/lib.es2018.d.ts","../node_modules/typescript/lib/lib.es2019.d.ts","../node_modules/typescript/lib/lib.es2020.d.ts","../node_modules/typescript/lib/lib.es2021.d.ts","../node_modules/typescript/lib/lib.es2022.d.ts","../node_modules/typescript/lib/lib.es2023.d.ts","../node_modules/typescript/lib/lib.esnext.d.ts","../node_modules/typescript/lib/lib.dom.d.ts","../node_modules/typescript/lib/lib.dom.iterable.d.ts","../node_modules/typescript/lib/lib.es2015.core.d.ts","../node_modules/typescript/lib/lib.es2015.collection.d.ts","../node_modules/typescript/lib/lib.es2015.generator.d.ts","../node_modules/typescript/lib/lib.es2015.iterable.d.ts","../node_modules/typescript/lib/lib.es2015.promise.d.ts","../node_modules/typescript/lib/lib.es2015.proxy.d.ts","../node_modules/typescript/lib/lib.es2015.reflect.d.ts","../node_modules/typescript/lib/lib.es2015.symbol.d.ts","../node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../node_modules/typescript/lib/lib.es2016.array.include.d.ts","../node_modules/typescript/lib/lib.es2016.intl.d.ts","../node_modules/typescript/lib/lib.es2017.date.d.ts","../node_modules/typescript/lib/lib.es2017.object.d.ts","../node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts","../node_modules/typescript/lib/lib.es2017.string.d.ts","../node_modules/typescript/lib/lib.es2017.intl.d.ts","../node_modules/typescript/lib/lib.es2017.typedarrays.d.ts","../node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts","../node_modules/typescript/lib/lib.es2018.asynciterable.d.ts","../node_modules/typescript/lib/lib.es2018.intl.d.ts","../node_modules/typescript/lib/lib.es2018.promise.d.ts","../node_modules/typescript/lib/lib.es2018.regexp.d.ts","../node_modules/typescript/lib/lib.es2019.array.d.ts","../node_modules/typescript/lib/lib.es2019.object.d.ts","../node_modules/typescript/lib/lib.es2019.string.d.ts","../node_modules/typescript/lib/lib.es2019.symbol.d.ts","../node_modules/typescript/lib/lib.es2019.intl.d.ts","../node_modules/typescript/lib/lib.es2020.bigint.d.ts","../node_modules/typescript/lib/lib.es2020.date.d.ts","../node_modules/typescript/lib/lib.es2020.promise.d.ts","../node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts","../node_modules/typescript/lib/lib.es2020.string.d.ts","../node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts","../node_modules/typescript/lib/lib.es2020.intl.d.ts","../node_modules/typescript/lib/lib.es2020.number.d.ts","../node_modules/typescript/lib/lib.es2021.promise.d.ts","../node_modules/typescript/lib/lib.es2021.string.d.ts","../node_modules/typescript/lib/lib.es2021.weakref.d.ts","../node_modules/typescript/lib/lib.es2021.intl.d.ts","../node_modules/typescript/lib/lib.es2022.array.d.ts","../node_modules/typescript/lib/lib.es2022.error.d.ts","../node_modules/typescript/lib/lib.es2022.intl.d.ts","../node_modules/typescript/lib/lib.es2022.object.d.ts","../node_modules/typescript/lib/lib.es2022.sharedmemory.d.ts","../node_modules/typescript/lib/lib.es2022.string.d.ts","../node_modules/typescript/lib/lib.es2022.regexp.d.ts","../node_modules/typescript/lib/lib.es2023.array.d.ts","../node_modules/typescript/lib/lib.es2023.collection.d.ts","../node_modules/typescript/lib/lib.esnext.collection.d.ts","../node_modules/typescript/lib/lib.esnext.intl.d.ts","../node_modules/typescript/lib/lib.esnext.disposable.d.ts","../node_modules/typescript/lib/lib.esnext.promise.d.ts","../node_modules/typescript/lib/lib.esnext.decorators.d.ts","../node_modules/typescript/lib/lib.esnext.object.d.ts","../node_modules/typescript/lib/lib.decorators.d.ts","../node_modules/typescript/lib/lib.decorators.legacy.d.ts","../src/constants.ts","../src/generators.ts","../src/utils.ts","../src/types.ts","../src/prng.ts","../src/index.ts"],"fileInfos":[{"version":"824cb491a40f7e8fdeb56f1df5edf91b23f3e3ee6b4cde84d4a99be32338faee","affectsGlobalScope":true},"45b7ab580deca34ae9729e97c13cfd999df04416a79116c3bfb483804f85ded4","3facaf05f0c5fc569c5649dd359892c98a85557e3e0c847964caeb67076f4d75","9a68c0c07ae2fa71b44384a839b7b8d81662a236d4b9ac30916718f7510b1b2d","5e1c4c362065a6b95ff952c0eab010f04dcd2c3494e813b493ecfd4fcb9fc0d8","68d73b4a11549f9c0b7d352d10e91e5dca8faa3322bfb77b661839c42b1ddec7","5efce4fc3c29ea84e8928f97adec086e3dc876365e0982cc8479a07954a3efd4","feecb1be483ed332fad555aff858affd90a48ab19ba7272ee084704eb7167569","5514e54f17d6d74ecefedc73c504eadffdeda79c7ea205cf9febead32d45c4bc","1c0cdb8dc619bc549c3e5020643e7cf7ae7940058e8c7e5aefa5871b6d86f44b","886e50ef125efb7878f744e86908884c0133e7a6d9d80013f421b0cd8fb2af94",{"version":"87d693a4920d794a73384b3c779cadcb8548ac6945aa7a925832fe2418c9527a","affectsGlobalScope":true},{"version":"76f838d5d49b65de83bc345c04aa54c62a3cfdb72a477dc0c0fce89a30596c30","affectsGlobalScope":true},{"version":"138fb588d26538783b78d1e3b2c2cc12d55840b97bf5e08bca7f7a174fbe2f17","affectsGlobalScope":true},{"version":"dc2df20b1bcdc8c2d34af4926e2c3ab15ffe1160a63e58b7e09833f616efff44","affectsGlobalScope":true},{"version":"4443e68b35f3332f753eacc66a04ac1d2053b8b035a0e0ac1d455392b5e243b3","affectsGlobalScope":true},{"version":"bc47685641087c015972a3f072480889f0d6c65515f12bd85222f49a98952ed7","affectsGlobalScope":true},{"version":"0dc1e7ceda9b8b9b455c3a2d67b0412feab00bd2f66656cd8850e8831b08b537","affectsGlobalScope":true},{"version":"ce691fb9e5c64efb9547083e4a34091bcbe5bdb41027e310ebba8f7d96a98671","affectsGlobalScope":true},{"version":"8d697a2a929a5fcb38b7a65594020fcef05ec1630804a33748829c5ff53640d0","affectsGlobalScope":true},{"version":"4ff2a353abf8a80ee399af572debb8faab2d33ad38c4b4474cff7f26e7653b8d","affectsGlobalScope":true},{"version":"93495ff27b8746f55d19fcbcdbaccc99fd95f19d057aed1bd2c0cafe1335fbf0","affectsGlobalScope":true},{"version":"6fc23bb8c3965964be8c597310a2878b53a0306edb71d4b5a4dfe760186bcc01","affectsGlobalScope":true},{"version":"ea011c76963fb15ef1cdd7ce6a6808b46322c527de2077b6cfdf23ae6f5f9ec7","affectsGlobalScope":true},{"version":"38f0219c9e23c915ef9790ab1d680440d95419ad264816fa15009a8851e79119","affectsGlobalScope":true},{"version":"bb42a7797d996412ecdc5b2787720de477103a0b2e53058569069a0e2bae6c7e","affectsGlobalScope":true},{"version":"4738f2420687fd85629c9efb470793bb753709c2379e5f85bc1815d875ceadcd","affectsGlobalScope":true},{"version":"2f11ff796926e0832f9ae148008138ad583bd181899ab7dd768a2666700b1893","affectsGlobalScope":true},{"version":"4de680d5bb41c17f7f68e0419412ca23c98d5749dcaaea1896172f06435891fc","affectsGlobalScope":true},{"version":"9fc46429fbe091ac5ad2608c657201eb68b6f1b8341bd6d670047d32ed0a88fa","affectsGlobalScope":true},{"version":"61c37c1de663cf4171e1192466e52c7a382afa58da01b1dc75058f032ddf0839","affectsGlobalScope":true},{"version":"b541a838a13f9234aba650a825393ffc2292dc0fc87681a5d81ef0c96d281e7a","affectsGlobalScope":true},{"version":"b20fe0eca9a4e405f1a5ae24a2b3290b37cf7f21eba6cbe4fc3fab979237d4f3","affectsGlobalScope":true},{"version":"811ec78f7fefcabbda4bfa93b3eb67d9ae166ef95f9bff989d964061cbf81a0c","affectsGlobalScope":true},{"version":"717937616a17072082152a2ef351cb51f98802fb4b2fdabd32399843875974ca","affectsGlobalScope":true},{"version":"d7e7d9b7b50e5f22c915b525acc5a49a7a6584cf8f62d0569e557c5cfc4b2ac2","affectsGlobalScope":true},{"version":"71c37f4c9543f31dfced6c7840e068c5a5aacb7b89111a4364b1d5276b852557","affectsGlobalScope":true},{"version":"576711e016cf4f1804676043e6a0a5414252560eb57de9faceee34d79798c850","affectsGlobalScope":true},{"version":"89c1b1281ba7b8a96efc676b11b264de7a8374c5ea1e6617f11880a13fc56dc6","affectsGlobalScope":true},{"version":"49ed889be54031e1044af0ad2c603d627b8bda8b50c1a68435fe85583901d072","affectsGlobalScope":true},{"version":"e93d098658ce4f0c8a0779e6cab91d0259efb88a318137f686ad76f8410ca270","affectsGlobalScope":true},{"version":"063600664504610fe3e99b717a1223f8b1900087fab0b4cad1496a114744f8df","affectsGlobalScope":true},{"version":"934019d7e3c81950f9a8426d093458b65d5aff2c7c1511233c0fd5b941e608ab","affectsGlobalScope":true},{"version":"bf14a426dbbf1022d11bd08d6b8e709a2e9d246f0c6c1032f3b2edb9a902adbe","affectsGlobalScope":true},{"version":"5e07ed3809d48205d5b985642a59f2eba47c402374a7cf8006b686f79efadcbd","affectsGlobalScope":true},{"version":"2b72d528b2e2fe3c57889ca7baef5e13a56c957b946906d03767c642f386bbc3","affectsGlobalScope":true},{"version":"8073890e29d2f46fdbc19b8d6d2eb9ea58db9a2052f8640af20baff9afbc8640","affectsGlobalScope":true},{"version":"368af93f74c9c932edd84c58883e736c9e3d53cec1fe24c0b0ff451f529ceab1","affectsGlobalScope":true},{"version":"af3dd424cf267428f30ccfc376f47a2c0114546b55c44d8c0f1d57d841e28d74","affectsGlobalScope":true},{"version":"995c005ab91a498455ea8dfb63aa9f83fa2ea793c3d8aa344be4a1678d06d399","affectsGlobalScope":true},{"version":"51e547984877a62227042850456de71a5c45e7fe86b7c975c6e68896c86fa23b","affectsGlobalScope":true},{"version":"956d27abdea9652e8368ce029bb1e0b9174e9678a273529f426df4b3d90abd60","affectsGlobalScope":true},{"version":"4fa6ed14e98aa80b91f61b9805c653ee82af3502dc21c9da5268d3857772ca05","affectsGlobalScope":true},{"version":"e6633e05da3ff36e6da2ec170d0d03ccf33de50ca4dc6f5aeecb572cedd162fb","affectsGlobalScope":true},{"version":"d8670852241d4c6e03f2b89d67497a4bbefe29ecaa5a444e2c11a9b05e6fccc6","affectsGlobalScope":true},{"version":"8444af78980e3b20b49324f4a16ba35024fef3ee069a0eb67616ea6ca821c47a","affectsGlobalScope":true},{"version":"caccc56c72713969e1cfe5c3d44e5bab151544d9d2b373d7dbe5a1e4166652be","affectsGlobalScope":true},{"version":"3287d9d085fbd618c3971944b65b4be57859f5415f495b33a6adc994edd2f004","affectsGlobalScope":true},{"version":"50d53ccd31f6667aff66e3d62adf948879a3a16f05d89882d1188084ee415bbc","affectsGlobalScope":true},{"version":"08a58483392df5fcc1db57d782e87734f77ae9eab42516028acbfe46f29a3ef7","affectsGlobalScope":true},{"version":"436aaf437562f276ec2ddbee2f2cdedac7664c1e4c1d2c36839ddd582eeb3d0a","affectsGlobalScope":true},{"version":"b1cb28af0c891c8c96b2d6b7be76bd394fddcfdb4709a20ba05a7c1605eea0f9","affectsGlobalScope":true},{"version":"13f6e6380c78e15e140243dc4be2fa546c287c6d61f4729bc2dd7cf449605471","affectsGlobalScope":true},{"version":"15b98a533864d324e5f57cd3cfc0579b231df58c1c0f6063ea0fcb13c3c74ff9","affectsGlobalScope":true},{"version":"ac77cb3e8c6d3565793eb90a8373ee8033146315a3dbead3bde8db5eaf5e5ec6","affectsGlobalScope":true},{"version":"d4b1d2c51d058fc21ec2629fff7a76249dec2e36e12960ea056e3ef89174080f","affectsGlobalScope":true},{"version":"2fef54945a13095fdb9b84f705f2b5994597640c46afeb2ce78352fab4cb3279","affectsGlobalScope":true},{"version":"33358442698bb565130f52ba79bfd3d4d484ac85fe33f3cb1759c54d18201393","affectsGlobalScope":true},{"version":"782dec38049b92d4e85c1585fbea5474a219c6984a35b004963b00beb1aab538","affectsGlobalScope":true},{"version":"616ab0bd2bbaf106ac22339078a358ee71f48f67c1ce6c3af6859b26d51a77a5","signature":"5d94ae30564d6c19b1321a2f4aa82f2e719fefb1928a04754dcbe4164f4ef5ff"},{"version":"9288dcc5a21b0fd8bdeb7a0432ff0dd9645b326b2c6fb6a32ed7d73502cad120","signature":"709e85ca16dd836d820b278ec307e9425f23dc9aa60a049ed312d12b66bb6069"},{"version":"8b97dffa88ef063ca82e610fd45159d839bd25c471b4d577e6c9726d865ab0ca","signature":"2f1af64d6ed029246747a1c222595701752389e1e314360cf403cab4d64d8df1"},{"version":"dac3e0680e3f4f20aa24da05e45d1d561aca3422debaef8c4c0eed9f21da2cdd","signature":"04eee05863b6e30ef98b265b28fb07f419a25295e6dfcea4b6cd16371d4c2bfa"},{"version":"d299e587560fe45b18b2f7ad5c713e72937745f4b844ec982c47244535fbbb61","signature":"499d75c68df08be3529a93f519dd15a59e89c5e1e3384157c79efc068e6d741c"},{"version":"4ad6c3c36a402735215d866c9a7d8a3247515d0997bc0c4d490f9bb9d9552919","signature":"af89e9999aa1cc41788c9ec6883fc71f145f88c6979739395eddf9b9a6313b44"}],"root":[[70,75]],"options":{"allowJs":true,"checkJs":true,"declaration":true,"module":99,"outDir":"./","skipLibCheck":true,"strict":true,"target":99},"fileIdsList":[[70,71,72,73,74],[70,71,72,73],[73]],"referencedMap":[[75,1],[74,2]],"exportedModulesMap":[[75,1],[74,3]],"semanticDiagnosticsPerFile":[68,69,12,13,15,14,2,16,17,18,19,20,21,22,23,3,24,4,25,29,26,27,28,30,31,32,5,33,34,35,36,6,40,37,38,39,41,7,42,47,48,43,44,45,46,8,52,49,50,51,53,9,54,55,56,59,57,58,60,61,10,1,62,11,66,64,63,67,65,70,71,75,74,73,72]},"version":"5.4.2"}

package/lib/types.d.ts

@@ -1,8 +1,2 @@
-export declare enum AlgorithmName {
-    jsf32 = "jsf32",
-    mulberry32 = "mulberry32",
-    sfc32 = "sfc32",
-    splitmix32 = "splitmix32",
-    xoshiro128ss = "xoshiro128**"
-}
-export type AlgorithmFunction = (...args: number[]) => number;
+export type Seed = string | number;
+export type Generator = (...hashes: number[]) => number;

package/lib/types.js

@@ -1,8 +1 @@
-export var AlgorithmName;
-(function (AlgorithmName) {
-    AlgorithmName["jsf32"] = "jsf32";
-    AlgorithmName["mulberry32"] = "mulberry32";
-    AlgorithmName["sfc32"] = "sfc32";
-    AlgorithmName["splitmix32"] = "splitmix32";
-    AlgorithmName["xoshiro128ss"] = "xoshiro128**";
-})(AlgorithmName || (AlgorithmName = {}));
+export {};

package/lib/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generate a random string that can be used as a seed
+ *
+ * @param {number} [length=64] Length of the generated seed string
+ * @returns {string} Generated random seed string
+ */
+export declare function randomSeed(length?: number): string;

package/lib/utils.js

@@ -0,0 +1,13 @@
+/**
+ * Generate a random string that can be used as a seed
+ *
+ * @param {number} [length=64] Length of the generated seed string
+ * @returns {string} Generated random seed string
+ */
+export function randomSeed(length = 64) {
+    let seed = "0x";
+    for (let i = length; i > 0; --i) {
+        seed += "0123456789abcdef"[~~(Math.random() * 16)];
+    }
+    return seed;
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "toosoon-prng",
-  "version": "4.0.3",
+  "version": "4.1.0",
   "description": "This project provides PRNG functions for generating pseudo-random values using a seed-based approach and various algorithms",
   "type": "module",
   "engines": {
-    "node": ">=16"
+    "node": ">=22"
   },
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",

package/.prettierrc

@@ -1,7 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "printWidth": 120,
-  "trailingComma": "none",
-  "endOfLine": "auto"
-}

package/tsconfig.json

@@ -1,28 +0,0 @@
-{
-  "include": ["src"],
-  "exclude": ["node_modules"],
-  "compilerOptions": {
-    "baseUrl": ".",
-
-    "outDir": "lib",
-
-    "target": "ESNext",
-    "lib": ["ESNext", "DOM", "DOM.Iterable"],
-    "skipLibCheck": true,
-    "declaration": true,
-    "incremental": true,
-
-    /* Bundler mode */
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "moduleDetection": "force",
-    "isolatedModules": true,
-    "resolveJsonModule": true,
-
-    /* Linting */
-    "strict": true,
-    "allowJs": true,
-    "checkJs": true,
-    "forceConsistentCasingInFileNames": true
-  }
-}