TOOSOON Pseudo-Random Number Generator (PRNG) — Controllers

This project provides a PRNG functions with a set of Controllers for generating and manipulating pseudo-random values using a seed-based approach and various algorithms.

It adds additionnal features to the main library: toosoon-prng.


Installation

Yarn:

``properties
$ yarn add toosoon-prng-controllers
`

NPM:

`properties
$ npm install toosoon-prng-controllers
`

Usage

`ts
import { IntController, IntGroupController } from 'toosoon-prng-controllers';

const config = {
count: new IntController('count', 0, 10),
counts: new IntGroupController('counts', 5, 10)
};

console.log(config.count.getValue()); // Pseudo-random integer in the interval [0, 10]

for (let i = 0; i < 5; i++) {
console.log(config.counts.getValueAt(i)); // Pseudo-random integers in the interval [5, 10]
}
`

Controllers

$3

Generate pseudo-random boolean value.

`ts
class BooleanController(seed: string | number, probability?: number);
`

$3

Generate pseudo-random sign value (-1 or 1).

`ts
class SignController(seed: string | number, probability?: number);
`

$3

Generate pseudo-random floating-point number within a specified range.

`ts
class FloatController(seed: string | number, min?: number, max?: number);
`

$3

Generate pseudo-random integer number within a specified range.

`ts
class IntController(seed: string | number, min: number, max: number);
`

$3

Generates pseudo-random hexadecimal color.

`ts
class HexColorController(seed: string);
`

$3

Pick a pseudo-random item from a given array.

`ts
class ItemController(seed: string | number, items: T[]);
`

$3

Pick a pseudo-random property value from a given object.

`ts
class ObjectPropertyController(seed: string | number, object: Record);
`

$3

Select a pseudo-random index from an array of weighted items.

`ts
class WeightsController(seed: string | number, items: Array<{ weight: number; value: T }>);
`

$3

Generate a pseudo-random number fitting a Gaussian (normal) distribution.

`ts
class GaussianController(seed: string | number, mean?: number, spread?: number);
`

Group Controllers

Group Controllers manage multiple instances of individual controllers.

$3

Manage multiple BooleanController.

`ts
class BooleanGroupController(seed: string | number, probability: number);
`

$3

Manage multiple SignController.

`ts
class SignGroupController(seed: string | number, probability: number);
`

$3

Manage multiple FloatController.

`ts
class FloatGroupController(seed: string | number, min: number, max: number);
`

$3

Manage multiple IntController.

`ts
class IntGroupController(seed: string | number, min: number, max: number);
`

$3

Manage multiple HexColorController.

`ts
class HexColorGroupController(seed: string);
`

$3

Manage multiple ItemController.

`ts
class ItemGroupController(seed: string | number, items: T[]);
`

$3

Manage multiple ObjectPropertyController.

`ts
class ObjectPropertyGroupController(seed: string | number, object: object);
`

$3

Manage multiple WeightsController.

`ts
class WeightsGroupController(seed: string | number, items: Array<{ weight: number; value: T }>);
`

$3

Manage multiple GaussianController.

`ts
class GaussianGroupController(seed: string | number, mean?: number, spread?: number);
``

License

MIT License, see LICENSE for details.