toosoon-prng 1.4.0 → 2.0.0

package/lib/controllers.d.ts

@@ -1,158 +0,0 @@
-import { Gui, GuiController } from 'toosoon-gui';
-export interface PRNGController<T = unknown> {
-    seed: string;
-    value: T;
-    addGUI(gui: Gui, min?: number, max?: number, step?: number): GuiController;
-    getValue(): T;
-    dispose(): void;
-}
-export interface PRNGGroupController<T = unknown> {
-    seed: string;
-    addGUI(gui: Gui, min?: number, max?: number, step?: number): Gui;
-    createController(index: number): PRNGController<T>;
-    getValueAt(index: number): T;
-    dispose(): void;
-}
-declare abstract class BasePRNGController<T> implements PRNGController<T> {
-    seed: string;
-    abstract value: T;
-    gui: GuiController;
-    constructor(seed: string);
-    abstract addGUI(gui: Gui, min?: number, max?: number, step?: number): GuiController;
-    abstract getValue(): T;
-    dispose(): void;
-}
-declare abstract class BasePRNGGroupController<T> implements PRNGGroupController<T> {
-    seed: string;
-    controllers: PRNGController<T>[];
-    gui: Gui;
-    guiArgs: {
-        min?: number;
-        max?: number;
-        step?: number;
-    };
-    constructor(seed: string);
-    addGUI(gui: Gui, min?: number, max?: number, step?: number): Gui;
-    abstract createController(index: number): PRNGController<T>;
-    getValueAt(index: number): T;
-    dispose(): void;
-}
-export declare class BooleanController extends BasePRNGController<boolean> {
-    value: boolean;
-    probability: number;
-    constructor(seed: string, probability?: number);
-    addGUI(gui: Gui): GuiController;
-    getValue(): boolean;
-}
-export declare class SignController extends BasePRNGController<number> {
-    value: number;
-    probability: number;
-    constructor(seed: string, probability?: number);
-    addGUI(gui: Gui): GuiController;
-    getValue(): number;
-}
-export declare class FloatController extends BasePRNGController<number> {
-    value: number;
-    min: number;
-    max: number;
-    constructor(seed: string, min?: number, max?: number);
-    addGUI(gui: Gui, min: number, max: number, step?: number): GuiController;
-    getValue(): number;
-}
-export declare class IntController extends BasePRNGController<number> {
-    value: number;
-    min: number;
-    max: number;
-    constructor(seed: string, min: number, max: number);
-    addGUI(gui: Gui, min: number, max: number, step?: number): GuiController;
-    getValue(): number;
-}
-export declare class HexColorController extends BasePRNGController<string> {
-    value: string;
-    constructor(seed: string);
-    addGUI(gui: Gui): GuiController;
-    getValue(): string;
-}
-export declare class ItemController<T = unknown> extends BasePRNGController<T> {
-    value: T;
-    items: T[];
-    constructor(seed: string, items: T[]);
-    addGUI(gui: Gui): GuiController;
-    getValue(): T;
-}
-export declare class ObjectPropertyController<T = unknown> extends BasePRNGController<T> {
-    value: T;
-    object: {
-        [key: string]: T;
-    };
-    constructor(seed: string, object: {
-        [key: string]: T;
-    });
-    addGUI(gui: Gui): GuiController;
-    getValue(): T;
-}
-type WeightsItems<T> = Array<{
-    weight: number;
-    value: T;
-}>;
-export declare class WeightsController<T = unknown> extends BasePRNGController<T> {
-    value: T;
-    items: WeightsItems<T>;
-    weights: number[];
-    constructor(seed: string, items: WeightsItems<T>);
-    addGUI(gui: Gui): GuiController;
-    getValue(): T;
-}
-export declare class BooleanGroupController extends BasePRNGGroupController<boolean> {
-    probability: number;
-    controllers: BooleanController[];
-    constructor(seed: string, probability: number);
-    createController(index: number): BooleanController;
-}
-export declare class SignGroupController extends BasePRNGGroupController<number> {
-    probability: number;
-    controllers: SignController[];
-    constructor(seed: string, probability: number);
-    createController(index: number): SignController;
-}
-export declare class FloatGroupController extends BasePRNGGroupController<number> {
-    min: number;
-    max: number;
-    controllers: FloatController[];
-    constructor(seed: string, min: number, max: number);
-    createController(index: number): FloatController;
-}
-export declare class IntGroupController extends BasePRNGGroupController<number> {
-    min: number;
-    max: number;
-    controllers: IntController[];
-    constructor(seed: string, min: number, max: number);
-    createController(index: number): IntController;
-}
-export declare class HexColorGroupController extends BasePRNGGroupController<string> {
-    controllers: HexColorController[];
-    createController(index: number): HexColorController;
-}
-export declare class ItemGroupController<T = unknown> extends BasePRNGGroupController<T> {
-    items: T[];
-    controllers: ItemController<T>[];
-    constructor(seed: string, items: T[]);
-    createController(index: number): ItemController<T>;
-}
-export declare class ObjectPropertyGroupController<T = unknown> extends BasePRNGGroupController<T> {
-    object: {
-        [key: string]: T;
-    };
-    controllers: ObjectPropertyController<T>[];
-    constructor(seed: string, object: {
-        [key: string]: T;
-    });
-    createController(index: number): ObjectPropertyController<T>;
-}
-export declare class WeightsGroupController<T = unknown> extends BasePRNGGroupController<T> {
-    items: WeightsItems<T>;
-    controllers: WeightsController<T>[];
-    constructor(seed: string, items: WeightsItems<T>);
-    createController(index: number): WeightsController<T>;
-}
-export {};

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,114 +0,0 @@
-import { PRNGController } from './controllers';
-import { Algorithm } from './types';
-/**
- * PRNG class
- *
- * @class PRNG
- */
-declare class PRNG {
-    seed: string;
-    algorithm: Algorithm;
-    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: {
-        [key: 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;
-}
-declare const prng: PRNG;
-export default prng;