toosoon-prng 1.5.0 → 2.0.0

package/lib/controllers.js

@@ -1,363 +0,0 @@
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-import prng from './prng';
-// *********************
-// Abstract controllers
-// *********************
-var BasePRNGController = /** @class */ (function () {
-    function BasePRNGController(seed) {
-        this.seed = seed;
-        prng.addController(this);
-    }
-    BasePRNGController.prototype.dispose = function () {
-        var _a;
-        prng.removeController(this);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.destroy();
-    };
-    return BasePRNGController;
-}());
-var BasePRNGGroupController = /** @class */ (function () {
-    function BasePRNGGroupController(seed) {
-        this.controllers = [];
-        this.seed = seed;
-    }
-    BasePRNGGroupController.prototype.addGUI = function (gui, min, max, step) {
-        this.gui = gui.addFolder(this.seed).close();
-        this.guiArgs = { min: min, max: max, step: step };
-        return this.gui;
-    };
-    BasePRNGGroupController.prototype.getValueAt = function (index) {
-        var controller = this.controllers[index];
-        if (!controller) {
-            controller = this.createController(index);
-            if (this.gui) {
-                controller
-                    .addGUI(this.gui, this.guiArgs.min, this.guiArgs.max, this.guiArgs.step)
-                    .name("".concat(this.seed, "-").concat(index));
-            }
-            this.controllers[index] = controller;
-        }
-        return controller.value;
-    };
-    BasePRNGGroupController.prototype.dispose = function () {
-        var _a;
-        this.controllers.forEach(function (controller) { return controller.dispose(); });
-        this.controllers = [];
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.destroy();
-    };
-    return BasePRNGGroupController;
-}());
-// *********************
-// Controllers
-// *********************
-var BooleanController = /** @class */ (function (_super) {
-    __extends(BooleanController, _super);
-    function BooleanController(seed, probability) {
-        if (probability === void 0) { probability = 0.5; }
-        var _this = _super.call(this, seed) || this;
-        _this.probability = probability;
-        _this.value = _this.getValue();
-        return _this;
-    }
-    BooleanController.prototype.addGUI = function (gui) {
-        this.gui = gui.add(this, 'value').name(this.seed);
-        return this.gui;
-    };
-    BooleanController.prototype.getValue = function () {
-        var _a;
-        this.value = prng.randomBoolean(this.seed, this.probability);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return BooleanController;
-}(BasePRNGController));
-export { BooleanController };
-var SignController = /** @class */ (function (_super) {
-    __extends(SignController, _super);
-    function SignController(seed, probability) {
-        if (probability === void 0) { probability = 0.5; }
-        var _this = _super.call(this, seed) || this;
-        _this.probability = probability;
-        _this.value = _this.getValue();
-        return _this;
-    }
-    SignController.prototype.addGUI = function (gui) {
-        this.gui = gui.add(this, 'value', [-1, 1]).name(this.seed);
-        return this.gui;
-    };
-    SignController.prototype.getValue = function () {
-        var _a;
-        this.value = prng.randomSign(this.seed, this.probability);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return SignController;
-}(BasePRNGController));
-export { SignController };
-var FloatController = /** @class */ (function (_super) {
-    __extends(FloatController, _super);
-    function FloatController(seed, min, max) {
-        if (min === void 0) { min = 0; }
-        if (max === void 0) { max = 1; }
-        var _this = _super.call(this, seed) || this;
-        _this.min = min;
-        _this.max = max;
-        _this.value = _this.getValue();
-        return _this;
-    }
-    FloatController.prototype.addGUI = function (gui, min, max, step) {
-        if (step === void 0) { step = 0.01; }
-        this.gui = gui.add(this, 'value', min, max, step).name(this.seed);
-        return this.gui;
-    };
-    FloatController.prototype.getValue = function () {
-        var _a;
-        this.value = prng.randomFloat(this.seed, this.min, this.max);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return FloatController;
-}(BasePRNGController));
-export { FloatController };
-var IntController = /** @class */ (function (_super) {
-    __extends(IntController, _super);
-    function IntController(seed, min, max) {
-        var _this = _super.call(this, seed) || this;
-        _this.min = min;
-        _this.max = max;
-        _this.value = prng.randomInt(_this.seed, min, max);
-        return _this;
-    }
-    IntController.prototype.addGUI = function (gui, min, max, step) {
-        if (step === void 0) { step = 1; }
-        this.gui = gui.add(this, 'value', min, max, step).name(this.seed);
-        return this.gui;
-    };
-    IntController.prototype.getValue = function () {
-        var _a;
-        this.value = prng.randomInt(this.seed, this.min, this.max);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return IntController;
-}(BasePRNGController));
-export { IntController };
-var HexColorController = /** @class */ (function (_super) {
-    __extends(HexColorController, _super);
-    function HexColorController(seed) {
-        var _this = _super.call(this, seed) || this;
-        _this.value = _this.getValue();
-        return _this;
-    }
-    HexColorController.prototype.addGUI = function (gui) {
-        this.gui = gui.addColor(this, 'value').name(this.seed);
-        return this.gui;
-    };
-    HexColorController.prototype.getValue = function () {
-        var _a;
-        this.value = prng.randomHexColor(this.seed);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return HexColorController;
-}(BasePRNGController));
-export { HexColorController };
-var ItemController = /** @class */ (function (_super) {
-    __extends(ItemController, _super);
-    function ItemController(seed, items) {
-        var _this = _super.call(this, seed) || this;
-        _this.items = items;
-        _this.value = _this.getValue();
-        return _this;
-    }
-    ItemController.prototype.addGUI = function (gui) {
-        this.gui = gui.add(this, 'value', this.items).name(this.seed);
-        return this.gui;
-    };
-    ItemController.prototype.getValue = function () {
-        var _a;
-        this.value = prng.randomItem(this.seed, this.items);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return ItemController;
-}(BasePRNGController));
-export { ItemController };
-var ObjectPropertyController = /** @class */ (function (_super) {
-    __extends(ObjectPropertyController, _super);
-    function ObjectPropertyController(seed, object) {
-        var _this = _super.call(this, seed) || this;
-        _this.object = object;
-        _this.value = _this.getValue();
-        return _this;
-    }
-    ObjectPropertyController.prototype.addGUI = function (gui) {
-        this.gui = gui.add(this, 'value', this.object).name(this.seed);
-        return this.gui;
-    };
-    ObjectPropertyController.prototype.getValue = function () {
-        var _a;
-        this.value = prng.randomObjectProperty(this.seed, this.object);
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return ObjectPropertyController;
-}(BasePRNGController));
-export { ObjectPropertyController };
-var WeightsController = /** @class */ (function (_super) {
-    __extends(WeightsController, _super);
-    function WeightsController(seed, items) {
-        var _this = _super.call(this, seed) || this;
-        _this.items = items;
-        _this.weights = _this.items.map(function (item) { return item.weight; });
-        _this.value = _this.getValue();
-        return _this;
-    }
-    WeightsController.prototype.addGUI = function (gui) {
-        this.gui = gui
-            .add(this, 'value', this.items.map(function (item) { return item.value; }))
-            .name(this.seed);
-        return this.gui;
-    };
-    WeightsController.prototype.getValue = function () {
-        var _a;
-        var index = prng.randomIndex(this.seed, this.weights);
-        this.value = this.items[index].value;
-        (_a = this.gui) === null || _a === void 0 ? void 0 : _a.updateDisplay();
-        return this.value;
-    };
-    return WeightsController;
-}(BasePRNGController));
-export { WeightsController };
-// *********************
-// Group Controllers
-// *********************
-var BooleanGroupController = /** @class */ (function (_super) {
-    __extends(BooleanGroupController, _super);
-    function BooleanGroupController(seed, probability) {
-        var _this = _super.call(this, seed) || this;
-        _this.controllers = [];
-        _this.probability = probability;
-        return _this;
-    }
-    BooleanGroupController.prototype.createController = function (index) {
-        return new BooleanController("".concat(this.seed, "-").concat(index), this.probability);
-    };
-    return BooleanGroupController;
-}(BasePRNGGroupController));
-export { BooleanGroupController };
-var SignGroupController = /** @class */ (function (_super) {
-    __extends(SignGroupController, _super);
-    function SignGroupController(seed, probability) {
-        var _this = _super.call(this, seed) || this;
-        _this.controllers = [];
-        _this.probability = probability;
-        return _this;
-    }
-    SignGroupController.prototype.createController = function (index) {
-        return new SignController("".concat(this.seed, "-").concat(index), this.probability);
-    };
-    return SignGroupController;
-}(BasePRNGGroupController));
-export { SignGroupController };
-var FloatGroupController = /** @class */ (function (_super) {
-    __extends(FloatGroupController, _super);
-    function FloatGroupController(seed, min, max) {
-        var _this = _super.call(this, seed) || this;
-        _this.controllers = [];
-        _this.min = min;
-        _this.max = max;
-        return _this;
-    }
-    FloatGroupController.prototype.createController = function (index) {
-        return new FloatController("".concat(this.seed, "-").concat(index), this.min, this.max);
-    };
-    return FloatGroupController;
-}(BasePRNGGroupController));
-export { FloatGroupController };
-var IntGroupController = /** @class */ (function (_super) {
-    __extends(IntGroupController, _super);
-    function IntGroupController(seed, min, max) {
-        var _this = _super.call(this, seed) || this;
-        _this.controllers = [];
-        _this.min = min;
-        _this.max = max;
-        return _this;
-    }
-    IntGroupController.prototype.createController = function (index) {
-        return new IntController("".concat(this.seed, "-").concat(index), this.min, this.max);
-    };
-    return IntGroupController;
-}(BasePRNGGroupController));
-export { IntGroupController };
-var HexColorGroupController = /** @class */ (function (_super) {
-    __extends(HexColorGroupController, _super);
-    function HexColorGroupController() {
-        var _this = _super !== null && _super.apply(this, arguments) || this;
-        _this.controllers = [];
-        return _this;
-    }
-    // constructor(seed: string) {
-    //   super(seed);
-    // }
-    HexColorGroupController.prototype.createController = function (index) {
-        return new HexColorController("".concat(this.seed, "-").concat(index));
-    };
-    return HexColorGroupController;
-}(BasePRNGGroupController));
-export { HexColorGroupController };
-var ItemGroupController = /** @class */ (function (_super) {
-    __extends(ItemGroupController, _super);
-    function ItemGroupController(seed, items) {
-        var _this = _super.call(this, seed) || this;
-        _this.controllers = [];
-        _this.items = items;
-        return _this;
-    }
-    ItemGroupController.prototype.createController = function (index) {
-        return new ItemController("".concat(this.seed, "-").concat(index), this.items);
-    };
-    return ItemGroupController;
-}(BasePRNGGroupController));
-export { ItemGroupController };
-var ObjectPropertyGroupController = /** @class */ (function (_super) {
-    __extends(ObjectPropertyGroupController, _super);
-    function ObjectPropertyGroupController(seed, object) {
-        var _this = _super.call(this, seed) || this;
-        _this.controllers = [];
-        _this.object = object;
-        return _this;
-    }
-    ObjectPropertyGroupController.prototype.createController = function (index) {
-        return new ObjectPropertyController("".concat(this.seed, "-").concat(index), this.object);
-    };
-    return ObjectPropertyGroupController;
-}(BasePRNGGroupController));
-export { ObjectPropertyGroupController };
-var WeightsGroupController = /** @class */ (function (_super) {
-    __extends(WeightsGroupController, _super);
-    function WeightsGroupController(seed, items) {
-        var _this = _super.call(this, seed) || this;
-        _this.controllers = [];
-        _this.items = items;
-        return _this;
-    }
-    WeightsGroupController.prototype.createController = function (index) {
-        return new WeightsController("".concat(this.seed, "-").concat(index), this.items);
-    };
-    return WeightsGroupController;
-}(BasePRNGGroupController));
-export { WeightsGroupController };

package/lib/index.d.ts

@@ -1,3 +0,0 @@
-export { BooleanController, SignController, IntController, FloatController, HexColorController, ItemController, ObjectPropertyController, WeightsController, BooleanGroupController, SignGroupController, IntGroupController, FloatGroupController, HexColorGroupController, ItemGroupController, ObjectPropertyGroupController, WeightsGroupController } from './controllers';
-export { default } from './prng';
-export type * from './types';

package/lib/index.js

@@ -1,2 +0,0 @@
-export { BooleanController, SignController, IntController, FloatController, HexColorController, ItemController, ObjectPropertyController, WeightsController, BooleanGroupController, SignGroupController, IntGroupController, FloatGroupController, HexColorGroupController, ItemGroupController, ObjectPropertyGroupController, WeightsGroupController } from './controllers';
-export { default } from './prng';

package/lib/prng.d.ts

@@ -1,119 +0,0 @@
-import { PRNGController } from './controllers';
-import { Algorithm } from './types';
-/**
- * Utility class for generating pseudo-random values
- *
- * @class PRNG
- */
-declare class PRNG {
-    seed: string;
-    algorithm: (...args: number[]) => number;
-    controllers: PRNGController[];
-    /**
-     * Add a controller to this PRNG
-     *
-     * @param {PRNGController} controller
-     */
-    addController(controller: PRNGController): void;
-    /**
-     * Remove a controller from this PRNG
-     *
-     * @param {PRNGController} controller
-     */
-    removeController(controller: PRNGController): void;
-    /**
-     * Set this PRNG seed
-     *
-     * @param {string} seed
-     */
-    setSeed(seed: string): void;
-    /**
-     * Set this PRNG algorithm for generating pseudo-random values
-     *
-     * @param {Algorithm} algorithm Algorithm name
-     */
-    setAlgorithm(algorithm: Algorithm): void;
-    /**
-     * Generate a pseudo-random number in the interval [0, 1]
-     * PRNG equivalent of `Math.random()`
-     *
-     * @param {string} seed
-     * @returns {number}
-     */
-    random(seed: string): number;
-    /**
-     * Generate a pseudo-random boolean (true or false)
-     *
-     * @param {string} seed
-     * @param {number} [probability=0.5] Probability to get `true`
-     * @returns {boolean} Either `true` or `false`
-     */
-    randomBoolean(seed: string, probability?: number): boolean;
-    /**
-     * Generate a pseudo-random sign (1 or -1)
-     *
-     * @param {string} seed
-     * @param {number} [probability=0.5] Probability to get 1
-     * @returns {number} Either 1 or -1
-     */
-    randomSign(seed: string, probability?: number): number;
-    /**
-     * Generate a pseudo-random floating-point number within a specified range
-     *
-     * @param {string} seed
-     * @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
-     */
-    randomFloat(seed: string, min?: number, max?: number, precision?: number): number;
-    /**
-     * Generate a pseudo-random integer number within a specified range
-     *
-     * @param {string} seed
-     * @param {number} min Minimum boundary
-     * @param {number} max Maximum boundary
-     * @returns {number} Generated integer
-     */
-    randomInt(seed: string, min: number, max: number): number;
-    /**
-     * Generate a pseudo-random hexadecimal color
-     *
-     * @param {string} seed
-     * @returns {string} Generated hexadecimal color
-     */
-    randomHexColor(seed: string): string;
-    /**
-     * Pick a pseudo-random item from a given array
-     *
-     * @param {string} seed
-     * @param {T[]} array Array to pick the item from
-     * @returns {T|undefined} Random item picked
-     */
-    randomItem<T = unknown>(seed: string, array: T[]): T | undefined;
-    /**
-     * Pick a pseudo-random property value from a given object
-     *
-     * @param {string} seed
-     * @param {object} object Object to pick the property from
-     * @returns {T|undefined} Random item picked
-     */
-    randomObjectProperty<T = unknown>(seed: string, object: Record<string, T>): T | undefined;
-    /**
-     * Select a pseudo-random index from an array of weighted items
-     *
-     * @param {string} seed
-     * @param {number[]} weights Array of weights
-     * @returns {number} Random index based on weights
-     */
-    randomIndex(seed: string, weights: number[]): number;
-    /**
-     * Get the PRNG algorithm function by its name
-     *
-     * @param {Algorithm} algorithm Algorithm name
-     * @returns {Function} PRNG algorithm function
-     */
-    private getAlgorithm;
-}
-declare const prng: PRNG;
-export default prng;

package/lib/prng.js

@@ -1,192 +0,0 @@
-import { jsf32, mulberry32, sfc32, splitmix32, xoshiro128ss, random } from 'toosoon-utils/prng';
-import { Algorithm } from './types';
-/**
- * Utility class for generating pseudo-random values
- *
- * @class PRNG
- */
-var PRNG = /** @class */ (function () {
-    function PRNG() {
-        this.seed = '';
-        this.algorithm = splitmix32;
-        this.controllers = [];
-    }
-    /**
-     * Add a controller to this PRNG
-     *
-     * @param {PRNGController} controller
-     */
-    PRNG.prototype.addController = function (controller) {
-        this.controllers.push(controller);
-    };
-    /**
-     * Remove a controller from this PRNG
-     *
-     * @param {PRNGController} controller
-     */
-    PRNG.prototype.removeController = function (controller) {
-        var index = this.controllers.indexOf(controller);
-        this.controllers.splice(index, 1);
-    };
-    /**
-     * Set this PRNG seed
-     *
-     * @param {string} seed
-     */
-    PRNG.prototype.setSeed = function (seed) {
-        if (this.seed === seed)
-            return;
-        this.seed = seed;
-        this.controllers.forEach(function (controller) { return controller.getValue(); });
-    };
-    /**
-     * Set this PRNG algorithm for generating pseudo-random values
-     *
-     * @param {Algorithm} algorithm Algorithm name
-     */
-    PRNG.prototype.setAlgorithm = function (algorithm) {
-        this.algorithm = this.getAlgorithm(algorithm);
-        this.controllers.forEach(function (controller) { return controller.getValue(); });
-    };
-    /**
-     * Generate a pseudo-random number in the interval [0, 1]
-     * PRNG equivalent of `Math.random()`
-     *
-     * @param {string} seed
-     * @returns {number}
-     */
-    PRNG.prototype.random = function (seed) {
-        return random({ seed: this.seed + seed, algorithm: this.algorithm });
-    };
-    /**
-     * Generate a pseudo-random boolean (true or false)
-     *
-     * @param {string} seed
-     * @param {number} [probability=0.5] Probability to get `true`
-     * @returns {boolean} Either `true` or `false`
-     */
-    PRNG.prototype.randomBoolean = function (seed, probability) {
-        if (probability === void 0) { probability = 0.5; }
-        return this.random(seed) < probability;
-    };
-    /**
-     * Generate a pseudo-random sign (1 or -1)
-     *
-     * @param {string} seed
-     * @param {number} [probability=0.5] Probability to get 1
-     * @returns {number} Either 1 or -1
-     */
-    PRNG.prototype.randomSign = function (seed, probability) {
-        if (probability === void 0) { probability = 0.5; }
-        return this.randomBoolean(seed, probability) ? 1 : -1;
-    };
-    /**
-     * Generate a pseudo-random floating-point number within a specified range
-     *
-     * @param {string} seed
-     * @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
-     */
-    PRNG.prototype.randomFloat = function (seed, min, max, precision) {
-        if (min === void 0) { min = 0; }
-        if (max === void 0) { max = 1; }
-        if (precision === void 0) { precision = 2; }
-        return parseFloat(Math.min(min + this.random(seed) * (max - min), max).toFixed(precision));
-    };
-    /**
-     * Generate a pseudo-random integer number within a specified range
-     *
-     * @param {string} seed
-     * @param {number} min Minimum boundary
-     * @param {number} max Maximum boundary
-     * @returns {number} Generated integer
-     */
-    PRNG.prototype.randomInt = function (seed, min, max) {
-        return Math.floor(this.random(seed) * (max - min + 1) + min);
-    };
-    /**
-     * Generate a pseudo-random hexadecimal color
-     *
-     * @param {string} seed
-     * @returns {string} Generated hexadecimal color
-     */
-    PRNG.prototype.randomHexColor = function (seed) {
-        return '#' + ('00000' + ((this.random(seed) * (1 << 24)) | 0).toString(16)).slice(-6);
-    };
-    /**
-     * Pick a pseudo-random item from a given array
-     *
-     * @param {string} seed
-     * @param {T[]} array Array to pick the item from
-     * @returns {T|undefined} Random item picked
-     */
-    PRNG.prototype.randomItem = function (seed, array) {
-        if (array.length === 0)
-            return undefined;
-        return array[this.randomInt(seed, 0, array.length - 1)];
-    };
-    /**
-     * Pick a pseudo-random property value from a given object
-     *
-     * @param {string} seed
-     * @param {object} object Object to pick the property from
-     * @returns {T|undefined} Random item picked
-     */
-    PRNG.prototype.randomObjectProperty = function (seed, object) {
-        var keys = Object.keys(object);
-        var key = this.randomItem(seed, keys);
-        if (key && object.hasOwnProperty(key)) {
-            return object[key];
-        }
-    };
-    /**
-     * Select a pseudo-random index from an array of weighted items
-     *
-     * @param {string} seed
-     * @param {number[]} weights Array of weights
-     * @returns {number} Random index based on weights
-     */
-    PRNG.prototype.randomIndex = function (seed, weights) {
-        if (weights.length === 0)
-            return -1;
-        var totalWeight = 0;
-        for (var _i = 0, weights_1 = weights; _i < weights_1.length; _i++) {
-            var weight_1 = weights_1[_i];
-            totalWeight += weight_1;
-        }
-        if (totalWeight <= 0)
-            console.warn('PRNG.randomIndex()', 'Weights must sum to > 0', totalWeight);
-        var weight = this.random(seed) * totalWeight;
-        for (var i = 0; i < weights.length; i++) {
-            if (weight < weights[i])
-                return i;
-            weight -= weights[i];
-        }
-        return 0;
-    };
-    /**
-     * Get the PRNG algorithm function by its name
-     *
-     * @param {Algorithm} algorithm Algorithm name
-     * @returns {Function} PRNG algorithm function
-     */
-    PRNG.prototype.getAlgorithm = function (algorithm) {
-        switch (algorithm) {
-            case Algorithm.splitmix32:
-                return splitmix32;
-            case Algorithm.jsf32:
-                return jsf32;
-            case Algorithm.mulberry32:
-                return mulberry32;
-            case Algorithm.sfc32:
-                return sfc32;
-            case Algorithm.xoshiro128ss:
-                return xoshiro128ss;
-        }
-    };
-    return PRNG;
-}());
-var prng = new PRNG();
-export default prng;